お知らせ:

当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

ZCQL

ZCQLは、Data Storeでデータの作成、取得、および変更操作を実行できるCatalyst独自のクエリ言語です。組み込み関数、SQL Join句、その他のステートメントおよび条件を含むクエリをサポートしています。

ZCQLクエリの実行

Flutterでは、ZCQLを使用してデータ取得操作を実行できます。必要なデータセットを取得するためにZCQLクエリを実行する前に、getData()メソッドに渡すクエリを構築する必要があります。ZCQL構文については、ZCQLヘルプページで確認できます。

以下のZCQLクエリ実行のコード構文に示すように、ZCatalystSelectQueryのインスタンスをgetData()メソッドに渡す必要があります。

ここで使用される<DATA_STORE_INSTANCE>は、Data Storeインスタンスページで定義されたインスタンスです。

copy
Future<(APIResponse, List<dynamic>?)> ZCatalystApp.getInstance().getDataStoreInstance().getData(
ZCatalystSelectQuery selectQuery)

パラメータ:

  • selectQuery: 渡すZCatalystSelectQuery型のインスタンス

ZCQLでサポートされるステートメント用のZCatalystSelectQueryselectQueryインスタンスは、以下の方法で作成できます:

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

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());
 }

最終更新日 2026-02-23 18:09:41 +0530 IST

このページについて