---
title: "Sintaxis y excepciones de ZCQL V2"
url: https://docs.catalyst.zoho.com/es/cloud-scale/help/zcql/syntax-exceptions/
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
---

# Sintaxis y excepciones de ZCQL V2

Catalyst ha añadido varias mejoras y actualizaciones de sintaxis para ayudarte a escribir consultas ZCQL de manera más efectiva. Estas nuevas actualizaciones de sintaxis proporcionarán funcionalidades adicionales y te permitirán realizar operaciones relacionadas con datos en el Data Store con mucha mayor facilidad.

> **Nota:**

* Para usar estas mejoras de funcionalidad, necesitarás migrar a la versión **V2**. Las actualizaciones de sintaxis no serán aplicables si las implementas mientras ejecutas comandos ZCQL en **V1**.

* 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.

Las siguientes excepciones y particularidades de sintaxis deben tenerse en cuenta al ejecutar una consulta ZCQL:

1. La función ZCQL [`AVG ()`](https://docs.catalyst.zoho.com/es/cloud-scale/help/zcql/zcql-functions/#avg) se puede aplicar a los siguientes tipos de datos:
    - **Date**
    - **DateTime**
    - **Boolean**

2. Cuando indicas un valor en tu sentencia ZCQL, indica el valor entre comillas simples.

    Por ejemplo, si necesitas obtener un nombre particular de una base de datos de empleados, escribirás el comando de la siguiente manera:

```sql
SELECT Name FROM Employee_DB WHERE name = 'Amelia'
```

3. Si una columna es de tipo de dato Boolean:
    - No se permiten valores de cadena.
    - El tipo de dato Boolean solo admitirá los siguientes valores:
        - FALSE
        - TRUE
        - NULL

4. Si estás usando un **tipo de dato Encrypted**, las siguientes funciones de ZCQL no se pueden usar en esa columna:
    - `AVG()`
    - `SUM()`
    - `MAX()`
    - `MIN()`

5. Se han añadido [excepciones apropiadas](https://docs.catalyst.zoho.com/es/cloud-scale/help/zcql/syntax-exceptions/#list-of-zcql-exceptions) cuando usas operadores comparativos como `Less Than`, `Greater Than`, `Less Than or Equal` y `Greater Than or Equal` en tipos de datos **Encrypted Text** y **Boolean**. Estas excepciones no son aplicables para los operadores `Equal` y `Not Equal`.

6. Las subconsultas ahora son compatibles en las sentencias de la cláusula `WHERE`. Puedes obtener más información sobre ellas en este [documento de ayuda](https://docs.catalyst.zoho.com/es/cloud-scale/help/zcql/where/#subqueries-in-where-clause).

7. La cláusula [`ORDER BY`](https://docs.catalyst.zoho.com/es/cloud-scale/help/zcql/groupby-orderby/#order-by-statement) ahora admite el uso de [funciones de ZCQL](https://docs.catalyst.zoho.com/es/cloud-scale/help/zcql/zcql-functions/).

8. En todas las columnas donde uses la cláusula `ORDER BY`, ahora se puede aplicar la funcionalidad `ASC` y `DESC`. También puedes aplicar `ASC` y `DESC` para columnas individuales.

**Base de datos de ejemplo**:

Considera la siguiente base de datos - **ZylkerEmployeeCompensation**

<table class="content-table">
	<thead>
		<tr>
			<th class="w50p">Name</th>
			<th class="w25p">Salary</th>
            <th class="w25p">Reimbursement</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>Michelle Mascarenhas</td>
			<td>90000</td>
            <td>10000</td>
		</tr>
        <tr>
			<td>Bruce Kyle</td>
			<td>3000000</td>
            <td>45000</td>
		</tr>
        <tr>
			<td>Clark Kane</td>
			<td>3300</td>
            <td>1500</td>
		</tr>
        <tr>
			<td>Judith Bridges</td>
			<td>4700</td>
            <td>300</td>
		</tr>
        <tr>
			<td>Devon Dreymond</td>
			<td>80000</td>
            <td>2300</td>
		</tr>
        <tr>
			<td>Ashley Kim</td>
			<td>6000</td>
            <td>200</td>
		</tr>
	</tbody>
</table>

Ejecuta el siguiente comando para listar la tabla

```sql
SELECT Salary, Reimbursement FROM ZylkerEmployeeCompensation ORDER BY Salary ASC, Reimbursement DESC
```

**Salida:** 

<table class="content-table">
	<thead>
		<tr>
			<th class="w50p">ZylkerEmployeeCompensation.Salary</th>
            <th class="w50p">ZylkerEmployeeCompensation.Reimbursement</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>3300</td>
            <td>45000</td>
		</tr>
        <tr>
			<td>4700</td>
            <td>10000</td>
		</tr>
        <tr>
			<td>6000</td>
            <td>2300</td>
		</tr>
        <tr>
			<td>80000</td>
            <td>1500</td>
		</tr>
        <tr>
			<td>90000</td>
            <td>300</td>
		</tr>
        <tr>
			<td>3000000</td>
            <td>200</td>
		</tr>
	</tbody>
</table>

9. Se activarán [excepciones apropiadas](https://docs.catalyst.zoho.com/es/cloud-scale/help/zcql/syntax-exceptions/#list-of-zcql-exceptions) en los siguientes casos:
    - Si se ha excedido el valor máximo/mínimo permitido en el tipo de dato **Integer**.
    - Si la longitud de caracteres es mayor que el valor establecido por ti en el tipo de dato **VarChar**.
    - Si el valor está fuera del rango soportado en el tipo de dato **BIGINT**.

10. Puedes escribir **cuatro** cláusulas [`JOIN`](https://docs.catalyst.zoho.com/es/cloud-scale/help/zcql/joins/) en una sola sentencia ZCQL. Sin embargo, solo puedes escribir **una** condición `JOIN` para cada cláusula de join.

11. La funcionalidad de **alias de tabla** ahora es compatible en ZCQL. Ahora puedes invocar la funcionalidad de alias en ZCQL usando el comando `AS` de ZCQL. Con este comando puedes referirte a tu tabla con otros nombres.

**Base de datos de ejemplo**:

Considera las siguientes bases de datos:

**Tabla 1: ZylkerEmployeeCompensation**

<table class="content-table">
	<thead>
		<tr>
			<th class="w50p">Name</th>
			<th class="w25p">Salary</th>
            <th class="w25p">Reimbursement</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>Michelle Mascarenhas</td>
			<td>90000</td>
            <td>10000</td>
		</tr>
        <tr>
			<td>Bruce Kyle</td>
			<td>3000000</td>
            <td>45000</td>
		</tr>
        <tr>
			<td>Clark Kane</td>
			<td>3300</td>
            <td>1500</td>
		</tr>
        <tr>
			<td>Judith Bridges</td>
			<td>4700</td>
            <td>300</td>
		</tr>
        <tr>
			<td>Devon Dreymond</td>
			<td>80000</td>
            <td>2300</td>
		</tr>
        <tr>
			<td>Ashley Kim</td>
			<td>6000</td>
            <td>200</td>
		</tr>
	</tbody>
</table>

**Tabla 2: ZylkerEmployeeRelation**

<table class="content-table">
	<thead>
		<tr>
			<th class="w50p">Manager</th>
			<th class="w50p">Member</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>Michelle Mascarenhas</td>
			<td>Bruce Kyle</td>
		</tr>
        <tr>
			<td>Michelle Mascarenhas</td>
			<td>Clark Kane</td>
		</tr>
        <tr>
			<td>Judith Bridges</td>
			<td>Michelle Mascarenhas</td>
		</tr>
	</tbody>
</table>

Ejecuta el siguiente comando para listar la tabla

```sql
SELECT Managers.Name, Members.Name FROM ZylkerEmployeeCompensation AS Managers
INNER JOIN ZylkerEmployeeRelation AS asso ON Managers.ROWID = asso.Manager
INNER JOIN ZylkerEmployeeCompensation AS Members ON Members.ROWID = asso.Member
```

**Salida:** 

<table class="content-table">
	<thead>
		<tr>
			<th class="w50p">Manager.Name</th>
			<th class="w50p">Member.Name</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>Michelle Mascarenhas</td>
			<td>Bruce Kyle</td>
		</tr>
        <tr>
			<td>Michelle Mascarenhas</td>
			<td>Clark Kane</td>
		</tr>
        <tr>
			<td>Judith Bridges</td>
			<td>Michelle Mascarenhas</td>
		</tr>
	</tbody>
</table>

> **Nota:** La operación de alias de tabla solo es compatible con sentencias `SELECT`.

12. Puedes verificar si tienes un valor NULL usando el operador **IS/IS NOT**. La compatibilidad del operador **IS/IS NOT** solo está disponible para valores NULL.

13. Al escribir sentencias [`GROUP BY`](https://docs.catalyst.zoho.com/es/cloud-scale/help/zcql/groupby-orderby/) con [`Binaryof()`](https://docs.catalyst.zoho.com/es/cloud-scale/help/zcql/groupby-orderby/#binaryof-function), se deben recordar las siguientes reglas de ZCQL:
    - La funcionalidad Binaryof() solo se puede usar en sentencias GROUP BY.
    - Binaryof() solo se puede usar en columnas con tipo de dato VarChar o Text.
    - Cuando se usa Binaryof() en una sentencia GROUP BY, los valores devueltos distinguen entre mayúsculas y minúsculas. Por ejemplo, considera que tienes los valores 'AMELIA', 'amelia', 'Burrows' y 'burrows' en una columna llamada Name, en una tabla llamada Zylker_EMP. Si usas el siguiente comando:

```sql
Select Name from Zylker_EMP group by binaryof(Name)
```

El resultado podría ser cualquiera de los siguientes:

- AMELIA
- amelia
- burrows
- Burrows

14. Los nombres de columnas ahora pueden contener valores numéricos. Puedes indicar dichos nombres de columna en la consulta usando la puntuación de acento grave (**`**). 

Por ejemplo, una consulta `SELECT` en una tabla llamada Numbers con una columna llamada 01 se puede escribir de la siguiente manera:

```sql
SELECT `01` FROM Numbers
```

### Lista de excepciones de ZCQL

La siguiente es una lista de excepciones comunes y sentencias de consulta de ejemplo que pueden activar estas excepciones. Asegúrate de revisar la lista y seguir estrictamente la sintaxis de ZCQL para evitar activar estas excepciones.

<table class="content-table">
<thead>
  <tr>
    <th class="w15p">Tipo de dato</th>
    <th class="w20p">Caso</th>
    <th class="w25p">Consulta ZCQL de ejemplo</th>
    <th class="w40p">Excepción activada</th>
  </tr>
</thead>
<tbody>
  <tr>
    <td rowspan="5"><strong>Encrypted Text</strong></td>
    <td>Ciertos operadores no son compatibles</td>
    <td>SELECT * FROM temp WHERE enc > 'temsp'</td>
    <td>`Operator > is not supported for
ENCRYPTED TEXT`

La misma excepción se aplica, pero el mensaje de excepción se modificará en consecuencia si usas estos operadores **<**, **<=**, **>=** en la sentencia ZCQL</td>
  </tr>
  <tr>
    <td>`LIKE` no es compatible</td>
    <td>SELECT  * FROM temp WHERE enc LIKE '*temsp'</td>
    <td>`Operator LIKE is not supported for
ENCRYPTED TEXT`

La misma excepción se aplica, pero el mensaje de excepción se modificará en consecuencia si usas **NOT LIKE** en la sentencia ZCQL</td>
  </tr>
  <tr>
    <td>`BETWEEN` no es compatible</td>
    <td>SELECT * FROM temp WHERE enc BETWEEN 'one' AND 'ten'</td>
    <td>`Operator BETWEEN is not supported for
ENCRYPTED TEXT`

La misma excepción se aplica, pero el mensaje de excepción se modificará en consecuencia si usas **NOT BETWEEN** en la sentencia ZCQL</td>
  </tr>
  <tr>
    <td>`IN` no es compatible</td>
    <td>SELECT * FROM temp WHERE enc IN ('one','three')</td>
    <td>`Operator IN is not supported for
ENCRYPTED TEXT`
    
La misma excepción se aplica si usas **NOT IN** en tu consulta, pero el mensaje de excepción se modificará en consecuencia</td>
  </tr>
    <tr>
    <td>Las funciones de ZCQL no son compatibles</td>
    <td>SELECT AVG(enc) FROM temp</td>
    <td>`AVG() function is not supported for
ENCRYPTED_TEXT`
    
Las [funciones de ZCQL](https://docs.catalyst.zoho.com/es/cloud-scale/help/zcql/zcql-functions/) no son compatibles con **Encrypted Text**.</td>
  </tr>
  <tr>
    <td rowspan="4"><strong>Boolean</strong></td>
    <td>Ciertos operadores no son compatibles</td>
    <td>SELECT * FROM temp WHERE bools > FALSE</td>
    <td>`Operator > is not supported for BOOLEAN`

La misma excepción se aplica, pero el mensaje de excepción se modificará en consecuencia si usas estos operadores **<**, **<=**, **>=** en la sentencia ZCQL</td>
  </tr>
  <tr>
    <td>`LIKE` no es compatible</td>
    <td>SELECT * FROM temp WHERE bools LIKE FALSE</td>
    <td>`Operator LIKE is not supported for BOOLEAN`

La misma excepción se aplica si usas **NOT LIKE** en tu consulta, pero el mensaje de excepción se modificará en consecuencia</td>
    </tr>
    <tr>
        <td>`BETWEEN` no es compatible</td>
        <td>SELECT * FROM temp WHERE bools BETWEEN TRUE and FALSE</td>
        <td>`Operator BETWEEN is not supported for
BOOLEAN`

La misma excepción se aplica si usas **NOT BETWEEN** en tu consulta, pero el mensaje de excepción se modificará en consecuencia</td>
    </tr>
    <tr>
        <td>`IN` no es compatible</td>
        <td>SELECT * FROM temp WHERE bools IN (TRUE, FALSE)</td>
        <td>`Operator IN is not supported for BOOLEAN`

La misma excepción se aplica si usas **NOT IN** en tu consulta, pero el mensaje de excepción se modificará en consecuencia</td>
    </tr>
    <tr>
        <td rowspan="1"><strong>VarChar</strong></td>
        <td>Longitud máxima excedida</td>
        <td>INSERT INTO temp (Fishes) value ('salmon')</td>
        <td>`'salmon' data too long for column 'Fishes'`

La columna `Fishes` fue creada como **VarChar** y el **MaxLength** se estableció en `5`. En esta sentencia, `'Salmon'` excede el **MaxLength**</td>
    </tr>
    <tr>
        <td rowspan="1"><strong>Integer</strong></td>
        <td>Valor máximo excedido</td>
        <td>INSERT INTO temp (numbers) VALUE (546895326908)</td>
        <td>`For column 'ints' INT value should be between
-9999999999 and 9999999999`

La columna numbers fue creada como **INT**. El valor del tipo de dato **INT** debe estar entre `-9999999999` y `9999999999`</td>
    </tr>
    <tr>
        <td rowspan="1"><strong>Big Integer</strong></td>
        <td>Valor máximo excedido</td>
        <td>INSERT INTO temp (numbers) VALUE (92343432412351
435123453245)</td>
        <td>`Given numeric value 92343432412351
435123453 is too large`

La columna numbers fue creada como **BIGINT**. El valor del tipo de dato **BIGINT** debe estar entre `-9223372036854775808` y `9223372036854775807`</td>
    </tr>
    <tr>
        <td rowspan="1"><strong>Text</strong></td>
        <td>Valor no encerrado entre comillas simples</td>
        <td>SELECT * FROM temp WHERE name = one</td>
        <td>`Unknown Table temp or Unknown Column
one in WHERE`

El valor `one` se considerará como columna si no está encerrado entre comillas: '`one`'</td>
    </tr>
</tbody>
</table>