---
title: "Crear filas"
url: https://docs.catalyst.zoho.com/es/sdk/flutter/v2/cloud-scale/data-store/create-rows/
description: "Puedes crear una nueva instancia de fila para una tabla particular en Data Store y habilitar los métodos definidos en esta clase para acceder al objeto de la instancia."
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
  - name: "Records"
    url: /es/cloud-scale/help/data-store/records
  - name: "Insert Row - API"
    url: /es/api/code-reference/cloud-scale/data-store/insert-new-row/#InsertNewRow
---

# Crear filas

### Crear una sola fila

Puedes crear una nueva fila en una tabla de [Data Store](https://docs.catalyst.zoho.com/es/cloud-scale/help/data-store/introduction) de la instancia dada usando el método `newRow()`. Debes establecer los valores de las filas en la tabla, especificando el nombre de la columna y el valor de fila correspondiente como un par clave-valor.

El `<ROW_INSTANCE>` utilizado en la sintaxis de código a continuación es la instancia definida en la [página de instancia de fila](https://docs.catalyst.zoho.com/es/sdk/flutter/v2/cloud-scale/data-store/create-row-instance).

```bash
Future<(APIResponse, ZCatalystRow)> &lt;ROW_INSTANCE&gt;.create()
```

> **Nota:** Si una columna fue creada con la propiedad `is_unique` o `is_mandatory` habilitada, debes asegurarte de que el valor sea único o se pase obligatoriamente, respectivamente. También debes asegurarte de que los datos que pases para una columna sean del tipo de dato configurado de la columna.

A continuación se muestra un fragmento de código de ejemplo con la creación de una instancia de fila:

```bash
var row = ZCatalystApp.getInstance()
      .getDataStoreInstance()
      .getTableInstance(identifier: 'Products')
      .newRow(); //Definir la instancia de fila para la tabla y pasar los datos clave-valor de la fila
  row.setColumnValue('product_name', 'power_bank');
  row.setColumnValue('product_price', 2000);
  row.setColumnValue('product_quantity', 2);

try {
   var (response, row) = await row.create();
   print('New row created successfully : ${row.id}');
} on ZCatalystException catch (ex) {
  print('Failed to create the row: $exception');
}
```

### Crear múltiples filas

Catalyst Flutter SDK te permite crear múltiples filas a la vez en una tabla de la instancia dada. Esto se hace pasando una lista que contiene las filas que necesitan ser insertadas en la tabla. La lista se pasa como argumento al método `createRows()`, como se muestra en la sintaxis de código a continuación.

El `&lt;TABLE_INSTANCE&gt;` utilizado en el código a continuación es la instancia definida en la [página de instancia de tabla](https://docs.catalyst.zoho.com/es/sdk/flutter/v2/cloud-scale/data-store/create-table-instance).

```bash
Future<(APIResponse, List&lt;ZCatalystRow&gt;)> &lt;TABLE_INSTANCE&gt;.createRows(List&lt;ZCatalystRow&gt; rows)
```

**Parámetros**:

* `rows`: El array de filas a crear

A continuación se muestra un fragmento de código de ejemplo con la creación de instancias de fila:

```bash
List&lt;ZCatalystRow&gt; newRows = []; //Crear un array
//Definir instancias de fila para las filas a crear
  ZCatalystRow row1 = 
      dataStore.getTableInstance(identifier: 'Products').newRow();
  row1.setColumnValue('product_name', 'a');
  row1.setColumnValue('product_price', 25);
  row1.setColumnValue('product_quantity', 50);

  ZCatalystRow row2 =
      dataStore.getTableInstance(identifier: 'Products').newRow();
  row2.setColumnValue('product_name', 'b');
  row2.setColumnValue('product_price', 30);
  row2.setColumnValue('product_quantity', 40);

  ZCatalystRow row3 =
      dataStore.getTableInstance(identifier: 'Products').newRow();
  row3.setColumnValue('product_name', 'c');
  row3.setColumnValue('product_price', 25);
  row3.setColumnValue('product_quantity', 70);
//Agregar instancias de fila al arreglo
  newRows.add(row1);
  newRows.add(row2);
  newRows.add(row3);
try{
  var (response, rows) = await dataStore.getTableInstance(identifier: 'Products').createRows(rows: newRows);
  for (var row in rows) {
            print(row.id); //Acciones a ejecutar cuando se creen las filas correctamente
  }
} on ZCatalystException catch (ex) {
  print('The IDs of the rows that were successfully created are listed below:')
}
```