---
title: "Bulk Read Rows"
url: https://docs.catalyst.zoho.com/en/sdk/javascript/v1/cloudscale/datastore/bulk-operations/bulk-read/
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: "Java SDK"
    url: /en/sdk/java/v1/cloud-scale/data-store/bulk-read/
  - name: "Python SDK"
    url: /en/sdk/python/v1/cloud-scale/data-store/bulk-read-rows/
  - name: "iOS SDK"
    url: /en/sdk/ios/v2/cloud-scale/data-store/get-rows/
  - name: "Android SDK"
    url: /en/sdk/android/v2/cloud-scale/data-store/get-rows/
  - name: "Flutter SDK"
    url: /en/sdk/flutter/v2/cloud-scale/data-store/get-rows/
  - name: "REST APIs"
    url: /en/api/code-reference/cloud-scale/data-store/bulk-read-rows/create-bulk-read-job/#CreateBulkReadJob
repository:
  name: "Repository"
  url: https://github.com/catalystbyzoho/zcatalyst-sdk-js
---

# Bulk Read 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 **200,000 rows** can be read simultaneously.

You can perform bulk read jobs on row data stored in a table in Catalyst DataStore. Using the following bulk read utility, you can read thousands of records from a specific table and generate a .CSV file containing the results of read operation.

### Methods Used

<table border="1" cellpadding="8" cellspacing="0">
  <thead>
    <tr>
      <th>Methods Used</th>
      <th>Description</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>`bulkRead.createJob({criteria, page,select_columns})`</td>
      <td>Create new bulk read job.</td>
    </tr>
    <tr>
      <td>`bulkRead.getStatus(jobID)`</td>
      <td>Get a bulk read job status.</td>
    </tr>
    <tr>
      <td>`bulkRead.getResult(jobID)`</td>
      <td>Get a bulk read job's result.</td>
    </tr>
  </tbody>
</table>

The required table is referred to by its [Table ID](https://docs.catalyst.zoho.com/en/cloud-scale/help/data-store/tables/). 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/).

> **Info:** You can also use the `dataStore.table().bulkJob('read' | 'write')` method to perform either a bulk read or a [bulk write job](https://docs.catalyst.zoho.com/en/sdk/javascript/v1/cloudscale/datastore/bulk-operations/bulk-write/).

```javascript
// Bulk read
const datastore = new Datastore(); // get datastore instance
const bulkRead = datastore.table("sampleTable").bulkJob("read");
const bulkReadJob = await bulkRead.createJob({
  criteria: {
    group_operator: "or",
    group: [
      { column_name: "Department", comparator: "equal", value: "Marketing" },
      { column_name: "EmpID", comparator: "greater_than", value: "1000" },
      { column_name: "EmpName", comparator: "starts_with", value: "S" }
    ]
  },
  page: 1,
  select_columns: ["EmpID", "EmpName", "Department"],
  url: "https://hr.zylker.com/en/EmpRecords/_callback.php",
  headers: { src: "ZCatalyst", operation: "bulkreadAPI" },
  params: { project_name: "EmployeeDatabase" }
});
```

### Get Bulk Read Status

```javascript
await bulkRead.getStatus(bulkReadJob.job_id);
```

### Get Bulk Read Result

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

```javascript
await bulkRead.getResult(bulkReadJob.job_id);
```