ClickHouse/docs/es/sql-reference/syntax.md
Ivan Blinkov cd14f9ebcb
SQL reference refactoring (#10857)
* split up select.md

* array-join.md basic refactoring

* distinct.md basic refactoring

* format.md basic refactoring

* from.md basic refactoring

* group-by.md basic refactoring

* having.md basic refactoring

* additional index.md refactoring

* into-outfile.md basic refactoring

* join.md basic refactoring

* limit.md basic refactoring

* limit-by.md basic refactoring

* order-by.md basic refactoring

* prewhere.md basic refactoring

* adjust operators/index.md links

* adjust sample.md links

* adjust more links

* adjust operatots links

* fix some links

* adjust aggregate function article titles

* basic refactor of remaining select clauses

* absolute paths in make_links.sh

* run make_links.sh

* remove old select.md locations

* translate docs/es

* translate docs/fr

* translate docs/fa

* remove old operators.md location

* change operators.md links

* adjust links in docs/es

* adjust links in docs/es

* minor texts adjustments

* wip

* update machine translations to use new links

* fix changelog

* es build fixes

* get rid of some select.md links

* temporary adjust ru links

* temporary adjust more ru links

* improve curly brace handling

* adjust ru as well

* fa build fix

* ru link fixes

* zh link fixes

* temporary disable part of anchor checks
2020-05-15 07:34:54 +03:00

12 KiB

machine_translated machine_translated_rev toc_priority toc_title
true 72537a2d52 31 Sintaxis

Sintaxis

Hay dos tipos de analizadores en el sistema: el analizador SQL completo (un analizador de descenso recursivo) y el analizador de formato de datos (un analizador de flujo rápido). En todos los casos, excepto el INSERT consulta, sólo se utiliza el analizador SQL completo. El INSERT consulta utiliza ambos analizadores:

INSERT INTO t VALUES (1, 'Hello, world'), (2, 'abc'), (3, 'def')

El INSERT INTO t VALUES fragmento es analizado por el analizador completo, y los datos (1, 'Hello, world'), (2, 'abc'), (3, 'def') es analizado por el analizador de flujo rápido. También puede activar el analizador completo de los datos mediante el input_format_values_interpret_expressions configuración. Cuando input_format_values_interpret_expressions = 1, ClickHouse primero intenta analizar valores con el analizador de flujo rápido. Si falla, ClickHouse intenta usar el analizador completo para los datos, tratándolo como un SQL expresion.

Los datos pueden tener cualquier formato. Cuando se recibe una consulta, el servidor no calcula más de max_query_size bytes de la solicitud en RAM (por defecto, 1 MB), y el resto se analiza la secuencia. Permite evitar problemas con grandes INSERT consulta.

Cuando se utiliza el Values formato en un INSERT consulta, puede parecer que los datos se analizan igual que las expresiones en un SELECT consulta, pero esto no es cierto. El Values formato es mucho más limitado.

El resto de este artículo cubre el analizador completo. Para obtener más información sobre los analizadores de formato, consulte Formato apartado.

Espacio

Puede haber cualquier número de símbolos de espacio entre las construcciones sintácticas (incluidos el principio y el final de una consulta). Los símbolos de espacio incluyen el espacio, tabulación, avance de línea, CR y avance de formulario.

Comentario

ClickHouse admite comentarios de estilo SQL y de estilo C. Los comentarios de estilo SQL comienzan con -- y continuar hasta el final de la línea, un espacio después -- se puede omitir. C-estilo son de /* a */y puede ser multilínea, tampoco se requieren espacios.

Palabras clave

Las palabras clave no distinguen entre mayúsculas y minúsculas cuando corresponden a:

  • Estándar SQL. Por ejemplo, SELECT, select y SeLeCt son todos válidos.
  • Implementación en algunos DBMS populares (MySQL o Postgres). Por ejemplo, DateTime es lo mismo que datetime.

Si el nombre del tipo de datos distingue entre mayúsculas y minúsculas system.data_type_families tabla.

A diferencia de SQL estándar, todas las demás palabras clave (incluidos los nombres de funciones) son minúsculas.

Las palabras clave no están reservadas; se tratan como tales solo en el contexto correspondiente. Si usted usa identificador con el mismo nombre que las palabras clave, encerrarlas en comillas dobles o backticks. Por ejemplo, la consulta SELECT "FROM" FROM table_name es válido si la tabla table_name tiene columna con el nombre "FROM".

Identificador

Los identificadores son:

  • Nombres de clúster, base de datos, tabla, partición y columna.
  • Función.
  • Tipos de datos.
  • Alias de expresión.

Los identificadores pueden ser citados o no citados. Este último es preferido.

Los identificadores no citados deben coincidir con la expresión regular ^[a-zA-Z_][0-9a-zA-Z_]*$ y no puede ser igual a Palabras clave. Ejemplos: x, _1, X_y__Z123_.

Si desea utilizar identificadores iguales a las palabras clave o si desea utilizar otros símbolos en los identificadores, cítelo con comillas dobles o retrocesos, por ejemplo, "id", `id`.

Literal

Hay numérico, cadena, compuesto, y NULL literal.

Numérico

Literal numérico, intenta ser analizado:

  • Primero, como un número firmado de 64 bits, usando el strtoull función.
  • Si no tiene éxito, como un número de 64 bits sin signo, Sistema abierto. función.
  • Si no tiene éxito, como un número de punto flotante strtod función.
  • De lo contrario, devuelve un error.

El valor literal tiene el tipo más pequeño en el que se ajusta el valor. Por ejemplo, 1 se analiza como UInt8 pero 256 se analiza como UInt16. Para obtener más información, consulte Tipos de datos.

Ejemplos: 1, 18446744073709551615, 0xDEADBEEF, 01, 0.1, 1e100, -1e-100, inf, nan.

Cadena

Solo se admiten literales de cadena entre comillas simples. Los caracteres incluidos se pueden escapar de barra invertida. Las siguientes secuencias de escape tienen un valor especial correspondiente: \b, \f, \r, \n, \t, \0, \a, \v, \xHH. En todos los demás casos, secuencias de escape en el formato \c, donde c cualquier carácter, se convierten a c. Significa que puedes usar las secuencias \'y\\. El valor tendrá el Cadena tipo.

En literales de cadena, necesitas escapar al menos ' y \. Las comillas simples se pueden escapar con las comillas simples, literales 'It\'s' y 'It''s' son iguales.

Compuesto

Las matrices se construyen con corchetes [1, 2, 3]. Nuples están construidos con paréntesis (1, 'Hello, world!', 2). Técnicamente, estos no son literales, sino expresiones con el operador de creación de matriz y el operador de creación de tuplas, respectivamente. Una matriz debe constar de al menos un elemento y una tupla debe tener al menos dos elementos. Hay un caso separado cuando aparecen tuplas en el IN cláusula de un SELECT consulta. Los resultados de la consulta pueden incluir tuplas, pero las tuplas no se pueden guardar en una base de datos (excepto las tablas con Memoria motor).

NULL

Indica que falta el valor.

Para almacenar NULL en un campo de tabla, debe ser del NULL tipo.

Dependiendo del formato de datos (entrada o salida), NULL puede tener una representación diferente. Para obtener más información, consulte la documentación de Formatos de datos.

Hay muchos matices para el procesamiento NULL. Por ejemplo, si al menos uno de los argumentos de una operación de comparación es NULL, el resultado de esta operación también es NULL. Lo mismo es cierto para la multiplicación, la suma y otras operaciones. Para obtener más información, lea la documentación de cada operación.

En las consultas, puede verificar NULL utilizando el IS NULL y IS NOT NULL operadores y las funciones relacionadas isNull y isNotNull.

Función

Las llamadas a funciones se escriben como un identificador con una lista de argumentos (posiblemente vacíos) entre corchetes redondos. A diferencia de SQL estándar, los corchetes son necesarios, incluso para una lista de argumentos vacía. Ejemplo: now(). Hay funciones regulares y agregadas (ver la sección “Aggregate functions”). Algunas funciones agregadas pueden contener dos listas de argumentos entre paréntesis. Ejemplo: quantile (0.9) (x). Estas funciones agregadas se llaman “parametric” funciones, y los argumentos en la primera lista se llaman “parameters”. La sintaxis de las funciones agregadas sin parámetros es la misma que para las funciones regulares.

Operador

Los operadores se convierten a sus funciones correspondientes durante el análisis de consultas, teniendo en cuenta su prioridad y asociatividad. Por ejemplo, la expresión 1 + 2 * 3 + 4 se transforma a plus(plus(1, multiply(2, 3)), 4).

Tipos de datos y motores de tabla de base de datos

Tipos de datos y motores de tablas en el CREATE las consultas se escriben de la misma manera que los identificadores o funciones. En otras palabras, pueden o no contener una lista de argumentos entre corchetes. Para obtener más información, consulte las secciones “Data types,” “Table engines,” y “CREATE”.

Alias de expresión

Un alias es un nombre definido por el usuario para la expresión en una consulta.

expr AS alias
  • AS — The keyword for defining aliases. You can define the alias for a table name or a column name in a SELECT cláusula sin usar el AS palabra clave.

    For example, `SELECT table_name_alias.column_name FROM table_name table_name_alias`.
    
    In the [CAST](sql_reference/functions/type_conversion_functions.md#type_conversion_function-cast) function, the `AS` keyword has another meaning. See the description of the function.
    
  • expr — Any expression supported by ClickHouse.

    For example, `SELECT column_name * 2 AS double FROM some_table`.
    
  • alias — Name for expr. Los alias deben cumplir con el identificador sintaxis.

    For example, `SELECT "table t".column_name FROM table_name AS "table t"`.
    

Notas sobre el uso

Los alias son globales para una consulta o subconsulta, y puede definir un alias en cualquier parte de una consulta para cualquier expresión. Por ejemplo, SELECT (1 AS n) + 2, n.

Los alias no son visibles en subconsultas y entre subconsultas. Por ejemplo, al ejecutar la consulta SELECT (SELECT sum(b.a) + num FROM b) - a.a AS num FROM a ClickHouse genera la excepción Unknown identifier: num.

Si se define un alias para las columnas de resultados SELECT cláusula de una subconsulta, estas columnas son visibles en la consulta externa. Por ejemplo, SELECT n + m FROM (SELECT 1 AS n, 2 AS m).

Tenga cuidado con los alias que son iguales a los nombres de columna o tabla. Consideremos el siguiente ejemplo:

CREATE TABLE t
(
    a Int,
    b Int
)
ENGINE = TinyLog()
SELECT
    argMax(a, b),
    sum(b) AS b
FROM t
Received exception from server (version 18.14.17):
Code: 184. DB::Exception: Received from localhost:9000, 127.0.0.1. DB::Exception: Aggregate function sum(b) is found inside another aggregate function in query.

En este ejemplo, declaramos tabla t con columna b. Luego, al seleccionar los datos, definimos el sum(b) AS b apodo. Como los alias son globales, ClickHouse sustituyó el literal b en la expresión argMax(a, b) con la expresión sum(b). Esta sustitución causó la excepción.

Asterisco

En un SELECT consulta, un asterisco puede reemplazar la expresión. Para obtener más información, consulte la sección “SELECT”.

Expresiones

Una expresión es una función, identificador, literal, aplicación de un operador, expresión entre paréntesis, subconsulta o asterisco. También puede contener un alias. Una lista de expresiones es una o más expresiones separadas por comas. Las funciones y los operadores, a su vez, pueden tener expresiones como argumentos.

Artículo Original