---
title: "Escritura masiva de filas"
url: https://docs.catalyst.zoho.com/es/sdk/java/v1/cloud-scale/data-store/bulk-write/
description: "Esta página describe el método para escribir múltiples filas en una tabla de Data Store en tu aplicación Java con fragmentos de código de ejemplo"
last_updated: 2026-03-30T08:10:30Z
service: Cloud Scale
type: general
related_links:
  - name: "Data Store"
    url: /es/cloud-scale/help/data-store/introduction
---

# Escritura masiva de filas
Catalyst te permite realizar trabajos de escritura masiva en una tabla específica presente en [Data Store](https://docs.catalyst.zoho.com/es/cloud-scale/help/data-store/introduction). La operación de escritura masiva puede obtener miles de registros de un archivo CSV subido en [Stratus](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/introduction/) e insertarlos en una tabla específica.
La tabla se identifica por su [Table ID](https://docs.catalyst.zoho.com/es/cloud-scale/help/data-store/tables/) único. La columna en la que se debe realizar la operación de escritura se identifica por su [ID de columna](https://docs.catalyst.zoho.com/es/cloud-scale/help/data-store/columns/#column-characteristics) único.

> **Nota:** Para realizar una operación de escritura masiva, primero debes [subir](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/objects/upload-object/) los datos requeridos como un archivo CSV en Stratus.

Durante el trabajo de escritura, el archivo se referenciará usando los siguientes atributos:
* `bucketName`: El [nombre del bucket](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/buckets/name-bucket/#ideal-practices-to-name-a-bucket), donde se almacena el objeto.
* `objectKey`: Puede contener la [ruta](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/objects/introduction/#path) o la [URL del objeto](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/objects/introduction/#object-url) del objeto requerido.
* `versionID`: Si el bucket tiene el [versionado](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/stratus-config/general-settings/#versioning) habilitado, entonces el versionID específico del archivo se almacenará en este atributo. 
Estos detalles deberán resolverse como un objeto JSON llamado `objectDetails`, y pasarse al método `setObjectDetails()`.
Catalyst soporta los siguientes métodos para escritura masiva en Java SDK:
<table class="content-table">
        <thead>
                <tr>
                        <th>Método utilizado</th>
                        <th>Descripción</th>
                </tr>
        </thead>
        <tbody>
                <tr>
                        <td>`createBulkWriteJob(bulkWriteDetails)`</td>
                        <td>Crear un nuevo trabajo de escritura masiva en una tabla específica.</td>
                </tr>
      <td>`createInsertBulkWriteJob(table ID, objectDetails)`</td>
      <td>Crear un nuevo trabajo de inserción de escritura masiva.</td>
    <tr>
      <td>`createUpsertBulkWriteJob(tableId, objectDetails, column ID)`</td>
      <td>Crear un nuevo trabajo de upsert de escritura masiva.</td>
    </tr>
    <tr>
      <td>`getBulkWriteJobDetails(jobID)`</td>
      <td>Obtener el estado y los resultados de un trabajo de escritura masiva.</td>
    </tr>
        </tbody>
</table>
Copia el siguiente fragmento del SDK para realizar un trabajo de escritura masiva en una tabla en particular.
#### Fragmento de código de ejemplo 

**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(); 
// crear instancia de escritura masiva
ZCBulkWriteDetails bulkWriteDetails = ZCBulkWriteDetails.getInstance(); 
// crear y llenar el objeto de detalles de escritura masiva
bulkWriteDetails.setTableIdentifier(12096000000642178L);  // Proporciona tu Table ID
bulkWriteDetails.setObjectDetails(objectDetails);
ZCBulkResult bulkWriteResult = bulkWrite.createBulkWriteJob(bulkWriteDetails); 
// crear trabajo de escritura masiva
bulkWrite.createInsertBulkWriteJob(12096000000642178L, objectDetails);  // Proporciona tu Table ID
// crear trabajo de inserción de escritura masiva
bulkWrite.createUpdateBulkWriteJob(12096000000642178L, objectDetails, 12096000000642900L); // Proporciona tu Table ID y Column ID
// crear trabajo de inserción de escritura masiva
bulkWrite.createUpsertBulkWriteJob(12096000000642178L, objectDetails, 12096000000642900L);  // Proporciona tu Table ID y Column ID
// crear trabajo de upsert de escritura masiva
bulkWrite.getBulkWriteJobStatus(bulkWriteResult.getJobId()); 
// obtener el estado y resultados del trabajo de escritura masiva

```

> **Nota:** Se puede escribir un máximo de **100,000 filas** simultáneamente usando el método `createBulkWriteJob()`.