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.

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

1. La función ZCQL 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:

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

7. La cláusula ORDER BY ahora admite el uso de funciones de ZCQL.

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

Ejecuta el siguiente comando para listar la tabla

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

Salida:

9. Se activarán excepciones apropiadas 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 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

Tabla 2: ZylkerEmployeeRelation

Ejecuta el siguiente comando para listar la tabla

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:

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 con Binaryof(), 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:
      

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:

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.