NoSQLテーブルのクエリ

# NoSQLテーブルのクエリ

Catalystでは、{{%link href="/ja/cloud-scale/help/nosql/introduction/" %}}NoSQL{{%/link%}}テーブルをクエリし、テーブルの{{%link href="/ja/cloud-scale/help/nosql/components/#table-keys" %}}プライマリキー{{%/link%}}を使用してアイテムを識別することでデータを取得できます。たとえば、パーティションキーのみ、またはパーティションキーとソートキーの組み合わせを使用してアイテムを取得できます。

{{%note%}}{{%bold%}}Note:{{%/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>

以下の例では、パーティションキー{{%badge%}}fruitType{{%/badge%}}を使用してアイテムを識別し、条件値を「Citrus」として指定して、{{%badge%}}queryTable(){{%/badge%}}メソッドでクエリを実行しています。

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

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

{{%badge%}}zcatalyst-sdk-node{{%/badge%}}パッケージの{{%badge%}}no-sql{{%/badge%}}ライブラリは、NoSQLアイテムの定義に必要です。

{{%code class="language-javascript" scroll="set-scroll" %}}const { NoSQLMarshall, NoSQLEnum } = require('zcatalyst-sdk-node/lib/no-sql');
const { NoSQLOperator } = NoSQLEnum;
// パーティションキーfruitTypeの値「citrus」で識別されるアイテムを取得するためにNoSQLテーブルをクエリする
const queriedItem = await table.queryTable({
// アイテムをクエリするためのキー条件を定義する
key_condition: {
// テーブルのパーティションキー属性名を指定する
attribute: 'fruitType',
// 使用するサポートされた演算子を定義する。BETWEEN、GREATERTHAN、LESSERTHAN、GREATERTHANOREQUALTO、LESSERTHANOREQUALTOも使用可能
operator: NoSQLOperator.EQUALS,
// 比較する値を指定する
value: NoSQLMarshall.makeString('Citrus')
},
// consistent_readをtrueに設定してマスターからクエリする。falseに設定するとスレーブからクエリされる。
consistent_read: true,
// 値を指定して返される行数を制限する
limit: 10,
// forward_scanをtrueに設定して結果を昇順にソートする。それ以外の場合は降順にソートされる。
forward_scan: true
});{{%/code%}}

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

Note: 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

以下の例では、パーティションキーfruitTypeを使用してアイテムを識別し、条件値を「Citrus」として指定して、queryTable()メソッドでクエリを実行しています。

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

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

zcatalyst-sdk-nodeパッケージのno-sqlライブラリは、NoSQLアイテムの定義に必要です。

copy

         const { NoSQLMarshall, NoSQLEnum } = require('zcatalyst-sdk-node/lib/no-sql');
const { NoSQLOperator } = NoSQLEnum;
// パーティションキーfruitTypeの値「citrus」で識別されるアイテムを取得するためにNoSQLテーブルをクエリする
const queriedItem = await table.queryTable({
// アイテムをクエリするためのキー条件を定義する
key_condition: {
// テーブルのパーティションキー属性名を指定する
attribute: 'fruitType',
// 使用するサポートされた演算子を定義する。BETWEEN、GREATERTHAN、LESSERTHAN、GREATERTHANOREQUALTO、LESSERTHANOREQUALTOも使用可能
operator: NoSQLOperator.EQUALS,
// 比較する値を指定する
value: NoSQLMarshall.makeString('Citrus')
},
// consistent_readをtrueに設定してマスターからクエリする。falseに設定するとスレーブからクエリされる。
consistent_read: true,
// 値を指定して返される行数を制限する
limit: 10,
// forward_scanをtrueに設定して結果を昇順にソートする。それ以外の場合は降順にソートされる。
forward_scan: true
});
    

最終更新日 2026-03-24 17:38:39 +0530 IST

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit

NoSQL Table Keys Query Table