説明
さまざまなアプリケーションをカスタマイズするために、クエリステートメントに kvpair 句を含めることができます。 kvpair 句は、キーと値のペアを指定します。
構文
kvpair={key}:{value};{key}:{value};....例
query=SELECT brand, COUNT(*) FROM phone &&kvpair=trace:INFO;formatType:full_jsonkvpair 句でサポートされているパラメーター
パラメーター | 有効な値 | デフォルト値 | 説明 |
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 に設定します。 |
注:
構成項目の名前が kvpair 句のパラメーター名と同じ場合、kvpair 句のパラメーターが優先されます。
複数のキーと値のペアはセミコロン(;)で区切ります。セミコロン(;)の前または後にスペースを指定しないでください。