---
title: "行の作成"
url: https://docs.catalyst.zoho.com/ja/sdk/android/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/android/v2/cloud-scale/data-store/create-row-instance)で定義されているインスタンスです。

```bash
<ROW_INSTANCE>.create(
    success: (ZCatalystRow) → Unit,
    failure: ((ZCatalystException) → Unit)?
): ZCatalystRequest<ZCatalystResponse<ArrayList<ZCatalystRow>>>?

```

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

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

```bash
val row = ZCatalystApp.getInstance().getDataStoreInstance().getTableInstance("EmployeeDetails").newRow() //これをあなたのテーブル名に置き換えてください
    row.setColumnValue("Department_Name", "Marketing") //これをあなたの列名に置き換えてください and its value
    row.setColumnValue("Employee_ID", "109223") //これをあなたの列名に置き換えてください and its value
	row.setColumnValue("Employee_Name", "Robert Smith") //これをあなたの列名に置き換えてください and its value
    row.create(
        {
            success ->
            println("New row created successfully $success")
        },
        {
            exception ->
            println("Failed to create a new row! $exception")
        }
    )

```

### 複数行の作成

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

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

```bash
<TABLE_INSTANCE>.createRows(
    rows: ArrayList<ZCatalystRow>,
    success: (List<ZCatalystRow>) → Unit,
    failure: ((ZCatalystException) → Unit)?
): ZCatalystRequest<ZCatalystResponse<ArrayList<ZCatalystRow>>>?

```

**パラメータ**:

* `rows`: 作成する行の配列

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

```bash
ZCatalystApp.getInstance().getDataStoreInstance().getTableInstance("EmployeeDetails").createRows( //これをあなたのテーブル名に置き換えてください
	rowsList, //カラムの名前と値を設定してarrayListに追加する
        {
            rows -> println("The IDs of the rows that were successfully created are listed below:")
            for (row in rows){
                println("${row.id}")
            }
        },
        {
            exception -> println("Add Rows Failed! $exception")
        })

```