---
title: "一括行書き込み"
url: https://docs.catalyst.zoho.com/ja/sdk/java/v1/cloud-scale/data-store/bulk-write/
description: "このページでは、Javaアプリケーションでデータストアのテーブルに複数の行を書き込むメソッドについて、サンプルコードスニペットとともに説明します。"
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ファイルから数千のレコードを取得し、特定のテーブルに挿入できます。

テーブルは一意の[テーブルID](https://docs.catalyst.zoho.com/ja/cloud-scale/help/data-store/tables/)で参照されます。書き込み操作を実行するカラムは、一意の[カラム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)または[Object 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がこの属性に保存されます。

これらの詳細は`objectDetails`という名前のJSONオブジェクトとして解決し、`setObjectDetails()`メソッドに渡す必要があります。

CatalystはJava SDKの一括書き込みに対して以下のメソッドをサポートしています：

<table class="content-table">
	<thead>
		<tr>
			<th>使用メソッド</th>
			<th>説明</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>`createBulkWriteJob(bulkWriteDetails)`</td>
			<td>特定のテーブルに対して新しい一括書き込みジョブを作成します。</td>
		</tr>
      <td>`createInsertBulkWriteJob(table ID, objectDetails)`</td>
      <td>新しい一括書き込み挿入ジョブを作成します。</td>
    <tr>
      <td>`createUpsertBulkWriteJob(tableId, objectDetails, column ID)`</td>
      <td>新しい一括書き込みupsertジョブを作成します。</td>
    </tr>
    <tr>
      <td>`getBulkWriteJobDetails(jobID)`</td>
      <td>一括書き込みジョブのステータスと結果を取得します。</td>
    </tr>
	</tbody>
</table>

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

#### サンプルコードスニペット

**Package Imports**

```java
import com.zc.component.object.bulk.ZCBulkWriteServices;
import com.zc.component.object.bulk.ZCDataStoreBulk;
import com.zc.component.object.bulk.result.ZCBulkResult;
import com.zc.component.object.bulk.ZCBucketObjectDetails;
import com.zc.component.object.bulk.ZCBulkWriteDetails 
```

```java
ZCBulkWriteServices bulkWrite = ZCDataStoreBulk.getInstance().getBulkWriteInstance(); 
// 一括書き込みインスタンスを作成する
ZCBulkWriteDetails bulkWriteDetails = ZCBulkWriteDetails.getInstance(); 
// 一括書き込み詳細オブジェクトを作成して入力する
bulkWriteDetails.setTableIdentifier(12096000000642178L);  // Table IDを入力してください
bulkWriteDetails.setObjectDetails(objectDetails);
ZCBulkResult bulkWriteResult = bulkWrite.createBulkWriteJob(bulkWriteDetails); 
// 一括書き込みジョブを作成する
bulkWrite.createInsertBulkWriteJob(12096000000642178L, objectDetails);  // Table IDを入力してください
// 一括書き込み挿入ジョブを作成する
bulkWrite.createUpdateBulkWriteJob(12096000000642178L, objectDetails, 12096000000642900L); // Table IDとColumn IDを入力してください
// 一括書き込み更新ジョブを作成する
bulkWrite.createUpsertBulkWriteJob(12096000000642178L, objectDetails, 12096000000642900L);  // Table IDとColumn IDを入力してください
// 一括書き込みupsertジョブを作成する
bulkWrite.getBulkWriteJobStatus(bulkWriteResult.getJobId()); 
// 一括書き込みジョブのステータスと結果を取得する

```

> **Note:** `createBulkWriteJob()`メソッドを使用して同時に書き込める行は最大**100,000行**です。