---
title: "クエリの実行"
url: https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/zcql/execute-zcql-query/
description: "このページでは、Pythonアプリケーションで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 Help"
    url: /ja/cloud-scale/help/zcql/introduction
  - name: "Data Store Help"
    url: /ja/cloud-scale/help/data-store/introduction
  - name: "SDK Scopes"
    url: /ja/sdk/python/v1/sdk-scopes
---

# クエリの実行

以下のコードスニペットで使用されている`zcql_service`参照は、[以前に](https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/zcql/get-component-instance/)作成されたコンポーネントインスタンスです。渡されるクエリオブジェクトに基づいて、レスポンスは行オブジェクトまたは行オブジェクトの配列を返します。

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

プライマリData Storeで実行するZCQLクエリでは、以下に示すようにクエリオブジェクトを構築し、`execute_query()`メソッドに渡すことができます。これらのクエリには、SELECT、INSERT、UPDATE、またはDELETEステートメントを含めることができます。

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

```javascript
#ZCQLクエリを構築する
query = 'INSERT into ShipmentData (productID, productName, region) VALUES (3782, A4 Reams, India)'
result = zcql_service.execute_query(query)
```

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

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

```javascript
//Construct the query to execute 
query = 'SELECT SUM(price) FROM ShipmentData';
result = zcql_service.execute_olap_query(query);
```

**使用するパラメータ**

<table class="content-table">
	<thead>
		<tr>
			<th class="w20p">パラメータ名</th>
			<th class="w20p">データ型</th>
      <th class="w60p">定義</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>`query`</td>
			<td>String</td>
			<td>**必須**パラメータです。実行するクエリを格納します。</td>
		</tr>
	</tbody>
</table>

> **情報：** 上記の操作を実行するために必要な権限レベルを確認するには、[SDKスコープの表](https://docs.catalyst.zoho.com/ja/sdk/python/v1/sdk-scopes)を参照してください。