---
title: "行の一括書き込み"
url: https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/data-store/bulk-write-rows/
description: "このページでは、PythonアプリケーションでData Storeのテーブルに行を一括書き込みするメソッドについて、サンプルコードスニペットとともに説明します。"
last_updated: 2026-03-30T08:10:30Z
service: Cloud Scale
type: general
related_links:
  - name: "Data Store Help"
    url: /ja/cloud-scale/help/data-store/introduction
  - name: "SDK Scopes"
    url: /ja/sdk/python/v1/sdk-scopes
---

# 行の一括書き込み

Catalystでは、[Data Store](https://docs.catalyst.zoho.com/ja/cloud-scale/help/data-store/introduction)に存在する特定のテーブルに対して一括書き込みジョブを実行できます。一括書き込み操作は、[Stratus](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/introduction/)にアップロードされたCSVファイルから数千件のレコードを取得し、特定のテーブルに挿入します。

テーブルは、作成時にCatalystが生成する一意の[`table ID`](https://docs.catalyst.zoho.com/ja/cloud-scale/help/data-store/tables/)で参照されます。書き込み操作を実行するカラムは、一意の[column ID](https://docs.catalyst.zoho.com/ja/cloud-scale/help/data-store/columns/#column-characteristics)で参照されます。

> **注意：** 一括書き込み操作を実行するには、まず必要なデータをCSVファイルとしてStratusに[アップロード](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/objects/upload-object/)する必要があります。

<table class="content-table">
	<thead>
		<tr>
			<th class="w20p">パラメータ名</th>
      <th class="w20p">データ型</th>
      <th class="w60p">定義</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>`tableID`</td>
      <td>String</td>
			<td>**必須**パラメータです。データを書き込むテーブルのIDを保持します。</td>
		</tr>
        <tr>
			<td>`find_by`</td>
      <td>String</td>
			<td>**必須**パラメータです。データを書き込むカラムの名前を保持します。</td>
		</tr>
        <tr>
			<td>`fk_mapping`</td>
      <td>Array</td>
			<td>**必須**パラメータです。local_columnとreference_columnの詳細を保持します。</td>
		</tr>
        <tr>
			<td>`operation`</td>
      <td>String</td>
			<td>**必須**パラメータです。このパラメータの値はinsertである必要があります。</td>
		</tr>
    <tr>
      <td>o`bject_details`</td>
      <td>JSON Object</td>
      <td>
        <ul>
          <li>`bucket_name`: オブジェクトが保存されている[バケットの名前](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/buckets/name-bucket/#ideal-practices-to-name-a-bucket)です。</li>
          <li>`object_key`: 必要なオブジェクトの[パス](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/objects/introduction/#path)または[オブジェクトURL](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/objects/introduction/#object-url)を含めることができます。</li>
          <li>`version_id`: バケットで[バージョニング](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/stratus-config/general-settings/#versioning)が有効な場合、この属性にファイルの特定のバージョンIDが格納されます。</li>
        </ul>
      </td>
    </tr>
	</tbody>
</table>

特定のテーブルに対して一括書き込みジョブを実行するには、以下のSDKスニペットをコピーしてください。以下で使用されているコンポーネントインスタンス`datastore_service`の詳細については、[こちらのヘルプセクション](https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/data-store/get-component-instance/)を参照してください。

```python
datastore_service = app.datastore()
bulk_write = datastore_service.table("Sample").bulk_write()
object_details = {
  "bucket_name": "zcstratus12345",
  "object_key": "sample.csv",
  "version_id": "64832huidksnd83"
}
#バルク書き込みジョブを作成する
bulk_write_job = bulk_write.create_job(object_details, {
  "find_by": "S1",
  "fk_mapping": [
    {"local_column": "EmployeeID", "reference_column": "EmpId"},
    {"local_column": "DepartmentID", "reference_column": "DepId"}
  ],
  "operation": "insert"
})
#バルク書き込みのステータスを取得する
status = bulk_write.get_status('6759000000167103')
#バルク書き込みの結果を取得する
result = bulk_write.get_result('6759000000167103')

```

> **注意：** 一度に最大**100,000行**を書き込むことができます。

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