> ## 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>

Путь: Панель администрирования → Операции с запросами таблиц

Используйте **Операции с запросами таблиц**, когда представления, фильтры, связи или поиск в большой таблице становятся медленными. Фоновый анализатор отслеживает нагрузку запросов и преобразует наблюдения в рекомендации. На странице они перечислены, чтобы администраторы экземпляра могли изучить доказательства, глубже проанализировать конкретную таблицу и подтвердить любое изменение базы данных.

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

## Просмотр рекомендаций

Страница открывается на вкладке **Рекомендации**, упорядоченной по приоритету. Анализатор сопоставляет риск запроса с интенсивностью использования таблицы, поэтому сначала отображаются наиболее важные рекомендации.

Ищите по ID таблицы, Базы или Пространства, чтобы отфильтровать все рекомендации; любой другой текст фильтрует то, что уже находится на экране. Фильтры статуса и риска дополнительно сужают список.

Каждая запись указывает пространство, базу и таблицу, к которым она относится. Разверните строку, чтобы прочитать доказательства, лежащие в основе рекомендации, системное решение и диагностику SQL:

| Раздел                  | Что он сообщает                                                                                                                                                                                                                              |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Триггер**             | Источник рекомендации: наблюдаемый трафик запросов, сохраненная конфигурация представления или конфигурация поля связи. Триггер сохраненного представления означает, что медленный запрос еще не наблюдался; риск вызвала сама конфигурация. |
| **Путь доступа**        | Как часто к этой таблице обращались через последовательное сканирование, а не через сканирование индекса.                                                                                                                                    |
| **Причины**             | Понятные причины, такие как большая таблица, отсутствие полезного индекса для полей фильтрации или сортировки, дорогостоящая сортировка либо наблюдаемые тайм-ауты.                                                                          |
| **Структура запроса**   | Конкретные фильтруемые и сортируемые поля с указанием типа сопоставления для каждого из них.                                                                                                                                                 |
| **Предлагаемый индекс** | Поля, которые будут индексированы по рекомендации, и причина этого.                                                                                                                                                                          |

**Углубленный анализ** открывает рабочее пространство анализа с уже заполненной этой таблицей.

Когда анализатор обнаруживает интенсивный поиск подстрок по таблице, он создает одну рекомендацию **GIN для сгенерированного текста** для всей таблицы вместо индекса для каждого поля. Такая строка предлагает **Создать путь поиска** вместо **Углубленного анализа**, а **Добавить индекс** не отображается, поскольку путь доступа для поиска применяется из рабочего пространства анализа и сначала требует **EXPLAIN-пример поиска**. Рекомендация закрывается сама, когда у таблицы появляется этот путь.

Рядом находятся еще две вкладки:

| Вкладка              | Что она показывает                                                                                                |
| -------------------- | ----------------------------------------------------------------------------------------------------------------- |
| **Активные таблицы** | Наиболее загруженные таблицы с запросами, медленными запросами, тайм-аутами и самой долгой длительностью запроса. |
| **Задачи**           | Задачи устранения проблем, созданные Teable, со статусом, попытками, обработчиком и последней ошибкой.            |

Баннер появляется над списком, когда проблему удерживает ошибка конфигурации: пути доступа для поиска настроены, но флаг среды выполнения выключен; у некоторых таблиц путь доступа устарел или ожидает перестроения, поэтому их поиск незаметно вернулся к более медленному сканированию `ILIKE`; либо самая старая задача в очереди ожидает достаточно долго, чтобы предположить отсутствие обработчика, который ее получает. Исправьте то, о чем сообщает баннер, прежде чем работать с рекомендациями ниже.

### Чтение метки решения

Каждая рекомендация содержит последнее решение, принятое системой:

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

<Info>По умолчанию Teable только записывает решения и создает записи рекомендаций и задач; он не изменяет вашу базу данных самостоятельно. Автоматическое выполнение включается по желанию через `V2_TABLE_QUERY_OPS_AUTO_ACCEPT=auto`, и даже тогда применяется только к небольшим таблицам, для которых план выполнения показывает явное снижение стоимости. Все остальное ожидает администратора.</Info>

### Добавление предлагаемого индекса

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

Для таблицы с предполагаемым размером 50 000 строк или более диалог просит подтвердить наличие окна обслуживания, прежде чем кнопка станет доступной. Одновременное построение на большой таблице занимает время и создает нагрузку во время выполнения.

Затем Teable сообщает либо **Индекс создан**, либо **Рекомендация принята и поставлена в очередь**. Во втором случае отслеживайте задачу на вкладке **Задачи**. Если за рекомендацией нет исполняемого физического столбца, **Добавить индекс** остается отключенной и сообщает об этом; вместо этого используйте рабочее пространство анализа для дальнейшего изучения.

## Запуск углубленного анализа

Откройте **Рабочее пространство анализа**, чтобы проанализировать область по запросу, например когда пользователь сообщает о медленной таблице, для которой еще нет рекомендации.

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

Выберите **Таблицу**, **Базу** или **Пространство**, введите соответствующий ID и выберите тип анализа. Начните с **Таблицы**, если уже знаете, какая таблица работает медленно.

Нажмите **Сгенерировать отчет по запросам** или **Сгенерировать отчет по поиску**. Отчет суммирует обнаруженные риски и рекомендуемые дальнейшие действия. Для отчета по поиску **EXPLAIN-пример поиска** необязателен. Добавьте пример, чтобы проверить совместимость результатов, планы запросов и время повторных запросов для предлагаемого пути доступа для поиска подстрок. Teable не сохраняет значение примера.

<Info>Отчет по запросам не изменяет базу данных. Применение рекомендации по поиску подстрок требует **EXPLAIN-примера поиска** и подтверждения администратора.</Info>

Для большой таблицы оцените влияние и запланируйте любое подтвержденное изменение на подходящее окно обслуживания.