---
title: "行の挿入"
url: https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/cloud-scale/data-store/insert-rows/
description: "このページでは、NodeJS アプリケーションの Data Store のテーブルに単一行または一括で行を挿入する方法について、サンプルコードとともに説明します。"
last_updated: 2026-03-24T12:08:39Z
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) のテーブルに新しいデータ行またはレコードを挿入できます。次のセクションで説明するように、テーブルに複数行を挿入することもできます。

以下のコードで使用している `table` の参照は、以前作成した[テーブルインスタンス](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/cloud-scale/data-store/get-table-instance)または[テーブルメタ](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/cloud-scale/data-store/get-table-meta)のいずれかです。

> **Note:**

* テーブルとそのカラムは事前に作成されている必要があります。コンソールから[テーブルの作成](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)が可能です。

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

### 単一行の挿入

_{カラム名 : カラム値}_ 形式で行の詳細を含む JSON オブジェクトを作成し、以下に示すように `insertRow()` メソッドの引数として渡す必要があります。これにより、名前または一意のテーブル ID で参照したテーブルに行が挿入されます。行が挿入されると、行の一意の `RowID` 値が自動的に生成されます。

ここで返される Promise は JSON の行オブジェクトに解決されます。

```javascript
//Create a JSON object with the rows to be inserted 
let rowData = { Name: `George Hamilton`, Age: 22, ID: 6868 };
//テーブルメタオブジェクトを使用してPromiseを返す行を挿入する 
let datastore = app.datastore(); 
let table = datastore.table('EmpDetails'); 
let insertPromise = table.insertRow(rowData); 
insertPromise.then((row) => {
console.log(row); });
```

各バージョンで受信するサンプルレスポンスを以下に示します:

```javascript
{
CREATORID: "2136000000006003",
MODIFIEDTIME: "2021-08-16 16:29:10:499",
Name: "George Hamilton",
Age: "22",
ID: "6868",
CREATEDTIME: "2021-08-16 16:29:10:499",
ROWID: 2136000000011011
}
```

### 複数行の挿入

行を含む配列を構築し、以下に示すように `insertRows()` メソッドの引数として渡すことで、テーブルに複数行を挿入できます。ここで返される Promise は、行オブジェクトを含む配列に解決されます。

```javascript
//Create a JSON array with the rows to be inserted 
let rowData = [{ Name: `Mark Wellington`, Age: 29, ID: 7218 }, 
{
Name: `Zendaya Jones`, Age: 32, ID: 3211 } ]; 
//テーブルメタオブジェクトを使用してPromiseを返す複数行を挿入する
promise let datastore = app.datastore(); 
let table = datastore.table('EmpDetails'); 
let insertPromise = table.insertRows(rowData); 
insertPromise.then((rows) => { console.log(rows); 
});
```

受信するサンプルレスポンスを以下に示します。レスポンスは両方のバージョンで同じです。

```javascript
[
  {
    CREATORID: "2136000000006003",
    MODIFIEDTIME: "2021-08-25 13:55:04:904",
    Name: "Mark Wellington",
    Age: "92", 
    ID: "7218",
    CREATEDTIME: "2021-08-25 13:55:04:904",
    ROWID: 2136000000038008
  },
  {
    CREATORID: "2136000000006003",
    MODIFIEDTIME: "2021-08-25 13:55:04:906",
    Name: "Zendaya Jones",
    Age: "32", 
    ID: "3211",
    CREATEDTIME: "2021-08-25 13:55:04:906",
    ROWID: 2136000000038010
  }
]
```