Spark Funzioni SQL

È possibile utilizzare diverse funzioni SQL Spark incorporate per estendere le funzionalità SQL con Adobe Experience Platform Query Service. 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, leggere Documentazione della funzione SQL Spark.

NOTE
Non tutte le funzioni nella documentazione esterna sono supportate.

Operatori e funzioni matematiche e statistiche math

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 logical-operators

Operatore/funzione
Descrizione
! o not
Non logico
<
Minore di
<=
Minore o uguale a
=
Uguale
>
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 datetime-functions

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 la marca temporale UNIX®
weekday
Giorno della settimana (0-6)
weekofyear
Restituisce la settimana dell’anno per una data specificata
year
Restituisce l’anno della stringa

Matrici arrays

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
Separare gli elementi di un 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 datatype-casting

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 conversion

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
Modifica la stringa in modo che sia maiuscola/minuscola
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 data-evaluation

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 current-information

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

Funzioni di ordine superiore higher-order

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
recommendation-more-help
ccf2b369-4031-483f-af63-a93b5ae5e3fb