分かち書きプラグイン|V4.4.2|OceanBaseデータベース|ドキュメント|OceanBaseマニュアル

ビルド設定（CMakeLists.txt）を変更します。

サンプルコードのルートディレクトリには、CMakeLists.txt ファイルがあります。このファイルでは、「TODO」とマークされた箇所が変更が必要な部分であり、以下の部分が含まれます：

PLUGIN_NAME：現在のプラグイン名であり、プロジェクト名および生成される動的リンクライブラリの名前でもあります。必要な名前に変更してください。
SOURCES：実装ファイルのリストで、CまたはC++のソースファイルを含めることができます。新しい実装ファイルを追加する際は、ここにファイルのパスを追加してください。ヘッダーファイルはこのリストに含めないでください。

コンパイルを実行します。

以下の手順を実行してコンパイルします：

作業ディレクトリに移動します。
```
cd /your/work/path/ftparser
```
分かち書きプラグインの開発ディレクトリに移動します。/your/work/path/ftparser を実際の開発ディレクトリパスに置き換えてください。
ビルドディレクトリを作成します。
```
mkdir -p build
```
コンパイル処理で生成される中間ファイルや最終生成物を格納するために、build という名前のディレクトリを作成します。-p パラメータは、ディレクトリが既に存在してもエラーを報告しないようにします。
ビルドディレクトリに入ります。
```
cd build
```
作成したばかりの build ディレクトリに入ります。その後のコンパイル操作はこのディレクトリ内で行われるため、ソースコードディレクトリをきれいに保つことができます。
ビルド環境を設定します。
```
cmake ..
```
cmake コマンドを実行し、親ディレクトリにある CMakeLists.txt ファイルを読み込んで、コンパイルに必要な Makefile ファイルを生成します。.. は CMakeLists.txt ファイルが親ディレクトリにあることを示します。
ソースコードをコンパイルします。
```
make
```
make コマンドを実行し、生成された Makefile ファイルに基づいてソースコードをコンパイルし、動的リンクライブラリファイル（例：libexample_ftparser.so）を生成します。

コンパイルが成功すると、現在のディレクトリ（つまり build ディレクトリ）に動的リンクライブラリファイルが生成されます。

コンパイル生成物をコピーします。

コンパイルが完了すると、build ディレクトリに動的リンクライブラリファイル（例：libexample_ftparser.so）が生成されます。このファイルをOceanBaseクラスタの各Observerノードの plugin_dir ディレクトリにコピーします。

cp libexample_ftparser.so /path/to/plugin_dir/

生成された動的リンクライブラリファイルをOceanBaseのプラグインディレクトリにコピーします。/path/to/plugin_dir/ を実際の plugin_dir パス（システムパラメータ plugin_dir を確認することで取得できます）に置き換えてください。

プラグインをロードします。

システムテナントでOceanBaseデータベースにログインし、設定パラメータ plugins_load を変更してプラグインをロードします：

ALTER SYSTEM SET plugins_load='libexample_ftparser.so';

クラスタを再起動して、プラグインを有効にします。

OceanBaseデプロイツール（OBD）で管理されているOceanBaseクラスタの場合、以下のコマンドでクラスタを再起動できます。
```
obd cluster restart <cluster_name>
```
<cluster_name> を実際のクラスタ名に置き換えてください。
OceanBaseクラウドプラットフォーム(OCP)で管理されているクラスタの場合は、OCP上で直接クラスタを再起動できます。

インストール済みの分かち書きプラグインを確認します。

select * from oceanbase.GV$OB_PLUGINS;

実行結果は次のとおりです：

+-----------+----------+------------------+--------+----------+------------------------+-----------------+------------------+-------------------+-----------------------+---------------+---------------------------------------------+
| SVR_IP    | SVR_PORT | NAME             | STATUS | TYPE     | LIBRARY                | LIBRARY_VERSION | LIBRARY_REVISION | INTERFACE_VERSION | AUTHOR                | LICENSE       | DESCRIPTION                                 |
+-----------+----------+------------------+--------+----------+------------------------+-----------------+------------------+-------------------+-----------------------+---------------+---------------------------------------------+
| 127.0.0.1 |    55801 | ngram            | READY  | FTPARSER | NULL                   | 1.0.0           | NULL             | 0.1.0             | OceanBase Corporation | Mulan PubL v2 | This is a ngram fulltext parser plugin.     |
| 127.0.0.1 |    55801 | beng             | READY  | FTPARSER | NULL                   | 1.0.0           | NULL             | 0.1.0             | OceanBase Corporation | Mulan PubL v2 | This is a basic english parser plugin.      |
| 127.0.0.1 |    55801 | space            | READY  | FTPARSER | NULL                   | 1.0.0           | NULL             | 0.1.0             | OceanBase Corporation | Mulan PubL v2 | This is a default whitespace parser plugin. |
| 127.0.0.1 |    55801 | example_ftparser | READY  | FTPARSER | libexample_ftparser.so | 1.0.0           | NULL             | 0.1.0             | OceanBase Corporation | Mulan PSL v2  | This is an example ftparser.                |
+-----------+----------+------------------+--------+----------+------------------------+-----------------+------------------+-------------------+-----------------------+---------------+---------------------------------------------+

ここで、LIBRARYがNULLの場合は、組み込みの分かち書きプラグインを意味します。

分かち書きプラグイン

注意

前提条件

説明

手順

ステップ１：開発環境のインストール

ステップ2：開発テンプレートを取得する

ステップ3：プラグインのコンパイルとインストール

ステップ4：分かち書きプラグインをテストする