---
title: "Bulk Write Rows"
url: https://docs.catalyst.zoho.com/en/sdk/javascript/v1/cloudscale/datastore/bulk-operations/bulk-write/
description: "This page describes the method to perform operations in the DataStore component."
last_updated: 2026-09-09T10:45:38Z
service: CloudScale
type: general
related_links:
  - name: "Catalyst CloudScale"
    url: /en/cloud-scale/
  - name: "DataStore Help"
    url: /en/cloud-scale/help/data-store/introduction/
  - name: "Stratus Help"
    url: /en/cloud-scale/help/stratus/introduction/
  - name: "Java SDK"
    url: /en/sdk/java/v1/cloud-scale/data-store/bulk-write/
  - name: "Python SDK"
    url: /en/sdk/python/v1/cloud-scale/data-store/bulk-write-rows/
  - name: "iOS SDK"
    url: /en/sdk/ios/v2/cloud-scale/data-store/create-rows/
  - name: "Android SDK"
    url: /en/sdk/android/v2/cloud-scale/data-store/create-rows/
  - name: "Flutter SDK"
    url: /en/sdk/flutter/v2/cloud-scale/data-store/create-rows/
  - name: "REST APIs"
    url: /en/api/code-reference/cloud-scale/data-store/bulk-write-rows/create-bulk-write-job/#CreateBulkWriteJob
repository:
  name: "Repository"
  url: https://github.com/catalystbyzoho/zcatalyst-sdk-js
---

# Bulk Write Rows

> **Notes:** 

* Ensure you have installed the [required package](https://docs.catalyst.zoho.com/en/sdk/javascript/v1/cloudscale/datastore/overview/#prerequisites) to use this SDK method.

*  A maximum of **100,000 rows** can be written at one time.

You can perform bulk write jobs on a specific table present in the Catalyst DataStore. Using the bulk write utility you can fetch thousands of records stored in a .CSV file uploaded to a [bucket](https://docs.catalyst.zoho.com/en/cloud-scale/help/stratus/buckets/name-bucket/) in [Stratus](https://docs.catalyst.zoho.com/en/cloud-scale/help/stratus/introduction/), and insert them to a specific table.

The required table is referred to by its [table ID](https://docs.catalyst.zoho.com/en/cloud-scale/help/data-store/tables/#create-a-new-table), and the required column will be referred to by its [column ID](https://docs.catalyst.zoho.com/en/cloud-scale/help/data-store/columns/#create-a-new-column).

> **Note:** To perform the bulk write operation, you need to ensure that the required .CSV file is uploaded to a bucket in *Catalyst Stratus*. The .CSV file will be referred to using a JSON object which contains details, such as the bucket name, object name, and, if [versioning](https://docs.catalyst.zoho.com/en/cloud-scale/help/stratus/stratus-config/general-settings/#versioning) is enabled for your bucket, its `version ID`.

### Methods Used

<table border="1" cellpadding="8" cellspacing="0">
  <thead>
    <tr>
      <th>Methods Used</th>
      <th>Description</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>`bulkWrite.createJob(objectDetails,{find_by, fk_mapping, operation})`</td>
      <td>Create a new bulk write job on a specific table.</td>
    </tr>
    <tr>
      <td>`bulkWrite.status(job ID)`</td>
      <td>Get the status of a bulk write operation.</td>
    </tr>
    <tr>
      <td>`bulkWrite.result(job ID)`</td>
      <td>Get the result of a bulk write operation.</td>
    </tr>
  </tbody>
</table>

The `datastore` reference used in the following code snippet is the [component instance](https://docs.catalyst.zoho.com/en/sdk/javascript/v1/cloudscale/datastore/get-component-instance/).

```javascript
const objectDetails = {
  bucket_name: "zylker14266",
  object_key: "sample.csv",
  version_id: "64832huidksnd83"
};
const datastore = new Datastore(); // get datastore instance
const bulkWrite = datastore.table("sampleTable").bulkJob("write");
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"
});
```

### Get Bulk Write Status

```javascript
await bulkWrite.getStatus(bulkWriteJob.job_id);
```

### Get Bulk Write Result

> **Note:** The bulk write job status must be **Completed** for the result to be retrieved successfully.

```javascript
await bulkWrite.getResult(bulkWriteJob.job_id);
```