Aviso:

Para brindarle información de soporte completa de manera más rápida, el contenido de esta página ha sido traducido al español mediante traducción automática. Para consultar la información de soporte más precisa, consulte la versión en inglés de este contenido.

Insertar items NoSQL en tabla

Catalyst te permite insertar items en una tabla NoSQL 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, y los tipos de datos soportados 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.

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

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

copy
//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.

copy
//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

copy
//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.

copy
//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.

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

2. Usando operador, operando y valor

copy
//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

copy
//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.

copy
//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

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

Última actualización 2026-03-20 21:51:56 +0530 IST