NoSQLテーブルからのアイテムの取得

Catalystでは、NoSQLテーブルから、プライマリキーを使用してアイテムを識別し、取得できます。たとえば、パーティションキーのみ、またはパーティションキーとソートキーの組み合わせを使用してアイテムを取得できます。また、必要な属性を指定して、取得する属性をオプションでフィルタリングすることもできます。

以下の例では、fetchItem()を使用して、パーティションキーfruitの値が「apple」であるアイテムを取得しています。required_attributesを使用して、propertiesやtasteなどの特定の属性がフィルタリングされて取得されます。

このコードスニペットでは、consistent_readを使用して、読み取り操作をマスタークラスターまたはスレーブクラスターのどちらで実行するかを指定しています。trueに設定すると、マスターからクエリされます。falseの場合、スレーブからクエリされます。

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

const { NoSQLItem } = require('zcatalyst-sdk-node/lib/no-sql');
//パーティションキー値「apple」で識別されるNoSQLItemのプロパティを取得する
const fetchedItem = await table.fetchItem({
// 取得するアイテムのパーティションキーと値を定義する
keys: [new NoSQLItem().addString('fruit', 'apple')],
// consistent_readをtrueに設定してマスターからクエリする。falseに設定するとスレーブからクエリされる。
consistent_read: true,
// 取得する属性を指定する
required_attributes: [['properties', 'taste']]
});