17.15.4 InnoDB INFORMATION_SCHEMA FULLTEXT Index Tables — MySQL 8.4

17.15.4 Таблицы индексов полнотекстового поиска InnoDB INFORMATION_SCHEMA

В следующих таблицах представлена метаданные для индексов полнотекстового поиска:

mysql> SHOW TABLES FROM INFORMATION_SCHEMA LIKE 'INNODB_FT%';
+-------------------------------------------+
| Tables_in_INFORMATION_SCHEMA (INNODB_FT%) |
+-------------------------------------------+
| INNODB_FT_CONFIG                          |
| INNODB_FT_BEING_DELETED                   |
| INNODB_FT_DELETED                         |
| INNODB_FT_DEFAULT_STOPWORD                |
| INNODB_FT_INDEX_TABLE                     |
| INNODB_FT_INDEX_CACHE                     |
+-------------------------------------------+

Обзор таблиц

INNODB_FT_CONFIG: Предоставляет метаданные об индексе полнотекстового поиска и связанной обработке для таблицы.
INNODB_FT_BEING_DELETED: Предоставляет моментальный снимок таблицы INNODB_FT_DELETED; используется только во время операции обслуживания OPTIMIZE TABLE. При выполнении OPTIMIZE TABLE, таблица INNODB_FT_BEING_DELETED очищается, а значения DOC_ID удаляются из таблицы INNODB_FT_DELETED. Поскольку содержимое таблицы INNODB_FT_BEING_DELETED обычно имеет короткий срок жизни, эта таблица имеет ограниченную полезность для мониторинга или отладки. Дополнительную информацию о выполнении OPTIMIZE TABLE для таблиц с индексами FULLTEXT см. в разделе 14.9.6 «Настройка параметров MySQL для полнотекстового поиска».
INNODB_FT_DELETED: Содержит строки, удаленные из индекса полнотекстового поиска для таблицы.

Для предотвращения дорогостоящей реорганизации индекса во время операций DML для индекса InnoDB FULLTEXT, информация о недавно удаленных словах хранится отдельно, отфильтровывается из результатов поиска при выполнении текстового поиска и удаляется из основного индекса поиска только при выполнении команды OPTIMIZE TABLE для таблицы InnoDB.
INNODB_FT_DEFAULT_STOPWORD: Содержит список стоп-слов, используемых по умолчанию при создании индекса полнотекстового поиска для таблиц.

Дополнительную информацию о таблице INNODB_FT_DEFAULT_STOPWORD см. в разделе 14.9.4 «Стоп-слова полнотекстового поиска».
INNODB_FT_INDEX_TABLE: Предоставляет информацию об инвертированном индексе, используемом для обработки поисковых запросов к индексу полнотекстового поиска таблицы.
INNODB_FT_INDEX_CACHE: Предоставляет информацию о токенах недавно вставленных строк в индекс полнотекстового поиска. Для избежания дорогостоящей реорганизации индекса во время операций DML информация о новых проиндексированных словах хранится отдельно и объединяется с основным индексом поиска только при выполнении OPTIMIZE TABLE, при завершении работы сервера или при превышении размера кэша, заданного системной переменной innodb_ft_cache_size или innodb_ft_total_cache_size.

Примечание

За исключением таблицы INNODB_FT_DEFAULT_STOPWORD, эти таблицы изначально пустые. Перед запросом к любой из этих таблиц установите значение системной переменной innodb_ft_aux_table в имя (включая имя базы данных) таблицы, содержащей индекс полнотекстового поиска (например, test/articles).

Пример 17.5 Индекс FULLTEXT InnoDB таблицы INFORMATION_SCHEMA

В этом примере используется таблица с индексом FULLTEXT, чтобы продемонстрировать данные, содержащиеся в индексе FULLTEXT таблиц INFORMATION_SCHEMA.

Создайте таблицу с индексом FULLTEXT и добавьте некоторые данные:

mysql> CREATE TABLE articles (
         id INT UNSIGNED AUTO_INCREMENT NOT NULL PRIMARY KEY,
         title VARCHAR(200),
         body TEXT,
         FULLTEXT (title,body)
       ) ENGINE=InnoDB;

mysql> INSERT INTO articles (title,body) VALUES
       ('MySQL Tutorial','DBMS stands for DataBase ...'),
       ('How To Use MySQL Well','After you went through a ...'),
       ('Optimizing MySQL','In this tutorial we show ...'),
       ('1001 MySQL Tricks','1. Never run mysqld as root. 2. ...'),
       ('MySQL vs. YourSQL','In the following database comparison ...'),
       ('MySQL Security','When configured properly, MySQL ...');

Установите переменную innodb_ft_aux_table на имя таблицы с индексом FULLTEXT. Если эта переменная не установлена, таблицы InnoDB FULLTEXT INFORMATION_SCHEMA будут пустыми, за исключением таблицы INNODB_FT_DEFAULT_STOPWORD.
```
mysql> SET GLOBAL innodb_ft_aux_table = 'test/articles';
```

Запросите таблицу INNODB_FT_INDEX_CACHE, которая отображает информацию о недавно вставленных строках в индексе FULLTEXT. Чтобы избежать дорогостоящей реорганизации индекса во время операций DML, данные для недавно вставленных строк хранятся в кэше индекса FULLTEXT до тех пор, пока не будет выполнена команда OPTIMIZE TABLE (или пока сервер не будет выключен, или пока не будут превышены лимиты кэша).

