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

OpenSearch:kvpair 句

最終更新日:Dec 28, 2024

説明

さまざまなアプリケーションをカスタマイズするために、クエリステートメントに kvpair 句を含めることができます。 kvpair 句は、キーと値のペアを指定します。

構文

kvpair={key}:{value};{key}:{value};....

query=SELECT brand, COUNT(*) FROM phone &&kvpair=trace:INFO;formatType:full_json

kvpair 句でサポートされているパラメーター

パラメーター

有効な値

デフォルト値

説明

trace

DISABLE, FATAL,

ERROR,

WARN,

INFO,

DEBUG, TRACE1, TRACE2, TRACE3, SCHEDULE, NOTSET

DISABLE

フロントエンドで生成されるクエリプロセス情報。

formatType/format

string, json, full_json, flatbuffers

string

返される結果の形式。

詳細については、クエリ結果の解釈を参照してください。

クエリが JSON 形式の場合は full_json を使用し、クエリを高速化したい場合は flatbuffers を使用することをお勧めします。

timeout

ulimit

デフォルト値は、SQL ステートメントの構成に基づいて決定されます。

クエリのタイムアウト期間。単位:ミリ秒。

searchInfo

true, false

false

検索情報を返すかどうかを指定します。

sqlPlan

true, false

false

SQL プランに関する情報を返すかどうかを指定します。

forbitMergeSearchInfo

true, false

false

Query Result Searcher (QRS) が列検索によって返される検索情報をマージするかどうかを指定します。各列の詳細をクエリする場合は、このパラメーターを true に設定します。

resultReadable

true, false

false

format パラメーターが json または full_json に設定されている場合、読みやすさを向上させるために、JSON 形式で返される結果に改行を追加するかどうかを指定します。

並列 (

parallel (

V3.8.0 より前のバージョンの OpenSearch Retrieval Engine Edition に適用可能)

1-16

1

Searcher で並列最適化を有効にします。

OpenSearch Retrieval Engine Edition のバージョンが V3.8.0 以降の場合は、新しい実装を使用してください。詳細については、ヒントを参照してください。

注:新しい実装と古い実装は互換性がありません。同時に使用しないでください。

parallelTables (並列テーブル

parallelTables (

V3.8.0 より前のバージョンの OpenSearch Retrieval Engine Edition に適用可能)

複数のテーブルを縦棒(|)で区切ります。

このパラメーターは、parallel パラメーターと一緒に使用されます。 parallelTables パラメーターは、分割と並列をサポートするテーブルを指定し、結合で使用されます。

databaseName

QRS が対応する Searcher にアクセスするために使用するデフォルトのデータベース名。クエリステートメントで dbName.tableName 形式でテーブル名の前にデータベース名を指定すると、QRS は同時に複数の Searcher にアクセスすることもできます。

lackResultEnable

true, false

false

結果に列が欠落することを許可するかどうかを指定します。たとえば、結果に RPC タイムアウト列が欠落することがあります。

iquan.optimizer.debug.enable

true/false

false

最適化フェーズでデバッグを有効にするかどうかを指定します。

iquan.optimizer.sort.limit.use.together

true/false

true

ORDER BY 句が使用されている場合、ORDER BY 句の後に LIMIT 句を強制的に指定するかどうかを指定します。

iquan.optimizer.force.limit.num

ulimit

100

iquan.optimizer.force.limit.enable パラメーターを true に設定すると、iquan.optimizer.force.limit.num パラメーターの値が iquan によって LIMIT 句の値として使用されます。

iquan.optimizer.join.condition.check

true/false

true

結合する必要があるフィールドがハッシュフィールドである必要があるかどうかを指定します。

iquan.optimizer.force.hash.join

true/false

false

すべての結合ノードをハッシュ結合ノードに強制的に変換するかどうかを指定します。

iquan.plan.format.type

json

json

iquan によって生成される実行プランの形式。JSON のみがサポートされています。

iquan.plan.prepare.level

rel.post.optimize

jni.post.optimize

jni.post.optimize

iquan.plan.cache.enable パラメーターおよび dynamic_params パラメーターと一緒に使用されます。このパラメーターを jni.post.optimize に設定することをお勧めします。

iquan.plan.cache.enable パラメーターを true に設定すると、iquan は指定されたフェーズの結果をキャッシュに保存します。

dynamic_params パラメーターを指定すると、iquan は指定されたフェーズの結果のパラメーターを動的に置き換えます。

rel.post.optimize:Java コードで最適化された結果を返します。

jni.post.optimize:Java Native Interface (JNI) 呼び出しが実行された後に C++ コードで結果を返します。

iquan.plan.cache.enable

true / false

false

現在の結果をキャッシュに保存するかどうかを指定します。

exec.source.id

""

クエリステートメントによってアクセスされる特定の行。このパラメーターは、複数の交換が存在する場合に役立ちます。このパラメーターの値は、デフォルトでは時系列で生成されます。

exec.source.spec

""

ビジネスパーティのソース。指定された形式でソースを入力します。

The Personalization Platform (TPP) での推奨シナリオ:tpp-appid-abid-solutionid-ip

その他のシナリオ:製品名-システム名-IP アドレス

dynamic_params

二次元配列

デフォルト値はありません。

動的パラメーター

urlencode_data

true / false

false

dynamic_params パラメーターの値が URL エンコードされている場合は、このパラメーターを true に設定します。

注:

  1. 構成項目の名前が kvpair 句のパラメーター名と同じ場合、kvpair 句のパラメーターが優先されます。

  2. 複数のキーと値のペアはセミコロン(;)で区切ります。セミコロン(;)の前または後にスペースを指定しないでください。