---
title: "Consultar tabla"
url: https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/nosql/query-table/
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 una tabla 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 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 items 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 partition key o una combinación de la partition key y sort key para recuperar el 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 ejecuta usando el método `queryTable()` identificando los items usando la partition key `fruitType` y especificando el valor de la condición como "citrus". También especificamos una condición adicional con el atributo location que coincide con "USA".
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 una tabla NoSQL para obtener los elementos identificados por la clave de partición fruitType con el valor "citrus"
res = table.query_table(
 {
    # Establecer consistent_read a true para consultar desde el master. Si se establece a false, se consulta desde el slave.
   'consistent_read': 'true',# Establecer forwardScan 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 identificar elementos
   'key_condition': {
    'attribute': 'fruitType',
    'operator': 'equals',
    'value': {
     'S': 'citrus'
    }
   },
    # Especificar condiciones adicionales para consultar los elementos de la tabla usando operadores de grupo
   'other_condition': {
    'group_operator': 'and',
    'group': [
     {
     'attribute': 'location',
     'operator': 'equals',
     'value': {
      'S': 'USA'
     }
     }
    ]
   } 
 })
print(res)
```