> ## Documentation Index
> Fetch the complete documentation index at: https://help.teable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Операції із запитами до Таблиць

> Переглядайте рекомендації щодо ризиків запитів для повільних Таблиць і підтверджуйте вдосконалення бази даних.

<Tip>Доступно для самостійно розгорнутого тарифного плану Business та вище</Tip>

Шлях: Панель адміністратора → Операції із запитами до Таблиць

Використовуйте розділ **Операції із запитами до Таблиць**, коли Перегляди, фільтри, зв’язки або пошук у великій Таблиці сповільнюються. Фоновий аналізатор стежить за навантаженням запитів і перетворює спостереження на рекомендації. Вони відображаються на сторінці, щоб адміністратори екземпляра могли перевірити докази, докладніше проаналізувати певну Таблицю й підтвердити будь-яку зміну бази даних.

Лічильники над списком підсумовують поточний стан: вікна спостереження, запити, повільні запити, перевищення часу очікування, відкриті та прийняті рекомендації, активні й невдалі завдання, а також кількість готових або погіршених шляхів доступу для пошуку.

## Перегляд рекомендацій

Сторінка відкривається на вкладці **Рекомендації**, упорядкованій за пріоритетом. Аналізатор зіставляє ризик запиту з інтенсивністю використання Таблиці, тому першими відображаються рекомендації, на які найважливіше відреагувати.

Шукайте за ідентифікатором Таблиці, Бази або Простору, щоб фільтрувати всі рекомендації; будь-який інший текст фільтрує вміст, який уже відображається. Фільтри стану й ризику додатково звужують список.

Для кожного елемента вказано Простір, Базу й Таблицю, до яких він належить. Розгорніть рядок, щоб переглянути докази, на яких ґрунтується рекомендація, рішення системи й діагностику SQL:

| Розділ                    | Що він повідомляє                                                                                                                                                                                                                         |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Тригер**                | Джерело рекомендації: спостережуваний трафік запитів, збережена конфігурація Перегляду або конфігурація Поля зв’язку. Тригер збереженого Перегляду означає, що повільний запит іще не спостерігався: ризик виник через саму конфігурацію. |
| **Шлях доступу**          | Як часто ця Таблиця читалася послідовним скануванням і скануванням індексу.                                                                                                                                                               |
| **Причини**               | Зрозумілі причини, наприклад велика Таблиця, відсутність корисного індексу для Полів фільтрування чи сортування, ресурсомістке сортування або зафіксоване перевищення часу очікування.                                                    |
| **Форма запиту**          | Конкретні Поля, за якими виконується фільтрування й сортування, і тип зіставлення для кожного з них.                                                                                                                                      |
| **Запропонований індекс** | Поля, які буде індексовано за рекомендацією, і причина.                                                                                                                                                                                   |

Команда **Глибокий аналіз** відкриває робочу область аналізу з уже вибраною Таблицею.

Якщо аналізатор виявляє інтенсивний пошук підрядків у всій Таблиці, він створює одну рекомендацію **GIN для згенерованого тексту** для всієї Таблиці замість окремого індексу для кожного Поля. У такому рядку замість **Глибокого аналізу** доступна команда **Створити шлях пошуку**, а команда **Додати індекс** не відображається, оскільки шлях доступу для пошуку застосовується з робочої області аналізу й спочатку потребує **прикладу пошуку EXPLAIN**. Рекомендація автоматично закриється, коли Таблиця отримає цей шлях.

Поруч розташовано ще дві вкладки:

| Вкладка                 | Що вона показує                                                                                                     |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Навантажені Таблиці** | Найактивніші Таблиці із запитами, повільними запитами, перевищеннями часу очікування й найдовшою тривалістю запиту. |
| **Завдання**            | Створені Teable завдання з виправлення зі станом, кількістю спроб, виконавцем і останньою помилкою.                 |

Над списком з’являється банер, коли проблема конфігурації блокує процес: шляхи доступу для пошуку налаштовані, але прапорець середовища виконання вимкнено; деякі Таблиці мають застарілий шлях доступу або шлях, що очікує перебудови, і їхній пошук непомітно повернувся до повільнішого сканування `ILIKE`; або найстаріше завдання в черзі очікує достатньо довго, щоб припустити відсутність активного виконавця. Усуньте проблему, про яку повідомляє банер, перш ніж працювати з рекомендаціями нижче.

