Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Aplica-se a: Databricks SQL
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 indexExpr o elemento nd de ARRAY arrayExpr . |
[] | mapExpr [ keyExpr ] |
Devolve o valor em keyExpr de MAP mapExpr . |
^ | expr1 ^ expr2 |
Devolve o exclusivo OR (XOR) bitwise de expr1 e expr2 . |
: | jsonStr : jsonPath |
Devolve campos extraídos do jsonStr ficheiro . |
:: | expr :: type |
Converte o valor expr para o tipo type de 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 NULL s 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 , regexp ilike , 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 expr STRING , 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 expr STRING 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 expr n 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 expr STRING 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_NTZ sourceTs 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 expr numBins 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 yExpr de 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 yExpr de 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 element count 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 value unit s a um carimbo de data/hora expr . |
date_diff(unidade, início, parada) | Calcula a diferença entre dois timestamps medidos em unit s. |
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 value unit s 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 unit s. |
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 , hours mins 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 unit s. |
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 value unit s a um carimbo de data/hora expr . |
timestampdiff(unidade, início, parada) | Calcula a diferença entre dois timestamps medidos em unit s. |
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 type de dados de destino. |
expr :: tipo | Converte o valor expr para o tipo type de 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 , hours mins e secs . |
make_interval (anos, meses, semanas, dias, horas, minutos, segundos) | 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 . |
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 DECIMA L 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 jsonStr ficheiro . |
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 , ROLLUP ou 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. |