OpenSearch のインデックス管理とマッピング

インデックスを作成し、OpenSearch のマッピングとフィールドの統計を読み、設定を変え、削除し、定義をコードとしてコピーします。インデックスには、テーブルと同じダイアログのうち OpenSearch に当てはまる部分があります。インデックスタブのツールバーのインデックス設定で開きます。インデックスの作成・変更・削除には試用中または有効なライセンスが必要ですが、ダイアログを読むだけなら不要です。

インデックスを作成する

⌘K で新規インデックスを選ぶか、サイドバーの空いた場所を右クリックします。フォームで尋ねられるのは:

ターゲット: ドメインまたはコレクション。プロファイルが複数に届くときだけ表示されます。
名前: 小文字、最大 255 バイトで、空白と \ / * ? " < > | , # : を含められません。_、-、+、. で始めることもできません。フォームは、名前が破っている規則を示します。
シャードとレプリカ: 任意。空欄ならサーバーの既定値です。マネージドドメインまたはセルフホストのエンドポイントでのみ表示されます。

新しいインデックスはタブで開きます。マッピングエディタはありません。OpenSearch は最初に書き込んだドキュメントからインデックスをマッピングします。knn_vector フィールドのように明示的なマッピングが必要なら、REST API でインデックスを作成してください。

名前を入力した新規インデックスのフォームと、シャード / レプリカのフィールド。

概要

概要のペインはインデックスを直接読み取ります: ドキュメント、サイズ（レプリカを含むすべてのコピー）、ドキュメント平均サイズ、次にドキュメントキー（_id）と、ヘルス、プライマリのサイズ、削除済みドキュメント、プライマリシャード、レプリカ、更新間隔、作成日、エンドポイント、 UUID などの情報です。OpenSearch が返さない情報は — と表示されます。エイリアスでは、指し示すインデックスが表示されます。

マッピング

マッピングのペインは、入れ子のオブジェクトも含めてマッピングが宣言するすべてのフィールドを、マッピング型とともに一覧します。一覧が長ければ名前で絞り込みます。フィールドを展開すると、よく出現する値と、数値や日付のフィールドでは値の分布が表示されます。更新でマッピングを読み直します。

エクスポートは、テーブルのスキーマエクスポートと同じく、マッピングを TypeScript、Zod、JSON Schema に変換します。マッピングはドキュメントにどのフィールドが必須かを示さないため、すべてのフィールドは任意として扱われます。

マッピングペインを開いたインデックスダイアログ。keyword フィールド status を展開し、上位の値を表示している。

設定

マネージドドメインまたはセルフホストのエンドポイントでは、設定で 2 つを変更できます:

レプリカ: レプリカはそれぞれインデックスのプライマリシャードの完全なコピーなので、先に確認を求めます。
更新間隔: 1s や 30s のような値、または更新を止める -1。すぐに適用されます。単位のない数値だけは拒否されます。

プライマリシャードの数はインデックスの作成時に決まるため、概要に情報として表示されます。Serverless コレクションはこれらの設定を自分で管理するため、ペインには削除だけが表示されます。エイリアスには注記だけが表示され、操作はできません。エイリアス経由の変更は、その背後のすべてのインデックスに及ぶからです。

インデックスを削除する

設定の最後にある危険な操作は、名前を入力するとインデックスを削除します。中のドキュメントもすべて消え、OpenSearch にはそれを防ぐ削除保護がありません。インデックスを開いているタブは閉じます。同じ名前のテーブルや、別のドメインの同じ名前のインデックスには影響しません。

AI コンテキスト

AI コンテキストには、AI アシスタントがこのインデックスを扱うたびに読むメモを置きます: フィールドの意味や、重要な値などです。 Team Workspace があれば、自分のメモの隣にチームのメモが並びます。インデックスのメモは、同じ名前のテーブルのメモとは別です。

定義をコードとしてコピーする

インデックスのツールバーのコードは、インデックス定義の下でインデックスの定義をコピーします:

REST: 設定、マッピング、エイリアスを含む PUT /<index> リクエスト。 Dev Tools コンソールでそのまま使えます。
Terraform: インポート行とコメントアウトしたプロバイダーブロックを含む opensearch_index リソース。リソースに引数がない設定は、先頭のコメントに一覧されます。

UUID や作成日など OpenSearch が管理する設定は除かれます。エイリアスでは、背後のインデックスを最大 5 つまで表示します。結果はコピーで受け取ります。