# NoSQL -------------------------------------------------------------------------------- title: "Introducción" description: "Catalyst NoSQL es una base de datos potente y completamente administrada que te proporciona un medio de almacenamiento de datos no relacional y sin SQL. Crea, administra y consulta datos en tablas NoSQL con facilidad, y realiza operaciones CRUD en Java, Node.js y Python." last_updated: "2026-07-02T09:34:15.857Z" source: "https://docs.catalyst.zoho.com/es/cloud-scale/help/nosql/introduction/" service: "Cloud Scale" -------------------------------------------------------------------------------- # Catalyst NoSQL ### Introducción Catalyst Cloud Scale NoSQL es una base de datos potente y completamente administrada que ofrece un enfoque no relacional para el almacenamiento de datos. Te permite manejar datos no estructurados, semiestructurados y dispares sin depender de los modelos SQL tradicionales. La infraestructura propietaria altamente escalable, impulsada por Catalyst, garantiza que puedas crear y administrar bases de datos sin esfuerzo, sin preocuparte por tareas de backend como el aprovisionamiento, la configuración o el escalado. Esta flexibilidad la hace ideal para aplicaciones modernas orientadas a datos. Catalyst ofrece NoSQL además de su base de datos relacional convencional, el Data Store en el servicio CloudScale. Dependiendo de tus requisitos de negocio y otros factores, como la posibilidad de un esquema fijo en tu base de datos o la necesidad de un sistema con lectura intensiva, puedes determinar la opción de almacenamiento de datos adecuada para tu caso de uso. Consulta [esta sección comparativa](#catalyst-data-store-vs-nosql) entre Data Store y NoSQL para más ayuda. Catalyst admite el almacenamiento de datos de tipo documento basado en **pares clave-valor** en NoSQL, con la posibilidad de almacenar tus datos en un formato JSON personalizado de Catalyst que admite numerosos tipos de datos. Con la capacidad de particionar los datos entre clústeres, NoSQL ofrece una opción de almacenamiento de alto volumen, además de habilitar la escalabilidad multinivel. Si decides construir una aplicación con Catalyst NoSQL, puedes crear tablas fácilmente en tu proyecto, configurarlas, agregar datos o consultar datos desde la consola de Catalyst. También puedes migrar fácilmente tus bases de datos NoSQL existentes de fuentes de terceros a Catalyst en unos pocos pasos simples. Catalyst proporciona SDKs del lado del servidor para realizar diversas operaciones CRUD de NoSQL, como agregar o consultar datos, en los siguientes entornos de programación: * Java * Node.js * Python Consulta las documentaciones de SDK vinculadas para conocer los métodos de SDK disponibles. También puedes utilizar las APIs de NoSQL en Catalyst para estas operaciones. Consulta la documentación de la API para más detalles. <br> ### Catalyst Data Store vs NoSQL Catalyst proporciona tanto Data Store como Catalyst NoSQL como dos opciones diferentes de almacenamiento de datos, donde el primero es una base de datos SQL y relacional y el segundo, una base de datos no relacional. Puedes optar por la base de datos que se adapte a tus necesidades según diversos factores como tu lógica de negocio, la estructura de datos de tu aplicación o tu uso. Almacenar datos no estructurados en una base de datos relacional presenta problemas en la organización del esquema y frecuentemente genera redundancia de datos. Por lo tanto, debes elegir la plataforma de almacenamiento adecuada para tu caso de uso. Aquí tienes una guía práctica que te ayudará a decidir la mejor opción de base de datos para tus requisitos. #### Catalyst Data Store Elige Catalyst Data Store si se cumplen las siguientes condiciones: * Arquitectura: La arquitectura de tu base de datos es relacional, es decir, los puntos de datos están relacionados entre sí. * Estructura de datos: Tus datos están bien estructurados y pueden organizarse de forma ordenada en filas y columnas para formar colectivamente una tabla. * Esquema: El esquema de tu base de datos es uniforme, se conoce de antemano y puede diseñarse y finalizarse estáticamente antes de las operaciones de datos. * Lenguaje de consulta: Necesitas usar SQL para consultar, actualizar y mantener la base de datos. SQL funciona bien con bases de datos relacionales y estructuradas. * Prioridades: Tu prioridad para tu base de datos es el cumplimiento ACID (Atomicidad, Consistencia, Aislamiento y Durabilidad), y no la escalabilidad horizontal. * Rendimiento de lectura/escritura: Necesitas consultas rápidas, sin errores y eficientes con mínima latencia y sobrecarga para una base de datos con lectura intensiva. #### Catalyst NoSQL Elige Catalyst NoSQL si se cumplen las siguientes condiciones: * Arquitectura: No existen interdependencias ni relaciones entre los puntos de datos en tu base de datos, y existen como entidades independientes. * Estructura de datos: Tu base de datos contiene datos dispares semiestructurados o no estructurados que no pueden almacenarse en el formato tabular convencional, y están organizados de forma flexible. * Esquema: Necesitas que el esquema de tu base de datos sea altamente flexible donde no todos los elementos necesiten adherirse a la misma estructura, fácil de configurar, o si no puede diseñarse de antemano. * Formato de datos: Tus datos estarán principalmente en formato JSON, y necesitas el soporte de múltiples tipos de datos. * Prioridades: Tu prioridad es la alta escalabilidad, tanto vertical como horizontal, y necesitas almacenamiento en múltiples nodos de base de datos con asignación dinámica de recursos. * Rendimiento de lectura/escritura: Estás construyendo un sistema con escritura intensiva donde el particionamiento del almacenamiento entre clústeres distribuidos con replicación peer-to-peer puede ser beneficioso. -------------------------------------------------------------------------------- title: "Beneficios" description: "Catalyst NoSQL es una base de datos potente y completamente administrada que te proporciona un medio de almacenamiento de datos no relacional y sin SQL. Crea, administra y consulta datos en tablas NoSQL con facilidad, y realiza operaciones CRUD en Java, Node.js y Python." last_updated: "2026-07-02T09:34:15.857Z" source: "https://docs.catalyst.zoho.com/es/cloud-scale/help/nosql/benefits/" service: "Cloud Scale" -------------------------------------------------------------------------------- # Beneficios 1. Escalado Automático Horizontal y Vertical Rápido Catalyst ofrece una solución de base de datos de baja latencia y alto rendimiento con NoSQL, donde sus robustos servidores pueden escalar automáticamente hacia arriba o hacia abajo de forma fluida según la carga. La arquitectura de NoSQL también facilita tanto el escalado horizontal como vertical, donde se agregan nuevos recursos al sistema existente (escalado vertical) y se aprovisionan nuevos racks de servidores (escalado horizontal) según la demanda. Juntos, estos garantizan que se te proporcione una infraestructura duradera y confiable sobre la cual puedas almacenar y administrar eficientemente grandes volúmenes de datos. <br> 2. Infraestructura Completamente Administrada y Segura para tu Base de Datos Puedes experimentar una base de datos completamente administrada que te permite delegar todas las tareas administrativas con Catalyst, en comparación con una base de datos NoSQL autoalojada, y enfocarte solo en construir tu esquema y trabajar con tus datos. También te beneficias de una plataforma segura y confiable construida sobre la infraestructura probada de Zoho que protege tus datos y proporciona facilidad de desarrollo, funcionalidad y rendimiento a escala. <br> 3. Consultas Rápidas y Potentes con los Componentes de NoSQL Catalyst NoSQL proporciona consultas dinámicas y flexibles al admitir claves primarias compuestas que se componen tanto de claves de partición como de claves de ordenación. Esto resulta beneficioso al consultar, ya que el primer atributo se usa para determinar la partición en la que se almacena un elemento, mientras que el segundo puede determinar su rango en su orden de clasificación. Además de estos, Catalyst te permite consultar usando claves de ordenación adicionales, además de la clave de ordenación principal, así como crear y consultar con índices en tu tabla para mayor comodidad. Estas funcionalidades son ventajosas y garantizan que puedas construir y desplegar aplicaciones de alto rendimiento y confiables. <br> 4. Migración Fácil y Segura de Metadatos y Datos de Terceros Puedes utilizar un método conveniente para migrar grandes volúmenes de metadatos así como datos almacenados en servicios de terceros a Catalyst con solo unos clics. NoSQL actualmente admite la migración desde AWS DynamoDB configurando los tokens de acceso requeridos. Esta práctica funcionalidad te permite migrar el esquema y la información de metadatos de tus tablas NoSQL configuradas en AWS en el entorno de desarrollo de Catalyst, mientras aprovechas la capacidad de migrar datos de tus tablas NoSQL de AWS en el entorno de producción. <br> 5. Almacenamiento Optimizado y de Alta Disponibilidad La arquitectura subyacente general de NoSQL facilita una alta optimización del almacenamiento de datos mediante el uso de modelos de datos flexibles por defecto. El soporte de Catalyst NoSQL para el almacenamiento de datos basado en pares clave-valor elimina la dependencia del almacenamiento orientado a objetos, lo que garantiza aún más la optimización del almacenamiento. Además, el particionamiento y la replicación del almacenamiento entre clústeres proporciona alta tolerancia a fallos y alta disponibilidad de datos, incluso durante situaciones críticas. <br> 6. Solución de Almacenamiento Rentable Cuando eliges NoSQL para los requisitos adecuados, puedes beneficiarte de una forma altamente rentable de operar y administrar tus datos. Catalyst ofrece los mejores precios para realizar operaciones CRUD en NoSQL a través de sus estrategias innovadoras de precios, que mejoran aún más la eficiencia de costos. NoSQL también proporciona una forma automatizada de eliminar elementos de tus tablas marcando sus períodos de expiración a través de un atributo TTL (Time To Live), que te ahorra realizar escrituras innecesarias para la eliminación manual. <br> 7. Facilidad de Acceso con la Consola, SDK del Lado del Servidor y API Puedes crear tablas en NoSQL para tu proyecto desde la consola de Catalyst, así como realizar la configuración y administración de tablas, la adición y consulta de datos allí. Las operaciones de datos de NoSQL también están disponibles en los SDKs de Java, Node.js y Python, lo que te permite incorporarlas en tu lógica del lado del servidor con facilidad. Catalyst también te permite utilizar múltiples APIs para estas operaciones de NoSQL. -------------------------------------------------------------------------------- title: "Componentes de NoSQL" description: "Catalyst NoSQL es una base de datos potente y completamente administrada que te proporciona un medio de almacenamiento de datos no relacional y sin SQL. Crea, administra y consulta datos en tablas NoSQL con facilidad, y realiza operaciones CRUD en Java, Node.js y Python." last_updated: "2026-07-02T09:34:15.857Z" source: "https://docs.catalyst.zoho.com/es/cloud-scale/help/nosql/components/" service: "Cloud Scale" -------------------------------------------------------------------------------- # Componentes de NoSQL Para comprender la arquitectura de las bases de datos de Catalyst NoSQL y aprender a trabajar con ellas, primero debes entender los componentes que conforman las bases de datos NoSQL. ### Componentes Básicos A continuación se explican los componentes fundamentales involucrados en Catalyst NoSQL. #### Terminología <br> <table class="content-table nosql-components-table"> <thead> <tr> <th class="w10p">Nombre del Componente</th> <th class="w30p">Descripción</th> </tr> </thead> <tbody> <tr> <td>Tabla</td> <td>Una tabla es la estructura fundamental en la que NoSQL almacena datos. Similar a las bases de datos relacionales, las tablas están compuestas por registros o elementos. <br><br> La tabla de ejemplo Travel que se muestra a continuación contiene datos sobre destinos de viaje que se podrían visitar, con información clave sobre cada lugar.</td> </tr> <tr> <td>Atributos</td> <td>Un atributo representa una característica de un valor de datos en una tabla. Los atributos en NoSQL son como campos o columnas en una base de datos relacional, donde cada atributo contiene datos de un tipo de dato específico. <br><br> La tabla de ejemplo Travel a continuación contiene los atributos DestinationName, Distance, BestTimeToVist, Location y EstimatedCost.</td> </tr> <tr> <td>Elementos</td> <td>Un elemento es una colección de atributos que contienen los datos de un único punto de datos. Los elementos en NoSQL son similares a las filas o registros en una base de datos relacional, donde pueden contener valores para diferentes atributos. <br><br> En la tabla de ejemplo Travel, cada colección de datos identificada de forma única por DestinationName es un elemento. Por ejemplo, el registro "Honululu" que también contiene un conjunto de valores para Distance, BestTimeToVisit y EstimatedCost es un elemento. De manera similar, el registro identificado por "Prague" con diferentes valores de atributos es un elemento.<br><br> Nota: El tamaño total máximo de un elemento aprovisionado en Catalyst NoSQL es de 400 KB.</td> </tr> <tr> <td>Datos</td> <td>En términos de Catalyst NoSQL, los datos de una tabla están compuestos por todos los atributos y elementos en ella, presentes en el formato JSON personalizado de Catalyst. <br><br> El código JSON que se muestra a continuación para la tabla Travel representa los datos de la tabla. La sección de ayuda Trabajar con Datos elabora sobre el formato de datos JSON personalizado y los tipos de datos admitidos.</td> </tr> </tbody> </table> <br> #### Representación de Tabla de Ejemplo Nombre de la tabla: Travel { "item": { "DestinationName": { "S": "Honolulu" }, "Distance": { "N": 4960 }, "BestTimeToVist": { "L": [ { "S": "September" }, { "S": "October" }, { "S": "November" } ] }, "EstimatedCost": { "N": 2500 } }, "item": { "DestinationName": { "S": "Prague" }, "Distance": { "N": 4081 }, "Location": { "M": { "Country": { "S": "Czech Republic" }, "Continent": { "S": "Europe" } } }, "EstimatedCost": { "N": 3000 } }, "item": { "DestinationName": { "S": "Marrakesh" }, "Distance": { "N": 3700 }, "BestTimeToVist": { "L": [ { "S": "March" }, { "S": "April" }, { "S": "September" }, { "S": "October" } ] }, "Location": { "M": { "Country": { "S": "Morocco" }, "Continent": { "S": "Africa" } } }, "EstimatedCost": { "N": 1700 } } } La tabla *Travel* representa una tabla NoSQL simple en el formato JSON personalizado. La estructura incluye atributos anidados y arrays: BestTimeToVist está presente como un array del tipo de dato lista ("L"), y el atributo Location es un atributo anidado del tipo de dato mapa ("M") que contiene las claves Country y Continent. Nota: La tabla presentada aquí es una representación del formato JSON personalizado de Catalyst. Los formatos para construir datos en cada SDK del lado del servidor en este formato JSON varían. Para conocer la sintaxis general del formato JSON personalizado de Catalyst presente en esta tabla, así como los tipos de datos admitidos y sus notaciones, consulta esta sección. <br> ### Claves de Tabla Siguiendo una arquitectura NoSQL típica, Catalyst NoSQL almacena datos en particiones distribuidas entre clústeres, también conocidos como shards. Estos shards también pueden replicarse en múltiples servidores en espejos. Este almacenamiento distribuido entre múltiples nodos divide los conjuntos de datos en fragmentos más pequeños y promueve la optimización. Al consultar datos en una tabla NoSQL, debemos poder localizar la partición en la que se almacena un elemento específico. Además, ordenar a través de una partición para localizar un elemento también implica esfuerzos adicionales. Esto se logra con la ayuda de claves distintas que identifican particiones u ordenan a través de ellas, como se describe a continuación. #### Terminología <br> <table class="content-table nosql-components-table"> <thead> <tr> <th class="w10p">Nombre del Componente</th> <th class="w30p">Descripción</th> </tr> </thead> <tbody> <tr> <td>Clave de Partición</td> <td>La clave de partición identifica una partición lógica en un almacenamiento distribuido en la que se almacena un elemento de datos. Estas particiones lógicas se mapean a nodos de almacenamiento físico en el backend mediante funciones hash.<br><br> En la tabla de ejemplo Menu que se analiza a continuación, el atributo Category es una clave de partición.</td> </tr> <tr> <td>Clave de Ordenación</td> <td>La clave de ordenación principal ordena a través de una partición específica para localizar un elemento de datos y lo devuelve en un orden clasificado si más de 1 elemento coincide con la clave de partición en los datos. Esto se hace identificándolo a partir de un rango de hashes de clave. Catalyst te permite agregar una clave de ordenación opcionalmente al crear una tabla NoSQL. <br><br> En la tabla de ejemplo Menu que se analiza a continuación, el atributo DishName se considera como una clave de ordenación.</td> </tr> <tr> <td>Clave Primaria Simple</td> <td>Una clave primaria simple en Catalyst NoSQL denota únicamente la clave de partición. <br><br> Cuando eliges configurar solo una clave de partición para una tabla NoSQL sin una clave de ordenación, la clave de partición actuará como la clave primaria de la tabla identificando de forma única un elemento en ella. Esto es similar al concepto de una clave primaria en una base de datos relacional. <br><br> En la tabla de ejemplo Travel analizada en la sección anterior, el atributo DestinationName se considera como la clave primaria, ya que este atributo debe estar presente en todos los elementos y no pueden existir dos elementos con los mismos valores para este atributo.<br><br> Sin embargo, en la tabla de ejemplo Menu que se analiza a continuación, la clave de partición Category no identifica de forma única un elemento, porque pueden existir múltiples elementos con el mismo valor para ella. Esto se debe a que la tabla Menu utiliza una clave primaria compuesta. </td> </tr> <tr> <td>Clave Primaria Compuesta</td> <td>La clave primaria compuesta incluye tanto una clave de partición como una clave de ordenación para identificar de forma única un elemento, es decir, la combinación de ambas claves actúa como clave primaria. Consultar una tabla con la clave primaria compuesta es global, ya que los datos abarcan múltiples particiones.<br><br> A diferencia de la clave primaria simple que requiere que la clave de partición sea única, aquí puedes almacenar valores no únicos para la clave de partición, siempre y cuando definas también una clave de ordenación. <br><br> Nota: Para todos los elementos que tienen la misma clave de partición en una tabla, las claves de ordenación deben ser únicas. La tabla de ejemplo Menu que se analiza a continuación contiene una clave primaria compuesta donde la clave de partición Category y la clave de ordenación DishName juntas identifican de forma única un elemento de datos (un plato).</td> </tr> <tr> <td>Claves de Ordenación Adicionales</td> <td>Catalyst NoSQL te permite configurar claves de ordenación adicionales, además de la clave de ordenación principal, que es parte de la clave primaria compuesta. <br><br> Las claves de ordenación adicionales se utilizan si necesitas que la ordenación se realice según una clave diferente a la clave de ordenación principal, o si la clave de ordenación principal es desconocida para un elemento específico. En este caso, una combinación de la clave de partición y una clave de ordenación adicional se utilizará como clave primaria compuesta.<br><br> Consultar una tabla con claves de ordenación adicionales es similar a la indexación local, ya que todas se utilizan con la misma clave de partición para ordenar solo en esa partición específica.<br><br> Nota: Catalyst te permite configurar un máximo de 5 claves de ordenación adicionales para una tabla. En la tabla de ejemplo Menu que se analiza a continuación, los atributos PreparationTime y Calories están configurados como claves de ordenación adicionales.</td> </tr> </tbody> </table> <br> #### Representación de Tabla de Ejemplo Nombre de la tabla: Menu { "item": { "Category": { "S": "Pizza" }, "DishName": { "S": "Vegan" }, "Calories": { "N": 350 }, "PreparationTime": { "N": 20 }, "Cost": { "N:" 25 }, "DiscountPercentage": { "N": 5 }, "KeyIngredients": { "L": [ { "S": "Pizza Base" }, { "S": "Pizza Sauce" }, { "S": "Olives" }, { "S": "Bell Peppers" }, { "S": "Corn" }, { "S": "Onions" } ] } }, "item": { "Category": { "S": "Pizza" }, "DishName": { "S": "Chicken Overload" }, "Calories": { "N": 450 }, "PreparationTime": { "N": 30 }, "KeyIngredients": { "L": [ { "S": "Pizza Base" }, { "S": "Pizza Sauce" }, { "S": "Fried Chicken" }, { "S": "Paprika" } ] } }, "item": { "Category": { "S": "Sandwich" }, "DishName": { "S": "Vegan" }, "Calories": { "N": 300 }, "PreparationTime": { "N": 20 }, "Cost": { "N": 25 }, "DiscountPercentage": { "N": 15 } } } <br> La tabla Menu incluye varios atributos de los cuales Category es la clave de partición, DishName es la clave de ordenación, y PreparationTime y Calories son claves de ordenación adicionales. Nota: La tabla presentada aquí es una representación del formato JSON personalizado de Catalyst. Los formatos para construir datos en cada SDK del lado del servidor en este formato JSON varían. Para conocer la sintaxis general del formato JSON personalizado de Catalyst presente en esta tabla, así como los tipos de datos admitidos y sus notaciones, consulta esta sección. La clave primaria compuesta mejora la consulta de datos. Si esta tabla estuviera configurada solo con la clave primaria simple, es decir, con Category (ejemplo: "Pizza"), entonces consultarla obtendría todos los elementos de esa Category (todas las "pizzas" en el menú). Sin embargo, dado que está configurada con una clave primaria compuesta, es decir, con Category y DishName, consultarla con ambas claves recuperará un elemento único de esos valores (ejemplo: "Pizza" y "Vegan"). De manera similar, las claves de ordenación adicionales proporcionan mayor flexibilidad al consultar la tabla dentro de la misma partición. Puedes elegir consultar la tabla con la clave de ordenación adicional PreparationTime en combinación con la clave de partición Category (ejemplo: "Sandwich" y "20"). Antes de analizar la indexación, entendamos un atributo especial que Catalyst NoSQL proporciona para todas las tablas. <br> ### Time To Live (TTL) Time To Live (TTL) proporciona una forma automatizada de eliminar elementos en las tablas de Catalyst NoSQL después de un punto específico en el tiempo. Puedes configurar un atributo para almacenar la marca de tiempo de expiración en tu tabla al crearla. Luego puedes agregar la marca de tiempo de expiración de cada elemento en la tabla en el formato de tiempo Unix epoch al agregar los datos. Catalyst eliminará permanentemente los elementos de la tabla que hayan pasado su tiempo de expiración automáticamente, evitándote realizar actualizaciones manuales y consumir rendimiento de escritura. El atributo TTL es útil para eliminar elementos que no serán necesarios más allá de un punto específico en el tiempo o cuya validez es de corta duración. Los elementos que Catalyst elimina automáticamente después de que hayan pasado su fecha de expiración se eliminarán de la tabla y de cualquier lugar donde estén indexados. Catalyst opera un programador integrado una vez cada 24 horas para verificar si hay elementos cuyos valores de atributo TTL indican que han expirado. Esta verificación se realiza en todas las tablas NoSQL de todos tus proyectos, y los elementos que han pasado su expiración se eliminan permanentemente. Entendamos el TTL con un ejemplo. Supongamos que creamos un atributo llamado Expiry para almacenar la marca de tiempo TTL en la tabla Menu proporcionada en la sección anterior. Luego podemos definir la marca de tiempo de expiración para todos los elementos de la tabla de la siguiente manera. #### Representación de Tabla de Ejemplo Nombre de la tabla: Menu { "item": { "Category": { "S": "Pizza" }, "DishName": { "S": "Vegan" }, "Calories": { "N": 350 }, "PreparationTime": { "N": 20 }, "Cost": { "N:" 25 }, "DiscountPercentage": { "N": 5 }, "Expiry": { "N": 1715755926 } }, "item": { "Category": { "S": "Pizza" }, "DishName": { "S": "Chicken Overload" }, "Calories": { "N": 450 }, "PreparationTime": { "N": 30 }, "Expiry": { "N": 1715565610 } }, "item": { "Category": { "S": "Sandwich" }, "DishName": { "S": "Vegan" }, "Calories": { "N": 300 }, "PreparationTime": { "N": 20 }, "Cost": { "N": 25 }, "DiscountPercentage": { "N": 15 } "Expiry": { "N": 1715700869 } } } <br> Nota: La tabla presentada aquí es una representación del formato JSON personalizado de Catalyst. Los formatos para construir datos en cada SDK del lado del servidor en este formato JSON varían. Para conocer la sintaxis general del formato JSON personalizado de Catalyst presente en esta tabla, así como los tipos de datos admitidos y sus notaciones, consulta esta sección. Puntos a recordar: * Podrás actualizar el valor del atributo TTL para elementos en una tabla NoSQL en cualquier momento que lo necesites. Cuando se ejecute el programador integrado de Catalyst, identificará y procesará los elementos según el último valor de TTL. * También puedes eliminar el atributo TTL para elementos según tus necesidades, basándote en los valores proporcionados -------------------------------------------------------------------------------- title: "Crear y Administrar Tablas" description: "Catalyst NoSQL es una base de datos potente y completamente administrada que te proporciona un medio de almacenamiento de datos no relacional y sin SQL. Crea, administra y consulta datos en tablas NoSQL con facilidad, y realiza operaciones CRUD en Java, Node.js y Python." last_updated: "2026-07-02T09:34:15.860Z" source: "https://docs.catalyst.zoho.com/es/cloud-scale/help/nosql/create-manage-tables/" service: "Cloud Scale" -------------------------------------------------------------------------------- # Crear y Administrar Tablas en NoSQL Analicemos ahora cómo trabajar con tablas NoSQL desde la consola de Catalyst. Nota: Las configuraciones realizadas en esta sección, como agregar y administrar tablas, solo se pueden hacer desde la consola remota, y no a través de los SDKs o la API. Puedes realizar operaciones de datos desde los SDKs del lado del servidor y la API. Puedes acceder a NoSQL en tu proyecto de Catalyst desde el servicio CloudScale en tu consola. ### Crear una Tabla Para crear una tabla en Catalyst NoSQL en tu proyecto: 1. Dirígete al servicio CloudScale en la consola, luego haz clic en NoSQL. <br> 2. Haz clic en Create Table. 3. Ingresa un nombre para la tabla. Debes configurar la Clave de Partición proporcionando un nombre de clave y seleccionando el tipo de dato de la clave. Nota: Solo puedes configurar la clave de partición con los tipos de datos String, Numeric o Binary. Para conocer los tipos de datos admitidos y sus notaciones, consulta esta sección. Nota: No podrás modificar ni eliminar la clave de partición configurada para una tabla, ni eliminar el atributo de clave de partición de ningún elemento de datos, después de configurarla. Dado que esta es la clave primaria, todos los elementos deben incluir este valor.<br> 4. Opcionalmente puedes configurar una Clave de Ordenación para la tabla para incluir una Clave Primaria Compuesta seleccionando Yes en "Include Sort Key?". Sin embargo, si solo prefieres tener la clave de partición (Clave Primaria Simple), entonces selecciona No. <br> Si incluyes una clave de ordenación, ingresa el nombre de la clave y selecciona el tipo de dato de la clave. Nota: * No podrás modificar ni eliminar la Clave de Ordenación en una tabla después de configurarla. * Solo puedes configurar la clave de ordenación con los tipos de datos String, Numeric o Binary. Para conocer los tipos de datos admitidos y sus notaciones, consulta esta sección. <br> 5. Si necesitas que se incluyan Claves de Ordenación Adicionales en tu tabla, puedes agregarlas proporcionando el nombre de la clave y seleccionando el tipo de dato. Puedes agregar múltiples claves haciendo clic en (+). Nota: * No podrás modificar ni eliminar las Claves de Ordenación Adicionales en una tabla después de configurarlas. * Catalyst te permite configurar un máximo de 5 Claves de Ordenación Adicionales en una tabla. * Solo puedes configurar las claves de ordenación adicionales con los tipos de datos String, Numeric o Binary. Para conocer los tipos de datos admitidos y sus notaciones, consulta esta sección. <br> 6. Configura un atributo para almacenar la marca de tiempo TTL para la tabla. Puedes agregar valores para este atributo para cada elemento en la tabla para indicar su fecha de expiración. Nota: Puedes deshabilitar el atributo TTL en una tabla después de configurarlo. Sin embargo, no podrás cambiar el nombre del atributo, ni habilitarlo/configurarlo nuevamente una vez deshabilitado.<br> 7. Después de configurar la tabla, haz clic en Create. La tabla NoSQL se creará y se listará bajo Tables en tu proyecto. Catalyst creará automáticamente un ID de tabla único para tu tabla que puedes usar para referenciarla al realizar acciones de SDK y API. Hay tres secciones en la tabla: Overview, Indexes y Data. <br> ### La Sección Overview La sección Overview proporciona un vistazo de la configuración y los detalles de la tabla. Muestra toda la información esencial, como el ID de tabla único, los detalles de la persona que la creó, el atributo TTL, etc. El Storage Size indica el tamaño de la tabla. Una tabla vacía contendrá 0 bytes, así como 0 elementos de datos. Catalyst opera un programador integrado una vez cada 24 horas que calcula y actualiza el Storage Size y el No. of Items de cada tabla. También puedes ver la clave de partición, la clave de ordenación y las claves de ordenación adicionales configuradas para la tabla. El No. of Indexes indica la cantidad de índices creados a partir de la tabla. Haz clic en View aquí para navegar a la sección de Indexes. <br> ### Editar una Tabla Puedes editar una tabla en NoSQL y modificar el nombre de la tabla, o deshabilitar el atributo TTL configurado para una tabla. Sin embargo, no podrás modificar la clave de partición, la clave de ordenación ni las claves de ordenación adicionales que configuraste, ni el nombre del atributo TTL. Para editar una tabla NoSQL: 1. Haz clic en el ícono de puntos suspensivos desde la sección Overview de la tabla, luego haz clic en Edit. <br> 2. Modifica los detalles requeridos de la tabla, luego haz clic en Update. Nota: Si deshabilitas el atributo TTL, no podrás habilitarlo ni configurarlo nuevamente para la tabla. Deshabilitar el atributo TTL impedirá que Catalyst elimine automáticamente los elementos de datos expirados de la tabla. <br> ### Eliminar una Tabla Puedes eliminar permanentemente una tabla y todos los datos que contiene en NoSQL de la siguiente manera: 1. Haz clic en el ícono de puntos suspensivos desde la sección Overview de la tabla, luego haz clic en Delete. <br> 2. Haz clic en Delete en la ventana emergente de confirmación. -------------------------------------------------------------------------------- title: "Búsqueda por Consulta" description: "Catalyst NoSQL es una base de datos potente y completamente administrada que te proporciona un medio de almacenamiento de datos no relacional y sin SQL. Crea, administra y consulta datos en tablas NoSQL con facilidad, y realiza operaciones CRUD en Java, Node.js y Python." last_updated: "2026-07-02T09:34:15.861Z" source: "https://docs.catalyst.zoho.com/es/cloud-scale/help/nosql/query-search/" service: "Cloud Scale" -------------------------------------------------------------------------------- # Búsqueda por Consulta en NoSQL ### Descripción General Catalyst te permite realizar búsquedas por consulta para leer datos de tablas en NoSQL desde la consola, el SDK del lado del servidor en Java, Node.js o Python, o a través de API. La sección Data en la consola incluye una sección de consulta donde puedes buscar datos y los resultados se mostrarán en ella. Una operación de consulta en NoSQL tiene como alcance una partición del almacenamiento de datos. Esto significa que puedes buscar dentro de una partición un elemento basándote solo en la clave de partición, en caso de que la tabla esté configurada con una clave primaria simple. Si la tabla está configurada con una clave primaria compuesta, la búsqueda se realiza usando la combinación de una clave primaria y una clave de ordenación. También puedes utilizar claves de ordenación adicionales que hayas configurado para una tabla en combinación con la clave de partición para ejecutar búsquedas por consulta. Consulta esta página para conocer más sobre las claves de tabla. Puedes basar una búsqueda por consulta en una tabla o en un índice de la tabla. Esto le indicará a Catalyst que busque en la partición apropiada y proporcione las claves primarias apropiadas para la búsqueda. <br> ### Operadores Admitidos Catalyst admite varios operadores que puedes usar para ejecutar consultas. Estos operadores solo se pueden usar con la clave de ordenación principal y las claves de ordenación adicionales. Dependiendo del tipo de dato de las claves de ordenación, los operadores admitidos varían. Nota: Solo puedes usar el operador "EQUALS" con la clave de partición. Los operadores listados a continuación solo se pueden usar con la clave de ordenación de un índice, o la clave de ordenación y las claves de ordenación adicionales de una tabla. <br> <table class="content-table nosql-components-table"> <thead> <tr> <th class="w10p">Tipo de Dato de la Clave de Ordenación</th> <th class="w10p">Operadores Admitidos</th> </tr> </thead> <tbody> <tr> <td>String</td> <td>Equals, Not Equals, Between, Not Between, Greater Than, Lesser Than, Greater Than or Equal To, Lesser Than or Equal To</td> </tr> <tr> <td>Numeric</td> <td>Equals, Not Equals, Between, Not Between, Begins With, Ends With, Greater Than, Lesser Than, Greater Than or Equal To, Lesser Than or Equal To, Contains, Not Contains, In, Not In</td> </tr> </tbody> </table> <br> Nota: Todos los operadores admitidos están disponibles a través de operaciones de SDK y API, mientras que algunos de estos operadores admitidos no están disponibles en la búsqueda de la consola. Consulta la documentación de ayuda del SDK y la API respectivos para más detalles. <br> ### Ejecutar una Búsqueda por Consulta Puedes ejecutar una búsqueda por consulta desde la consola de Catalyst para leer datos de una tabla NoSQL de la siguiente manera: 1. Dirígete a la sección Data de la tabla en NoSQL. <br> 2. Puedes seleccionar el nombre de la tabla o cualquiera de los índices en los que realizar la búsqueda, desde el menú desplegable en la parte superior. Catalyst listará la tabla y todos los índices. <br> 3. Si la tabla está configurada con la clave primaria simple, ingresa un valor para la clave de partición a buscar. El tipo de dato configurado para la clave de partición se mostrará automáticamente. Si la tabla está configurada con la clave primaria compuesta, ingresa el valor para la clave de partición, luego selecciona el operador requerido de la lista para la clave de ordenación e ingresa un valor a buscar. Puedes elegir la clave de ordenación principal o cualquiera de las claves de ordenación adicionales, si están configuradas. El tipo de dato configurado para la clave de ordenación se mostrará automáticamente. Nota: Solo puedes usar el [operador "EQUALS"](#operadores-admitidos) con la clave de partición. Dependiendo del tipo de dato de la clave de ordenación principal o adicional, los operadores apropiados estarán disponibles para su selección.<br> 4. También puedes marcar la casilla "Enable this to search using ascending sort" para listar los resultados de búsqueda en orden ascendente. El orden descendente se usará por defecto. Si no se ha configurado ninguna clave de ordenación para la tabla o el índice que seleccionas, el orden de los datos recuperados se basa en la clave de partición de la tabla. 5. Después de configurar los parámetros de consulta, haz clic en Search. <br> Los resultados de la consulta se mostrarán en esta sección. Si no se encuentran resultados, Catalyst mostrará un mensaje apropiado. Puedes usar la opción de filtro para elegir las columnas a mostrar, o ver los datos como JSON, como se analizó en la sección anterior. -------------------------------------------------------------------------------- title: "Migración de Terceros" description: "Catalyst NoSQL es una base de datos potente y completamente administrada que te proporciona un medio de almacenamiento de datos no relacional y sin SQL. Crea, administra y consulta datos en tablas NoSQL con facilidad, y realiza operaciones CRUD en Java, Node.js y Python." last_updated: "2026-07-02T09:34:15.861Z" source: "https://docs.catalyst.zoho.com/es/cloud-scale/help/nosql/third-party-migration/" service: "Cloud Scale" -------------------------------------------------------------------------------- # Migración de Terceros ### Introducción Catalyst proporciona la capacidad de migrar bases de datos NoSQL de fuentes de terceros. Esta migración solo se admite para bases de datos de tipo NoSQL y no para bases de datos relacionales u otros tipos. La posibilidad de migrar una base de datos de una fuente externa te permite cambiar fácilmente a Catalyst para tus necesidades de NoSQL. Si habías mantenido bases de datos NoSQL para aplicaciones o microservicios de Catalyst en un entorno externo, puedes beneficiarte de integrarla dentro de tu ecosistema de Catalyst y administrar toda la configuración aquí. Puedes realizar la migración desde la consola de Catalyst con solo unos clics. Todo lo que necesitas hacer para migrar bases de datos es proporcionar las credenciales requeridas para acceder a la base de datos de terceros y elegir las tablas a migrar. Catalyst garantiza que no experimentes tiempo de inactividad ni problemas de latencia durante el proceso de migración. Después de que la base de datos se migre, puedes acceder a las tablas en la sección NoSQL en la consola dentro de tu proyecto. Nota: Puedes consultar la página de Precios para obtener información de precios del almacenamiento así como de las operaciones CRUD en NoSQL. <br> Catalyst actualmente admite la migración desde esta fuente de terceros: AWS DynamoDB Hay dos opciones diferentes de migración que puedes utilizar: * Migrar metadatos: Esta opción solo migrará el esquema y los metadatos de tus tablas desde la fuente de terceros. Está disponible únicamente en el entorno de desarrollo en Catalyst. * Migrar datos: Esta opción migrará los datos de tus tablas junto con las configuraciones desde la fuente de terceros. Está disponible únicamente en el entorno de producción en Catalyst. Puedes elegir la opción apropiada que necesites y realizar la migración desde el entorno adecuado. <br> ## Migrar desde AWS DynamoDB Para realizar migraciones desde AWS, se te pedirá configurar credenciales de clave de acceso de AWS con Catalyst. Las credenciales de clave de acceso de AWS te permiten acceder a los recursos de AWS a través de su CLI o API. Las claves de acceso de AWS se componen de dos partes: Access Key ID y Secret Access Key. Necesitarás configurar ambas en Catalyst, y también proporcionar información sobre la región de AWS a la que pertenece tu cuenta de AWS. Nota: Consulta los enlaces proporcionados anteriormente para aprender sobre la creación u obtención de credenciales de clave de acceso para tu cuenta de AWS, así como para encontrar la región de tu cuenta. <br> ### Migrar Metadatos desde DynamoDB Puedes migrar los metadatos de las tablas en tu AWS DynamoDB mientras trabajas en el entorno de desarrollo de Catalyst. Este es el entorno predeterminado en Catalyst y, por lo tanto, puedes acceder a esta opción de migración por defecto. Puedes usar esta opción si prefieres crear nuevos datos para tu base de datos y solo necesitas las configuraciones de tabla. La migración de metadatos migrará las configuraciones de tabla y las configuraciones de índices de las tablas que selecciones, como sus claves de partición y claves de ordenación configuradas, así como cualquier otra metainformación o configuración que Catalyst NoSQL admita. Para migrar metadatos desde AWS DynamoDB a Catalyst NoSQL en tu proyecto: 1. Dirígete a NoSQL desde la sección CloudScale desde el entorno de desarrollo en la consola, luego haz clic en Third-Party Meta Migration. <br> 2. Esto abrirá una ventana emergente. Ingresa el Access Key ID, Secret Access Key y la región de tu cuenta de AWS. Luego, haz clic en Next. <br> 3. Selecciona las tablas cuyos metadatos deseas migrar desde tu DynamoDB. Luego, haz clic en Import. <br> Catalyst entonces programará el proceso de migración. El tiempo necesario para completar la migración depende del número de tablas y sus tamaños. <br> Después de que las tablas se migren, recibirás una notificación. <br> Luego puedes acceder a las tablas importadas en tu proyecto actualizando la consola. Encontrarás las tablas importadas con sus configuraciones en NoSQL, y entonces podrás proceder a agregar datos. <br> ### Migrar Datos desde DynamoDB Para migrar datos de las tablas en tu AWS DynamoDB, primero necesitarás acceder al entorno de producción en Catalyst. Si nunca has desplegado tu proyecto de Catalyst a producción, primero debes hacerlo para habilitar la producción. Consulta esta página de ayuda para desplegar proyectos al entorno de producción. Una vez que puedas acceder al entorno de producción de tu proyecto, puedes cambiar al entorno de producción en la consola desde el encabezado. Puedes usar la opción de migrar datos junto con el esquema si necesitas que se migre la base de datos completa. Esto importará los datos de las tablas que selecciones, así como las configuraciones y metadatos de las tablas que elijas. Esto incluye las configuraciones de tabla y las configuraciones de índices de las tablas que selecciones, como sus claves de partición y claves de ordenación configuradas, así como cualquier otra metainformación o configuración que Catalyst NoSQL admita. <br> Para migrar datos desde AWS DynamoDB a Catalyst NoSQL en tu proyecto: 1. Dirígete a NoSQL desde la sección CloudScale desde el entorno de producción en la consola, luego haz clic en Third-Party Data Migration. <br> 2. Esto abrirá una ventana emergente. Ingresa el Access Key ID, Secret Access Key y la región de tu cuenta de AWS. Luego, haz clic en Next. <br> 3. Selecciona las tablas cuyos datos deseas migrar desde tu DynamoDB. Luego, haz clic en Import. Catalyst entonces programará el proceso de migración. El tiempo necesario para completar la migración depende del número de tablas y sus tamaños según el volumen de los datos. <br> Después de que las tablas se migren, recibirás una notificación. <br> Luego puedes acceder a las tablas importadas con sus datos en tu proyecto. Puedes actualizar o eliminar elementos, o procesar los datos según sea necesario. ## Indexación -------------------------------------------------------------------------------- title: "Introducción" description: "Catalyst NoSQL es una base de datos potente y completamente administrada que te proporciona un medio de almacenamiento de datos no relacional y sin SQL. Crea, administra y consulta datos en tablas NoSQL con facilidad, y realiza operaciones CRUD en Java, Node.js y Python." last_updated: "2026-07-02T09:34:15.861Z" source: "https://docs.catalyst.zoho.com/es/cloud-scale/help/nosql/indexing/introduction/" service: "Cloud Scale" -------------------------------------------------------------------------------- # Indexación en NoSQL Catalyst NoSQL proporciona la capacidad de crear índices para tablas NoSQL que te permitirán ejecutar consultas alternativas sobre los datos de la tabla, sin hacer uso de las claves primarias. Esto significa que puedes crear y utilizar índices secundarios y buscar elementos de datos por otros atributos además de la clave de partición y la clave de ordenación. Los índices facilitan la conveniencia y agregan flexibilidad en las operaciones de recuperación de datos, ya que resultan útiles en escenarios que requieren priorizar atributos no convencionales en una tabla. Consultar usando índices acelera el proceso de lectura de datos y promueve la eficiencia. También puedes modificar o eliminar índices en una tabla según tus requisitos sin afectar la tabla principal de ninguna manera. ### Arquitectura de los Índices Los índices de Catalyst NoSQL abarcan toda la tabla y todas las particiones en las que se almacenan los datos de la tabla. Esta funcionalidad de indexación global entre particiones resulta altamente beneficiosa ya que te permite ejecutar consultas a través de todas las claves de partición de una tabla. Catalyst te permite crear un máximo de 20 índices para una tabla. Puedes configurar claves de partición y claves de ordenación individuales para cada índice que crees. Debido a que la indexación es global, podrás configurar claves de partición y ordenación diferentes de las configuradas en la tabla principal. Esencialmente, un índice puede considerarse como una copia de la tabla principal creada con diferentes claves de partición y ordenación para diferentes requisitos en la consulta de datos. En términos de arquitectura, cuando se crea un índice para una tabla, se almacena una copia de ella en diferentes nodos de almacenamiento con las mismas reglas de particionamiento aplicables a la tabla principal. Por lo tanto, cuando ejecutas consultas basadas en un índice secundario, aún puedes acceder a todos los atributos y datos de la tabla. Nota: Catalyst actualizará automáticamente los índices cuando agregues, actualices o elimines datos de su tabla base. <br> ### Tipos de Índices Catalyst proporciona tres formas diferentes de indexar una tabla en NoSQL: * Indexar Todos los Atributos: Esto creará un índice de todos los atributos de una tabla. Cuando elijas esta opción, Catalyst esencialmente replicará todos los atributos de la tabla y los almacenará según la clave de partición que configures para el índice. * Indexar Solo Claves: Esto indexará solo los atributos de clave de partición, clave de ordenación y las claves de ordenación adicionales, si las hay, en una tabla. Estos atributos de clave se almacenan según la clave de partición que configures para el índice. * Indexar Atributos Específicos: Esto indexará atributos específicos de una tabla que selecciones. Los atributos seleccionados se replican y almacenan según la clave de partición que configures para el índice. Cuando ejecutas una consulta basada en un índice, los atributos de clave de partición y clave de ordenación de la tabla y del índice se devolverán junto con otros atributos según el tipo que hayas configurado. Entendamos mejor la indexación con un ejemplo. La tabla Menu analizada en las secciones anteriores se actualiza y se muestra a continuación. #### Representación de Tabla de Ejemplo Nombre de la tabla- Menu { "item": { "Category": { "S": "Pizza" }, "DishName": { "S": "Vegan" }, "Calories": { "N": 350 }, "PreparationTime": { "N": 20 }, "DiscountPercentage": { "N": 12 }, "KeyIngredients": { "L": [ { "S": "Pizza Base" }, { "S": "Pizza Sauce" }, { "S": "Olives" }, { "S": "Bell Peppers" }, { "S": "Corn" }, { "S": "Onions" } ] } }, "item": { "Category": { "S": "Pizza" }, "DishName": { "S": "Chicken Overload" }, "Cost": { "N": 25 }, "DiscountPercentage": { "N": 15 }, "Calories": { "N": 450 }, "PreparationTime": { "N": 30 } }, "item": { "Category": { "S": "Sandwich" }, "DishName": { "S": "Vegan" }, "Calories": { "N": 300 }, "PreparationTime": { "N": 20 }, "Cost": { "N": 20 }, "DiscountPercentage": { "N": 10 } } } Nota: La tabla presentada aquí es una representación del formato JSON personalizado de Catalyst. Los formatos para construir datos en cada SDK del lado del servidor en este formato JSON varían. Para conocer la sintaxis general del formato JSON personalizado de Catalyst presente en esta tabla, así como los tipos de datos admitidos y sus notaciones, consulta esta sección. Supongamos que creas un índice, Pricing, para esta tabla con las siguientes configuraciones: * Clave de Partición: Cost * Clave de Ordenación: DiscountPercentage * Tipo de Índice: Atributos Específicos (Calories y PreparationTime) A continuación se muestra una representación del índice creado. #### Representación de Índice de Ejemplo Nombre del índice- Pricing { "item": { "Cost": { "N": 25 }, "DiscountPercentage": { "N": 15 }, "Category": { "S": "Pizza" }, "DishName": { "S": "Chicken Overload" } "Calories": { "N": 450 }, "PreparationTime": { "N": 30 } }, "item": { "Cost": { "N": 20 }, "DiscountPercentage": { "N": 10 }, "Category": { "N": "Sandwich" }, "DishName": { "N": "Vegan" }, "Calories": { "N": 300 }, "PreparationTime": { "N": 20 } } } Nota: Los elementos de datos que no contienen la clave de partición de un índice se omiten de la indexación. En este ejemplo, el elemento identificado por "Pizza" y "Vegan" de la tabla principal no se indexa porque no incluye el valor para la clave de partición del índice, Cost. -------------------------------------------------------------------------------- title: "Crear y Administrar Índices" description: "Catalyst NoSQL es una base de datos potente y completamente administrada que te proporciona un medio de almacenamiento de datos no relacional y sin SQL. Crea, administra y consulta datos en tablas NoSQL con facilidad, y realiza operaciones CRUD en Java, Node.js y Python." last_updated: "2026-07-02T09:34:15.861Z" source: "https://docs.catalyst.zoho.com/es/cloud-scale/help/nosql/indexing/create-manage-indexes/" service: "Cloud Scale" -------------------------------------------------------------------------------- # Crear y Administrar Índices Veamos cómo crear y trabajar con índices en tu tabla NoSQL en la consola de Catalyst. Nota: Las configuraciones realizadas en esta sección, como crear y administrar índices, solo se pueden hacer desde la consola remota, y no a través de los SDKs o la API. Puedes realizar operaciones de datos desde los SDKs del lado del servidor y la API. ### Crear un Índice Para crear un índice para una tabla NoSQL en tu proyecto: 1. Dirígete a la sección Indexes de la tabla desde el componente NoSQL, luego haz clic en Add Index. 2. Ingresa un nombre para el índice. Debes configurar la Clave de Partición para el índice proporcionando un nombre de clave y seleccionando el tipo de dato de la clave. Nota: No podrás modificar ni eliminar la Clave de Partición del índice después de configurarla. 3. Opcionalmente puedes configurar una Clave de Ordenación si la necesitas para el índice seleccionando Yes en "Include Sort Key?". Sin embargo, si solo prefieres tener la clave de partición, entonces selecciona No. Si incluyes una clave de ordenación, ingresa el nombre de la clave y selecciona el tipo de dato de la clave. Nota: No podrás modificar ni eliminar la Clave de Ordenación del índice después de configurarla. 4. Selecciona un Tipo de Atributo para el índice. Si seleccionas Include Columns, especifica los atributos a indexar. Catalyst te permitirá agregar múltiples atributos en la ventana. Puedes hacer clic en (-) para eliminar un atributo. 5. Después de configurar el índice, haz clic en Create. El índice para tu tabla NoSQL se creará y se listará en la sección Indexes. Catalyst creará automáticamente un ID de índice único para tu índice que puedes usar para referenciarlo al realizar acciones de SDK y API. <br> ### La Sección de Índices La sección Index proporciona un vistazo de todos los índices configurados para una tabla particular y sus detalles. Muestra información esencial, como el ID de índice único, la clave de partición y la clave de ordenación configuradas para él, y el tamaño y la cantidad de elementos en el índice. Una tabla vacía contendrá 0 bytes y 0 elementos de datos. Catalyst opera un programador integrado una vez cada 24 horas que calcula y actualiza el Storage Size y el No. of Items de cada índice. Para los índices creados para atributos específicos, la sección de índices mostrará un botón View para mostrar todos los atributos que están indexados. Puedes ver los atributos haciendo clic en él. <br> ### Editar un Índice Puedes editar un índice creado para una tabla en NoSQL para modificar el nombre del índice. Sin embargo, no podrás modificar la clave de partición, la clave de ordenación ni los tipos de atributos que configuraste para él. Para editar el índice de una tabla: 1. Haz clic en el ícono de puntos suspensivos del índice en la sección Indexes, luego haz clic en Edit. <br> 2. Modifica el nombre del índice, luego haz clic en Update. <br> ### Eliminar un Índice Puedes eliminar permanentemente el índice de una tabla en NoSQL. Esto lo eliminará del almacenamiento y ya no podrás ejecutar consultas basadas en el índice. Para eliminar permanentemente un índice de una tabla NoSQL: 1. Haz clic en el ícono de puntos suspensivos del índice en la sección Indexes, luego haz clic en Delete. <br> 2. Haz clic en Delete en la ventana emergente de confirmación. ## Trabajar con Datos -------------------------------------------------------------------------------- title: "Introducción" description: "Catalyst NoSQL es una base de datos potente y completamente administrada que te proporciona un medio de almacenamiento de datos no relacional y sin SQL. Crea, administra y consulta datos en tablas NoSQL con facilidad, y realiza operaciones CRUD en Java, Node.js y Python." last_updated: "2026-07-02T09:34:15.863Z" source: "https://docs.catalyst.zoho.com/es/cloud-scale/help/nosql/working-with-data/introduction/" service: "Cloud Scale" -------------------------------------------------------------------------------- # Trabajar con Datos en NoSQL Las unidades de datos en NoSQL se denominan *Elementos*, donde cada elemento de datos es similar a un registro o fila en una base de datos relacional, como se describe en esta Terminología. Catalyst te permite realizar operaciones CRUD en tus tablas NoSQL usando los SDKs del lado del servidor de Java, Node.js o Python y a través de API. Nota: También puedes realizar operaciones CRUD desde la consola de Catalyst para probar el trabajo con datos en NoSQL. Sin embargo, solo podrás agregar un elemento en una tabla desde la consola. Catalyst admite el almacenamiento de datos de tipo documento basado en pares clave-valor con la capacidad de agregar datos en el formato JSON personalizado de Catalyst, que se explica en la siguiente sección. Nota: Puedes agregar datos en el formato JSON regular que sigue la sintaxis del estándar internacional solo desde la consola de Catalyst para pruebas. Sin embargo, al trabajar con los SDKs y la API, solo podrás agregar datos en el formato JSON personalizado. Catalyst también te permite usar múltiples tipos de datos en los datos JSON, con los que puedes configurar los atributos de NoSQL. Puedes declarar el tipo de dato correcto para un atributo al agregar o actualizar datos en la tabla. <br> ### Tipos de Datos Admitidos Los tipos de datos admitidos en Catalyst para los atributos de NoSQL se listan a continuación. <br> <table class="content-table nosql-components-table"> <thead> <tr> <th class="w10p">Tipo de Dato</th> <th class="w10p">Notación</th> <th class="w30p">Descripción</th> </tr> </thead> <tbody> <tr> <td>String</td> <td>S</td> <td>Almacena una secuencia de caracteres</td> </tr> <tr> <td>Number</td> <td>N</td> <td>Almacena un valor numérico</td> </tr> <tr> <td>Binary</td> <td>B</td> <td>Almacena un número binario que representa una secuencia de bytes</td> </tr> <tr> <td>Boolean</td> <td>BOOL</td> <td>Almacena uno de estos valores booleanos: true o false</td> </tr> <tr> <td>Set of String</td> <td>SS</td> <td>Un conjunto que almacena una o más cadenas únicas</td> </tr> <tr> <td>Set of Numbers</td> <td>SN</td> <td>Un conjunto que almacena una colección de números</td> </tr> <tr> <td>Set of Binary</td> <td>SB</td> <td>Un conjunto que almacena una colección de números binarios como un conjunto de bytes</td> </tr> <tr> <td>List</td> <td>L</td> <td>Almacena elementos ordenados del mismo tipo de dato</td> </tr> <tr> <td>Map</td> <td>M</td> <td>Almacena una colección no ordenada de elementos de pares clave-valor</td> </tr> <tr> <td>Null</td> <td>NULL</td> <td>Almacena solo un valor: NULL</td> </tr> </tbody> </table> Para entender las notaciones y el uso de estos tipos de datos al agregar datos en NoSQL, consulta la [sección del formato JSON personalizado de Catalyst](#el-formato-json-personalizado-de-catalyst). Nota: * Cuando configuras una tabla o un índice en NoSQL desde la consola, Catalyst te permite seleccionar solo uno de los dos tipos de datos, String o Number, para las claves primarias de la tabla. Esto incluye la clave de partición, la clave de ordenación y las claves de ordenación adicionales. * Al agregar o actualizar datos en tu tabla NoSQL, debes asegurarte de agregar siempre el valor apropiado para un atributo que coincida con el tipo de dato que declares para él. Cualquier discrepancia entre los tipos de datos y los valores generará errores. <br> ### El Formato JSON Personalizado de Catalyst El JSON personalizado de Catalyst es el formato de datos JSON que Catalyst puede procesar para NoSQL. La sintaxis es similar al formato JSON estándar con la adición de especificar el [tipo de dato](#tipos-de-datos-admitidos) con el que cada atributo está configurado. Veamos una tabla de ejemplo para entender el formato JSON personalizado de Catalyst. #### Representación de Tabla de Ejemplo Nombre de la tabla- Employees { "item": { "EmpID": { "N": "10999" }, "FirstName":{ "S": "Paul" }, "LastName":{ "S": "Smith" }, "YearOfJoining":{ "N": 2011 }, "PriorExperience":{ "BOOL": false }, "Location": { "M": { "Country": { "S": "USA" }, "City": { "S": "New York" } } } }, "item": { "EmpID": { "N": "10113" }, "FirstName":{ "S": "Lana" }, "LastName":{ "S": "Belle" }, "YearOfJoining":{ "N": 2019 }, "PriorExperience":{ "BOOL": true }, "Department": { "S": "IT" } }, "item": { "EmpID": { "N": "29123" }, "FirstName":{ "S": "Kevin" }, "LastName":{ "S": "Wilson" }, "YearOfJoining":{ "N": 2023 }, "Clubs":{ "L": [ { "S": "Innovate" }, { "S": "Swimmers of NPY" }, { "S": "Technova" } ] } } } La tabla *Employees* incluye propiedades JSON anidadas bajo el atributo Location, así como un atributo, Clubs, con valores de array. En esta tabla, cada atributo se denota con el tipo de dato configurado para él, como N (Number) para EmpI y YearOfJoining, o S para FirstName y LastName. El atributo booleano PriorExperience se denota como BOOL. Consulta la [sección de Tipos de Datos Admitidos](#tipos-de-datos-admitidos) para todos los tipos de datos y sus notaciones que puedes usar. #### Puntos Importantes a Recordar: * Las claves primarias de la tabla (la clave de partición y las claves de ordenación) deben estar presentes en la raíz al construir un elemento para agregar o actualizar datos en una tabla. El formato que se muestra aquí es solo una representación. Los formatos para construir datos en cada SDK del lado del servidor en este formato JSON varían. * Puedes agregar o actualizar datos para tu tabla NoSQL desde la consola de Catalyst en el formato JSON estándar o en el formato JSON personalizado de Catalyst para pruebas. * Solo puedes agregar o actualizar datos en tu tabla NoSQL a través del SDK específico del servidor de Java, Node.js o Python, o a través de API, en el formato JSON personalizado de Catalyst. Los recursos de ayuda del SDK contienen los formatos y ejemplos para construir elementos de datos e insertarlos en ese entorno de programación. * Si usas el formato JSON estándar al agregar o actualizar datos desde la consola, los tipos de datos asociados con los atributos de clave primaria al crear la tabla o el índice se procesarán automáticamente. Para todos los demás atributos, sus tipos de datos se reconocen automáticamente por Catalyst según los valores que proporciones. -------------------------------------------------------------------------------- title: "Agregar y Administrar Datos" description: "Catalyst NoSQL es una base de datos potente y completamente administrada que te proporciona un medio de almacenamiento de datos no relacional y sin SQL. Crea, administra y consulta datos en tablas NoSQL con facilidad, y realiza operaciones CRUD en Java, Node.js y Python." last_updated: "2026-07-02T09:34:15.863Z" source: "https://docs.catalyst.zoho.com/es/cloud-scale/help/nosql/working-with-data/add-manage-data/" service: "Cloud Scale" -------------------------------------------------------------------------------- # Agregar y Administrar Datos en una Tabla NoSQL ### Descripción General Esta sección cubre la realización de operaciones CRUD en Catalyst NoSQL, así como la administración de datos desde la consola de Catalyst. Consulta la documentación del SDK de Java, Node.js y Python y la documentación de la API para realizar operaciones de datos a través de código o API. Aquí tienes algunos puntos a recordar cuando agregas o actualizas datos en una tabla de Catalyst NoSQL: * Los valores para la clave de partición configurada de una tabla deben estar presentes en cada elemento de datos, si está configurada con una clave primaria simple. En caso de una clave primaria compuesta, tanto los valores de la clave de partición como de la clave de ordenación deben estar presentes en cada elemento de datos. * Los tipos de datos configurados para la clave de partición y la clave de ordenación de una tabla deben coincidir con los tipos de datos que proporcionas para los valores de esos atributos. * No podrás cambiar los tipos de datos de la clave de partición y la clave de ordenación en una tabla ni los atributos asociados con ellas, cuando agregues o actualices datos en la tabla. * El tamaño total máximo de un elemento aprovisionado en Catalyst NoSQL es de 400 KB. <br> ### Agregar Datos en una Tabla Para agregar datos en una tabla NoSQL desde la consola de Catalyst para pruebas: 1. Dirígete a la sección Data de la tabla desde el componente NoSQL, luego haz clic en Add Data. <br> 2. Esto abrirá una ventana emergente donde puedes agregar datos a la tabla. Catalyst mostrará una plantilla para los datos, que incluirá la clave de partición y la clave de ordenación configuradas para la tabla, tanto en los formatos JSON personalizado y estándar. Nota: Solo puedes agregar un elemento en la tabla desde la consola. Esto se debe a que las operaciones de datos proporcionadas en la consola son únicamente para fines de prueba. <br> Puedes alternar entre la vista JSON estándar y personalizada usando el botón de alternancia. Sin embargo, hay ciertas condiciones que los datos en el formato estándar deben satisfacer para que puedas cambiar al formato personalizado. Esto se explica a continuación. <br> 3. Agrega los datos para la tabla en cualquiera de los formatos, luego haz clic en Create. Formato JSON Personalizado: Formato JSON Estándar: <br> #### Condiciones en las que el Botón de Alternancia de Vista JSON se Deshabilita En ciertos casos, no podrás alternar entre el formato JSON estándar y personalizado al agregar o actualizar datos en la consola. Estos incluyen: 1. Cuando el tipo de dato de un atributo es inválido o no está admitido en Catalyst 2. Cuando el valor proporcionado para una clave en el JSON es inválido 3. Cuando el código JSON agregado es inválido, o contiene errores de sintaxis o lógicos 4. Cuando los datos son válidos pero incluyen ciertos tipos de datos admitidos que no se pueden renderizar en la vista JSON estándar. Por ejemplo, SS (Set of Strings) o SN (Set of Numbers) no se pueden renderizar, pero los datos que proporciones se agregarán a la tabla. Después de agregar los datos en una tabla NoSQL, se mostrarán en la sección Data de forma tabular para una visualización fácil. Nota: Ten en cuenta que los datos de la tabla no se mostrarán de forma persistente en la sección Data. Solo podrás ver los datos de la tabla consultando en esta sección. Puedes filtrar las columnas a mostrar al consultar o justo después de agregar datos a través de la consola, usando el ícono de filtro en la esquina inferior derecha. Selecciona las columnas requeridas y haz clic en Apply. Esto mostrará las columnas seleccionadas. <br> #### Ver Datos de la Tabla como JSON 1. Puedes ver los datos de la tabla en formato JSON haciendo clic en el ícono de puntos suspensivos junto a la tabla. <br> 2. Luego, haz clic en View JSON de las opciones. Esto muestra los datos de la tabla en el formato JSON personalizado de Catalyst. <br> ### Actualizar Datos en una Tabla Puedes actualizar los datos de tu tabla NoSQL fácilmente desde la consola para pruebas. Todas las especificaciones y restricciones descritas para la adición de datos aplican también a la operación de actualización de datos. Nota: Si actualizas los datos en una tabla desde la consola, esencialmente sobrescribirá los datos existentes, ya que esto es para fines de prueba. Sin embargo, si actualizas datos desde código a través de los SDKs, o a través de la API, se aplica el proceso de actualización estándar de una operación CRUD. Para actualizar los datos de una tabla NoSQL en tu proyecto: 1. Haz clic en el ícono de puntos suspensivos junto a la tabla, luego haz clic en Edit. <br> 2. Actualiza los datos en el formato JSON estándar o personalizado, luego haz clic en Update. <br> ### Eliminar Datos en una Tabla Para eliminar permanentemente los datos que agregaste en una tabla NoSQL para fines de prueba: 1. Haz clic en el ícono de puntos suspensivos junto a la tabla, luego haz clic en Delete. 2. Haz clic en Delete en la ventana emergente de confirmación. --- ## API Reference — NoSQL -------------------------------------------------------------------------------- title: "Insertar nuevo elemento" description: "Esta API te permite insertar un nuevo elemento en una tabla NoSQL." last_updated: "2026-07-02T09:34:15.866Z" source: "https://docs.catalyst.zoho.com/es/api/code-reference/cloud-scale/nosql/insert-item/" service: "Cloud Scale" -------------------------------------------------------------------------------- # NoSQL Catalyst NoSQL es una función de almacenamiento de datos no relacional, NoSQL completamente administrada que te permite almacenar los datos semi-estructurados, no estructurados y dispares de tus aplicaciones. Catalyst admite almacenamiento de datos de tipo documento en formato JSON basado en pares clave-valor. Las APIs de Catalyst NoSQL te permiten realizar operaciones CRUD en tus tablas NoSQL. Puedes insertar, actualizar, eliminar u obtener elementos, así como ejecutar consultas en una tabla o en el índice de una tabla. # Insertar elemento ### Descripción Esta API te permite insertar un nuevo elemento en una tabla NoSQL en tu proyecto. La tabla se referencia por su ID único o nombre. Puedes insertar un elemento con o sin especificar condiciones pasando los datos en el formato JSON personalizado. Nota: La tabla ya debe estar creada. Puedes crear una tabla NoSQL desde la consola. ### Detalles de la solicitud #### URL de solicitud <p>{api-domain}/baas/v1/project/{{project_id}}/nosqltable/{{table_identifier}}/item</p> El dominio específico del DC para acceder a Catalyst API El ID único del proyecto El ID único de la tabla o nombre de la tabla #### Encabezados de solicitud **Authorization:** Zoho-oauthtoken {oauth_token} <br> Content-Type: application/json <br> **Encabezados opcionales** <br> **CATALYST-ORG:** {org_id} **Environment:** Development #### Scope ZohoCatalyst.nosql.item.INSERT Nota: Esta operación también puede ejecutarse con permisos de autenticación de usuario de Catalyst usando los SDKs de Catalyst. Consulta la [sección de Prerrequisitos de la API de Catalyst](/es/api/introduction/overview-and-prerequisites/#prerequisites) para más detalles. ### Propiedades JSON de la solicitud Contiene los datos principales a insertar en la tabla. El elemento debe insertarse en el formato JSON personalizado. Especifica la partition key, si la tabla fue configurada con una clave primaria simple. Especifica tanto la partition key como la sort key, si la tabla fue configurada con una clave primaria compuesta. Los datos existentes de la tabla se obtienen y evalúan contra esta condición. Los elementos se insertan solo si la evaluación es verdadera. Si no hay datos existentes, las condiciones se ignoran y los elementos se insertan. Hay tres formas de inicializar una condición: Las dos funciones integradas son: attribute_exist, que puede usarse para verificar la presencia de un atributo, y attribute_type, que puede usarse para verificar si el nombre de atributo dado pertenece al tipo dado. Para realizar operaciones de comparación directa. Operadores soportados: contains, not_contains, begins_with, ends_with, in, not_in, between, not_between, equals, not_equals, greater_than, less_than, greater_equal, less_equal. Para combinar dos o más condiciones. Operadores de grupo soportados: and, or. Para negar el resultado de las condiciones. ### Detalles de la respuesta La respuesta devolverá el estado de la operación de inserción, así como los detalles del elemento insertado como el table_name, partition_key y sort_key, si están configurados. curl -X POST \ https://api.catalyst.zoho.com/baas/v1/project/4000000006007/nosqltable/3376000003171728/item \ -H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57" \ -H "Content-Type:application/json" \ -d '{ "item": { "EmpID": { "N": "10999" }, "FirstName":{ "S": "Paul" }, "LastName":{ "S": "Smith" }, "PriorExperience":{ "BOOL": false }, "Location": { "M": { "Country": { "S": "USA" }, "City": { "S": "New York" } } } } }' { "status": "success", "data": { "table_name": "employeeDetails", "project_details": { "id": 4000000006007, "project_name": "EmpDatabase", "project_type": "Live" } } } Insert Items- Java SDK</br></br> Insert Items- Node.js SDK</br></br> Insert Items- Python SDK </br></br> -------------------------------------------------------------------------------- title: "Actualizar elemento" description: "Esta API te permite actualizar un elemento en una tabla NoSQL." last_updated: "2026-07-02T09:34:15.867Z" source: "https://docs.catalyst.zoho.com/es/api/code-reference/cloud-scale/nosql/update-item/" service: "Cloud Scale" -------------------------------------------------------------------------------- # Actualizar elemento ### Descripción Esta API te permite actualizar un elemento de los datos existentes en una tabla NoSQL en tu proyecto. La tabla se referencia por su ID único o nombre. Puedes pasar los atributos a actualizar con o sin especificar condiciones en el formato JSON personalizado. ### Detalles de la solicitud #### URL de solicitud <p>{api-domain}/baas/v1/project/{{project_id}}/nosqltable/{{table_identifier}}/item</p> El dominio específico del DC para acceder a Catalyst API El ID único del proyecto El ID único de la tabla o nombre de la tabla #### Encabezados de solicitud **Authorization:** Zoho-oauthtoken {oauth_token} <br> Content-Type: application/json <br> **Encabezados opcionales** <br> **CATALYST-ORG:** {org_id} **Environment:** Development #### Scope ZohoCatalyst.nosql.item.UPDATE Nota: Esta operación también puede ejecutarse con permisos de autenticación de usuario de Catalyst usando los SDKs de Catalyst. Consulta la [sección de Prerrequisitos de la API de Catalyst](/es/api/introduction/overview-and-prerequisites/#prerequisites) para más detalles. ### Propiedades JSON de la solicitud Indica la partition key y la sort key de la tabla. Indica el atributo a actualizar junto con su valor. La actualización puede ser de dos tipos: PUT (para agregar un nuevo atributo dentro del elemento) y DELETE (para eliminar un atributo del elemento). El attribute_path indica la ruta dentro del elemento donde se debe realizar la operación real. El valor a actualizar puede ser de dos tipos: El valor real a actualizar. Hay cuatro funciones que pueden usarse: <br> if_not_exists - Verifica la existencia del atributo y declara un valor si no está presente. append_list - Agrega datos a una lista add - Agrega un valor junto con el valor existente o agrega un elemento en un conjunto reduction - Resta un valor del valor existente o elimina un elemento en un conjunto. Los datos existentes de la tabla se obtienen y evalúan contra esta condición. Los elementos se insertan solo si la evaluación es verdadera. Si no hay datos existentes, las condiciones se ignoran y los elementos se insertan. Hay tres formas de inicializar una condición: Las dos funciones integradas son: attribute_exist, que puede usarse para verificar la presencia de un atributo, y attribute_type, que puede usarse para verificar si el nombre de atributo dado pertenece al tipo dado. Para realizar operaciones de comparación directa. Operadores soportados: contains, not_contains, begins_with, ends_with, in, not_in, between, not_between, equals, not_equals, greater_than, less_than, greater_equal, less_equal. Para combinar dos o más condiciones. Operadores de grupo soportados: and, or. Para negar el resultado de las condiciones. ### Detalles de la respuesta La respuesta devolverá el estado de la operación de inserción, así como los detalles del elemento actualizado como el table_name, partition_key y sort_key, si están configurados. curl -X PUT \ https://api.catalyst.zoho.com/baas/v1/project/4000000006007/nosqltable/3376000003171728/item \ -H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57" \ -H "Content-Type:application/json" \ -d '{ keys:{ partition_key:{ "S":"Country" }, sort_key:{ "N":"EmpID" }, } update_attributes:{ "item": { "EmpID": { "N": "10999" }, "FirstName":{ "S": "Paul" }, "LastName":{ "S": "Smith" }, "PriorExperience":{ "BOOL": false }, "Location": { "M": { "Country": { "S": "USA" }, "City": { "S": "New York" } } } } } }' { "status": "success", "data": { "table_name": "employeeDetails", "project_details": { "id": 4000000006007, "project_name": "EmpDatabase", "project_type": "Live" } } } Update Items- Java SDK</br></br> Update Items- Node.js SDK</br></br> Update Items- Python SDK </br></br> -------------------------------------------------------------------------------- title: "Obtener elemento" description: "Esta API te permite obtener un elemento existente de una tabla NoSQL." last_updated: "2026-07-02T09:34:15.867Z" source: "https://docs.catalyst.zoho.com/es/api/code-reference/cloud-scale/nosql/fetch-item/" service: "Cloud Scale" -------------------------------------------------------------------------------- # Obtener elemento ### Descripción Esta API te permite obtener un elemento de una tabla NoSQL en tu proyecto. La tabla se referencia por su ID único o nombre. Puedes especificar los atributos de los elementos a obtener, e incluso indicar si necesitan obtenerse del clúster maestro o de un clúster esclavo. ### Detalles de la solicitud #### URL de solicitud <p>{api-domain}/baas/v1/project/{{project_id}}/nosqltable/{{table_identifier}}/item/fetch</p> El dominio específico del DC para acceder a Catalyst API El ID único del proyecto El ID único de la tabla o nombre de la tabla #### Encabezados de solicitud **Authorization:** Zoho-oauthtoken {oauth_token} <br> Content-Type: application/json <br> **Encabezados opcionales** <br> **CATALYST-ORG:** {org_id} **Environment:** Development #### Scope ZohoCatalyst.nosql.item.READ Nota: Esta operación también puede ejecutarse con permisos de autenticación de usuario de Catalyst usando los SDKs de Catalyst. Consulta la [sección de Prerrequisitos de la API de Catalyst](/es/api/introduction/overview-and-prerequisites/#prerequisites) para más detalles. ### Propiedades JSON de la solicitud Indica la partition key y la sort key de la tabla. Lista de atributos a devolver. Declara si la lectura debe hacerse desde el maestro o el esclavo. Si se establece en false, se consulta desde el esclavo. Valores aceptados: true, false. ### Detalles de la respuesta La respuesta devolverá el estado de la operación de obtención, así como los elementos que se obtienen. Se obtendrán todos los atributos o los atributos especificados de los elementos. curl -X GET \ https://api.catalyst.zoho.com/baas/v1/project/4000000006007/nosqltable/3376000003171728/item/fetch \ -H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57" \ -H "Content-Type:application/json" \ -d '{ keys:{ partition_key:{ "S":"Country" }, sort_key:{ "N":"EmpID" }, } required_attributes: { "EmpID", "FirstName", "LastName", "PriorExperience" }, consistent_read: "true" }' { "status": "success", "data": { fetched_attributes:{ "item": { "EmpID": { "N": "10999" }, "FirstName":{ "S": "Paul" }, "LastName":{ "S": "Smith" }, "PriorExperience":{ "BOOL": false } } } } } Fetch Items- Java SDK</br></br> Fetch Items- Node.js SDK</br></br> Fetch Items- Python SDK </br></br> -------------------------------------------------------------------------------- title: "Eliminar elemento" description: "Esta API te permite eliminar un elemento de una tabla NoSQL." last_updated: "2026-07-02T09:34:15.868Z" source: "https://docs.catalyst.zoho.com/es/api/code-reference/cloud-scale/nosql/delete-item/" service: "Cloud Scale" -------------------------------------------------------------------------------- # Eliminar elemento ### Descripción Esta API te permite insertar un nuevo elemento en una tabla NoSQL en tu proyecto. La tabla se referencia por su ID único o nombre. Puedes insertar un elemento con o sin especificar condiciones pasando los datos en el formato JSON personalizado. Nota: La tabla ya debe estar creada. Puedes crear una tabla NoSQL desde la consola. ### Detalles de la solicitud #### URL de solicitud <p>{api-domain}/baas/v1/project/{{project_id}}/nosqltable/{{table_identifier}}/item</p> El dominio específico del DC para acceder a Catalyst API El ID único del proyecto El ID único de la tabla o nombre de la tabla #### Encabezados de solicitud **Authorization:** Zoho-oauthtoken {oauth_token} <br> Content-Type: application/json <br> **Encabezados opcionales** <br> **CATALYST-ORG:** {org_id} **Environment:** Development #### Scope ZohoCatalyst.nosql.item.INSERT Nota: Esta operación también puede ejecutarse con permisos de autenticación de usuario de Catalyst usando los SDKs de Catalyst. Consulta la [sección de Prerrequisitos de la API de Catalyst](/es/api/introduction/overview-and-prerequisites/#prerequisites) para más detalles. ### Propiedades JSON de la solicitud Contiene los datos principales a insertar en la tabla. El elemento debe insertarse en el formato JSON personalizado. Especifica la partition key, si la tabla fue configurada con una clave primaria simple. Especifica tanto la partition key como la sort key, si la tabla fue configurada con una clave primaria compuesta. Los datos existentes de la tabla se obtienen y evalúan contra esta condición. Los elementos se insertan solo si la evaluación es verdadera. Si no hay datos existentes, las condiciones se ignoran y los elementos se insertan. Hay tres formas de inicializar una condición: Las dos funciones integradas son: attribute_exist, que puede usarse para verificar la presencia de un atributo, y attribute_type, que puede usarse para verificar si el nombre de atributo dado pertenece al tipo dado. Para realizar operaciones de comparación directa. Operadores soportados: contains, not_contains, begins_with, ends_with, in, not_in, between, not_between, equals, not_equals, greater_than, less_than, greater_equal, less_equal. Para combinar dos o más condiciones. Operadores de grupo soportados: and, or. Para negar el resultado de las condiciones. ### Detalles de la respuesta La respuesta devolverá el estado de la operación de inserción, así como los detalles del elemento insertado como el table_name, partition_key y sort_key, si están configurados. curl -X DELETE \ https://api.catalyst.zoho.com/baas/v1/project/4000000006007/nosqltable/3376000003171728/item \ -H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57" \ -H "Content-Type:application/json" \ -d '{ "item": { "EmpID": { "N": "10999" }, "FirstName":{ "S": "Paul" }, "LastName":{ "S": "Smith" }, "PriorExperience":{ "BOOL": false }, "Location": { "M": { "Country": { "S": "USA" }, "City": { "S": "New York" } } } } }' { "status": "success", "data": { "table_name": "employeeDetails", "project_details": { "id": 4000000006007, "project_name": "EmpDatabase", "project_type": "Live" } } } Insert Items- Java SDK</br></br> Insert Items- Node.js SDK</br></br> Insert Items- Python SDK </br></br> -------------------------------------------------------------------------------- title: "Consultar tabla" description: "Esta API te permite consultar una tabla NoSQL y obtener datos." last_updated: "2026-07-02T09:34:15.869Z" source: "https://docs.catalyst.zoho.com/es/api/code-reference/cloud-scale/nosql/query-table/" service: "Cloud Scale" -------------------------------------------------------------------------------- # Consultar tabla ### Descripción Esta API te permite consultar una tabla NoSQL en tu proyecto y obtener datos. La tabla se referencia por su ID único. ### Detalles de la solicitud #### URL de solicitud <p>{api-domain}/baas/v1/project/{{project_id}}/nosqltable/{{table_identifier}}/item/query</p> El dominio específico del DC para acceder a Catalyst API El ID único del proyecto El ID único de la tabla o nombre de la tabla #### Encabezados de solicitud **Authorization:** Zoho-oauthtoken {oauth_token} <br> Content-Type: application/json <br> **Encabezados opcionales** <br> **CATALYST-ORG:** {org_id} **Environment:** Development #### Scope ZohoCatalyst.nosql.POST Nota: Esta operación también puede ejecutarse con permisos de autenticación de usuario de Catalyst usando los SDKs de Catalyst. Consulta la [sección de Prerrequisitos de la API de Catalyst](/es/api/introduction/overview-and-prerequisites/#prerequisites) para más detalles. ### Propiedades JSON de la solicitud Contiene la condición en un formato similar a las operaciones CRUD de elementos. Solo se pueden dar condiciones de partition key y sort key. La partition key solo puede tener el operador "equals". La condición puede ser partition key = valor, o un grupo con condición de partition key equals y la condición de sort key. Consulta la lista completa de operadores soportados. Lista de atributos a devolver. Declara si la lectura debe hacerse desde el maestro o el esclavo. Si se establece en false, se consulta desde el esclavo. Valores aceptados: true, false. Estas son condiciones que se aplican sobre los datos obtenidos. La respuesta se envía después de que se aplican estas condiciones. Se usa para indicar si la consulta debe hacerse en orden ascendente o descendente. Se usa para fines de paginación para obtener el siguiente conjunto de elementos de datos. Se usa para indicar si la consulta se hace contra la tabla con sort keys adicionales. Contiene los nombres de atributos de sort key adicionales. Indica la cantidad máxima de elementos que deben devolverse. ### Detalles de la respuesta La respuesta devolverá el estado de la operación de consulta, así como los elementos que se obtienen según las condiciones establecidas en la consulta. curl -X POST \ https://api.catalyst.zoho.com/baas/v1/project/4000000006007/nosqltable/3376000003171728/item/query \ -H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57" \ -H "Content-Type:application/json" \ -d -d '{ key_condition:{ partition_key:{ "S":"Country" }, sort_key:{ "N":"EmpID" }, } required_attributes: { "EmpID", "FirstName", "LastName", "PriorExperience" }, consistent_read: "true" }' { "status": "success", "data": { fetched_data:{ "item": { "EmpID": { "N": "10999" }, "FirstName":{ "S": "Paul" }, "LastName":{ "S": "Smith" }, "PriorExperience":{ "BOOL": false } } } } } Query Table- Java SDK</br></br> Query Table- Node.js SDK</br></br> Query Table- Python SDK </br></br> -------------------------------------------------------------------------------- title: "Consultar índice" description: "Esta API te permite consultar un índice NoSQL y obtener datos." last_updated: "2026-07-02T09:34:15.869Z" source: "https://docs.catalyst.zoho.com/es/api/code-reference/cloud-scale/nosql/query-index/" service: "Cloud Scale" -------------------------------------------------------------------------------- # Consultar índice ### Descripción Esta API te permite consultar un índice NoSQL en tu proyecto y obtener datos. El índice se referencia por su ID único. ### Detalles de la solicitud #### URL de solicitud <p>{api-domain}/baas/v1/project/{{project_id}}/nosqltable/{{table_identifier}}//index/{{index_identifier/}}/item/query</p> El dominio específico del DC para acceder a Catalyst API El ID único del proyecto El ID único de la tabla o nombre de la tabla El ID único del índice #### Encabezados de solicitud **Authorization:** Zoho-oauthtoken {oauth_token} <br> Content-Type: application/json <br> **Encabezados opcionales** <br> **CATALYST-ORG:** {org_id} **Environment:** Development #### Scope ZohoCatalyst.nosql.POST Nota: Esta operación también puede ejecutarse con permisos de autenticación de usuario de Catalyst usando los SDKs de Catalyst. Consulta la [sección de Prerrequisitos de la API de Catalyst](/es/api/introduction/overview-and-prerequisites/#prerequisites) para más detalles. ### Propiedades JSON de la solicitud Contiene la condición en un formato similar a las operaciones CRUD de elementos. Solo se pueden dar condiciones de partition key y sort key. La partition key solo puede tener el operador "equals". La condición puede ser partition key = valor, o un grupo con condición de partition key equals y la condición de sort key. Consulta la lista completa de operadores soportados. Lista de atributos a devolver. Declara si la lectura debe hacerse desde el maestro o el esclavo. Si se establece en false, se consulta desde el esclavo. Valores aceptados: true, false. Estas son condiciones que se aplican sobre los datos obtenidos. La respuesta se envía después de que se aplican estas condiciones. Se usa para indicar si la consulta debe hacerse en orden ascendente o descendente. Se usa para fines de paginación para obtener el siguiente conjunto de elementos de datos. Se usa para indicar si la consulta se hace contra la tabla con sort keys adicionales. Contiene los nombres de atributos de sort key adicionales. Indica la cantidad máxima de elementos que deben devolverse. ### Detalles de la respuesta La respuesta devolverá el estado de la operación de consulta, así como los elementos que se obtienen según las condiciones establecidas en la consulta. curl -X POST \ https://api.catalyst.zoho.com/baas/v1/project/4000000006007/nosqltable/3376000003171728/index/786387162881/item/query \ -H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57" \ -H "Content-Type:application/json" \ -d -d '{ key_condition:{ partition_key:{ "S":"Country" }, sort_key:{ "N":"EmpID" }, } required_attributes: { "EmpID", "FirstName", "LastName", "PriorExperience" }, consistent_read: "true" }' { "status": "success", "data": { fetched_data:{ "item": { "EmpID": { "N": "10999" }, "FirstName":{ "S": "Paul" }, "LastName":{ "S": "Smith" }, "PriorExperience":{ "BOOL": false } } } } } Query Index- Java SDK</br></br> Query Index- Node.js SDK</br></br> Query Index- Python SDK </br></br> --- ## SDK — Java — NoSQL -------------------------------------------------------------------------------- title: "Obtener metadatos de tabla" 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 obtener los metadatos de una tabla NoSQL." last_updated: "2026-07-02T09:34:15.877Z" source: "https://docs.catalyst.zoho.com/es/sdk/java/v1/cloud-scale/nosql/get-table-metadata/" service: "Cloud Scale" related: - NoSQL (/es/cloud-scale/help/nosql/introduction) - NoSQL API (/es/api/code-reference/cloud-scale/nosql/insert-item/#InsertNewItem) - NoSQL Node.js SDK (/es/sdk/nodejs/v2/cloud-scale/nosql/get-component-instance/) - NoSQL Python SDK (/es/sdk/python/v1/cloud-scale/nosql/get-component-instance/) -------------------------------------------------------------------------------- # NoSQL Catalyst NoSQL es una funcionalidad de almacenamiento de datos no relacional, NoSQL, completamente administrada que te permite almacenar los datos semiestructurados, no estructurados y dispares de tus aplicaciones. Catalyst soporta almacenamiento de datos de tipo documento en el formato JSON basado en pares clave-valor. El paquete del Java SDK de Catalyst NoSQL te permite realizar operaciones CRUD de datos en las tablas NoSQL de tu proyecto. Puedes obtener los metadatos de tus tablas NoSQL, crear items NoSQL de varios tipos de datos soportados, e insertar, actualizar, obtener o eliminar items en una tabla específica. También puedes consultar tablas o índices de tablas especificando condiciones de consulta. ## Obtener metadatos de tabla Catalyst te permite obtener los metadatos de una tabla NoSQL obteniendo una instancia del Java SDK usando el método getInstance(). Puedes obtener los metadatos de una sola tabla o de todas las tablas de tu proyecto. ### Obtener metadatos de una sola tabla Los metadatos de una sola tabla en Catalyst NoSQL se pueden obtener de dos formas como se menciona en esta página. La respuesta contendrá detalles de la configuración de la tabla, como la clave de partición y la clave de ordenamiento, el atributo TTL, y más. #### Obtener metadatos de tabla con el ID de tabla Puedes obtener los metadatos de una tabla NoSQL en tu proyecto haciendo referencia a su ID de tabla único usando el método getTable() como se muestra a continuación. //public ZCNoSQLTable getTable(String tableName) throws Exception; //public ZCNoSQLTable getTable(Long tableId) throws Exception; // Obtener metadatos de tabla usando el Table ID ZCNoSQL.getInstance().getTable(2144568989001); <br> #### Obtener metadatos de tabla con el nombre de tabla Puedes obtener los metadatos de una tabla NoSQL en tu proyecto haciendo referencia al nombre de la tabla usando el método getTable() como se muestra a continuación. //public ZCNoSQLTable getTable(String tableName) throws Exception; //public ZCNoSQLTable getTable(Long tableId) throws Exception; // Obtener metadatos de tabla usando el nombre de Tabla ZCNoSQL.getInstance().getTable('Employees'); Nota: Si renombras la tabla, necesitarás actualizar los cambios en tu código. <br> ### Obtener metadatos de todas las tablas Catalyst te permite obtener los metadatos de todas las tablas de tu proyecto usando el método getAllTables() como se muestra a continuación. //public List&lt;ZCNoSQLTable&gt; getAllTables() throws Exception; ZCNoSQL.getInstance().getAllTables(); -------------------------------------------------------------------------------- title: "Crear instancia de tabla" 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 crear una instancia de una tabla NoSQL." last_updated: "2026-07-02T09:34:15.877Z" source: "https://docs.catalyst.zoho.com/es/sdk/java/v1/cloud-scale/nosql/create-table-instance/" service: "Cloud Scale" related: - NoSQL (/es/cloud-scale/help/nosql/introduction) - Create and Manage Tables (/es/cloud-scale/help/nosql/create-manage-tables/) -------------------------------------------------------------------------------- # Crear instancia de tabla Catalyst NoSQL te permite obtener una instancia de tabla vacía de una tabla NoSQL. Luego puedes usar esta instancia para hacer referencia a esa tabla y realizar todas las operaciones de tabla soportadas. Este proceso no realizará una llamada del lado del servidor. Puedes obtener una instancia de tu tabla NoSQL de dos formas como se describe en esta sección. ### Obtener instancia con el ID de tabla Obtén una instancia de tabla pasando el ID único de la tabla a getTableInstance() como se muestra a continuación. //public ZCNoSQLTable getTableInstance(Long tableId); //public ZCNoSQLTable getTableInstance(String tableName); // Crear una instancia de tabla con el Table ID ZCNoSQL.getInstance().getTableInstance(37898901211); <br> ### Obtener instancia con el nombre de tabla Obtén una instancia de tabla pasando el nombre de la tabla a getTableInstance() como se muestra a continuación. //public ZCNoSQLTable getTableInstance(Long tableId); //public ZCNoSQLTable getTableInstance(String tableName); // Crear una instancia de tabla con el Table ID ZCNoSQL.getInstance().getTableInstance('Employees'); -------------------------------------------------------------------------------- title: "Construir item NoSQL" 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 construir un item NoSQL." last_updated: "2026-07-02T09:34:15.877Z" source: "https://docs.catalyst.zoho.com/es/sdk/java/v1/cloud-scale/nosql/construct-item/" service: "Cloud Scale" related: - NoSQL (/es/cloud-scale/help/nosql/introduction) - Working with Data (/es/cloud-scale/help/nosql/working-with-data/introduction/) - NoSQL API (/es/api/code-reference/cloud-scale/nosql/insert-item/#InsertNewItem) -------------------------------------------------------------------------------- # Construir item NoSQL Los items de Catalyst NoSQL representan una colección de atributos que contienen los datos de un único punto de datos, como registros. Puedes insertar o actualizar items en una tabla NoSQL existente de tu proyecto en un formato JSON personalizado. Sin embargo, antes de insertar o actualizar un item en Catalyst, necesitarás construir el item. Puedes construir un item NoSQL con atributos que contengan diferentes tipos de datos soportados por Catalyst como se describe en la sección a continuación. Catalyst soporta varios tipos de datos como String, Number, Set of Strings, Set of Numbers, List y Map. Consulta la lista completa de tipos de datos soportados en el recurso compartido para obtener más información. Debes proporcionar obligatoriamente los valores del atributo de clave de partición que configuraste para una tabla en cada item de datos. Consulta la sección de ayuda de claves de tabla para conocer las claves de tabla, el atributo TTL y otros detalles. <br> ### Crear un nuevo item NoSQL Puedes crear un nuevo item NoSQL usando el método ZCNoSQLItem(), como se muestra a continuación. ZCNoSQLItem item = new ZCNoSQLItem(); #### Crear un nuevo item NoSQL con JSON / Map Puedes crear un nuevo item NoSQL a partir de datos JSON planos o de un Map después de definirlos como se muestra a continuación. //public static ZCNoSQLItem fromJSON(String json) throws Exception; ZCNoSQLItem.fromJSON(&lt;json string&gt;); <br> ### Construir items NoSQL de diferentes tipos de datos El fragmento de código a continuación muestra los formatos para construir un item con atributos de diferentes tipos de datos: //public ZCNoSQLItem withString(String attrName, String val) throws Exception; item.withString("attribute name", "&lt;string value&gt;"); //public ZCNoSQLItem withNumber(String attrName, BigDecimal val) throws Exception; //public ZCNoSQLItem withNumber(String attrName, Number val) throws Exception; item.withNumber("attribute name", "&lt;numeric value&gt;"); //public ZCNoSQLItem withInt(String attrName, int val) throws Exception; item.withInt("attribute name", "&lt;integer value&gt;"); //public ZCNoSQLItem withBigInteger(String attrName, BigInteger val) throws Exception; item.withBigInteger("attribute name", "&lt;BigInt value&gt;"); //public ZCNoSQLItem withShort(String attrName, short val) throws Exception; item.withShort("attribute name", "&lt;Short value&gt;"); //public ZCNoSQLItem withFloat(String attrName, float val) throws Exception; item.withFloat("attribute name", "&lt;Float value&gt;"); //public ZCNoSQLItem withDouble(String attrName, double val) throws Exception; item.withDouble("attribute name", "&lt;Double value&gt;"); //public ZCNoSQLItem withLong(String attrName, long val) throws Exception; item.withLong("attribute name", "&lt;Long value&gt;"); //public ZCNoSQLItem withBinary(String attrName, byte[] val) throws Exception; //public ZCNoSQLItem withBinary(String attrName, ByteBuffer val) throws Exception; item.withBinary("attribute name", "&lt;Byte value&gt;"); //public ZCNoSQLItem withStringSet(String attrName, Set&lt;String&gt; val) throws Exception; //public ZCNoSQLItem withStringSet(String attrName, String... val) throws Exception; item.withStringSet("attribute name", "&lt;StringSet/String variadic param value&gt;"); //public ZCNoSQLItem withBigDecimalSet(String attrName, Set&lt;BigDecimal&gt; val) throws Exception; //public ZCNoSQLItem withBigDecimalSet(String attrName, BigDecimal... vals) throws Exception; item.withBigDecimalSet("attribute name", "&lt;DecimalSet/Decimal Variadic param value&gt;"); //public &lt;T extends Number&gt; ZCNoSQLItem withNumberSet(String attrName, T... vals) throws Exception; //public &lt;T extends Number&gt; ZCNoSQLItem withNumberSet(String attrName, Set&lt;T&gt; vals) throws Exception; item.withNumberSet("attribute name", "&lt;Numeric/Numeric Variadic param value&gt;"); //public ZCNoSQLItem withBinarySet(String attrName, Set&lt;byte[]&gt; val) throws Exception; //public ZCNoSQLItem withBinarySet(String attrName, byte[]... vals) throws Exception; //public ZCNoSQLItem withBinarySet(String attrName, ByteBuffer... vals) throws Exception; item.withBinarySet("attribute name", "&lt;Byte Set value&gt;"); //public ZCNoSQLItem withByteBufferSet(String attrName, Set&lt;ByteBuffer&gt; val) throws Exception; item.withByteBufferSet("attribute name", "&lt;Byte Set value&gt;"); //public ZCNoSQLItem withList(String attrName, List&lt;?&gt; val) throws Exception; //public ZCNoSQLItem withList(String attrName, Object... vals) throws Exception; item.withList("attribute name", "&lt;List/Variadic Param value&gt;"); //public ZCNoSQLItem withMap(String attrName, Map&lt;String, ?&gt; val) throws Exception; item.withMap("attribute name", "&lt;Map value&gt;"); //public ZCNoSQLItem withJSON(String attrName, String json) throws Exception; item.withJSON("attribute name", "&lt;JSON String value&gt;"); //public ZCNoSQLItem withBoolean(String attrName, boolean val) throws Exception; item.withBoolean("attribute name", "&lt;Boolean value&gt;"); //public ZCNoSQLItem withNull(String attrName) throws Exception; item.withNull("attribute name"); //public ZCNoSQLItem with(String attrName, Object val) throws Exception; item.with("attribute name", "&lt;Value&gt;"); -------------------------------------------------------------------------------- title: "Operaciones con items NoSQL" 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 los métodos del SDK para realizar varias operaciones con items NoSQL." last_updated: "2026-07-02T09:34:15.877Z" source: "https://docs.catalyst.zoho.com/es/sdk/java/v1/cloud-scale/nosql/item-operations/" service: "Cloud Scale" related: - NoSQL (/es/cloud-scale/help/nosql/introduction) - Working with Data (/es/cloud-scale/help/nosql/working-with-data/introduction/) - NoSQL API (/es/api/code-reference/cloud-scale/nosql/insert-item/#InsertNewItem) -------------------------------------------------------------------------------- # Operaciones con items NoSQL Los items de Catalyst NoSQL representan una colección de atributos que contienen los datos de un único punto de datos, como registros. A continuación se presentan los métodos que puedes usar con un item y realizar varias operaciones sobre él. #### Eliminar atributos de un item construido //public ZCNoSQLItem removeAttribute(String attrName) throws Exception; item.removeAttribute("attribute name"); #### Obtener todas las claves del item que se está construyendo //public Iterable&lt;Map.Entry&gt;String, Object&gt;&gt; attributes(); item.attributes(); #### Verificar si el item construido contiene un atributo específico //public boolean hasAttribute(String attrName); item.hasAttribute("attribute name"); #### Obtener el item como un map //public Map<String, Object> asMap(); item.asMap(); //public Map&lt;String, Object&gt; getAllAttributesAsMap(); item.getAllAttributesAsMap(); #### Obtener el item como JSON //public String toJSON() throws Exception; item.toJSON(); #### Obtener la cantidad de atributos en el item construido //public int numberOfAttributes(); item.numberOfAttributes(); <br> ### ZCNoSQLAttribute Puedes usar la clase ZCNoSQLAttribute para indicar los atributos sobre los cuales realizas las operaciones. Para acceder a los elementos anidados de un Map, puedes separar los atributos usando ',' al usar ZCNoSQLAttribute. Para acceder a un índice específico de una lista, puedes denotarlo como "[&lt;index&gt;]". Esto se demuestra en el ejemplo a continuación. //public static ZCNoSQLAttribute getInstance(String ...pathElements) throws Exception; //public ZCNoSQLAttribute(List&lt;String&gt; pathElements) throws Exception; ZCNoSQLAttribute.getInstance("", ...); new ZCNoSQLAttribute("", ...) Los tipos de datos soportados por NoSQL se pueden denotar con ZCNoSQLAttribute de la siguiente manera: <table class="content-table nosql-components-table"> <thead> <tr> <th class="w10p">Tipo de dato soportado</th> <th class="w10p">Notación con ZCNoSQLAttribute</th> </tr> </thead> <tbody> <tr> <td>String</td> <td>ZCNoSQLValue.DataType.S </td> </tr> <tr> <td>Numeric</td> <td>ZCNoSQLValue.DataType.N</td> </tr> <tr> <td>Binary</td> <td>ZCNoSQLValue.DataType.B </td> </tr> <tr> <td>Boolean</td> <td>ZCNoSQLValue.DataType.BOOL</td> </tr> <tr> <td>Set of String</td> <td>ZCNoSQLValue.DataType.SS</td> </tr> <tr> <td>Set of Numbers</td> <td>ZCNoSQLValue.DataType.SN</td> </tr> <tr> <td>Set of Binary</td> <td>ZCNoSQLValue.DataType.SB</td> </tr> <tr> <td>List</td> <td>ZCNoSQLValue.DataType.L</td> </tr> <tr> <td>Map</td> <td>ZCNoSQLValue.DataType.M</td> </tr> <tr> <td>Null</td> <td>ZCNoSQLValue.DataType.NuLL</td> </tr> </tbody> </table> <br> ### ZCNoSQLValue Los objetos de esta clase se usan para indicar el valor de los atributos junto con su tipo de dato, como se muestra a continuación. // public ZCNoSQLValue(DataType dataType, Object value) throws Exception; //public static ZCNoSQLValue getInstance(DataType dataType, Object value) throws Exception; new ZCNoSQLValue(&lt;ZCNoSQLValue.DataType&gt;, &lt;Value&gt;) ZCNoSQLValue.getInstance(&lt;ZCNoSQLValue.DataType&gt;, &lt;Value&gt;) <br> ### ZCNoSQLResponseBean Esta clase contiene la respuesta de las llamadas del SDK realizadas al servidor. Incluye los siguientes métodos. * getSize - Se usa para retornar el tamaño de los datos leídos/escritos desde o hacia el servidor. //public int getSize(); responseBean.getSize(); * getStartKey - Se usa para retornar la clave de inicio del siguiente conjunto de datos para paginación, si existen más datos. //public ZCNoSQLItem getStartKey(); responseBean.getStartKey(); * getResponseDataList - Retorna los datos reales. Según el NOSQL_RETURN_VALUE, se retornan los datos antiguos o nuevos en el método getNew_item() o getOld_Item(). //public List&lt;Data&gt; getResponseDataList(); responseBean.getResponseDataList().get(&lt;index&gt;).getNew_item(); responseBean.getResponseDataList().get(&lt;index&gt;).getOld_item(); responseBean.getResponseDataList().get(&lt;index&gt;).setStatus(); -------------------------------------------------------------------------------- title: "Insertar items en tabla" 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-07-02T09:34:15.886Z" source: "https://docs.catalyst.zoho.com/es/sdk/java/v1/cloud-scale/nosql/insert-items/" service: "Cloud Scale" related: - NoSQL (/es/cloud-scale/help/nosql/introduction) - Working with Data (/es/cloud-scale/help/nosql/working-with-data/introduction/) - NoSQL API (/es/api/code-reference/cloud-scale/nosql/insert-item/#InsertNewItem) -------------------------------------------------------------------------------- # 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. //public ZCNoSQLResponseBean insert(ZCNoSQLItem item) throws Exception; table.insert(&lt;ZCNoSQLItem&gt;); Puedes insertar datos con la instancia de ZCNoSQLInsertHelper como se muestra a continuación. //public ZCNoSQLInsertHelper getInsertHelper(ZCNoSQLItem item) throws Exception; //public ZCNoSQLResponseBean insert() throws Exception; table.getInsertHelper(&lt;ZCNoSQLItem&gt;).insert(); Esta clase se puede usar para insertar datos en una tabla con condiciones. Se puede obtener desde la instancia de ZCNoSQLTable. <br> ### 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. //public ZCNoSQLInsertHelper withCondition(ZCNoSQLCondition condition) throws Exception; table.getInsertHelper(&lt;ZCNoSQLItem&gt;).withCondition(&lt;ZCNoSQLCondition&gt;).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 //public static ZCNoSQLCondition getInstance(NoSQLConditionFunction function) throws Exception; //public ZCNoSQLCondition(NoSQLConditionFunction function) throws Exception; ZCNoSQLCondition.getInstance(&lt;NoSQLCondtitionFunction&gt;); new ZCNoSQLCondition(&lt;NoSQLCondtitionFunction&gt;) Hay dos funciones integradas disponibles. i. ZCNoSQLAttributeTypeFunction Verifica si el tipo de dato del atributo dado coincide con el tipo de dato proporcionado. //public ZCNoSQLAttributeTypeFunction(ZCNoSQLAttribute attribute, ZCNoSQLValue.DataType dataType) throws Exception; //public static ZCNoSQLAttributeTypeFunction getInstance(ZCNoSQLAttribute attribute, ZCNoSQLValue.DataType dataType) throws Exception; ZCNoSQLAttributeTypeFunction.getInstance(&lt;ZCNoSQLAttribute&gt;, &lt;ZCNoSQLValue.DataType&gt;); new ZCNoSQLAttributeTypeFunction(&lt;ZCNoSQLAttribute&gt;, &lt;ZCNoSQLValue.DataType&gt;); ii. ZCNoSQLAttributeExistFunction Se usa para evaluar si un atributo ya existe en el item recuperado. //public ZCNoSQLAttributeExistFunction(ZCNoSQLAttribute attribute); //public static ZCNoSQLAttributeExistFunction getInstance(ZCNoSQLAttribute attribute); ZCNoSQLAttributeExistFunction.getInstance(&lt;ZCNoSQLAttribute&gt;); new ZCNoSQLAttributeExistFunction(&lt;ZCNoSQLAttribute&gt;) <br> #### 2. Usando operador, operando y valor //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(&lt;ZCNoSQLAttribute&gt;, &lt;NOSQL_OPERATOR&gt;, &lt;ZCNoSQLValue&gt;); new ZCNoSQLCondition(&lt;ZCNoSQLAttribute&gt;, &lt;NOSQL_OPERATOR&gt;, &lt;ZCNoSQLValue&gt;); #### 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 //public static ZCNoSQLCondition getInstance(List&lt;ZCNoSQLCondition&gt; groups, NOSQL_CONDITION_GROUP_OPERATOR groupOperator) throws Exception; //public ZCNoSQLCondition(List&lt;ZCNoSQLCondition&gt; groups, NOSQL_CONDITION_GROUP_OPERATOR groupOperator) throws Exception; ZCNoSQLCondition.getInstance(List&lt;ZCNoSQLCondition&gt;,&lt;NOSQL_CONDITION_GROUP_OPERATOR&gt;) new ZCNoSQLCondition(List&lt;ZCNoSQLCondition&gt;,&lt;NOSQL_CONDITION_GROUP_OPERATOR&gt;) #### 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. //public ZCNoSQLInsertHelper withReturnValue(NOSQL_RETURN_VALUE returnValue) throws Exception table.getInsertHelper(&lt;ZCNoSQLItem&gt;).withReturnValue(&lt;NOSQL_RETURN_VALUE&gt;).insert(); Los valores permitidos de NOSQL_RETURN_VALUE son NEW, OLD, NULL #### Insertar con condición y valor de retorno table.getInsertHelper(&lt;ZCNoSQLItem&gt;).withCondition(&lt;ZCNoSQLCondition&gt;).withReturnValue(&lt;NOSQL_RETURN_VALUE&gt;).insert(); -------------------------------------------------------------------------------- title: "Actualizar 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-07-02T09:34:15.886Z" source: "https://docs.catalyst.zoho.com/es/sdk/java/v1/cloud-scale/nosql/update-items/" service: "Cloud Scale" related: - NoSQL (/es/cloud-scale/help/nosql/introduction/) - NoSQL API (/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 específica después de construirlos. Un item se puede actualizar identificándolo usando sus claves primarias. 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. //public ZCNoSQLResponseBean update(ZCNoSQLItem item, ZCNoSQLUpdateAttributeOperation updateAttributeOperation) throws Exception; table.update(&lt;ZCNoSQLItem&gt;, &lt;ZCNoSQLUpdateAttributeOperation&gt;); Para actualizar con ZCNoSQLUpdateHelper #### ZCNoSQLUpdateHelper //public ZCNoSQLInsertHelper getInsertHelper(ZCNoSQLItem item) throws Exception; //public ZCNoSQLResponseBean insert() throws Exception; table.getUpdateHelper(&lt;ZCNoSQLItem&gt;, &lt;ZCNoSQLUpdateAttributeOperation&gt;).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 //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(&lt;ZCNoSQLAttribute&gt;, &lt;ZCNoSQLValue&gt;); new ZCNoSQLUpdateAttributeOperation(&lt;ZCNoSQLAttribute&gt;, &lt;NoSQLUpdateAttributeFunction&gt;); ZCNoSQLUpdateAttributeOperation.getPutAttributeInstance(&lt;ZCNoSQLAttribute&gt;, &lt;ZCNoSQLValue&gt;); ZCNoSQLUpdateAttributeOperation.getPutAttributeInstance(&lt;ZCNoSQLAttribute&gt;, &lt;NoSQLUpdateAttributeFunction&gt;) Para eliminar atributos //ZCNoSQLUpdateAttributeOperation(ZCNoSQLAttribute attribute); //public static ZCNoSQLUpdateAttributeOperation getDeleteAttributeInstance(ZCNoSQLAttribute attribute); new ZCNoSQLUpdateAttributeOperation(&lt;ZCNoSQLAttribute&gt;); ZCNoSQLUpdateAttributeOperation.getDeleteAttributeInstance(&lt;ZCNoSQLAttribute&gt;); 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. //public ZCNoSQLIfNotExistFunction(ZCNoSQLAttribute attribute, ZCNoSQLValue value) //public static ZCNoSQLIfNotExistFunction getInstance(ZCNoSQLAttribute attribute, ZCNoSQLValue value); new ZCNoSQLIfNotExistFunction(&lt;ZCNoSQLAttribute&gt;, &lt;ZCNoSQLValue&gt;) ZCNoSQLIfNotExistFunction.getInstance(&lt;ZCNoSQLAttribute&gt;, &lt;ZCNoSQLValue&gt;) #### ZCNoSQLAppendListFunction Esta función se usa para agregar elementos a un atributo de lista existente o nuevo. //public ZCNoSQLAppendListFunction(ZCNoSQLValue...values); //public static ZCNoSQLAppendListFunction getInstance(ZCNoSQLValue...values); new ZCNoSQLAppendListFunction(&lt;List of ZCNoSQLValue&gt;) ZCNoSQLAppendListFunction.getInstance(&lt;List of ZCNoSQLValue&gt;) #### 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. //public ZCNoSQLAdditionFunction(ZCNoSQLAttribute attribute, ZCNoSQLValue value); //public static ZCNoSQLAdditionFunction getInstance(ZCNoSQLAttribute attribute, ZCNoSQLValue value); new ZCNoSQLAdditionFunction(&lt;ZCNoSQLAttribute&gt;, &lt;ZCNoSQLValue&gt;) ZCNoSQLAdditionFunction.getInstance(&lt;ZCNoSQLAttribute&gt;, &lt;ZCNoSQLValue&gt;) #### 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. //public ZCNoSQLReductionFunction(ZCNoSQLAttribute attribute, ZCNoSQLValue value) throws Exception; //public static ZCNoSQLReductionFunction getInstance(ZCNoSQLAttribute attribute, ZCNoSQLValue value) throws Exception; new ZCNoSQLReductionFunction(&lt;ZCNoSQLAttribute&gt;, &lt;ZCNoSQLValue&gt;) ZCNoSQLReductionFunction.getInstance(&lt;ZCNoSQLAttribute&gt;, &lt;ZCNoSQLValue&gt;) 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 table.getUpdateHelper(&lt;ZCNoSQLItem&gt;,&lt;ZCNoSQLUpdateAttributeOperation&gt;).withCondition(&lt;ZCNoSQLCondition&gt;).withReturnValue(&lt;NOSQL_RETURN_VALUE&gt;).update(); -------------------------------------------------------------------------------- title: "Obtener items de tabla NoSQL" 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 obtener items de una tabla NoSQL." last_updated: "2026-07-02T09:34:15.886Z" source: "https://docs.catalyst.zoho.com/es/sdk/java/v1/cloud-scale/nosql/fetch-items/" service: "Cloud Scale" related: - NoSQL (/es/cloud-scale/help/nosql/introduction/) - NoSQL API (/es/api/code-reference/cloud-scale/nosql/insert-item/#InsertNewItem) -------------------------------------------------------------------------------- # Obtener items de tabla NoSQL Catalyst te permite obtener items de una tabla NoSQL identificándolos con sus claves primarias. 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 obtener el item. También puedes filtrar opcionalmente los atributos que se van a obtener especificando los atributos requeridos. Nota: Catalyst te permite obtener un máximo de 100 items de una tabla NoSQL en una sola operación de lectura del SDK. Los datos se pueden obtener sin filtrar atributos específicos usando la instancia de ZCNoSQLTable o se pueden obtener con la ayuda de la instancia de ZCNoSQLFetchHelper que se puede usar para construir las diversas partes de la solicitud. Para obtener datos con la instancia de ZCNoSQLTable, se puede usar lo siguiente. //public ZCNoSQLResponseBean fetch(ZCNoSQLItem key) throws Exception; table.fetch(&lt;ZCNoSQLItem&gt;); Para obtener con ZCNoSQLFetchHelper #### ZCNoSQLFetchHelper Esta clase se puede usar para obtener datos de la tabla y filtrar atributos específicos. Se puede obtener desde la instancia de ZCNoSQLTable. //public ZCNoSQLFetchHelper getFetchHelper(ZCNoSQLItem key) throws Exception; //public ZCNoSQLResponseBean fetch() throws Exception; table.getFetchHelper(&lt;ZCNoSQLItem&gt;).fetch(); Otros métodos disponibles en ZCNoSQLFetchHelper #### Atributos requeridos Este método se puede usar para filtrar y recuperar solo los atributos requeridos específicos /public ZCNoSQLFetchHelper withRequiredAttributes(List&lt;ZCNoSQLAttribute&gt; requiredAttributesList) throws Exception; table.getFetchHelper(&lt;ZCNoSQLItem&gt;).withRequiredAttributes(&lt;List of ZCNoSQLAttributes&gt;).fetch(); También puedes usar la consistencia para indicar si la operación de lectura debe realizarse usando el clúster maestro o un esclavo. Cuando se establece en true, se consulta desde el maestro. Si es false, se consulta desde el esclavo. Nota: En la replicación maestro-esclavo, el maestro contiene todos los datos de la base de datos y el esclavo contiene copias del maestro. Realizar una operación de lectura desde el esclavo puede reducir el costo general con la contrapartida de un ligero retraso en que los datos actualizados se reflejen. //public ZCNoSQLFetchHelper withConsistency(boolean consistency) throws Exception; table.getFetchHelper(&lt;ZCNoSQLItem&gt;).withConsistency(true/false).fetch(); Obtener con atributos requeridos y consistencia table.getFetchHelper(&lt;ZCNoSQLItem&gt;).withRequiredAttributes(&lt;List of ZCNoSQLAttributes&gt;).withConsistency(true/false).fetch(); -------------------------------------------------------------------------------- title: "Consultar tabla NoSQL" 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 consultar una tabla NoSQL." last_updated: "2026-07-02T09:34:15.886Z" source: "https://docs.catalyst.zoho.com/es/sdk/java/v1/cloud-scale/nosql/query-table/" service: "Cloud Scale" related: - NoSQL (/es/cloud-scale/help/nosql/introduction/) - NoSQL API (/es/api/code-reference/cloud-scale/nosql/insert-item/#InsertNewItem) -------------------------------------------------------------------------------- # Consultar tabla NoSQL Catalyst te permite consultar una tabla NoSQL y recuperar datos identificando los items usando las claves primarias de la tabla. 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 recuperar el item. Nota: Catalyst te permite recuperar un máximo de 100 items en bloque de una tabla NoSQL con paginación desde una sola operación del SDK. Puedes definir la condición de clave que identifica el item especificando los atributos, sus valores requeridos y el operador soportado que se va a usar. Consulta la sección de ayuda para obtener una lista de operadores soportados y ayuda sobre cómo consultar desde la consola de Catalyst. Para consultar los datos con la instancia de ZCNoSQLTable, se puede usar el siguiente fragmento. //public ZCNoSQLResponseBean queryTable(ZCNoSQLPartitionKeyCondition partitionKeyCondition, boolean forwardScan, int limit) throws Exception; table.query(&lt;ZCNoSQLPartitionKeyCondition&gt;, &lt;true/false&gt;, &lt;limit&gt;); Para consultar con ZCNoSQLQueryHelper ZCNoSQLQueryHelper Esta clase se puede usar para consultar datos de la tabla y también especificar otras condiciones, orden de clasificación, límite, etc. Se puede obtener a partir de la instancia ZCNoSQLTable. //public ZCNoSQLQueryHelper getQueryHelper(ZCNoSQLPartitionKeyCondition partitionKeyCondition, boolean forwardScan, int limit) throws Exception; //public ZCNoSQLResponseBean queryTable() throws Exception; table.getQueryHelper(&lt;ZCNoSQLPartitionKeyCondition&gt;, &lt;true/false&gt;, &lt;limit&gt;).queryTable(); ZCNoSQLPartitionKeyCondition Se usa para construir los criterios de la clave de partición. Es necesario para consultar datos de la tabla o el índice. //public ZCNoSQLPartitionKeyCondition(ZCNoSQLAttribute attribute, ZCNoSQLValue value) throws Exception; //public static ZCNoSQLPartitionKeyCondition getInstance(ZCNoSQLAttribute attribute, ZCNoSQLValue value) throws Exception; new ZCNoSQLPartitionKeyCondition(&lt;ZCNoSQLAttribute&gt;, &lt;ZCNoSQLValue&gt;) ZCNoSQLPartitionKeyCondition.getInstance(&lt;ZCNoSQLAttribute&gt;, &lt;ZCNoSQLValue&gt;) Secondary Key Condition Se usa para construir los criterios de la clave de ordenamiento. Se utilizará para indicar si se debe usar la clave de ordenamiento o una clave de ordenamiento adicional al consultar la tabla. //public static ZCNoSQLSecondaryKeyCondition getInstance(ZCNoSQLAttribute attribute, SECONDARY_KEY_CONDITION_OPERATOR operator, ZCNoSQLValue value) throws Exception new ZCNoSQLSecondaryKeyCondition(&lt;ZCNoSQLAttribute&gt;, &lt;SECONDARY_KEY_CONDITION_OPERATOR&gt;, &lt;ZCNoSQLValue&gt;) ZCNoSQLSecondaryKeyCondition.getInstance(&lt;ZCNoSQLAttribute&gt;, &lt;SECONDARY_KEY_CONDITION_OPERATOR&gt;, &lt;ZCNoSQLValue&gt;) //public ZCNoSQLQueryHelper withSecondaryKeyCondition(ZCNoSQLSecondaryKeyCondition secondaryKeyCondition, Boolean isAdditionalSortKey) throws Exception; table.getQueryHelper(&lt;ZCNoSQLPartitionKeyCondition&gt;, &lt;true/false&gt;, &lt;limit&gt;).withSecondaryKeyCondition(&lt;ZCNoSQLSecondaryKeyCondition&gt;, &lt;true/false&gt;).queryTable(); Otros métodos disponibles en ZCNoSQLQueryHelper SECONDARY_KEY_CONDITION_OPERATOR Puede tener los valores begins_with, between, equals, greater_than, less_than, greater_equal, less_equal; Otras condiciones Se pueden usar para filtrar los datos recuperados usando la clave de partición y la clave de ordenamiento si se especificó. Esto se aplicará solo sobre los datos recuperados usando las claves. Por lo tanto, puede haber escenarios donde los datos pueden estar presentes para la clave de partición, clave de ordenamiento y otras condiciones dadas, pero hasta el límite máximo de 100 items, se pueden devolver 0 items después de aplicar la otra condición junto con la clave de inicio. //public ZCNoSQLQueryHelper withOtherCondition(ZCNoSQLCondition otherCondition) throws Exception; table.getQueryHelper(<ZCNoSQLPartitionKeyCondition>, <true/false>, <limit>).withOtherCondition(<ZCNoSQLCondition>).queryTable(); Start Key Se usa para la paginación. Al consultar datos de la tabla/índice, si existen más registros, se devolverá la clave de inicio. Para obtener el siguiente conjunto de datos, este valor debe establecerse a partir de la respuesta de la solicitud anterior. //public ZCNoSQLQueryHelper withStartKey(ZCNoSQLItem startKey); table.getQueryHelper(&lt;ZCNoSQLPartitionKeyCondition&gt;, &lt;true/false&gt;, &lt;limit&gt;).withStartKey(&lt;ZCNoSQLItem&gt;).queryTable(); -------------------------------------------------------------------------------- title: "Consultar índice NoSQL" 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 consultar un índice NoSQL." last_updated: "2026-07-02T09:34:15.887Z" source: "https://docs.catalyst.zoho.com/es/sdk/java/v1/cloud-scale/nosql/query-index/" service: "Cloud Scale" related: - NoSQL (/es/cloud-scale/help/nosql/introduction/) - NoSQL API (/es/api/code-reference/cloud-scale/nosql/insert-item/#InsertNewItem) -------------------------------------------------------------------------------- # Consultar índice NoSQL Catalyst te permite consultar un índice NoSQL y recuperar datos identificando los items usando las claves primarias del índice. La indexación te permite ejecutar consultas alternativas sobre los datos de la tabla sin hacer uso de las claves primarias de la tabla principal. Puedes configurar índices desde la consola de Catalyst. Por lo tanto, puedes usar solo la clave de partición o una combinación de la clave de partición y la clave de ordenamiento del índice para recuperar un item. Nota: Catalyst te permite recuperar un máximo de 100 items en bloque de una tabla NoSQL con paginación desde una sola operación del SDK. Puedes definir la condición de clave que identifica el item especificando los atributos, sus valores requeridos y el operador soportado que se va a usar. Consulta la sección de ayuda sobre la lista de operadores soportados y ayuda sobre cómo consultar desde la consola de Catalyst. Para consultar los datos con la instancia de ZCNoSQLTable, se puede usar lo siguiente. //public ZCNoSQLResponseBean queryIndex(Long indexID, ZCNoSQLPartitionKeyCondition partitionKeyCondition, boolean forwardScan, int limit) throws Exception; table.queryIndex(&lt;indexID&gt;, &lt;ZCNoSQLPartitionKeyCondition&gt;, &lt;true/false&gt;, &lt;limit&gt;); Para consultar con ZCNoSQLQueryHelper ZCNoSQLQueryHelper Esta clase se puede usar para consultar datos del índice y también especificar otras condiciones, orden de clasificación, límite, etc. Se puede obtener a partir de la instancia ZCNoSQLTable. //public ZCNoSQLQueryHelper getQueryHelper(ZCNoSQLPartitionKeyCondition partitionKeyCondition, boolean forwardScan, int limit) throws Exception; //public ZCNoSQLResponseBean queryTable() throws Exception; table.getQueryHelper(&lt;ZCNoSQLPartitionKeyCondition&gt;, &lt;true/false&gt;, &lt;limit&gt;).queryIndex(&lt;indexID&gt;); ZCNoSQLPartitionKeyCondition La misma condición de clave de partición descrita anteriormente se puede reutilizar aquí también. Otros métodos disponibles en ZCNoSQLQueryHelper Required Attributes Los mismos Required Attributes descritos anteriormente se pueden reutilizar aquí también. Consistencia Catalyst NoSQL también te permite definir otros elementos de la consulta, como usar consistent_read para indicar si la operación de lectura debe realizarse usando el clúster maestro o un clúster esclavo, limitar el número de filas que se devolverán y especificar el orden de clasificación como ascendente. Nota: En la replicación maestro-esclavo, el maestro contiene todos los datos de la base de datos y el esclavo contiene copias del maestro. Realizar una operación de lectura desde el esclavo puede reducir el costo general con la contrapartida de un ligero retraso en la actualización de los datos reflejados. Secondary Key Condition La misma condición de clave secundaria descrita anteriormente se puede reutilizar aquí también, con la excepción de que la clave de ordenamiento adicional no se puede usar para el índice. Otras condiciones Las otras condiciones mencionadas para consultar tablas se pueden reutilizar aquí también. Start Key La misma Start Key descrita anteriormente se puede usar aquí también. Consulta de índice con todas las combinaciones table.getQueryHelper(ZCNoSQLPartitionKeyCondition&gt;, &lt;true/false&gt;, &lt;limit&gt;) .withSecondaryKSeyCondition(&lt;ZCNoSQLSecondaryKeyCondition&gt;, false) .withOtherCondition(&lt;ZCNoSQLCondition&gt;) .withRequiredAttributes(&lt;List of ZCNoSQLAttributes&gt;) .withConsistency(true/false) .withStartKey(&lt;ZCNoSQLItem&gt;) .queryIndex(&lt;indexID&gt;); -------------------------------------------------------------------------------- title: "Eliminar items de tabla" 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 eliminar items de una tabla NoSQL." last_updated: "2026-07-02T09:34:15.887Z" source: "https://docs.catalyst.zoho.com/es/sdk/java/v1/cloud-scale/nosql/delete-items/" service: "Cloud Scale" related: - NoSQL (/es/cloud-scale/help/nosql/introduction/) - NoSQL API (/es/api/code-reference/cloud-scale/nosql/insert-item/#InsertNewItem) -------------------------------------------------------------------------------- # Eliminar items de una tabla NoSQL Puedes eliminar items de una tabla NoSQL en Catalyst identificándolos usando las claves primarias de la tabla. 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 de la tabla, para identificar un item. Nota: Catalyst te permite eliminar un máximo de 25 items en bloque de una tabla NoSQL con una sola operación del SDK. Los datos se pueden eliminar sin ninguna condición usando la instancia ZCNoSQLTable o se pueden eliminar con la ayuda de la instancia ZCNoSQLDeleteHelper, que se puede usar para construir las distintas partes de la solicitud. Para eliminar datos con la instancia de ZCNoSQLTable, se puede usar lo siguiente. //public ZCNoSQLResponseBean delete(ZCNoSQLItem key) throws Exception; table.delete(&lt;ZCNoSQLItem&gt;); Para eliminar con ZCNoSQLDeleteHelper ZCNoSQLDeleteHelper Esta clase se puede usar para eliminar datos de la tabla con condiciones. Se puede obtener a partir de la instancia ZCNoSQLTable. //public ZCNoSQLDeleteHelper getDeleteHelper(ZCNoSQLItem keys) throws Exception; //public ZCNoSQLResponseBean delete() throws Exception; table.getDeleteHelper(&lt;ZCNoSQLItem&gt;).delete(); Otros métodos disponibles en ZCNoSQLDeleteHelper ZCNoSQLCondition Las mismas condiciones descritas anteriormente se pueden reutilizar para la eliminación. NOSQL_RETURN_VALUE Las mismas condiciones descritas anteriormente se pueden reutilizar para la eliminación. Eliminar con condición y valor de retorno table.getDeleteHelper(&lt;ZCNoSQLItem&gt;).withCondition(&lt;ZCNoSQLCondition&gt;).withReturnValue(&lt;NOSQL_RETURN_VALUE&gt;).delete(); --- ## SDK — Node JS — NoSQL -------------------------------------------------------------------------------- title: "Obtener instancia del componente" description: "Catalyst NoSQL es una base de datos completamente administrada y potente que te proporciona un medio de almacenamiento de datos no relacional y no SQL. Esta página describe el método del SDK para crear una nueva instancia del componente NoSQL." last_updated: "2026-07-02T09:34:15.887Z" source: "https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/cloud-scale/nosql/get-component-instance/" service: "Cloud Scale" related: - NoSQL (/es/cloud-scale/help/nosql/introduction) - NoSQL API (/es/api/code-reference/cloud-scale/nosql/insert-item/#InsertNewItem) - NoSQL Java SDK (/es/sdk/java/v1/cloud-scale/nosql/get-table-metadata/) - NoSQL Python SDK (/es/sdk/python/v1/cloud-scale/nosql/get-component-instance/) -------------------------------------------------------------------------------- # NoSQL Catalyst NoSQL es una función de almacenamiento de datos no relacional, NoSQL, completamente administrada que te permite almacenar los datos semi-estructurados, no estructurados y dispares de tus aplicaciones. Catalyst admite almacenamiento de datos de tipo documento en formato JSON basado en pares clave-valor. El paquete del SDK de Node.js de Catalyst NoSQL te permite realizar operaciones CRUD de datos en tus tablas NoSQL en tu proyecto. Puedes obtener los metadatos de tus tablas NoSQL, crear elementos NoSQL de varios tipos de datos admitidos, e insertar, actualizar, obtener o eliminar elementos en una tabla específica. También puedes consultar tablas o índices de tablas especificando condiciones de consulta. ### Create a NoSQL Instance Una instancia de componente es un objeto que se puede utilizar para acceder a las configuraciones predefinidas específicas de un componente en particular. Puedes crear un objeto NoSQL para realizar operaciones del SDK en Node.js como se muestra a continuación. Esto no realizará una llamada del lado del servidor. Haremos referencia a esta instancia de nosql en varios fragmentos de código para trabajar con NoSQL. La referencia app utilizada para crear la instancia de NoSQL es el objeto de Node.js devuelto como respuesta durante la inicialización del SDK. // Crear una instancia de NoSQL const nosql = app.nosql(); -------------------------------------------------------------------------------- title: "Obtener metadatos de tabla" description: "Catalyst NoSQL es una base de datos completamente administrada y potente que te proporciona un medio de almacenamiento de datos no relacional y no SQL. Esta página describe el método del SDK para obtener los metadatos de tablas NoSQL." last_updated: "2026-07-02T09:34:15.887Z" source: "https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/cloud-scale/nosql/get-table-metadata/" service: "Cloud Scale" related: - NoSQL (/es/cloud-scale/help/nosql/introduction) - Create and Manage Tables (/es/cloud-scale/help/nosql/create-manage-tables/) -------------------------------------------------------------------------------- # Obtener metadatos de tabla NoSQL Puedes obtener los metadatos de una tabla individual de Catalyst NoSQL o de todas las tablas en tu proyecto como se describe a continuación. ### Get Metadata of Single Table Los metadatos de una tabla individual en Catalyst NoSQL se pueden obtener de dos formas como se menciona en esta página. La respuesta contendrá detalles de la configuración de la tabla, como la clave de partición y la clave de ordenamiento, el atributo TTL, y más. La referencia nosql utilizada en los fragmentos de código a continuación es la instancia del componente creada para realizar estas operaciones. #### Obtener metadatos de tabla con ID de tabla Puedes obtener los metadatos de una tabla NoSQL en tu proyecto haciendo referencia a su ID de tabla único utilizando el método getTable() como se muestra a continuación. // Crear una instancia de NoSQL const nosql = app.nosql(); // Obtener metadatos de tabla usando el Table ID const tableA = await nosql.getTable('124567890'); #### Obtener metadatos de tabla con nombre de tabla Puedes obtener los metadatos de una tabla NoSQL en tu proyecto haciendo referencia al nombre de la tabla utilizando el método getTable() como se muestra a continuación. // Crear una instancia de NoSQL const nosql = app.nosql(); // Obtener metadatos de tabla usando el nombre de tabla const tableB = await nosql.getTable('EmpTable'); Nota: Si renombras la tabla, necesitarás actualizar los cambios en tu código. <br> ### Get Metadata of All Tables Catalyst te permite obtener los metadatos de todas las tablas en tu proyecto utilizando el método getAllTable() como se muestra a continuación. // Obtener metadatos de todas las tablas const allTables = await nosql.getAllTable(); -------------------------------------------------------------------------------- title: "Obtener instancia de tabla" description: "Catalyst NoSQL es una base de datos completamente administrada y potente que te proporciona un medio de almacenamiento de datos no relacional y no SQL. Esta página describe el método del SDK para crear una instancia de tabla NoSQL." last_updated: "2026-07-02T09:34:15.887Z" source: "https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/cloud-scale/nosql/get-table-instance/" service: "Cloud Scale" related: - NoSQL (/es/cloud-scale/help/nosql/introduction) - Create and Manage Tables (/es/cloud-scale/help/nosql/create-manage-tables/) -------------------------------------------------------------------------------- # Obtener instancia de tabla NoSQL Catalyst NoSQL te permite obtener una instancia de tabla vacía de una tabla NoSQL existente. Luego puedes usar esta instancia para hacer referencia a esa tabla y realizar todas las operaciones de tabla admitidas. Este proceso no realizará una llamada del lado del servidor. Puedes obtener una instancia de tu tabla NoSQL de tres formas como se describe en esta sección. La referencia nosql utilizada en los fragmentos de código a continuación es la instancia del componente creada anteriormente. ### Get Instance with Table ID Obtén una instancia de tabla con el ID único de la tabla como se muestra a continuación. const tableInstanceA = nosql.table('1234567890'); // Crear una instancia de tabla con el Table ID <br> ### Get Instance with Table Name Obtén una instancia de tabla con el nombre de la tabla como se muestra a continuación. const tableInstanceB = nosql.table('Emptable'); // Crear una instancia de tabla con el nombre de tabla <br> ### Get Instance with Table Details Obtén una instancia de tabla especificando los detalles de la tabla y resolviéndola con toJSON() como se muestra a continuación. Este método proporciona flexibilidad al permitirte duplicar un objeto de tabla cuya instancia ya obtuviste usando el ID de tabla o el nombre de la tabla. Luego puedes configurar detalles adicionales de la tabla en la instancia y usar esto para hacer referencia a la tabla en su lugar. const tableInstanceC = nosql.table(tableA.toJSON()); // Crear una instancia de tabla con los detalles de tabla -------------------------------------------------------------------------------- title: "Construir elemento NoSQL" description: "Catalyst NoSQL es una base de datos completamente administrada y potente que te proporciona un medio de almacenamiento de datos no relacional y no SQL. Esta página describe los métodos para construir elementos NoSQL de varios tipos de datos." last_updated: "2026-07-02T09:34:15.887Z" source: "https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/cloud-scale/nosql/construct-item/" service: "Cloud Scale" related: - NoSQL (/es/cloud-scale/help/nosql/introduction) - Basic Components (/es/cloud-scale/help/nosql/components/#basic-components) - Supported Data Types in NoSQL (/es/cloud-scale/help/nosql/working-with-data/introduction/) -------------------------------------------------------------------------------- # Construir elemento NoSQL Los elementos de Catalyst NoSQL representan una colección de atributos que contienen los datos de un único punto de datos, como registros. Puedes insertar o actualizar elementos en una tabla NoSQL existente en tu proyecto en un formato JSON personalizado. Sin embargo, antes de insertar o actualizar un elemento en Catalyst, necesitarás construir el elemento. Puedes construir un elemento NoSQL de atributos que contengan diferentes tipos de datos admitidos por Catalyst como se describe en la sección a continuación. Catalyst admite varios tipos de datos como String, Number, Set of Strings, Set of Numbers, List y Map. Consulta la lista completa de tipos de datos admitidos para obtener más información. Debes proporcionar obligatoriamente los valores para el atributo de clave de partición que configuraste para una tabla en cada elemento de datos. Consulta la sección de ayuda de claves de tabla para conocer sobre las claves de tabla, el atributo TTL y otros detalles. <br> ### Create a New NoSQL Item Puedes crear un nuevo elemento NoSQL utilizando el método NoSQLItem() después de requerir la biblioteca no-sql que es parte del paquete zcatalyst-sdk-node, como se muestra a continuación. const { NoSQLItem } = require('zcatalyst-sdk-node/lib/no-sql'); const item = new NoSQLItem() // Crear un nuevo ítem NoSQL <br> ### Construct a NoSQL Item of String En el ejemplo a continuación, construimos un elemento que incluye valores de cadena y un atributo JSON anidado color como Map. const { NoSQLItem } = require('zcatalyst-sdk-node/lib/no-sql'); const item = new NoSQLItem() // Crear un nuevo ítem NoSQL // Agregar un valor de cadena .addString('fruit', 'mango') // Agregar un mapa .addMap('properties', { color: 'yellow' }); <br> ### Construct a NoSQL Byte Puedes crear un byte NoSQL para almacenar valores del tipo de datos *Binary*, creando un objeto buffer que se utiliza para representar una secuencia de bytes. Luego puedes crear un byte de dos formas como se muestra a continuación: usando el objeto ArrayBuffers que representa un buffer de datos binarios sin procesar, o desde una cadena Base64 que representa datos binarios en formato ASCII. const { NoSQLByte } = require('zcatalyst-sdk-node/lib/no-sql'); // Crear un NoSQL Byte const buff = Buffer.from('Hello world !!!'); // Crear un objeto buffer const byte = new NoSQLByte(buff); // Crear un byte NoSQL usando el objeto ArrayBuffers const byteA = new NoSQLByte(buff.toString('base64')); // Crear un byte NoSQL desde una cadena Base64 <br> ### Construct a NoSQL Byte Set Catalyst te permite crear un conjunto de bytes NoSQL para almacenar una colección de valores binarios del tipo de datos *Set of Binary*, creando un objeto buffer que se utiliza para representar una secuencia de bytes. Luego puedes crear un conjunto de bytes usando el objeto ArrayBuffers que representa un buffer de datos binarios sin procesar, o desde una cadena Base64 que representa datos binarios en formato ASCII. También puedes crear un conjunto de bytes pasando bytes construidos como un arreglo de bytes. const { NoSQLByte, NoSQLByteSet } = require('zcatalyst-sdk-node/lib/no-sql'); // Crear un NoSQL Byte Set const buff = Buffer.from('Hello world !!!'); // Crear un objeto buffer const byte = new NoSQLByte(buff); // Crear un byte NoSQL usando el objeto ArrayBuffers const byteA = new NoSQLByte(buff.toString('base64')); // Crear un byte NoSQL desde una cadena Base64 const byteSet = new NoSQLByteSet([byte, byteA]); // Crear un set de bytes NoSQL desde un array de bytes NoSQL const byteSetA = new NoSQLByteSet([buff.toString('base64')]); // Crear un NoSQL Byte set from a Base64 string array const byteSetB = new NoSQLByteSet([buff]); // Crear un NoSQL Byte set using the ArrayBuffers object <br> ### Construct a NoSQL String Set Puedes crear un conjunto de cadenas NoSQL del tipo de datos *Set of String* desde un arreglo de cadenas como se muestra a continuación. const { NoSQLStringSet } = require('zcatalyst-sdk-node/lib/no-sql'); // Crear un NoSQL string set const stringSet = new NoSQLStringSet(['hello', 'world']); // Crear un NoSQL string set from a string array <br> ### Construct a NoSQL Number Set Puedes crear un conjunto de números NoSQL del tipo de datos *Set of Numbers* desde un arreglo de números o valores BigInt como se muestra a continuación. const { NoSQLNumberSet } = require('zcatalyst-sdk-node/lib/no-sql'); // Crear un NoSQL number set const numberSet = new NoSQLNumberSet([123, 1234n]); // Crear un set de números NoSQL desde un array de números o valores BigInt <br> ### Manipulate NoSQL Items Catalyst te permite realizar manipulaciones en elementos NoSQL, como crear un elemento NoSQL desde un objeto JavaScript simple, o viceversa. Puedes crear un elemento NoSQL construyendo un objeto JavaScript simple que contenga los datos del elemento, en el formato JSON estándar. Luego puedes construir el elemento NoSQL desde el objeto JS usando NoSQLItem.from() como se muestra en el código de ejemplo a continuación. También puedes convertir un elemento NoSQL de vuelta a un objeto JavaScript simple usando itemFromObj.to(), como se muestra en el código. const { NoSQLItem } = require('zcatalyst-sdk-node/lib/no-sql'); // Definir un objeto const obj = { fruit: 'apple', // Clave de partición properties: { color: 'red' } }; const itemFromObj = NoSQLItem.from(obj); // Construir un ítem NoSQL desde el objeto JS plano const plainJsObject = itemFromObj.to(); // Convertir el ítem a un objeto JS plano -------------------------------------------------------------------------------- title: "Insertar elementos en tabla" description: "Catalyst NoSQL es una base de datos completamente administrada y potente que te proporciona un medio de almacenamiento de datos no relacional y no SQL. Esta página describe los métodos del SDK para insertar elementos en una tabla NoSQL de varias formas." last_updated: "2026-07-02T09:34:15.888Z" source: "https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/cloud-scale/nosql/insert-items/" service: "Cloud Scale" related: - NoSQL (/es/cloud-scale/help/nosql/introduction) - Working with Data (/es/cloud-scale/help/nosql/working-with-data/introduction/) - NoSQL API (/es/api/code-reference/cloud-scale/nosql/insert-item/#InsertNewItem) -------------------------------------------------------------------------------- # Insertar elementos en tabla NoSQL Catalyst te permite insertar elementos en una tabla NoSQL específica después de construirlos. Los elementos 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 admitidos para conocer estos temas en detalle. Nota: Catalyst te permite insertar un máximo de 25 elementos de forma masiva en una tabla NoSQL con una sola operación del SDK. <br> ### Insert Items without Conditions Puedes insertar nuevos elementos en una tabla NoSQL sin condiciones construyendo los elementos en el formato JSON personalizado de Catalyst. Esto requerirá que pases obligatoriamente los valores para los atributos de clave de partición y clave de ordenamiento configurados para la tabla. En el ejemplo dado a continuación, se proporciona un elemento que contiene el valor del atributo de clave de partición fruitName como "Banana". Otros atributos del tipo de datos string como fruitColor y fruitType también se agregan como un map llamado fruitProperties. El elemento se inserta usando el método insertItems(). // Insertar un ítem NoSQL sin condiciones const plainInsert = await table.insertItems({ // Definir el elemento a insertar con la clave de partición fruitName item: NoSQLItem.from({ fruitName: 'Banana', //Proporcionar valores para los otros atributos del elemento fruitProperties: { fruitColor: 'Yellow', fruitType: 'Berries' } }), // Establecer el valor de retorno en la respuesta. Otros valores soportados son "OLD" y "NULL" return: NoSQLReturnValue.NEW }); <br> ### Insert Items with Conditional Functions Puedes insertar atributos en elementos existentes en una tabla NoSQL utilizando condiciones específicas que defines en el formato JSON personalizado de Catalyst. En este tipo, los datos existentes de la tabla se recuperan y se evalúan contra la condición especificada. Los elementos se insertan solo si la evaluación es verdadera. Si no hay datos existentes, las condiciones se ignoran y los elementos se insertan. Catalyst admite múltiples operadores para evaluar condiciones. Los operadores admitidos se representan como se muestra a continuación. <table class="content-table nosql-components-table"> <thead> <tr> <th class="w10p">Operadores</th> <th class="w10p">Notación</th> </tr> </thead> <tbody> <tr> <td>CONTAINS</td> <td>contains</td> </tr> <tr> <td>NOT_CONTAINS</td> <td>not_contains</td> </tr> <tr> <td>BEGINS_WITH</td> <td>begins_with</td> </tr> <tr> <td>ENDS_WITH</td> <td>ends_with</td> </tr> <tr> <td>IN</td> <td>in</td> </tr> <tr> <td>NOT_IN</td> <td>not_in</td> </tr> <tr> <td>BETWEEN</td> <td>between</td> </tr> <tr> <td>NOT_BETWEEN</td> <td>not_between</td> </tr> <tr> <td>EQUALS</td> <td>equals</td> </tr> <tr> <td>NOT_EQUALS</td> <td>not_equals</td> </tr> <tr> <td>GREATER_THAN</td> <td>greater_than</td> </tr> <tr> <td>LESS_THAN</td> <td>less_than</td> </tr> <tr> <td>GREATER_THAN_OR_EQUALS</td> <td>greater_equal</td> </tr> <tr> <td>LESSER_THAN_OR_EQUALS</td> <td>less_equal</td> </tr> <tr> <td>AND</td> <td>AND</td> </tr> <tr> <td>OR</td> <td>OR</td> </tr> </tbody> </table> <br> El ejemplo a continuación ilustra esto definiendo una condición para que el tipo de datos del atributo fruitName sea String en los datos existentes. Si la condición se cumple, el atributo taste con el valor "Sweet" se agrega a estos elementos. // Insertar un ítem NoSQL con la función "attribute_type" const attrTypeInsert = await table.insertItems({ // Definir el elemento a insertar item: NoSQLItem.from({ taste: 'Sweet' }), // Definir la condición para la inserción condition: { // La condición especifica que el elemento debe ser agregado si el tipo de atributo es String ("S") function: { // Establecer el tipo de función function_name: 'attribute_type', // Proporcionar los argumentos a la función args: [ { // Establecer la ruta del atributo attribute_path: ['fruitName'] }, // Establecer el tipo de atributo NoSQLMarshall.makeString('S') // => { "S": "S" } ] } } }); <br> A continuación se muestran algunos fragmentos de ejemplo más para insertar elementos con funciones condicionales. //Insertar un elemento NoSQL con el operador "equals", el valor del atributo "name" es "apple" const operatorEqInsert = await table.insertItems({ // Definir el elemento a insertar item: NoSQLItem.from({ taste: 'Sweet' }), // Definir la condición para la inserción condition: { // Establecer la ruta del atributo attribute: ['name'], // Establecer el operador según la operación operator: NoSQLOperator.EQUALS, // Establecer el valor para comparación value: NoSQLMarshall.makeString('apple') // => { "S": "apple" } } }); //Insertar un elemento NoSQL con "group_operator", atributo "name" es "apple" Y atributo "variety" es "gala" const groupOpInsert = await table.insertItems({ // Definir el elemento a insertar item: NoSQLItem.from({ taste: 'Sweet' }), // Definir la condición para la inserción condition: { // Establecer el operador de grupo group_operator: NoSQLConditionGroupOperator.AND, // Proporcionar las condiciones de grupo group: [ { // Establecer la ruta del atributo attribute: 'name', // Establecer el operador según la operación operator: NoSQLOperator.EQUALS, // Establecer el valor para comparación value: NoSQLMarshall.makeString('apple') // => { "S": "apple" } }, { // Establecer la ruta del atributo attribute: 'variety', // Establecer el operador según la operación operator: NoSQLOperator.EQUALS, // Establecer el valor para comparación value: NoSQLMarshall.makeString('gala') // => { "S": "gala" } } ] } }); //Insertar un elemento NoSQL con el operador "begins_with", el valor del atributo "name" comienza con "app" const beginsWithInsert = await table.insertItems({ // Definir el elemento a insertar item: NoSQLItem.from({ taste: 'Sweet' }), // Definir la condición para la inserción condition: { // Establecer la ruta del atributo attribute: ['name'], // Establecer el operador según la operación operator: NoSQLOperator.BEGINS_WITH, // establecer el valor para comparación value: NoSQLMarshall.makeString('app') // => { "S": "app" } } }); -------------------------------------------------------------------------------- title: "Actualizar elementos en tabla" description: "Catalyst NoSQL es una base de datos completamente administrada y potente 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 elementos en una tabla NoSQL." last_updated: "2026-07-02T09:34:15.888Z" source: "https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/cloud-scale/nosql/update-items/" service: "Cloud Scale" related: - NoSQL (/es/cloud-scale/help/nosql/introduction) - Working with Data (/es/cloud-scale/help/nosql/working-with-data/introduction/) - Basic Components (/es/cloud-scale/help/nosql/components/#basic-components) - NoSQL API (/es/api/code-reference/cloud-scale/nosql/update-item/#UpdateItem) -------------------------------------------------------------------------------- # Actualizar elementos en tabla Catalyst te permite actualizar elementos en una tabla NoSQL específica después de construirlos. Un elemento se puede actualizar identificándolo usando sus claves primarias. 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 elemento. 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 a actualizar en el elemento. Nota: Catalyst te permite actualizar un máximo de 25 elementos de forma masiva en una tabla NoSQL con una sola operación del SDK. El ejemplo a continuación ilustra esto identificando un elemento con la clave de partición fruitName y el valor "Apple". Se proporcionan los valores para los atributos de este elemento a actualizar, color y taste, junto con la ruta a estos atributos. Se requiere la biblioteca no-sql del paquete zcatalyst-sdk-node para definir y construir el elemento NoSQL. const { NoSQLItem, NoSQLEnum } = require('zcatalyst-sdk-node/lib/no-sql'); const { NoSQLOperator } = NoSQLEnum; // Actualizar un elemento NoSQL identificado con la clave de partición "apple" con su atributo de propiedades actualizado const updatedItems = await table.updateItems({ // Definir el valor de la clave de partición del elemento a actualizar keys: [new NoSQLItem().addString('fruit', 'apple')], // Definir los atributos a actualizar update_attributes: [ { // Especificar el tipo de operación de actualización operation_type: NoSQLUpdateOperationType.PUT, // Proporcionar los valores para el atributo a actualizar update_value: NoSQLMarshall.makeMap({ color: 'Green', taste: 'Sour' }), // Especificar la ruta a los atributos attribute_path: ['fruitProperties'] } ] }); -------------------------------------------------------------------------------- title: "Obtener elementos de tabla" description: "Catalyst NoSQL es una base de datos completamente administrada y potente que te proporciona un medio de almacenamiento de datos no relacional y no SQL. Esta página describe el método del SDK para obtener elementos de una tabla NoSQL." last_updated: "2026-07-02T09:34:15.888Z" source: "https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/cloud-scale/nosql/fetch-items/" service: "Cloud Scale" related: - NoSQL (/es/cloud-scale/help/nosql/introduction) - Basic Components (/es/cloud-scale/help/nosql/components/#basic-components) - Working with Data (/es/cloud-scale/help/nosql/working-with-data/introduction/) - NoSQL API (/es/api/code-reference/cloud-scale/nosql/fetch-item/#FetchItem) -------------------------------------------------------------------------------- # Obtener elementos de tabla NoSQL Catalyst te permite obtener elementos de una tabla NoSQL identificándolos con sus claves primarias. 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 obtener el elemento. También puedes filtrar opcionalmente los atributos a obtener especificando los atributos requeridos. Nota: Catalyst te permite obtener un máximo de 100 elementos de una tabla NoSQL en una sola operación de lectura del SDK. El ejemplo a continuación ilustra la obtención de un elemento identificado por su clave de partición fruit con el valor "apple" usando fetchItem(). Atributos específicos como properties y taste se filtran para ser obtenidos usando required_attributes. El fragmento de código también usa consistent_read para indicar si la operación de lectura debe realizarse usando el clúster maestro o uno esclavo. Cuando se establece en true, se consulta desde el maestro. Si es false, se consulta desde el esclavo. Nota: En la replicación maestro-esclavo, el maestro contiene todos los datos de la base de datos, y el esclavo contiene copias del maestro. Realizar una operación de lectura desde el esclavo puede reducir el costo general con la compensación de un ligero retraso en que los datos actualizados se reflejen. Se requiere la biblioteca no-sql del paquete zcatalyst-sdk-node para definir el elemento NoSQL. const { NoSQLItem } = require('zcatalyst-sdk-node/lib/no-sql'); //Obtener propiedades de un NoSQLItem identificado con el valor de clave de partición "apple" const fetchedItem = await table.fetchItem({ // Definir la clave de partición y el valor del elemento a obtener keys: [new NoSQLItem().addString('fruit', 'apple')], // Establecer consistent_read en true para consultar desde el maestro. Si se establece en false, se consulta desde el esclavo. consistent_read: true, // Especificar los atributos a obtener required_attributes: [['properties', 'taste']] }); -------------------------------------------------------------------------------- title: "Consultar tabla" description: "Catalyst NoSQL es una base de datos completamente administrada y potente que te proporciona un medio de almacenamiento de datos no relacional y no SQL. Esta página describe el método del SDK para consultar una tabla NoSQL." last_updated: "2026-07-02T09:34:15.888Z" source: "https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/cloud-scale/nosql/query-table/" service: "Cloud Scale" related: - NoSQL (/es/cloud-scale/help/nosql/introduction) - Table Keys (/es/cloud-scale/help/nosql/components/#table-keys) - Query Table (/es/sdk/nodejs/v2/cloud-scale/nosql/query-table/) -------------------------------------------------------------------------------- # Consultar tabla NoSQL Catalyst te permite consultar una tabla NoSQL y recuperar datos identificando los elementos usando las claves primarias de la tabla. 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 recuperar el elemento. Nota: Catalyst te permite recuperar un máximo de 100 elementos de forma masiva de una tabla NoSQL con paginación desde una sola operación del SDK. Debes usar el token start_key recibido en la respuesta del SDK y construir la lógica para la paginación. Puedes definir la condición de clave que identifica el elemento especificando los atributos, sus valores requeridos y el operador admitido a utilizar. Los operadores admitidos se representan como se muestra a continuación. <table class="content-table nosql-components-table"> <thead> <tr> <th class="w10p">Operadores</th> <th class="w10p">Notación</th> </tr> </thead> <tbody> <tr> <td>CONTAINS</td> <td>contains</td> </tr> <tr> <td>NOT_CONTAINS</td> <td>not_contains</td> </tr> <tr> <td>BEGINS_WITH</td> <td>begins_with</td> </tr> <tr> <td>ENDS_WITH</td> <td>ends_with</td> </tr> <tr> <td>IN</td> <td>in</td> </tr> <tr> <td>NOT_IN</td> <td>not_in</td> </tr> <tr> <td>BETWEEN</td> <td>between</td> </tr> <tr> <td>NOT_BETWEEN</td> <td>not_between</td> </tr> <tr> <td>EQUALS</td> <td>equals</td> </tr> <tr> <td>NOT_EQUALS</td> <td>not_equals</td> </tr> <tr> <td>GREATER_THAN</td> <td>greater_than</td> </tr> <tr> <td>LESS_THAN</td> <td>less_than</td> </tr> <tr> <td>GREATER_THAN_OR_EQUALS</td> <td>greater_equal</td> </tr> <tr> <td>LESSER_THAN_OR_EQUALS</td> <td>less_equal</td> </tr> <tr> <td>AND</td> <td>AND</td> </tr> <tr> <td>OR</td> <td>OR</td> </tr> </tbody> </table> <br> En el ejemplo a continuación, la consulta se ejecuta usando el método queryTable() identificando los elementos usando la clave de partición fruitType y especificando el valor de condición como "Citrus". Catalyst NoSQL también te permite definir otros elementos de la consulta, como usar consistent_read para indicar si la operación de lectura debe realizarse usando el clúster maestro o uno esclavo, limitar el número de filas a devolver y especificar el orden de clasificación como ascendente. Nota: En la replicación maestro-esclavo, el maestro contiene todos los datos de la base de datos, y el esclavo contiene copias del maestro. Realizar una operación de lectura desde el esclavo puede reducir el costo general con la compensación de un ligero retraso en que los datos actualizados se reflejen. Se requiere la biblioteca no-sql del paquete zcatalyst-sdk-node para definir el elemento NoSQL. const { NoSQLMarshall, NoSQLEnum } = require('zcatalyst-sdk-node/lib/no-sql'); const { NoSQLOperator } = NoSQLEnum; // Consultar una tabla NoSQL para obtener los elementos identificados por la clave de partición fruitType con el valor "citrus" const queriedItem = await table.queryTable({ // Definir la condición de clave para consultar los elementos key_condition: { // Especificar el nombre del atributo de clave de partición de la tabla attribute: 'fruitType', // Definir el operador soportado a utilizar. También puedes usar BETWEEN, GREATERTHAN, LESSERTHAN, GREATERTHANOREQUALTO, LESSERTHANOREQUALTO operator: NoSQLOperator.EQUALS, // Especificar el valor para comparación value: NoSQLMarshall.makeString('Citrus') }, // Establecer consistent_read en true para consultar desde el maestro. Si se establece en false, se consulta desde el esclavo. consistent_read: true, // Limitar el número de filas a devolver especificando un valor limit: 10, // Establecer forward_scan en true para ordenar los resultados en orden ascendente. De lo contrario, se ordena en orden descendente. forward_scan: true }); -------------------------------------------------------------------------------- title: "Consultar índice" description: "Catalyst NoSQL es una base de datos completamente administrada y potente que te proporciona un medio de almacenamiento de datos no relacional y no SQL. Esta página describe el método del SDK para consultar un índice NoSQL." last_updated: "2026-07-02T09:34:15.888Z" source: "https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/cloud-scale/nosql/query-index/" service: "Cloud Scale" related: - NoSQL (/es/cloud-scale/help/nosql/introduction) - Table Keys (/es/cloud-scale/help/nosql/components/#table-keys) - Query Index (/es/sdk/nodejs/v2/cloud-scale/nosql/query-index/) -------------------------------------------------------------------------------- # Consultar índice en NoSQL Catalyst te permite consultar un índice NoSQL y recuperar datos identificando los elementos usando las claves primarias del índice. La indexación te permite ejecutar consultas alternativas sobre los datos de la tabla sin hacer uso de las claves primarias de la tabla principal. Puedes configurar índices desde la consola de Catalyst. Puedes usar solo la clave de partición o una combinación de la clave de partición y la clave de ordenamiento del índice para recuperar un elemento. Nota: Catalyst te permite recuperar un máximo de 100 elementos de forma masiva de una tabla NoSQL con paginación desde una sola operación del SDK. Debes usar el token start_key recibido en la respuesta del SDK y construir la lógica para la paginación. Puedes definir la condición de clave que identifica el elemento especificando los atributos, sus valores requeridos y el operador admitido a utilizar. Los operadores admitidos se representan como se muestra a continuación. <table class="content-table nosql-components-table"> <thead> <tr> <th class="w10p">Operadores</th> <th class="w10p">Notación</th> </tr> </thead> <tbody> <tr> <td>CONTAINS</td> <td>contains</td> </tr> <tr> <td>NOT_CONTAINS</td> <td>not_contains</td> </tr> <tr> <td>BEGINS_WITH</td> <td>begins_with</td> </tr> <tr> <td>ENDS_WITH</td> <td>ends_with</td> </tr> <tr> <td>IN</td> <td>in</td> </tr> <tr> <td>NOT_IN</td> <td>not_in</td> </tr> <tr> <td>BETWEEN</td> <td>between</td> </tr> <tr> <td>NOT_BETWEEN</td> <td>not_between</td> </tr> <tr> <td>EQUALS</td> <td>equals</td> </tr> <tr> <td>NOT_EQUALS</td> <td>not_equals</td> </tr> <tr> <td>GREATER_THAN</td> <td>greater_than</td> </tr> <tr> <td>LESS_THAN</td> <td>less_than</td> </tr> <tr> <td>GREATER_THAN_OR_EQUALS</td> <td>greater_equal</td> </tr> <tr> <td>LESSER_THAN_OR_EQUALS</td> <td>less_equal</td> </tr> <tr> <td>AND</td> <td>AND</td> </tr> <tr> <td>OR</td> <td>OR</td> </tr> </tbody> </table> <br> En el ejemplo a continuación, la consulta se ejecuta identificando los elementos usando la clave de partición fruitColor del índice FruitIdentifier y especificando el valor de condición como "yellow". La consulta se realiza usando el método queryIndex(). Catalyst NoSQL también te permite definir otros elementos de la consulta, como usar consistent_read para indicar si la operación de lectura debe realizarse usando el clúster maestro o uno esclavo, limitar el número de filas a devolver y especificar el orden de clasificación como ascendente. Nota: En la replicación maestro-esclavo, el maestro contiene todos los datos de la base de datos, y el esclavo contiene copias del maestro. Realizar una operación de lectura desde el esclavo puede reducir el costo general con la compensación de un ligero retraso en que los datos actualizados se reflejen. Se requiere la biblioteca no-sql del paquete zcatalyst-sdk-node para definir el elemento NoSQL. const { NoSQLMarshall, NoSQLEnum } = require('zcatalyst-sdk-node/lib/no-sql'); const { NoSQLOperator } = NoSQLEnum; //Consultar un índice de tabla NoSQL para obtener los elementos identificados por la clave de partición fruitColour con el valor "yellow" const queriedIndexItems = await table.queryIndex('FruitIdentifier', { //Definir la condición de clave para consultar los elementos key_condition: { attribute: 'fruitColor', //Definir el operador soportado a utilizar operator: NoSQLOperator.EQUALS, value: NoSQLMarshall.makeString('yellow') }, // Establecer consistent_read en true para consultar desde el maestro. Si se establece en false, se consulta desde el esclavo. consistent_read: true, //Limitar el número de filas a devolver especificando un valor limit: 15, // Establecer forward_scan en true para ordenar los resultados en orden ascendente. De lo contrario, se ordena en orden descendente. forward_scan: true }); -------------------------------------------------------------------------------- title: "Eliminar elementos de tabla" description: "Catalyst NoSQL es una base de datos completamente administrada y potente que te proporciona un medio de almacenamiento de datos no relacional y no SQL. Esta página describe el método del SDK para eliminar elementos de una tabla NoSQL." last_updated: "2026-07-02T09:34:15.888Z" source: "https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/cloud-scale/nosql/delete-items/" service: "Cloud Scale" related: - NoSQL (/es/cloud-scale/help/nosql/introduction) - Working with Data (/es/cloud-scale/help/nosql/working-with-data/introduction/) - Basic Components (/es/cloud-scale/help/nosql/components/#basic-components) - NoSQL API (/es/api/code-reference/cloud-scale/nosql/delete-item/#DeleteItem) -------------------------------------------------------------------------------- # Eliminar elementos de tabla NoSQL Puedes eliminar elementos de una tabla NoSQL en Catalyst identificándolos usando las claves primarias de la tabla. 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 de la tabla, para identificar un elemento. Nota: Catalyst te permite eliminar un máximo de 25 elementos de forma masiva de una tabla NoSQL con una sola operación del SDK. La operación de eliminación se realiza usando el método deleteItems() como se muestra en el ejemplo a continuación. Se elimina el elemento con la clave de partición fruit que coincide con "apple". Se requiere la biblioteca no-sql del paquete zcatalyst-sdk-node para definir elementos NoSQL. const { NoSQLItem } = require('zcatalyst-sdk-node/lib/no-sql'); //Eliminar un elemento NoSQL de la tabla con clave de partición "fruit" y el valor coincidente "apple" const deletedItems = await table.deleteItems({ //Especificar el valor de la clave de partición del elemento a eliminar keys: NoSQLItem.from({ fruit: 'apple' }) }); --- ## SDK — Python — NoSQL -------------------------------------------------------------------------------- title: "Obtener instancia del componente" 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 crear una nueva instancia del componente NoSQL." last_updated: "2026-07-02T09:34:15.889Z" source: "https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/nosql/get-component-instance/" service: "Cloud Scale" related: - NoSQL (/es/cloud-scale/help/nosql/introduction) - NoSQL API (/es/api/code-reference/cloud-scale/nosql/insert-item/#InsertNewItem) - NoSQL Java SDK (/es/sdk/java/v1/cloud-scale/nosql/get-table-metadata/) - NoSQL Node.js SDK (/es/sdk/nodejs/v2/cloud-scale/nosql/get-component-instance/) -------------------------------------------------------------------------------- # Obtener instancia del componente Catalyst NoSQL es una funcionalidad de almacenamiento de datos no relacional, NoSQL y completamente administrada que te permite almacenar los datos semi-estructurados, no estructurados y dispares de tus aplicaciones. Catalyst soporta almacenamiento de datos de tipo documento en formato JSON basado en pares clave-valor. El paquete del SDK de Python de Catalyst NoSQL te permite realizar operaciones CRUD de datos en tus tablas NoSQL en tu proyecto. Puedes obtener los metadatos de tus tablas NoSQL, crear items NoSQL de varios tipos de datos soportados, e insertar, actualizar, obtener o eliminar items en una tabla específica. También puedes consultar tablas o índices de tablas especificando condiciones de consulta. ### Crear una instancia de NoSQL Una instancia del componente es un objeto que se puede usar para acceder a las configuraciones predefinidas específicas de un componente en particular. Puedes crear un objeto NoSQL para realizar operaciones del SDK en Python como se muestra a continuación. Esto no realizará una llamada del lado del servidor. Nos referiremos a esta instancia nosql en varios fragmentos de código para trabajar con NoSQL. La referencia app utilizada para crear la instancia NoSQL es el objeto Python devuelto como respuesta durante la inicialización del SDK. #Crear una instancia de NoSQL nosql = app.nosql() -------------------------------------------------------------------------------- title: "Obtener metadatos de tabla" 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 obtener metadatos de tabla NoSQL." last_updated: "2026-07-02T09:34:15.889Z" source: "https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/nosql/get-table-metadata/" service: "Cloud Scale" related: - NoSQL (/es/cloud-scale/help/nosql/introduction) - Create and Manage Tables (/es/cloud-scale/help/nosql/create-manage-tables/) -------------------------------------------------------------------------------- # Obtener metadatos de tabla NoSQL Puedes obtener los metadatos de una tabla individual de Catalyst NoSQL o de todas las tablas en tu proyecto como se describe a continuación. ### Obtener metadatos de una tabla individual Los metadatos de una tabla individual en Catalyst NoSQL se pueden obtener haciendo referencia al nombre de la tabla usando el método getTable() como se muestra a continuación. La respuesta contendrá detalles de la configuración de la tabla, como la partition key y sort key, el atributo TTL, y más. La referencia nosql utilizada en los fragmentos de código a continuación es la instancia del componente creada para realizar estas operaciones. # Crear una instancia de NoSQL nosql = app.nosql() #Obtener metadatos de tabla usando el nombre de tabla table_details = nosql.get_table_resources("EmpTable") print(table_details) Note: Si renombras la tabla, necesitarás actualizar los cambios en tu código. <br> ### Obtener metadatos de todas las tablas Catalyst te permite obtener los metadatos de todas las tablas en tu proyecto usando el método get_all_tables() como se muestra a continuación. table_res = nosql.get_all_tables() print(table_res) -------------------------------------------------------------------------------- title: "Obtener instancia de tabla" 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 crear una instancia de tabla NoSQL." last_updated: "2026-07-02T09:34:15.889Z" source: "https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/nosql/get-table-instance/" service: "Cloud Scale" related: - NoSQL (/es/cloud-scale/help/nosql/introduction) - Create and Manage Tables (/es/cloud-scale/help/nosql/create-manage-tables/) -------------------------------------------------------------------------------- # Obtener instancia de tabla NoSQL Catalyst NoSQL te permite obtener una instancia de tabla vacía de una tabla NoSQL. Luego puedes usar esta instancia para hacer referencia a esa tabla y realizar todas las operaciones de tabla soportadas. Este proceso no realizará una llamada del lado del servidor. Puedes obtener una instancia de tu tabla NoSQL haciendo referencia al nombre de la tabla como se muestra en esta sección. La referencia nosql utilizada en los fragmentos de código a continuación es la instancia del componente creada anteriormente. table = nosql.get_table('employees') # Crear una instancia de tabla con el nombre de tabla -------------------------------------------------------------------------------- title: "Construir item" 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 los métodos para construir items NoSQL de varios tipos de datos." last_updated: "2026-07-02T09:34:15.889Z" source: "https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/nosql/construct-item/" service: "Cloud Scale" related: - NoSQL (/es/cloud-scale/help/nosql/introduction) - Basic Components (/es/cloud-scale/help/nosql/components/#basic-components) - Supported Data Types in NoSQL (/es/cloud-scale/help/nosql/working-with-data/introduction/) -------------------------------------------------------------------------------- # Construir item NoSQL Los items de Catalyst NoSQL representan una colección de atributos que contienen los datos de un único punto de datos, como registros. Puedes insertar o actualizar items en una tabla NoSQL existente en tu proyecto en un formato JSON personalizado. Sin embargo, antes de insertar o actualizar un item en Catalyst, necesitarás construir el item. Puedes construir un item NoSQL de atributos que contengan diferentes tipos de datos soportados por Catalyst como se describe en la sección a continuación. Catalyst soporta varios tipos de datos como String, Number, Set of Strings, Set of Numbers, List y Map. Consulta la lista completa de tipos de datos soportados para conocer más. Debes proporcionar obligatoriamente los valores para el atributo de partition key que configuraste para una tabla en cada item de datos. Consulta la sección de ayuda de Table Keys para conocer sobre las claves de tabla, el atributo TTL y otros detalles. El fragmento de código a continuación muestra los formatos para construir un item con atributos de diferentes tipos de datos: # Construir un elemento NoSQL de diferentes tipos de datos attributes = { # cadena de texto "custom_attrib_string": { "S": "John Doe" }, # Número "custom_attrib_num": { "N": "234521" }, # Valor codificado en binario "custom_attrib_bin": { "B": "SGVsbG9Xb3JsZA==" }, # Conjunto de cadenas "custom_attrib_set_string": { "SS": ["John Doe", "New York", "USA"] }, # conjunto de números "custom_attrib_set_num": { "SN": ["23423", "821n", "11"] }, # conjunto de valores binarios "custom_attrib_set_bin": { "SB": ["SGVsbG8=", "V29ybGQ="] }, # atributo booleano "custom_attrib_bool": { "BOOL": True }, # atributo de lista "custom_attrib_list": { "L": [{"name": "banana"}, {"quantity": 4}] }, # atributo de mapa "custom_attrib_map": { "M": { "name": { "S": "John Doe" }, "age": { "N": "23" } } } } -------------------------------------------------------------------------------- title: "Insertar 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 los métodos del SDK para insertar items en una tabla NoSQL de varias maneras." last_updated: "2026-07-02T09:34:15.889Z" source: "https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/nosql/insert-items/" service: "Cloud Scale" related: - NoSQL (/es/cloud-scale/help/nosql/introduction) - Working with Data (/es/cloud-scale/help/nosql/working-with-data/introduction/) - NoSQL API (/es/api/code-reference/cloud-scale/nosql/insert-item/#InsertNewItem) -------------------------------------------------------------------------------- # Insertar items en tablas NoSQL Catalyst te permite insertar items en una tabla NoSQL específica después de construirlos. Los items se pueden insertar de diferentes maneras como se describe en esta sección. Puedes consultar las secciones de ayuda sobre agregar y trabajar con datos, el formato JSON personalizado de Catalyst, y los tipos de datos soportados para conocer estos temas en detalle. Note: Catalyst te permite insertar un máximo de 25 items de forma masiva en una tabla NoSQL con una sola operación del SDK. <br> ### Insertar items sin condiciones Puedes insertar nuevos items en una tabla NoSQL sin ninguna condición construyendo los items en el formato JSON personalizado de Catalyst. Esto requerirá que pases obligatoriamente los valores para los atributos de partition key y sort key configurados para la tabla. Por ejemplo, en el fragmento de código a continuación, se proporcionan los valores para los atributos de partition key y sort key del item, fruitName y Location respectivamente. Otros atributos del tipo de dato string como fruitType y availability se proporcionan como una lista fruitProperties. El item se inserta luego usando el método insert_items(). # Insertar un ítem NoSQL sin condiciones item = { "fruitName": { "S": "Banana" }, "Location": { "S": "Indonesia" }, "fruitProperties": { "L": [ { "fruitType": "Berries" }, { "availability": "abundant" } } ] } } # Insertar el elemento basado en la condición definida y establecer el elemento a devolver en la respuesta. Otros valores soportados son "OLD" y "NULL" res = table.insert_items({ 'item': item, 'return': 'NEW' }) <br> ### Insertar items con funciones condicionales Puedes insertar atributos en items existentes en una tabla NoSQL usando condiciones específicas que defines en el formato JSON personalizado de Catalyst. En este tipo, los datos existentes de la tabla se recuperan y 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. Catalyst soporta múltiples operadores para evaluar condiciones. Los operadores soportados se representan como se muestra a continuación. <table class="content-table nosql-components-table"> <thead> <tr> <th class="w10p">Operators</th> <th class="w10p">Notation</th> </tr> </thead> <tbody> <tr> <td>CONTAINS</td> <td>contains</td> </tr> <tr> <td>NOT_CONTAINS</td> <td>not_contains</td> </tr> <tr> <td>BEGINS_WITH</td> <td>begins_with</td> </tr> <tr> <td>ENDS_WITH</td> <td>ends_with</td> </tr> <tr> <td>IN</td> <td>in</td> </tr> <tr> <td>NOT_IN</td> <td>not_in</td> </tr> <tr> <td>BETWEEN</td> <td>between</td> </tr> <tr> <td>NOT_BETWEEN</td> <td>not_between</td> </tr> <tr> <td>EQUALS</td> <td>equals</td> </tr> <tr> <td>NOT_EQUALS</td> <td>not_equals</td> </tr> <tr> <td>GREATER_THAN</td> <td>greater_than</td> </tr> <tr> <td>LESS_THAN</td> <td>less_than</td> </tr> <tr> <td>GREATER_THAN_OR_EQUALS</td> <td>greater_equal</td> </tr> <tr> <td>LESSER_THAN_OR_EQUALS</td> <td>less_equal</td> </tr> <tr> <td>AND</td> <td>AND</td> </tr> <tr> <td>OR</td> <td>OR</td> </tr> </tbody> </table> <br> El ejemplo a continuación ilustra esto definiendo una condición para el atributo anidado fruitColour en los datos existentes que contenga el valor "Yellow". Este atributo es parte del atributo fruitProperties. Si la condición se satisface, los atributos fruitType y availability se agregan a los items. El item se inserta luego usando el método insert_items(). # Insertar un elemento NoSQL con una función condicional condition_function = { "function": { "function_name": "attribute_type", "args": [ { "attribute_path": ["fruitProperties", "[0]"] }, { "fruitColour": "Yellow" } ] } } item = { "Location": { "S": "Indonesia" }, "fruitName": { "S": "Banana" }, "fruitProperties": { "L": [ { "fruitType": "Berries" }, { "availability": "abundant" } } ] } } # Insertar el elemento basado en la condición definida y establecer el valor de retorno en la respuesta. Otros valores soportados son "OLD" y "NULL" res = table.insert_items({ 'item': item, 'condition': condition_function, 'return': 'NEW' }) <br> ### Insertar items con operadores condicionales Catalyst también te permite insertar items basándose en condiciones definidas con operadores en el formato JSON personalizado de Catalyst. Los datos existentes de la tabla se recuperan y 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. Catalyst soporta múltiples operadores para evaluar condiciones, como se enumeran en la [sección anterior](#insert-items-with-conditional-functions). El ejemplo a continuación ilustra la inserción de un item basándose en condiciones definidas con el operador between. La condición establece que solo cuando el atributo count tiene valores entre 0 y 10 en los datos existentes, los atributos backupID y count se deben insertar en esos items. El item se inserta con el método insert_items(). # Insertar un elemento NoSQL con un operador condicional condition_function = { "attribute": ["count"], "operator": "between", "value": { "L": [ { "N": "0" }, { "N": "10" } ] } } item = { "countryCode": { "N": 054 }, "backupID": { "N": 2379992 }, "count": { "N": "3" } } # Insertar el elemento basado en la condición definida y establecer el valor de retorno en la respuesta. Otros valores soportados son "OLD" y "NULL" res = table.insert_items({ 'item': item, 'condition': condition_function, 'return': 'NEW' }) -------------------------------------------------------------------------------- title: "Actualizar 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-07-02T09:34:15.892Z" source: "https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/nosql/update-items/" service: "Cloud Scale" -------------------------------------------------------------------------------- # Actualizar items NoSQL en tabla Catalyst te permite actualizar items en una tabla NoSQL específica después de construirlos. Un item puede actualizarse identificándolo usando sus claves primarias. Por ejemplo, puedes usar solo la partition key o una combinación de la partition key y sort key 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 a actualizar en el item. Note: Catalyst te permite actualizar un máximo de 25 items de forma masiva en una tabla NoSQL con una sola operación del SDK. El ejemplo a continuación ilustra esto recuperando un item con la partition key fruitName y la sort key location. Los atributos de este item a actualizar son color y taste. Se proporcionan los valores para todos estos atributos. También puedes definir opcionalmente una condición para la actualización. La actualización ocurrirá solo si se cumple la condición. # Actualizar un elemento NoSQL identificándolo con sus claves primarias res = table.update_items({ "keys": { "fruitName": { "S": "Banana" }, "location": { "S": "Indonesia" } },# Definir los atributos a actualizar en el elemento "update_attributes": [ { "operation_type": "PUT", "color": { "S": "Yellow" }, "taste": { "S": "Sweet" }, "attribute_path": "fruitProperties" } ],# Definir una condición. El elemento se actualizará solo si se cumple. (opcional) "condition" : { "function": { "function_name": "attribute_exists", "args": [ { "attribute_path": "fruitProperties" } ] } } }) print(res) -------------------------------------------------------------------------------- title: "Obtener 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 obtener items de una tabla NoSQL." last_updated: "2026-07-02T09:34:15.892Z" source: "https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/nosql/fetch-items/" service: "Cloud Scale" related: - NoSQL (/es/cloud-scale/help/nosql/introduction) - Basic Components (/es/cloud-scale/help/nosql/components/#basic-components) - Working with Data (/es/cloud-scale/help/nosql/working-with-data/introduction/) - NoSQL API (/es/api/code-reference/cloud-scale/nosql/fetch-item/#FetchItem) -------------------------------------------------------------------------------- # Obtener items de tabla NoSQL Catalyst te permite obtener items de una tabla NoSQL identificándolos con sus claves primarias. Por ejemplo, puedes usar solo la partition key o una combinación de la partition key y sort key para obtener el item. También puedes filtrar opcionalmente los atributos a obtener especificando los atributos requeridos. Note: Catalyst te permite obtener un máximo de 100 items de una tabla NoSQL en una sola operación de lectura del SDK. El ejemplo a continuación ilustra la obtención de un item identificado por su partition key fruit y la sort key location usando fetch_item(). Los atributos específicos como properties y taste se filtran para ser obtenidos usando required_objects. # Obtener las propiedades de un elemento NoSQL identificado con la clave de partición y la clave de ordenamiento res = table.fetch_item({ "keys": [ { "fruit": { "S": "apple" }, "location: { "S": "USA" } } ], # Especificar los atributos a obtener 'required_objects': ["properties", "taste"] }) print(res) -------------------------------------------------------------------------------- title: "Consultar tabla" 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 consultar una tabla NoSQL." last_updated: "2026-07-02T09:34:15.892Z" source: "https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/nosql/query-table/" service: "Cloud Scale" related: - NoSQL (/es/cloud-scale/help/nosql/introduction) - Table Keys (/es/cloud-scale/help/nosql/components/#table-keys) - Query Table (/es/sdk/nodejs/v2/cloud-scale/nosql/query-table/) -------------------------------------------------------------------------------- # Consultar tabla NoSQL Catalyst te permite consultar una tabla NoSQL y recuperar datos identificando los items usando las claves primarias de la tabla. Por ejemplo, puedes usar solo la partition key o una combinación de la partition key y sort key para recuperar el item. Note: Catalyst te permite recuperar un máximo de 100 items de forma masiva de una tabla NoSQL con paginación desde una sola operación del SDK. Debes usar el token start_key recibido en la respuesta del SDK y construir la lógica para la paginación. Puedes definir la condición de clave que identifica el item especificando los atributos, sus valores requeridos y el operador soportado a utilizar. También puedes especificar condiciones adicionales con los operadores de grupo. Los operadores soportados se representan como se muestra a continuación. <table class="content-table nosql-components-table"> <thead> <tr> <th class="w10p">Operators</th> <th class="w10p">Notation</th> </tr> </thead> <tbody> <tr> <td>CONTAINS</td> <td>contains</td> </tr> <tr> <td>NOT_CONTAINS</td> <td>not_contains</td> </tr> <tr> <td>BEGINS_WITH</td> <td>begins_with</td> </tr> <tr> <td>ENDS_WITH</td> <td>ends_with</td> </tr> <tr> <td>IN</td> <td>in</td> </tr> <tr> <td>NOT_IN</td> <td>not_in</td> </tr> <tr> <td>BETWEEN</td> <td>between</td> </tr> <tr> <td>NOT_BETWEEN</td> <td>not_between</td> </tr> <tr> <td>EQUALS</td> <td>equals</td> </tr> <tr> <td>NOT_EQUALS</td> <td>not_equals</td> </tr> <tr> <td>GREATER_THAN</td> <td>greater_than</td> </tr> <tr> <td>LESS_THAN</td> <td>less_than</td> </tr> <tr> <td>GREATER_THAN_OR_EQUALS</td> <td>greater_equal</td> </tr> <tr> <td>LESSER_THAN_OR_EQUALS</td> <td>less_equal</td> </tr> <tr> <td>AND</td> <td>AND</td> </tr> <tr> <td>OR</td> <td>OR</td> </tr> </tbody> </table> <br> En el ejemplo a continuación, la consulta se ejecuta usando el método queryTable() identificando los items usando la partition key fruitType y especificando el valor de la condición como "citrus". También especificamos una condición adicional con el atributo location que coincide con "USA". Catalyst NoSQL también te permite definir otros elementos de la consulta, como usar consistent_read para indicar si la operación de lectura debe realizarse usando el clúster maestro o un esclavo, limitar el número de filas a devolver, y especificar el orden de clasificación como ascendente. Note: En la replicación maestro-esclavo, el maestro contiene todos los datos de la base de datos, y el esclavo contiene copias del maestro. Realizar una operación de lectura desde el esclavo puede reducir el costo general con la compensación de un pequeño retraso en que los datos actualizados se reflejen. # Consultar una tabla NoSQL para obtener los elementos identificados por la clave de partición fruitType con el valor "citrus" res = table.query_table( { # Establecer consistent_read a true para consultar desde el master. Si se establece a false, se consulta desde el slave. 'consistent_read': 'true',# Establecer forwardScan a true para ordenar los resultados en orden ascendente. De lo contrario, se ordena en orden descendente. 'forwardScan': 'true',# Limitar el número de filas a devolver especificando un valor 'limit': 10,# Definir la condición de clave para identificar elementos 'key_condition': { 'attribute': 'fruitType', 'operator': 'equals', 'value': { 'S': 'citrus' } }, # Especificar condiciones adicionales para consultar los elementos de la tabla usando operadores de grupo 'other_condition': { 'group_operator': 'and', 'group': [ { 'attribute': 'location', 'operator': 'equals', 'value': { 'S': 'USA' } } ] } }) print(res) -------------------------------------------------------------------------------- title: "Consultar índice" 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 consultar un índice NoSQL." last_updated: "2026-07-02T09:34:15.892Z" source: "https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/nosql/query-index/" service: "Cloud Scale" related: - NoSQL (/es/cloud-scale/help/nosql/introduction) - Table Keys (/es/cloud-scale/help/nosql/components/#table-keys) - Query Index (/es/sdk/nodejs/v2/cloud-scale/nosql/query-index/) -------------------------------------------------------------------------------- # Consultar índice Catalyst te permite consultar un índice NoSQL y recuperar datos identificando los items usando las claves primarias del índice. La indexación te permite ejecutar consultas alternativas en los datos de la tabla sin hacer uso de las claves primarias de la tabla principal. Puedes configurar índices desde la consola de Catalyst. Puedes usar solo la partition key o una combinación de la partition key y sort key del índice para recuperar un item. Note: Catalyst te permite recuperar un máximo de 100 items de forma masiva de una tabla NoSQL con paginación desde una sola operación del SDK. Debes usar el token start_key recibido en la respuesta del SDK y construir la lógica para la paginación. Puedes definir la condición de clave que identifica el item especificando los atributos, sus valores requeridos y el operador soportado a utilizar. También puedes especificar condiciones adicionales con los operadores de grupo. Los operadores soportados se representan como se muestra a continuación. <table class="content-table nosql-components-table"> <thead> <tr> <th class="w10p">Operators</th> <th class="w10p">Notation</th> </tr> </thead> <tbody> <tr> <td>CONTAINS</td> <td>contains</td> </tr> <tr> <td>NOT_CONTAINS</td> <td>not_contains</td> </tr> <tr> <td>BEGINS_WITH</td> <td>begins_with</td> </tr> <tr> <td>ENDS_WITH</td> <td>ends_with</td> </tr> <tr> <td>IN</td> <td>in</td> </tr> <tr> <td>NOT_IN</td> <td>not_in</td> </tr> <tr> <td>BETWEEN</td> <td>between</td> </tr> <tr> <td>NOT_BETWEEN</td> <td>not_between</td> </tr> <tr> <td>EQUALS</td> <td>equals</td> </tr> <tr> <td>NOT_EQUALS</td> <td>not_equals</td> </tr> <tr> <td>GREATER_THAN</td> <td>greater_than</td> </tr> <tr> <td>LESS_THAN</td> <td>less_than</td> </tr> <tr> <td>GREATER_THAN_OR_EQUALS</td> <td>greater_equal</td> </tr> <tr> <td>LESSER_THAN_OR_EQUALS</td> <td>less_equal</td> </tr> <tr> <td>AND</td> <td>AND</td> </tr> <tr> <td>OR</td> <td>OR</td> </tr> </tbody> </table> <br> En el ejemplo a continuación, la consulta se realiza con un índice referenciado por su ID de índice único. La consulta identifica los items usando la partition key del índice fruitColor y especificando el valor de la condición como "yellow". También especificamos una condición adicional con el atributo fruitType que coincide con "citrus". La consulta se realiza usando el método query_index(). Catalyst NoSQL también te permite definir otros elementos de la consulta, como usar consistent_read para indicar si la operación de lectura debe realizarse usando el clúster maestro o un esclavo, limitar el número de filas a devolver, y especificar el orden de clasificación como ascendente. Note: En la replicación maestro-esclavo, el maestro contiene todos los datos de la base de datos, y el esclavo contiene copias del maestro. Realizar una operación de lectura desde el esclavo puede reducir el costo general con la compensación de un pequeño retraso en que los datos actualizados se reflejen. # Consultar un índice de tabla NoSQL para obtener los elementos identificados por la clave de partición fruitColour con el valor "yellow"# Pasar el ID único del índice cres = table.query_index('6759000000740017', { # Establecer consistent_read a true para consultar desde el master. Si se establece a false, se consulta desde el slave. 'consistent_read': 'true',# Establecer forward_scan a true para ordenar los resultados en orden ascendente. De lo contrario, se ordena en orden descendente. 'forwardScan': 'true',# Limitar el número de filas a devolver especificando un valor 'limit': 10,# Definir la condición de clave para consultar los elementos 'key_condition': { 'attribute': 'fruitColor', 'operator': 'equals', 'value': { 'S': 'yellow' } }, # Definir condiciones adicionales para consultar los datos, usando operadores de grupo 'other_condition': { 'group_operator': 'AND', 'group': [ { 'attribute': 'fruitType', 'operator': 'equals', 'value': { 'S': 'citrus' } } ] } }) print(res) -------------------------------------------------------------------------------- title: "Eliminar 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 eliminar items de una tabla NoSQL." last_updated: "2026-07-02T09:34:15.892Z" source: "https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/nosql/delete-items/" service: "Cloud Scale" related: - NoSQL (/es/cloud-scale/help/nosql/introduction) - Working with Data (/es/cloud-scale/help/nosql/working-with-data/introduction/) - Basic Components (/es/cloud-scale/help/nosql/components/#basic-components) - NoSQL API (/es/api/code-reference/cloud-scale/nosql/delete-item/#DeleteItem) -------------------------------------------------------------------------------- # Eliminar items de tabla NoSQL Puedes eliminar items de una tabla NoSQL en Catalyst identificándolos usando las claves primarias de la tabla. Por ejemplo, puedes usar solo la partition key, o una combinación de la partition key y sort key de la tabla, para identificar un item. Note: Catalyst te permite eliminar un máximo de 25 items de forma masiva de una tabla NoSQL con una sola operación del SDK. La operación de eliminación se realiza usando el método delete_items() como se muestra en el ejemplo a continuación. El item con la partition key fruit que coincide con "apple" y la sort key location que coincide con "USA" se elimina. También puedes especificar condiciones adicionales para la eliminación. Solo si el item coincide con la condición, se eliminará. # Eliminar un elemento NoSQL de la tabla identificándolo con la clave de partición y la clave de ordenamiento res = table.delete_items( { "keys": { "fruit": { "S": "apple" }, "location": { "S": "USA" } } }), # Especificar una condición para la eliminación (opcional) "condition": { "function": { "function_name": "attribute_exists", "args": [ { "attribute_path": ["properties"] } ] } } }) print(res)