CREATE SEARCH INDEX

構文

CREATE SEARCH INDEX [ IF NOT EXISTS ] ON [keyspace_name.]table_name
  [ WITH [ COLUMNS column_list { option : value } [ , ... ] ]
  [ [ AND ] PROFILES profile_name [ , ... ] ]
  [ [ AND ] CONFIG { option:value } [ , ... ] ]
  [ [ AND ] OPTIONS { option:value } [ , ... ] ] ] ;

CREATE SEARCH INDEX文にオプションが指定されていない場合、すべてのカラムでデフォルト値を使用してインデックスが作成されます。

EBNF

createSearchIndex ::= 'CREATE' 'SEARCH' 'INDEX' ('IF' 'NOT' 'EXISTS')?
                      'ON' tableName
                      ('WITH' indexOptions)?
tableName         ::= (keyspace '.')? table
indexOptions      ::= indexOption ('AND' indexOption)*
indexOption       ::= 'COLUMNS' columnList
                      | 'PROFILES' profileName (',' profileName)*
                      | 'CONFIG' optionMap
                      | 'OPTIONS' optionMap
columnList        ::= column (',' column)*
column            ::= (columnName | '*')('{' optionMap '}')?
optionMap         ::= '{' (optionName ':' optionValue (',' optionName ':'
                      optionValue)*)? '}'

レールロード・ダイアグラム：

COLUMNS

COLUMNS column_list { copyField : true | false }, 
column_list { docValues : true | false }, 
column_list { excluded : true | false }, 
column_list { indexed : true | false }

column_list

コンマ区切りリストまたは*（すべてのカラム）。タプル・フィールドとサブフィールドを含めることができます。インデックスを作成する必要があるPRIMARY KEYカラムを除き、リストされていないカラムはデフォルトでインデックスから除外されます。

• 検索インデックスに含めるすべてのcolumn_name、tuplefield、またはtuplefield.subfieldのコンマ区切りリスト。サブフィールドが包含対象として選択されている場合は、親フィールドが常に含まれます。
• column_listのカラムごとに、copyField、docValues、excluded、またはindexedについてtrueまたはfalseを指定します。
• すべてのカラムを選択するには、アスタリスク（*）を指定します。

例を次に示します。

COLUMNS column_name1, column_name2

COLUMNS column_name1, column_name2 {copyField:true}

copyField: (true | false)

StrField型の指定したカラムからコピーして新しいフィールドを作成するには、trueに設定します。元のフィールドのデータを新しいフィールドに複製します。検索とファセット化の両方で必要なカラムに使用します。

デフォルト値はfalseです。

docValues: (true | false)

指定したカラムごとにフォワード・インデックスを作成します。TrieField、UUIDField、およびStrFieldを拡張するSolr型でのみ有効な設定です。ソートまたはグループ化（ファセット化）されたカラムで使用します。デフォルト値は、TrieField型とUUIDField型ではtrue、StrField型ではfalseです。

SOLR-7264により、Solrスキーマのブーリアン・フィールドでdocValuesをtrueに設定することはできません。ブーリアンdocValuesの回避策として、TrieIntFieldで0および1を使用します。

注: spaceSavingsプロファイルを使用すると、DocValuesの自動生成が無効になります。

excluded: (true | false)

COLUMNSオプションを使用する場合、インデックスからカラムを除外します。

• true - リストされたカラムとカラム内のすべてのフィールドがインデックスから除外されます。
• false - リストされたカラムはインデックスから除外されません。インデックスにカラムを含めるには、含めるカラムを指定する必要があります。指定されない場合のデフォルトです。

除外されたカラムはHTTPクエリー結果とsinglePassクエリーに存在しません。

indexed: (true | false)

COLUMNSオプションを使用する場合、以下のように設定します。

• true - 指定されたフィールドがインデックスに含まれます。指定されない場合のデフォルトです。
• false - 指定されたフィールドがインデックスから除外されます。

インデックスが作成されていないカラムはHTTPクエリー結果とsinglePassクエリーに存在します。

PROFILES

PROFILES profile_name [, profile_name, ...]

spaceSavingAll

すべてのプロファイルを適用します。

spaceSavingNoJoin

検索クエリーでテーブル全体の結合に必要な非表示のパーティション・キーをインデックスから除外します。使用する場合、検索インデックス・クエリーでテーブル結合を使用できません。

spaceSavingSlowTriePrecision

トライ・フィールドprecisionStepを「0」に設定すると、領域を大幅に節約できますがクエリーの速度は低下します。

CONFIG

CONFIG { shortcut_name:value [, shortcut_name:value, ...] }

shortcuts

構成要素の値へのショートカット。SETを使用します。

• autoCommitTime：デフォルト値は10,000です。
• defaultQueryField：フィールドの名前です。デフォルトは設定されていません。
  注: SETを使用して追加します。削除するには、DROPを使用します。
• directoryFactory：directoryFactoryClassオプションの代わりに使用できます。オプションは以下のとおりです。
  • 'standard'
  • 'encrypted'
• filterCacheLowWaterMark：デフォルトは1024です。
• filterCacheHighWaterMark：デフォルトは2048です。
• directoryFactoryClass：ディレクトリー係数の完全修飾名を指定します。標準および暗号化ディレクトリー係数以外のディレクトリー係数に対して、directoryFactoryオプションの代わりに使用します。
• mergeMaxThreadCount：mergeMaxMergeCountとともに構成する必要があります。デフォルト値は、tpc_coresの数値です（この数値はcassandra.yamlで構成されています）。
• mergeMaxMergeCount：mergeMaxThreadCountを使用して構成する必要があります。デフォルト値は

  max(max(<maxThreadCount * 2>, <num_tokens * 8>), <maxThreadCount + 5>)

  です。ここで、num_tokensは、仮想ノード（vnode）を割り当てるトークン範囲の数値です（この数値はcassandra.yamlで構成されています）。
• ramBufferSize：デフォルトは512です。
• realtime：デフォルトはfalseです。

OPTIONS

OPTIONS { option:value [, option:value, ...] }

例

wiki.solrキースペースとテーブル、および指定したオプションで検索インデックスを作成します。

CREATE SEARCH INDEX IF NOT EXISTS ON wiki.solr WITH COLUMNS id, body {excluded : false};

CREATE SEARCH INDEX ON wiki.solr WITH CONFIG { realtime:true } AND OPTIONS { reindex : false };

透過的なデータ暗号化（TDE）を使用して検索インデックスを作成する

CREATE SEARCH INDEX IF NOT EXISTS ON wiki.solr WITH COLUMNS c1,c2 {docValues:true} AND PROFILES spaceSavingAll AND CONFIG {directoryFactory:'encrypted'};

CREATE SEARCH INDEX ON wiki.solr WITH COLUMNS * { docValues:true };

CREATE SEARCH INDEX ON wiki.solr WITH COLUMNS field1 { indexed:true }, field2 { indexed:false };

インデックスが作成されていないカラムは、HTTPクエリー結果とシングルパス・クエリー結果に含まれています。除外するには、excludedオプションを使用します。

タプルおよびUDTフィールドの制御を使用して検索インデックスを作成する

CREATE SEARCH INDEX ON wiki.solr WITH COLUMNS tuplefield.field1 {docValues:true};

検索インデックスを作成して、HTTPクエリー結果とsinglePassクエリーから除外するカラムを指定する

CREATE SEARCH INDEX ON wiki.solr WITH COLUMNS field1 { excluded:true }, field2 { excluded:false };