---
title: "Ejecutar consulta ZCQL"
url: https://docs.catalyst.zoho.com/es/sdk/ios/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-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
---

# ZCQL

ZCQL es el lenguaje de consulta propio de Catalyst que te permite realizar operaciones de recuperación de datos en [Data Store](https://docs.catalyst.zoho.com/es/cloud-scale/help/data-store/introduction). Soporta consultas SELECT 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.

```bash
<ZCatalystApp>.execute( query : ZCatalystSelectQuery, completion: @escaping (Result<[ [ String : Any ] ], ZCatalystError>) -> Void)
```

**Parámetros**:

* `query`: La instancia del tipo `ZCatalystSelectQuery` a pasar
* `completion`: Si la llamada de ejecución de la consulta es exitosa, el bloque de completion devolverá los registros que coincidan con los criterios de la consulta. De lo contrario, devolverá un error.

Puedes crear una instancia de `query` 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: Comparator,  value: String) -> ZCatalystSelectQuery.Builder
   .from(tableName: String)  -> ZCatalystSelectQuery.Builder
   .and(column: String, comparator: Comparator,  value: String) -> ZCatalystSelectQuery.Builder
   .groupBy(columns: Set<Column>) -> ZCatalystSelectQuery.Builder
   .orderBy(columns: Set<Column>, sortOrder: SortOrder) -> ZCatalystSelectQuery.Builder
   .innerJoin(tableName: String) -> ZCatalystSelectQuery.Builder
   .leftJoin(tableName: String) -> ZCatalystSelectQuery.Builder
   .on(joinColumn1: String, comparator: Comparator, joinColumn2: String) -> ZCatalystSelectQuery.Builder
   .or(column: String, comparator: Comparator, value:  String) -> ZCatalystSelectQuery.Builder
   .limit(offset: Int, value: Int? = nil) -> ZCatalystSelectQuery.Builder
  .build() -> ZCatalystSelectQuery

```

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

```bash
func testExecuteZCQL(){
	  var builder = ZCatalystSelectQuery.Builder()
	  var query = builder.selectAll().from( tableName : "Bio-data" ).build() //Reemplazar con el nombre de tu tabla
			ZCatalystApp.shared.getDataStoreInstance(tableIdentifier: "1096000000002071").execute( query : query) { ( result ) in
						switch result{
	  case .success( let response ) :
   	print("Response : \( response )")
  	case .error( let error ) :
   print( "Error occurred >>> \( error )" )
  	}
 	}
	}

```