すべてのプロダクト
Search
ドキュメントセンター

OpenSearch:クエリ構成の管理

最終更新日:Dec 28, 2024

概要

OpenSearch では、クラスター構成ページの [クエリ構成] タブでクエリ構成をカスタマイズできます。

クエリ構成バージョンの変更

インスタンスの詳細ページで、左側のペインの 構成管理 > クラスター構成 を選択します。クラスター構成ページで、クエリ構成 タブをクリックします。

1. [クエリ構成] タブで、クエリ構成バージョンを見つけます。

2. [アクション] 列の [表示] または [変更] をクリックします。次に、表示または変更する構成ファイルを見つけ、[アクション] 列の [表示] または [変更] をクリックします。

3. 変更するパラメーターを見つけ、[アクション] 列の [変更] をクリックします。[変更] ページで、パラメーターを変更します。

4. [新しいバージョンの公開] をクリックして、新しいバージョンを生成します。

5. クラスター管理ページに移動し、[構成情報] セクションの [更新] をクリックします。[クラスター構成の更新] パネルで、クエリ構成バージョンを選択して適用します。

6. 拡張機能モジュールの変更履歴ページで更新の進捗状況を確認します。

クエリ構成バージョンの削除

クラスター構成ページの [クエリ構成] タブで、[未使用] 状態のクエリ構成バージョンを削除できます。

パラメーター

クエリ構成ファイル: qrs.json

キー

説明

__cluster_name

general

クラスターのカスタム名。

primary_table_name

$primary_table_name

プライマリテーブルの名前。

qrs_connection_timeout

750

クエリタイムアウト期間 (ミリ秒)。

qrs_request_compress_type

z_speed_compress

クエリ結果サーチャー (QRS) ワーカーによってサーチャーワーカーに転送されるリクエストの圧縮タイプ。このパラメーターは空のままにすることができます。デフォルトでは、リクエストは圧縮されません。

compress_type は圧縮タイプを指定します。デフォルト値: no_compress。有効な値:

  • no_compress: リクエストは圧縮されません。

  • default_compress: zlib の Z_DEFAULT_COMPRESSION を使用してリクエストを圧縮します。

  • z_speed_compress: zlib の Z_BEST_SPEED を使用してリクエストを圧縮します。

qrs_return_hits_limit

5000

クエリで返されるドキュメントの数。

クエリ構成ファイル: zones/general/default_biz.json

キー

説明

cava_alloc_size_limit

40

Cava クエリレベルに割り当てることができる最大メモリ容量。単位: MB。

cava_compile_thread_num

1

デフォルト値。

cava_loop_and_func_limit

10000

デフォルト値。

cava_max_variable_count

10000

デフォルト値。

cava_module_cache_size

256

キャッシュクエリに渡されるソースコードブロックの数。しきい値を超えると、Least Recently Used (LRU) アルゴリズムが使用されます。

default_index

$default_index

クエリのデフォルトのインデックス名。クエリのインデックス名を指定しない場合、デフォルトのインデックスが使用されます。たとえば、query=nid:1 は nid インデックスをクエリすることを指定します。 query='mp3' はクエリのインデックス名を指定しません。この場合、デフォルトのインデックスが使用されます。

default_rank_size

1000000

ヒットするドキュメントのデフォルトの数。

default_rerank_size

200

詳細ソート式に基づいてソートされるドキュメントのデフォルトの数。

early_termination_min_wait_time

100

デフォルト値。

early_termination_trigger_result_percent

0.85

デフォルト値。

early_termination_wait_time_factor

2

デフォルト値。

enable_cava

false

Cava を使用するかどうかを指定します。

filter_field

hash_mode

$hash_mode

例: "hash_mode":

{

"hash_field" : "nid",

"hash_function" : "HASH"

}

上記のサンプルコードの値は、パーティション分割のために HASH メソッドと nid フィールドを使用してハッシュ値を計算することを指定しています。

latency_upper_limit_ms

60

デフォルト値。

latency_upper_limit_percent

2

デフォルト値。

main_online_index

$main_online_index

デフォルト値。

primary_table_name

$primary_table_name

プライマリテーブルの名前。

probe_percent

0.05

プリフェッチシナリオの要件を満たすには、probe_percent を 0.05 より大きい値に設定します。たとえば、メモリはロック解除されます。

return_hit_rewrite_ratio

1.2

サーチャーでは、ソートされたレコードの数、シリアル化されたレコードの数、および (start + hit)/partition の値に、ビジネスシナリオに基づいて 1 より大きい係数が乗算されます。 return_hit_rewrite_ratio パラメーターの有効な値の範囲は 1 から partition_count です。 inshop が単一の列にルーティングされるクエリなどのクエリに対しては、最適化操作は実行されません。

return_hit_rewrite_threshold

500

start パラメーターと hit パラメーターで指定されたレコードの数がこのしきい値より大きい場合、最適化が有効になります。

searcher_cache_latency_limit_ms

1

サーチャキャッシュは、次の条件を満たすクエリの結果のみを格納します。(rank_latency + rerank_latency) > latency_limit。キャッシュされたクエリのレイテンシが高い場合は、キャッシュを使用してパフォーマンスを効果的に向上させることができます。単位: ミリ秒。デフォルト値: 1。

searcher_degrade_rank_size

5000

ヒットするドキュメントの数。

searcher_degrade_rerank_size

100

詳細ソート式に基づいてソートされるドキュメントの数。

使用上の注意

  • クエリ構成バージョンが公開されると、構成の内容を変更できなくなります。

  • 公開済みのクエリ構成バージョンを変更して、新しいクエリ構成バージョンを生成できます。

  • 公開済みのクエリ構成バージョンを変更すると、システムは最新のドラフトバージョンのみを保存します。

  • [未使用] 状態のクエリ構成バージョンのみを削除できます。[使用中] 状態のクエリ構成バージョンは削除できません。