Partilhar via


Funções incorporadas

Aplica-se a:seleção marcada sim Databricks SQL seleção marcada sim Databricks Runtime

Este artigo apresenta links e descrições de operadores e funções incorporados para cadeias de caracteres e tipos binários, escalares numéricos, agregações, janelas, matrizes, mapas, datas e timestamps, conversão, dados CSV, dados JSON, manipulação XPath e outras funções diversas.

Para casos de uso que não são suportados por funções internas existentes, considere definir uma função personalizada. Consulte O que são funções definidas pelo usuário (UDFs)?.

Veja também:

Operadores e predicados

Para obter informações sobre como os operadores são analisados uns em relação aos outros, consulte Precedência de Operadores.

Operador Sintaxe Descrição
& expr1 & expr2 Devolve o bit a AND bit de expr1 e expr2.
e expr1 and expr2 Devolve a lógica AND de expr1 e expr2.
* multiplier * multiplicand Retorna multiplier multiplicado por multiplicand.
!= expr1 != expr2 Retorna true se expr1 não for igual a expr2, ou false de outra forma.
! !expr Retorna a lógica NOT de uma expressão booleana.
entre expr1 [not] between expr2 and expr2 Testa se expr1 é maior ou igual e expr2 menor ou igual a expr3.
[] arrayExpr [ indexExpr ] Retorna indexExpro elemento nd de ARRAYarrayExpr.
[] mapExpr [ keyExpr ] Devolve o valor em keyExpr de MAPmapExpr.
^ expr1 ^ expr2 Devolve o exclusivo OR (XOR) bitwise de expr1 e expr2.
: jsonStr : jsonPath Devolve campos extraídos do jsonStrficheiro .
:: expr :: type Converte o valor expr para o tipo typede dados de destino.
?:: expr ?:: type Converte o valor expr para o tipo type de dados de destino, se possível, retorna NULL caso contrário.
div dividend div divisor Devolve a parte integral da divisão de dividend por divisor.
. mapExpr . keyIdentifier Retorna um MAP valor através de keyIdentifier.
. structExpr . fieldIdentifier Devolve um STRUCT campo através de fieldIdentifier.
== expr1 == expr2 Retorna true se expr1 for igual a expr2, ou false de outra forma.
= expr1 = expr2 Retorna true se expr1 for igual a expr2, ou false de outra forma.
>= expr1 >= expr2 Devolve true se expr1 for maior ou igual a expr2, ou false de outra forma.
> expr1 > expr2 Retorna true se expr1 for maior que expr2, ou false de outra forma.
existe exists(query) Retorna verdadeiro se query retornar pelo menos uma linha, ou falso caso contrário.
ilike str [not] ilike (pattern[ESCAPE escape]) Retorna verdadeiro se str (não) corresponder a pattern sem diferenciar maiúsculas de minúsculas.
ilike str [not] ilike {ANY\|SOME\|ALL}([pattern[, ...]]) Retorna verdadeiro se str (não) corresponder a qualquer/todos os padrões, sem diferenciar maiúsculas de minúsculas.
em elem [not] in (expr1[, ...]) Devolve true se elem (não) for igual a qualquer exprN.
em elem [not] in (query) Devolve true se elem (não) for igual a qualquer linha em query.
é distinta expr1 is [not] distinct from expr2 Testa se os argumentos (não) têm valores diferentes onde NULLs são considerados como valores comparáveis.
é falso expr is [not] false Testa se expr é (não) false.
é nulo expr is [not] null Devolve true se expr for (não) NULL.
é verdade expr is [not] true Testa se expr é (não) true.
como str [not] like (pattern[ESCAPE escape]) Retorna verdadeiro se str (não) corresponder a pattern com escape.
como str [not] like {ANY\|SOME\|ALL}([pattern[, ...]]) Retorna verdadeiro se str (não) corresponder a algum/todos os padrões.
<=> expr1 <=> expr2 Retorna o mesmo resultado que o EQUAL(=) para operandos não nulos, mas retorna true se ambos forem NULL, false se um deles for NULL.
<= expr1 <= expr2 Devolve true se expr1 for inferior ou igual a expr2, ou false de outra forma.
<> expr1 <> expr2 Retorna true se expr1 não for igual a expr2, ou false de outra forma.
< expr1 < expr2 Devolve true se expr1 for inferior a expr2, ou false caso contrário.
- expr1 - expr2 Devolve a subtração de expr2 de expr1.
não not expr Retorna a lógica NOT de uma expressão booleana.
ou expr1 or expr2 Devolve a lógica OR de expr1 e expr2.
% dividend % divisor Devolve o restante após dividend / divisor.
|| expr1 \|\| expr2 Devolve a concatenação de expr1 e expr2.
| expr1 \| expr2 Devolve o bit a OR bit de expr1 e expr2.
+ expr1 + expr2 Devolve a soma de expr1 e expr2.
Regexp str [not] regexp regex Retorna verdadeiro se str não corresponder a regex.
regexp_like str [not] regexp_like regex Retorna verdadeiro se str não corresponder a regex.
rlike str [not] rlike regex Retorna verdadeiro se str não corresponder a regex.
/ dividend / divisor Retorna dividend dividido por divisor.
~ ~ expr Retorna o resultado bit a bit de NOT em expr.

Precedência dos operadores

Precedência Operador
1 :, ::, ?::, [ ]
2 -(unário), +(unário), ~
3 *, /, %, div
4 +, -, \|\|
5 &
6 ^
7 \|
8 =, ==, <=>, , <>, !=<, <=, >,>=
9 not, exists
10 between, in, rlike, regexpilike, like, is [not] [NULL, true, false], is [not] distinct from
11 and
12 or

Funções binárias e de cadeia de caracteres

