---
title: "新しい行の挿入"
url: https://docs.catalyst.zoho.com/ja/api/code-reference/cloud-scale/data-store/insert-new-row/
description: "このAPIを使用すると、Data Store内のテーブルにデータの新しい行（レコード）を挿入できます。"
last_updated: 2026-02-23T12:39:41Z
service: Cloud Scale
type: api
---

# Data Store

[Catalyst Data Store](https://docs.catalyst.zoho.com/ja/cloud-scale/help/data-store/introduction)は、アプリケーションの永続データをテーブル形式で保存するクラウドベースのリレーショナルデータベース管理システムです。

Data Store APIを使用すると、プロジェクトのData Store内のテーブルにレコードを挿入・管理したり、テーブルやカラムの詳細を取得したり、一括読み取りや一括書き込みのアクションを実行したりできます。ただし、テーブルとそのスキーマの作成はCatalystコンソールからのみ行えます。

# テーブルへの新しい行の挿入

### 説明

このAPIを使用すると、テーブルの一意のIDまたは名前を指定して、Data Store内のテーブルにデータの新しい行（レコード）を挿入できます。

以下に説明するように、リクエスト内のJSON配列でレコードのカラム名とその対応する値を渡す必要があります。

> **注意:** 

* テーブルとそのカラムは事前に作成されている必要があります。コンソールから[テーブルを作成](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/introduction/)では、各プロジェクトのテーブルごとに最大5,000件のレコードを挿入できます。開発環境では、各プロジェクト全体で最大25,000件のレコードを作成できます。本番環境ではレコード作成の上限はありません。

### リクエスト詳細

#### リクエストURL

`POST` {api-domain}/baas/v1/project/{project_id}/table/{tableIdentifier}/row

- **api-domain** (URL): Catalyst APIにアクセスするためのDC固有のドメイン

- **project_id** (Numerical): プロジェクトの[一意のID](https://docs.catalyst.zoho.com/ja/getting-started/set-up-a-catalyst-project/general-settings/)

- **tableIdentifier** (Numerical): テーブルの[一意のID](https://docs.catalyst.zoho.com/ja/cloud-scale/help/data-store/tables/#create-a-new-table)またはテーブル名

#### リクエストヘッダー
 **Authorization:** Zoho-oauthtoken {oauth_token} 

 **Content-Type:** application/json 

**任意のヘッダー** 

 **CATALYST-ORG:** {org_id}

 **Environment:** Development

#### スコープ

ZohoCatalyst.tables.rows.CREATE

> **注意:** この操作は、Catalyst SDKを使用してCatalystユーザー認証権限でも実行できます。詳細については、[Catalyst API前提条件セクション](https://docs.catalyst.zoho.com/ja/api/introduction/overview-and-prerequisites/#prerequisites)を参照してください。

#### リクエストJSON配列

以下のような**JSON配列**でカラム名とその対応する値を送信する必要があります：

```json

    {
        "column1_name": "column1_value",
        "column2_name": "column2_value",
        "column3_name": "column3_value",
        .
        .
    }
```

ここで`column_name`はテーブル内の一意のカラム名、`column_value`はレコード内のその対応する値です。

> **注意:** レコードに挿入するカラム名と値のペアを少なくとも1つ送信する必要があります。

### レスポンス詳細

レスポンスには、`ROWID`や`CREATEDTIME`などの作成された行のメタデータと、挿入されたカラムのキー名と値が含まれます。

**リクエスト例**

```bash
curl -X POST \ 
https://api.catalyst.zoho.com/baas/v1/project/4000000006007/table/EmpDetails/row  \
-H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57" \
-H "Content-Type:application/json" \
-d '[
       {
         "Department_ID":"IT678",
         "Department_Name":"Marketing", 
         "Employee_Name":"Robert Page"
       }
      ]'

```

**レスポンス例**

```json

    {
    "status": "success",
    "data": [
        {
            "CREATORID": "12096000000003003",
            "MODIFIEDTIME": "2023-06-05 11:35:14:332",
            "Department_ID": null,
            "Employee_Name": "Robert Page",
            "Department_Name": "Marketing",
            "CREATEDTIME": "2023-06-05 11:35:14:332",
            "ROWID": 12096000000642928
        }
    ]
}
```

### SDK Documentation

[Insert Rows- Java SDK](https://docs.catalyst.zoho.com/ja/sdk/java/v1/cloud-scale/data-store/insert-rows)

[Insert Rows- Node.js SDK](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/cloud-scale/data-store/insert-rows)

[Insert Rows- Python SDK](https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/data-store/insert-rows)

[Insert Rows- Web SDK](https://docs.catalyst.zoho.com/ja/sdk/web/v4/cloud-scale/data-store/insert-rows)