Spark Funzioni SQL

Adobe Experience Platform Query Service fornisce diverse funzioni Spark SQL integrate per estendere le funzionalità SQL. Questo documento elenca le funzioni SQL di Spark supportate da Query Service.

Per informazioni più dettagliate sulle funzioni, tra cui la sintassi, l’utilizzo e alcuni esempi, consulta la Documentazione della funzione SQL Spark.

NOTA

Non tutte le funzioni nella documentazione esterna sono supportate.

Operatori e funzioni matematiche e statistiche

Operatore/funzione Descrizione
% Restituisce il resto dei due numeri
* Moltiplica i due numeri
+ Aggiunge i due numeri
- Sottrae i due numeri
/ Divide i due numeri
abs Restituisce il valore assoluto dell’input
acos Restituisce il valore del coseno inverso
approx_count_distinct Restituisce la cardinalità stimata da HyperLogLog++
approx_percentile Restituisce il valore percentile approssimativo alla percentuale specificata
asin Restituisce il valore seno inverso
atan Restituisce il valore della tangente inversa
atan2 Restituisce l'angolo tra il piano positivo dell'asse x e i punti forniti dalle coordinate
avg Restituisce il valore medio
cbrt Restituisce la radice del cubo
ceil o ceiling Restituisce il numero intero più piccolo, non superiore al valore immesso
conv Conversione da una base a un'altra
corr Restituisce il coefficiente di Pearson tra i numeri
cos Restituisce il valore del coseno
cosh Restituisce il valore del coseno iperbolico
cot Restituisce il valore cotangente
dense_rank Restituisce il rango di un valore in un gruppo di valori
e Restituisce il numero di Eulero
exp Restituisce e alla potenza del valore
expm1 Restituisce e alla potenza del valore meno 1
factorial Restituisce il fattoriale del valore
floor Restituisce il numero intero più grande, non inferiore al valore
greatest Restituisce il valore più grande di tutti i parametri
hypot Restituisce l’ipotenusa dei due valori forniti
kurtosis Restituisce il valore della curtosi dal gruppo
least Restituisce il valore più piccolo di tutti i parametri
ln Restituisce il logaritmo naturale del valore
log Restituisce il logaritmo del valore
log10 Restituisce il logaritmo in base 10 del valore
log1p Restituisce il logaritmo del valore più 1
log2 Restituisce il logaritmo in base 2 del valore
max Restituisce il valore massimo dell’espressione
mean Restituisce la media calcolata dai valori
min Restituisce il valore minimo dell’espressione
monotonically_increasing_id Restituisce ID con incremento monotono
negative Restituisce il valore negato
percent_rank Restituisce la classificazione percentuale di un valore
percentile Restituisce il percentile esatto a una determinata percentuale
percentile_approx Restituisce il percentile approssimativo a una determinata percentuale
pi Restituisce pi greco
pmod Restituisce il modulo positivo tra due valori
positive Restituisce il valore positivo
pow, power Restituisce il primo valore alla potenza del secondo valore
radians Converte il valore in radianti
rand Restituisce un numero casuale compreso tra 0 e 1
randn Restituisce un valore casuale
rint Restituisce il valore doppio più vicino
round Restituisce il valore arrotondato più vicino
sign, signum Restituisce il segno del numero
sin Restituisce il seno del valore
sinh Restituisce il seno iperbolico del valore
sqrt Restituisce la radice quadrata del valore
stddev Restituisce la deviazione standard del valore
sttdev_pop Restituisce la deviazione standard della popolazione del valore
stddev_samp Restituisce la deviazione standard del valore
sum Restituisce la somma dei valori
tan Restituisce la tangente del valore
tanh Restituisce la tangente iperbolica del valore
var_pop Restituisce la varianza della popolazione calcolata
var_samp, variance Restituisce la varianza del campione calcolata

Operatori logici e funzioni

Operatore/funzione Descrizione
! o not Non logico
< Minore di
<= Minore o uguale a
= Uguale a
> Maggiore di
>= Maggiore o uguale a
^ OR esclusivo bit per bit
| bit per bit o
~ bit per bit non
arrays_overlap Restituisce gli elementi comuni
assert_true Asserisce se l’espressione è true
if Se l'espressione restituisce true, restituisce la seconda espressione. In caso contrario, restituisce la terza espressione.
ifnull Se l'espressione è null, restituisce la seconda espressione. In caso contrario, restituisce la prima espressione.
in Restituisce true se la prima espressione si trova in una qualsiasi delle espressioni successive.
isnan Restituisce true se il valore non è un numero
isnotnull Restituisce true se il valore non è null
isnull Restituisce true se il valore è null
nanvl Restituisce la prima espressione se non è un numero, in caso contrario restituisce la seconda espressione
or OR logico
when Quando può essere utilizzato per creare condizioni di ramo da confrontare
xpath_boolean Restituisce true se l'espressione XPath restituisce true o se viene trovato un nodo corrispondente

