Compartilhar via

Expressão SQL

  • Artigo

Aplica-se a: marca de seleção positiva SQL do Databricks marca de seleção positiva Runtime do Databricks

Uma expressão é uma fórmula que calcula um resultado com base em literais ou faz referências a colunas, campos ou variáveis usando funções ou operadores.

Sintaxe

{ literal |
  named_parameter_marker |
  unnamed_parameter_marker |
  column_reference |
  field_reference |
  parameter_reference |
  CAST expression |
  CASE expression |
  expr operator expr |
  operator expr |
  expr [ expr ] |
  function_invocation |
  ( expr ) |
  ( expr, expr [, ... ] ) |
  scalar_subquery }

scalar_subquery
  ( query )

Os colchetes em expr [ expr ] são colchetes reais e não indicam sintaxe opcional.

Parâmetros

  • literal

    Um literal de um tipo descrito em Tipos de dados.

  • named_parameter_marker

    Um espaço reservado nomeado e digitado de um valor fornecido pela API que envia a instrução SQL.

  • unnamed_parameter_marker

    Um espaço reservado sem nome e digitado de um valor fornecido pela API que envia a instrução SQL.

  • column_reference

    Uma referência a uma coluna em uma tabela ou alias de coluna.

  • field_reference

    Uma referência a um campo em um tipo STRUCT.

  • parameter_reference

    Uma referência a um parâmetro de uma função SQL definida pelo usuário com o corpo da função. A referência pode usar o nome não qualificado do parâmetro ou qualificar o nome com o nome da função. Os parâmetros constituem o escopo mais externo ao resolver identificadores.

  • Expressão CAST

    Uma expressão que converte o argumento em outro tipo.

  • Expressão CASE

    Uma expressão que permite a avaliação condicional.

  • expr

    Uma expressão que é combinada a um operator ou que é um argumento de uma função.

  • operator

    Um operador unário ou binário.

  • expr [ expr ]

    Uma referência a um elemento de matriz ou uma chave de mapa.

  • function_invocation

    Uma invocação de uma função integrada ou definida pelo usuário.

    Confira function_invocation para obter detalhes.

  • ( expr )

    Precedência imposta que substitui a precedência do operador.

  • ( expr, expr [, … ] )

    Cria um struct de dois ou mais campos. Essa notação é sinônimo da função struct.

  • scalar_subquery:

    • ( query )

      Uma expressão baseada em uma consulta que deve retornar uma única coluna e, no máximo, uma linha.

As páginas de cada função e operador descrevem os tipos de dados esperados pelos respectivos parâmetros. O Azure Databricks executa a conversão implícita em tipos esperados usando regras de tipo de dados SQL. Se um operador ou função for inválido para o argumento fornecido, o Azure Databricks gerará um erro.

Consulte Resolução de variáveis, colunas, campos e parâmetros para obter mais informações sobre resolução de nomes.

Expressão de constante

Uma expressão que se baseia apenas em literais ou funções determinísticas sem argumentos. O Azure Databricks pode executar a expressão e usar a constante resultante em casos nos quais os literais são normalmente necessários.

expressão booliana

Uma expressão com resultado do tipo BOOLEAN. Às vezes, uma expressão booliana também é conhecida como condição ou predicado.

Subconsulta escalar

Uma expressão de formato ( query ). A consulta deve retornar uma tabela que tenha uma coluna e, no máximo, uma linha.

Se a consulta não retornar linhas, o resultado será NULL. Se a consulta retornar mais de uma linha, o Azure Databricks retornará um erro. Caso contrário, o resultado será o valor retornado pela consulta.

Expressão simples

Uma expressão que não contém um query, como uma subconsulta escalar ou um predicado EXISTS.

Exemplos

> SELECT 1;
  1

> SELECT (SELECT 1) + 1;
  2

> SELECT 1 + 1;
  2

> SELECT 2 * (1 + 2);
  6

> SELECT 2 * 1 + 2;
  4

> SELECT substr('Spark', 1, 2);
  Sp

> SELECT c1 + c2 FROM VALUES(1, 2) AS t(c1, c2);
  3

> SELECT a[1] FROM VALUES(array(10, 20)) AS T(a);
  20

> SELECT true;
  true

> SELECT (c1, (c2, c3)) FROM VALUES(1, 2, 3) AS T(c1, c2, c3);
  {"c1":1,"col2":{"c2":2,"c3":3}}