---
title: "行の取得"
url: https://docs.catalyst.zoho.com/ja/sdk/ios/v2/cloud-scale/data-store/get-rows/
description: "指定されたインスタンスのData Storeテーブルから、特定の行またはすべての行をページネーション付きで取得できます。"
last_updated: 2026-03-24T12:08:39Z
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をこのメソッドの引数として渡します。

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

```bash
<DATA_STORE_INSTANCE>.getRow(id : Int64, completion: @escaping (Result<ZCatalystRow, ZCatalystError>) -> Void)
```

**パラメータ**:

* `id`: 取得する特定の行の[一意のROWID](https://docs.catalyst.zoho.com/ja/cloud-scale/help/data-store/records/#create-a-new-record)
* `completion`: 操作が成功した場合、completionブロックは行の詳細を返します。それ以外の場合は、エラーを返します。

サンプルコードスニペットは以下の通りです:

```bash
ZCatalystApp.shared.getDataStoreInstance(tableIdentifier : "EmployeeDetails").getRow(id: 1096000000002845){( result ) in
// これをあなたのテーブル識別子とROW IDに置き換えてください       
switch result{
  case .success ( let row) :
   print(row.id)
  case .error( let error ) :
   print( "Error occurred >>> \( error )" )
 }
}

```

### ページネーションを使用して行を取得する

ページネーションをコードに組み込むことで、Data Storeのテーブルからすべての行を取得できます。ページネーションを使用すると、テーブルの行をバッチまたはページとして反復的に取得できます。

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

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

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

```bash
<DATA_STORE_INSTANCE>.getRows(nextToken : String?, maxRecord : String?, completion: @escaping (Result<[ZCatalystRow], ZCatalystError>) -> Void)
```

**パラメータ**:

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

最初の反復後にすべての残りの行を取得する場合は、`maxRows`の制限を渡さないこともできます。すべての行が取得されると、ページネーションは完了します。

### すべての行を取得する

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

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

```bash
<DATA_STORE_INSTANCE>.getRows(completion: @escaping (Result<[ZCatalystRow], ZCatalystError>) -> Void)
```

**パラメータ**:

* `completion`: 操作が成功した場合、completionブロックはすべての行の詳細を返します。それ以外の場合は、エラーを返します。

サンプルコードスニペットは以下の通りです:

```bash
ZCatalystApp.shared.getDataStoreInstance(tableIdentifier : "EmployeeDetails").getRows{ ( result ) in      
//これをあなたのテーブル名に置き換えてください             
switch result{
  case .success ( let rows) :
   for row in rows{
    print(row.id)
   }
  case .error( let error ) :
   print( "Error occurred >>> \( error )" )
 }
}

```