### Читання позначки рішення

Кожна рекомендація має позначку останнього рішення системи:

| Позначка                                                               | Значення                                                                                                       |
| ---------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| **Потрібне підтвердження вручну**                                      | Застосувати цю рекомендацію може лише адміністратор.                                                           |
| **Тіньовий режим · було б виконано автоматично**                       | Рекомендація відповідає критеріям прийняття, але автоматичне виконання не ввімкнено, тому нічого не змінилося. |
| **Автоматичне виконання** / **Виконано автоматично**                   | Система автоматичного виконання прийняла й застосувала рекомендацію.                                           |
| **Перевірку після виконання не пройдено · повторну спробу відкладено** | Автоматична зміна не пройшла перевірку. Teable довше чекатиме перед наступною спробою для цієї Таблиці.        |
| **Період очікування**                                                  | Цю саму область нещодавно змінено, тому система поки що утримується від дій.                                   |
| **Призупинено** / **Автоматичне виконання не застосовано**             | Докази плану або розмір Таблиці не відповідають вимогам автоматичного виконання.                               |

<Info>За замовчуванням Teable лише записує рішення й створює Записи рекомендацій і завдань; він не змінює базу даних самостійно. Автоматичне виконання вмикається окремо за допомогою `V2_TABLE_QUERY_OPS_AUTO_ACCEPT=auto`, і навіть тоді застосовується лише до малих Таблиць, план виконання яких демонструє явне зменшення вартості. Усі інші рекомендації очікують дії адміністратора.</Info>

### Додавання запропонованого індексу

Якщо ви погоджуєтеся із запропонованим у рекомендації індексом, натисніть **Додати індекс** у відповідному рядку. Підтвердження приймає рекомендацію й виконує `CREATE INDEX CONCURRENTLY` для базової Таблиці PostgreSQL; якщо перевірку плану було пропущено, Teable усе одно створює індекс із рекомендованих Полів. У діалоговому вікні докази відображаються ще раз для остаточної перевірки.

Якщо орієнтовний розмір Таблиці становить щонайменше 50 000 рядків, перш ніж кнопка стане доступною, діалогове вікно попросить підтвердити наявність вікна технічного обслуговування. Одночасне створення індексу для великої Таблиці потребує часу й створює додаткове навантаження.

Після цього Teable повідомляє **Індекс створено** або **Рекомендацію прийнято й додано до черги**. У другому випадку стежте за завданням на вкладці **Завдання**. Якщо рекомендація не має придатного для виконання фізичного стовпця, команда **Додати індекс** залишається вимкненою з відповідним поясненням; натомість продовжте дослідження в робочій області аналізу.

## Виконання глибокого аналізу

Відкрийте **Робочу область аналізу**, щоб проаналізувати область за запитом, наприклад коли користувач повідомляє про повільну Таблицю, для якої ще немає рекомендації.

| Тип аналізу          | Призначення                                                                                                           |
| -------------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Запити й індекси** | Пошук ризиків запитів і можливих удосконалень індексів.                                                               |
| **Пошук підрядків**  | Перевірка, чи може шлях доступу для пошуку підрядків пришвидшити пошук за входженням без зміни поведінки зіставлення. |

Виберіть **Таблиця**, **База** або **Простір**, введіть відповідний ідентифікатор і виберіть тип аналізу. Починайте з **Таблиці**, якщо вже знаєте, яка Таблиця працює повільно.

Натисніть **Створити звіт про запити** або **Створити звіт про пошук**. У звіті підсумовуються виявлені ризики й рекомендовані подальші дії. Для звіту про пошук **приклад пошуку EXPLAIN** необов’язковий. Додайте приклад, щоб перевірити сумісність результатів, плани запитів і час повторних запитів для запропонованого шляху доступу до пошуку підрядків. Teable не зберігає значення прикладу.

<Info>Звіт про запити не змінює базу даних. Застосування рекомендації щодо пошуку підрядків потребує **прикладу пошуку EXPLAIN** і підтвердження адміністратора.</Info>

Для великої Таблиці оцініть вплив і заплануйте всі підтверджені зміни на відповідне вікно технічного обслуговування.