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

# 行の挿入

テーブルの一意のIDまたは名前を参照して、[Data Store](https://docs.catalyst.zoho.com/ja/cloud-scale/help/data-store/introduction)のテーブルに新しいデータ行またはレコードを挿入できます。次のセクションで説明するように、テーブルに複数の行を挿入することもできます。

> **Note:**

1. テーブルとそのカラムは事前に作成しておく必要があります。コンソールから[テーブルを作成](https://docs.catalyst.zoho.com/ja/cloud-scale/help/data-store/tables/#create-a-new-table)し、[カラムを作成](https://docs.catalyst.zoho.com/ja/cloud-scale/help/data-store/columns/#create-a-new-column)できます。

2. [開発環境](https://docs.catalyst.zoho.com/ja/deployment-and-billing//environments/introduction)では、プロジェクトごとに各テーブルに最大5,000レコードを挿入できます。開発環境ではプロジェクト全体で最大25,000レコードを作成できます。本番環境ではレコード作成の上限はありません。

### 単一行の挿入

以下のサンプルコードに示すように、行インスタンスを作成し、カラム名とそれに対応する値を渡す必要があります。`insertRow()`メソッドは、一意の名前またはIDで参照して作成したインスタンスのテーブルに行を挿入します。行が挿入されると、その行の一意の`RowID`値が自動的に生成されます。

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

**Package Imports**

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

```java
 //ベースオブジェクトインスタンスを作成する 
ZCObject object = ZCObject.getInstance(); 
//ベースオブジェクトのtableIDを参照してテーブルインスタンスを取得する 
ZCTable tab = object.getTable("1510000000110121"); 
//行インスタンスを作成する 
ZCRowObject row = ZCRowObject.getInstance(); 
//行インスタンスのset()メソッドを使用して必要な列の値を設定する 
row.set("Name","George Smith"); 
row.set("Age", 25); 
//insertRow()メソッドを呼び出してテーブルに単一行を追加する 
tab.insertRow(row);

```

### 複数行の挿入

以下に示すように、行オブジェクトのリストを構築し、`insertRows()`メソッドの引数として渡すことで、テーブルに複数の行を挿入できます。

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

**Package Imports**

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

```java
 //RowObjectsのリストを作成する 
List rows = new ArrayList(); 
//ベースオブジェクトインスタンスを作成する 
ZCObject object = ZCObject.getInstance(); 
//ベースオブジェクトのtableIDを参照してテーブルインスタンスを取得する 
ZCTable tab = object.getTable(1510000000110121L); 
//必要な数の行インスタンスを作成する 
ZCRowObject row1 = ZCRowObject.getInstance();
ZCRowObject row2 = ZCRowObject.getInstance(); 
//set()メソッドを使用して各行に列の値を設定する 
row1.set("Name","George Smith"); 
row1.set("Age", 25); 
row2.set("Name","Moana Violet"); 
row2.set("Age", 22); 
//add()メソッドを使用してリストに行を追加する 
rows.add(row1); 
rows.add(row2); 
//insertRows()メソッドを使用してテーブルにリストを追加する 
tab.insertRows(rows);

```