---
title: "行の作成"
url: https://docs.catalyst.zoho.com/ja/sdk/ios/v2/cloud-scale/data-store/create-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: "Insert Row - API"
    url: /ja/api/code-reference/cloud-scale/data-store/insert-new-row/#InsertNewRow
---

# 行の作成

### 単一の行を作成する

以下に示すように、`newRow()`メソッドを使用して、指定されたインスタンスの[Data Store](https://docs.catalyst.zoho.com/ja/cloud-scale/help/data-store/introduction)テーブルに新しい行を作成できます。テーブル内の行の値を、カラム名と対応する行の値をキーと値のペアとして指定して設定する必要があります。

以下のコード構文で使用されている`<ROW_INSTANCE>`は、[行インスタンスページ](https://docs.catalyst.zoho.com/ja/sdk/ios/v2/cloud-scale/data-store/create-new-row-instance)で定義されたインスタンスです。カラム値は、[カラム値の追加ページ](https://docs.catalyst.zoho.com/ja/sdk/ios/v2/cloud-scale/data-store/add-column-value-to-row)で説明されているメソッドを使用して設定されます。

**パラメータ**:

* `completion`: 操作が成功した場合、completionブロックは作成された行の詳細（一意のROWIDやその他のメタ情報など）を返します。それ以外の場合は、エラーを返します。

> **Note:** `is_unique`または`is_mandatory`プロパティを有効にしてカラムを作成した場合、それぞれ値が一意であること、または値が必ず渡されることを確認する必要があります。また、カラムに渡すデータがカラムの設定されたデータ型であることも確認する必要があります。 

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

```bash
let instance = ZCatalystApp.shared.getDataStoreInstance(tableIdentifier: "1096000000002071").newRow() //これをあなたのテーブルIDに置き換えてください
instance.setColumnValue(columnName: "Department_Name", value: "Marketing")
instance.setColumnValue(columnName: "Employee_Name", value: "Linda Page")
//これをあなたの列名に置き換えてください and value
instance.create() {(result) in
switch result{
  case .success ( let row) :
   print("A new row is successfully created with row id /(row.id)")
  case .error( let error ) :
   print( "Error occurred >>> \( error )" )
 }
}

```

### 複数の行を作成する

iOS SDKでは、指定されたインスタンスのテーブルに一度に複数の行を作成できます。テーブルに挿入する行を含む配列を渡すことで実行します。以下のコード構造に示すように、配列を`create()`メソッドの引数として渡します。

[行インスタンスページ](https://docs.catalyst.zoho.com/ja/sdk/ios/v2/cloud-scale/data-store/create-new-row-instance)で説明されているように各行のインスタンスを作成した後、`<ROW_INSTANCE>`の配列を渡す必要があります。カラム値は、[カラム値の追加ページ](https://docs.catalyst.zoho.com/ja/sdk/ios/v2/cloud-scale/data-store/add-column-value-to-row)で説明されているように設定する必要があります。

以下のコードで使用されている`<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>.create(_ rows: [ ZCatalystRow ], completion: @escaping(Result<[ZCatalystRow], ZCatalystError>) -> Void)
```

**パラメータ**:

* `rows`: 作成する行の配列
* `completion`: 操作が成功した場合、completionブロックは作成された行の詳細（ROWIDやその他のメタ情報など）を返します。それ以外の場合は、エラーを返します。

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

```bash
let row_instance1 = ZCatalystApp.shared.getDataStoreInstance(tableIdentifier: "1096000000002071").newRow() //ここにテーブルIDを入力してください
row_instance1.setColumnValue(columnName: "Department_Name", value: "Marketing")
row_instance1.setColumnValue(columnName: "Employee_Name", value: "Robert Jones")
//これをあなたの列名に置き換えてください and value
let row_instance2 = ZCatalystApp.shared.getDataStoreInstance(tableIdentifier: "1096000000002071").newRow()
//これをあなたのテーブルIDに置き換えてください
row_instance2.setColumnValue(columnName: "Department_Name", value: "Finance")
row_instance2.setColumnValue(columnName: "Employee_Name", value: "Louis Smith")
//これをあなたの列名に置き換えてください and value
ZCatalystApp.shared.getDataStoreInstance(tableIdentifier: "1096000000002071").create([row_instance1, row_instance2]) {(result) in
switch result{
  case .success ( let rows) :
   print("The rows ids which are successfully created are listed below")
    for row in rows{
     print(row.id)
    }
  case .error( let error ) :
   print( "Error occurred >>> \( error )" )
 }
}

```