Aviso:

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

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.


Tipos de Datos Admitidos

Los tipos de datos admitidos en Catalyst para los atributos de NoSQL se listan a continuación.


Tipo de Dato Notación Descripción
String S Almacena una secuencia de caracteres
Number N Almacena un valor numérico
Binary B Almacena un número binario que representa una secuencia de bytes
Boolean BOOL Almacena uno de estos valores booleanos: true o false
Set of String SS Un conjunto que almacena una o más cadenas únicas
Set of Numbers SN Un conjunto que almacena una colección de números
Set of Binary SB Un conjunto que almacena una colección de números binarios como un conjunto de bytes
List L Almacena elementos ordenados del mismo tipo de dato
Map M Almacena una colección no ordenada de elementos de pares clave-valor
Null NULL Almacena solo un valor: NULL

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.

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.


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

copy
{
	"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 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.

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