---
title: "Insertar items en tabla"
url: https://docs.catalyst.zoho.com/es/sdk/java/v1/cloud-scale/nosql/insert-items/
description: "Catalyst NoSQL es una base de datos potente y completamente administrada que te proporciona un medio de almacenamiento de datos no relacional y no SQL. Esta página describe el método del SDK para insertar items en una tabla NoSQL."
last_updated: 2026-03-20T16:21:56Z
service: Cloud Scale
type: general
related_links:
  - name: "NoSQL"
    url: /es/cloud-scale/help/nosql/introduction
  - name: "Working with Data"
    url: /es/cloud-scale/help/nosql/working-with-data/introduction/
  - name: "NoSQL API"
    url: /es/api/code-reference/cloud-scale/nosql/insert-item/#InsertNewItem
---

# Insertar items NoSQL en tabla

Catalyst te permite insertar items en una tabla [NoSQL](https://docs.catalyst.zoho.com/es/cloud-scale/help/nosql/introduction/) específica después de construirlos. Los items se pueden insertar de diferentes formas como se describe en esta sección.

Puedes consultar las secciones de ayuda sobre cómo agregar y trabajar con datos, el [formato JSON personalizado de Catalyst](https://docs.catalyst.zoho.com/es/cloud-scale/help/nosql/working-with-data/introduction/#the-catalyst-custom-json-format), y los [tipos de datos soportados](https://docs.catalyst.zoho.com/es/cloud-scale/help/nosql/working-with-data/introduction/#supported-data-types) para conocer estos temas en detalle.

> **Nota:** Catalyst te permite insertar un máximo de 25 items en masa en una tabla NoSQL con una sola operación del SDK.

### Insertar items sin condiciones

Puedes insertar nuevos items en una tabla NoSQL sin ninguna condición ya sea usando la instancia de `ZCNoSQLTable`, o la instancia de `ZCNoSQLInsertHelper` que se puede usar para construir las diversas partes de la solicitud. 

Puedes insertar datos con la instancia de `ZCNoSQLTable` como se muestra a continuación.

```java
//public ZCNoSQLResponseBean insert(ZCNoSQLItem item) throws Exception;
table.insert(<ZCNoSQLItem>);
```

Puedes insertar datos con la instancia de `ZCNoSQLInsertHelper` como se muestra a continuación.

```java
//public ZCNoSQLInsertHelper getInsertHelper(ZCNoSQLItem item) throws Exception;
//public ZCNoSQLResponseBean insert() throws Exception;
table.getInsertHelper(<ZCNoSQLItem>).insert();
```

Esta clase se puede usar para insertar datos en una tabla con condiciones. Se puede obtener desde la instancia de `ZCNoSQLTable`.

### Insertar items con condiciones

Puedes insertar atributos en items existentes en una tabla NoSQL usando condiciones específicas que definas. En este tipo, los datos existentes de la tabla se recuperan y se evalúan contra la condición especificada. Los items se insertan solo si la evaluación es verdadera. Si no hay datos existentes, las condiciones se ignoran y los items se insertan.

El fragmento a continuación muestra la inserción de items con condiciones usando `ZCNoSQLCondition`.

```java
//public ZCNoSQLInsertHelper withCondition(ZCNoSQLCondition condition) throws Exception;
table.getInsertHelper(<ZCNoSQLItem>).withCondition(<ZCNoSQLCondition>).insert();
```

La condición se puede pasar con la ayuda de la instancia de `ZCNoSQLCondition` que se puede obtener usando un constructor o llamando al método `getInstance()`. Las condiciones se pueden inicializar de 3 formas

#### 1. Usando funciones

```java
//public static ZCNoSQLCondition getInstance(NoSQLConditionFunction function) throws Exception;
//public ZCNoSQLCondition(NoSQLConditionFunction function) throws Exception;
ZCNoSQLCondition.getInstance(<NoSQLCondtitionFunction>);
new ZCNoSQLCondition(<NoSQLCondtitionFunction>)
```

Hay dos funciones integradas disponibles.

**i. ZCNoSQLAttributeTypeFunction**

Verifica si el tipo de dato del atributo dado coincide con el tipo de dato proporcionado.

```java
//public ZCNoSQLAttributeTypeFunction(ZCNoSQLAttribute attribute, ZCNoSQLValue.DataType dataType) throws Exception;
//public static ZCNoSQLAttributeTypeFunction getInstance(ZCNoSQLAttribute attribute, ZCNoSQLValue.DataType dataType) throws Exception;
ZCNoSQLAttributeTypeFunction.getInstance(<ZCNoSQLAttribute>, <ZCNoSQLValue.DataType>);
new ZCNoSQLAttributeTypeFunction(<ZCNoSQLAttribute>, <ZCNoSQLValue.DataType>);
```

**ii. ZCNoSQLAttributeExistFunction **

Se usa para evaluar si un atributo ya existe en el item recuperado.

```java
//public ZCNoSQLAttributeExistFunction(ZCNoSQLAttribute attribute);
//public static ZCNoSQLAttributeExistFunction getInstance(ZCNoSQLAttribute attribute);
ZCNoSQLAttributeExistFunction.getInstance(<ZCNoSQLAttribute>);
new ZCNoSQLAttributeExistFunction(<ZCNoSQLAttribute>)
```

#### 2. Usando operador, operando y valor

```java
//public static ZCNoSQLCondition getInstance(ZCNoSQLAttribute attribute, NOSQL_OPERATOR operator, ZCNoSQLValue value) throws Exception;
//public ZCNoSQLCondition(ZCNoSQLAttribute attribute, NOSQL_OPERATOR operator, ZCNoSQLValue value) throws Exception;
ZCNoSQLCondition.getInstance(<ZCNoSQLAttribute>, <NOSQL_OPERATOR>, <ZCNoSQLValue>);
new ZCNoSQLCondition(<ZCNoSQLAttribute>, <NOSQL_OPERATOR>, <ZCNoSQLValue>);
```

#### NOSQL_OPERATOR

Los valores permitidos de `NOSQL_OPERATOR` son contains, `not_contains`, `begins_with`, `ends_with`, `in`, `not_in`, `between`, `not_between`, `equals`, `not_equals`, `greater_than`, `less_than`, `greater_equal`, `less_equal`

#### Usando grupo de condiciones

```java
//public static ZCNoSQLCondition getInstance(List<ZCNoSQLCondition> groups, NOSQL_CONDITION_GROUP_OPERATOR groupOperator) throws Exception;
//public ZCNoSQLCondition(List<ZCNoSQLCondition> groups, NOSQL_CONDITION_GROUP_OPERATOR groupOperator) throws Exception;
ZCNoSQLCondition.getInstance(List<ZCNoSQLCondition>,<NOSQL_CONDITION_GROUP_OPERATOR>)
new ZCNoSQLCondition(List<ZCNoSQLCondition>,<NOSQL_CONDITION_GROUP_OPERATOR>)
```

#### NOSQL_CONDITION_GROUP_OPERATOR

Los valores permitidos de `NOSQL_CONDITION_GROUP_OPERATOR` son `AND`, `OR`

#### NOSQL_RETURN_VALUE 

Indica el valor de retorno después de evaluar la condición.

```java
//public ZCNoSQLInsertHelper withReturnValue(NOSQL_RETURN_VALUE returnValue) throws Exception
table.getInsertHelper(<ZCNoSQLItem>).withReturnValue(<NOSQL_RETURN_VALUE>).insert();
```

Los valores permitidos de `NOSQL_RETURN_VALUE` son `NEW`, `OLD`, `NULL`

#### Insertar con condición y valor de retorno

```java
table.getInsertHelper(<ZCNoSQLItem>).withCondition(<ZCNoSQLCondition>).withReturnValue(<NOSQL_RETURN_VALUE>).insert();
```