Compartilhar via


Consulta

Recupera conjuntos de resultados de uma ou mais tabelas.

Aplica-se a:marca de seleção positiva SQL do Databricks caixa de seleção marcada 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

  • common table expression

    As CTE (expressões de tabela comuns) 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 capacidade de leitura de consultas aninhadas complexas.

  • subquery

    Um dos vários constructos que produzem um conjunto de resultados intermediário.

    • subselect

      Uma subconsistência que consiste em um padrão SELECT FROM WHERE.

      • VALUES

        Especificou uma tabela temporária em linha.

      • ( query )

        Uma invocação aninhada de uma consulta que pode conter operadores definidos 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 a exibição a ser retornada.

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

      • FROM

        Aplica-se a: com marcação de verificação sim Databricks Runtime 16.2 e posterior

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

        • table_reference

          Uma fonte de entrada para 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 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

    Um constructo que combina subconsultas usando operadores UNION, EXCEPT ou INTERSECT.

  • 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. Esse parâmetro é mutuamente exclusivo para SORT BY, CLUSTER BY e DISTRIBUTE BY e não pode ser especificado junto.

  • DISTRIBUTE BY

    Um conjunto de expressões pelo qual as linhas de resultado são reparticionadas. Esse parâmetro é mutuamente exclusivo para ORDER BY e CLUSTER BY e não pode ser especificado junto.

  • SORT BY

    Uma ordenação pela qual as linhas são ordenadas em cada partição. Esse parâmetro é mutuamente exclusivo para ORDER BY e CLUSTER BY e não pode ser especificado junto.

  • CLUSTER BY

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

  • LIMIT

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

  • OFFSET

    Aplica-se a:verificação marcada como sim SQL do Databricks marca de seleção positiva Databricks Runtime 11.3 LTS e versões posteriores

    Ignora um número de linhas retornadas por uma instrução ou subconsulta. Essa cláusula é usada principalmente em conjunto com LIMIT para a página através de um conjunto de resultados e ORDER BY para produzir um resultado determinístico.

    Observação

    Ao paginar um conjunto de resultados usando LIMIT e OFFSET, as linhas ignoradas ainda são processadas. Essas linhas são suprimidas do conjunto de resultados. A paginação com essa técnica não é recomendada para consultas com uso intensivo de recursos.

  • WINDOW

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

  • |> piped_operation

    Aplica-se a: com marcação de verificação sim Databricks Runtime 16.2 e posterior

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