お知らせ:

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

ZCQL

ZCQLは、Data Storeでのデータ取得操作を可能にするCatalyst独自のクエリ言語です。組み込み関数、SQL Joinクローズ、およびその他のステートメントと条件を持つSELECTクエリをサポートしています。

ZCQLクエリの実行

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

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

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

パラメータ:

  • query: 渡すZCatalystSelectQuery型のインスタンスです。
  • completion: クエリ実行の呼び出しが成功した場合、completionブロックはクエリの条件に一致するレコードを返します。それ以外の場合は、エラーを返します。

ZCQLがサポートするステートメントのZCatalystSelectQueryのqueryインスタンスを以下の方法で作成できます:

copy
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

ZCQLクエリ実行のサンプルコードスニペットを以下に示します:

copy
func testExecuteZCQL(){
	  var builder = ZCatalystSelectQuery.Builder()
	  var query = builder.selectAll().from( tableName : "Bio-data" ).build() //ここにテーブル名を入力してください
			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 )" )
  	}
 	}
	}

最終更新日 2026-03-30 13:40:30 +0530 IST

このページについて