--- title: "Funciones de ZCQL" url: https://docs.catalyst.zoho.com/es/cloud-scale/help/zcql/zcql-functions/ description: "ZCQL es el lenguaje de consulta propio de Catalyst, inspirado en lenguajes de consulta conocidos, que puedes utilizar para consultar la base de datos de tu aplicación de manera eficiente." last_updated: 2026-03-20T16:21:56Z service: Cloud Scale type: general --- # Funciones de ZCQL ZCQL admite algunas funciones matemáticas y analíticas integradas que te ayudan a realizar operaciones aritméticas rápidas sobre los datos y manipular el conjunto de resultados de una consulta de búsqueda para satisfacer tus necesidades. Estas funciones se utilizan en la sentencia `SELECT` para las columnas que se generan en la salida. ### MIN() La función `MIN()` devuelve el valor mínimo de la columna seleccionada. Puedes usarla para obtener el valor más pequeño de una columna que contiene datos numéricos o el registro que aparece primero en orden alfabético. La sintaxis básica para usar una función `MIN()` junto con la sentencia `SELECT` es: ```sql SELECT MIN(column_name) FROM base_table_name ``` **Ejemplo**: Para ver la película menos costosa de la tabla _Pricing_, ejecuta la siguiente consulta: ```sql SELECT MIN(Price) FROM Pricing ``` Esto generará la siguiente salida:
MIN(Price)
7.44
### MAX() La función `MAX()` devuelve el valor máximo de la columna seleccionada. Puedes usarla para obtener el valor más grande de una columna que contiene datos numéricos o el registro que aparece último en orden alfabético. La sintaxis básica para usar una función `MAX()` con la sentencia `SELECT` es: ```sql SELECT MAX(column_name) FROM base_table_name ``` **Ejemplo**: Para ver la película más costosa de la tabla _Pricing_, ejecuta la siguiente consulta: ```sql SELECT MAX(Price) FROM Pricing ``` Esto generará la siguiente salida:
MAX(Price)
11.50
### COUNT() La función `COUNT()` devuelve el número de filas en los registros que se obtienen para una columna particular en la salida. La función `COUNT` también se usa con la sentencia `SELECT`. La sintaxis básica para usar una función `COUNT()` con la sentencia `SELECT` es: ```sql SELECT COUNT(column_name) FROM base_table_name ``` **Ejemplo:** Para ver el número de cines en New York City y Albany de la tabla _Theaters_, ejecuta la siguiente consulta: ```sql SELECT COUNT(TheaterName) FROM Theaters WHERE Location='New York City' OR Location='Albany' ``` Esto generará la siguiente salida:
COUNT(TheaterName)
2
### SUM() La función `SUM()` calcula y devuelve la suma total de los registros de una columna numérica. Solo se puede usar para una columna que contiene datos numéricos. La función `SUM()` también se puede usar con la sentencia `SELECT` para una columna individual. La sintaxis básica para usar una función `SUM()` con la sentencia `SELECT` es: ```sql SELECT SUM(column_name) FROM base_table_name ``` **Ejemplo**: Para ver la suma total de los cargos de entradas para 'The First Purge' y 'Hotel Transylvania 3: Summer Vacation' de la tabla _Pricing_, ejecuta la siguiente consulta: ```sql SELECT SUM(Price) FROM Pricing WHERE MovieID='2056' OR MovieID='2058' ``` Esto generará la siguiente salida:
SUM(Price)
20.7
### AVG() La función `AVG()` calcula y devuelve el valor promedio de los registros de una columna numérica. Solo se puede usar para una columna que contiene datos numéricos. La función `AVG()` se utiliza junto con la sentencia `SELECT` para una columna particular únicamente. La función `AVG ()` de ZCQL se puede aplicar a los siguientes tipos de datos: - **Date** - **DateTime** - **Boolean** > **Nota:** * Esta funcionalidad solo está disponible en **ZCQL V2**. * A partir del **1 de diciembre de 2024**, todos tus proyectos actuales en todas tus [organizaciones](https://docs.catalyst.zoho.com/es/getting-started/catalyst-organizations/) presentes en el [entorno de desarrollo](https://docs.catalyst.zoho.com/es/deployment-and-billing/environments/development-environment/) se mapearán automáticamente al **ZCQL V2 Parser**. * A partir del **1 de abril de 2025**, todos los proyectos presentes en todas las *organizaciones* que ya hayan sido mapeados al **ZCQL V2 Parser** en el *entorno de desarrollo* se mapearán automáticamente al **ZCQL V2 Parser** en el [entorno de producción](https://docs.catalyst.zoho.com/es/deployment-and-billing/environments/production-environment/), si y cuando se habilite producción para el proyecto. La sintaxis básica para usar una función `AVG()` con la sentencia `SELECT` es: ```sql SELECT AVG(column_name) FROM base_table_name ``` **Ejemplo**: Para ver el precio promedio del boleto para las películas en la tabla _Pricing_, ejecuta la siguiente consulta: ```sql SELECT AVG(Price) As AverageTicketPrice FROM Pricing ``` Esto generará la siguiente salida:
AVG(Price)
9.19
### DISTINCT La sentencia `DISTINCT` devuelve solo los valores de registros distintos para una columna. Si hay valores duplicados en una columna, esta sentencia no devolverá los duplicados. La sentencia `DISTINCT` se utiliza junto con la sentencia `SELECT` en una consulta. La sintaxis básica para usar una sentencia `SELECT DISTINCT` es: ```sql SELECT DISTINCT column_name(s) FROM base_table_name ``` **Ejemplo**: Para ver los cines distintos donde se proyectan las películas, ejecuta la siguiente consulta: ```sql SELECT DISTINCT Theaters.TheaterName FROM Movies INNER JOIN Theaters ON Movies.TheaterID=Theaters.TheaterID ``` Esto generará la siguiente salida:
TheaterName
The Express Cinemas
Cosmos Theater
FunTime Cinemas
### Usar múltiples funciones de ZCQL Puedes usar múltiples funciones de ZCQL en la misma columna en una sola sentencia de consulta ZCQL. **Base de datos de ejemplo**: Los detalles de empleados de Zylker Technologies se mantienen en el [Data Store](https://docs.catalyst.zoho.com/es/cloud-scale/help/data-store/introduction/) en la tabla *Zylker_Employee_DB*. La tabla contiene las siguientes columnas y filas:
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
A continuación, aplicamos múltiples funciones de ZCQL juntas en la consulta, como se muestra a continuación: ```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
> **Nota:** * Esta funcionalidad solo está disponible en **ZCQL V2**. * A partir del **1 de diciembre de 2024**, todos tus proyectos actuales en todas tus [organizaciones](https://docs.catalyst.zoho.com/es/getting-started/catalyst-organizations/) presentes en el [entorno de desarrollo](https://docs.catalyst.zoho.com/es/deployment-and-billing/environments/development-environment/) se mapearán automáticamente al **ZCQL V2 Parser**. * A partir del **1 de abril de 2025**, todos los proyectos presentes en todas las *organizaciones* que ya hayan sido mapeados al **ZCQL V2 Parser** en el *entorno de desarrollo* se mapearán automáticamente al **ZCQL V2 Parser** en el [entorno de producción](https://docs.catalyst.zoho.com/es/deployment-and-billing/environments/production-environment/), si y cuando se habilite producción para el proyecto.