---
title: "ZCQL関数"
url: https://docs.catalyst.zoho.com/ja/cloud-scale/help/zcql/zcql-functions/
description: "ZCQLは、使い慣れたクエリ言語をモデルにしたCatalyst独自のクエリ言語であり、アプリのデータベースを効率的にクエリするために使用できます。"
last_updated: 2026-02-23T12:39:41Z
service: Cloud Scale
type: general
---
# ZCQL関数
ZCQLは、データに対する迅速な算術演算を実行し、検索クエリの結果セットを要件に合わせて操作するための、数学的および分析的な組み込み関数をいくつかサポートしています。これらの関数は、出力で生成されるカラムに対して`SELECT`文で使用されます。
### MIN()
`MIN()`関数は、選択されたカラムの最小値を返します。数値データを含むカラムの最小値、またはアルファベット順で最初に来るレコードを返すために使用できます。
`SELECT`文と一緒に`MIN()`関数を使用する基本構文は以下のとおりです：
```sql
SELECT MIN(column_name) FROM base_table_name
```
**例**：
_Pricing_テーブルから最も安い映画を表示するには、以下のクエリを実行します：
```sql
SELECT MIN(Price) FROM Pricing
```
以下の出力が生成されます：
### MAX()
`MAX()`関数は、選択されたカラムの最大値を返します。数値データを含むカラムの最大値、またはアルファベット順で最後に来るレコードを返すために使用できます。
`SELECT`文と一緒に`MAX()`関数を使用する基本構文は以下のとおりです：
```sql
SELECT MAX(column_name) FROM base_table_name
```
**例**：
_Pricing_テーブルから最も高い映画を表示するには、以下のクエリを実行します：
```sql
SELECT MAX(Price) FROM Pricing
```
以下の出力が生成されます：
### COUNT()
`COUNT()`関数は、出力の特定のカラムに対して返されるレコードの行数の値を返します。`COUNT`関数も`SELECT`文と一緒に使用されます。
`SELECT`文と一緒に`COUNT()`関数を使用する基本構文は以下のとおりです：
```sql
SELECT COUNT(column_name) FROM base_table_name
```
**例：**
_Theaters_テーブルからNew York CityとAlbanyの劇場数を表示するには、以下のクエリを実行します：
```sql
SELECT COUNT(TheaterName) FROM Theaters
WHERE Location='New York City' OR Location='Albany'
```
以下の出力が生成されます：
### SUM()
`SUM()`関数は、数値カラムのレコードの合計を計算して返します。数値データを含むカラムにのみ使用できます。`SUM()`関数は、単一カラムに対して`SELECT`文と一緒に使用することもできます。
`SELECT`文と一緒に`SUM()`関数を使用する基本構文は以下のとおりです：
```sql
SELECT SUM(column_name) FROM base_table_name
```
**例**：
_Pricing_テーブルから'The First Purge'と'Hotel Transylvania 3: Summer Vacation'のチケット料金の合計を表示するには、以下のクエリを実行します：
```sql
SELECT SUM(Price) FROM Pricing
WHERE MovieID='2056' OR MovieID='2058'
```
以下の出力が生成されます：
### AVG()
`AVG()`関数は、数値カラムのレコードの平均値を計算して返します。数値データを含むカラムにのみ使用できます。`AVG()`関数は、特定のカラムのみに対して`SELECT`文と一緒に使用されます。
`AVG ()` ZCQL関数は以下のデータ型に適用できます：
- **Date**
- **DateTime**
- **Boolean**
> **注意:**
* この機能は**ZCQL V2**でのみ利用可能です。
* **2024年12月1日**より、すべての[Org](https://docs.catalyst.zoho.com/ja/getting-started/catalyst-organizations/)の[開発環境](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/development-environment/)にある現在のすべてのプロジェクトは、自動的に**ZCQL V2 Parser**にマッピングされます。
* **2025年4月1日**より、*開発環境*で**ZCQL V2 Parser**にすでにマッピングされているすべての*Org*のすべてのプロジェクトは、プロジェクトの本番環境が有効化された場合、[本番環境](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/production-environment/)で自動的に**ZCQL V2 Parser**にマッピングされます。
`SELECT`文と一緒に`AVG()`関数を使用する基本構文は以下のとおりです：
```sql
SELECT AVG(column_name) FROM base_table_name
```
**例**：
_Pricing_テーブルの映画の平均チケット価格を表示するには、以下のクエリを実行します：
```sql
SELECT AVG(Price) As AverageTicketPrice FROM Pricing
```
以下の出力が生成されます：
### DISTINCT
`DISTINCT`文は、カラムの重複しないレコード値のみを返します。カラムに重複する値がある場合、この文は重複を返しません。`DISTINCT`文は、クエリで`SELECT`文と一緒に使用されます。
`SELECT DISTINCT`文を使用する基本構文は以下のとおりです：
```sql
SELECT DISTINCT column_name(s) FROM base_table_name
```
**例**：
映画が上映されている重複しない劇場を表示するには、以下のクエリを実行します：
```sql
SELECT DISTINCT Theaters.TheaterName FROM Movies
INNER JOIN Theaters ON Movies.TheaterID=Theaters.TheaterID
```
以下の出力が生成されます：
| TheaterName |
| The Express Cinemas |
| Cosmos Theater |
| FunTime Cinemas |
### 複数ZCQL関数の使用
1つのZCQLクエリ文で同じカラムに対して複数のZCQL関数を使用できます。
**サンプルデータベース**：
Zylker Technologiesの従業員詳細は、[Data Store](https://docs.catalyst.zoho.com/ja/cloud-scale/help/data-store/introduction/)の*Zylker_Employee_DB*テーブルで管理されています。テーブルには以下のカラムと行が含まれています：
| ID |
Name |
Department |
Salary |
| ZT-001 |
Amelia Burrows |
Product Management |
15000 |
| ZT-2001 |
Bruce Wayne |
Sr. Management |
85000 |
| ZT-239 |
Clark Kane |
Media Relations |
4500 |
| ZT-4289 |
Michelle Mascarenhas |
Finance |
89000 |
次に、以下のように複数のZCQL関数をクエリに一緒に適用します：
```sql
SELECT MIN (Salary), MAX (Salary), COUNT (Salary), SUM (Salary), AVG (Salary) FROM Zylker_Employee_DB
```
| MAX(Salary) |
SUM(Salary) |
MIN(Salary) |
AVG(Salary) |
COUNT(Salary) |
| 89000 |
193500 |
4500 |
48975 |
4 |
> **注意:**
* この機能は**ZCQL V2**でのみ利用可能です。
* **2024年12月1日**より、すべての[Org](https://docs.catalyst.zoho.com/ja/getting-started/catalyst-organizations/)の[開発環境](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/development-environment/)にある現在のすべてのプロジェクトは、自動的に**ZCQL V2 Parser**にマッピングされます。
* **2025年4月1日**より、*開発環境*で**ZCQL V2 Parser**にすでにマッピングされているすべての*Org*のすべてのプロジェクトは、プロジェクトの本番環境が有効化された場合、[本番環境](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/production-environment/)で自動的に**ZCQL V2 Parser**にマッピングされます。