NoSQLテーブルのクエリ

# NoSQLテーブルのクエリ

Catalystでは、テーブルのプライマリキーを使用してアイテムを識別し、NoSQLテーブルをクエリしてデータを取得できます。例えば、パーティションキーのみ、またはパーティションキーとソートキーの組み合わせを使用してアイテムを取得できます。

{{%note%}}{{%bold%}}注意:{{%/bold%}} Catalystでは、1回のSDK操作でNoSQLテーブルからページネーション付きで最大100個のアイテムを一括で取得できます。{{%/note%}}

属性、必要な値、および使用するサポートされている演算子を指定して、アイテムを識別するキー条件を定義できます。サポートされる演算子のリストおよびCatalystコンソールからのクエリに関するヘルプセクションを参照してください。

ZCNoSQLTableインスタンスでデータをクエリするには、以下のスニペットを使用します。

{{%code class="language-java"%}}//public ZCNoSQLResponseBean queryTable(ZCNoSQLPartitionKeyCondition partitionKeyCondition, boolean forwardScan, int limit) throws Exception;
table.query(&lt;ZCNoSQLPartitionKeyCondition&gt;, &lt;true/false&gt;, &lt;limit&gt;);
{{%/code%}}

ZCNoSQLQueryHelperでクエリする場合
ZCNoSQLQueryHelper
このクラスは、テーブルからデータをクエリし、その他の条件、ソート順、制限などを指定するために使用できます。ZCNoSQLTableインスタンスから取得できます。

{{%code class="language-java"%}}//public ZCNoSQLQueryHelper getQueryHelper(ZCNoSQLPartitionKeyCondition partitionKeyCondition, boolean forwardScan, int limit) throws Exception;
//public ZCNoSQLResponseBean queryTable() throws Exception;
table.getQueryHelper(&lt;ZCNoSQLPartitionKeyCondition&gt;, &lt;true/false&gt;, &lt;limit&gt;).queryTable();
{{%/code%}}

ZCNoSQLPartitionKeyCondition

パーティションキーの条件を構築するために使用されます。テーブルまたはインデックスからデータをクエリするために必要です。

{{%code class="language-java"%}}//public ZCNoSQLPartitionKeyCondition(ZCNoSQLAttribute attribute, ZCNoSQLValue value) throws Exception;
//public static ZCNoSQLPartitionKeyCondition getInstance(ZCNoSQLAttribute attribute, ZCNoSQLValue value) throws Exception;
new ZCNoSQLPartitionKeyCondition(&lt;ZCNoSQLAttribute&gt;, &lt;ZCNoSQLValue&gt;)
ZCNoSQLPartitionKeyCondition.getInstance(&lt;ZCNoSQLAttribute&gt;, &lt;ZCNoSQLValue&gt;)
{{%/code%}}

セカンダリキー条件
ソートキーの条件を構築するために使用されます。テーブルのクエリ時にソートキーを使用するか、追加のソートキーを使用するかを示すために使用されます。

{{%code class="language-java"%}}//public static ZCNoSQLSecondaryKeyCondition getInstance(ZCNoSQLAttribute attribute, SECONDARY_KEY_CONDITION_OPERATOR operator, ZCNoSQLValue value) throws Exception
new ZCNoSQLSecondaryKeyCondition(&lt;ZCNoSQLAttribute&gt;, &lt;SECONDARY_KEY_CONDITION_OPERATOR&gt;, &lt;ZCNoSQLValue&gt;)
ZCNoSQLSecondaryKeyCondition.getInstance(&lt;ZCNoSQLAttribute&gt;, &lt;SECONDARY_KEY_CONDITION_OPERATOR&gt;, &lt;ZCNoSQLValue&gt;)
//public ZCNoSQLQueryHelper withSecondaryKeyCondition(ZCNoSQLSecondaryKeyCondition secondaryKeyCondition, Boolean isAdditionalSortKey) throws Exception;
table.getQueryHelper(&lt;ZCNoSQLPartitionKeyCondition&gt;, &lt;true/false&gt;, &lt;limit&gt;).withSecondaryKeyCondition(&lt;ZCNoSQLSecondaryKeyCondition&gt;, &lt;true/false&gt;).queryTable();
{{%/code%}}

