---
title: "Construir elemento NoSQL"
url: https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/cloud-scale/nosql/construct-item/
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-03-30T08:10:30Z
service: Cloud Scale
type: general
related_links:
  - name: "NoSQL"
    url: /es/cloud-scale/help/nosql/introduction
  - name: "Basic Components"
    url: /es/cloud-scale/help/nosql/components/#basic-components
  - name: "Supported Data Types in NoSQL"
    url: /es/cloud-scale/help/nosql/working-with-data/introduction/
---

# Construir elemento NoSQL

Los elementos de [Catalyst NoSQL](https://docs.catalyst.zoho.com/es/cloud-scale/help/nosql/introduction/) 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](https://docs.catalyst.zoho.com/es/cloud-scale/help/nosql/working-with-data/introduction/#the-catalyst-custom-json-format). 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](https://docs.catalyst.zoho.com/es/cloud-scale/help/nosql/working-with-data/introduction/#supported-data-types) 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](https://docs.catalyst.zoho.com/es/cloud-scale/help/nosql/components/#table-keys) 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.

```javascript
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.

```javascript
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.

```javascript
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.

```javascript
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.

```javascript
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.

```javascript
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.

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