---
title: "NoSQLテーブルからアイテムを取得"
url: https://docs.catalyst.zoho.com/ja/sdk/java/v1/cloud-scale/nosql/fetch-items/
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個のアイテムを取得できます。

ZCNoSQLTableインスタンスを使用して特定の属性をフィルタリングせずにデータを取得するか、リクエストの各部分を構築するために使用できるZCNoSQLFetchHelperインスタンスを使用して取得できます。

ZCNoSQLTableインスタンスでデータを取得するには、以下を使用します。

```java
//public ZCNoSQLResponseBean fetch(ZCNoSQLItem key) throws Exception;
table.fetch(<ZCNoSQLItem>);
```

ZCNoSQLFetchHelperで取得する場合

#### ZCNoSQLFetchHelper

このクラスは、テーブルからデータを取得し、特定の属性をフィルタリングするために使用できます。ZCNoSQLTableインスタンスから取得できます。

```java
//public ZCNoSQLFetchHelper getFetchHelper(ZCNoSQLItem key) throws Exception;
//public ZCNoSQLResponseBean fetch() throws Exception;
table.getFetchHelper(<ZCNoSQLItem>).fetch();
```

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

#### 必要な属性

このメソッドを使用して、特定の必要な属性のみをフィルタリングして取得できます。

```java
/public ZCNoSQLFetchHelper withRequiredAttributes(List<ZCNoSQLAttribute> requiredAttributesList) throws Exception;
table.getFetchHelper(<ZCNoSQLItem>).withRequiredAttributes(<List of ZCNoSQLAttributes>).fetch();

```

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

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

```java
//public ZCNoSQLFetchHelper withConsistency(boolean consistency) throws Exception;
table.getFetchHelper(<ZCNoSQLItem>).withConsistency(true/false).fetch();
```

必要な属性とconsistencyを指定した取得

```java
table.getFetchHelper(<ZCNoSQLItem>).withRequiredAttributes(<List of ZCNoSQLAttributes>).withConsistency(true/false).fetch();
```