Spark Funções SQL

O Adobe Experience Platform Query Service fornece várias funções SQL Spark incorporadas para estender a funcionalidade SQL. Este documento lista as funções SQL Spark suportadas pelo Serviço de Consulta.

Para obter informações mais detalhadas sobre as funções, incluindo sintaxe, uso e exemplos, leia a documentação da função SQL Spark.

OBSERVAÇÃO

Nem todas as funções na documentação externa são compatíveis.

Categorias

Operadores e funções de matemática e estatística

Operador/Função Descrição
% Retorna o restante dos dois números
* Multiplica os dois números
+ Adiciona os dois números
- Subtrai os dois números
/ Divide os dois números
abs Retorna o valor absoluto da entrada
acos Retorna o valor cosseno inverso
approx_count_distinct Retorna a cardinalidade estimada de HyperLog++
approx_percentile Retorna o valor aproximado do percentil na porcentagem especificada
asin Retorna o valor seno inverso
atan Retorna o valor da tangente inversa
atan2 Retorna o ângulo entre o plano positivo do eixo x e os pontos indicados pelas coordenadas
avg Retorna o valor médio
cbrt Retorna a raiz do cubo
ceil ou ceiling Retorna o menor número inteiro não maior que o valor inserido
conv Converter de uma base para outra
corr Retorna o coeficiente Pearson entre os números
cos Retorna o valor cosseno
cosh Retorna o valor cosseno hiperbólico
cot Retorna o valor tangente
dense_rank Retorna a classificação de um valor em um grupo de valores
e Retorna o número do Euler
exp Retorna e para a potência do valor
expm1 Retorna e para a potência do valor menos 1
factorial Retorna o fatorial do valor
floor Retorna o maior inteiro não menor que o valor
greatest Retorna o maior valor de todos os parâmetros
hypot Retorna a hipotensão dos dois valores dados
kurtosis Retorna o valor de kurtosis do grupo
least Retorna o menor valor de todos os parâmetros
ln Retorna o logaritmo natural do valor
log Retorna o logaritmo do valor
log10 Retorna o logaritmo, em base 10, do valor
log1p Retorna o logaritmo do valor mais 1
log2 Retorna o logaritmo, em base 2, do valor
max Retorna o valor máximo da expressão
mean Retorna a média calculada com base nos valores
min Retorna o valor mínimo da expressão
monotonically_increasing_id Retorna IDs que aumentam monotonicamente
negative Retorna o valor negado
percent_rank Retorna a classificação da porcentagem de um valor
percentile Retorna o percentil exato em uma determinada porcentagem
percentile_approx Retorna o percentil aproximado em uma determinada porcentagem
pi Retorna pi
pmod Retorna o módulo positivo entre dois valores
positive Retorna o valor positivo
pow, power Retorna o primeiro valor para a potência do segundo valor
radians Converte o valor em radianos
rand Retorna um número aleatório entre 0 e 1
randn Retorna um valor aleatório
rint Retorna o valor duplo mais próximo
round Retorna o valor arredondado mais próximo
sign, signum Retorna o sinal do número
sin Retorna seno do valor
sinh Retorna o seno hiperbólico do valor
sqrt Retorna a raiz quadrada do valor
stddev Retorna o desvio padrão do valor
sttdev_pop Retorna o desvio padrão da população do valor
stddev_samp Retorna o desvio padrão da amostra do valor
sum Retorna a soma dos valores
tan Retorna a tangente do valor
tanh Retorna a tangente hiperbólica do valor
var_pop Retorna a variação de população calculada
var_samp, variance Retorna a variação calculada da amostra

Operadores e funções lógicos

