---
title: "ZCQLクエリの実行"
url: https://docs.catalyst.zoho.com/ja/sdk/ios/v2/cloud-scale/zcql/execute-zcql-query/
description: "ZCQLは、Data Storeでのデータの作成、取得、および変更操作を可能にするCatalyst独自のクエリ言語です。"
last_updated: 2026-03-30T08:10:30Z
service: Cloud Scale
type: general
related_links:
  - name: "Data Store"
    url: /ja/cloud-scale/help/data-store/introduction
  - name: "ZCQL"
    url: /ja/cloud-scale/help/zcql/introduction/
  - name: "Execute ZCQL - API"
    url: /ja/api/code-reference/cloud-scale/zcql/execute-zcql-query/#ExecuteZCQLQuery
---

# ZCQL

ZCQLは、[Data Store](https://docs.catalyst.zoho.com/ja/cloud-scale/help/data-store/introduction)でのデータ取得操作を可能にするCatalyst独自のクエリ言語です。組み込み関数、SQL Joinクローズ、およびその他のステートメントと条件を持つSELECTクエリをサポートしています。

### ZCQLクエリの実行

必要なデータセットを取得するためにZCQLクエリを実行する前に、`execute()`メソッドに渡すクエリを構築する必要があります。ZCQLの構文については、[ZCQLヘルプページ](https://docs.catalyst.zoho.com/ja/cloud-scale/help/zcql/introduction)から学ぶことができます。

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

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

**パラメータ**:

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

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

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

```

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

```bash
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 )" )
  	}
 	}
	}

```