JSONを使用したDSE Searchクエリー

分散クエリーは多くのシャードにアクセスするため、クエリーのシャード障害耐性を向上させることで、クエリー完了数を確実に増やすことができます。shards.failoverパラメーターとshards.tolerantパラメーターを使用して、JSONクエリー中に発生したクエリー・フェイルオーバーとシャード障害耐性を定義します。 フェイルオーバーと部分的な結果のトレランスは同じクエリー内に共存できません。クエリーは、単一のパラメーターのみに対するトレランスの有効化をサポートしています。

単純な検索文字列の構文：

単純な検索文字列	mytestuser1?
Solrクエリー	name:mytestuser1\?
CQL Solrクエリー	solr_query='{"q":"name:mytestuser1\\?"}'

複雑な検索文字列の構文：

複雑な検索文字列	(1+1):2
Solrクエリー	e:\(1\+1\)\:2
CQL Solrクエリー	solr_query='{"q":"e:\\(1\\+1\\)\\:2"}'

日付計算で追加および切り上げに使用されるデフォルトのTimeZone（UTC）を上書きするようにTZパラメーターを指定します。夏時間（DST）の開始や終了も含めて、指定されたタイムゾーンのローカル・ルールによって、任意の各日付がいつ開始されるかが決まります。タイムゾーン・ルールはDAYSの切り上げと追加に影響しますが、HOURS、MIN、MONTH、およびYEARの切り上げにも影響します。たとえば、異なるタイムゾーンを指定すると、異なる結果が得られます。 TZパラメーターの値には、java TimeZoneクラスでサポートされているゾーンIDを使用できます。

ファセットJSONオブジェクト内のファセットパラメーターを指定して、Solrクエリー内のフィールド、クエリー、および範囲のファセット化を実行します。分散されたピボットのファセット化がサポートされています。クエリー構文は以下の方法でファセットを指定するように簡潔なものになっています。

• HTTP APIで必要とされるファセット・プレフィックスを使用せずに、各ファセット・パラメーターを指定する
• 複数のファセット・フィールドとクエリーをJSON配列内で表現する

ファセット化された検索例 

SELECT * FROM solr WHERE solr_query='{"q":"id:*","facet":{"field":"type"}}';

クエリー・ファセット例 

SELECT * FROM solr WHERE solr_query='{"q":"id:*","facet":{"query":"type:0"}}';

複数のクエリー例 

SELECT * FROM solr WHERE solr_query='{"q":"id:*","facet":{"query":["type:0","type:1"]}}';

分散されたピボット・ファセット化の例 

SELECT id FROM table WHERE solr_query='{"q":"id:*","facet":{"pivot":"type,value","limit":"-1"}}'

範囲ファセットの例 

SELECT * FROM solr WHERE solr_query='{"q":"id:*","facet":{"range":"type", "f.type.range.start":-10, "f.type.range.end":10, "range.gap":1}}}';

返される結果は、各カラムがファセットの出力（フィールド、クエリー、または範囲）に対応した単一行としてフォーマットされます。ファセット結果は複雑でネスト化される場合があるため、値はJSONブロブとして表されます。例：

facet_fields           | facet_queries
------------------------+-------------------------
{"type":{"0":2,"1":1}} | {"type:0":2,"type:1":1}

日付による範囲ファセットの例 

SELECT * FROM solr WHERE solr_query='{"q":"business_date:*","facet":{"range":"business_date", "f.business_date.range.start":"2015-01-01T00:00:00Z", "f.business_date.range.end":"2015-08-01T00:00:00Z", "f.business_date.range.gap":"+1MONTH"}}';

標準の2パス・クエリーの代わりにシングルパス分散クエリーを使用するには、JSONクエリー式でdistrib.singlePassブーリアン・パラメーターを指定します。

SELECT * FROM ks.cf WHERE solr_query = '{"q" :"*:*", "distrib.singlePass" :true}'

シングルパス分散クエリーを使用すると、ディスクおよびネットワークのオーバーヘッドが増える可能性があるため、運用コストがかかります。シングルパス・クエリーでは、各ノードはクエリーを満たす行をすべて読み取り、コーディネーター・ノードに返します。シングルパス分散クエリーは高度な機能であるため、クエリーされた行の取得中に、1つのネットワーク往復の転送を保存します。通常の分散クエリーは2つのネットワーク往復を実行します。クエリーを満たすSolrからIDを取得するのが1つで、もう1つが最初のステップから得たIDに基づいて、Cassandraからのクエリーを満たす行のみを取得するものです。シングルパス分散クエリーは、見つかったほとんどのドキュメントが検索結果に表示される場合に最も効果的です。これらのドキュメントがコーディネーター・ノードに返されない場合は効果はありません。

以下の構文を使用して、メトリクスとパフォーマンス・オブジェクトのモニターをサポートするようにクエリーに名前を付けます。クエリーに名前を付けると、タグ付けやJMX操作に役立つ場合があります。以下に例を示します。

SELECT id FROM nhanes_ks.nhanes WHERE solr_query=' {"query.name":"Asian subjects", "q":"ethnicity:Asia*"}' LIMIT 50;

例：

SELECT id FROM nhanes_ks.nhanes WHERE solr_query='{"q":"ethnicity:Asia*", "commit":true}' LIMIT 50;

DSE Searchでは、タプルおよびユーザー定義型（UDT）を含む、高度なデータ型のインデックス作成とクエリーをサポートしています。

• タプル・データ型は、位置指定された型付きのフィールドを要素とする固定要素数の集合を保持します。ユーザー定義型の代わりにタプルを使用できます。
• ユーザー定義型（UDT）を使用すると、テーブル内で関連する情報を持つ複数のフィールドを扱うのが容易になります。UDTはタプルの特殊型です。すべての例とタプルへのドキュメント・リファレンスは、タプルにもUDTにも適用します。

  情報を別のテーブルに格納するのではなく、ユーザー定義型を使用して関連する情報のフィールドを表すことで、複数のテーブルを必要とするアプリケーションを、より少ないテーブルを使うようにして簡素化できます。

cql_solr_query_pagingオプションがdse.yamlファイルでオフになっている場合は、paging:driverパラメーターを使用してページネーションを動的に有効にします。

cqlsh> select id from wiki.solr where solr_query='{"q":"*", "sort":"id asc", "paging":"driver"}';