---
title: "Ejecutar consulta ZCQL"
url: https://docs.catalyst.zoho.com/es/sdk/android/v2/cloud-scale/zcql/execute-zcql-query/
description: "ZCQL es el lenguaje de consulta 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-24T12:08:39Z
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 consulta 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

Antes de ejecutar una consulta ZCQL para obtener el conjunto de datos requerido, debes construir la consulta para pasarla al método `execute()`. 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 `execute()`, 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/android/v2/cloud-scale/data-store/create-data-store-instance).

```bash
ZCatalystApp.getInstance().getDataStoreInstance().execute(
    selectQuery: ZCatalystSelectQuery,
    success: (List<Map<String, Map<String, Any?>>>) → Unit,
    failure: ((ZCatalystException) → Unit)?
): ZCatalystRequest<ZCatalystResponse<List<Map<String, Any?>>>>>?

```

**Parámetros**:

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

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

```bash
ZCatalystSelectQuery.Builder()
   .select(columns: Set<Column>): 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<Column>): ZCatalystSelectQuery.Builder
   .orderBy(columns: Set<Column>, 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
val query = ZCatalystSelectQuery.Builder()
    .selectAll()
    .from("EmployeeDetails") //Reemplaza esto con el nombre de tu tabla
    .where("Location", ZCatalystUtil.Comparator.EQUAL_TO, "Austin")
    .and("Department", ZCatalystUtil.Comparator.EQUAL_TO, "Marketing")
    .or("isActive", ZCatalystUtil.Comparator.EQUAL_TO, "true")
    .limit(5)
    .build()

ZCatalystApp.getInstance().getDataStoreInstance().execute(query,
    {
        println("Query executed successfully. $it")
    },
    {
        exception -> println("Exception occured $exception")
    })

```