---
title: "テーブルのクエリ"
url: https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/nosql/query-table/
description: "Catalyst NoSQLは、非リレーショナル・非SQLのデータストレージ手段を提供する、完全マネージドで強力なデータベースです。このページでは、NoSQLテーブルをクエリするSDKメソッドについて説明します。"
last_updated: 2026-03-30T08:10:30Z
service: Cloud Scale
type: general
related_links:
  - name: "NoSQL"
    url: /ja/cloud-scale/help/nosql/introduction
  - name: "Table Keys"
    url: /ja/cloud-scale/help/nosql/components/#table-keys
  - name: "Query Table"
    url: /ja/sdk/nodejs/v2/cloud-scale/nosql/query-table/
---

# NoSQLテーブルのクエリ

Catalystでは、テーブルの[プライマリキー](https://docs.catalyst.zoho.com/ja/cloud-scale/help/nosql/components/#table-keys)を使用してアイテムを識別し、[NoSQL](https://docs.catalyst.zoho.com/ja/cloud-scale/help/nosql/introduction/)テーブルをクエリしてデータを取得できます。たとえば、パーティションキーのみ、またはパーティションキーとソートキーの組み合わせを使用してアイテムを取得できます。

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

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

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

<table class="content-table nosql-components-table">

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

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

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

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

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