Informazioni di riferimento sulle funzioni di Tableau Prep
Le funzioni di calcolo di Tableau Prep ti consentono di utilizzare campi calcolati per creare nuovi dati utilizzando i dati già esistenti nell’origine dati.
Funzioni numeriche
| Sintassi | Descrizione |
|---|---|
ABS(number) | Restituisce il valore assoluto del numero dato. Esempi:
|
ACOS(number) | Restituisce l’arcocoseno del numero dato. Il risultato è in radianti. Esempio:
|
ASIN(number) | Restituisce l’arcoseno di un numero dato. Il risultato è in radianti. Esempio:
|
ATAN(number) | Restituisce l’arcotangente di un numero dato. Il risultato è in radianti. Esempio:
|
ATAN2(y number, x number) | Restituisce l’arcotangente di due numeri dati (x e y). Il risultato è in radianti.Esempio:
|
CEILING(number) | Arrotonda un numero al numero intero più vicino di valore uguale o superiore. Esempio:
|
COS(number) | Restituisce il coseno di un angolo. Specifica l’angolo in radianti. Esempio:
|
COT(angle) | Restituisce la cotangente di un angolo. Specifica l’angolo in radianti. Esempio:
|
DIV(integer1, integer2) | Restituisce la parte intera di un’operazione di divisione, in cui integer1 è diviso per integer2.Esempio:
|
EXP(number) | Restituisce e innalzato alla potenza del numero dato. Esempi:
|
FLOOR(number) | Arrotonda un numero al numero intero più vicino di valore uguale o inferiore. Esempio:
|
HEXBINX(number, number) | Mappa una coordinata x, y alla coordinata x del contenitore esagonale più vicino. I contenitori hanno una lunghezza laterale di 1, quindi potrebbe essere necessario ridimensionare gli input in modo appropriato. Esempio:
|
HEXBINY(number, number) | Mappa una coordinata x, y alla coordinata y del contenitore esagonale più vicino. I contenitori hanno una lunghezza laterale di 1, quindi potrebbe essere necessario ridimensionare gli input in modo appropriato. Esempio:
|
LN(number) | Restituisce il logaritmo naturale di un numero dato. Restituisce Null se il numero è minore o uguale a 0. Esempio:
|
LOG(number [, base]) | Restituisce il logaritmo di un numero per la base data. Se il valore base viene omesso, si utilizza il valore base 10. Esempio:
|
MAX(number, number) | Restituisce il massimo dei due argomenti, che devono essere dello stesso tipo. Restituisce Null se un argomento è Null. MAX può anche essere applicato a un singolo campo in un calcolo aggregato.Esempi:
|
MIN(number, number) | Restituisce il minimo dei due argomenti, che devono essere dello stesso tipo. Restituisce Null se un argomento è Null. MIN può anche essere applicato a un singolo campo in un calcolo aggregato.Esempi:
|
PI( ) | Restituisce la costante numerica pi: 3,14159. Esempio:
|
POWER(number, power) | Aumenta il numero fino alla potenza specificata. Esempi:
È inoltre possibile utilizzare il simbolo ^:
|
RADIANS(number) | Converte il numero dato da gradi in radianti. Esempio:
|
ROUND(number, [decimals]) | Arrotonda i numeri a un determinato numero di cifre. L’argomento decimals specifica quante posizioni decimali di precisione includere nel risultato finale. Se decimals è omesso, il numero viene arrotondato al numero intero più vicino. Esempio: Questo esempio arrotonda ogni valore di Sales a un numero intero:
|
SIGN(number) | Restituisce il segno di un numero: i valori possibili di ritorno sono -1 se il numero è negativo, 0 se il numero è zero, o 1 se il numero è positivo. Esempio: Se la media del campo dei profitti è negativa, allora
|
SIN(number) | Restituisce il seno di un angolo. Specifica l’angolo in radianti. Esempi:
|
SQRT(number) | Restituisce la radice quadrata di un numero. Esempio:
|
SQUARE(number) | Restituisce il quadrato di un numero. Esempio:
|
TAN(number) | Restituisce la tangente di un angolo. Specifica l’angolo in radianti. Esempio:
|
ZN(expression) | Restituisce l’espressione se non è Null, altrimenti restituisce zero. Usa questa funzione per utilizzare valori zero invece di valori Null. Esempio:
|
Funzioni stringa
| Sintassi | Descrizione |
|---|---|
ASCII(string) | Restituisce il codice ASCII per il primo carattere di una stringa. Esempio:
|
CHAR(number) | Restituisce il carattere codificato tramite il numero del codice ASCII. Esempio:
|
CONTAINS(string, substring) | Restituisce true se la stringa data contiene la sottostringa specificata. Esempio:
|
ENDSWITH(string, substring) | Restituisce true se la stringa data termina con la sottostringa substring specificata. Gli spazi vuoti finali vengono ignorati.Esempio:
|
FIND(string, substring, [start]) | Restituisce la posizione dell’indice di substring nella stringa oppure 0 se la sottostringa non viene trovata. Se viene aggiunto l’argomento facoltativo start, la funzione ignora qualsiasi istanza di substring che appare prima della posizione dell’indice start. Il primo carattere della stringa è la posizione 1.Esempi:
|
FINDNTH(string, substring, occurrence) | Restituisce la posizione dell’occorrenza n della sottostringa all’interno della stringa specificata, dove n è definito dall’argomento dell’occorrenza. Esempio:
|
ISDATE(string) | Restituisce true se una determinata stringa è una data valida. Esempio:
|
LEFT(string, number) | Restituisce il numero di caratteri più a sinistra della stringa. Esempio:
|
LEN(string) | Restituisce la lunghezza della stringa. Esempio:
|
LOWER(string) | Restituisce la stringa con tutti i caratteri in minuscolo. Esempio:
|
LTRIM(string) | Restituisce la stringa con gli eventuali spazi iniziali rimossi. Esempio:
|
(MID(string, start, [length]) | Restituisce la stringa a partire dalla posizione dell’indice start. Il primo carattere della stringa è la posizione 1. Se viene aggiunto l’argomento facoltativo lenght, la stringa restituita include solo quel numero di caratteri. Esempi:
|
PROPER(string) | Converte una stringa di testo in modo che la prima lettera di ogni parola sia in maiuscolo e le lettere rimanenti siano in minuscolo. Anche gli spazi e i caratteri non alfanumerici, come la punteggiatura, fungono da separatori. Esempio:
|
REGEXP_EXTRACT(string, pattern) | Restituisce una sottostringa della stringa specificata che corrisponde al gruppo di acquisizione all’interno del modello di espressione regolare. Il modello di espressione regolare richiede esattamente un gruppo di acquisizione Esempio:
|
REGEXP_EXTRACT_NTH(string, pattern, index) | Restituisce una sottostringa della stringa specificata utilizzando il modello dell’espressione regolare. La porzione della stringa è abbinata al gruppo di acquisizione nth, dove n è l’indice dato. Esempio:
|
REGEXP_MATCH(string, pattern) | Restituisce True se una sottostringa della stringa specificata corrisponde al modello dell’espressione regolare. Esempio:
|
REGEXP_REPLACE(string, pattern, replacement) | Restituisce una copia della stringa data in cui il modello di corrispondenza è sostituito dalla stringa sostitutiva. Esempio:
|
REPLACE(string, substring, replacement) | Cerca una sottostringa nella stringa e la sostituisce con la sostituzione. Se la sottostringa non viene trovata, la stringa rimane inalterata. Esempio:
|
RIGHT(string, number) | Restituisce il numero di caratteri più a destra della stringa. Esempio:
|
RTRIM(string) | Restituisce la stringa con gli eventuali spazi finali rimossi. Esempio:
|
SPACE(number) | Restituisce una stringa composta dal numero specificato di spazi ripetuti. Esempio:
|
SPLIT(string, delimiter, token number)
| Restituisce una sottostringa da una stringa, come determinato da un delimitatore che estrae i caratteri dall’inizio o dalla fine della stringa. Esempio:
|
STARTSWITH(string, substring) | Restituisce True se la stringa inizia con substring. Gli spazi vuoti iniziali vengono ignorati.Esempio:
|
TRIM(string) | Restituisce la stringa con gli spazi iniziali e finali rimossi. Esempio:
|
UPPER(string) | Restituisce la stringa con tutti i caratteri in maiuscolo. Esempio:
|
Funzioni aggregate
| Sintassi | Descrizione |
|---|---|
AVG(expression) | Restituisce la media di tutti i valori nell’espressione. AVG può essere utilizzato solo con campi numerici. I valori Null vengono ignorati Esempio:
|
COUNT(expression) | Restituisce il numero di voci di un gruppo. I valori NULL non vengono conteggiati. Esempio:
|
COUNTD(expression) | Restituisce il numero di elementi distinti in un gruppo. I valori NULL non vengono conteggiati. Ogni valore univoco viene conteggiato una sola volta. Esempio:
|
MEDIAN(expression) | Restituisce la mediana di una singola espressione. MEDIAN può essere utilizzato solo con campi numerici. I valori NULL vengono ignorati. Esempio:
|
PERCENTILE(expression, number) | Calcolo aggregato che restituisce il valore percentile dell’espressione data corrispondente al numero specificato. I valori validi per il numero sono compresi tra 0 e 1. PERCENTILE([espressione], 0,50) restituirà sempre il valore mediano dell’espressione. Esempio:
|
STDEV(expression) | Restituisce la deviazione standard del campione dell’espressione. Esempio:
|
STDEVP(expression) | Restituisce la deviazione standard della popolazione dell’espressione. Esempio:
|
SUM(expression) | Restituisce la somma di tutti i valori nell’espressione. SUM può essere utilizzato solo con campi numerici. I valori NULL vengono ignorati. Esempio:
|
VAR(expression) | Restituisce la varianza statistica di tutti i valori dell’espressione data sulla base di un campione della popolazione. Esempio:
|
VARP(expression) | Restituisce la varianza statistica di tutti i valori dell’espressione data sulla base di un campione della popolazione. Esempio:
|
ZN(expression) | Restituisce l’espressione se non è Null, altrimenti restituisce zero. Usa questa funzione per utilizzare valori zero invece di valori Null. Esempio:
|
Funzioni di conversione del tipo
| Sintassi | Descrizione |
|---|---|
DATE | Restituisce una data con un numero, una stringa o un’espressione di data. Esempio:
Tieni presente che le virgolette sono obbligatorie. |
DATETIME(expression) | Restituisce data e ora con un numero, una stringa o un’espressione di data. Esempio:
Tieni presente che le virgolette sono obbligatorie. |
FLOAT(expression) | Restituisce un numero a virgola mobile data un’espressione di qualsiasi tipo. Questa funzione richiede numeri non formattati, il che significa che è necessario escludere virgole e altri simboli. Esempio:
|
INT(expression) | Restituisce un numero intero data un’espressione. Questa funzione tronca i risultati al numero intero più vicino allo zero. Esempio:
|
MAKEDATE(year, month, day) | Restituisce un valore di data costruito a partire da un anno, un mese e un giorno del mese. Esempio:
|
MAKEDATETIME(date, time) | Restituisce un valore di data e ora in base a un’espressione di data e un’espressione di ora. Esempio:
|
MAKETIME(hour, minute, second) | Restituisce un valore di ora costruito a partire da ore, minuti e secondi. Esempio:
|
STR(expression) | Restituisce una stringa data un’espressione. Esempio:
Restituisce tutti i valori della misura Age come stringhe. |
Funzioni data
| Sintassi | Descrizione |
|---|---|
DATEADD(date_part, interval, date) | Aggiunge un incremento alla data specificata e restituisce la nuova data. L’incremento è definito dall’intervallo e da date_part. Esempio:
|
DATEDIFF(date_part, start_date, end_date, [start_of_week]) | Restituisce la differenza tra due date, sottraendo start_date da end_date. La differenza è espressa in unità di date_part. Se start_of_week è omesso, il giorno di inizio della settimana viene determinato dal giorno di inizio configurato per l’origine dati. Esempio:
|
DATENAME(date_part, date, [start_of_week]) | Restituisce una parte della data specificata come stringa, dove la parte è definita da date_part. Se start_of_week è omesso, il giorno di inizio della settimana viene determinato dal giorno di inizio configurato per l’origine dati. Esempio:
|
DATEPARSE(format, string) | Converte una stringa in una data nel formato specificato. Esempio:
|
DATEPARTT(date_part, date, [start_of_week]) | Restituisce una parte della data specificata come numero intero, dove la parte è definita da date_part. Se start_of_week è omesso, il giorno di inizio della settimana viene determinato dal giorno di inizio configurato per l’origine dati. Esempio:
|
DATETRUNC(date_part, date, [start_of_week]) | Tronca la data specificata in base a quanto specificato da date_part e restituisce la nuova data. Se start_of_week è omesso, il giorno di inizio della settimana viene determinato dal giorno di inizio configurato per l’origine dati. Esempio:
|
DAY(date) | Restituisce il giorno della data indicata come numero intero. Esempio:
|
ISDATE(string) | Restituisce true se una determinata stringa è una data valida. Esempio:
|
MONTH(date) | Restituisce il mese della data specificata come numero intero. Esempio:
|
NOW() | Restituisce la data e l’ora correnti. Esempio:
|
TODAY() | Restituisce la data attuale. Esempio:
|
YEAR(date) | Restituisce l’anno della data specificata come numero intero. Esempio:
|
Funzioni logiche
| Sintassi | Descrizione |
|---|---|
IFNULL(expr1, expr2) | Restituisce <expr1> se non è Null, altrimenti <expr2>.Esempio:
|
IIF(test, then, else, [unknown]) | Controlla se una condizione è soddisfatta e restituisce un valore per TRUE, un altro valore per FALSE e un terzo valore opzionale o NULL se sconosciuto. Esempio:
|
ISDATE(string) | Restituisce true se una determinata stringa è una data valida. Esempio:
|
ISNULL(expression) | Restituisce True se l’espressione non contiene dati validi (Null).Esempio:
|
ZN(expression) | Restituisce l’espressione se non è Null, altrimenti restituisce zero. Usa questa funzione per utilizzare valori zero invece di valori Null. Esempio:
|
Funzioni analitiche
| Sintassi | Descrizione |
|---|---|
LAST_VALUE(expression, [return_last_non-null_value]) | Restituisce l’ultimo valore dell’espressione data, dalla prima riga della partizione alla riga corrente. Accetta un secondo parametro booleano facoltativo per restituire l’ultimo valore non Null. Esempio:
|
LOOKUP(expression, [offset]) | Restituisce il valore dell’espressione data in una riga di destinazione, specificato come offset relativo rispetto alla riga corrente. Se la riga di destinazione non è determinabile, restituisce NULL. Il parametro [ Esempio:
Restituisce il valore SALES dalla riga precedente. |
NTILE(number) | Distribuisce le righe in una partizione selezionata in un numero specificato di gruppi o sezioni. Con questa funzione l’insieme dei valori (6,9,9,14) distribuiti su 3 sezioni verrebbe assegnato alle sezioni (1,2,2,3) in ordine crescente. Esempio:
|
RANK() | Restituisce la classificazione standard della concorrenza per la riga corrente della partizione. A valori identici viene assegnata una classificazione identica. Esempio:
|
RANK_DENSE() | Restituisce la classificazione densa per la riga corrente della partizione. A valori identici è assegnata una classificazione identica, ma nella sequenza numerica non vengono inseriti intervalli. Esempio:
|
RANK_MODIFIED() | Restituisce la classificazione modificata della concorrenza per la riga corrente della partizione. A valori identici viene assegnata una classificazione identica. Esempio:
|
RANK_PERCENTILE() | Restituisce la classificazione percentile per la riga corrente della partizione. Esempio:
|
ROW_NUMBER() | Restituisce un ID di riga sequenziale univoco per ogni riga. Esempio:
|
RUNNING_AVG(expression) | Restituisce la media mobile dell’espressione data, dalla prima riga della partizione alla riga corrente. Esempio:
|
RUNNING_SUM(expression) | Restituisce la somma corrente dell’espressione data, dalla prima riga della partizione alla riga corrente. Esempio:
|
Parole chiave
| Funzione | Descrizione |
|---|---|
AND | Esegue una congiunzione logica su due espressioni Esempio:
|
ASC | Definisce l’ordine crescente per le operazioni ORDERBY .Esempio
|
CASE | Trova il primo <value> che corrisponde a <expr> e restituisce il valore <return> corrispondente.Esempio:
|
DESC | Definisce l’ordine decrescente per le operazioni ORDERBY . Esempio:
|
ELSE | Testa una serie di espressioni e restituisce il valore <then> per la prima espressione <expr> True. Esempio:
|
ELSEIF | Testa una serie di espressioni e restituisce il valore <then> per la prima espressione <expr> True. Equivalente all’inserimento di un’istruzione if all’interno di un’operazione ELSE.Esempio:
|
END | Termina un’operazione introdotta dalla direttiva corrispondente. Esempio:
|
{ FIXED } | Le espressioni Level of Detail FIXED calcolano i valori utilizzando le dimensioni specificate, senza riferimento al livello di dettaglio della vista. Esempio:
|
IF | Crea un’istruzione condizionale (istruzione IF) e consente l’esecuzione solo se una condizione è True.Esempio:
|
NOT | Esegue una negazione logica su un’espressione. Esempio:
|
OR | Esegue una disgiunzione logica su un’espressione. Esempio:
|
{ ORDERBY } | Definisce l’ordine di applicazione delle funzioni analitiche. Utilizzare l’argomento facoltativo asc | desc per specificare l’ordine crescente o decrescente per ciascun campo. Esempio:
|
{ PARTITION } | Definisce il gruppo per le funzioni analitiche. ORDERBY deve essere all’interno della partizione. Esempio:
|
THEN | Testa una serie di espressioni e restituisce il valore <then> per la prima espressione <expr> True. Esempio:
|
WHEN | Trova il primo <value> che corrisponde a <expr> e restituisce il valore <return> corrispondente. Esempio:
|