--- title: "ZCQLクエリの実行" url: https://docs.catalyst.zoho.com/ja/api/code-reference/cloud-scale/zcql/execute-zcql-query/ description: "このAPIは、ZCQLクエリを実行してData Store内のテーブルからデータを取得、挿入、更新、または削除できるようにします。" last_updated: 2026-02-23T12:39:41Z service: Cloud Scale type: api --- # ZCQL [ZCQL](https://docs.catalyst.zoho.com/ja/cloud-scale/help/zcql/introduction/)は、[Catalyst Data Store](https://docs.catalyst.zoho.com/ja/cloud-scale/help/data-store/introduction/)内のテーブルに対してデータの取得、挿入、更新、および削除操作を実行できるCatalyst独自のクエリ言語です。 ZCQLを使用してさまざまなDMLクエリを実行し、データの取得や操作を行うことができます。また、SQL Join句、GroupByおよびOrderByステートメント、組み込みSQL関数などのさまざまな句やステートメントを使用できます。 # ZCQLクエリの実行 ### 説明 このAPIは、ZCQLクエリを実行してData Store内のテーブルからデータを取得、挿入、更新、または削除できるようにします。サンプルリクエストに示すように、JSONリクエストでZCQLクエリを渡してこのAPIを実行できます。 > **注意:** APIリクエスト形式は、すべてのZCQLクエリ実行操作で同じです。 ### リクエスト詳細 #### リクエストURL `POST` {api-domain}/baas/v1/project/{project_id}/query - **api-domain** (URL): Catalyst APIにアクセスするためのDC固有のドメイン - **project_id** (Numerical): プロジェクトの[一意のID](https://docs.catalyst.zoho.com/ja/getting-started/set-up-a-catalyst-project/general-settings/) #### リクエストヘッダー **Authorization:** Zoho-oauthtoken {oauth_token} **Content-Type:** application/json **オプションヘッダー** **CATALYST-ORG:** {org_id} **Environment:** Development #### スコープ ZohoCatalyst.zcql.CREATE > **注意:** この操作は、Catalyst SDKを使用してCatalystユーザー認証権限でも実行できます。詳細については、[Catalyst API前提条件セクション](https://docs.catalyst.zoho.com/ja/api/introduction/overview-and-prerequisites/#prerequisites)を参照してください。 #### リクエストJSONプロパティ - **query** (string, mandatory): 実行するZCQLクエリ ### レスポンス詳細 データ取得操作: APIは、クエリ実行の結果として取得されたレコードをレスポンスとして返します。 データ挿入および更新操作: APIは、クエリを通じて挿入または更新されたレコードをレスポンスとして返します。 データ削除操作: APIは削除された行数を返します。 **リクエスト例: データ取得** ```bash curl -X POST \ https://api.catalyst.zoho.com/baas/v1/project/4000000006007/query \ -H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57" \ -H "Content-Type: application/json" \ -d '{ "query":"SELECT EmpID, EmpName, Department, Address from EmpDetails ORDER BY EmpID ASC LIMIT 1000,5" }' ``` **レスポンス例: データ取得** ```json { "status": "success", "data": [ { "EmpDetails": { "CREATORID": "3376000000002003", "MODIFIEDTIME": "2023-06-05 15:09:33:881", "CREATEDTIME": "2023-06-05 15:09:33:881", "ROWID": "3376000001924975", "EmpID": "1001", "EmpName": "Allison Powell", "Department":"Marketing", "Address": "13, Winter Avenue, Philadelphia, PY" } }, { "EmpDetails": { "CREATORID": "3376000000002003", "MODIFIEDTIME": "2023-06-05 15:09:33:881", "CREATEDTIME": "2023-06-05 15:09:33:881", "ROWID": "3376000001927682", "EmpID": "1002", "EmpName": "James Cortez", "Department":"HR", "Address": "25, Blossom Street, Austin, TX" } }, { "EmpDetails": { "CREATORID": "3376000000002003", "MODIFIEDTIME": "2023-06-02 21:04:11:111", "CREATEDTIME": "2023-06-02 15:05:21:001", "ROWID": "3376000001224112", "EmpID": "1003", "EmpName": "Han Chan", "Department":"Sales", "Address": "112, St.Patrick's Road, Louisville, KY" } }, { "EmpDetails": { "CREATORID": "337600000003111", "MODIFIEDTIME": "2023-06-02 21:04:11:111", "CREATEDTIME": "2023-06-02 15:05:21:001", "ROWID": "3376000001242012", "EmpID": "1004", "EmpName": "Rubella Miguel", "Department":"Accounts", "Address": "333, Marine Bay, Salt Lake City, UT" } }, { "EmpDetails": { "CREATORID": "3376000000115254", "MODIFIEDTIME": "2023-04-12 21:04:10:521", "CREATEDTIME": "2023-06-11 15:05:02:541", "ROWID": "3376000001241341", "EmpID": "1005", "EmpName": "Ronwick Boseman", "Department":"Support", "Address": "61, Gringott's Avenue, Herfordshire, CO" } } ] } ``` **リクエスト例: データ挿入** ```bash curl -X POST \ https://api.catalyst.zoho.com/baas/v1/project/4000000006007/query \ -H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57 \ -H "Content-Type: application/json" \ -d '{ "query":"INSERT INTO EmpDetails VALUES (1007,'Randy Marsh','Sales','42, Tenth Street, Jacksonville, FL', '14 MAR 2017')" }' ``` **レスポンス例: データ挿入** ```json { "status": "success", "data": [ { "EmpDetails": { "CREATORID": "3813000000002003", "EmpID": "1007", "EmpName": "Randy Marsh", "Department":"Sales", "Address": "42, Tenth Street, Jacksonville, FL", "DOJ": "14 MAR 2017", "MODIFIEDTIME": "2021-08-04 09:10:14:752", "CREATEDTIME": "2021-08-04 09:10:14:752", "ROWID": "3813000000214001" } } ] } ``` **リクエスト例: データ更新** ```bash curl -X POST \ https://api.catalyst.zoho.com/baas/v1/project/4000000006007/query \ -H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57 \ -H "Content-Type: application/json" \ -d '{ "query":"UPDATE EmpDetails SET Department='Operations' WHERE EmpID=1007" }' ``` **レスポンス例: データ更新** ```json { "status": "success", "data": [ { "EmpDetails": { "CREATORID": "3813000000002003", "EmpID": "1007", "EmpName": "Randy Marsh", "Department":"Operations", "Address": "42, Tenth Street, Jacksonville, FL", "DOJ": "14 MAR 2017", "MODIFIEDTIME": "2021-08-04 09:11:54:318", "CREATEDTIME": "2021-08-04 09:10:14:752", "ROWID": "3813000000214001" } } ] } ``` **リクエスト例: データ削除** ```bash curl -X POST \ https://api.catalyst.zoho.com/baas/v1/project/4000000006007/query \ -H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57 \ -H "Content-Type: application/json" \ -d '{ "query":"DELETE FROM EmpDetails WHERE EmpID=1007" }' ``` **レスポンス例: データ削除** ```json { "status": "success", "data": [ { "EmpDetails": { "DELETED_ROWS_COUNT": 1 } } ] } ``` ### SDK Documentation [Execute ZCQL Query- Java SDK](https://docs.catalyst.zoho.com/ja/sdk/java/v1/cloud-scale/zcql/execute-zcql-query)

[Execute ZCQL Query- Node.js SDK](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/cloud-scale/zcql/execute-zcql-query)

[Execute ZCQL Query- Python SDK](https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/zcql/execute-zcql-query)

[Execute ZCQL Query- Web SDK](https://docs.catalyst.zoho.com/ja/sdk/web/v4/cloud-scale/zcql/execute-zcql-query)