照会リファレンス

Discovery の照会パラメーター、演算子、および集約の全リスト。 Discovery 照会言語を使用して照会を作成する際に、この情報を参照することができます。

Discovery のユーザーインターフェースでは、 [改善とカスタマイズ]ページで自然言語によるクエリ を記述し、テストすることができます。

パラメーターの説明

照会パラメーターを使用して、コレクションの検索、結果セットの識別、および結果セットの分析を行います。

検索パラメーター
パラメーター 説明 例
aggregation 結果セットの統計的照会 aggregation=term(enriched_text.entities.type)
filter ランク付けされない、一致する文書の照会言語検索。 filter=bees
natural_language_query ランクされる、一致する文書の自然言語検索 natural_language_query="How do bees fly"
query ランク付けされる、一致する文書の照会言語検索。 query=bees
構造パラメーター
パラメーター 説明 例
count 返す result 文書の数。 count=15
highlight 照会の一致を強調表示する highlight=true
offset 結果セットから result 文書を返す前に無視する結果の数 offset=100
return 返すフィールドのリスト return=title,url
sort 結果セットのソート基準となるフィールド sort=enriched_text.sentiment.document.score
spelling suggestions 自然言語照会に対して返されるスペル候補 spelling_suggestions=true

照会の制限

以下の文字を含むフィールド名ではクエリを実行できません

  • フィールド名の接尾部の数字 (0 - 9)。 例えば、extracted-content2です。
  • field_name の接頭辞にある _ 、 + 、 - の文字。 例えば、+extracted-contentなどです。
  • field_name 内の文字 .、 ,、および :。 例えば、new:extracted-contentなどです。

オペレーター

演算子は、照会のさまざまな部分の分離文字です。 次の表は、利用可能な演算子をリストアップしています。

照会演算子 (query operators)
オペレーター 説明 例
. JSON 区切り文字 enriched_text.concepts.text
: インクルード text:computer
:: 完全一致突き合わせ title::"Query building"
:! 含まない text:!computer
::! 完全一致ではない text::!winter
\ エスケープ文字 title::"Dorothy said: \"There's no place like home.\""
"" 語句照会 enriched_text.concepts.text:"IBM Watson"
(), [] ネストされたグループ filter-entities:(text:Turkey,type:Location)
| または query-enriched.entities.text:Google|IBM
, および query-enriched.entities.text:Google,IBM
<=, >=, >, < 数値の比較 enriched_text.sentiment.document.score>0.679
^x スコア乗数 text:IBM^3
* ワイルドカード query-enriched_text.concepts.text:pre*
~n 文字列の変化 query-enriched_text.entities.text:cat~1
:* 存在します title:*
!* 存在しません title!*

集計

集約は、一連のデータ値を返します。 以下の表は、利用可能な集計をリストアップしています。

照会の集約
集計 説明 例
average 結果セット内の指定されたフィールドの平均値。 average(product.price)
filter 指定されたパターンに基づいて結果をフィルターに掛けます filter(enriched_text.concepts.text:cloud computing)
histogram 区間ベースの分布 histogram(product.price,interval:1)
max 結果セット内の指定されたフィールドの最大値。 max(product.price)
min 結果セット内の指定されたフィールドの最小値。 min(product.price)
nested 集約を制限する nested(enriched_text.entities)
sum 結果セット内のすべてのフィールドの合計。 sum(product.price)
term 同一値の数 term(enriched_text.concepts.text,count:10)
timeslice 時間ベースの分布 timeslice(last_modified,2day,America/New York)
top_hits 現在の集約の上位ランクの結果文書 term(enriched_text.concepts.text).top_hits(10)
unique_count 集約内のフィールドの固有値の数 unique_count(enriched_text.entities.type)