Referencia del lenguaje MongoSQL

Tipos de datos

Los tipos de datos de MongoSQL son el conjunto de BSON types. Todos estos tipos pueden consultarse en MongoSQL. Ellos son:

• String (STRING)

• Documento (DOCUMENT)

• Arreglo (ARRAY)

• BinData (BINDATA)

• ObjectId (OBJECTID)

• Booleano (BOOL)

• Fecha (TIMESTAMP)

• Nulo (NULL)

• Regex (REGEX)

• entero de 32 bits (INT)

• double (DOUBLE)

• Long (LONG)

• Sello de tiempo (BSON_TIMESTAMP)

• Decimal (DECIMAL)

• MinKey (MINKEY)

• MaxKey (MAXKEY)

• DBPointer (DBPOINTER)

• Símbolo (SYMBOL)

• Javascript con alcance (JAVASCRIPTWITHSCOPE)

• JavaScript (JAVASCRIPT)

Cada tipo en MongoSQL tiene un nombre (entre paréntesis arriba), que es una palabra clave que se puede utilizar para referirse al tipo cuando sea necesario, como en una expresión como CAST.

Conversiones de tipo

Las conversiones de tipos explícitas se expresan a través de la función CAST o del operador ::. Todos los tipos numéricos son mutuamente comparables; MongoSQL permite operaciones entre los diversos tipos numéricos sin necesidad de convertir los operandos al mismo tipo numérico.

Schemas

MongoSQL convierte los valores flexibles de documentos de MongoDB en tipos utilizando un esquema. Un esquema de MongoSQL es un conjunto de hechos sobre una expresión o colección que se sabe que son verdaderos en tiempo de compilación.

Por ejemplo, un esquema MongoSQL puede dictar que una expresión sea un booleano o un documento con subcampos, o que una expresión sea un arreglo con una longitud de uno o un entero positivo.

Si no se cumple una restricción de tipo estático, la consulta no se compilará.

La gestión de esquemas difiere entre la herramienta manual on-premises y la herramienta automatizada Atlas.

Seleccionar

SELECT begins every Atlas SQL query. MongoSQL permite que SELECT VALUE y SELECT VALUES se utilicen de manera intercambiable.

MongoSQL requiere que las instrucciones anidadas SELECT tengan un alias.

SELECT foo FROM (SELECT bar FROM baz) as subSelect

SELECT DISTINCT

Utiliza SELECT DISTINCT para excluir filas duplicadas del conjunto de resultados. La comprobación de duplicados sigue la semántica de igualdad de MongoDB, donde el orden de los campos importa para la comparación de documentos y tanto el orden como el valor de los elementos importan para la comparación de arreglos.

SELECT DISTINCT bar FROM baz

SELECT * FROM table WHERE period_start_utc >= CAST('2023-01-01T00:00:00.000Z' AS TIMESTAMP)

de

FROM es la primera cláusula evaluada en cada query de MongoSQL.

FROM puede extraer datos de varias fuentes, incluyendo colecciones (SELECT * FROM foo), arreglos (SELECT * FROM [{'a': 1}]), uniones (SELECT * FROM a JOIN b), tablas derivadas (SELECT * FROM (SELECT a FROM foo) d) y FLATTEN y UNWIND.

DONDE

La cláusula WHERE es un filtro para los datos entrantes. Su expresión debe tener estáticamente el tipo BOOL o NULL y puede evaluarse como MISSING.

Agrupar por

GROUP BY proporciona un medio para agrupar y agregar datos.

GROUP BY Las claves pueden ser campos de nivel superior o subcampos. Si agrupa por subcampos, estos deben tener alias en la cláusula SELECT o GROUP BY. Por ejemplo, en una colección Sales, tiene documentos con la siguiente estructura:

{"customer": {"age": <Integer>}}

En este ejemplo, se pueden ejecutar las siguientes consultas para usar el subcampo age como clave de grupo:

"SELECT customerAge FROM Sales GROUP BY customer.age AS customerAge"
"SELECT customer.age as customerAge FROM Sales GROUP BY customerAge"

Aunque aplanes tus datos, los subcampos anteriores deben tener alias. Por ejemplo, en una colección Orders, tienes documentos con la siguiente estructura:

{"customer": {"address": {"city": <String>}}}

Después de aplanar la estructura, esta se convierte en {"customer_address_city": <String>}, y puede ejecutar las siguientes consultas para usar el subcampo city como clave de grupo:

"SELECT city FROM FLATTEN(orders) GROUP BY customer_address_city AS city"
"SELECT customer_address_city AS city FROM FLATTEN(orders) GROUP BY city"

TENIENDO

La cláusula HAVING funciona de la misma manera que la cláusula WHERE, pero después de la cláusula GROUP BY. Al igual que la cláusula WHERE, la cláusula HAVING toma una expresión que debe tener estáticamente el tipo BOOL o NULL y puede evaluarse a MISSING. Puede hacer referencia a alias definidos en el GROUP BY y puede contener expresiones con funciones de agregación. Solo los alias definidos en el GROUP BY están disponibles para la cláusula HAVING.

ORDER BY

