Aviso:

Para brindarle información de soporte completa de manera más rápida, el contenido de esta página ha sido traducido al español mediante traducción automática. Para consultar la información de soporte más precisa, consulte la versión en inglés de este contenido.

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. 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.

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.

copy
Future<(APIResponse, List<dynamic>?)> 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:

copy
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:

copy
try {
      ZCQLColumn column1 = ZCQLColumn('Title');
      ZCQLColumn column2 = ZCQLColumn('Category');
      Set<ZCQLColumn> 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());
 }

Última actualización 2026-03-20 21:51:56 +0530 IST

EN ESTA PÁGINA

ENLACES RELACIONADOS

Data Store ZCQL Execute ZCQL - API