Страница только ставит задачи в очередь и никогда не меняет базу данных напрямую. Каждое изменение выполняется в фоне асинхронно, поэтому проверяйте итог в разделе Задачи / история.
Операции с запросами таблиц по умолчанию отключены. Задайте на бэкенде
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 строк, а также неизвестного размера, дополнительно требуется подтверждение окна обслуживания. Затем выберите Подтвердить и поставить задачу в очередь.
Диалог возвращает подтверждение постановки задачи, а не результат. Закройте его и следите за задачей в разделе Задачи / история. Повторная отправка того же изменения вернет уже существующую задачу.
Управлять индексами фильтрации и сортировки
Вкладка Индексы фильтрации / сортировки перечисляет физические индексы, обслуживающие условия фильтрации и сортировку этой таблицы, с указанием валидности, управляется ли индекс Teable, его размера и определения. Они управляются отдельно от индексов подстрочного поиска. Ниже в разделе Ожидающие действия собраны рекомендации по индексам и отметка о том, подтверждены ли они данными плана выполнения. Проверить создание индекса показывает предлагаемый индекс, базу данных выполнения и доказательства; после подтверждения Teable асинхронно выполняетCREATE INDEX CONCURRENTLY. Для больших таблиц и таблиц неизвестного размера здесь тоже требуется подтверждение окна обслуживания.
Эта страница не удаляет индексы. Неуправляемые и системные индексы могут защищать ограничения или обслуживать другие запросы, поэтому их не трогают.
Диагностировать конкретные запросы
Если о медленной таблице сообщили, а подходящей рекомендации нет, откройте вкладку Диагностика запросов и выберите Анализировать запросы. Анализ только читает сохраненные формы запросов и доступные данные плана выполнения и ничего не создает. Вывод бывает трех видов: Найдены возможности индексации, подтвержденные планом, Доступные планы не подтверждают возможность индексации и Недостаточно данных. Недостаток данных не означает, что произошло последовательное сканирование: одно наблюдение медленного запроса не доказывает, что причина в пути доступа. Ниже перечислен каждый затронутый запрос с указанием, пришел он из реального трафика или из сохраненной конфигурации представления, а также оценочная стоимость плана до и после предлагаемого индекса (стоимость плана, а не миллисекунды).Отслеживать результаты
Вкладка Задачи / история состоит из трех частей:- Задачи: фоновые задачи этой таблицы со статусом, числом попыток, типом задачи и причиной сбоя. Если задача в итоге завершилась успешно после сбоя, ошибка помечается как прошлая попытка.
- История настроек поиска: поставщик, статус и список Полей каждой прошлой конфигурации покрытия.
- История рекомендаций: принятые, отклоненные или замененные рекомендации.
Пока у таблицы есть задача в очереди или в работе, кнопки настройки поиска и создания индексов остаются неактивными. Дождитесь завершения задачи.