---
title: "行の取得"
url: https://docs.catalyst.zoho.com/ja/sdk/android/v2/cloud-scale/data-store/get-rows/
description: "指定したインスタンスのData Storeテーブルから、特定の行や全行をページネーションを使用して取得できます。"
last_updated: 2026-03-30T08:10:30Z
service: Cloud Scale
type: general
related_links:
  - name: "Data Store"
    url: /ja/cloud-scale/help/data-store/introduction
  - name: "Records"
    url: /ja/cloud-scale/help/data-store/records
  - name: "Get All Rows - API"
    url: /ja/api/code-reference/cloud-scale/data-store/get-all-rows/#GetAllRows
---

# 行の取得

### 特定の行の取得

`getRow()`メソッドを使用して、指定したインスタンスの[Data Store](https://docs.catalyst.zoho.com/ja/cloud-scale/help/data-store/introduction)テーブルから特定の行を取得できます。以下のコード構文に示すように、行の一意のROWIDを引数としてこのメソッドに渡します。

以下のコードで使用する`<TABLE_INSTANCE>`は、[テーブルインスタンスページ](https://docs.catalyst.zoho.com/ja/sdk/android/v2/cloud-scale/data-store/create-table-instance)で定義されているインスタンスです。

```bash
<TABLE_INSTANCE>.getRow(
    id: Long,
    success: (ZCatalystRow) → Unit,
    failure: ((ZCatalystException) → Unit)?
): ZCatalystRequest<ZCatalystResponse<ZCatalystRow>>?

```

**パラメータ**:

* `id`: 取得する必要がある特定の行の[一意のROWID](https://docs.catalyst.zoho.com/ja/cloud-scale/help/data-store/records/#create-a-new-record)

以下にサンプルコードスニペットを示します：

```bash
val table = ZCatalystApp.getInstance().getDataStoreInstance().getTableInstance("EmployeeDetails") //これをあなたのテーブル名に置き換えてください
    table.getRow(2823000000014176, //ここに行IDを入力してください
        {
            row -> println("Get Row Success")
            println(" The row details are: ${row.getData()}")
        },
        {
            exception ->
            println("Get row failed! $exception")
        })

```

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

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

たとえば、行を100件ずつのバッチで個別のページとして取得する場合、各ページで取得する最大行数を定義し、以下のように`maxRows`を使用してカウントを指定できます。

以下のコードスニペットで使用する`<TABLE_INSTANCE>`は、[テーブルインスタンスページ](https://docs.catalyst.zoho.com/ja/sdk/android/v2/cloud-scale/data-store/create-table-instance)で定義されているインスタンスです。

```bash
<TABLE_INSTANCE>.getRows(maxRows: Int, success: (List<ZCatalystRow>, ResponseInfo) -> Unit, failure: ((ZCatalystException) -> Unit)? = null): ZCatalystRequest<ZCatalystResponse<ArrayList<ZCatalystRow>>>?
```

**パラメータ**:

* `maxRows`: このイテレーションで取得する最大行数

以下にサンプルコードスニペットを示します：

```bash
ZCatalystApp.getInstance().getDataStoreInstance().getTableInstance("EmployeeDetails").getRows( 10,
    {
           rows, info  ->{
        println("The token for next set of rows -  ${info.nextToken}")
        println("Boolean to know if there are records in next page - ${info.moreRecords}")
    } 
    },
    {
        exception -> println("Failed to get the rows! $exception")
})
```

さらに、ループの各実行後に、後続のデータ取得を許可するトークン文字列がレスポンスで返されます。このトークンは`info.nextToken`を通じて取得でき、後続のイテレーションで`nextToken`の値として渡します。ループの最初の実行時には、`nextToken`文字列は渡しません。

コードスニペットに示すように、`info.moreRecords`を通じて取得待ちの行数を確認することもできます。

ページネーションを続行する場合は、nextTokenと`maxRows`を渡して次の行セットを取得できます。以下のように行います。

```bash
<TABLE_INSTANCE>.getRows(nextToken: String, maxRows: Int, success: (List<ZCatalystRow>, ResponseInfo) -> Unit, failure: ((ZCatalystException) -> Unit)? = null): ZCatalystRequest<ZCatalystResponse<ArrayList<ZCatalystRow>>>?
```

**パラメータ**:

* `maxRows`: このイテレーションで取得する最大行数
* `nextToken`: 次の行セットを取得するための認可トークン

以下にサンプルコードスニペットを示します：

```bash
ZCatalystApp.getInstance().getDataStoreInstance().getTableInstance("EmployeeDetails").getRows( "1000.6f********" , 20 ,
    {
        rows, info  ->{
        println("The token for next set of rows -  ${info.nextToken}")
        println("Boolean to know if there are records in next page - ${info.moreRecords}")
    } 
    },
    {
        exception -> println("Failed to get the rows! $exception")
})
```

`info.moreRecords`が`FALSE`を返すまで、`nextToken`と`moreRecords`の情報を取得できます。

最初のイテレーション後に残りの全行を取得し、`maxRows`の制限を設定しない場合は、以下の方法で行うことができます：

```bash
<TABLE_INSTANCE>.getRows(nextToken: String, success: (List<ZCatalystRow>, ResponseInfo) -> Unit, failure: ((ZCatalystException) -> Unit)? = null):  ZCatalystRequest<ZCatalystResponse<ArrayList<ZCatalystRow>>>?
```

**パラメータ**:
* `nextToken`: 次の行セットを取得するための認可トークン

以下にサンプルコードスニペットを示します：

```bash
ZCatalystApp.getInstance().getDataStoreInstance().getTableInstance("EmployeeDetails").getRows( "1000.6f********", 
    {
          rows, info  ->{
        println("The token for next set of rows -  ${info.nextToken}")
        println("Boolean to know if there are records in next page - ${info.moreRecords}")
    } 
    },
    {
        exception -> println("Failed to get the rows! $exception")
})
```

これにより、`info.moreRecords`は`FALSE`を返します。

### 全行の取得

以下のコード構文に示すように、`getRows()`メソッドを使用して、指定したインスタンスのテーブルの全行を取得できます。操作が成功した場合、このメソッドはフィルターや条件なしでテーブルの全行を返します。

以下のコード構文で使用する`<TABLE_INSTANCE>`は、[テーブルインスタンスページ](https://docs.catalyst.zoho.com/ja/sdk/android/v2/cloud-scale/data-store/create-table-instance)で定義されているインスタンスです。

```bash
<TABLE_INSTANCE>.getRows(
    success: (List<ZCatalystRow>,ResponseInfo) → Unit,
    failure: ((ZCatalystException) → Unit)?= null):
): ZCatalystRequest<ZCatalystResponse<ArrayList<ZCatalystRow>>>?

```

以下にサンプルコードスニペットを示します：

```bash
val table = ZCatalystApp.getInstance().getDataStoreInstance().getTableInstance("EmployeeDetails") //これをあなたのテーブル名に置き換えてください
        table.getRows(
            {
            rows, info  ->{
        		println("The token for next set of rows -  ${info.nextToken}")
        		println("Boolean to know if there are records in next page - ${info.moreRecords}")
    } 
    },
    {
        exception -> println("Failed to get the rows! $exception")
    })

```

> **Note:** これは全行を取得する操作のため、`info.nextToken`は無視できます。ページネーションなしで利用可能な全行が返されます。全行が取得された場合、`info.moreRecords`も`FALSE`を返します。