OpenSearch:cluster 句

概要

cluster 句はオプションです。cluster 句を使用すると、クエリを実行するクラスター内のパーティションを指定できます。

構文

パーティションフィールド値の指定

{
  "cluster" : {  
    "hash_field" : []
  }
}

hash_field パラメーターは、パーティションフィールドの元の値を指定します。このパラメーターには複数の値を指定できます。OpenSearch Retrieval Engine Edition は、指定した値をハッシュ化し、対応するパーティションの ID を計算してから、パーティション内のデータに対してクエリを実行します。例：

# 123 と 456 のハッシュ値に対応するパーティション内のデータにクエリを実行します。
{
  "cluster" : {  
    "hash_field" : ["123", "456"]
  }
}

# abc のハッシュ値に対応するパーティション内のデータにクエリを実行します。
{
  "cluster" : {  
    "hash_field" : ["abc"]
  }
}

ドキュメントハッシュ ID の指定

{
  "cluster" : {  
    "part_ids" : []
  }
}

クエリ結果からパーティション内のドキュメントのハッシュ ID が返された場合は、ドキュメントのハッシュ ID を指定して、パーティション内のデータに対してクエリを実行できます。パーティション内のドキュメントのハッシュ ID は、0 から 65535 の範囲内である必要があります。たとえば、クラスターに 2 つのパーティションがある場合、1 つのパーティション内のドキュメントのハッシュ ID は 0 から 32767 の範囲内、もう 1 つのパーティション内のドキュメントのハッシュ ID は 32768 から 65535 の範囲内である必要があります。指定したドキュメントのハッシュ ID がパーティションのハッシュ ID 範囲内にある場合、パーティション内のデータに対してクエリが実行されます。例：

# ハッシュ ID 123 と 8790 に対応するパーティション内のデータにクエリを実行します。
{
  "cluster" : {
    "part_ids" : [123,8790]
  }
}

使用上の注意

• cluster 句では、hash_field パラメーターと part_ids パラメーターのいずれか 1 つのみを指定できます。