---
title: "クエリの実行"
url: https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/cloud-scale/zcql/execute-zcql-query/
description: "このページでは、NodeJSアプリケーションでData Storeのテーブルに対してZCQLクエリを実行するメソッドについて、サンプルコードスニペットと共に説明します。"
last_updated: 2026-03-30T08:10:30Z
service: Cloud Scale
type: general
related_links:
  - name: "Execute query - API"
    url: /ja/api/code-reference/cloud-scale/zcql/execute-zcql-query/#ExecuteZCQLQuery
  - name: "ZCQL"
    url: /ja/cloud-scale/help/zcql/introduction
  - name: "Data Store"
    url: /ja/cloud-scale/help/data-store/introduction
---

# クエリの実行

`zcql`は[こちら](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/cloud-scale/zcql/get-component-instance)で定義されたコンポーネントインスタンスを参照します。これはPromiseを返し、オブジェクトに解決されます。`content`キーに行オブジェクトの配列が含まれます。

### プライマリData Storeでのクエリの構築と実行

プライマリData Storeで実行する[ZCQLクエリ](https://docs.catalyst.zoho.com/ja/cloud-scale/help/zcql/introduction)については、クエリを構築し、以下に示すように`executeZCQLQuery()`メソッドに渡すことができます。これらのクエリには、SELECT、INSERT、UPDATE、またはDELETEステートメントを含めることができます。

以下にサンプルのINSERTクエリを示します:

```javascript
//Construct the query to execute 
let query = 'INSERT into ShipmentData (productID, productName, region) VALUES (3782, A4 Reams, India)';
let result = await zcql.executeZCQLQuery(query);
```

### OLAPデータベースでのクエリの構築と実行

OLAPデータベースで実行するクエリは、SELECTステートメントのみを含める必要があります。直接の書き込み操作は許可されていません。クエリオブジェクトを構築し、`executeOLAPQuery()`メソッドに渡すことができます。以下にサンプルの分析SELECTクエリを示します。

```javascript
//Construct the query to execute 
let query = 'SELECT SUM(price) FROM ShipmentData';
let result = await zcql.executeOLAPQuery(query);
```