---
title: "Consultar tabla"
url: https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/cloud-scale/nosql/query-table/
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-03-24T12:08:39Z
service: Cloud Scale
type: general
related_links:
  - name: "NoSQL"
    url: /es/cloud-scale/help/nosql/introduction
  - name: "Table Keys"
    url: /es/cloud-scale/help/nosql/components/#table-keys
  - name: "Query Table"
    url: /es/sdk/nodejs/v2/cloud-scale/nosql/query-table/
---

# Consultar tabla NoSQL

Catalyst te permite consultar una tabla [NoSQL](https://docs.catalyst.zoho.com/es/cloud-scale/help/nosql/introduction/) y recuperar datos identificando los elementos usando las [claves primarias](https://docs.catalyst.zoho.com/es/cloud-scale/help/nosql/components/#table-keys) 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>

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.

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