Compartir vía

Consultar

  • Artículo

Recupera conjuntos de resultados de una o varias tablas.

Se aplica a:casilla marcada como Sí Databricks SQL casilla marcada como Sí Databricks Runtime

Sintaxis

[ common_table_expression ]
  subquery
  [ set_operator ]
  [ ORDER BY clause | { [ DISTRIBUTE BY clause ] [ SORT BY clause ] } | CLUSTER BY clause ]
  [ WINDOW clause ]
  [ LIMIT clause  ]
  [ OFFSET clause ]
  [ { |> piped_operation } [ ...] ]

subquery
{ subselect |
  VALUES clause |
  ( query ) |
  TABLE [ table_name | view_name ] |
  FROM table_reference [, ...] }

Parámetros

  • expresión de tabla común

    Las expresiones de tabla comunes (CTE) son una o varias consultas con nombre que se pueden reutilizar varias veces dentro del bloque de consultas principal para evitar cálculos repetidos o para mejorar la legibilidad de consultas anidadas complejas.

  • subquery

    Una de varias construcciones que producen un conjunto de resultados intermedio.

    • subselect

      Subconsulta que consta de un patrón SELECT FROM WHERE.

      • VALUES

        Se ha especificado una tabla temporal insertada.

      • ( query )

        Invocación anidada de una consulta que puede contener operadores de conjunto o expresiones de tabla comunes.

      • TABLE

        Devuelve toda la tabla o vista.

        • table_name

          Identifica la tabla que se va a devolver.

        • view_name

          Identifica la vista que se va a devolver.

        Si no se encuentra la tabla o vista, Azure Databricks genera un error TABLE_OR_VIEW_NOT_FOUND.

      • FROM

        Se aplica a: check marked yes Databricks Runtime 16.2 y versiones posteriores

        Devuelve la combinación cruzada de todas las referencias de tabla. Esta cláusula se usa normalmente como raíz de una canalización de SQL.

        • table_reference

          Origen de entrada para SELECT. Esta referencia de entrada se puede convertir en una referencia de streaming mediante la palabra clave STREAM antes de la referencia.

    Origen de entrada para SELECT. Esta referencia de entrada se puede convertir en una referencia de streaming mediante la palabra clave STREAM antes de la referencia.

  • set_operator

    Construcción que combina subconsultas mediante los operadores UNION, EXCEPT o INTERSECT.

  • ORDER BY

    Orden de las filas del conjunto de resultados completo de la consulta. Las filas de salida se ordenan entre las particiones. Este parámetro es mutuamente excluyente con SORT BY, CLUSTER BY y DISTRIBUTE BY, por lo que no se pueden especificar juntos.

  • DISTRIBUTE BY

    Conjunto de expresiones por las que se vuelven a particionar las filas de resultados. Este parámetro es mutuamente excluyente con ORDER BY y CLUSTER BY, por lo que no se pueden especificar juntos.

  • SORT BY

    Orden por el que se ordenan las filas dentro de cada partición. Este parámetro es mutuamente excluyente con ORDER BY y CLUSTER BY, por lo que no se pueden especificar juntos.

  • CLUSTER BY

    Conjunto de expresiones que se usa para volver a particionar y ordenar las filas. El uso de esta cláusula tiene el mismo efecto que usar DISTRIBUTE BY y SORT BY juntos.

  • LIMIT

    Número máximo de filas que puede devolver una instrucción o subconsulta. Esta cláusula se usa principalmente junto con ORDER BY para generar un resultado determinista.

  • OFFSET

    Se aplica a:casilla marcada como sí Databricks SQL casilla marcada como Sí Databricks Runtime 11.3 LTS y versiones posteriores

    Omite un número de filas devuelto por una instrucción o una subconsulta. Esta cláusula se usa principalmente en combinación con LIMIT para paginar un conjunto de resultados y ORDER BY para generar un resultado determinista.

    Nota:

    Al paginar un conjunto de resultados mediante LIMIT y OFFSET, las filas omitidas se siguen procesando. Estas filas simplemente se suprimen del conjunto de resultados. No se recomienda la paginación con esta técnica con consultas que consumen muchos recursos.

  • WINDOW

    Define las especificaciones de ventana con nombre que pueden compartir varias funciones de ventana en select_query.

  • |> piped_operation

    Se aplica a: check marked yes Databricks Runtime 16.2 y versiones posteriores

    Especifica una operación canalizada que se va a realizar en el conjunto de resultados de la subconsulta y las otras cláusulas precedentes.