OpenSearch:OSSデータソース

OSSを有効にする

1. オブジェクトストレージサービス (OSS) を有効にする.

2. OSSコンソールでバケットを作成する.

3. OSSバケットにオブジェクトをアップロードする.

OSSデータソースを設定する

1. OpenSearchコンソールにログオンします。左上隅で、OpenSearch Retrieval Engine Edition を選択します。[インスタンス] ページで、管理するインスタンスを見つけ、[アクション] 列の [管理] をクリックします。

2. 左側のペインで、構成センター > データソースを選択します。[データソース] ページで、データソースを追加をクリックします。[データソースを追加] パネルで、[データソースの種類] パラメーターを OSS に設定し、データソース名、OSSパス、および バケット パラメーターを設定します。次に、検証をクリックします。

パラメーター:

• データソース名: OSSデータソースのカスタム名。名前は文字で始まり、文字、数字、アンダースコア(_)を含めることができます。

• OSSパス: OSSオブジェクトにアクセスするために使用されるパス。

• バケット: OSSバケットの名前。

3. インデックステーブルを作成する。

   1. OSSデータソースを設定した後、左側のペインで 構成センター > インデックススキーマ を選択します。[インデックススキーマ] ページで、[インデックステーブルの作成] をクリックします。

   2. 構成ページで、カスタムインデックステーブル名を入力し、構成したOSSデータソースを選択します。

この例では、pkフィールドとembeddingsフィールドが設定されています。サンプルデータの詳細については、oss_test.txtを参照してください。

CMD=add
pk=999000
embeddings=0.00.0039257140.0098142860.0039257140.00
pk=999000
embeddings=0.00.0039257140

インデックススキーマの詳細については、このトピックの「インデックス作成用のデータファイル」セクションを参照してください。

4. 左側のペインで、O&Mセンター > O&M管理を選択します。[O&M管理] ページで、再インデックスをクリックします。[再インデックス] パネルで、パラメーターを設定してOSSデータソースの再インデックスをトリガーします。

再インデックスが完了したら、クエリテストを実行できます。

インデックス作成用のデータファイル

ファイルはインデックス作成のデータソースとして機能します。ファイルはUTF-8形式でエンコードされている必要があります。このセクションでは、インデックス作成用のデータファイルの標準入力形式について説明します。

• 次の情報は、standard_sample.dataという名前の完全なデータファイルの内容を示しています。

CMD=add^_
PK=12345321^_
url=http://www.aliyun.com/index.html^_
title=Alibaba Cloud Computing Co., Ltd.^_
body=xxxxxx xxx^_
time=3123423421^_
multi_value_field=1234^]324^]342^_
bidwords=mp3^\price=35.8^Ptime=13867236221^]mp4^\price=32.8^Ptime=13867236221^_
^^
CMD=delete^_
PK=12345321^_CMD=add^_
PK=12345321^_
url=http://www.aliyun.com/index.html^_
title=Alibaba Cloud Computing Co., Ltd.^_
body=xxxxxx xxx^_
time=3123423421^_
multi_value_field=1234^]324^]342^_
bidwords=mp3^\price=35.8^Ptime=13867236221^]mp4^\price=32.8^Ptime=13867236221^_
^^
CMD=delete^_
PK=12345321^_

このデータファイルには、addコマンドとdeleteコマンドが含まれています。各コマンドは複数の行で構成され、各行はキーと値のペアです。 コマンドは '^^\n' で区切られ、キーと値のペアは '^_\n' で区切られ、値は '^]' で区切られます。次の表とリストは、ファイル区切り文字とコマンド形式について説明しています。

• ファイル区切り文字

• コマンド形式

  • add

    addコマンドは、インデックススキーマにデータを追加するために使用されます。

    addコマンドの最初の行はCMD=addである必要があり、その後にドキュメントのフィールドが続きます。フィールドの順序は、インデックススキーマのフィールドの順序と同じにすることができます。addコマンドに表示されるすべてのフィールドは、インデックススキーマで指定する必要があります。

CMD=add^_
PK=12345321^_
url=http://www.aliyun.com/index.html^_
title=Alibaba Cloud Computing Co., Ltd.^_
body=xxxxxx xxx^_
time=3123423421^_
multi_value_field=1234^]324^]342^_
bidwords=mp3^\price=35.8^Ptime=13867236221^]mp4^\price=32.8^Ptime=13867236221^_
^^CMD=add^_
PK=12345321^_
url=http://www.aliyun.com/index.html^_
title=Alibaba Cloud Computing Co., Ltd.^_
body=xxxxxx xxx^_
time=3123423421^_
multi_value_field=1234^]324^]342^_
bidwords=mp3^\price=35.8^Ptime=13867236221^]mp4^\price=32.8^Ptime=13867236221^_
^^

• delete

  deleteコマンドは、インデックススキーマからデータを削除するために使用されます。

  deleteコマンドの最初の行はCMD=deleteである必要があり、その後にインデックススキーマでプライマリキーフィールドとして定義されているフィールドと、

  ハッシュパーティションに使用されるフィールドが続きます。2つのフィールドが同じ場合は、1つのフィールドのみを指定する必要があります。

CMD=delete^_
PK=12345321^_
^^CMD=delete^_
PK=12345321^_
^^

OSSデータソースを削除する

データソースページで、削除するデータソースを見つけ、アクション列の削除をクリックします。

注:

• データソースを削除すると、復元できません。慎重に行ってください。

• 削除するOSSデータソースのインデックステーブルが作成されている場合は、OSSデータソースを削除する前に、インデックステーブルを削除する必要があります。

使用上の注意

• 購入したOpenSearch Retrieval Engine Editionインスタンスと同じリージョンでOSSを有効にする必要があります。

• OpenSearch Retrieval Engine EditionはAnywhere OSSバケットをサポートしていません。

• OSSデータソースを設定すると、システムはAliyunServiceRoleForSearchEngineという名前のサービスリンクロールを自動的に作成します。サービスリンクロールがすでに存在する場合は、システムは別のロールを作成しません。OpenSearchはこのロールを使用してクラウド リソースにアクセスし、関連機能を実装します。