---
title: "ZCQLクエリの実行"
url: https://docs.catalyst.zoho.com/ja/sdk/android/v2/cloud-scale/zcql/execute-zcql-query/
description: "ZCQLは、Data Storeでのデータ作成、取得、および変更操作を可能にするCatalyst独自のクエリ言語です。"
last_updated: 2026-03-24T12:08:39Z
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クエリの実行

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

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

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

```bash
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`インスタンスを作成できます：

```bash
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クエリ実行のサンプルコードスニペットを示します：

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

```