Funzioni data/ora

Funzione Descrizione
add_months Aggiungi mesi alla data
date_add Aggiungi giorni alla data
date_format Modifica formato data
date_sub Sottrai giorni dalla data
date_trunc Restituisce la data troncata nell'unità specificata
datediff Restituisce la differenza tra le date in giorni
day, dayofmonth Restituisce il giorno del mese
dayofweek Restituisce il giorno della settimana (1-7)
dayofyear Restituisce il giorno dell’anno
from_unixtime Restituisce la data in ora Unix
from_utc_timestamp Restituisce la data in ora UTC
hour Restituisce l’ora dell’input
last_day Restituisce l’ultimo giorno del mese a cui appartiene la data
minute Restituisce il minuto dell’input
month Restituisce il mese dell’input
months_between Numero di mesi tra
next_day Restituisce il primo giorno successivo all’input
quarter Restituisce il trimestre dell'input
second Restituisce il secondo della stringa
to_date Converte la stringa in una data. Nota: La stringa deve essere nel formato yyyy-mm-ddTHH24:MM:SS.
to_timestamp Converte la stringa in una marca temporale. Nota: La stringa deve essere nel formato yyyy-mm-ddTHH24:MM:SS.
to_unix_timestamp Converte la stringa in una marca temporale Unix
to_utc_timestamp Converte la stringa in una marca temporale UTC
trunc Tronca la data
unix_timestamp Restituisce il timestamp Unix
weekday Giorno della settimana (0-6)
weekofyear Restituisce la settimana dell’anno per una data specificata
year Restituisce l’anno della stringa

Matrici

Funzione Descrizione
array Crea un array con gli elementi dati
array_contains Controlla se l’array contiene il valore
array_distinct Rimuove i valori duplicati dall’array
array_except Restituisce una matrice degli elementi nella prima matrice, ma non nella seconda
array_intersect Restituisce l'intersezione dei due array
array_join Unisce due array
array_max Restituisce il valore massimo della matrice
array_min Restituisce il valore minimo della matrice
array_position Restituisce la posizione in base 1 dell'elemento
array_remove Rimuove tutti gli elementi uguali all'elemento
array_repeat Crea una matrice contenente il valore di ore conteggiate
array_sort Ordina l’array
array_union Unisce l'array senza duplicati
arrays_zip Combina i valori di determinate matrici con i valori della raccolta originale in un determinato indice
cardinality Restituisce la dimensione dell’array
element_at Restituisce l’elemento nella posizione
explode Separa gli elementi dell’array in più righe, escluso il valore null
explode_outer Separa gli elementi dell’array in più righe, incluso null
find_in_set Restituisce la posizione basata su 1 della matrice
flatten Appiattisce un array di array
inline Separa la matrice di strutture in una tabella, escludendo null
inline_outer Separa la matrice di strutture in una tabella, incluso null
posexplode Separa gli elementi dell’array in più righe con posizioni, escluso il valore null
reverse Inverti elementi dell’array
shuffle Restituisce una permutazione casuale dell’array
slice Sottoimposta un array
sort_array Ordinare un array, in base all’ordine
zip_with Unisce i due array in un unico array, prima di applicare una funzione

Funzioni di colata del tipo di dati

Funzione Descrizione
bigint Cambia il tipo di dati in bigint
binary Cambia il tipo di dati in binario
boolean Modificare il tipo di dati in booleano
type Modifica il tipo di dati nel tipo specificato
date Modifica il tipo di dati in data
decimal Cambia il tipo di dati in decimale
double Modifica il tipo di dati in doppio
float Cambia il tipo di dati in virgola mobile
int Cambia il tipo di dati in int
smallint Cambia il tipo di dati in smallint
str_to_map Creare una mappa da una stringa
string Cambia il tipo di dati in stringa
struct Creare una struttura
tinyint Cambia il tipo di dati in tinyint

Funzioni di conversione e formattazione

