---
title: "Bulk Write Rows"
url: https://docs.catalyst.zoho.com/en/sdk/nodejs/v2/cloud-scale/data-store/bulk-write/
description: "This page describes the method to write multiple rows from a table in the Data Store in your NodeJS application with sample code snippets"
last_updated: 2026-09-08T11:07:33Z
service: Cloud Scale
type: general
related_links:
  - name: "Data Store"
    url: /en/cloud-scale/help/data-store/introduction
---

# Bulk Write Rows

> **Note:** This SDK is currently in deprecation. Migrate to [JavaScript SDK](https://docs.catalyst.zoho.com/en/sdk/javascript/v1/cloudscale/datastore/bulk-operations/bulk-write/) now.

Catalyst enables you to perform bulk write jobs on a specific table present in the [Data Store](https://docs.catalyst.zoho.com/en/cloud-scale/help/data-store/introduction). The bulk write operation can fetch thousands of records from a CSV file uploaded in [Stratus](https://docs.catalyst.zoho.com/en/cloud-scale/help/stratus/introduction/) and insert them in a specific table.

The table is referred to by its unique [`table ID`](https://docs.catalyst.zoho.com/en/cloud-scale/help/data-store/tables/) that is generated by Catalyst during creation. The column in which the write operation must be performed is referred to by its unique [column ID](https://docs.catalyst.zoho.com/en/cloud-scale/help/data-store/columns/#column-characteristics).

> **Note:** To perform a bulk write operation, you must [first upload](https://docs.catalyst.zoho.com/en/cloud-scale/help/stratus/objects/upload-object/) the required data as a CSV file in Stratus.

During the write job, the file will be referred to using the following attributes:

* `bucketName`: The [name of the bucket](https://docs.catalyst.zoho.com/en/cloud-scale/help/stratus/buckets/name-bucket/#ideal-practices-to-name-a-bucket), where the object is stored.
* `objectKey`: Can contain the [path](https://docs.catalyst.zoho.com/en/cloud-scale/help/stratus/objects/introduction/#path) or the [Object URL](https://docs.catalyst.zoho.com/en/cloud-scale/help/stratus/objects/introduction/#object-url) of the required object.
* `versionID`: If the bucket has [versioning](https://docs.catalyst.zoho.com/en/cloud-scale/help/stratus/stratus-config/general-settings/#versioning) enabled, then the specific versionID of the file will be stored in this attribute. 

<table class="content-table">
	<thead>
		<tr>
			<th>Method 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>
            <td>`bulkWrite.status(job ID)`</td>
            <td>Get the status of a bulk write operation.</td>
        <tr>
            <td>`bulkWrite.result(job ID)`</td>
            <td>Get the result of a bulk write operation.</td>
        </tr>
	</tbody>
</table>

Copy the SDK snippet below to perform a bulk write job on a particular table.

```javascript
let datastore = app.datastore(); // get datastore instance
const bulkWrite = datastore.table('sampleTable').bulkJob('write');
const objectDetails = {
  "bucket_name": "zylker14266",
  "object_key": "emp_records.csv",
  "version_id": "64832huidksnd83"
};
// create bulk write job
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
await bulkWrite.getStatus(bulkWriteJob.job_id);
// get bulk write result
await bulkWrite.getResult(bulkWriteJob.job_id);

```

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