Documentazione Experience Platform Guida di Query Service

Spark funzioni SQL

Ultimo aggiornamento: 16 luglio 2024

Argomenti:
Query

Creato per:

Utente
Sviluppatore

È 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 la documentazione sulle funzioni SQL Spark.

NOTE

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

Array

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

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`	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

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 `n` 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 i primi `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

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

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