Referencia del lenguaje MongoSQL

Tipos de datos

Los tipos de datos de MongoSQL son el conjunto de BSON typesTodos estos tipos se pueden consultar en MongoSQL. Son:

• Cadena (STRING)

• Documento (DOCUMENT)

• Matriz (ARRAY)

• BinData (BINDATA)

• ObjectId (OBJECTID)

• Booleano (BOOL)

• Fecha (TIMESTAMP)

• Nulo (NULL)

• Expresión regular (REGEX)

• Entero de 32bits (INT)

• Doble (DOUBLE)

• Long (LONG)

• Marca de tiempo (BSON_TIMESTAMP)

• Decimales (DECIMAL)

• MinKey (MINKEY)

• Tecla máxima (MAXKEY)

• Puntero DB (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 usar para hacer referencia al tipo cuando sea necesario, como en una expresión como CAST.

Conversiones de tipos

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

Schemas

MongoSQL convierte los valores de documentos flexibles de MongoDB en tipos mediante un esquema. Un MongoSQL Unesquema es una colección de hechos sobre una expresión o colección que se sabe que son verdaderos en el momento de la compilación.

Por ejemplo, un esquema MongoSQL podría dictar que una expresión es un valor booleano o un documento con subcampos, o que una expresión es una matriz con una longitud de uno o un entero positivo.

Si no se satisface una restricción de tipo estático, la consulta no podrá compilarse.

La gestión de esquemas difiere entre la herramienta manual local y la herramienta automatizada Atlas.

SELECCIONE

SELECT Comienza cada consulta SQL de Atlas. MongoSQL permite usar SELECT VALUE y SELECT VALUES indistintamente.

MongoSQL requiere que las instrucciones anidadas SELECT tengan un alias.

SELECT foo FROM (SELECT bar FROM baz) as subSelect

SELECCIONAR DISTINTO

Utilice 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 es importante para la comparación de documentos, y tanto el orden como el valor de los elementos son importantes para la comparación de matrices.

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

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

DONDE

La cláusula WHERE filtra los datos entrantes. Su expresión debe ser estáticamente de tipo BOOL o NULL y puede evaluarse como MISSING.

AGRUPAR POR

GROUP BY Proporciona un medio para agrupar y agregar datos.

Si se GROUP BY utiliza en un campo que se ha aplanado mediante FLATTEN o UNWIND, se requiere un alias.

SELECT customerAge, COUNT(*) FROM Sales GROUP BY customer.age AS customerAge

TENIENDO

La cláusula HAVING funciona de la misma manera que una 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 ser estáticamente de tipo BOOL o NULL y puede evaluarse como MISSING. Puede hacer referencia a alias definidos en GROUP BY y contener expresiones con funciones de agregación. Solo los alias definidos en GROUP BY están disponibles para la cláusula HAVING.

ORDENAR POR

La cláusula ORDER BY permite ordenar un conjunto de resultados mediante una o más claves de ordenación. Cada clave de ordenación puede ser una referencia a una columna o un literal entero que hace referencia a una expresión SELECT por su posición en la lista de expresiones de selección. Las claves de ordenación que son referencias a columnas pueden ser identificadores compuestos. Estos identificadores compuestos pueden calificarse con nombres de fuentes de datos o hacer referencia a subcampos del documento.

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

LÍMITE y DESPLAZAMIENTO

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

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

Cuando LIMIT y OFFSET están configurados, se omitirán las OFFSET filas antes de devolver el resto de los resultados, que 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 se pueden utilizar 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 dicho carácter, debe estar delimitado, es decir, entre comillas dobles o comillas invertidas. Por ejemplo, un identificador debe estar delimitado si comienza con un dígito o si entra en conflicto con una palabra clave reservada (p. "10cent" ej.,). Los identificadores distinguen entre mayúsculas y minúsculas, estén delimitados o no.

Aliases

En MongoSQL, se utilizan identificadores para todos los alias. En la mayoría de los casos, MongoSQL devuelve un error si un alias se usa más de una vez en la misma cláusula. La excepción es que los alias pueden repetirse a 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 se pueden utilizar como identificadores no delimitados.

Literales

MongoSQL admite literales para booleanos, valores nulos, números y cadenas. Las cadenas se escriben entre comillas simples. Para incluir una comilla simple en un literal de cadena, duplíquela ('o''clock').

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

Expresiones entre paréntesis

Una expresión entre paréntesis es una expresión agrupada entre paréntesis. Siempre que haya operadores infijos, puede ser necesario usar paréntesis (o un mecanismo similar) para distinguir el orden de las operaciones. MongoSQL cuenta con varios operadores infijos, como + y ::. Por ejemplo, el valor de 1 + 2 * 3 es 7, mientras que el 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. Se puede usar una subconsulta en cualquier lugar donde se pueda usar una expresión.

MongoSQL admite subconsultas escalares y de tabla. Una subconsulta escalar devuelve un conjunto de resultados con cero o una fila y una columna. Se puede usar en la mayoría de los casos donde un valor literal o de una sola columna es válido. Una subconsulta de tabla devuelve cero o más filas y una o más columnas.

Expresiones de acceso a documentos y campos

Los documentos se pueden representar con una sintaxis similar a la de los objetos JSON. Las claves deben ser cadenas y los valores pueden tener cualquiera de los tipos admitidos. Para acceder a los campos del documento, MongoSQL admite dos opciones: notación de punto y notación de corchetes.

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

Nulo y faltante

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