--- title: "NoSQLテーブルのクエリ" url: https://docs.catalyst.zoho.com/ja/sdk/java/v1/cloud-scale/nosql/query-table/ description: "Catalyst NoSQLは、非リレーショナル、非SQLのデータストレージ手段を提供する完全マネージドの強力なデータベースです。このページでは、NoSQLテーブルのメタデータを取得するSDKメソッドについて説明します。" last_updated: 2026-02-23T12:39:41Z service: Cloud Scale type: general related_links: - name: "NoSQL" url: /ja/cloud-scale/help/nosql/introduction/ - name: "NoSQL API" url: /ja/api/code-reference/cloud-scale/nosql/insert-item/#InsertNewItem --- # NoSQLテーブルのクエリ Catalystでは、テーブルのプライマリキーを使用してアイテムを識別し、NoSQLテーブルをクエリしてデータを取得できます。例えば、パーティションキーのみ、またはパーティションキーとソートキーの組み合わせを使用してアイテムを取得できます。 > **注意:** Catalystでは、1回のSDK操作でNoSQLテーブルからページネーション付きで最大100個のアイテムを一括で取得できます。 属性、必要な値、および使用するサポートされている演算子を指定して、アイテムを識別するキー条件を定義できます。サポートされる演算子のリストおよびCatalystコンソールからのクエリに関するヘルプセクションを参照してください。 ZCNoSQLTableインスタンスでデータをクエリするには、以下のスニペットを使用します。 ```java //public ZCNoSQLResponseBean queryTable(ZCNoSQLPartitionKeyCondition partitionKeyCondition, boolean forwardScan, int limit) throws Exception; table.query(<ZCNoSQLPartitionKeyCondition>, <true/false>, <limit>); ``` ZCNoSQLQueryHelperでクエリする場合 ZCNoSQLQueryHelper このクラスは、テーブルからデータをクエリし、その他の条件、ソート順、制限などを指定するために使用できます。ZCNoSQLTableインスタンスから取得できます。 ```java //public ZCNoSQLQueryHelper getQueryHelper(ZCNoSQLPartitionKeyCondition partitionKeyCondition, boolean forwardScan, int limit) throws Exception; //public ZCNoSQLResponseBean queryTable() throws Exception; table.getQueryHelper(<ZCNoSQLPartitionKeyCondition>, <true/false>, <limit>).queryTable(); ``` ZCNoSQLPartitionKeyCondition パーティションキーの条件を構築するために使用されます。テーブルまたはインデックスからデータをクエリするために必要です。 ```java //public ZCNoSQLPartitionKeyCondition(ZCNoSQLAttribute attribute, ZCNoSQLValue value) throws Exception; //public static ZCNoSQLPartitionKeyCondition getInstance(ZCNoSQLAttribute attribute, ZCNoSQLValue value) throws Exception; new ZCNoSQLPartitionKeyCondition(<ZCNoSQLAttribute>, <ZCNoSQLValue>) ZCNoSQLPartitionKeyCondition.getInstance(<ZCNoSQLAttribute>, <ZCNoSQLValue>) ``` セカンダリキー条件 ソートキーの条件を構築するために使用されます。テーブルのクエリ時にソートキーを使用するか、追加のソートキーを使用するかを示すために使用されます。 ```java //public static ZCNoSQLSecondaryKeyCondition getInstance(ZCNoSQLAttribute attribute, SECONDARY_KEY_CONDITION_OPERATOR operator, ZCNoSQLValue value) throws Exception new ZCNoSQLSecondaryKeyCondition(<ZCNoSQLAttribute>, <SECONDARY_KEY_CONDITION_OPERATOR>, <ZCNoSQLValue>) ZCNoSQLSecondaryKeyCondition.getInstance(<ZCNoSQLAttribute>, <SECONDARY_KEY_CONDITION_OPERATOR>, <ZCNoSQLValue>) //public ZCNoSQLQueryHelper withSecondaryKeyCondition(ZCNoSQLSecondaryKeyCondition secondaryKeyCondition, Boolean isAdditionalSortKey) throws Exception; table.getQueryHelper(<ZCNoSQLPartitionKeyCondition>, <true/false>, <limit>).withSecondaryKeyCondition(<ZCNoSQLSecondaryKeyCondition>, <true/false>).queryTable(); ``` ZCNoSQLQueryHelperで利用可能なその他のメソッド SECONDARY_KEY_CONDITION_OPERATOR 使用できる値は、begins_with、between、equals、greater_than、less_than、greater_equal、less_equalです。 その他の条件 パーティションキーとソートキー（指定した場合）を使用して取得したデータをフィルタリングするために使用できます。これはキーを使用して取得したデータの上にのみ適用されます。そのため、指定したパーティションキー、ソートキー、およびその他の条件のデータが存在しても、最大100アイテムの制限に対して、その他の条件と開始キーを適用した後に0アイテムが返されるシナリオが発生する場合があります。 ```java //public ZCNoSQLQueryHelper withOtherCondition(ZCNoSQLCondition otherCondition) throws Exception; table.getQueryHelper(, , ).withOtherCondition().queryTable(); ``` 開始キー ページネーションに使用されます。テーブル/インデックスからデータをクエリした際、さらにレコードが存在する場合、開始キーが返されます。次のデータセットを取得するには、前のリクエストのレスポンスからこの値を設定する必要があります。 ```java //public ZCNoSQLQueryHelper withStartKey(ZCNoSQLItem startKey); table.getQueryHelper(<ZCNoSQLPartitionKeyCondition>, <true/false>, <limit>).withStartKey(<ZCNoSQLItem>).queryTable(); ```