mysql> SELECT * FROM INFORMATION_SCHEMA.INNODB_FT_INDEX_CACHE LIMIT 5;
+------------+--------------+-------------+-----------+--------+----------+
| WORD       | FIRST_DOC_ID | LAST_DOC_ID | DOC_COUNT | DOC_ID | POSITION |
+------------+--------------+-------------+-----------+--------+----------+
| 1001       |            5 |           5 |         1 |      5 |        0 |
| after      |            3 |           3 |         1 |      3 |       22 |
| comparison |            6 |           6 |         1 |      6 |       44 |
| configured |            7 |           7 |         1 |      7 |       20 |
| database   |            2 |           6 |         2 |      2 |       31 |
+------------+--------------+-------------+-----------+--------+----------+

Включите переменную системы innodb_optimize_fulltext_only и выполните OPTIMIZE TABLE над таблицей, содержащей индекс FULLTEXT. Эта операция очищает содержимое кэша индекса FULLTEXT в основной индекс FULLTEXT. innodb_optimize_fulltext_only изменяет способ работы команды OPTIMIZE TABLE над таблицами InnoDB и предназначена для временного включения во время операций технического обслуживания над таблицами InnoDB с индексами FULLTEXT.
```
mysql> SET GLOBAL innodb_optimize_fulltext_only=ON;

mysql> OPTIMIZE TABLE articles;
+---------------+----------+----------+----------+
| Table         | Op       | Msg_type | Msg_text |
+---------------+----------+----------+----------+
| test.articles | optimize | status   | OK       |
+---------------+----------+----------+----------+
```

Запросите таблицу INNODB_FT_INDEX_TABLE, чтобы просмотреть информацию о данных в главном индексе FULLTEXT, включая информацию о данных, которые только что были очищены из кэша индекса FULLTEXT.

mysql> SELECT * FROM INFORMATION_SCHEMA.INNODB_FT_INDEX_TABLE LIMIT 5;
+------------+--------------+-------------+-----------+--------+----------+
| WORD       | FIRST_DOC_ID | LAST_DOC_ID | DOC_COUNT | DOC_ID | POSITION |
+------------+--------------+-------------+-----------+--------+----------+
| 1001       |            5 |           5 |         1 |      5 |        0 |
| after      |            3 |           3 |         1 |      3 |       22 |
| comparison |            6 |           6 |         1 |      6 |       44 |
| configured |            7 |           7 |         1 |      7 |       20 |
| database   |            2 |           6 |         2 |      2 |       31 |
+------------+--------------+-------------+-----------+--------+----------+

Таблица INNODB_FT_INDEX_CACHE теперь пуста, так как операция OPTIMIZE TABLE очистила кэш индекса FULLTEXT.

mysql> SELECT * FROM INFORMATION_SCHEMA.INNODB_FT_INDEX_CACHE LIMIT 5;
Empty set (0.00 sec)

Удалите некоторые записи из таблицы test/articles.
```
mysql> DELETE FROM test.articles WHERE id < 4;
```
Запросите таблицу INNODB_FT_DELETED. Эта таблица записывает строки, удаленные из индекса FULLTEXT. Чтобы избежать дорогостоящей реорганизации индекса во время операций DML, информация о недавно удаленных записях хранится отдельно, отфильтровывается из результатов поиска при выполнении текстового поиска и удаляется из основного индекса поиска при выполнении OPTIMIZE TABLE.
```
mysql> SELECT * FROM INFORMATION_SCHEMA.INNODB_FT_DELETED;
+--------+
| DOC_ID |
+--------+
|      2 |
|      3 |
|      4 |
+--------+
```

Выполните OPTIMIZE TABLE для удаления удаленных записей.

mysql> OPTIMIZE TABLE articles;
+---------------+----------+----------+----------+
| Table         | Op       | Msg_type | Msg_text |
+---------------+----------+----------+----------+
| test.articles | optimize | status   | OK       |
+---------------+----------+----------+----------+

Таблица INNODB_FT_DELETED теперь должна быть пустой.

mysql> SELECT * FROM INFORMATION_SCHEMA.INNODB_FT_DELETED;
Empty set (0.00 sec)

Запросите таблицу INNODB_FT_CONFIG. Эта таблица содержит метаданные об индексе FULLTEXT и связанной обработке:
- optimize_checkpoint_limit: Количество секунд после которого запуск OPTIMIZE TABLE прекращается.
- synced_doc_id: Следующая запланированная операция DOC_ID.
- stopword_table_name: Имя database/table для пользовательской таблицы стоп-слов. Столбец VALUE пуст, если нет пользовательской таблицы стоп-слов.
- use_stopword: Указывает, используется ли таблица стоп-слов, которая определяется при создании индекса FULLTEXT.
```
mysql> SELECT * FROM INFORMATION_SCHEMA.INNODB_FT_CONFIG;
+---------------------------+-------+
| KEY                       | VALUE |
+---------------------------+-------+
| optimize_checkpoint_limit | 180   |
| synced_doc_id             | 8     |
| stopword_table_name       |       |
| use_stopword              | 1     |
+---------------------------+-------+
```
Отключите innodb_optimize_fulltext_only, так как он предназначен для временного включения:
```
mysql> SET GLOBAL innodb_optimize_fulltext_only=OFF;
```