ZCNoSQLQueryHelperで利用可能なその他のメソッド

SECONDARY_KEY_CONDITION_OPERATOR
使用できる値は、begins_with、between、equals、greater_than、less_than、greater_equal、less_equalです。
    
その他の条件
パーティションキーとソートキー（指定した場合）を使用して取得したデータをフィルタリングするために使用できます。これはキーを使用して取得したデータの上にのみ適用されます。そのため、指定したパーティションキー、ソートキー、およびその他の条件のデータが存在しても、最大100アイテムの制限に対して、その他の条件と開始キーを適用した後に0アイテムが返されるシナリオが発生する場合があります。

{{%code class="language-java"%}}//public ZCNoSQLQueryHelper withOtherCondition(ZCNoSQLCondition otherCondition) throws Exception;
table.getQueryHelper(<ZCNoSQLPartitionKeyCondition>, <true/false>, <limit>).withOtherCondition(<ZCNoSQLCondition>).queryTable();
{{%/code%}}

開始キー
ページネーションに使用されます。テーブル/インデックスからデータをクエリした際、さらにレコードが存在する場合、開始キーが返されます。次のデータセットを取得するには、前のリクエストのレスポンスからこの値を設定する必要があります。

{{%code class="language-java"%}}//public ZCNoSQLQueryHelper withStartKey(ZCNoSQLItem startKey);
table.getQueryHelper(&lt;ZCNoSQLPartitionKeyCondition&gt;, &lt;true/false&gt;, &lt;limit&gt;).withStartKey(&lt;ZCNoSQLItem&gt;).queryTable();
{{%/code%}}

注意: Catalystでは、1回のSDK操作でNoSQLテーブルからページネーション付きで最大100個のアイテムを一括で取得できます。

ZCNoSQLTableインスタンスでデータをクエリするには、以下のスニペットを使用します。

copy

         //public ZCNoSQLResponseBean queryTable(ZCNoSQLPartitionKeyCondition partitionKeyCondition, boolean forwardScan, int limit) throws Exception;
table.query(<ZCNoSQLPartitionKeyCondition>, <true/false>, <limit>);

ZCNoSQLQueryHelperでクエリする場合 ZCNoSQLQueryHelper このクラスは、テーブルからデータをクエリし、その他の条件、ソート順、制限などを指定するために使用できます。ZCNoSQLTableインスタンスから取得できます。

copy

         //public ZCNoSQLQueryHelper getQueryHelper(ZCNoSQLPartitionKeyCondition partitionKeyCondition, boolean forwardScan, int limit) throws Exception;
//public ZCNoSQLResponseBean queryTable() throws Exception;
table.getQueryHelper(<ZCNoSQLPartitionKeyCondition>, <true/false>, <limit>).queryTable();

ZCNoSQLPartitionKeyCondition

パーティションキーの条件を構築するために使用されます。テーブルまたはインデックスからデータをクエリするために必要です。

copy

         //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>)

    

セカンダリキー条件ソートキーの条件を構築するために使用されます。テーブルのクエリ時にソートキーを使用するか、追加のソートキーを使用するかを示すために使用されます。

copy

         //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アイテムが返されるシナリオが発生する場合があります。

copy

         //public ZCNoSQLQueryHelper withOtherCondition(ZCNoSQLCondition otherCondition) throws Exception;
table.getQueryHelper(, , ).withOtherCondition().queryTable();

開始キーページネーションに使用されます。テーブル/インデックスからデータをクエリした際、さらにレコードが存在する場合、開始キーが返されます。次のデータセットを取得するには、前のリクエストのレスポンスからこの値を設定する必要があります。

copy

         //public ZCNoSQLQueryHelper withStartKey(ZCNoSQLItem startKey);
table.getQueryHelper(<ZCNoSQLPartitionKeyCondition>, <true/false>, <limit>).withStartKey(<ZCNoSQLItem>).queryTable();

最終更新日 2026-02-23 18:09:41 +0530 IST

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit

NoSQL NoSQL API