--- title: "Actualizar items" url: https://docs.catalyst.zoho.com/es/sdk/java/v1/cloud-scale/nosql/update-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 actualizar 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: "NoSQL API" url: /es/api/code-reference/cloud-scale/nosql/insert-item/#InsertNewItem --- # Actualizar items en una tabla NoSQL Catalyst te permite actualizar items en una tabla [NoSQL](https://docs.catalyst.zoho.com/es/cloud-scale/help/nosql/introduction/) específica después de construirlos. Un item se puede actualizar identificándolo usando sus [claves primarias](https://docs.catalyst.zoho.com/es/cloud-scale/help/nosql/components/#table-keys). Por ejemplo, puedes usar solo la clave de partición o una combinación de la clave de partición y la clave de ordenamiento para identificar el item. Luego puedes definir el tipo de operación de actualización con el método de solicitud HTTP apropiado y proporcionar los atributos y valores que se van a actualizar en el item. > **Nota:** Catalyst te permite actualizar un máximo de 25 items en masa en una tabla NoSQL con una sola operación del SDK. Hay dos formas de actualizar los datos. Los datos se pueden actualizar sin ninguna condición usando la instancia de `ZCNoSQLTable` o se pueden actualizar con la ayuda de la instancia de `ZCNoSQLUpdateHelper` que se puede usar para construir las diversas partes de la solicitud. Puedes actualizar los datos con la instancia de `ZCNoSQLTable` como se muestra a continuación. ```java //public ZCNoSQLResponseBean update(ZCNoSQLItem item, ZCNoSQLUpdateAttributeOperation updateAttributeOperation) throws Exception; table.update(<ZCNoSQLItem>, <ZCNoSQLUpdateAttributeOperation>); ``` Para actualizar con ZCNoSQLUpdateHelper #### ZCNoSQLUpdateHelper ```java //public ZCNoSQLInsertHelper getInsertHelper(ZCNoSQLItem item) throws Exception; //public ZCNoSQLResponseBean insert() throws Exception; table.getUpdateHelper(<ZCNoSQLItem>, <ZCNoSQLUpdateAttributeOperation>).update(); ``` #### ZCNoSQLUpdateAttributeOperation Esta clase se usa para actualizar el item ya sea agregando/actualizando un atributo existente o eliminando un atributo existente. Se puede obtener una instancia de lo anterior usando los métodos a continuación. Para insertar o actualizar atributos ```java //ZCNoSQLUpdateAttributeOperation(ZCNoSQLAttribute attribute, ZCNoSQLValue updateValue); //ZCNoSQLUpdateAttributeOperation(ZCNoSQLAttribute attribute, NoSQLUpdateAttributeFunction updateFunction); //public static ZCNoSQLUpdateAttributeOperation getPutAttributeInstance(ZCNoSQLAttribute attribute, ZCNoSQLValue updateValue); // public static ZCNoSQLUpdateAttributeOperation getPutAttributeInstance(ZCNoSQLAttribute attribute, NoSQLUpdateAttributeFunction updateFunction); new ZCNoSQLUpdateAttributeOperation(<ZCNoSQLAttribute>, <ZCNoSQLValue>); new ZCNoSQLUpdateAttributeOperation(<ZCNoSQLAttribute>, <NoSQLUpdateAttributeFunction>); ZCNoSQLUpdateAttributeOperation.getPutAttributeInstance(<ZCNoSQLAttribute>, <ZCNoSQLValue>); ZCNoSQLUpdateAttributeOperation.getPutAttributeInstance(<ZCNoSQLAttribute>, <NoSQLUpdateAttributeFunction>) ``` Para eliminar atributos ```java //ZCNoSQLUpdateAttributeOperation(ZCNoSQLAttribute attribute); //public static ZCNoSQLUpdateAttributeOperation getDeleteAttributeInstance(ZCNoSQLAttribute attribute); new ZCNoSQLUpdateAttributeOperation(<ZCNoSQLAttribute>); ZCNoSQLUpdateAttributeOperation.getDeleteAttributeInstance(<ZCNoSQLAttribute>); ``` La actualización también tiene ciertas funciones preconstruidas que se pueden usar para actualizar los valores. Estas funciones se pueden agrupar bajo el tipo NoSQLUpdateAttributeFunction y se pueden usar al obtener la instancia de ZCNoSQLUpdateAttributeOperation. ### NoSQLUpdateAttributeFunction Hay 4 funciones preconstruidas. #### ZCNoSQLIfNotExistFunction Esta función se usa para actualizar el atributo con el valor de otro atributo existente. Si el atributo no existe, entonces se actualiza con el valor proporcionado. ```java //public ZCNoSQLIfNotExistFunction(ZCNoSQLAttribute attribute, ZCNoSQLValue value) //public static ZCNoSQLIfNotExistFunction getInstance(ZCNoSQLAttribute attribute, ZCNoSQLValue value); new ZCNoSQLIfNotExistFunction(<ZCNoSQLAttribute>, <ZCNoSQLValue>) ZCNoSQLIfNotExistFunction.getInstance(<ZCNoSQLAttribute>, <ZCNoSQLValue>) ``` #### ZCNoSQLAppendListFunction Esta función se usa para agregar elementos a un atributo de lista existente o nuevo. ```java //public ZCNoSQLAppendListFunction(ZCNoSQLValue...values); //public static ZCNoSQLAppendListFunction getInstance(ZCNoSQLValue...values); new ZCNoSQLAppendListFunction(<List of ZCNoSQLValue>) ZCNoSQLAppendListFunction.getInstance(<List of ZCNoSQLValue>) ``` #### ZCNoSQLAdditionFunction Esta función se usa para agregar elementos a un conjunto o agregar un valor numérico a un atributo existente. El tipo de operación depende del tipo de atributo objetivo. ```java //public ZCNoSQLAdditionFunction(ZCNoSQLAttribute attribute, ZCNoSQLValue value); //public static ZCNoSQLAdditionFunction getInstance(ZCNoSQLAttribute attribute, ZCNoSQLValue value); new ZCNoSQLAdditionFunction(<ZCNoSQLAttribute>, <ZCNoSQLValue>) ZCNoSQLAdditionFunction.getInstance(<ZCNoSQLAttribute>, <ZCNoSQLValue>) ``` #### ZCNoSQLReductionFunction Esta función se usa para eliminar elementos de un conjunto o restar un valor numérico de un atributo existente. El tipo de operación depende del tipo de atributo objetivo. ```java //public ZCNoSQLReductionFunction(ZCNoSQLAttribute attribute, ZCNoSQLValue value) throws Exception; //public static ZCNoSQLReductionFunction getInstance(ZCNoSQLAttribute attribute, ZCNoSQLValue value) throws Exception; new ZCNoSQLReductionFunction(<ZCNoSQLAttribute>, <ZCNoSQLValue>) ZCNoSQLReductionFunction.getInstance(<ZCNoSQLAttribute>, <ZCNoSQLValue>) ``` Otros métodos disponibles en ZCNoSQLUpdateHelper #### ZCNoSQLCondition Las mismas condiciones descritas anteriormente se pueden reutilizar para la actualización también. NOSQL_RETURN_VALUE El mismo valor de retorno descrito anteriormente se puede reutilizar para la actualización también. Actualizar con condición y valor de retorno ```java table.getUpdateHelper(<ZCNoSQLItem>,<ZCNoSQLUpdateAttributeOperation>).withCondition(<ZCNoSQLCondition>).withReturnValue(<NOSQL_RETURN_VALUE>).update(); ```