---
title: "Ejecutar consulta ZCQL"
url: https://docs.catalyst.zoho.com/es/sdk/web/v4/cloud-scale/zcql/execute-zcql-query/
description: "ZCQL es el lenguaje de consulta propio de Catalyst que te permite realizar operaciones de recuperación de datos en el Data Store."
last_updated: 2026-03-30T08:10:30Z
service: Cloud Scale
type: general
related_links:
  - name: "Data Store"
    url: /es/cloud-scale/help/data-store/introduction
  - name: "ZCQL"
    url: /es/cloud-scale/help/zcql/introduction/
  - name: "Execute ZCQL - API"
    url: /es/api/code-reference/cloud-scale/zcql/execute-zcql-query/#ExecuteZCQLQuery
---

# Ejecutar consulta ZCQL

### Construir la consulta

Debes construir una [consulta ZCQL](https://docs.catalyst.zoho.com/es/cloud-scale/help/zcql/introduction/) sobre el conjunto de datos requerido antes de ejecutarla. A continuación se muestra una consulta SELECT de ejemplo:

```javascript
//Crear una consulta para ejecutar
var query = 'SELECT * FROM ShipmentData';

```

### Ejecutar la consulta

El objeto de consulta creado en el paso anterior se pasa al método executeZCQLQuery(). La referencia zcql utilizada aquí es la [instancia del componente](https://docs.catalyst.zoho.com/es/sdk/web/v4/cloud-scale/zcql/get-component-instance) definida anteriormente.

Esto devolverá una promesa que se resolverá a un objeto. La clave content contendrá el arreglo de objetos de fila.

```javascript
//Ejecutar la consulta pasándola
var zcql = catalyst.ZCatalystQL;
 var zcqlPromise  = zcql.executeQuery(query);
zcqlPromise
        .then((response) => {
            console.log(response.content);
        })
        .catch((err) => {
            console.log(err);
        });

```

> **Nota:** Para usar los comandos de [ZCQL V2](https://docs.catalyst.zoho.com/es/cloud-scale/help/zcql/syntax-exceptions/) en tu código, usa los métodos de Catalyst listados [aquí](https://docs.catalyst.zoho.com/es/sdk/web/v4/overview/#manage-environment-variables) con los valores listados a continuación para establecer la variable de entorno apropiada:

* **Key**: `ZOHO_CATALYST_ZCQL_PARSER`

* **Value**: `V2`

A continuación se muestra una respuesta de ejemplo que recibirás. La respuesta es la misma para ambas versiones del Web SDK.

**Web SDK**

```json
[
  {
    AlienCity: {
      CREATORID: "2136000000006003",
      MODIFIEDTIME: "2021-08-13 13:49:19:475",
      CREATEDTIME: "2021-08-13 13:49:19:475",
      CityName: "Dallas",
      ROWID: "2136000000008508"
    }
  },
  {
    AlienCity: {
      CREATORID: "2136000000006003",
      MODIFIEDTIME: "2021-08-16 15:55:32:969",
      CREATEDTIME: "2021-08-16 15:55:32:969",
      CityName: "Houston",
      ROWID: "2136000000011002"
    }
  },
  {
    AlienCity: {
      CREATORID: "2136000000006003",
      MODIFIEDTIME: "2021-08-16 17:03:01:507",
      CREATEDTIME: "2021-08-16 16:29:10:499",
      CityName: "Austin",
      ROWID: "2136000000011011"
    }
  }
]

```