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

OpenSearch:XML 形式のクエリ結果

最終更新日:Dec 28, 2024

OpenSearch Retrieval Engine Edition は、標準クエリ、独立フェーズ 1 クエリ、独立フェーズ 2 クエリの 3 種類のクエリをサポートしています。このトピックでは、これらの種類のクエリのクエリ結果について説明します。

標準クエリの結果

<?xml version="1.0" encoding="UTF-8"?>
<Root>
<TotalTime>0.003</TotalTime>
<SortExprMeta>< ![CDATA[-RANK]] ></SortExprMeta>                     ---ソートされたフィールドの名前とソート方法。マイナス記号 (-) はフィールドが降順であることを示し、プラス記号 (+) はフィールドが昇順であることを示します。
<hits numhits="1" totalhits="8" coveredPercent="100.00">             ---1
	<hit cluster_name="simple4" hash_id="0" docid="15">          ---2
		<fields></fields>                                    ---3
		<property></property>                                ---4
		<attribute></attribute>                              ---5
		<variableValue></variableValue>                      ---6
		<sortExprValues>0.25</sortExprValues>                ---7
		<trace_info></trace_info>                            ---8
	</hit>                                                        
	<metaHit metaHitKey=""></metaHit>                            ---9
</hits>
<AggregateResults>                                                   ---10
	<AggregateResult key='company_id'>
	</AggregateResult>
</AggregateResults>
<Error>                                                              ---11
	<ErrorCode>0</ErrorCode>
	<ErrorDescription></ErrorDescription>
</Error>
<Request_Trace>                                                      ---12
</Request_Trace>
<fromCache></fromCache>                                              ---13
</Root>

<0> ソートされたフィールドの名前とソート方法。マイナス記号 (-) はフィールドが降順であることを示し、プラス記号 (+) はフィールドが昇順であることを示します。

<1> coveredPercent パラメーターは、クエリの最初のフェーズでスキャンされるパーティションの割合を示します。

<2> クラスタ名、ハッシュ ID、ドキュメント ID などの情報。

<3> サマリーのフィールド。

<4> Query Result Searcher (QRS) プラグインで指定したドキュメント情報。

<5> クエリステートメントで指定した属性フィールドの値。

<6> クエリステートメントで指定したその他の情報。

: declareVariable メソッドを呼び出してシリアル化するデータを指定した場合、指定したデータはクエリ結果に含まれます。

<7> ソート式に基づいて取得された値。

<8> ソート操作のトレース。トレースは、ドキュメントのスコアの計算プロセス中に収集されたログの情報を記録します。クエリステートメントの config 句に rank_trace パラメーターを含めて、トレースレベルを指定できます。次の出力は、トレースの例を示しています。

  [TRACE1] [build/debug64/ha3/rank/DefaultScorer.cpp:53] tf=1

<9> QRS プラグインによって返されるように指定したデータ。

<10> 統計情報。

クエリステートメントで aggregate=group_key:company_id,agg_fun:max(id)#min(id) 句を使用すると、次の結果が返されます。

 <AggregateResults>
        <AggregateResult key='company_id'>
                <group value='1'><max>1</max><min>0</min></group>
                <group value='2'><max>3</max><min>1</min></group>
        </AggregateResult>
</AggregateResults>

<11> エラー情報。ParitionId、HostName、ErrorCode、ErrorDescription パラメーターなど。

<12> リクエストのトレース。トレースは、クエリフェーズや各クエリフェーズに必要な期間など、クエリプロセスに関する情報を記述します。config 句でトレースレベルを指定できます。

<13> クエリ結果が QRS キャッシュから取得されたかどうかを示します。このパラメーターは、config 句の cache_info パラメーターの値が yes の場合にのみ返されます。

独立フェーズ 1 クエリの結果

<?xml version="1.0" encoding="UTF-8"?>
<Root>
<TotalTime>0.002</TotalTime>
<SortExprMeta>< ![CDATA[-RANK]] ></SortExprMeta>
<hits numhits="1" totalhits="8" coveredPercent="100.00">
	<hit cluster_name="simple4" hash_id="0" docid="15" gid="simple4_0_0_0_15" pk="00000000000000004d8a42e58ec9d95d">
		<fields>
		</fields>
		<property>
		</property>
		<attribute>
		</attribute>
		<sortExprValues>0.25</sortExprValues>
		<trace_info>
		</trace_info>
	</hit>
</hits>
<AggregateResults>
</AggregateResults>
<Error>
	<ErrorCode>0</ErrorCode>
	<ErrorDescription></ErrorDescription>
</Error>
<Request_Trace>
</Request_Trace>
</Root>

標準クエリの結果と比較して、独立フェーズ 1 クエリの結果の hit パラメーターには gid および pk コンポーネントが含まれ、fields パラメーターの値は空です。pk パラメーターは、クエリステートメントで対応するドキュメントのプライマリキーを指定した場合にのみ返されます。

独立フェーズ 2 クエリの結果

標準クエリの結果と比較して、独立フェーズ 2 クエリの結果の hit パラメーターには gid コンポーネントが含まれ、返される totalhits パラメーターと coveredPercent パラメーターの値は 0 です。