Função Descrição
expr1 || EXPR2 Devolve a concatenação de expr1 e expr2.
aes_decrypt(expr, key[, mode[, padding[, aad]]]) Desencripta um binário expr usando encriptação AES.
aes_encrypt(expr, key[, mode[, padding[, iv[, aad]]]]) Criptografa um binário expr usando criptografia AES.
ASCII(STR) Retorna o ponto de código ASCII do primeiro caractere de str.
base64(expr) Converte expr em uma cadeia de caracteres codificada em base 64.
bin(expr) Devolve a representação binária de expr.
binário(expr) Converte o valor de expr para BINARY.
bit_length(expr) Retorna o tamanho em bits dos dados de cadeia de caracteres ou o número de bits dos dados binários.
bitmap_count(expr) Retorna o número de bits definidos em uma BINARY cadeia de caracteres que representa um bitmap.
btrim(str [, trimStr]) Retorna str com caracteres no início e no fim removidos.
char (expr) Retorna o caractere no ponto de código UTF-16 fornecido.
char_length(expr) Retorna o comprimento do caractere dos dados da cadeia de caracteres ou o número de bytes dos dados binários.
character_length(expr) Retorna o comprimento do caractere dos dados da cadeia de caracteres ou o número de bytes dos dados binários.
charindex(substr, str[, pos]) Devolve a posição da primeira ocorrência de substr em str após a posição pos.
chr(expr) Retorna o caractere no ponto de código UTF-16 fornecido.
strExpr agrupar agrupamentoNome Anexa um agrupamento explícito collationName a strExpr.
agrupamento [para] (strExpr) Devolve a ordenação anexada a strExpr.
Concat(expr1, expr2[, ...]) Devolve a concatenação dos argumentos.
concat_ws(sep[, expr1[, ...]]) Retorna as cadeias de caracteres de concatenação separadas por sep.
contém(expr, subExpr) Devolve true se exprSTRING, ou BINARY contém subExpr.
CRC32 (EXPR) Devolve um valor de verificação de redundância cíclica de expr.
decodificar (expr, charSet) Traduz o binário expr para uma cadeia de caracteres usando a codificação do conjunto de caracteres charSet.
codificar(expr, charSet) Retorna a representação binária de uma cadeia de caracteres usando a codificação de charSet caracteres.
endswith(expr, endExpr) Retorna true se exprSTRING ou BINARY termina com endExpr.
find_in_set(searchExpr, sourceExpr) Retorna a posição de uma cadeia de caracteres dentro de uma lista de cadeias de caracteres separadas por vírgula.
format_number(expr, escala) Formata expr como #,###,###.##, arredondado para scale casas decimais.
format_number(EXPR, FMT) Formatos expr como fmt.
format_string(strfmt[, obj1 [, ...]]) Retorna uma cadeia de caracteres formatada a partir de formatos estilo printf.
hex (expr) Converte expr em hexadecimal.
str ilike (padrão[ESCAPE escape]) Retorna verdadeiro se str corresponder a pattern com escape sem diferenciar maiúsculas de minúsculas.
initcap(expr) Retorna expr com a primeira letra de cada palavra em maiúsculas.
instr(str, substr) Devolve o índice (baseado em 1) da primeira ocorrência de substr in str.
lcase (expr) Retorna expr com todos os caracteres alterados para minúsculas.
esquerda(str, len) Devolve os len primeiros caracteres de str.
len (expr) Retorna o comprimento do caractere dos dados da cadeia de caracteres ou o número de bytes dos dados binários.
comprimento (expr) Retorna o comprimento do caractere dos dados da cadeia de caracteres ou o número de bytes dos dados binários.
Levenshtein(Str1, Str2) Devolve a distância de Levenshtein entre as cadeias str1 e str2.
str LIKE (pattern[ESCAPE escape]) Retorna verdadeiro se str corresponder a pattern com escape.
localizar(substr, str[, pos]) Devolve a posição da primeira ocorrência de substr em str após a posição pos.
inferior (expr) Retorna expr com todos os caracteres alterados para minúsculas.
LPAD(EXPR, LEN[, PAD]) Retorna expr, preenchido à esquerda com pad até um comprimento de len.
ltrim([trimstr,] str) Retorna str com os caracteres iniciais do trimStr removidos.
máscara(str[, upperChar[, lowerChar[, digitChar[, otherChar]]]) Retorna uma versão mascarada da entrada str.
MD5 (EXPR) Retorna uma soma de verificação MD5 de 128 bits de expr como uma cadeia hexadecimal.
octet_length(expr) Retorna o comprimento de byte de dados de cadeia de caracteres ou o número de bytes de dados binários.
sobreposição (entrada COLOCANDO substituir FROM pos [FOR len]) Substitui input por replace que começa em pos e é de comprimento len.
sobreposição (entrada COLOCANDO substituir FROM pos [FOR len]) Substitui input por replace que começa em pos e é de comprimento len.
parse_url(url, partToExtract[, chave]) Extrai uma parte de url.
posição(substr, str[, pos]) Devolve a posição da primeira ocorrência de substr em str após a posição pos.
posição (subtr IN str) Devolve a posição da primeira ocorrência de substr em str após a posição pos.
printf(strfmt[, obj1 [, ...]]) Retorna uma cadeia de caracteres formatada a partir de formatos estilo printf.
randstr(comprimento) Retorna uma sequência aleatória de length caracteres alfanuméricos.
str regexp regex | Retorna verdadeiro se str corresponder a regex.
str regexp_like regex Retorna verdadeiro se str corresponder a regex.
regexp_count(str, regexp) Devolve o número de vezes str que corresponde ao regexp padrão.
regexp_extract(str, regexp[, idx]) Extrai a primeira cadeia de caracteres em str que corresponde à expressão regexp e ao índice de grupo regex.
regexp_extract_all(str, regexp[, idx]) Extrai todas as cadeias de caracteres em str que correspondem à expressão regexp e ao índice do grupo regex.
regexp_instr(str, regexp) Devolve a posição da primeira subcadeia de caracteres em str que corresponde a regexp.
regexp_replace(str, regexp, rep[, posição]) Substitui todas as substrings de str que correspondam a regexp por rep.
regexp_substr(str, regexp) Retorna a primeira substring em str que corresponde a regexp.
repetir(expr, n) Retorna a cadeia de caracteres que repete exprn vezes.
replace(str, search [, substituir]) Substitui todas as ocorrências de search por replace.
reverso (expr) Retorna uma cadeia de caracteres invertida ou uma matriz com ordem inversa de elementos.
direita(str, len) Retorna os últimos len caracteres da cadeia de caracteres str.
str rlike regex | Retorna verdadeiro se str corresponder a regex.
rpad(expr, len[, pad]) Retorna expr, preenchido à direita com pad até um comprimento de len.
rtrim([trimStr,] str) Retorna str com caracteres finais removidos.
frases(str[, lang, country]) Divide str em matrizes de matrizes de palavras.
SHA (EXPR) Retorna um valor de hash sha1 como uma cadeia de caracteres hexadecimal de expr.
SHA1(EXPR) Retorna um valor de hash sha1 como uma cadeia de caracteres hexadecimal de expr.
sha2(expr, bitLength) Retorna uma soma de verificação da família SHA-2 como uma cadeia de caracteres hexadecimal de expr.
Soundex(EXPR) Retorna o código soundex da cadeia de caracteres.
espaço(n) Retorna uma cadeia de n caracteres que consiste em espaços.
split(str, regex[, limite]) Divide str em torno de ocorrências que correspondam a regex e devolve um array com um comprimento máximo de limit.
split_part(str, delim, partNum) Divide str nas ocorrências de delim e devolve a parte partNum.
startswith(expr, startExpr) Retorna true se exprSTRING ou BINARY começa com startExpr.
string(expr) Converte o valor expr em STRING.
substr(expr, pos[, len]) Retorna a substring de expr que começa em pos e é de comprimento len.
substr(expr FROM pos[ FOR len]) Retorna a substring de expr que começa em pos e é de comprimento len.
substring(expr, pos[, len]) Retorna a substring de expr que começa em pos e é de comprimento len.
substring(expr FROM pos[ FOR len]) Retorna a substring de expr que começa em pos e é de comprimento len.
substring_index(expr, delim, count) Retorna a substring de expr antes de count ocorrências do delimitador delim.
to_binary(expr[, fmt]) Retorna expr convertido para um binário com base em fmt.
to_char(numExpr, fmt) Retorna numExpr convertido para STRING utilizando a formatação fmt.
to_varchar(numExpr, fmt) (convertendo numExpr em varchar usando fmt) Retorna numExpr convertido para STRING utilizando a formatação fmt.
traduzir(expr, de, para) Retorna um expr onde todos os caracteres em from foram substituídos pelos de to.
trim([[AMBOS | LIDERANÇA | TRAILING] [trimStr] DE] str) Cortar caracteres de uma cadeia de caracteres.
try_aes_decrypt(expr, key[, mode[, padding[, aad]]]) Descriptografa um binário expr usando criptografia AES e retorna NULL em caso de erro.
try_to_binary(expr [, fmt]) Tenta converter para binário. Retorna expr convertido para o tipo BINARY com base em fmt, ou NULL se a entrada for inválida.
try_url_decode(str) Traduz uma cadeia de caracteres do formato application/x-www-form-urlencoded de volta e devolve NULL se ocorrer um erro.
try_zstd_decompress(valor) Retorna o valor descompactado utilizando a compressão Zstandard ou NULL se a entrada for inválida.
ucase (expr) Retorna expr com todos os caracteres alterados para maiúsculas.
UNBASE64(EXPR) Retorna uma cadeia de caracteres base64 decodificada como binária.
unhex(expr) Converte hexadecimal expr em BINARY.
superior (expr) Retorna expr com todos os caracteres alterados para maiúsculas.
url_decode(str) Traduz uma cadeia de caracteres de volta do formato application/x-www-form-urlencoded .
url_encode(str) Traduz uma string para o formato application/x-www-form-urlencoded.
zstd_compress (valor[,nível[,modo_de_transmissão]]) Retorna o valor compactado com a compactação Zstandard.
zstd_decompress(valor) Retorna o valor descompactado com o método de compressão Zstandard.

Funções escalares numéricas

Função Descrição
~ EXPR Retorna o resultado bit a bit de NOT em expr.
dividendo / divisor Retorna dividend dividido por divisor.
expr1 | EXPR2 Devolve o bit a OR bit de expr1 e expr2.
- EXPR Devolve o valor negado de expr.
EXPR1 - EXPR2 Devolve a subtração de expr2 de expr1.
+ EXPR Devolve o valor de expr.
expr1 + expr2 Devolve a soma de expr1 e expr2.
dividendo % divisor Devolve o restante após dividend / divisor.
expr1 ^ expr2 Devolve o exclusivo OR (XOR) bitwise de expr1 e expr2.
expr1 & expr2 Devolve o bit a AND bit de expr1 e expr2.
multiplicador * multiplicando Retorna multiplier multiplicado por multiplicand.
abs(expr) Devolve o valor absoluto do valor numérico em expr.
ACOS (EXPR) Devolve o cosseno inverso (arccosina) de expr.
acosh (expr) Retorna o cosseno hiperbólico inverso de expr.
Asin (EXPR) Devolve o seno inverso (arcsina) de expr.
Asinh (EXPR) Devolve o seno hiperbólico inverso de expr.
Atan (EXPR) Devolve a tangente inversa (arco-tangente) de expr.
atan2(exprY, exprX) Devolve o ângulo em radianos entre o eixo x positivo de um plano e o ponto especificado pelas coordenadas (exprX, exprY).
atanh(expr) Devolve a tangente hiperbólica inversa de expr.
bigint(expr) Converte o valor expr em BIGINT.
bit_count(expr) Retorna o número de bits definidos no argumento.
bit_get(expr, pos) Devolve o valor de um bit numa representação binária de um numérico integral.
bit_reverse(expr) Retorna o valor obtido invertendo a ordem dos bits no argumento.
bitmap_bit_position(expr) Retorna a posição de bit 0 de um determinado BIGINT número dentro de um bucket.
bitmap_bucket_number(expr) Retorna o número do bucket de bitmap para um número BIGINT específico.
bround(expr[,targetScale]) Retorna o valor arredondado expr utilizando o modo de arredondamento HALF_EVEN.
CBRT(EXPR) Retorna a raiz cúbica de expr.
ceil(expr[,targetScale]) Devolve o menor número que não seja inferior a expr, arredondado para cima em relação ao número de targetScale algarismos após a vírgula decimal.
teto(expr[,targetScale]) Devolve o menor número que não seja inferior a expr, arredondado para cima em relação ao número de targetScale algarismos após a vírgula decimal.
conv(num, fromBase, toBase) Converte num de fromBase para toBase.
convert_timezone([sourceTz, ]targetTz, sourceTs) Converte o TIMESTAMP_NTZsourceTs do fuso horário sourceTz para targetTz.
cos(expr) Devolve o cosseno de expr.
Cosh (EXPR) Retorna o cosseno hiperbólico de expr.
cotg(expr) Devolve a cotangente de expr.
csc (expr) Devolve a cossecante de expr.
decimal(expr) Converte o valor expr em DECIMAL.
graus(expr) Converte radianos em graus.
divisor div dividendo Devolve a parte integral da divisão de divisor por dividend.
Duplo (EXPR) Converte o valor expr em DOUBLE.
e() Devolve a constante e.
exp(expr) Retorna e ao poder de expr.
expm1(expr) Retorna exp(expr) - 1.
fatorial(expr) Devolve o fatorial de expr.
float (expr) Converte o valor expr em FLOAT.
chão(expr[,targetScale]) Devolve o maior número não inferior a expr, arredondado para baixo a targetScale casas decimais.
getbit(expr, pos) Devolve o valor de um bit numa representação binária de um numérico integral.
Hipot(expr1, expr2) Retorna sqrt(expr1 * expr1 + expr2 * expr2).
int(expr) Converte o valor expr em INTEGER.
ISNAN(EXPR) Devolve true se expr é NaN.
ln(expr) Devolve o logaritmo natural (base e) de expr.
log([base,] expr) Devolve o logaritmo de expr com base.
log1p(expr) Retorna log(1 + expr).
log2(expr) Devolve o logaritmo de expr com base 2.
log10(expr) Devolve o logaritmo de expr com base 10.
mod(dividendo, divisor) Devolve o restante após dividend / divisor.
nanvl (expr1, expr2) Devolve expr1 se não for NaN, ou expr2 de outro modo.
negativo(expr) Devolve o valor negado de expr.
'nullifzero(expr)' Retorna expr se não for zero, ou NULL de outra forma.
pi() Retorna pi.
pmod(dividendo, divisor) Devolve o resto positivo após dividend / divisor.
positivo(expr) Devolve o valor de expr.
POW(EXPR1, EXPR2) Eleva expr1 à potência de expr2.
Potência (EXPR1, EXPR2) Eleva expr1 à potência de expr2.
radianos (expr) Converte expr em graus para radianos.
rand([semente]) Devolve um valor aleatório entre 0 e 1.
randn([semente]) Devolve um valor aleatório de uma distribuição normal padrão.
random([semente]) Devolve um valor aleatório entre 0 e 1.
rint (expr) Devolve expr arredondado para um número inteiro como um DOUBLE.
round(expr[,targetScale]) Retorna o valor arredondado expr utilizando o modo de arredondamento HALF_UP.
seg (expr) Devolve a secante de expr.
shiftleft(expr, n) Retorna um deslocamento bit a bit para a esquerda por n bits.
Shiftright(expr, n) Retorna um número integral assinado bit a bit e assinado, deslocado à direita por n bits.
shiftrightunsigned(expr, n) Retorna um número integral assinado não assinado bit a bit deslocado para a direita por n bits.
sinal(expr) Retorna -1.0, 0.0 ou 1.0 como expr é negativo, 0 ou positivo.
signum(expr) Retorna -1.0, 0.0 ou 1.0 como expr é negativo, 0 ou positivo.
sen(expr) Devolve o seno de expr.
sinh (expr) Devolve o seno hiperbólico de expr.
smallint (expr) Converte o valor expr em SMALLINT.
sqrt(expr) Devolve a raiz quadrada de expr.
bronzeado (expr) Devolve a tangente de expr.
tanh(EXPR) Retorna a tangente hiperbólica de expr.
tinyint(expr) Converte expr para TINYINT.
to_number(expr, fmt) Retorna expr convertido para DECIMAL usando a formatação fmt.
try_add(expr1, expr2) Devolve a soma de expr1 e expr2, ou NULL em caso de erro.
try_divide(dividendo, divisor) Retorna dividend dividido por divisor, ou NULL se divisor for 0.
try_mod(dividendo, divisor) Devolve o restante após dividend / divisor, ou NULL se divisor for 0..
try_multiply(multiplicador, multiplicando) Retorna multiplier multiplicado por multiplicand, ou NULL em caso de overflow.
try_subtract(expr1, expr2) Devolve a subtração de expr2 de expr1, ou NULL em caso de transbordo.
try_to_number(expr, fmt) Retorna expr convertido para DECIMAL usando a formatação fmt, ou NULL se expr não corresponder ao formato.
uniform (expr1, expr2 [,semente]) Devolve um valor aleatório com valores independentes e distribuídos de forma idêntica dentro do intervalo de números especificado.
width_bucket(expr, minExpr, maxExpr, numBuckets) Retorna o número do bucket para um valor em um histograma de equilargura.
'zeroifnull(expr)' Devolve expr se não for NULL, ou 0 de outra forma.

Funções de agregação

Função Descrição
qualquer(expressão) Retorna verdadeiro se pelo menos um valor de expr no grupo for verdadeiro.
any_value(expr[,ignoreNull]) Retorna algum valor de expr para um grupo de linhas.
approx_count_distinct(expr[,relativeSD]) Devolve o número estimado de valores distintos em expr dentro do grupo.
approx_percentile(expr,percentagem[,precisão]) Devolve o percentil aproximado de expr dentro do grupo.
approx_top_k(expr[,k[,maxItemsTracked]]) Devolve os principais k valores de item que ocorrem com mais frequência em um expr juntamente com suas contagens aproximadas.
array_agg(expr) Retorna uma matriz que consiste em todos os valores em expr dentro do grupo.
Média (EXPR) Devolve a média calculada a partir dos valores de um grupo.
bit_and(expr) Retorna o resultado da operação bit a bit AND de todos os valores de entrada no grupo.
bit_or(expr) Retorna o resultado da operação bit a bit OR de todos os valores de entrada no grupo.
bit_xor(expr) Retorna o resultado da operação bit a bit XOR de todos os valores de entrada no grupo.
bitmap_construct_agg(expr) Retorna o bit a bit OR de todos os valores de posição de bit no grupo. entre 0 e 32767 num grupo como BINARY.
bitmap_or_agg(expr) Retorna o OR bitwise de todos os BINARY valores de entrada no grupo.
bool_and(expr) Retorna true se todos os valores em expr forem true dentro do grupo.
bool_or(expr) Retorna verdadeiro se pelo menos um valor em expr for verdadeiro dentro do grupo.
collect_list(expr) Retorna uma matriz que consiste em todos os valores em expr dentro do grupo.
collect_set(expr) Retorna uma matriz que consiste em todos os valores exclusivos dentro expr do grupo.
corr(expr1,expr2) Devolve o coeficiente de correlação de Pearson entre um grupo de pares numéricos.
contagem(*) Retorna o número total de linhas recuperadas em um grupo, incluindo linhas contendo null.
contagem(expr[, ...]) Retorna o número de linhas em um grupo para o qual as expressões fornecidas são todas não-nulas.
count_if(expr) Devolve o número de valores verdadeiros para o grupo em expr.
count_min_sketch (coluna, épsilon, confiança, semente) Fornece um esboço de contagem mínima de todos os valores no grupo em column com epsilon, confidence e seed.
covar_pop(expr1,expr2) Devolve a covariância populacional de pares numéricos num grupo.
covar_samp(expr1,expr2) Devolve a covariância de amostra de pares numéricos num grupo.
todos (expr) Retorna verdadeiro se todos os valores de expr no grupo forem verdadeiros.
first(expr[,ignoreNull]) Devolve o primeiro valor de expr para um grupo de linhas.
first_value(expr[,ignoreNull]) Devolve o primeiro valor de expr para um grupo de linhas.
histograma_numérico(expr, numBins) Calcula um histograma com exprnumBins compartimentos, retornando uma matriz de pares que representam os centros do compartimento.
hll_sketch_agg(expr[,lgConfigK]) Retorna um esboço do HyperLogLog usado para aproximar uma contagem de valores distinta.
hll_union_agg(expr[,allowDifferentLgConfigK]) Agrega esboços do HyperLogLog para um grupo de linhas.
Curtose (expr) Devolve o valor da curtose calculado a partir dos valores de um grupo.
last(expr[,ignoreNull]) Devolve o último valor de expr para o grupo de linhas.
último_valor(expr[,ignorarNulo]) Devolve o último valor de expr para o grupo de linhas.
listagg(expr[,delim]) [DENTRO do GRUPO (ORDER BY chave [,...])] Retorna um STRING ou BINARY concatenado de todos os valores em expr dentro do grupo, separados por delim.
max (expr) Devolve o valor máximo de expr num grupo.
max_by(expr1,expr2) Devolve o valor de um expr1 associado com o valor máximo de expr2 num grupo.
média(expr) Devolve a média calculada a partir dos valores de um grupo.
medida(measure_column) Devolve a medida de uma vista métrica calculada a partir de valores de um grupo.
mediana (expr) Devolve a mediana calculada a partir dos valores de um grupo.
min (expr) Devolve o valor mínimo de expr num grupo.
min_by(expr1, expr2) Devolve o valor de um expr1 associado com o valor mínimo de expr2 num grupo.
modo(expr [,deterministic]) Devolve o valor mais frequente, não NULL, de expr num grupo.
percentil (expr, percentagem [,frequência]) Devolve o valor exato do percentil de expr at especificado percentage.
percentile_approx(expr,percentage[,exatidão]) Devolve o percentil aproximado de expr dentro do grupo.
percentile_cont(pct) DENTRO DO AGRUPAMENTO (chaveORDER BY) Devolve o percentil interpolado do key dentro do grupo.
percentile_disc(pct) DENTRO do GRUPO (chaveORDER BY) Retorna o percentil discreto do key dentro do grupo.
regr_avgx(yExpr, xExpr) Devolve a média dos xExpr calculados a partir de valores de um grupo em que xExpr e yExpr são NOT NULL.
regr_avgy(yExpr, xExpr) Devolve a média dos yExpr calculados a partir de valores de um grupo em que xExpr e yExpr são NOT NULL.
regr_count(yExpr, xExpr) Devolve o número de pares yExprde valores não nulos , xExpr no grupo.
regr_intercept(yExpr, xExpr) Retorna o intercepto da linha de regressão linear univariável num grupo onde xExpr e yExpr não são NULL.
regr_r2(yExpr, xExpr) Devolve o coeficiente de determinação a partir dos valores de um grupo onde xExpr e yExpr não são NULL.
regr_slope(yExpr, xExpr) Devolve a inclinação da linha de regressão linear de pares yExprde valores não nulos , xExpr no grupo.
regr_sxx(yExpr, xExpr) Devolve a soma dos quadrados dos xExpr valores de um grupo onde xExpr e yExpr NÃO são NULL.
regr_sxy(yExpr, xExpr) Devolve a soma dos produtos de yExpr e xExpr calculada a partir de valores de um grupo onde xExpr e yExpr são NOT NULL.
regr_syy(yExpr, xExpr) Devolve a soma dos quadrados dos yExpr valores de um grupo onde xExpr e yExpr NÃO são NULL.
esquema_de_json_agg(json[, opções]) Retorna o esquema combinado de cadeias de JSON caracteres num grupo no formato DDL.
schema_of_variant_agg(variantExpr) Retorna o esquema combinado de todos os VARIANT valores em um grupo no formato DDL.
assimetria (expr) Devolve o valor de assimetria calculado a partir de valores de um grupo.
alguma (expr) Devolve verdadeiro se pelo menos um valor de expr no grupo for true.
DST (EXPR) Devolve o desvio padrão da amostra calculado a partir dos valores dentro do grupo.
stddev(expr) Devolve o desvio padrão da amostra calculado a partir dos valores dentro do grupo.
stddev_pop(expr) Devolve o desvio-padrão da população calculado a partir dos valores de um grupo.
stddev_samp(expr) Devolve o desvio padrão da amostra calculado a partir dos valores de um grupo.
string_agg(expr[,delim]) [DENTRO do GRUPO (ORDER BY chave [,...])] Retorna um STRING ou BINARY concatenado de todos os valores em expr dentro do grupo, separados por delim.
soma(expr) Devolve a soma calculada a partir dos valores de um grupo.
try_avg(expr) Retorna a média calculada a partir dos valores de um grupo, NULL se houver um excesso.
try_sum(expr) Devolve a soma calculada a partir de valores de um grupo, NULL se houver um overflow.
var_pop(expr) Devolve a variância populacional calculada a partir dos valores de um grupo.
var_samp(expr) Devolve a variância da amostra calculada a partir dos valores de um grupo.
variância (expr) Devolve a variância da amostra calculada a partir dos valores de um grupo.

Funções da janela de classificação

Função Descrição
dense_rank() Devolve a classificação de um valor em comparação com todos os valores na partição.
percentil(n) Divide as linhas de cada partição de janela em n buckets que variam de 1 a, no máximo, n.
percent_rank() Calcula a classificação percentual de um valor dentro da partição.
classificação() Devolve a classificação de um valor em comparação com todos os valores na partição.
row_number() Atribui um número único e sequencial a cada linha, começando com uma, de acordo com a ordem das linhas dentro da partição da janela.

Funções de janela analítica

Função Descrição
cume_dist() Devolve a posição de um valor relativo a todos os valores na partição.
lag(expr[,offset[,default]]) Retorna o valor de expr de uma linha anterior dentro da partição.
lead(expr[,offset[,default]]) Retorna o valor de expr de uma linha subsequente dentro da partição.
nth_value(expr, offset[, ignoreNulls]) Retorna o valor de expr em um offset específico na janela.

Funções de Array

Função Descrição
arrayExpr[indexExpr] Retorna o elemento na posição indexExpr de ARRAY arrayExpr.
aggregate(expr,start,merge[,finish]) Agrega elementos em uma matriz usando um agregador personalizado.
matriz([expr [, ...]]) Retorna uma matriz com os elementos em expr.
array_append(matriz, elem) Devoluções array acrescentadas por elem.
array_compact(matriz) Remove valores NULL de array.
array_contains(array,valor) Retorna verdadeiro se array contiver value.
array_distinct(matriz) Remove valores duplicados do array.
array_except(matriz1,matriz2) Retorna uma matriz dos elementos em array1 , mas não em array2.
array_insert(array, índice, elem) Devolve um elemento expandido array em que elem é inserido na posição index.
array_intersect(matriz1,matriz2) Retorna uma matriz dos elementos na interseção de array1 e array2.
array_join(matriz,delimiter[,nullReplacement]) Concatena os elementos de array.
array_max(matriz) Devolve o valor máximo em array.
array_min(matriz) Devolve o valor mínimo em array.
array_position(array, elemento) Devolve a posição da primeira ocorrência de element in array.
array_prepend(matriz, elem) Devolve array precedido por elem.
array_remove(array, elemento) Remove todas as ocorrências de element de array.
array_repeat(elemento,contagem) Retorna uma matriz contendo elementcount tempos.
array_size(matriz) Devolve o número de elementos em array.
array_sort(array, func) Devolve array ordenado de acordo com func.
array_union(matriz1,matriz2) Retorna uma matriz dos elementos na união de array1 e array2 sem duplicatas.
arrays_overlap(matriz1, matriz2) Retorna true se a interseção de array1 e array2 não estiver vazia.
arrays_zip(array1 [, ...]) Retorna uma matriz mesclada de structs na qual a nth struct contém todos os Nth valores de matrizes de entrada.
cardinalidade(expr) Devolve o tamanho de expr.
concat(expr1, expr2 [, ...]) Devolve a concatenação dos argumentos.
element_at(arrayExpr, índice) Devolve o elemento de arrayExpr em index.
existe (expr, pred) Retorna verdadeiro se pred for verdadeiro para qualquer elemento em expr.
explodir (coleção) Retorna linhas ao desencaixar collection.
explode_outer(coleção) Retorna linhas ao desaninhar collection usando semântica externa.
filtro (expr, func) Filtra a matriz em expr usando a função func.
achatar(arrayOfArrays) Transforma uma matriz de matrizes em uma única matriz.
forall(expr, predFunc) Testa se predFunc é verdadeiro para todos os elementos no array.
obter(arrayExpr, índice) Retorna o elemento de um arrayExpr em index, começando em 0.
em linha (entrada) Transforma uma matriz de estruturas numa tabela.
inline_outer(entrada) Explode uma matriz de estruturas numa tabela com semântica externa.
posexplode (coleção) Retorna linhas desaninhando a matriz com numeração de posições.
posexplode_outer(coleção) Retorna linhas desaninhando a matriz com numeração de posições usando OUTER semântica.
reduzir(expr,start,merge[,finish]) Agrega elementos em uma matriz usando um agregador personalizado.
reverso(matriz) Retorna uma cadeia de caracteres invertida ou uma matriz com ordem inversa de elementos.
seqüência (início, parada, etapa) Gera uma matriz de elementos de start para stop (inclusive), incrementando em step.
embaralhar(matriz) Retorna uma permutação aleatória da matriz em expr.
tamanho(expr) Devolve a cardinalidade de expr.
slice(expr, início, comprimento) Retorna um subconjunto de uma matriz.
sort_array(expr[,ordem ascendente]) Retorna a matriz em expr ordem classificada.
transformar(expr, func) Transforma elementos numa matriz em expr usando a função func.
try_element_at(arrayExpr, índice) Retorna o elemento de um arrayExpr em index, ou NULL se index estiver fora dos limites.
zip_with(expr1, expr2, func) Mescla os arrays em expr1 e expr2, elemento a elemento, num único array usando func.

Funções de mapa

Função Descrição
mapExpr[keyExpr] Retorna o valor em keyExpr de MAP mapExpr.
cardinalidade(expr) Devolve o tamanho de expr.
element_at(mapExpr, chave) Devolve o valor de mapExpr para key.
explodir (coleção) Retorna linhas ao desencaixar expr.
explode_outer(coleção) Retorna linhas ao desaninhar expr usando semântica externa.
mapa([{key1, value1}[, ...]]) Cria um mapa com os pares chave-valor especificados.
map_concat([expr1 [, ...]]) Retorna a união de todas as expressões de mapa expr.
map_contains_key(mapa, chave) Retorna true se map contiver key, false caso contrário.
map_entries(mapa) Retorna uma matriz não ordenada de todas as entradas no map.
map_filter(expr, func) Filtra entradas no mapa em expr usando a função func.
map_from_arrays(chaves, valores) Cria um mapa com pares das matrizes keys e values.
map_from_entries(expr) Cria um mapa criado a partir da matriz especificada de entradas.
map_keys(mapa) Retorna uma matriz não ordenada contendo as chaves de map.
map_values(mapa) Retorna uma matriz não ordenada contendo os valores de map.
map_zip_with(mapa1, mapa2, func) Mescla map1 e map2 em um único mapa.
tamanho(expr) Devolve a cardinalidade de expr.
str_to_map(expr[,pairDelim[,keyValueDelim]]) Retorna um mapa depois de dividir expr em pares chave-valor usando delimitadores.
transform_keys(expr, func) Transforma chaves em um mapa no expr usando a função func.
transform_values (expr, func) Transforma valores em um mapa em expr usando a função func.
try_element_at(mapExpr, chave) Devolve o valor de mapExpr para key, ou NULL se key não existir.

Funções de data, timestamp e intervalo

Para obter informações sobre formatos de carimbo de data e hora, consulte Padrões de data/hora.

Função Descrição
intervalExpr / divisor Devolve o intervalo dividido por divisor.
- intervalExpr Devolve o valor negado de intervalExpr.
intervalExpr1 - intervalExpr2 Devolve a subtração de intervalExpr2 de intervalExpr1.
datetimeExpr1 - datetimeExpr2 Devolve a subtração de datetimeExpr2 de datetimeExpr1.
+ intervalExpr Devolve o valor de intervalExpr.
intervalExpr1 + intervalExpr2 Devolve a soma de intervalExpr1 e intervalExpr2.
intervalExpr * multiplicando Retorna intervalExpr multiplicado por multiplicand.
abs(expr) Devolve o valor absoluto do valor do intervalo em expr.
add_months(startDate,numMonths) Devolve a data que é numMonths após startDate.
Curdate() Devolve a data atual no início da avaliação da consulta.
current_date() Devolve a data atual no início da avaliação da consulta.
current_timestamp() Retorna o timestamp atual no início da execução da consulta.
current_timezone() Retorna o fuso horário local da sessão atual.
data(expr) Converte o valor expr para DATE.
date_add(startDate,numDays) Retorna a data numDays após startDate.
date_add(unidade, valor, expr) Adiciona valueunits a um carimbo de data/hora expr.
date_diff(unidade, início, parada) Calcula a diferença entre dois timestamps medidos em units.
date_format(expr,fmt) Converte um timestamp em uma string no formato fmt.
date_from_unix_date(dias) Cria uma data a partir do número de dias desde 1970-01-01.
date_part(campo,expr) Extrai uma parte da data, hora ou intervalo.
date_sub(startDate,numDays) Devolve a data numDays anterior a startDate.
date_trunc (unidade, expr) Retorna o carimbo de data/hora truncado para a unidade especificada em unit.
dateadd(startDate,numDays) Retorna a data numDays após startDate.
dateadd(unidade, valor, expr) Adiciona valueunits a um carimbo de data/hora expr.
datediff(endDate,startDate) Devolve o número de dias de startDate para endDate.
datediff(unidade, início, parada) Calcula a diferença entre dois timestamps medidos em units.
dia(expr) Devolve o dia do mês da data ou marca temporal.
nome_dia(expr) Devolve o acrónimo inglês de três letras para o dia da semana para a data determinada.
dia_do_mês(expr) Devolve o dia do mês da data ou marca temporal.
dia_da_semana(expr) Retorna o dia da semana da data ou do carimbo de data/hora.
diadoano(expr) Devolve o dia do ano da data ou marca temporal.
divisor div dividendo Devolve a parte integral da divisão do intervalo divisor por intervalo dividend.
extract(campo FROM source) Resultados field de source.
from_unixtime(unixTime,fmt) Devolve unixTime em fmt.
from_utc_timestamp(expr,fuso horário) Devolve o timestamp em UTC para um timestamp expr em timeZone.
getdate() Retorna o timestamp atual no início da execução da consulta.
hora (expr) Devolve o componente de hora de um timestamp.
last_day(expr) Devolve o último dia do mês a que a data pertence.
make_date (ano, mês, dia) Cria uma data a partir dos campos year, month e day.
make_dt_interval([dias[, horas[, mins[, seg]]]) Cria um intervalo de tempo diário de days, hoursmins e secs.
make_interval (anos, meses, semanas, dias, horas, minutos, segundos) Preterido: cria um intervalo de years, months, weeks, days, hours, mins e secs.
make_timestamp (ano, mês, dia, hora, min, seg[, fuso horário]) Cria um carimbo de data/hora a partir dos campos year, month, day, hour, min, sec e timezone.
make_ym_interval([anos[, meses]]) Cria um intervalo de ano-mês com years e months.
minuto(expr) Devolve o componente minuto do carimbo de data/hora em expr.
mês(expr) Retorna o componente do mês do timestamp em expr.
months_between(expr1,expr2[,roundOff]) Devolve o número de meses decorridos entre datas ou carimbos de data/hora em expr1 e expr2.
next_day(expr,dayOfWeek) Devolve a primeira data que seja posterior a expr e nomeada como em dayOfWeek.
agora() Retorna o timestamp atual no início da execução da consulta.
trimestre(expr) Retorna o trimestre do ano para expr no intervalo de 1 a 4.
segundo(expr) Devolve o segundo componente do carimbo de data/hora em expr.
session_window(expr, gpDuration) Cria uma janela de sessão sobre uma expressão de marca temporal.
sinal(expr) Retorna -1.0, 0.0 ou 1.0 como intervalo expr é negativo, 0 ou positivo.
signum(expr) Retorna -1.0, 0.0 ou 1.0 como intervalo expr é negativo, 0 ou positivo.
timediff (unidade, início, parada) Calcula a diferença entre dois timestamps medidos em units.
carimbo de data/hora (expr) Converte expr para TIMESTAMP.
timestamp_micros(expr) Cria uma marca temporal expr em microssegundos desde o início da época UTC.
timestamp_millis(expr) Cria um carimbo de data/hora expr milissegundos desde a época do UTC.
timestamp_seconds(expr) Cria segundos de carimbo de data/hora expr desde a época UTC.
timestampadd(unidade, valor, expr) Adiciona valueunits a um carimbo de data/hora expr.
timestampdiff(unidade, início, parada) Calcula a diferença entre dois timestamps medidos em units.
to_date(expr[,fmt]) Retorna expr convertido em uma data usando uma formatação opcional.
to_timestamp(expr[,fmt]) Retorna expr transformado num timestamp com uma formatação opcional.
to_unix_timestamp(expr[,fmt]) Retorna o carimbo de data/hora em expr como um carimbo de data/hora UNIX.
to_utc_timestamp(expr,fuso horário) Devolve o timestamp em UTC para um timestamp expr em timezone.
trunc(expr, fmt) Devolve uma data em que a parte truncada corresponde à unidade especificada pelo modelo de formato fmt.
try_add(expr1, expr2) Devolve a soma de expr1 e expr2, ou NULL em caso de erro.
try_divide(dividendo, divisor) Retorna dividend dividido por divisor, ou NULL se divisor for 0.
try_multiply(multiplicador, multiplicando) Retorna multiplier multiplicado por multiplicand, ou NULL em caso de overflow.
try_subtract(expr1, expr2) Devolve a subtração de expr2 de expr1, ou NULL em caso de transbordo.
try_to_timestamp(expr[,fmt]) Retorna expr convertido para um timestamp usando uma formatação opcional, ou NULL se a conversão falhar.
unix_date(expr) Devolve o número de dias desde 1970-01-01.
unix_micros(expr) Devolve o número de microssegundos desde 1970-01-01 00:00:00 UTC.
unix_millis(expr) Devolve o número de milissegundos desde 1970-01-01 00:00:00 UTC.
unix_seconds(expr) Devolve o número de segundos desde 1970-01-01 00:00:00 UTC.
unix_timestamp([expr[, fmt]]) Retorna o carimbo de data/hora UNIX da hora atual ou especificada.
Dia da semana(EXPR) Devolve o dia da semana de expr.
Semana do Ano (EXPR) Devolve a semana do ano de expr.
ano(expr) Devolve o componente de ano de expr.
janela(expr, width[, step[, start]]) Cria uma janela deslizante com base em saltos sobre uma expressão de carimbo de data/hora.
window_time(janela) Devolve a hora de fim inclusiva de uma janela deslizante produzida pelas funções de janela ou session_window .

Funções geoespaciais H3

Para obter informações sobre funções geoespaciais H3, consulte Funções geoespaciais H3.

Funções de conversão e construtores

Para obter informações sobre conversão entre tipos, consulte cast função e try_cast função.

Função Descrição
matriz([expr [, ...]]) Retorna uma matriz com os elementos em expr.
bigint(expr) Converte o valor expr em BIGINT.
binário(expr) Converte o valor de expr para BINARY.
Booleano (EXPR) Converte expr para BOOLEAN.
cast (tipo expr AS) Converte o valor expr para o tipo typede dados de destino.
expr :: tipo Converte o valor expr para o tipo typede dados de destino.
data(expr) Converte o valor expr em DATE.
decimal(expr) Converte o valor expr em DECIMAL.
Duplo (EXPR) Converte o valor expr em DOUBLE.
float (expr) Converte o valor expr em FLOAT.
int(expr) Converte o valor expr em INTEGER.
make_date (ano, mês, dia) Cria uma data a partir dos campos year, month e day.
make_dt_interval([dias[, horas[, mins[, seg]]]) Cria um intervalo de tempo diário de days, hoursmins e secs.
make_interval (anos, meses, semanas, dias, horas, minutos, segundos) Cria um intervalo de years, months, weeks, days, hoursmins e secs.
make_timestamp (ano, mês, dia, hora, min, seg[, fuso horário]) Cria um carimbo de data/hora a partir dos campos year, month, day, hour, min, sec e timezone.
make_ym_interval([anos[, meses]]) Cria um intervalo de ano-mês com years e months.
map([{key1, value1} [, ...]]) Cria um mapa com os pares chave-valor especificados.
named_struct({name1, val1} [, ...]) Cria uma struct com os nomes e valores de campo especificados.
smallint (expr) Converte o valor expr em SMALLINT.
string(expr) Converte o valor expr em STRING.
struct(expr1 [, ...]) Cria um STRUCT com os valores de campo especificados.
tinyint(expr) Converte expr para TINYINT.
carimbo de data/hora (expr) Converte expr para TIMESTAMP.
to_char(EXPR, FMT) Retorna expr convertido para STRING utilizando a formatação fmt.
to_date(expr[,fmt]) Retorna expr convertido em uma data usando uma formatação opcional.
to_number(EXPR, FMT) Retorna expr tipificado para DECIMAL usando a formatação fmt.
to_timestamp(expr[,fmt]) Retorna expr transformado num timestamp com uma formatação opcional.
to_varchar(EXPR, FMT) Retorna expr convertido para STRING utilizando a formatação fmt.
try_cast (tipo AS expr) Converte o valor expr para o tipo type de dados de destino com segurança.
try_to_number(EXPR, FMT) Retorna expr convertido para DECIMAL usando a formatação fmt, ou NULL se expr não for válido.

Funções CSV e Avro

Função Descrição
from_avro(avroBin, jsonSchema[, opções]) Retorna um valor struct com base em avroBin e jsonSchema.
from_csv(csvStr, schema[, options]) Retorna um valor struct com o csvStr e schema.
schema_of_csv(csv[, opções]) Retorna o esquema de uma cadeia de caracteres CSV no formato DDL.
to_avro(expr[, opções]) Retorna um valor binário Avro com o valor struct especificado.
to_csv(expr[, opções]) Retorna uma cadeia de caracteres CSV com o valor struct especificado.

Funções JSON

Função Descrição
jsonStr : jsonPath Devolve campos extraídos do jsonStrficheiro .
from_json(jsonStr, schema[, options]) Retorna um valor struct com o jsonStr e schema.
get_json_object(expr, caminho) Extrai um JSON objeto de path.
json_array_length(jsonArray) Devolve o número de elementos na matriz JSON mais externa.
json_object_keys(jsonObject) Retorna todas as chaves do objeto mais JSON externo como uma matriz.
json_tuple(jsonStr, caminho1 [, ...]) Retorna vários JSON objetos como uma tupla.
parse_json(jsonStr) Devolve um VARIANT valor do jsonStr.
schema_of_json(jsonStr[, opções]) Retorna o esquema de uma JSON cadeia de caracteres no formato DDL.
schema_of_json_agg(jsonStr[, opções]) Retorna o esquema combinado de cadeias de JSON caracteres num grupo no formato DDL.
to_json(expr[, opções]) Retorna uma cadeia de caracteres JSON com o STRUCT ou VARIANT especificado em expr.

Funções VARIANT

Função Descrição
variantExpr : jsonPath Retorna campos extraídos do variantExpr usando caminho JSON.
is_variant_null(variantExpr) Testa se variantExpr é um VARIANT codificado em NULL.
parse_json(jsonStr) Devolve um VARIANT valor do jsonStr.
schema_of_variant(variantExpr) Retorna o esquema de uma VARIANT expressão no formato DDL.
schema_of_variant_agg(variantExpr) Retorna o esquema combinado de todos os VARIANT valores em um grupo no formato DDL.
to_json(expr[, opções]) Retorna uma cadeia de caracteres JSON com o STRUCT ou VARIANT especificado em expr.
try_parse_json(jsonStr) Retorna um VARIANT valor do jsonStr se possível. Se não for possível, NULL é devolvido.
try_variant_get(variantExpr,caminho,tipo) Extrai um valor do tipo type de variantExpr, especificado por path, ou NULL se não for possível converter para o tipo de destino.
variant_explode(entrada) Retorna um conjunto de linhas ao descompactar input.
variant_explode_outer(entrada) Retorna um conjunto de linhas por desaninhamento de input usando semântica externa.
variant_get(variantExpr,caminho,tipo) Extrai um valor de tipo type de variantExpr, especificado por path.

Funções XPath e XML

Função Descrição
from_xml(xmlStr, schema[, options]) Retorna um valor de estrutura analisado de `xmlStr` usando `schema`.
schema_of_xml(xmlStr[, opções]) Retorna o esquema de uma XML cadeia de caracteres no formato DDL.
XPath(XML, XPath) Retorna valores dentro dos nós de xml que correspondem a xpath.
xpath_boolean(XML, XPath) Retorna true se a expressão xpath for avaliada como true, ou se for encontrado um nó correspondente em xml.
xpath_double(XML, XPath) Retorna um valor DOUBLE de um documento XML.
xpath_float(XML, XPath) Retorna um valor FLOAT de um documento XML.
xpath_int(XML, XPath) Retorna um valor INTEGER de um documento XML.
xpath_long(XML, XPath) Retorna um valor BIGINT de um documento XML.
xpath_number(XML, XPath) Retorna um valor DOUBLE de um documento XML.
xpath_short(xml, xpath) Retorna um valor SHORT de um documento XML.
xpath_string(XML, XPath) Retorna o conteúdo do primeiro nó XML que corresponde à expressão XPath.

Funções de IA

Função Descrição
ai_analyze_sentiment(conteúdo) Retorna o sentimento de um texto.
ai_classify(conteúdo, rótulos) Classifica o conteúdo fornecido em um dos rótulos fornecidos.
ai_extract(conteúdo, rótulos) Extrai entidades especificadas por rótulos de um determinado texto.
ai_corrigir_gramática(conteúdo) Corrige erros gramaticais num determinado texto.
ai_forecast(observado, time_col) Extropola dados de séries temporais para o futuro.
ai_gen(conteúdo) Invoca um modelo de IA generativa de última geração das APIs do Databricks Foundation Model para responder ao prompt fornecido pelo usuário.
ai_generate_text(prompt, modelName[, param1, value1] [...]) Obsoleto: retorna o texto gerado por um modelo de linguagem de grandes dimensões (LLM) selecionado com o prompt fornecido.
ai_mask(conteúdo, rótulos) Mascara entidades especificadas dentro de um determinado texto.
ai_query(endpointName, request, returnType) Invoca um ponto de extremidade existente do Mosaic AI Model Serving e analisa e retorna sua resposta.
ai_similarity(strExpr1, strExpr2) Compara duas cadeias de caracteres e calcula a pontuação de similaridade semântica.
ai_summarize(content[, max_words]) Gera um resumo de um determinado texto.
ai_translate(conteúdo, to_lang) Traduz texto para um idioma de destino especificado.
pesquisa_vetor(índice, consulta, num_resultados) Consulte um índice do Mosaic AI Vetor Search usando SQL.

Funções de leitura

Função Descrição
read_files(caminho, [optionKey => optionValue] [, ...]) Lê arquivos de dados no armazenamento em nuvem e os retorna em formato tabular.
read_kafka([optionKey => optionValue] [, ...]) Lê registros de um cluster Apache Kafka e os retorna em formato tabular.
read_kinesis({parâmetro => valor} [, ...]) Retorna uma tabela com os registos lidos de um ou mais fluxos do Kinesis.
read_pubsub([parâmetro => valor] [, ...]) Uma função com valor de tabela para ler registros de Pub/Sub de um tópico.
read_pulsar({optionKey => optionValue} [, ...]) Retorna uma tabela com registros lidos do Pulsar.
read_state_metadata(caminho) Retorna uma tabela com linhas que representam os metadados de um estado de consulta de streaming.
read_statestore(caminho [, option_key => option_value] [...]) Retorna registros do armazenamento de estado de consultas de streaming.

Funções diversas

Função Descrição
assert_true(expr) Retorna um erro se expr não for verdadeiro.
CASE expr { QUANDO opt1 ENTÃO res1 } [...] [ELSE def] FIM Devolve resN para o primeiro optN que é igual a expr ou def se nenhum corresponder.
CASO { QUANDO cond1 ENTÃO res1 } [...] [ELSE def] FIM Retorna resN para o primeiro condN que é avaliado como verdadeiro, ou def caso nenhum seja encontrado.
cloud_files_state( { TABLE(tabela) | ponto de verificação } ) Retorna o estado a nível de arquivo de um carregador automático cloud_files.
coalesce (expr1, expr2 [, ...]) Retorna o primeiro argumento não nulo.
agrupamentos() Devolve a lista de ordenações disponíveis.
cubo (expr1 [, ...]) Cria um cubo multidimensional usando as colunas de expressão especificadas.
current_catalog() Retorna o catálogo atual.
current_database() Retorna o esquema atual.
current_metastore() Retorna a ID atual do Unity Catalog Metastore.
current_recipient(chave) Retorna uma propriedade para o destinatário atual em uma exibição compartilhada com o Compartilhamento Delta.
current_schema() Retorna o esquema atual.
current_user() Retorna o usuário que executa a instrução.
current_version() Retorna a versão atual do Azure Databricks.
decodificar(expr, { chave, valor } [, ...] [,defValue]) Retorna o valor correspondente à chave.
elt(índice, expr1 [, ...] ) Retorna a enésima expressão.
equal_null(expr1, expr2) Devolve true se expr1 for igual ou ambas as expr2 expressões forem NULL, ou false de outra forma.
event_log( { TABLE(tabela) | pipeline_id } ) Retorna uma tabela do histórico de atualização para uma exibição materializada, tabela de streaming ou pipeline.
maior(expr1, expr2 [, ...]) Retorna o maior valor de todos os argumentos, ignorando valores nulos.
agrupamento (col) Indica se uma coluna especificada em um GROUPING SET, ROLLUPou CUBE representa um subtotal.
grouping_id([col1 [, ...]]) Retorna o nível de agrupamento para um conjunto de colunas.
hash(expr1 [, ...]) Retorna um valor em hash dos argumentos.
hll_sketch_estimate(expr) Estima o número de valores distintos coletados em um esboço do HyperLogLog.
hll_union(expr1, expr2 [,allowDifferentLgConfigK]) Combina dois esboços do HyperLogLog.
http_request({parm => expr} [, ...]) Faz uma solicitação HTTP usando uma conexão HTTP definida.
java_method(classe, método[, arg1 [, ...]]) Chama um método com reflexão.
se(cond, expr1, expr2) Retorna expr1 se cond é true, ou expr2 de outra forma.
IFF(cond, expr1, expr2) Retorna expr1 se cond é true, ou expr2 de outra forma.
ifnull(expr1, expr2) Retorna expr2 se expr1 é NULL, ou expr1 de outra forma.
input_file_block_length() Retorna o comprimento em bytes do bloco que está sendo lido.
`input_file_block_start()` Retorna o deslocamento inicial em bytes do bloco que está sendo lido.
input_file_name() Retorna o nome do arquivo que está sendo lido ou a cadeia de caracteres vazia, se não estiver disponível.
is_account_group_member(grupo) Retorna verdadeiro se o utilizador atual for um membro do grupo ao nível da conta.
is_member(grupo) Retorna verdadeiro se o utilizador atual for membro de um grupo ao nível do espaço de trabalho.
isnull(expr) Devolve true se expr é NULL.
isnotnull(expr) Devolve true se expr não for NULL.
mínimo(expr1, expr2 [, ...]) Retorna o menor valor de todos os argumentos, ignorando valores nulos.
list_secrets([scopeStr]) Devolve as chaves em um ou todos os escopos do serviço secreto Databricks que o utilizador está autorizado a ver.
luhn_check(numStr) Retorna true se numStr passar na verificação do algoritmo de Luhn.
monotonically_increasing_id() Retorna números inteiros de 64 bits monotonicamente crescentes.
nullif(expr1, expr2) Retorna NULL se expr1 for igual a expr2, ou expr1 de outra forma.
NVL (expr1, expr2) Retorna expr2 se expr1 é NULL, ou expr1 de outra forma.
NVL2(expr1, expr2, expr3) Retorna expr2 se expr1 não for NULL, ou expr3 de outra forma.
levantar_erro(expr) Lança uma exceção com expr como a mensagem.
intervalo (fim) Retorna uma tabela de valores dentro de um intervalo especificado.
intervalo(início, fim [, etapa [, numParts]]) Retorna uma tabela de valores dentro de um intervalo especificado.
reflect(classe, método[, arg1 [, ...]]) Chama um método com reflexão.
secret(escopo, chave) Extrai um valor secreto com os scope e key dados do serviço secreto do Databricks.
session_user() Retorna o usuário conectado ao Azure Databricks.
spark_partition_id() Retorna o ID da partição atual.
sql_keywords() Retorna o conjunto de palavras-chave SQL no Azure Databricks.
stack(numRows, expr1 [, ...]) Separa expr1, ... exprN em numRows linhas.
table_changes(table_str, início [, fim]) Retorna um log de alterações em uma tabela Delta Lake com o Change Data Feed habilitado.
try_reflect(classe, método[, arg1 [, ...]]) Chama um método com reflexão, retornando NULL se o método falhar.
try_secret(escopo, chave) Extrai um valor secreto utilizando o scope e o key fornecidos do serviço secreto Databricks, ou NULL caso a chave não seja possível de recuperar.
tipo de(expr) Retornar uma cadeia de caracteres de tipo formatada em DDL para o tipo de dados do expr.
utilizador() Retorna o usuário que executa a instrução.
Uuid() Retorna uma cadeia de caracteres UUID (identificador universalmente exclusivo).
janela(expr, width[, step [, start]]) Cria uma janela deslizante com base em saltos sobre uma expressão de carimbo de data/hora.
xxhash64(expr1 [, ...]) Retorna um valor em hash de 64 bits dos argumentos.
versão() Retorna a versão do Apache Spark.