---
title: "行の一括書き込み"
url: https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/cloud-scale/data-store/bulk-write/
description: "このページでは、NodeJS アプリケーションの Data Store のテーブルに複数行を書き込む方法について、サンプルコードとともに説明します。"
last_updated: 2026-03-30T08:10:30Z
service: Cloud Scale
type: general
related_links:
  - name: "Data Store"
    url: /ja/cloud-scale/help/data-store/introduction
---

# 行の一括書き込み

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)で参照されます。

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

書き込みジョブ中、ファイルは以下の属性を使用して参照されます:

* `bucketName`: オブジェクトが格納されている[バケットの名前](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/buckets/name-bucket/#ideal-practices-to-name-a-bucket)です。
* `objectKey`: 必要なオブジェクトの[パス](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)を含めることができます。
* `versionID`: バケットで[バージョニング](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/stratus-config/general-settings/#versioning)が有効になっている場合、ファイルの特定の versionID がこの属性に格納されます。

<table class="content-table">
	<thead>
		<tr>
			<th>使用メソッド</th>
			<th>説明</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>`bulkWrite.createJob(objectDetails, {find_by,fk_mapping,operation})`</td>
			<td>特定のテーブルに新しい一括書き込みジョブを作成します。</td>
		</tr>
            <td>`bulkWrite.status(job ID)`</td>
            <td>一括書き込み操作のステータスを取得します。</td>
        <tr>
            <td>`bulkWrite.result(job ID)`</td>
            <td>一括書き込み操作の結果を取得します。</td>
        </tr>
	</tbody>
</table>

以下の SDK スニペットをコピーして、特定のテーブルに対して一括書き込みジョブを実行します。

```javascript
let datastore = app.datastore(); // datastoreインスタンスを取得
const bulkWrite = datastore.table('sampleTable').bulkJob('write');
const objectDetails = {
  "bucket_name": "zylker14266",
  "object_key": "emp_records.csv",
  "version_id": "64832huidksnd83"
};
// 一括書き込みジョブを作成する
const bulkWriteJob = await bulkWrite.createJob(objectDetails, {
  find_by: 'EmpID',
  fk_mapping: [
    { local_column: 'EmployeeID', reference_column: 'EmpID' },
    { local_column: 'DepartmentID', reference_column: 'DeptID' }
  ],
  operation: 'insert'
});
// 一括書き込みステータスを取得する
await bulkWrite.getStatus(bulkWriteJob.job_id);
// 一括書き込み結果を取得する
await bulkWrite.getResult(bulkWriteJob.job_id);

```

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