---
title: "Ejecutar consulta"
url: https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/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 NodeJS con fragmentos de código de ejemplo."
last_updated: 2026-03-20T16:21:56Z
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"
    url: /es/cloud-scale/help/zcql/introduction
  - name: "Data Store"
    url: /es/cloud-scale/help/data-store/introduction
---

# Ejecutar consulta

`zcql` se refiere a la instancia del componente definida [aquí](https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/cloud-scale/zcql/get-component-instance). Esto devolverá una promesa que se resolverá con un objeto. La clave `content` contendrá el
arreglo de objetos de fila.

### Construct and Execute the Query on the Primary Data Store

Para las [consultas ZCQL](https://docs.catalyst.zoho.com/es/cloud-scale/help/zcql/introduction) que se ejecutan en el Data Store principal, puedes construir la consulta y pasarla al método `executeZCQLQuery()` 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
//Construct the query to execute 
let query = 'INSERT into ShipmentData (productID, productName, region) VALUES (3782, A4 Reams, India)';
let result = await zcql.executeZCQLQuery(query);
```

### Construct and Execute the Query on the OLAP Database

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

```javascript
//Construct the query to execute 
let query = 'SELECT SUM(price) FROM ShipmentData';
let result = await zcql.executeOLAPQuery(query);
```