---
title: "行の取得"
url: https://docs.catalyst.zoho.com/ja/sdk/java/v1/cloud-scale/data-store/get-rows/
description: "このページでは、Javaアプリケーションでデータストアのテーブルから単一行またはすべての行を取得するメソッドについて、サンプルコードスニペットとともに説明します。"
last_updated: 2026-03-30T08:10:30Z
service: Cloud Scale
type: general
related_links:
  - name: "Get Rows - API"
    url: /ja/api/code-reference/cloud-scale/data-store/get-all-rows/#GetAllRows
  - name: "Data Store"
    url: /ja/cloud-scale/help/data-store/introduction
---

# 行の取得

[Catalyst Data Store](https://docs.catalyst.zoho.com/ja/cloud-scale/help/data-store/introduction)のテーブルから単一行または複数行のデータを取得できます。以下のサンプルコードに示すように、テーブルの一意のテーブルIDを`getTable()`メソッドに渡すことで行を取得できます。

### 単一行の取得

`getRow()`メソッドを使用して、テーブルから単一行のデータを取得できます。以下に示すように、取得したい行の一意のRow IDをこのメソッドに渡す必要があります。

まず`getInstance()`を使用してベースオブジェクトインスタンスを取得する必要があります。ベースオブジェクトインスタンスを使用して、行の取得に使用するテーブルインスタンスを取得する必要があります。

#### サンプルコードスニペット

**Package Imports**

```java
import com.zc.component.object.ZCObject; 
import com.zc.component.object.ZCRowObject;
import com.zc.component.object.ZCTable; 
```

```java
//ベースオブジェクトインスタンスZCObjectを作成する
ZCObject obj = ZCObject.getInstance(); 
//ベースオブジェクトを使用してテーブルIDを参照してテーブルインスタンスを取得する 
ZCTable tab = obj.getTable(1510000000110121L); 
//Row IDを渡してテーブルから単一行を取得する 
ZCRowObject row = tab.getRow(1510000000108103L);

```

### ページネーションによるすべての行の取得

`ZCRowPagedResponse`クラスを使用してコードにページネーションを組み込むことで、Data Storeのテーブルからすべての行を取得できます。ページネーションにより、テーブルの行をバッチまたはページ単位でイテレーションを通じて取得できます。

たとえば、個別のページとして100行ずつバッチで行を取得する場合、各ページで取得する最大行数の変数を定義し、数を指定できます。以下のサンプルコードでは`maxRows`を100に設定しています。

> **Note:** `maxRows`パラメータはオプションです。この値が指定されていない場合、SDK呼び出しはデフォルトで単一ページに200行を返します。

さらに、ループの各実行後に、後続のデータ取得を認可するトークン文字列がレスポンスに含まれます。`getNextToken()`メソッドを通じてこのトークンを取得し、以下のコードに示すように、後続のイテレーションで`nextToken`の値として渡します。ループの最初の実行時、`nextToken`文字列の値はnullとして割り当てられます。

このイテレーションは、`moreRecordsAvailable()`メソッドで検証される、すべての行が取得されるまで実行されます。

サンプルコードに示すように、テーブル名と取得するカラム名を指定できます。

> **Note:** ページネーションはJava SDK v1.7.0アップデートから利用可能になりました。古いバージョンのJava SDKでは利用できません。

#### サンプルコードスニペット

**Package Imports**

```java
import com.zc.component.object.ZCObject; 
import com.zc.component.object.ZCRowObject;
import com.zc.component.object.ZCRowPagedResponse;  
```

```java
String nextToken = null; 
//最初のnextTokenの値をnullとして宣言する
iteration ZCRowPagedResponse pagedResp; 
//ページングされたレスポンスオブジェクトを定義する 
Long maxRows = 100; 
//1ページで取得する最大行数を定義する 
do
{ 
pagedResp = ZCObject.getInstance().getTable(empDetails).getPagedRows(nextToken,
maxRows); 
//テーブル名を指定し、nextTokenとmaxRowsを渡してページングされたレスポンスを取得する 
//列名を渡してテーブルから列を取得する 
for(ZCRowObject row : pagedResp.getRows())
{ 
basicIO.write("Employee ID: " +row.get("empID") + ","); 
basicIO.write("Name: " +row.get("empName") + ","); 
basicIO.write("Department: " +row.get("empDept") + ","); } 
//反復を検証し、レスポンスで取得したトークン文字列を次の反復に渡す 
if(pagedResp.moreRecordsAvailable())
{ 
nextToken = pagedResp.getNextToken(); 
}
}
while(pagedResp.moreRecordsAvailable());

```

> **Note:** テーブルから複数行のデータを取得するために以前利用可能であった`getAllRows()`メソッドのサポートは廃止されました。ページネーションは、取得する行数の制限なくすべての行を取得できる拡張機能として利用可能です。`getAllRows()`メソッドは今後のすべてのSDKバージョンから削除されます。コードを適宜アップグレードしてください。