---
title: "Ejecutar consulta ZCQL"
url: https://docs.catalyst.zoho.com/es/sdk/flutter/v2/cloud-scale/zcql/execute-zcql-query/
description: "ZCQL es el lenguaje de consultas propio de Catalyst que te permite realizar operaciones de creación, recuperación y modificación de datos en Data Store."
last_updated: 2026-03-20T16:21:56Z
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
---

# ZCQL

ZCQL es el lenguaje de consultas propio de Catalyst que te permite realizar operaciones de creación, recuperación y modificación de datos en [Data Store](https://docs.catalyst.zoho.com/es/cloud-scale/help/data-store/introduction). Admite consultas con funciones integradas, cláusulas SQL Join y otras sentencias y condiciones.

### Ejecutar una consulta ZCQL

Flutter te permite realizar operaciones de recuperación de datos usando ZCQL. Antes de ejecutar una consulta ZCQL para obtener el conjunto de datos requerido, debes construir la consulta para pasarla al método `getData()`. Puedes aprender sobre la sintaxis de ZCQL en la [página de ayuda de ZCQL](https://docs.catalyst.zoho.com/es/cloud-scale/help/zcql/introduction).

Debes pasar una instancia de `ZCatalystSelectQuery` al método `getData()`, como se muestra en la sintaxis de código de una ejecución de consulta ZCQL a continuación.

El `<DATA_STORE_INSTANCE>` utilizado aquí es la instancia definida en la [página de instancia de Data Store](https://docs.catalyst.zoho.com/es/sdk/flutter/v2/cloud-scale/data-store/create-data-store-instance).

```bash
Future<(APIResponse, List&lt;dynamic&gt;?)> ZCatalystApp.getInstance().getDataStoreInstance().getData(
ZCatalystSelectQuery selectQuery)
```

**Parámetros**:

* `selectQuery`: La instancia del tipo `ZCatalystSelectQuery` que se pasará

Puedes crear una instancia `selectQuery` para `ZCatalystSelectQuery` para las sentencias admitidas por ZCQL, de la siguiente manera:

```bash
ZCatalystSelectQuery.Builder()
   .select(columns: Set&lt;Column&gt;): ZCatalystSelectQuery.Builder
   .selectAll(): ZCatalystSelectQuery.Builder
   .where(column: String, comparator: ZCatalystUtil.Comparator,        	  
   value: String): ZCatalystSelectQuery.Builder
   .from(tableName: String): ZCatalystSelectQuery.Builder
   .and(column: String, comparator: ZCatalystUtil.Comparator, 		  
   value: String): ZCatalystSelectQuery.Builder
   .groupBy(columns: Set&lt;Column&gt;): ZCatalystSelectQuery.Builder
   .orderBy(columns: Set&lt;Column&gt;, sortOrder: 					  
   ZCatalystUtil.SortOrder): ZCatalystSelectQuery.Builder
   .innerJoin(tableName: String): ZCatalystSelectQuery.Builder
   .leftJoin(tableName: String): ZCatalystSelectQuery.Builder
   .on(joinColumn1: String, comparator: ZCatalystUtil.Comparator, 	  
   joinColumn2: String): ZCatalystSelectQuery.Builder
   .or(column: String, comparator: ZCatalystUtil.Comparator, value:String): ZCatalystSelectQuery.Builder
   .limit(offset: Int, value: Int?): ZCatalystSelectQuery.Builder
   .build(): ZCatalystSelectQuery
```

A continuación se muestra un fragmento de código de ejemplo de una ejecución de consulta ZCQL:

```bash
try {
      ZCQLColumn column1 = ZCQLColumn('Title');
      ZCQLColumn column2 = ZCQLColumn('Category');
      Set&lt;ZCQLColumn&gt; columns = Set();
      columns.add(column1);
      columns.add(column2);
      ZCatalystSelectQuery query = ZCatalystQueryBuilder()
          .select(columns)
          .from('Projects')
          .where('Category', Comparator.EQUAL_TO, 'Official')
          .build();
      var (_, result) = await app.getDataStoreInstance().getData(query);
      print("Query Result: $result");
 } on ZCatalystException catch (ex) {
      print(ex.toString());
 }
```