Skip to main content
Доступно для самостійно розгорнутого тарифного плану Business та вище
Шлях: Панель адміністратора → Операції із запитами до Таблиць Використовуйте розділ Пошук та індекси Таблиць, коли Перегляди, фільтри, зв’язки або пошук у великій Таблиці сповільнюються. Teable у фоні стежить за навантаженням запитів і зводить стан кожної Таблиці: як у ній зараз виконується пошук, які Поля охоплено, які фізичні індекси є та скільки повільних запитів зафіксовано нещодавно. Адміністратори екземпляра тут налаштовують покриття пошуку, створюють індекси й відстежують результати.
Сторінка лише додає завдання до черги й ніколи не змінює базу даних напряму. Кожна зміна виконується у фоні асинхронно, тож перевіряйте підсумок у розділі Завдання / історія.
Операції із запитами до Таблиць типово вимкнено. Задайте на бекенді V2_TABLE_QUERY_OPS_ENABLED значення true і перезапустіть сервіс, після цього сторінка почне накопичувати спостереження.

Знайти потрібну Таблицю

Сторінка відкривається зі списком Таблиць. Кнопки станів угорі мають власні лічильники й звужують список: Поле пошуку приймає назви та ідентифікатори Таблиць, Проєктів і Просторів. Сортувати можна за параметром Найбільше повільних запитів або Назва Таблиці. Вікно спостереження охоплює останню годину або 24 години, і всі показники спостережень у списку відповідають цьому вікну. Спостереження зберігаються 2 дні, давніші у списку не показуються. У кожному рядку наведено оцінену кількість рядків і розмір Таблиці, запити й повільні запити за вікно, поточний метод пошуку та покриття Полів, кількість індексів фільтрування/сортування, а також кількість відкритих рекомендацій і активних завдань. Натисніть назву Таблиці, щоб відкрити подробиці. Поруч із кнопками стану блок Про стани індексу пояснює, як рахуються ці числа.

Як читати стан індексу

У списку Таблиць і в подробицях поряд із методом пошуку показано стан індексу: Під станом можуть з’явитися два рядки. Налаштовано: pg_bigm / pg_trgm означає, що збережений постачальник відрізняється від поточного методу пошуку, а Перемикач середовища виконання індексованого пошуку: вимкнено — що індекс готовий, але середовище виконання вимкнено й пошук досі йде через ILIKE. Якщо сповіщення вгорі сторінки повідомляє про Таблиці, налаштований пошуковий індекс яких не працює, пошук у цих Таблицях повертається до ILIKE. Якщо в ньому також сказано, що обробник завдань вимкнено, задайте на бекенді V2_TABLE_QUERY_OPS_TASK_WORKER_ENABLED значення true і перезапустіть сервіс, щоб індекси можна було перебудувати.
Опублікований індекс не означає, що його використовує кожен пошук: надто короткий запит або Поле поза покриттям однаково повертаються до ILIKE. Ця сторінка показує стан індексу, а не доводить, що нещодавні запити його використали.

Налаштувати покриття пошуку

Вкладка Покриття пошуку показує поточний метод пошуку Таблиці, кількість охоплених Полів і Чинне покриття кожного Поля. Показати неохоплені поля залишає у списку лише ще не включені Поля; Поля з позначкою Не підходить не можуть брати участь в індексі підрядкового пошуку.
Чинне покриття потребує опублікованих і придатних метаданих індексу та ввімкненого перемикача середовища виконання; самої лише збереженої конфігурації недостатньо. Покриття задається явно, тож Поля, додані згодом, не включаються автоматично: налаштуйте Таблицю ще раз, щоб їх урахувати.
Для Таблиці, яку ще не налаштовували, оберіть Налаштувати пошук, а для вже налаштованої оберіть Оновити вибір / перебудувати: діалог відкриється з постачальником і набором Полів, збереженими минулого разу. У діалозі потрібно вказати: Проаналізувати й виконати пробний запуск виконує зміну без фіксації та показує кількість охоплених Полів, оцінену кількість рядків, наявність даних плану виконання й наслідки створення чи перебудови. Для Таблиць з оцінкою від 50 000 рядків, а також невідомого розміру, додатково потрібне підтвердження вікна обслуговування. Далі оберіть Підтвердити й додати завдання до черги.
Створення або перебудова покриття пошуку створює пошуковий стовпець та індекс GIN. Це може переписати всю Таблицю й утримувати блокування, а індексований пошук на час перерветься. Плануйте операцію на вікно обслуговування.
Діалог повертає підтвердження додавання завдання, а не результат. Закрийте його й стежте за завданням у розділі Завдання / історія. Повторне надсилання тієї самої зміни поверне вже наявне завдання.

Керувати індексами фільтрування та сортування

Вкладка Індекси фільтрування / сортування перелічує фізичні індекси, які обслуговують умови фільтрування та сортування цієї Таблиці, із зазначенням дійсності, чи керує ним Teable, розміру й визначення. Вони керуються окремо від індексів підрядкового пошуку. Нижче в розділі Дії, що очікують зібрано рекомендації щодо індексів і позначку, чи підтверджені вони даними плану виконання. Перевірити створення індексу показує запропонований індекс, базу даних виконання й докази; після підтвердження Teable асинхронно виконує CREATE INDEX CONCURRENTLY. Для великих Таблиць і Таблиць невідомого розміру тут теж потрібне підтвердження вікна обслуговування.
Ця сторінка не видаляє індекси. Некеровані та системні індекси можуть захищати обмеження або обслуговувати інші запити, тож їх не чіпають.

Діагностувати конкретні запити

Якщо про повільну Таблицю повідомили, а відповідної рекомендації немає, відкрийте вкладку Діагностика запитів і оберіть Проаналізувати запити. Аналіз лише читає збережені форми запитів і доступні дані плану виконання й нічого не створює. Висновок буває трьох видів: Знайдено можливості індексації, підтверджені планом, Доступні плани не підтверджують можливості індексації та Недостатньо доказів. Брак доказів не означає, що сталося послідовне сканування: саме лише спостереження повільного запиту не доводить, що причина в шляху доступу. Нижче перелічено кожен уражений запит із зазначенням, чи надійшов він із реального трафіку, чи зі збереженої конфігурації Перегляду, а також оцінену вартість плану до та після запропонованого індексу (вартість плану, а не мілісекунди).

Відстежувати результати

Вкладка Завдання / історія складається з трьох частин:
  • Завдання: фонові завдання цієї Таблиці зі станом, кількістю спроб, типом завдання й причиною збою. Якщо завдання зрештою виконалося після збою, помилку позначено як попередню спробу.
  • Історія налаштувань пошуку: постачальник, стан і список Полів кожної попередньої конфігурації покриття.
  • Історія рекомендацій: прийняті, відхилені або замінені рекомендації.
Історія завантажує лише найновіші записи. Якщо їх більше, рядок над списком показує загальну кількість.
Поки в Таблиці є завдання в черзі або в роботі, кнопки налаштування пошуку та створення індексів лишаються неактивними. Дочекайтеся завершення завдання.
Останнє оновлення 14 жовтня 2026 р.