Partilhar via


Query

Recupera conjuntos de resultados de uma ou mais tabelas.

Aplica-se a:Marque Sim Databricks SQL Marque Sim Databricks Runtime

Sintaxe

[ 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

  • expressão de tabela comum

    Expressões de tabela comuns (CTE) são uma ou mais consultas nomeadas que podem ser reutilizadas várias vezes dentro do bloco de consulta principal para evitar cálculos repetidos ou para melhorar a legibilidade de consultas complexas aninhadas.

  • subconsulta

    Uma das várias construções que produzem um conjunto de resultados intermediário.

    • subselecionar

      Uma subconsulta que consiste em um SELECT FROM WHERE padrão.

      • VALUES

        Especificada uma tabela embutida temporária.

      • ( consulta )

        Uma invocação aninhada de uma consulta que pode conter operadores de conjunto ou expressões de tabela comuns.

      • TABLE

        Retorna a tabela ou exibição inteira.

        • table_name

          Identifica a tabela a ser retornada.

        • view_name

          Identifica o modo de exibição a ser retornado.

        Se a tabela ou exibição não puder ser encontrada, o Azure Databricks gerará um erro TABLE_OR_VIEW_NOT_FOUND.

      • DE

        Aplica-se a: marcado com sim Databricks Runtime 16.2 e versões posteriores

        Retorna a junção cruzada de todas as referências de tabela. Essa cláusula é normalmente usada como a raiz de um pipeline SQL.

        • table_reference

          Uma fonte de entrada para o SELECT. Essa referência de entrada pode ser transformada em uma referência de streaming usando a palavra-chave STREAM antes da referência.

    Uma fonte de entrada para o SELECT. Essa referência de entrada pode ser transformada em uma referência de streaming usando a palavra-chave STREAM antes da referência.

  • set_operator

    Uma construção que combina subconsultas usando UNION, EXCEPTou INTERSECT operadores.

  • ORDER BY

    Uma ordenação das linhas do conjunto de resultados completo da consulta. As linhas de saída são ordenadas entre as partições. Este parâmetro é mutuamente exclusivo com SORT BY, CLUSTER BYe DISTRIBUTE BY não pode ser especificado em conjunto.

  • DISTRIBUTE BY

    Um conjunto de expressões pelas quais as linhas de resultado são reparticionadas. Este parâmetro exclui-se mutuamente e ORDER BYCLUSTER BY não pode ser especificado em conjunto.

  • SORT BY

    Uma ordenação pela qual as linhas são ordenadas dentro de cada partição. Este parâmetro exclui-se mutuamente e ORDER BYCLUSTER BY não pode ser especificado em conjunto.

  • CLUSTER BY

    Um conjunto de expressões que é usado para reparticionar e classificar as linhas. O uso desta cláusula tem o mesmo efeito de usar DISTRIBUTE BY e SORT BY em conjunto.

  • LIMIT

    O número máximo de linhas que podem ser retornadas por uma instrução ou subconsulta. Esta cláusula é usada principalmente em conjunto com ORDER BY para produzir um resultado determinístico.

  • OFFSET

    Aplica-se a:Marque Sim Databricks SQL Marque Sim Databricks Runtime 11.3 LTS e superior

    Ignora várias linhas retornadas por uma instrução ou subconsulta. Esta cláusula é usada principalmente na conjunção com LIMIT para página através de um conjunto de resultados, e ORDER BY para produzir um resultado determinístico.

    Nota

    Ao paginar um conjunto de resultados usando LIMIT e OFFSET as linhas ignoradas ainda são processadas. Essas linhas simplesmente são suprimidas do conjunto de resultados. A paginação com esta técnica não é aconselhada para consultas que consomem muitos recursos.

  • WINDOW

    Define as especificações de janela nomeadas que podem ser compartilhadas por várias funções Window no select_query.

  • |> piped_operation

    Aplica-se a: marca de seleção sim Databricks Runtime 16.2 ou posterior

    Especifica uma operação em pipeline a ser executada no conjunto de resultados da subconsulta e das outras cláusulas anteriores.