---
title: "Escritura masiva de filas"
url: https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/data-store/bulk-write-rows/
description: "Esta página describe el método para escribir filas de forma masiva en una tabla del Data Store en tu aplicación Python con fragmentos de código de ejemplo."
last_updated: 2026-03-20T16:21:56Z
service: Cloud Scale
type: general
related_links:
  - name: "Data Store Help"
    url: /es/cloud-scale/help/data-store/introduction
  - name: "SDK Scopes"
    url: /es/sdk/python/v1/sdk-scopes
---

# Escritura masiva de filas
Catalyst te permite realizar trabajos de escritura masiva en una tabla específica presente en el [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 cargado en [Stratus](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/introduction/) e insertarlos en una tabla específica.
La tabla se referencia por su [`table ID`](https://docs.catalyst.zoho.com/es/cloud-scale/help/data-store/tables/) único generado por Catalyst durante la creación. La columna en la que se debe realizar la operación de escritura se referencia por su [ID de columna](https://docs.catalyst.zoho.com/es/cloud-scale/help/data-store/columns/#column-characteristics) único.

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

<table class="content-table">
        <thead>
                <tr>
                        <th class="w20p">Nombre del parámetro</th>
      <th class="w20p">Tipo de dato</th>
      <th class="w60p">Definición</th>
                </tr>
        </thead>
        <tbody>
                <tr>
                        <td>`tableID`</td>
      <td>String</td>
                        <td>Un parámetro **obligatorio**. Contendrá el ID de la tabla en la que se deben escribir los datos.</td>
                </tr>
        <tr>
                        <td>`find_by`</td>
      <td>String</td>
                        <td>Un parámetro **obligatorio**. Contendrá el nombre de la columna en la que se deben escribir los datos.</td>
                </tr>
        <tr>
                        <td>`fk_mapping`</td>
      <td>Array</td>
                        <td>Un parámetro **obligatorio**. Contendrá los detalles de local_column y reference_column.</td>
                </tr>
        <tr>
                        <td>`operation`</td>
      <td>String</td>
                        <td>Un parámetro **obligatorio**. El valor de este parámetro debe ser insert.</td>
                </tr>
    <tr>
      <td>o`bject_details`</td>
      <td>JSON Object</td>
      <td>
        <ul>
          <li>`bucket_name`: 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.</li>
          <li>`object_key`: 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.</li>
          <li>`version_id`: 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.</li>
        </ul>
      </td>
    </tr>
        </tbody>
</table>
Copia el fragmento del SDK a continuación para realizar un trabajo de escritura masiva en una tabla en particular. Para conocer más sobre la instancia del componente `datastore_service` utilizada a continuación, consulta [esta sección de ayuda](https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/data-store/get-component-instance/).

```python
datastore_service = app.datastore()
bulk_write = datastore_service.table("Sample").bulk_write()
object_details = {
  "bucket_name": "zcstratus12345",
  "object_key": "sample.csv",
  "version_id": "64832huidksnd83"
}
#create bulk write job
bulk_write_job = bulk_write.create_job(object_details, {
  "find_by": "S1",
  "fk_mapping": [
    {"local_column": "EmployeeID", "reference_column": "EmpId"},
    {"local_column": "DepartmentID", "reference_column": "DepId"}
  ],
  "operation": "insert"
})
#get bulk write status
status = bulk_write.get_status('6759000000167103')
#get bulk write result
result = bulk_write.get_result('6759000000167103')

```

> **Note:** Se pueden escribir un máximo de **100,000 filas** a la vez.

> **Info :** Consulta la [tabla de SDK Scopes](https://docs.catalyst.zoho.com/es/sdk/python/v1/sdk-scopes) para determinar el nivel de permiso requerido para realizar la operación anterior.