---
title: "Consultar índice"
url: https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/cloud-scale/nosql/query-index/
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 un índice 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 Index"
    url: /es/sdk/nodejs/v2/cloud-scale/nosql/query-index/
---

# Consultar índice en NoSQL

Catalyst te permite consultar un índice [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) del índice. La indexación te permite ejecutar consultas alternativas sobre los datos de la tabla sin hacer uso de las claves primarias de la tabla principal. Puedes configurar índices desde la consola de Catalyst. Puedes usar solo la clave de partición o una combinación de la clave de partición y la clave de ordenamiento del índice para recuperar un 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 identificando los elementos usando la clave de partición `fruitColor` del índice `FruitIdentifier` y especificando el valor de condición como "yellow". La consulta se realiza usando el método `queryIndex()`.

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 un índice de tabla NoSQL para obtener los elementos identificados por la clave de partición fruitColour con el valor "yellow"
const queriedIndexItems = await table.queryIndex('FruitIdentifier', {
//Definir la condición de clave para consultar los elementos
key_condition: {
attribute: 'fruitColor',
//Definir el operador soportado a utilizar
operator: NoSQLOperator.EQUALS,
value: NoSQLMarshall.makeString('yellow')
},
// 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: 15,
// Establecer forward_scan en true para ordenar los resultados en orden ascendente. De lo contrario, se ordena en orden descendente.
forward_scan: true
});
```