お知らせ:

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

ZCQL

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

ZCQLクエリの実行

必要なデータセットを取得するためのZCQLクエリを実行する前に、execute()メソッドに渡すクエリを構築する必要があります。ZCQL構文については、ZCQLヘルプページから学ぶことができます。

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

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

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

パラメータ:

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

ZCQLでサポートされるステートメントのZCatalystSelectQueryに対して、以下の方法でselectQueryインスタンスを作成できます:

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
val query = ZCatalystSelectQuery.Builder()
    .selectAll()
    .from("EmployeeDetails") //これをあなたのテーブル名に置き換えてください
    .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”) })

最終更新日 2026-03-24 17:38:39 +0530 IST

このページについて