. Operador (sinal de ponto)

  • Artigo

Aplica-se a:verificar a verificação sim do SQL do Databricks marcada como sim Databricks Runtime

Devolve um fieldIdentifier valor num STRUCT ou num valor por keyIdentifier num MAP.

Sintaxe

structExpr . fieldIdentifier

mapExpr . keyIdentifier

Argumentos

  • structExpr: uma STRUCT expressão.
  • fieldIdentifier: um identificador para o campo em structExpr.
  • mapExpr: uma MAP expressão com chaves do tipo STRING.
  • keyIdentifier: um identificador que corresponde a um valor de chave no mapExpr.

Devolve

Um tipo que corresponde ao fieldIdentifier do ou do tipo dos mapExpr valores.

A resolução de nomes tem precedência sobre a resolução deste operador. Ou seja, tendo em conta uma série de identificadores separados por pontos, o Azure Databricks resolverá o nome qualificado mais longo possível. Se o nome resolvido for um MAP ou STRUCT o Azure Databricks interpretará os identificadores restantes com o operador de sinal de ponto.

Quando utilizado com um STRUCT, o Azure Databricks verifica a existência do fieldIdentifier na estrutura quando a instrução é compilada.

Quando utilizado com um MAP, e não existe nenhuma chave que corresponda keyIdentifiera , o Azure Databricks devolve nulo. Para regressar NULL , utilize a função try_element_at.

Aviso

No Databricks Runtime, se spark.sql.ansi.enabled for false, o resultado será NULL se não for encontrada nenhuma chave correspondente para o mapExpr.

Exemplos

-- Names take precedence over the dot sign operator
> CREATE SCHEMA a;
> CREATE TABLE a.a(a struct<a INT, b STRING>);
> INSERT INTO a.a VALUES (named_struct('a', 5, 'b', 'Spark'));

-- Column `a` in table `a`
> SELECT a.a FROM a.a;
  {"a":5,"b":"Spark"}

-- Field `b` in column `a`
> SELECT a.b FROM a.a;
  Spark

-- Column `a` in table `a.a`
> SELECT a.a.a FROM a.a;
  {"a":5,"b":"Spark"}

-- Field `a` in column `a` in table `a.a`
> SELECT a.a.a.a FROM a.a;
  5

-- Resolving a map value:
> SELECT map('three', 3).three;
 3

-- Resolving a map value using the [ ] notation:
> SELECT map('three', 3)['three']
 3

-- Resolving a map value using back quotes:
> SELECT map('서울시', 'Seoul').`서울시`;
  Seoul

-- Cannot resolve a non existing key
> SELECT map('three', 3).four;
  NULL