---
title: "テーブルからのアイテムの取得"
url: https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/cloud-scale/nosql/fetch-items/
description: "Catalyst NoSQLは、非リレーショナルかつ非SQLのデータストレージ手段を提供する、フルマネージドで強力なデータベースです。このページでは、NoSQLテーブルからアイテムを取得するためのSDKメソッドについて説明します。"
last_updated: 2026-03-24T12:08:39Z
service: Cloud Scale
type: general
related_links:
  - name: "NoSQL"
    url: /ja/cloud-scale/help/nosql/introduction
  - name: "Basic Components"
    url: /ja/cloud-scale/help/nosql/components/#basic-components
  - name: "Working with Data"
    url: /ja/cloud-scale/help/nosql/working-with-data/introduction/
  - name: "NoSQL API"
    url: /ja/api/code-reference/cloud-scale/nosql/fetch-item/#FetchItem
---

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

Catalystでは、[NoSQL](https://docs.catalyst.zoho.com/ja/cloud-scale/help/nosql/introduction/)テーブルから、[プライマリキー](https://docs.catalyst.zoho.com/ja/cloud-scale/help/nosql/components/#table-keys)を使用してアイテムを識別し、取得できます。たとえば、パーティションキーのみ、またはパーティションキーとソートキーの組み合わせを使用してアイテムを取得できます。また、必要な属性を指定して、取得する属性をオプションでフィルタリングすることもできます。

> **Note:** Catalystでは、1回のSDK読み取り操作でNoSQLテーブルから最大100件のアイテムを取得できます。

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

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

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

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

```javascript
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']]
});
```