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.

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

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'
});

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

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

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

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

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