Consultar tabla NoSQL

# Consultar tabla NoSQL

Catalyst te permite consultar una tabla {{%link href="/es/cloud-scale/help/nosql/introduction/" %}}NoSQL{{%/link%}} y recuperar datos identificando los elementos usando las {{%link href="/es/cloud-scale/help/nosql/components/#table-keys" %}}claves primarias{{%/link%}} 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.

{{%note%}}{{%bold%}}Nota:{{%/bold%}} 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 {{%badge%}}start_key{{%/badge%}} recibido en la respuesta del SDK y construir la lógica para la paginación.{{%/note%}}

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.

<thead>
        <tr>
            <th class="w10p">Operadores</th>
            <th class="w10p">Notación</th>
        </tr>
</thead>
<tbody>
    <tr>
        <td>CONTAINS</td>
        <td>{{%badge%}}contains{{%/badge%}}</td>
    </tr>
    <tr>
        <td>NOT_CONTAINS</td>
        <td>{{%badge%}}not_contains{{%/badge%}}</td>
    </tr>
    <tr>
        <td>BEGINS_WITH</td>
        <td>{{%badge%}}begins_with{{%/badge%}}</td>
    </tr>
    <tr>
       <td>ENDS_WITH</td>
        <td>{{%badge%}}ends_with{{%/badge%}}</td>
    </tr>
    <tr>
        <td>IN</td>
        <td>{{%badge%}}in{{%/badge%}}</td>
    </tr>
    <tr>
        <td>NOT_IN</td>
        <td>{{%badge%}}not_in{{%/badge%}}</td>
    </tr>
    <tr>
        <td>BETWEEN</td>
        <td>{{%badge%}}between{{%/badge%}}</td>
    </tr>
    <tr>
        <td>NOT_BETWEEN</td>
        <td>{{%badge%}}not_between{{%/badge%}}</td>
    </tr>
    <tr>
        <td>EQUALS</td>
        <td>{{%badge%}}equals{{%/badge%}}</td>
    </tr>
    <tr>
        <td>NOT_EQUALS</td>
        <td>{{%badge%}}not_equals{{%/badge%}}</td>
    </tr>
	<tr>
        <td>GREATER_THAN</td>
        <td>{{%badge%}}greater_than{{%/badge%}}</td>
    </tr>
	<tr>
        <td>LESS_THAN</td>
        <td>{{%badge%}}less_than{{%/badge%}}</td>
    </tr>
	<tr>
        <td>GREATER_THAN_OR_EQUALS</td>
        <td>{{%badge%}}greater_equal{{%/badge%}}</td>
    </tr>
	<tr>
        <td>LESSER_THAN_OR_EQUALS</td>
        <td>{{%badge%}}less_equal{{%/badge%}}</td>
    </tr>
	<tr>
        <td>AND</td>
        <td>{{%badge%}}AND{{%/badge%}}</td>
    </tr>
	<tr>
        <td>OR</td>
        <td>{{%badge%}}OR{{%/badge%}}</td>
    </tr>
</tbody>
</table>
<br>

En el ejemplo a continuación, la consulta se ejecuta usando el método {{%badge%}}queryTable(){{%/badge%}} identificando los elementos usando la clave de partición {{%badge%}}fruitType{{%/badge%}} y especificando el valor de condición como "Citrus".

Catalyst NoSQL también te permite definir otros elementos de la consulta, como usar {{%badge%}}consistent_read{{%/badge%}} 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.

{{%note%}}{{%bold%}}Nota:{{%/bold%}} 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.{{%/note%}}

Se requiere la biblioteca {{%badge%}}no-sql{{%/badge%}} del paquete {{%badge%}}zcatalyst-sdk-node{{%/badge%}} para definir el elemento NoSQL.

{{%code class="language-javascript" scroll="set-scroll" %}}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
});{{%/code%}}

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.

Operadores	Notación
CONTAINS	contains
NOT_CONTAINS	not_contains
BEGINS_WITH	begins_with
ENDS_WITH	ends_with
IN	in
NOT_IN	not_in
BETWEEN	between
NOT_BETWEEN	not_between
EQUALS	equals
NOT_EQUALS	not_equals
GREATER_THAN	greater_than
LESS_THAN	less_than
GREATER_THAN_OR_EQUALS	greater_equal
LESSER_THAN_OR_EQUALS	less_equal
AND	AND
OR	OR

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.

copy

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

Última actualización 2026-03-24 17:38:39 +0530 IST

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit

NoSQL Table Keys Query Table

Node JS SDK

Operaciones del SDK

Consultar tabla NoSQL