---
title: "Consultar índice"
url: https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/nosql/query-index/
description: "Catalyst NoSQL es una base de datos potente y completamente administrada 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-30T08:10:30Z
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
Catalyst te permite consultar un índice [NoSQL](https://docs.catalyst.zoho.com/es/cloud-scale/help/nosql/introduction/) y recuperar datos identificando los items 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 en 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 partition key o una combinación de la partition key y sort key del índice para recuperar un item. 

> **Note:** Catalyst te permite recuperar un máximo de 100 items 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 item especificando los atributos, sus valores requeridos y el operador soportado a utilizar. También puedes especificar condiciones adicionales con los operadores de grupo. 
Los operadores soportados se representan como se muestra a continuación.
<table class="content-table nosql-components-table">
<thead>
        <tr>
            <th class="w10p">Operators</th>
            <th class="w10p">Notation</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 realiza con un índice referenciado por su ID de índice único. La consulta identifica los items usando la partition key del índice `fruitColor` y especificando el valor de la condición como "yellow". También especificamos una condición adicional con el atributo `fruitType` que coincide con "citrus". La consulta se realiza usando el método `query_index()`.
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 un esclavo, limitar el número de filas a devolver, y especificar el orden de clasificación como ascendente. 

> **Note:** 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 pequeño retraso en que los datos actualizados se reflejen.

```python

# Consultar un índice de tabla NoSQL para obtener los elementos identificados por la clave de partición fruitColour con el valor "yellow"# Pasar el ID único del índice
cres = table.query_index('6759000000740017', {
  # Establecer consistent_read a true para consultar desde el master. Si se establece a false, se consulta desde el slave.
   'consistent_read': 'true',# Establecer forward_scan a true para ordenar los resultados en orden ascendente. De lo contrario, se ordena en orden descendente.
   'forwardScan': 'true',# Limitar el número de filas a devolver especificando un valor
   'limit': 10,# Definir la condición de clave para consultar los elementos
   'key_condition': {
    'attribute': 'fruitColor',
    'operator': 'equals',
   'value': {
     'S': 'yellow'
    }
   },
   # Definir condiciones adicionales para consultar los datos, usando operadores de grupo
   'other_condition': {
    'group_operator': 'AND',
    'group': [
     {
      'attribute': 'fruitType',
      'operator': 'equals',
      'value': {
       'S': 'citrus'
      }
     }
    ]
   } 
 })
print(res)
```