La cláusula ORDER BY proporciona una forma de ordenar un conjunto de resultados por una o más claves de ordenación. Cada clave de ordenación puede ser una referencia de columna o un literal entero que se refiere a una expresión SELECT por su posición en la lista de expresiones seleccionadas. Las claves de ordenación que son referencias de columna pueden ser identificadores compuestos. Estos identificadores compuestos pueden estar calificados con nombres de fuentes de datos o hacer referencia a subcampos de documentos.

MongoSQL organiza MISSING antes de NULL, y NULL antes de todos los demás valores. La cláusula ORDER BY requiere que todos los valores posibles en una expresión de clave de clasificación puedan verificarse estáticamente para ser comparables mediante los operadores > (mayor que) y < (menor que).

LIMIT y OFFSET

Las cláusulas LIMIT y OFFSET permiten a los usuarios recuperar solo algunas de las filas devueltas por una query. Si se proporciona un número LIMIT, no se devolverá más que esa cantidad de filas. Si se proporciona un número de OFFSET, se omite esa cantidad de filas antes de devolver las filas.

Tanto LIMIT como OFFSET deben ser números enteros positivos. Usar LIMIT o OFFSET sin ORDER BY no garantiza el mismo resultado.

Cuando LIMIT y OFFSET están configurados, las OFFSET filas se omitirán antes de devolver el resto de los resultados, los cuales no deben contener más de LIMIT filas.

LIMIT i, j es una forma más corta de LIMIT i OFFSET j.

LIMIT y OFFSET puede usarse en subconsultas.

Identifiers

Los identificadores en MongoSQL se refieren a bases de datos, tablas y columnas. Los identificadores de MongoSQL admiten todos los caracteres UTF-8 excepto el carácter nulo \x00.

En MongoSQL, algunos identificadores están restringidos para evitar conflictos con caracteres que tienen otro significado semántico; para que un identificador incluya tal carácter, debe estar delimitado, es decir, rodeado de comillas dobles o acentos graves. Por ejemplo, un identificador debe estar delimitado si comienza con un dígito o si entra en conflicto con una palabra clave reservada (por ejemplo, "10cent") Los identificadores distinguen entre mayúsculas y minúsculas, ya sean delimitados o no.

Aliases

Los identificadores se utilizan para todos los alias en MongoSQL. En la mayoría de los casos, MongoSQL devuelve un error si se utiliza un alias más de una vez en la misma cláusula. La excepción a esto es que los alias pueden repetirse en ambos lados de un UNION ALL. Esto también aplica a los alias generados automáticamente.

Keywords

Las palabras clave de MongoSQL (como SELECT, FROM, JOIN, etc.) no pueden usarse como identificadores sin delimitadores.

Literales

MongoSQL admite literales para booleanos, nulos, números y cadenas de texto. Las cadenas están encerradas entre comillas simples. Para incluir un carácter de comilla simple en un literal de string, duplicalo ('o''clock').

Los enteros literales se escriben como INT cuando están dentro del rango de enteros con signo de 32bits y LONG en caso contrario. Los números literales de punto flotante o los números en notación científica tienen el tipo DOUBLE.

Expresiones entre paréntesis

Una expresión entre paréntesis es una expresión agrupada entre paréntesis. Cada vez que hay operadores infijos presentes, puede ser necesario el uso de paréntesis (u otro mecanismo similar) para distinguir el orden de las operaciones. MongoSQL tiene varios operadores infijos, como + y ::. Por ejemplo, el valor de 1 + 2 * 3 es 7, mientras que el valor de (1 + 2) * 3 es 9.

Operadores

MongoSQL admite los siguientes operadores básicos:

• +

• -

• *

• /

• ||

• <

• <=

• !=

• ==

• >

• >=

• BETWEEN

• AND

• OR

• NOT

Expresiones de subconsulta

Una subconsulta es una consulta SQL dentro de otra consulta. Puedes utilizar una subconsulta en cualquier lugar donde se pueda usar una expresión.

MongoSQL admite subconsultas escalares y subconsultas de tabla. Una subconsulta escalar devuelve un conjunto de resultados con cero o una fila y una columna. Puede usarse en la mayoría de los lugares donde se acepta un valor literal o de columna única. Una subconsulta de tabla devuelve cero o más filas y una o más columnas.

Documentos y expresiones de acceso a campos

Los documentos pueden ser representados con una sintaxis similar a la de los objetos JSON. Las claves deben ser cadenas de texto y los valores pueden tener cualquiera de los tipos soportados. Para acceder a los campos de los documentos, MongoSQL soporta dos opciones: notación de puntos y notación "corchete".

La notación de puntos es similar al acceso de campos en la agregación de MongoDB. Por ejemplo, si un documento doc contiene un campo f, entonces se utiliza la expresión doc.f para acceder al valor de ese campo. La notación de corchetes utiliza corchetes ([ y ]) alrededor de un nombre de campo para acceder al campo con ese nombre. Por ejemplo, consideremos el mismo documento descrito anteriormente: doc["f"] se utiliza para acceder al valor de ese campo.

Nulo y Ausente

