インデックスのクエリ

# インデックスのクエリ

Catalystでは、インデックスの{{%link href="/ja/cloud-scale/help/nosql/components/#table-keys" %}}プライマリキー{{%/link%}}を使用してアイテムを識別し、{{%link href="/ja/cloud-scale/help/nosql/introduction/" %}}NoSQL{{%/link%}}インデックスをクエリしてデータを取得できます。インデックスを使用すると、メインテーブルのプライマリキーを使用せずに、テーブルデータに対して代替クエリを実行できます。Catalystコンソールからインデックスを設定できます。インデックスのパーティションキーのみ、またはパーティションキーとソートキーの組み合わせを使用してアイテムを取得できます。

{{%note%}}{{%bold%}}注意：{{%/bold%}} Catalystでは、1回のSDK操作でページネーションを使用してNoSQLテーブルから最大100アイテムを一括取得できます。SDKレスポンスで受け取った{{%badge%}}start_key{{%/badge%}}トークンを使用して、ページネーションのロジックを構築する必要があります。{{%/note%}}

属性、その必要な値、使用するサポートされる演算子を指定して、アイテムを識別するキー条件を定義できます。グループ演算子で追加条件を指定することもできます。

サポートされる演算子は以下のように表されます。

<thead>
        <tr>
            <th class="w10p">Operators</th>
            <th class="w10p">Notation</th>
        </tr>
</thead>
<tbody>
    <tr>
        <td>CONTAINS</td>
        <td>{{%badge%}}contains{{%/badge%}}</td>
    </tr>
    <tr>
        <td>NOT_CONTAINS</td>
        <td>{{%badge%}}not_contains{{%/badge%}}</td>
    </tr>
    <tr>
        <td>BEGINS_WITH</td>
        <td>{{%badge%}}begins_with{{%/badge%}}</td>
    </tr>
    <tr>
       <td>ENDS_WITH</td>
        <td>{{%badge%}}ends_with{{%/badge%}}</td>
    </tr>
    <tr>
        <td>IN</td>
        <td>{{%badge%}}in{{%/badge%}}</td>
    </tr>
    <tr>
        <td>NOT_IN</td>
        <td>{{%badge%}}not_in{{%/badge%}}</td>
    </tr>
    <tr>
        <td>BETWEEN</td>
        <td>{{%badge%}}between{{%/badge%}}</td>
    </tr>
    <tr>
        <td>NOT_BETWEEN</td>
        <td>{{%badge%}}not_between{{%/badge%}}</td>
    </tr>
    <tr>
        <td>EQUALS</td>
        <td>{{%badge%}}equals{{%/badge%}}</td>
    </tr>
    <tr>
        <td>NOT_EQUALS</td>
        <td>{{%badge%}}not_equals{{%/badge%}}</td>
    </tr>
	<tr>
        <td>GREATER_THAN</td>
        <td>{{%badge%}}greater_than{{%/badge%}}</td>
    </tr>
	<tr>
        <td>LESS_THAN</td>
        <td>{{%badge%}}less_than{{%/badge%}}</td>
    </tr>
	<tr>
        <td>GREATER_THAN_OR_EQUALS</td>
        <td>{{%badge%}}greater_equal{{%/badge%}}</td>
    </tr>
	<tr>
        <td>LESSER_THAN_OR_EQUALS</td>
        <td>{{%badge%}}less_equal{{%/badge%}}</td>
    </tr>
	<tr>
        <td>AND</td>
        <td>{{%badge%}}AND{{%/badge%}}</td>
    </tr>
	<tr>
        <td>OR</td>
        <td>{{%badge%}}OR{{%/badge%}}</td>
    </tr>
</tbody>
</table>
<br>

以下の例では、一意のインデックスIDで参照されるインデックスを使用してクエリを実行しています。クエリはインデックスのパーティションキー{{%badge%}}fruitColor{{%/badge%}}を使用してアイテムを識別し、条件値を「yellow」として指定しています。また、属性{{%badge%}}fruitType{{%/badge%}}が「citrus」に一致する追加条件も指定しています。クエリは{{%badge%}}query_index(){{%/badge%}}メソッドを使用して実行されます。

Catalyst NoSQLでは、{{%badge%}}consistent_read{{%/badge%}}を使用して読み取り操作をマスターまたはスレーブクラスターのどちらで実行するかを示す、返される行数の制限、昇順でのソート順の指定など、クエリの他の要素も定義できます。

{{%note%}}{{%bold%}}注意：{{%/bold%}} マスター・スレーブレプリケーションでは、マスターにはデータベースのすべてのデータが含まれ、スレーブにはマスターからのコピーが含まれます。スレーブから読み取り操作を実行すると、更新されたデータの反映に若干の遅延があるというトレードオフで、全体的なコストを削減できます。{{%/note%}}

{{%code class="language-python" scroll="set-scroll" %}}
# パーティションキーfruitColourの値が"yellow"であるアイテムを取得するためにNoSQLテーブルインデックスをクエリする# インデックスの一意のIDを渡す
cres = table.query_index('6759000000740017', {
  # consistent_readをtrueに設定してマスターからクエリする。falseの場合、スレーブからクエリされる。
   'consistent_read': 'true',# forward_scanをtrueに設定して結果を昇順でソートする。それ以外の場合は降順でソートされる。
   'forwardScan': 'true',# 値を指定して返される行数を制限する
   'limit': 10,# アイテムをクエリするためのキー条件を定義する
   'key_condition': {
    'attribute': 'fruitColor',
    'operator': 'equals',
   'value': {
     'S': 'yellow'
    }
   },
   # グループ演算子を使用してデータをクエリするための追加条件を定義する
   'other_condition': {
    'group_operator': 'AND',
    'group': [
     {
      'attribute': 'fruitType',
      'operator': 'equals',
      'value': {
       'S': 'citrus'
      }
     }
    ]
   } 
 })
print(res){{%/code%}}

Catalystでは、インデックスのプライマリキーを使用してアイテムを識別し、NoSQLインデックスをクエリしてデータを取得できます。インデックスを使用すると、メインテーブルのプライマリキーを使用せずに、テーブルデータに対して代替クエリを実行できます。Catalystコンソールからインデックスを設定できます。インデックスのパーティションキーのみ、またはパーティションキーとソートキーの組み合わせを使用してアイテムを取得できます。

注意： Catalystでは、1回のSDK操作でページネーションを使用してNoSQLテーブルから最大100アイテムを一括取得できます。SDKレスポンスで受け取ったstart_keyトークンを使用して、ページネーションのロジックを構築する必要があります。

サポートされる演算子は以下のように表されます。

Operators	Notation
CONTAINS	contains
NOT_CONTAINS	not_contains
BEGINS_WITH	begins_with
ENDS_WITH	ends_with
IN	in
NOT_IN	not_in
BETWEEN	between
NOT_BETWEEN	not_between
EQUALS	equals
NOT_EQUALS	not_equals
GREATER_THAN	greater_than
LESS_THAN	less_than
GREATER_THAN_OR_EQUALS	greater_equal
LESSER_THAN_OR_EQUALS	less_equal
AND	AND
OR	OR

以下の例では、一意のインデックスIDで参照されるインデックスを使用してクエリを実行しています。クエリはインデックスのパーティションキーfruitColorを使用してアイテムを識別し、条件値を「yellow」として指定しています。また、属性fruitTypeが「citrus」に一致する追加条件も指定しています。クエリはquery_index()メソッドを使用して実行されます。

Catalyst NoSQLでは、consistent_readを使用して読み取り操作をマスターまたはスレーブクラスターのどちらで実行するかを示す、返される行数の制限、昇順でのソート順の指定など、クエリの他の要素も定義できます。

注意： マスター・スレーブレプリケーションでは、マスターにはデータベースのすべてのデータが含まれ、スレーブにはマスターからのコピーが含まれます。スレーブから読み取り操作を実行すると、更新されたデータの反映に若干の遅延があるというトレードオフで、全体的なコストを削減できます。

copy

         
# パーティションキーfruitColourの値が"yellow"であるアイテムを取得するためにNoSQLテーブルインデックスをクエリする# インデックスの一意のIDを渡す
cres = table.query_index('6759000000740017', {
  # consistent_readをtrueに設定してマスターからクエリする。falseの場合、スレーブからクエリされる。
   'consistent_read': 'true',# forward_scanをtrueに設定して結果を昇順でソートする。それ以外の場合は降順でソートされる。
   'forwardScan': 'true',# 値を指定して返される行数を制限する
   'limit': 10,# アイテムをクエリするためのキー条件を定義する
   'key_condition': {
    'attribute': 'fruitColor',
    'operator': 'equals',
   'value': {
     'S': 'yellow'
    }
   },
   # グループ演算子を使用してデータをクエリするための追加条件を定義する
   'other_condition': {
    'group_operator': 'AND',
    'group': [
     {
      'attribute': 'fruitType',
      'operator': 'equals',
      'value': {
       'S': 'citrus'
      }
     }
    ]
   } 
 })
print(res)
    

最終更新日 2026-03-30 13:40:30 +0530 IST

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit

NoSQL Table Keys Query Index