Funzione Descrizione
ascii Restituisce il valore numerico (ASCII)
base64 Modificare l'argomento in una stringa base64
bin Cambia l'argomento in un valore binario
bit_length Restituisce la lunghezza del bit
char, chr Restituisce il carattere ASCII
char_length, character_length Restituisce la lunghezza della stringa
crc32 Restituisce il valore del controllo di ridondanza ciclica
degrees Converti radianti in gradi
format_number Modificare il formato del numero
from_json, get_json_object Ottieni dati da JSON
hash Restituisce il valore hash
hex Convertire l'argomento in un valore esadecimale
initcap Cambia la stringa in modo che il titolo sia maiuscolo
lcase, lower Cambia la stringa in minuscolo.
lpad Aggiunge il lato sinistro di una stringa.
map Creare una mappa
map_from_arrays Creare una mappa da un array
map_from_entries Creare una mappa da un array di strutture
md5 Restituisce il valore md5
rpad Inserisce il lato destro di una stringa
rtrim Rimuove gli spazi finali
sha, sha1 Restituisce il valore SHA1
sha2 Restituisce il valore SHA2
soundex Restituisce il codice soundex
stack Separare i valori nelle righe
substr, substring Restituisce la sottostringa
to_json Restituisce una stringa JSON
translate Sostituisci i valori all’interno di una stringa
trim Rimuovi caratteri iniziali e finali
ucase, upper Modifica la stringa in lettere maiuscole
unbase64 Converti la stringa base64 in binario
unhex Converti il valore esadecimale in binario
uuid Restituire un UUID

Valutazione dei dati

Funzione Descrizione
coalesce Restituisce il primo argomento non Null
collect_list Restituisce un elenco di elementi non univoci
collect_set Restituire un set di elementi univoci
concat Concatenazione
concat_ws Concatenazione con separatore
count Restituisce il conteggio totale delle righe
decode Decodificare utilizzando un set di caratteri
elt Restituisce il nth input
encode Codifica utilizzando un set di caratteri
first, first_value Restituisce il primo valore
grouping Indica se una colonna è raggruppata
grouping_id Restituisce il livello di raggruppamento
instr Restituisce un indice basato su 1 dell'occorrenza dei caratteri
json_tuple Restituisce una tupla da un input JSON
lag, lead Restituisce il valore prima dell'offset
last, last_value Restituisce l’ultimo valore
left Restituisce il primo n caratteri
length Restituisce la lunghezza della stringa
levenshtein Restituisce la distanza di Levenshtein tra stringhe
locate, position Restituisce la posizione della prima occorrenza di una sottostringa
map_concat Concatenare una mappa
map_keys Restituire le chiavi di una mappa
map_values Restituire i valori di una mappa
ntile Dividi righe in partizioni
nullif Restituisce null se true
nvl Restituisce il valore se null
nvl2 Restituisce il valore se non è nullo
parse_url Estrae parte di un URL
rank Calcola la classificazione di un valore
regexp_extract Estrae un elemento che corrisponde al regex
regex_replace Sostituisce un elemento che corrisponde al regex
repeat Restituisce una stringa che si ripete
replace Sostituire tutte le istanze di una stringa
rollup Creare un rollup multidimensionale
row_number Assegna un numero di riga univoco
schema_of_json Restituisce lo schema del JSON
sentences Divide la stringa in una matrice di parole
sequence Genera un array di elementi
shiftleft Spostamento bit per bit a sinistra firmato
shiftright Firmato spostamento bit per bit a destra
shiftrightunsigned Spostamento bit per bit a destra senza segno
size Restituisce la dimensione dell’array
space Restituisce una stringa con n spazi
split Dividi stringa
substring_index Indice restituito della sottostringa
window Finestra
xpath Analizza nodi XML
xpath_double, xpath_number Analizza nodi XML per doppio
xpath_float Analizza nodi XML per virgola mobile
xpath_int Analizza nodi XML per numero intero
xpath_long Analizza nodi XML per lunghi
xpath_short Analizza nodi XML per numero intero breve
xpath_string Analizza nodi XML per stringa

Informazioni correnti

Funzione Descrizione
current_database Restituisce il database corrente
current_date Restituisce la data corrente
current_timestamp, now Restituisce il timestamp corrente

Funzioni ordine superiore

Funzione Descrizione
transform Trasformare gli elementi in un array
exists Controlla se l'elemento esiste
filter Filtrare l’array di input
aggregate Applicare un operatore binario a tutti gli elementi

In questa pagina