Operador/Função Descrição
! ou not Lógica não
< Less than
<= Less than or equal to
= Equal to
> Greater than
>= Greater than or equal to
^ Exclusivo ou em bits
>= Maior que ou igual a
[` `](https://spark.apache.org/docs/latest/api/sql/index.html#_15)
~ No sentido de bits
arrays_overlap Retorna os elementos comuns
assert_true Asserta se a expressão for verdadeira
if Se a expressão for avaliada como true, retornará a segunda expressão. Caso contrário, retorne a terceira expressão.
ifnull Se a expressão for nula, retornará a segunda expressão. Caso contrário, retornará a primeira expressão.
in Retorna true se a primeira expressão estiver em qualquer uma das expressões subsequentes.
isnan Retorna true se o valor não for um número
isnotnull Retorna true se o valor não for nulo
isnull Retorna true se o valor for nulo
nanvl Retorna a primeira expressão se não for um número, retorna a segunda expressão caso contrário
or Lógica ou
when Quando pode ser usado para criar condições de ramificação para comparação
xpath_boolean Retorna true se a expressão XPath for avaliada como true ou se um nó correspondente for encontrado

Funções de data/hora

Função Descrição
add_months Adicionar meses até a data
date_add Adicionar dias à data
date_format Modificar formato de data
date_sub Subtrair dias a partir da data
date_trunc Retorna a data truncada para a unidade especificada
datediff Retorna a diferença entre datas em dias
day, dayofmonth Retorna o dia do mês
dayofweek Retorna o dia da semana (1-7)
dayofyear Retorna o dia do ano
from_unixtime Retorna a data em horário Unix
from_utc_timestamp Retorna a data em UTC time
hour Retorna a hora da entrada
last_day Retorna o último dia do mês ao qual a data pertence
minute Retorna o minuto da entrada
month Retorna o mês da entrada
months_between Número de meses entre
next_day Retorna o primeiro dia depois da entrada
quarter Retorna o trimestre da entrada
second Retorna o segundo da cadeia de caracteres
to_date Converte a cadeia de caracteres em uma data. Observação: a string ​deve estar no formato yyyy-mm-ddTHH24:MM:SS.
to_timestamp Converte a string em um carimbo de data e hora. Observação: a string ​deve estar no formato yyyy-mm-ddTHH24:MM:SS.
to_unix_timestamp Converte a cadeia de caracteres em um carimbo de data e hora Unix
to_utc_timestamp Converte a cadeia de caracteres em um carimbo de data e hora UTC
trunc Trunca a data
unix_timestamp Retorna o carimbo de data e hora Unix
weekday Dia da semana (0-6)
weekofyear Retorna a semana do ano para uma determinada data
year Retorna o ano da cadeira de caracteres

Matrizes

Função Descrição
array Cria uma matriz com os elementos fornecidos
array_contains Verifica se a matriz contém o valor
array_distinct Remove valores duplicados da matriz
array_except Retorna uma matriz dos elementos na primeira matriz, mas não na segunda
array_intersect Retorna a interseção dos dois arrays
array_join Une dois arrays
array_max Retorna o valor máximo da matriz
array_min Retorna o valor mínimo da matriz
array_position Retorna a posição baseada em 1 do elemento
array_remove Remove todos os elementos iguais ao elemento
array_repeat Cria uma matriz contendo o valor contado vezes
array_sort Classifica a matriz
array_union Une a matriz, sem duplicatas
array_zip CEP
cardinality Retornar o tamanho do storage
element_at Retorna o elemento na posição
explode Separe elementos da matriz em várias linhas, excluindo nulo
explode_outer Separe elementos da matriz em várias linhas, incluindo null
find_in_set Retorna a posição baseada em 1 da matriz
flatten Nivela uma matriz
inline Array separado de estruturas em uma tabela, excluindo nulo
inline_outer Array separado de estruturas em uma tabela, incluindo nulo
posexplod Separe elementos da matriz em várias linhas com posições, excluindo nulo
posexplod Separe elementos da matriz em várias linhas com posições, incluindo null
reverse Elementos inversos da matriz
shuffle Retornar uma permuta aleatória do array
slice Subdefine uma matriz
sort_array Classifique uma matriz, considerando uma ordem
zip_with Une os dois arrays em um único array, antes de aplicar uma função

Funções de vazamento do tipo de dados

Função Descrição
bigint Alterar o tipo de dados para bigint
binary Alterar o tipo de dados para binário
boolean Alterar o tipo de dados para booleano
type Alterar o tipo de dados para o tipo especificado
date Alterar o tipo de dados para a data
decimal Alterar o tipo de dados para decimal
double Alterar o tipo de dados para double
float Alterar o tipo de dados para flutuante
int Alterar o tipo de dados para int
smallint Alterar o tipo de dados para smallint
str_to_map Criar um mapa a partir de uma sequência de caracteres
string Alterar o tipo de dados para string
struct Criar uma estrutura
tinyint Alterar o tipo de dados para tinyint

Funções de conversão e formatação

Função Descrição
ascii Retorna o valor numérico (ASCII)
base64 Alterar o argumento para uma string base64
bin Alterar o argumento para um valor binário
bit_length Retorna o comprimento do bit
char, chr Retorna o caractere ASCII
char_length, character_length Retorna o comprimento da string
crc32 Retorna o valor de verificação de redundância cíclica
degrees Converter radianos em graus
format_number Alterar o formato do número
from_json, get_json_object Obter dados do JSON
hash Retorna o valor de hash
hex Converter o argumento em um valor hexadecimal
initcap Altera a string para ser classificada como título
lcase, lower Altera a cadeira de caracteres para estar todas em minúsculas
lpad Prepara o lado esquerdo de uma cadeira de caracteres
map Criar um mapa
map_from_arrays Criar um mapa a partir de uma matriz
map_from_entries Criar um mapa a partir de uma matriz de estruturas
md5 Retorna o valor md5
rpad Preenche o lado direito de uma cadeira de caracteres
rtrim Remove espaços à direita
sha, sha1 Retorna o valor SHA1
sha2 Retorna o valor SHA2
soundex Retorna o código soundex
stack Separar valores em linhas
substr, substring Retornar a subcadeia de caracteres
to_json Retorna uma string JSON
translate Substituir valores na cadeia de caracteres
trim Remover caracteres à esquerda e à direita
ucase, upper Alterar a cadeia de caracteres para estar em maiúsculas
unbase64 Converta a string base64 em binário
unhex Converter o hexadecimal em binário
uuid Retornar um UUID

Avaliação dos dados

Função Descrição
coalesce Retorna o primeiro argumento não nulo
collect_list Retornar uma lista de elementos não exclusivos
collect_set Retornar um conjunto de elementos únicos
concat Concatenação
concat_ws Concatenação com separador
count Retorna a contagem total de linhas
decode Decodificar usando um conjunto de caracteres
elt Retorna a entrada nth
encode Codificar usando um conjunto de caracteres
first, first_value Retorna o primeiro valor
grouping Indica se uma coluna foi agrupada
grouping_id Retorna o nível de agrupamento
instr Retorna um índice de ocorrência de caractere com base em 1
json_tuple Retorna uma tupla de uma entrada JSON
lag, lead Retorna o valor antes do deslocamento
last, last_value Retorna o último valor
left Retorna os primeiros n caracteres
length Retorna o comprimento da cadeira de caracteres
levenshtein Retorna a distância Levenshtein entre cadeias de caracteres
locate, position Retorna a posição da primeira ocorrência de uma substring
map_concat Concatenar um mapa
map_keys Retornar as chaves de um mapa
map_values Retornar os valores de um mapa
ntile Dividir linhas em partições
nullif Retorna null se true
nvl Retorna o valor se for nulo
nvl2 Retorna o valor se não for nulo
parse_url Extrai parte de um URL
rank Calcula a classificação de um valor
regexp_extract Extrai algo que corresponde ao regex
regex_replace Substitui algo que corresponda ao regex
repeat Retorna uma string que se repete
replace Substituir todas as instâncias de uma cadeia de caracteres
rollup Criar um rollup multidimensional
row_number Atribui um número de linha exclusivo
schema_of_json Retorna o esquema do JSON
sentences Divide a string em uma matriz de palavras
sequence Gera uma matriz de elementos
shiftleft Sinal de desvio bit a bit à esquerda
shiftright Sinal de desvio bit a bit à direita
shiftrightunsigned Deslocamento bit a bit não assinado à direita
size Retornar o tamanho do storage
space Retornar uma string com espaços n
split Split string
substring_index Índice de retorno da substring
window Window
xpath Analisar nós XML
xpath_double, xpath_number Analisar nós XML para double
xpath_float Analisar nós XML para flutuante
xpath_int Analisar nós XML para inteiro
xpath_long Analisar nós XML por muito tempo
xpath_short Analisar nós XML para número inteiro curto
xpath_string Analisar nós XML para cadeia de caracteres

Informações atuais

Função Descrição
current_database Retorna o banco de dados atual
current_date Retorna a data atual
current_timestamp, now Retorna o carimbo de data e hora atual

Funções de ordem mais alta

Função Descrição
transform Transformar elementos em uma matriz
exists Verificar se o elemento existe
filter Filtrar a matriz de entrada
aggregate Aplicar um operador binário a todos os elementos

Nesta página