---
title: "ZCQLクエリの実行"
url: https://docs.catalyst.zoho.com/ja/sdk/flutter/v2/cloud-scale/zcql/execute-zcql-query/
description: "ZCQLは、Data Storeでデータの作成、取得、および変更操作を実行できるCatalyst独自のクエリ言語です。"
last_updated: 2026-02-23T12:39:41Z
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句、その他のステートメントおよび条件を含むクエリをサポートしています。

### ZCQLクエリの実行

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

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

ここで使用される`<DATA_STORE_INSTANCE>`は、[Data Storeインスタンスページ](https://docs.catalyst.zoho.com/ja/sdk/flutter/v2/cloud-scale/data-store/create-data-store-instance)で定義されたインスタンスです。

```bash
Future<(APIResponse, List&lt;dynamic&gt;?)> ZCatalystApp.getInstance().getDataStoreInstance().getData(
ZCatalystSelectQuery selectQuery)
```

**パラメータ**:

* `selectQuery`: 渡す`ZCatalystSelectQuery`型のインスタンス

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

```bash
ZCatalystSelectQuery.Builder()
   .select(columns: Set&lt;Column&gt;): 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&lt;Column&gt;): ZCatalystSelectQuery.Builder
   .orderBy(columns: Set&lt;Column&gt;, 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クエリ実行のサンプルコードスニペットを以下に示します：

```bash
try {
      ZCQLColumn column1 = ZCQLColumn('Title');
      ZCQLColumn column2 = ZCQLColumn('Category');
      Set&lt;ZCQLColumn&gt; 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());
 }
```