BSON distingue entre NULL y MISSING. En el caso de NULL hay un campo con el valor literal NULL, mientras que en el caso de MISSING, el campo ha desaparecido.

MAP

MAP(array, function) Aplica una función a cada elemento de un array y devuelve el array transformado. MAP toma los siguientes argumentos:

• Expresión de matriz

• Expresión que especifica cómo transformar cada elemento del array.

Para referirse al elemento que procesa MAP, el segundo argumento debe usar la variable "this". Si el array está vacío, MAP devuelve un array vacío.

MAP Puede devolver un ARRAY o un NULL. Los siguientes requisitos se aplican a los argumentos:

• El primer argumento debe ser estáticamente de tipo ARRAY o NULL, y podría evaluarse como MISSING. Si el primer argumento es NULL o MISSING, MAP devuelve NULL. El tipo de los elementos del array debe cumplir con los usos de "this" en el segundo argumento.

• El segundo argumento puede ser cualquier expresión que sea semánticamente válida de forma estática. El tipo que devuelve el segundo argumento es el tipo de los elementos del array que devuelve MAP.

La siguiente consulta multiplica cada elemento del array por 2:

SELECT MAP([1, 2, 3], "this" * 2) AS doubled_values

{ '': { 'doubled_values': [2, 4, 6] } }

FILTRAR

FILTER(array, function) Aplica una condición a cada elemento de un array y devuelve un array que contiene solo los elementos para los que la condición se evalúa como true, en su orden original. FILTER toma los siguientes argumentos:

• Expresión de matriz

• Expresión que especifica la condición que se debe comprobar para cada elemento del array.

Para referirse al elemento que procesa FILTER, el segundo argumento debe usar la variable "this". Si el array está vacío, FILTER devuelve un array vacío.

FILTER Puede devolver un ARRAY o un NULL. Dado que FILTER no transforma elementos, los elementos del array que devuelve FILTER tienen el mismo tipo que los elementos del array de entrada. Los siguientes requisitos se aplican a los argumentos:

• El primer argumento debe ser estáticamente de tipo ARRAY o NULL, y podría evaluarse como MISSING. Si el primer argumento es NULL o MISSING, FILTER devuelve NULL. El tipo de los elementos del array debe cumplir con los usos de "this" en el segundo argumento.

• El segundo argumento puede ser cualquier expresión que sea semánticamente válida de forma estática y que devuelva BOOL o NULL.

La siguiente consulta conserva únicamente los elementos con valores impares del array:

SELECT FILTER([1, 2, 3], MOD("this", 2) = 1) AS odd_values

{ '': { 'odd_values': [1, 3] } }

REDUCIR

REDUCE(array, initialValue, function) Aplica una función a cada elemento de un array y combina los elementos en un único valor, comenzando con un valor inicial. REDUCE toma los siguientes argumentos:

• Expresión de matriz

• Expresión del valor inicial

• Expresión que especifica cómo combinar cada elemento del array con el resultado acumulado de los elementos anteriores.

El resultado acumulado comienza con el valor inicial. Para referirse al elemento procesado por REDUCE, el tercer argumento debe usar la variable "this". Para referirse al valor acumulado, el tercer argumento debe usar la variable "value". Si el array está vacío, REDUCE devuelve el valor inicial.

REDUCE Devuelve un valor del mismo tipo que el tercer argumento, un valor del tipo del valor inicial, o ambos. Puede ser cualquier tipo de MongoSQL, incluido NULL. Los siguientes requisitos se aplican a los argumentos:

• El primer argumento debe ser estáticamente de tipo ARRAY o NULL, y podría evaluarse como MISSING. Si el primer argumento es NULL o MISSING, REDUCE devuelve NULL. El tipo de los elementos del array debe cumplir con los usos de "this" en el tercer argumento.

• El segundo argumento debe satisfacer los usos de "value" en el tercer argumento.

• El tercer argumento puede ser cualquier expresión que sea semánticamente válida de forma estática y que satisfaga sus propios usos de "value". El tipo que devuelve el tercer argumento debe ser igual, superconjunto o subconjunto del segundo argumento. Los dos tipos pueden diferir si MongoSQL no detecta conflictos de esquema entre los usos de "value" en el tercer argumento y el tipo del segundo argumento.

La siguiente consulta suma los elementos del array, comenzando con 0:

SELECT REDUCE([1, 2, 3], 0, "value" + "this") AS summed_value

{ '': { 'summed_value': 6 } }

Argumentos de función con nombre

En lugar de una expresión, puedes pasar una función con nombre como último argumento a MAP, FILTER y REDUCE. Las funciones con nombre son una forma abreviada de expresiones que utilizan una única función u operador integrado. Por ejemplo, en lugar de MAP("array", LOWER("this")), puedes escribir MAP("array", LOWER). En lugar de REDUCE("array", 0, "value" + "this"), puedes escribir REDUCE("array", 0, +).

Puedes usar un argumento de función con nombre con cualquier operador unario o binario y con cualquier función escalar que acepte uno o dos argumentos.

Funciones adicionales de matrices

MongoSQL admite las siguientes funciones de matriz, que son alias sintácticos para usos comunes de MAP, FILTER y REDUCE: