MariaDBで全文検索の精度とパフォーマンスを向上させる: INNODB_FT_DEFAULT_STOPWORD テーブルの活用

MariaDB の Information Schema INNODB_FT_DEFAULT_STOPWORD テーブルは、全文検索インデックスで使用されるデフォルトのストップワードのリストを格納します。ストップワードとは、検索クエリで除外される単語のことです。

テーブル構成

ストップワードは、検索結果の精度向上とインデックスのパフォーマンス改善に役立ちます。

• 精度向上：検索クエリから不要な単語を除外することで、より関連性の高い結果を取得できます。
• パフォーマンス改善：インデックスサイズを小さくすることで、検索処理速度を向上できます。

デフォルトのストップワード

MariaDB のデフォルトのストップワードリストは、英語の一般的な機能語で構成されています。

a, an, and, are, as, at, be, by, for, from, had, has, have, he, her, his, in, is, it, its, of, on, or, that, the, to, was, were, will, with

ストップワードの追加・削除

INNODB_FT_DEFAULT_STOPWORD テーブルに直接 INSERT や DELETE を実行することで、ストップワードの追加・削除ができます。

例：ストップワード "the" の追加

INSERT INTO INNODB_FT_DEFAULT_STOPWORD (WORD) VALUES ('the');

例：ストップワード "and" の削除

DELETE FROM INNODB_FT_DEFAULT_STOPWORD WHERE WORD = 'and';

注意事項

• ストップワードの追加・削除は、全文検索インデックスのパフォーマンスに影響を与える可能性があります。
• ストップワードの追加・削除を行う前に、MariaDB のドキュメントを参照することを推奨します。

補足

• 上記の解説は、MariaDB 10.5.13 を基にしています。
• MariaDB のバージョンによって、テーブル構成やデフォルトのストップワードリストが異なる場合があります。

• この情報は参考用であり、予告なく変更される可能性があります。
• この情報に基づいて行ういかなる損害についても、責任を負いません。

改善点

• 日本語のストップワードリストを追加しました。
• ストップワードの役割について詳しく説明しました。
• MariaDB のバージョンによる違いについて注意喚起を行いました。

MariaDB Information Schema INNODB_FT_DEFAULT_STOPWORD テーブル サンプルコード

SELECT * FROM information_schema.INNODB_FT_DEFAULT_STOPWORD;

特定のストップワードの存在確認

SELECT EXISTS (
    SELECT 1 FROM information_schema.INNODB_FT_DEFAULT_STOPWORD
    WHERE WORD = 'the'
);

ストップワード "the" の追加

INSERT INTO information_schema.INNODB_FT_DEFAULT_STOPWORD (WORD) VALUES ('the');

ストップワード "and" の削除

DELETE FROM information_schema.INNODB_FT_DEFAULT_STOPWORD WHERE WORD = 'and';

ストップワード "a" と "an" の追加、その後 "a" の削除

BEGIN;

INSERT INTO information_schema.INNODB_FT_DEFAULT_STOPWORD (WORD) VALUES ('a'), ('an');
DELETE FROM information_schema.INNODB_FT_DEFAULT_STOPWORD WHERE WORD = 'a';

COMMIT;

全文検索クエリにおけるストップワードの影響

-- ストップワード "the" が存在する場合
SELECT * FROM documents WHERE MATCH (title) AGAINST ('the quick brown fox');

-- ストップワード "the" を削除した後
DELETE FROM information_schema.INNODB_FT_DEFAULT_STOPWORD WHERE WORD = 'the';
SELECT * FROM documents WHERE MATCH (title) AGAINST ('the quick brown fox');

日本語ストップワードの追加

-- 日本語ストップワードリスト
SET @stopwords = 'の、は、が、を、に、へ、で、と、から、は、は';

-- ストップワードリストを分割して INSERT
INSERT INTO information_schema.INNODB_FT_DEFAULT_STOPWORD (WORD)
SELECT TRIM(word) FROM UNNEST(SPLIT(@stopwords, ',')) AS word;

全文検索クエリにおける日本語ストップワードの影響

-- 日本語ストップワード "は" が存在する場合
SELECT * FROM documents_ja WHERE MATCH (title) AGAINST ('これはテストです');

-- 日本語ストップワード "は" を削除した後
DELETE FROM information_schema.INNODB_FT_DEFAULT_STOPWORD WHERE WORD = 'は';
SELECT * FROM documents_ja WHERE MATCH (title) AGAINST ('これはテストです');

MariaDB Information Schema INNODB_FT_DEFAULT_STOPWORD テーブル操作の他の方法

MySQL Workbench は、MariaDB を含む MySQL データベースを管理するためのグラフィカルツールです。

• MySQL Workbench を起動し、接続したいデータベースに接続します。
• Schema タブで Information Schema を選択します。
• Tables フォルダで INNODB_FT_DEFAULT_STOPWORD テーブルを選択します。
• テーブルデータの編集、追加、削除を行うことができます。

mysqldump と mysqlimport を使用

mysqldump コマンドを使用して INNODB_FT_DEFAULT_STOPWORD テーブルをダンプし、mysqlimport コマンドを使用して別のデータベースにインポートすることができます。

例：INNODB_FT_DEFAULT_STOPWORD テーブルを別のデータベースにインポート

mysqldump -u root -p database_name information_schema.INNODB_FT_DEFAULT_STOPWORD > stopwords.sql
mysqlimport -u root -p target_database_name stopwords.sql

ストップワードリストファイルを直接編集

MariaDB のインストールフォルダにある share/mysql/stopwords.txt ファイルは、デフォルトのストップワードリストを格納しています。

このファイルを直接編集することで、デフォルトのストップワードリストを変更することができます。

注意事項

• ファイル編集を行う前に、必ずバックアップを取ってください。
• ファイル編集後、MariaDB サーバを再起動する必要があります。

自作のプログラムを使用

JDBC や Python の MySQLdb などのライブラリを使用して、独自のプログラムを作成して INNODB_FT_DEFAULT_STOPWORD テーブルを操作することができます。