---
title: "行の挿入"
url: https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/data-store/insert-rows/
description: "このページでは、PythonアプリケーションでData Storeのテーブルに単一行または複数行を一括挿入するメソッドについて、サンプルコードスニペットとともに説明します。"
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 Help"
    url: /ja/cloud-scale/help/data-store/introduction
  - name: "SDK Scopes"
    url: /ja/sdk/python/v1/sdk-scopes
---

# 行の挿入

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

以下のコードで使用されている`table_service`参照は、以前に作成されたテーブルインスタンスまたはテーブルメタのいずれかです。

> **注意：**

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

### 単一行の挿入

以下に示すように、行の詳細を{カラム名 : カラム値}形式で含む辞書を作成し、それを`insert_row()`メソッドの引数として渡す必要があります。これにより、一意のテーブル名またはテーブルIDで参照するテーブルに行が挿入されます。

行が挿入されると、一意の`ID`値が自動的に生成されます。以下で使用されている[コンポーネントインスタンス](https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/data-store/get-component-instance/)`datastore_service`と[テーブルインスタンス](https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/data-store/get-table-instance/)`table_service`の詳細については、それぞれのヘルプセクションを参照してください。

**使用するパラメータ**

<table class="content-table">
	<thead>
		<tr>
			<th class="w20p">パラメータ名</th>
      <th class="w20p">データ型</th>
      <th class="w60p">定義</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>`row_data`</td>
      <td>Array</td>
			<td>**必須**パラメータです。挿入する行の詳細をキーと値のペアで保持します。</td>
		</tr>
	</tbody>
</table>

```python
#テーブルに単一行を挿入する
datastore_service = app.datastore()
table_service = datastore_service.table("Employee")
row_data = {'name': 'George Hamilton', 'id': '6868', 'age': '22'}
row_response = table_service.insert_row(row_data)

```

サンプルレスポンスを以下に示します：

```javascript
{
  CREATORID: "2136000000006003",
  MODIFIEDTIME: "2021-08-16 16:30:12:799",
  Name: "George Hamilton",
  Age: 22,
  ID: 6868,
  CREATEDTIME: "2021-08-16 16:30:12:799",
  ROWID: "2136000000011015"
}

```

### 複数行の挿入

以下に示すように、行を含む配列を構築し、それを`insert_rows()`メソッドの引数として渡すことで、テーブルに複数の行を挿入できます。以下で使用されている[コンポーネントインスタンス](https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/data-store/get-component-instance/)`datastore_service`と[テーブルインスタンス](https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/data-store/get-table-instance/)`table_service`の詳細については、それぞれのヘルプセクションを参照してください。

行オブジェクトの配列を含むレスポンスが返されます。

**使用するパラメータ**

<table class="content-table">
	<thead>
		<tr>
			<th class="w20p">パラメータ名</th>
      <th class="w60p">データ型</th>
      <th class="w60p">定義</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>`row_data`</td>
      <td>Array</td>
			<td>**必須**パラメータです。挿入する行の詳細をキーと値のペアで保持します。</td>
		</tr>
	</tbody>
</table>

```python
datastore_service = app.datastore()
table_service = datastore_service.table("Employee")
row_data = [{'name': 'Mark Wellington', 'id': '7218', 'age': '29'},
            {'name': 'Zendaya Jones', 'id': '3211', 'age': '32'}]
row_response = table_service.insert_rows(row_data)

```

サンプルレスポンスを以下に示します：

```javascript
[
  {
    CREATORID: "2136000000006003",
    MODIFIEDTIME: "2021-08-25 13:55:04:904",
    Name: "Mark Wellington",
    Age: 29,
    ID: 7218,
    CREATEDTIME: "2021-08-25 13:55:04:904",
    ROWID: 2136000000011015
  },
  {
    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: 2136000000011016
  }
]

```

> **情報：** 上記の操作を実行するために必要な権限レベルを確認するには、[SDKスコープの表](https://docs.catalyst.zoho.com/ja/sdk/python/v1/sdk-scopes)を参照してください。