---
title: "ZCQLクエリの実行"
url: https://docs.catalyst.zoho.com/ja/sdk/web/v4/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クエリ](https://docs.catalyst.zoho.com/ja/cloud-scale/help/zcql/introduction/)を構築する必要があります。サンプルのSELECTクエリを以下に示します:

```javascript
//実行するクエリを作成する
var query = 'SELECT * FROM ShipmentData';

```

### クエリの実行

上記の手順で作成したクエリオブジェクトをexecuteZCQLQuery()メソッドに渡します。ここで使用されているzcqlリファレンスは、先に定義した[コンポーネントインスタンス](https://docs.catalyst.zoho.com/ja/sdk/web/v4/cloud-scale/zcql/get-component-instance)です。

これはPromiseを返し、オブジェクトに解決されます。contentキーには行オブジェクトの配列が含まれます。

```javascript
//クエリを渡して実行する
var zcql = catalyst.ZCatalystQL;
 var zcqlPromise  = zcql.executeQuery(query);
zcqlPromise
        .then((response) => {
            console.log(response.content);
        })
        .catch((err) => {
            console.log(err);
        });

```

> **Note:** コードで[ZCQL V2](https://docs.catalyst.zoho.com/ja/cloud-scale/help/zcql/syntax-exceptions/)コマンドを使用するには、[こちら](https://docs.catalyst.zoho.com/ja/sdk/web/v4/overview/#manage-environment-variables)に記載されているCatalystメソッドと以下の値を使用して、適切な環境変数を設定してください:

* **Key**: `ZOHO_CATALYST_ZCQL_PARSER`

* **Value**: `V2`

受け取るサンプルレスポンスを以下に示します。レスポンスはWeb SDKの両方のバージョンで同じです。

**Web SDK**

```json
[
  {
    AlienCity: {
      CREATORID: "2136000000006003",
      MODIFIEDTIME: "2021-08-13 13:49:19:475",
      CREATEDTIME: "2021-08-13 13:49:19:475",
      CityName: "Dallas",
      ROWID: "2136000000008508"
    }
  },
  {
    AlienCity: {
      CREATORID: "2136000000006003",
      MODIFIEDTIME: "2021-08-16 15:55:32:969",
      CREATEDTIME: "2021-08-16 15:55:32:969",
      CityName: "Houston",
      ROWID: "2136000000011002"
    }
  },
  {
    AlienCity: {
      CREATORID: "2136000000006003",
      MODIFIEDTIME: "2021-08-16 17:03:01:507",
      CREATEDTIME: "2021-08-16 16:29:10:499",
      CityName: "Austin",
      ROWID: "2136000000011011"
    }
  }
]

```