---
title: "Ejecutar consulta"
url: https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/zcql/execute-zcql-query/
description: "Esta página describe el método para ejecutar consultas ZCQL en una tabla del Data Store en tu aplicación Python con fragmentos de código de ejemplo."
last_updated: 2026-03-30T08:10:30Z
service: Cloud Scale
type: general
related_links:
  - name: "Execute query - API"
    url: /es/api/code-reference/cloud-scale/zcql/execute-zcql-query/#ExecuteZCQLQuery
  - name: "ZCQL Help"
    url: /es/cloud-scale/help/zcql/introduction
  - name: "Data Store Help"
    url: /es/cloud-scale/help/data-store/introduction
  - name: "SDK Scopes"
    url: /es/sdk/python/v1/sdk-scopes
---

# Ejecutar consulta
La referencia `zcql_service` utilizada en el fragmento de código a continuación es la instancia del componente creada [anteriormente](https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/zcql/get-component-instance/). Según el objeto de consulta que se pase, la respuesta devuelve un objeto de fila o un array de objetos de fila.
### Construir y ejecutar la consulta en el Data Store principal
Para que las consultas ZCQL se ejecuten en el Data Store principal, puedes construir el objeto de consulta y pasarlo al método `execute_query()` como se muestra a continuación. Estas consultas pueden incluir sentencias SELECT, INSERT, UPDATE o DELETE.
A continuación se muestra una consulta INSERT de ejemplo:

```javascript
#Construir la consulta ZCQL
query = 'INSERT into ShipmentData (productID, productName, region) VALUES (3782, A4 Reams, India)'
result = zcql_service.execute_query(query)
```

### Construir y ejecutar la consulta en la base de datos OLAP
Las consultas que ejecutes en la base de datos OLAP solo deben incluir la sentencia SELECT, ya que las operaciones de escritura directa en ella no están permitidas. Puedes construir el objeto de consulta y pasarlo al método `execute_olap_query()`. A continuación se muestra una consulta SELECT analítica de ejemplo.

```javascript
//Construct the query to execute 
query = 'SELECT SUM(price) FROM ShipmentData';
result = zcql_service.execute_olap_query(query);
```

**Parámetros utilizados**
<table class="content-table">
        <thead>
                <tr>
                        <th class="w20p">Nombre del parámetro</th>
                        <th class="w20p">Tipo de dato</th>
      <th class="w60p">Definición</th>
                </tr>
        </thead>
        <tbody>
                <tr>
                        <td>`query`</td>
                        <td>String</td>
                        <td>Un parámetro **obligatorio**. Almacenará la consulta a ejecutar.</td>
                </tr>
        </tbody>
</table>

> **Info :** Consulta la [tabla de SDK Scopes](https://docs.catalyst.zoho.com/es/sdk/python/v1/sdk-scopes) para determinar el nivel de permiso requerido para realizar la operación anterior.