Funzioni di Tableau (per categoria)

Le funzioni di Tableau in questo riferimento sono organizzate per categoria. Fai clic su una categoria per visualizzarne le funzioni. In alternativa, premi CTRL+F (Comando+F su Mac) per aprire una casella di ricerca che puoi utilizzare per cercare una specifica funzione nella pagina.

Funzioni numeriche

Funzione

Sintassi

Descrizione

ABS

ABS(number)

Restituisce il valore assoluto del numero dato.

Esempi:

ABS(-7) = 7
ABS([Budget Variance])

Il secondo esempio restituisce il valore assoluto per tutti i numeri contenuti nel campo Budget Variance.

ACOS

ACOS(number)

Restituisce l'arcocoseno del numero dato. Il risultato è in radianti.

Esempio:

ACOS(-1) = 3.14159265358979

ASIN

ASIN(number)

Restituisce l'arcoseno di un numero dato. Il risultato è in radianti.

Esempio:

ASIN(1) = 1.5707963267949

ATAN

ATAN(number)

Restituisce l'arcotangente di un numero dato. Il risultato è in radianti.

Esempio:

ATAN(180) = 1.5652408283942

ATAN2

ATAN2(y number, x number)

Restituisce l'arcotangente di due numeri dati (x e y). Il risultato è in radianti.

Esempio:

ATAN2(2, 1) = 1.10714871779409

CEILING

CEILING(number)

Arrotonda un numero al numero intero più vicino di valore uguale o superiore.

Esempio:

CEILING(3.1415) = 4

Disponibilità per origine dati:

Origine datiAssistenza
Microsoft AccessNon supportato
Microsoft ExcelSupportato
File di testoSupportato
File statisticoSupportato
Tableau ServerSupportato
Actian VectorNon supportato
Amazon Aurora per MySQLNon supportato
Amazon EMR Hadoop HiveSupportato
Amazon RedshiftSupportato
Aster DatabaseNon supportato
Cloudera HadoopSupportato
DataStax EnterpriseSupportato
EXASOLNon supportato
FirebirdNon supportato
Google AnalyticsSupportato
Google BigQuerySupportato
Google Cloud SQLNon supportato
Fogli GoogleNon supportato
Hortonworks Hadoop HiveSupportato
IBM BigInsightsNon supportato
IBM DB2Non supportato
IBM PDA (Netezza)Non supportato
MapR Hadoop HiveSupportato
MarkLogicNon supportato
Microsoft Analysis ServicesNon supportato
Microsoft PowerPivotNon supportato
Microsoft SQL ServerSupportato
MySQLNon supportato
OracleNon supportato
Oracle EssbaseNon supportato
Actian Matrix (ParAccel)Non supportato
Pivotal GreenplumNon supportato
PostgreSQLNon supportato
Progress OpenEdgeNon supportato
SalesforceSupportato
SAP HANANon supportato
SAP Sybase ASENon supportato
SAP Sybase IQNon supportato
Spark SQLSupportato
SplunkNon supportato
TeradataNon supportato
Teradata OLAP ConnectorNon supportato
VerticaNon supportato

COS

COS(number)

Restituisce il coseno di un angolo. Specifica l'angolo in radianti.

Esempio:

COS(PI( ) /4) = 0.707106781186548

COT

COT(number)

Restituisce la cotangente di un angolo. Specifica l'angolo in radianti.

Esempio:

COT(PI( ) /4) = 1

DEGREES

DEGREES(number)

Converte un dato numero da radianti in gradi.

Esempio:

DEGREES(PI( )/4) = 45.0

DIV

DIV(integer1, integer2)

Restituisce la parte intera di un'operazione di divisione, in cui integer1 è diviso per integer2.

Esempio:

DIV(11,2) = 5

EXP

EXP(number)

Restituisce e innalzato alla potenza del numero dato.

Esempi:

EXP(2) = 7.389
EXP(-[Growth Rate]*[Time])

FLOOR

FLOOR(number)

Arrotonda un numero al numero intero più vicino di valore uguale o inferiore.

Esempio:

FLOOR(3.1415) = 3

Disponibilità per origine dati:

Origine datiAssistenza
Microsoft AccessNon supportato
Microsoft ExcelSupportato
File di testoSupportato
File statisticoSupportato
Tableau ServerSupportato
Actian VectorNon supportato
Amazon Aurora per MySQLNon supportato
Amazon EMR Hadoop HiveSupportato
Amazon RedshiftNon supportato
Aster DatabaseNon supportato
Cloudera HadoopSupportato
DataStax EnterpriseSupportato
EXASOLNon supportato
FirebirdNon supportato
Google AnalyticsSupportato
Google BigQuerySupportato
Google Cloud SQLNon supportato
Hortonworks Hadoop HiveSupportato
IBM BigInsightsNon supportato
IBM DB2Non supportato
IBM NetezzaNon supportato
MapR Hadoop HiveSupportato
MarkLogicNon supportato
Microsoft Analysis ServicesNon supportato
Microsoft PowerPivotNon supportato
Microsoft SQL ServerSupportato
MySQLNon supportato
OracleNon supportato
Oracle EssbaseNon supportato
ParAccelNon supportato
Pivotal GreenplumNon supportato
PostgreSQLNon supportato
Progress OpenEdgeNon supportato
SalesforceSupportato
SAP HANANon supportato
SAP Sybase ASENon supportato
SAP Sybase IQNon supportato
Spark SQLSupportato
SplunkNon supportato
TeradataNon supportato
Teradata OLAP ConnectorNon supportato
VerticaNon supportato

HEXBINX

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.

HEXBINX e HEXBINY sono funzioni di creazione di contenitori e tracciato per contenitori esagonali. I contenitori esagonali sono un'opzione efficiente ed elegante per visualizzare i dati in un piano x/y come ad esempio una mappa. Poiché i contenitori sono esagonali, ogni contenitore si avvicina molto a un cerchio e riduce al minimo la variazione della distanza tra il punto dati e il centro del contenitore. Questo rende il clustering più accurato e informativo.

Esempio:

HEXBINX([Longitude], [Latitude])

HEXBINY

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:

HEXBINY([Longitude], [Latitude])

LN

LN(number)

Restituisce il logaritmo naturale di un numero dato. Restituisce Null se il numero è inferiore o uguale a 0.

LOG

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.

MAX

MAX(number, number)

Restituisce il massimo dei due argomenti, che devono essere dello stesso tipo. Restituisce Null se uno dei due argomenti è Null. MAX può anche essere applicato a un singolo campo in un calcolo aggregato.

Esempi:

MAX(4,7)
MAX(Sales,Profit)
MAX([First Name],[Last Name])

MIN

MIN(number, number)

Restituisce il minimo dei due argomenti, che devono essere dello stesso tipo. Restituisce Null se uno dei due argomenti è Null. MIN può anche essere applicato a un singolo campo in un calcolo aggregato.

Esempi:

MIN(4,7)
MIN(Sales,Profit)
MIN([First Name],[Last Name])

PI

PI( )

Restituisce la costante numerica pi: 3,14159.

POWER

POWER(number, power)

Aumenta il numero fino alla potenza specificata.

Esempi:

POWER(5,2) = 52 = 25
POWER(Temperature, 2)

È inoltre possibile utilizzare il simbolo ^:

5^2 = POWER(5,2) = 25

RADIANS

RADIANS(number)

Converte il numero dato da gradi in radianti.

Esempio:

RADIANS(180) = 3.14159

ROUND

ROUND(number, [decimals])

Arrotonda i numeri a un determinato numero di cifre. L'argomento decimals specifica quanti punti decimali di precisione includere nel risultato finale. Se decimals è omesso, number viene arrotondato al numero intero più vicino.

Esempio:

Questo esempio arrotonda ogni valore Sales ad un intero:

ROUND(Sales)

Alcuni database, come SQL Server, permettono di specificare una length negativa, dove -1 arrotonda number a 10, -2 arrotonda a 100 e così via. Questo non è vero per tutti i database. Ad esempio, non è vero per Excel o Access.

Nota: poiché ROUND può incorrere in problemi dovuti alla rappresentazione in virgola mobile sottostante dei numeri, ad esempio 9,405 arrotondato a 9,40, potrebbe essere preferibile formattare il numero al numero desiderato di punti decimali anziché arrotondarlo. Formattando 9,405 a due cifre decimali si otterrà il valore previsto 9,41.

SIGN

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

SIGN(AVG(Profit)) = -1

SIN

SIN(number)

Restituisce il seno di un angolo. Specifica l'angolo in radianti.

Esempi:

SIN(0) = 1.0
SIN(PI( )/4) = 0.707106781186548

SQRT

SQRT(number)

Restituisce la radice quadrata di un numero.

Esempio:

SQRT(25) = 5

SQUARE

SQUARE(number)

Restituisce il quadrato di un numero.

Esempio:

SQUARE(5) = 25

TAN

TAN(number)

Restituisce la tangente di un angolo. Specifica l'angolo in radianti.

Esempio:

TAN(PI ( )/4) = 1.0

ZN

ZN(expression)

Restituisce l'espressione se non è nulla, altrimenti restituisce zero. Usare questa funzione per usare valori zero invece di valori nulli.

Esempio:

ZN([Profit]) = [Profit]

Funzioni stringa

Funzione

Sintassi

Definizione

ASCII

ASCII(string)

Restituisce il codice ASCII per il primo carattere di string.

Esempio:

ASCII('A') = 65

CHAR

CHAR(number)

Restituisce il carattere codificato dal codice ASCII number.

Esempio:

CHAR(65) = 'A'

CONTAINS

CONTAINS(string, substring)

Restituisce true se la stringa data contiene la sottostringa specificata.

Esempio:

CONTAINS(“Calculation”, “alcu”) = true

ENDSWITH

ENDSWITH(string, substring)

Restituisce true se la stringa data termina con la sottostringa specificata. Gli spazi bianchi finali vengono ignorati.

Esempio:

ENDSWITH(“Tableau”, “leau”) = true

FIND

FIND(string, substring, [start])

Restituisce la posizione dell'indice di substring in string, oppure 0 se substring non viene trovata. Se viene aggiunto l'argomento opzionale 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:

FIND("Calculation", "alcu") = 2
FIND("Calculation", "Computer") = 0
FIND("Calculation", "a", 3) = 7
FIND("Calculation", "a", 2) = 2
FIND("Calculation", "a", 8) = 0
FIND("Calculation", "a", 3) = 7
FIND("Calculation", "a", 2) = 2
FIND("Calculation", "a", 8) = 0

FINDNTH

FINDNTH(string, substring, occurrence)

Restituisce la posizione dell'occorrenza n della sottostringa all'interno della stringa specificata, dove n è definito dall'argomento dell'occorrenza.

Nota: FINDNTH non è disponibile per tutte le origini dati.

Esempio:

FINDNTH("Calculation", "a", 2) = 7

LEFT

LEFT(string, number)

Restituisce il numero di caratteri più a sinistra della stringa.

Esempio:

LEFT("Matador", 4) = "Mata"

LEN

LEN(string)

Restituisce la lunghezza della stringa.

Esempio:

LEN("Matador") = 7

LOWER

LOWER(string)

Restituisce string, con tutti i caratteri minuscoli.

Esempio:

LOWER("ProductVersion") = "productversion"

LTRIM

LTRIM(string)

Restituisce la stringa con gli eventuali spazi iniziali rimossi.

Esempio:

LTRIM(" Matador ") = "Matador "

MAX

MAX(a, b)

 

Restituisce il massimo di a e b (che devono essere dello stesso tipo). Questa funzione viene solitamente utilizzata per confrontare i numeri, ma funziona anche con le stringhe. Con le stringhe, MAX permette di trovare il valore più alto nella sequenza di ordinamento definita dal database per quella colonna. Restituisce Null se uno dei due argomenti è Null.

Esempio:

MAX ("Apple","Banana") = "Banana"

MID

(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 opzionale length, la stringa restituita include solo quel numero di caratteri.

Esempi:

MID("Calculation", 2) = "alculation"
MID("Calculation", 2, 5) ="alcul"

MIN

MIN(a, b)

Restituisce il minimo di a e b (che devono essere dello stesso tipo). Questa funzione viene solitamente utilizzata per confrontare i numeri, ma funziona anche con le stringhe. Con le stringhe, MIN consente di trovare il valore più basso nella sequenza di ordinamento. Restituisce Null se uno dei due argomenti è Null.

Esempio:

MIN ("Apple","Banana") = "Apple"

PROPERPROPER(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:

PROPER("PRODUCT name") = "Product Name"

PROPER("darcy-mae") = "Darcy-Mae"

REPLACE

REPLACE(string, substring, replacement)

Cerca in string provare substring e la sostituisce con replacement. Se substring non viene trovata, la stringa rimane inalterata.

Esempio:

REPLACE("Version8.5", "8.5", "9.0") = "Version9.0"

RIGHT

RIGHT(string, number)

Restituisce il numero di caratteri più a destra in string.

Esempio:

RIGHT("Calculation", 4) = "tion"

RTRIM

RTRIM(string)

Restituisce string con gli eventuali spazi finali rimossi.

Esempio:

RTRIM(" Calculation ") = " Calculation"

SPACE

SPACE(number)

Restituisce una stringa composta dal number specificato di spazi ripetuti.

Esempio:

SPACE(1) = " "

SPLIT

SPLIT(string, delimiter, token number)

Restituisce una sottostringa da una stringa, usando un carattere delimitatore per dividere la stringa in una sequenza di token.

La stringa è interpretata come una sequenza alternata di delimitatori e token. Quindi per la stringa abc-defgh-i-jkl, dove il carattere delimitatore è '-', i token sono abc, defgh, i e jlk. Considerali come i token da 1 a 4. SPLIT restituisce il token corrispondente al numero del token. Quando il numero di token è positivo, i token sono contati a partire dall'estremità sinistra della stringa; quando il numero di token è negativo, i token sono contati a partire da destra.

Esempi:

SPLIT (‘a-b-c-d’, ‘-‘, 2) = ‘b’
SPLIT (‘a|b|c|d’, ‘|‘, -2) = ‘c’


Nota: i comandi di divisione e di divisione personalizzata sono disponibili per i tipi di origini dati seguenti: estratti di dati di Tableau, Microsoft Excel, file di testo, file PDF, Salesforce, OData, Microsoft Azure Market Place, Google Analytics, Vertica, Oracle, MySQL, PostgreSQL, Teradata, Amazon Redshift, Aster Data, Google Big Query, Cloudera Hadoop Hive, Hortonworks Hive e Microsoft SQL Server.

Alcune origini dati impongono limiti alla stringa di divisione. La tabella seguente indica quali origini dati supportano i numeri di token negativi (divisione da destra) e se esiste un limite al numero di divisioni consentite per origine dati. Una funzione SPLIT che specifica un numero di token negativo e che sarebbe consentita con altre origini dati, con le origini dati seguenti restituirà questo errore: "Splitting from right is not support by the data source" (La divisione da destra non è supportata dall'origine dati).

 

Origine datiVincoli a sinistra/destraNumero massimo di divisioniLimiti di versione
Estratto di dati di TableauEntrambiInfinito 
Microsoft ExcelEntrambiInfinito 
File di testoEntrambiInfinito 
SalesforceEntrambiInfinito 
ODataEntrambiInfinito 
Google AnalyticsEntrambiInfinito 
Server di dati TableauEntrambiInfinitoSupportato nella versione 9.0.
VerticaSolo a sinistra10 
OracleSolo a sinistra10 
MySQLEntrambi10 
PostgreSQLA sinistra solo prima della versione 9.0; entrambi per la versione 9.0 e superiori.10 
TeradataSolo a sinistra10Versione 14 e successive
Amazon RedshiftSolo a sinistra10 
Aster DatabaseSolo a sinistra10 
Google BigQuerySolo a sinistra10 
Hortonworks Hadoop HiveSolo a sinistra10 
Cloudera HadoopSolo a sinistra10Impala supportato a partire dalla versione 2.3.0.
Microsoft SQL ServerEntrambi102008 e successive.

STARTSWITH

STARTSWITH(string, substring)

Restituisce true se string inizia con substring. Gli spazi bianchi iniziali vengono ignorati.

Esempio:

STARTSWITH(“Joker”, “Jo”) = true

TRIM

TRIM(string)

Restituisce la stringa con gli spazi iniziali e finali rimossi.

Esempio:

TRIM(" Calculation ") = "Calculation"

UPPER

UPPER(string)

Restituisce la stringa con tutti i caratteri in maiuscolo.

Esempio:

UPPER("Calculation") = "CALCULATION"

Funzioni data

Tableau offre diverse funzioni data. Molti degli esempi utilizzano il simbolo # con le espressioni di data. Per una spiegazione su questo simbolo, consulta Sintassi delle espressioni letterali. Inoltre, molte funzioni data utilizzano date_part, ovvero un argomento stringa costante. I valori date_part validi che puoi utilizzare sono:

date_partValori
'year'Anno in quattro cifre
'quarter'1-4
'month'1-12 o "January", "February" e così via.
'dayofyear'Giorno dell'anno: l'1 gennaio è 1, l'1 febbraio è 32 e così via.
'day'1-31
'weekday'1-7 o "Sunday", "Monday" e così via
'week'1-52
'hour'0-23
'minute'0-59
'second'0-60

Nota: le funzioni data non tengono conto dell'inizio dell'anno fiscale configurato. Consulta Date fiscali.

Funzione

Sintassi

Descrizione

DATEADD

DATEADD(date_part, interval, date)

Restituisce la data specificata con il numero specificato interval aggiunto alla date_part di tale data.

Supporta le date ISO 8601.

Esempio:

DATEADD('month', 3, #2004-04-15#) = 2004-07-15 12:00:00 AM

Questa espressione aggiunge tre mesi alla data #2004-04-15#.

DATEDIFF

DATEDIFF(date_part, date1, date2, [start_of_week])

Restituisce la differenza tra date1 e date2 espressa in unità di date_part.

Il parametro start_of_week, con il quale è possibile specificare il giorno da considerare come primo giorno della settimana, è opzionale. I valori possibili sono "lunedì", "martedì", ecc. Se è omesso, l'inizio della settimana è determinato dall'origine dati. Consulta Proprietà data per un'origine dati.

Supporta le date ISO 8601.

Esempi:

DATEDIFF('week', #2013-09-22#, #2013-09-24#, 'monday')= 1
DATEDIFF('week', #2013-09-22#, #2013-09-24#, 'sunday')= 0

La prima espressione restituisce 1 perché quando start_of_week è "lunedì", il 22 settembre (una domenica) e il 24 settembre (un martedì) appartengono a settimane diverse. La prima espressione restituisce 0 perché quando start_of_week è "lunedì", il 22 settembre (una domenica) e il 24 settembre (un martedì) appartengono a settimane diverse.

DATENAME

DATENAME(date_part, date, [start_of_week])

Restituisce date_part di date come una stringa. Il parametro start_of_week, con il quale è possibile specificare il giorno da considerare come primo giorno della settimana, è opzionale. I valori possibili sono "lunedì", "martedì", ecc. Se start_of_week è omesso, l'inizio della settimana è determinato dall'origine dati. Consulta Proprietà data per un'origine dati.

Supporta le date ISO 8601.

Esempi:

DATENAME('year', #2004-04-15#) = "2004"
DATENAME('month', #2004-04-15#) = "April"

DATEPARSEDATEPARSE(date_format, [date_string])

Restituisce [date_string] come data. L'argomento date_format descrive come viene disposto il campo [string]. A causa dei vari modi in cui può essere ordinato il campo string, date_format deve corrispondere esattamente. Per una spiegazione completa, consulta Convertire un campo in un campo di data.

Esempio:

DATEPARSE('yyyy-MM-dd', #2004-04-15#) = "April 4, 2004"

Nota: questa funzione è disponibile attraverso i seguenti connettori: connessioni non legacy Excel e file di testo, Amazon EMR Hadoop Hive, Cloudera Hadoop, Google Sheets, Hortonworks Hadoop Hive, MapR Hadoop Hive, MySQL, Oracle, PostgreSQL ed estrazioni di Tableau. Alcuni formati potrebbero non essere disponibili per tutte le connessioni.

Nota: DATEPARSE non è supportato nelle varianti di Hive. Sono supportati solo Denodo, Drill e Snowflake.

DATEPART

DATEPART(date_part, date, [start_of_week])

Restituisce date_part di date come numero intero.

Il parametro start_of_week, con il quale è possibile specificare il giorno da considerare come primo giorno della settimana, è opzionale. I valori possibili sono "lunedì", "martedì", ecc. Se start_of_week è omesso, l'inizio della settimana è determinato dall'origine dati. Consulta Proprietà data per un'origine dati.

Nota: quando date_part è un giorno della settimana, il parametro start_of_week viene ignorato. Questo avviene perché Tableau si basa su un giorno feriale fisso per applicare gli offset.

Supporta le date ISO 8601.

Esempi:

DATEPART('year', #2004-04-15#) = 2004
DATEPART('month', #2004-04-15#) = 4

DATETRUNC

DATETRUNC(date_part, date, [start_of_week])

Tronca la data specificata in base a quanto specificato dalla date_part. Questa funzione restituisce una nuova data. Ad esempio, quando si tronca una data che si trova a metà del mese a livello mensile, questa funzione restituisce il primo giorno del mese. Il parametro start_of_week, con il quale è possibile specificare il giorno da considerare come primo giorno della settimana, è opzionale. I valori possibili sono "lunedì", "martedì", ecc. Se start_of_week è omesso, l'inizio della settimana è determinato dall'origine dati. Consulta Proprietà data per un'origine dati.

Supporta le date ISO 8601.

Esempi:

DATETRUNC('quarter', #2004-08-15#) = 2004-07-01 12:00:00 AM
DATETRUNC('month', #2004-04-15#) = 2004-04-01 12:00:00 AM

DAY

DAY(date)

Restituisce il giorno della data indicata come numero intero.

Esempio:

DAY(#2004-04-12#) = 12

ISDATE

ISDATE(string)

Restituisce true se una determinata stringa è una data valida.

Esempio:

ISDATE("April 15, 2004") = true

MAKEDATE

MAKEDATE(year, month, day)

Restituisce un valore di data costruito a partire dall'anno, dal mese e dalla data specificati.

Disponibile per le estrazioni dei dati di Tableau. Verifica la disponibilità in altre origini dati.

Esempio:

MAKEDATE(2004, 4, 15) = #April 15, 2004#

MAKEDATETIME

MAKEDATETIME(date, time)

Restituisce un valore data e ora che combina una data e un'ora. La data può essere una data, un valore data e ora o un tipo di stringa. L'ora deve essere un valore data e ora.

Nota: questa funzione è disponibile solo per connessioni compatibili con MySQL (che per Tableau sono, oltre a MySQL e Amazon Aurora).

Esempi:

MAKEDATETIME("1899-12-30", #07:59:00#) = #12/30/1899 7:59:00 AM#
MAKEDATETIME([Date], [Time]) = #1/1/2001 6:00:00 AM#

MAKETIME

MAKETIME(hour, minute, second)

Restituisce un valore di data costruito a partire da ore, minuti e secondi specificati.

Disponibile per le estrazioni dei dati di Tableau. Verifica la disponibilità in altre origini dati.

Esempio:

MAKETIME(14, 52, 40) = #14:52:40#

MAX

MAX(expression) or MAX(expr1, expr2)

Di solito si applica ai numeri, ma funziona anche con le date. Restituisce il massimo di a e b (a e b deve essere dello stesso tipo). Restituisce Null se uno dei due argomenti è Null.

Esempi:

MAX(#2004-01-01# ,#2004-03-01#) = 2004-03-01 12:00:00 AM
MAX([ShipDate1], [ShipDate2])

MIN

MIN(expression) or MIN(expr1, expr2)

Di solito si applica ai numeri, ma funziona anche con le date. Restituisce il minimo di a e b (a e b deve essere dello stesso tipo). Restituisce Null se uno dei due argomenti è Null.

Esempi:

MIN(#2004-01-01# ,#2004-03-01#) = 2004-01-01 12:00:00 AM
MIN([ShipDate1], [ShipDate2])

MONTH

MONTH(date)

Restituisce il mese della data indicata come numero intero.

Esempio:

MONTH(#2004-04-15#) = 4

NOW

NOW( )

Restituisce la data e l'ora correnti del sistema locale.

Esempio:

NOW( ) = 2004-04-15 1:08:21 PM

QUARTERQUARTER ( )

Restituisce il trimestre della data indicata come numero intero.

Esempio:

QUARTER(#2004-04-15#) = 2

TODAY

TODAY( )

Restituisce la data attuale.

Esempio:

TODAY( ) = 2004-04-15

WEEKWEEK( )

Restituisce la settimana della data indicata come numero intero.

Esempio:

WEEK (#2004-04-15#) = 16

YEAR

YEAR (date)

Restituisce l'anno della data indicata come numero intero.

Esempio:

YEAR(#2004-04-15#) = 2004

ISOQUARTERISOQUARTER (date)

Restituisce il trimestre basato sul calendario settimanale ISO-8601 della data indicata come numero intero.

Esempio:

ISOQUARTER (#2005-03-29#) = 2

ISOWEEKISOWEEK (date)

Restituisce la settimana basata sul calendario settimanale ISO-8601 della data indicata come numero intero.

Esempio:

ISOWEEK (#2004-03-29#) = 14

ISOWEEKDAYISOWEEKDAY (date)

Restituisce il giorno feriale basato sul calendario settimanale ISO-8601 della data indicata come numero intero.

Esempio:

ISOWEEKDAY (#2004-03-29#) = 1

ISOYEARISOYEAR (date)

Restituisce l'anno basato sul calendario settimanale ISO-8601 della data indicata come numero intero.

Esempio:

ISOYEAR (#2003-12-29#) = 2004

Funzioni logiche

Funzione

Sintassi

Descrizione

IN<expr1> IN <expr2>

Restituisce TRUE se qualsiasi valore in <expr1> corrisponde a qualsiasi valore in <expr2>.

I valori in <expr2> possono essere un insieme, un elenco di valori letterali o un campo combinato.

Esempi:

SUM([Cost]) IN (1000, 15, 200)

[Field] IN [SET]

AND

IF <expr1> AND <expr2> THEN <then> END

Esegue una congiunzione logica su due espressioni.

Esempio:

IF (ATTR([Market]) = "New Business" AND SUM([Sales]) > [Emerging Threshold] )THEN "Well Performing"

CASECASE <expression> WHEN <value1> THEN <return1> WHEN <value2> THEN <return2> ... ELSE <default return> END

Esegue i test logici e restituisce i valori appropriati. La funzione CASE valuta expression, lo confronta con una sequenza di valori, value1, value2, ecc. e restituisce un risultato. Quando rileva un valore corrispondente a expression, CASE restituisce il corrispondente valore di ritorno. Se non trova alcuna corrispondenza, utilizza l'espressione di restituzione predefinita. Se non c'è un'espressione di restituzione predefinita né valori corrispondenti, restituisce Null.

CASE supporta anche la costruzione WHEN IN, ad esempio

CASE <expression> WHEN IN <set1> THEN <return1> WHEN IN <combinedfield> THEN <return2> ... ELSE <default> END

I valori con cui si confronta WHEN IN, devono essere un insieme, un elenco di valori letterali o un campo combinato.

Note aggiuntive

  • CASE e IF: CASE è spesso più facile da usare di IIF o IF THEN ELSE. In genere una funzione IF esegue una sequenza di test arbitrari, mentre una funzione CASE cerca la corrispondenza con un'espressione. Ma una funzione CASE può sempre essere riscritta come funzione IF, anche se la funzione CASE sarà generalmente più concisa.
  • CASE e gruppi: molte volte è possibile utilizzare un gruppo per ottenere gli stessi risultati di una funzione CASE complicata. Potresti voler vedere quale è più performante per il tuo scenario.

Esempi:

CASE [Region] WHEN 'West' THEN 1 WHEN 'East' THEN 2 ELSE 3 END

CASE LEFT(DATENAME('weekday',[Order Date]),3) WHEN 'Sun' THEN 0 WHEN 'Mon' THEN 1 WHEN 'Tue' THEN 2 WHEN 'Wed' THEN 3 WHEN 'Thu' THEN 4 WHEN 'Fri' THEN 5 WHEN 'Sat' THEN 6 END

ELSEIF <expr> THEN <then> ELSE <else> END

Testa una serie di espressioni che restituiscono il valore <then> per la prima <expr> true.

Esempio:

If [Profit] > 0 THEN 'Profitable' ELSE 'Loss' END

ELSEIFIF <expr> THEN <then> [ELSEIF <expr2> THEN <then2>...] [ELSE <else>] END

Testa una serie di espressioni che restituiscono il valore <then> per la prima <expr> true.

Esempio:

IF [Profit] > 0 THEN 'Profitable' ELSEIF [Profit] = 0 THEN 'Breakeven' ELSE 'Loss' END

ENDIF <expr> THEN <then> [ELSEIF <expr2> THEN <then2>...] [ELSE <else>] END

Testa una serie di espressioni che restituiscono il valore <then> per la prima <expr> true. Deve essere posto alla fine di un'espressione.

Esempio:

IF [Profit] > 0 THEN 'Profitable' ELSEIF [Profit] = 0 THEN 'Breakeven' ELSE 'Loss' END

IFIF <expr> THEN <then> [ELSEIF <expr2> THEN <then2>...] [ELSE <else>] END

Testa una serie di espressioni che restituiscono il valore <then> per la prima <expr> true.

Esempio:

IF [Profit] > 0 THEN 'Profitable' ELSEIF [Profit] = 0 THEN 'Breakeven' ELSE 'Loss' END

IFNULLIFNULL(expr1, expr2)

Restituisce <expr1> se non è null, altrimenti restituisce <expr2>.

Esempio:

IFNULL([Profit], 0)

IIFIIF(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:

IIF([Profit] > 0, 'Profit', 'Loss')

ISDATEISDATE(string)

Restituisce true se una determinata stringa è una data valida.

Esempio:

ISDATE("2004-04-15") = True

ISNULLISNULL(expression)

Restituisce true se l'espressione è NULL (non contiene dati validi).

Esempio:

ISNULL([Profit])

MAXMAX(expression) oppure Max(expr1, expr2)

Restituisce il massimo di una singola espressione in tutti i record o il massimo di due espressioni per ogni record.

Esempio:

MAX([Sales])

MINMIN(expression) oppure MIN(expr1, expr2)

Restituisce il minimo di un'espressione in tutti i record o il minimo di due espressioni per ogni record.

Esempio:

MIN([Profit])

NOTIF NOT <expr> THEN <then> END

Esegue una negazione logica su un'espressione.

Esempio:

IF NOT [Profit] > 0 THEN "Unprofitable" END

ORIF <expr1> OR <expr2> THEN <then> END

Esegue una disgiunzione logica su due espressioni.

Esempio:

IF [Profit] < 0 OR [Profit] = 0 THEN "Needs Improvement" END

THENIF <expre> THEN <then> [ELSEIF ,expr2> THEN <then2>...] [ELSE <else>] END

Testa una serie di espressioni che restituiscono il valore <then> per la prima <expr> true.

Esempio:

IF [Profit] > 0 THEN 'Profitable' ELSEIF [Profit] = 0 THEN 'Break even' ELSE 'unprofitable' END

WHENCASE <expr> WHEN <Value1> THEN <return1> ... [ELSE <else>] END

Trova il primo <value> che corrisponde a <expr> e restituisce il corrispondente <return>.

Esempio:

CASE [RomanNumberal] WHEN 'I' THEN 1 WHEN 'II' THEN 2 ELSE 3 END

ZNZN(expression)

Restituisce <expression> se non è null, altrimenti restituisce zero.

Esempio:

ZN([Profit])

Funzioni aggregate

Aggregazioni e aritmetica dei valori a virgola mobile: i risultati di alcune aggregazioni potrebbero non corrispondere sempre alle previsioni. Ad esempio, la funzione Sum potrebbe restituire un valore di -1,42e-14 per una colonna di numeri la cui somma dovrebbe essere 0. Questo perché lo standard IEEE (Institute of Electrical and Electronics Engineers) 754 dei valori a virgola mobile richiede che i numeri siano memorizzati in formato binario, il che implica che a volte vengano arrotondati a livelli di precisione estremamente alti. È possibile eliminare questa potenziale distrazione utilizzando la funzione ROUND (vedi Funzioni numeriche) o formattando il numero in modo che includa meno decimali.

Funzione

Sintassi

Definizione

ATTR

ATTR(expression)

Restituisce il valore dell'espressione se ha un unico valore per tutte le righe. In caso contrario restituisce un asterisco. I valori NULL vengono ignorati.

AVG

AVG(expression)

Restituisce la media di tutti i valori nell'espressione. AVG può essere utilizzato solo con campi numerici. I valori NULL vengono ignorati.

COLLECT

COLLECT (spatial)

Un calcolo aggregato che combina i valori nel campo dell'argomento. I valori NULL vengono ignorati.

Nota: la funzione COLLECT può essere utilizzata solo con campi spaziali.

Esempio:

COLLECT ([Geometry])

CORR

CORR(expression 1, expression2)

Restituisce il coefficiente di correlazione Pearson di due espressioni.

La correlazione di Pearson misura la relazione lineare tra due variabili. I risultati variano da -1 a +1 inclusi, dove 1 denota un'esatta relazione lineare positiva, come quando un cambiamento positivo in una variabile implica un cambiamento positivo di grandezza corrispondente nell'altra; 0 denota l'assenza di relazioni lineari tra la varianza, e -1 è un'esatta relazione negativa.

CORR è disponibile con le seguenti origini dati:

  • Estrazioni dei dati di Tableau (è possibile creare un estratto da qualsiasi origine dati)
  • Cloudera Hive
  • EXASolution
  • Firebird (versione 3.0 e successive)
  • Google BigQuery
  • Hortonworks Hadoop Hive
  • IBM PDA (Netezza)
  • Oracle
  • PostgreSQL
  • Presto
  • SybaseIQ
  • Teradata
  • Vertica

Per altre origini dati, puoi ricorrere all'estrazione dei dati o all'utilizzo di WINDOW_CORR. Vedi Funzioni di calcolo tabella.

Nota: il quadrato di un risultato CORR equivale al valore R-Squared per un modello di linee di tendenza lineare. Vedi Termini del modello di linea di tendenza.

Esempio:

Puoi utilizzare CORR per visualizzare la correlazione in un diagramma a dispersione disaggregato. In questo caso bisogna utilizzare un'espressione Level of Detail nell'ambito della tabella. Ad esempio:

{CORR(Sales, Profit)}

Con un'espressione Level of Detail, la correlazione viene eseguita su tutte le righe. Usando una formula come CORR(Sales, Profit) (senza parentesi, per renderla un'espressione Level of Detail), la vista mostrerebbe la correlazione di ogni singolo punto del diagramma a dispersione con l'altro punto, che è indefinito.

Vedi Ambito tabella.

COUNT

COUNT(expression)

Restituisce il numero di voci di un gruppo. I valori NULL non vengono conteggiati.

COUNTD

COUNTD(expression)

Restituisce il numero di voci distinte di un gruppo. I valori NULL non vengono conteggiati. Questa funzione non è disponibile nei seguenti casi: cartelle di lavoro create prima di Tableau Desktop 8.2 che utilizzano origini dati Microsoft Excel o file di testo, cartelle di lavoro che utilizzano la connessione legacy e cartelle di lavoro che utilizzano origini dati Microsoft Access. Per utilizzare questa funzione, estrai i dati in un file di estrazione. Vedi Estrarre i dati.

COVAR

COVAR(expression 1, expression2)

Restituisce la covarianza del campione di due espressioni.

La covarianza quantifica il modo in cui due variabili cambiano insieme. Una covarianza positiva indica che le variabili tendono a muoversi nella stessa direzione, come quando in media valori più grandi di una variabile tendono a corrispondere a valori più grandi dell'altra variabile. Per normalizzare il calcolo della covarianza, la covarianza del campione utilizza il numero di punti dati non NULL n - 1 al posto di n, che viene invece utilizzato dalla covarianza della popolazione (disponibile con la funzione COVARP). La covarianza del campione è la scelta appropriata quando i dati sono un campione casuale che viene utilizzato per stimare la covarianza per una popolazione più numerosa.

COVAR è disponibile con le seguenti origini dati:

  • Estrazioni dei dati di Tableau (è possibile creare un estratto da qualsiasi origine dati)
  • Cloudera Hive
  • EXASolution
  • Firebird (versione 3.0 e successive)
  • Google BigQuery
  • Hortonworks Hadoop Hive
  • IBM PDA (Netezza)
  • Oracle
  • PostgreSQL
  • Presto
  • SybaseIQ
  • Teradata
  • Vertica

Per altre origini dati, puoi ricorrere all'estrazione dei dati o all'utilizzo di WINDOW_COVAR. Vedi Funzioni di calcolo tabella.

Se espressione1 ed espressione2 sono uguali, ad esempio COVAR([profitto], [profitto]), COVAR restituisce un valore che indica l'ampiezza della distribuzione dei valori.

Nota: il valore di COVAR(X, X) è equivalente al valore di VAR(X) e anche al valore di STDEV(X)^2.

Esempio:

La seguente formula restituisce la covarianza del campione di Vendite e Profitto.

COVAR([Sales], [Profit])

COVARP

COVARP(expression 1, expression2)

Restituisce la covarianza della popolazione di due espressioni.

La covarianza quantifica il modo in cui due variabili cambiano insieme. Una covarianza positiva indica che le variabili tendono a muoversi nella stessa direzione, come quando in media valori più grandi di una variabile tendono a corrispondere a valori più grandi dell'altra variabile. La covarianza della popolazione è la covarianza del campione moltiplicata per (n-1)/n, dove n è il numero totale di punti dati non NULL. Quando vi sono dati disponibili per tutte le voci di interesse, la covarianza della popolazione è la scelta appropriata, al contrario di quando è presente solo un sottoinsieme casuale di voci, nel qual caso risulta appropriata la covarianza del campione (con la funzione COVAR).

COVARP è disponibile con le seguenti origini dati:

  • Estrazioni dei dati di Tableau (è possibile creare un estratto da qualsiasi origine dati)
  • Cloudera Hive
  • EXASolution
  • Firebird (versione 3.0 e successive)
  • Google BigQuery
  • Hortonworks Hadoop Hive
  • IBM PDA (Netezza)
  • Oracle
  • PostgreSQL
  • Presto
  • SybaseIQ
  • Teradata
  • Vertica

Per altre origini dati, puoi ricorrere all'estrazione dei dati o all'utilizzo di WINDOW_COVARP. Vedi Funzioni di calcolo tabella.

Se espressione1 ed espressione2 sono uguali, ad esempio COVARP([profitto], [profitto]), COVARP restituisce un valore che indica l'ampiezza della distribuzione dei valori.

Nota: il valore di COVARP(X, X) è equivalente al valore di VARP(X) e anche al valore di STDEVP(X)^2.

Esempio:

La seguente formula restituisce la covarianza della popolazione di Vendite e Profitto.

COVARP([Sales], [Profit])

MAX

MAX(expression)

Restituisce il massimo di un'espressione in tutti i registri. Se l'espressione è un valore di stringa, questa funzione restituisce l'ultimo valore, in cui l'ultimo è definito in ordine alfabetico.

MEDIAN

MEDIAN(expression)

Restituisce la mediana di un'espressione in tutti i registri. Median può essere utilizzata solo con campi numerici. I valori NULL vengono ignorati. Questa funzione non è disponibile per le cartelle di lavoro create prima di Tableau Desktop 8.2 o che utilizzano connessioni legacy. Non è disponibile nemmeno per le connessioni che utilizzano le seguenti origini dati:

  • Access
  • Amazon Redshift
  • Cloudera Hadoop
  • HP Vertica
  • IBM DB2
  • IBM PDA (Netezza)
  • Microsoft SQL Server
  • MySQL
  • SAP HANA
  • Teradata

Per altri tipi di origine dati, è possibile estrarre i dati in un file di estrazione per utilizzare questa funzione. Vedi Estrarre i dati.

MIN

MIN(expression)

Restituisce il minimo di un'espressione in tutti i registri. Se l'espressione è un valore di stringa, questa funzione restituisce il primo valore, in cui il primo è definito in ordine alfabetico.

PERCENTILE

PERCENTILE(expression, number)

Restituisce il valore percentile dell'espressione data corrispondente al numero specificato. Il numero deve essere compreso tra 0 e 1 (compreso), ad esempio 0,66, e deve essere una costante numerica.

Questa funzione è disponibile per le seguenti origini dati.

  • Connessioni non legacy Microsoft Excel e file di testo.

  • Estratti e tipi di origine dati di sola estrazione (ad esempio, Google Analytics, OData o Salesforce).

  • Sybase IQ 15.1 e origini dati successive.

  • Oracle 10 e origini dati successive.

  • Origini dati di Cloudera Hive e Hortonworks Hadoop Hive.

  • EXASolution 4.2 e origini dati successive.

Per altri tipi di origine dati, è possibile estrarre i dati in un file di estrazione per utilizzare questa funzione. Vedi Estrarre i dati.

STDEV

STDEV(expression)

Restituisce la deviazione statistica standard di tutti i valori dell'espressione data sulla base di un campione della popolazione.

STDEVP

STDEVP(expression)

Restituisce la deviazione statistica standard di tutti i valori dell'espressione data sulla base di un campione parziale della popolazione.

SUM

SUM(expression)

Restituisce la somma di tutti i valori nell'espressione. SUM può essere utilizzato solo con campi numerici. I valori NULL vengono ignorati.

VAR

VAR(expression)

Restituisce la varianza statistica di tutti i valori dell'espressione data sulla base di un campione della popolazione.

VARP

VARP(expression)

Restituisce la varianza statistica di tutti i valori dell'espressione data sulla base dell'intera popolazione.

Funzioni utente

Funzione

Sintassi

Descrizione

FULLNAME

FULLNAME( )

Restituisce il nome completo dell'utente corrente. È il nome completo di Tableau Server o Tableau Cloud quando l'utente è registrato; altrimenti è il nome completo locale o di rete dell'utente di Tableau Desktop.

Esempi:

FULLNAME( ) 

Restituisce il nome completo dell'utente cha ha effettuato l'accesso, Dave Hallsten.

[Manager]=FULLNAME( )

Se il responsabile Dave Hallsten è registrato, in questo esempio viene restituito True solo se nel campo Responsabile nella vista era specificato Dave Hallsten. Se utilizzato come filtro, questo campo calcolato può essere utilizzato per creare un filtro utente che mostra solo i dati rilevanti per la persona registrata sul server.

ISFULLNAME

ISFULLNAME(string)

Restituisce true se il nome completo dell'utente corrente corrisponde al nome completo specificato o false se non corrisponde. Questa funzione utilizza il nome completo di Tableau Server o Tableau Cloud quando l'utente ha effettuato l'accesso oppure il nome completo locale o di rete per l'utente di Tableau Desktop.

Esempio:

ISFULLNAME("Dave Hallsten")

In questo esempio, la funzione restituisce true se Dave Hallsten è l'utente corrente, altrimenti restituisce false.

ISMEMBEROF

ISMEMBEROF(string)

Restituisce true se la persona che attualmente utilizza Tableau è un membro di un gruppo che corrisponde alla stringa specificata. Se la persona che attualmente utilizza Tableau è registrata, l'appartenenza al gruppo è determinata dai gruppi su Tableau Server o Tableau Cloud. Se la persona non è registrata, questa funzione restituisce NULL.

Nota: la funzione restituirà un valore "True" se la stringa data è "Tutti gli utenti", che sia stato effettuato l'accesso a Tableau Server o Tableau Cloud.

La funzione ISMEMBEROF() accetta anche i domini Active Directory. Il dominio Active Directory deve essere dichiarato nel calcolo con il nome del gruppo.

Esempio:

IF ISMEMBEROF('domain.lan\Sales') THEN "Sales" ELSE "Other" END

ISUSERNAME

ISUSERNAME(string)

Restituisce true se il nome dell'utente corrente corrisponde al nome utente specificato o false se non corrisponde. Questa funzione utilizza il nome utente di Tableau Server o Tableau Cloud quando l'utente è registrato; altrimenti utilizza il nome utente locale o di rete dell'utente di Tableau Desktop.

Esempio:

ISUSERNAME("dhallsten")

In questo esempio, la funzione restituisce true se dhallsten è l'utente corrente, altrimenti restituisce false.

Nota: "All Users" verrà sempre restituito come true.

USERDOMAIN

USERDOMAIN()

Restituisce il dominio dell'utente corrente quando l'utente è registrato su Tableau Server. Restituisce il dominio Windows se l'utente di Tableau Desktop si trova su un dominio. Altrimenti questa funzione restituisce una stringa null.

Esempio:

[Manager]=USERNAME() AND [Domain]=USERDOMAIN()

USERNAME

USERNAME( )

Restituisce il nome utente dell'utente corrente. È il nome utente di Tableau Server o Tableau Cloud quando l'utente è registrato; altrimenti è il nome utente locale o di rete dell'utente di Tableau Desktop.

Esempi:

USERNAME( ) 

Restituisce il nome utente dell'utente che ha effettuato l'accesso, dhallsten.

[Manager]=USERNAME( )

Se il manager dhallsten ha effettuato l'accesso, questa funzione restituisce True solo quando il campo Manager nella vista è dhallsten. Se utilizzato come filtro, questo campo calcolato può essere utilizzato per creare un filtro utente che mostra solo i dati rilevanti per la persona registrata sul server.

USERATTRIBUTEUSERATTRIBUTE('attribute_name')

(Solo per l’incorporamento di workflow in Tableau Cloud)

Restituisce una stringa. Se 'attribute_name' fa parte del token JWT passato a Tableau, il calcolo restituisce il primo valore di 'attribute_name'. Restituisce NULL se 'attribute_name' non esiste.

Nota: puoi usare la funzione USERATTRIBUTEINCLUDES se prevedi che 'attribute_name' restituisca più valori.

Esempio:

Supponiamo che 'Region' sia l'attributo utente incluso nel token JWT e passato a Tableau utilizzando l'app connessa già configurata dall'amministratore del sito. In qualità di autore della cartella di lavoro, puoi configurare la tua visualizzazione per filtrare i dati in base a una regione specifica. In tale filtro, puoi fare riferimento al seguente calcolo.

[Region]=USERATTRIBUTE('Region')

Quando Alan Wang della regione occidentale visualizza la visualizzazione incorporata, Tableau mostra i dati appropriati solo per la regione occidentale.

USERATTRIBUTEINCLUDESUSERATTRIBUTEINCLUDES('attribute_name', 'expected_value')

(Solo per l’incorporamento di workflow in Tableau Cloud)

Restituisce un valore booleano. Restituisce "true" se le seguenti condizioni sono vere: 1) 'attribute_name' fa parte del token JWT passato a Tableau e 2) uno dei valori di 'attribute_name' è uguale a 'expected_value'. Restituisce "false" in caso contrario.

Nota: puoi usare la funzione USERATTRIBUTE se prevedi che 'attribute_name' restituisca un singolo valore stringa.

Esempio:

Supponiamo che 'Region' sia l'attributo utente definito nel token JWT e passato a Tableau utilizzando l'app connessa già configurata dall'amministratore del sito. In qualità di autore della cartella di lavoro, puoi configurare la tua visualizzazione per filtrare i dati in base a [Region]. In tale filtro, puoi fare riferimento al seguente calcolo.

USERATTRIBUTEINCLUDES('Region', [Region])

Se Alan Wang della regione occidentale accede alla visualizzazione incorporata, Tableau controlla se l'attributo utente Region corrisponde a uno dei valori del campo [Region]. Se è true, la visualizzazione mostra i dati appropriati. Quando un altro utente, Michele Kim della regione settentrionale, accede alla stessa visualizzazione, non potrà visualizzare alcun dato perché non c'è corrispondenza con i valori del campo [Region].

Calcoli tabella

FIRST( )


Restituisce il numero di righe dalla riga corrente alla prima riga della partizione. Ad esempio, la seguente vista mostra le vendite trimestrali. Quando FIRST() è calcolato all'interno della partizione Data, l'offset della prima riga dalla seconda riga è -1.

Esempio

Quando l'indice di riga corrente è 3, FIRST() = -2.

INDEX( )


Restituisce l'indice della riga corrente nella partizione, senza alcun ordinamento in base al valore. L'indice della prima riga inizia da 1. Ad esempio, la seguente tabella mostra le vendite trimestrali. Quando INDEX() è calcolato all'interno della partizione Data, l'indice di ogni riga è 1, 2, 3, 4....., ecc.

Esempio

Per la terza riga della partizione, INDEX() = 3.

LAST( )


Restituisce il numero di righe dalla riga corrente all'ultima riga della partizione. Ad esempio, la seguente tabella mostra le vendite trimestrali. Quando LAST() è calcolato all'interno della partizione Data, l'offset dell'ultima riga dalla seconda riga è 5.

Esempio

Quando l'indice di riga corrente è 3 di 7, LAST() = 4.

LOOKUP(espressione, [offset])


Restituisce il valore dell'espressione in una riga di destinazione, specificato come offset relativo rispetto alla riga corrente. Utilizza FIRST() + n e LAST() - n come parte della definizione dell'offset per una destinazione relativa alla prima/ultima riga della partizione. Se offset viene omesso, la riga da confrontare può essere impostata nel menu del campo. Se la riga di destinazione non è determinabile, questa funzione restituisce NULL.

La seguente vista mostra le vendite trimestrali. Quando LOOKUP (SUM(Sales), 2) viene calcolato all'interno della partizione Data, ogni riga mostra il valore delle vendite da 2 trimestri nel futuro.

Esempio

LOOKUP(SUM([Profit]), FIRST()+2) calcola SUM(Profitto) nella terza riga della partizione.

MODEL_EXTENSION_BOOL (nome_modello, argomenti, espressione)


Restituisce il risultato booleano di un'espressione calcolata da un modello con nome distribuito su un servizio esterno TabPy.

Model_name è il nome del modello di analisi distribuito che si desidera utilizzare.

Ogni argomento è una singola stringa che imposta i valori di input accettati dal modello distribuito ed è definita dal modello di analisi.

Utilizza le espressioni per definire i valori inviati da Tableau al modello di analisi. Assicurati di utilizzare le funzioni di aggregazione (SOMMA, AVG e così via) per aggregare i risultati.

Quando si utilizza la funzione, i tipi di dati e l'ordine delle espressioni devono corrispondere a quelli degli argomenti di input.

Esempio

MODEL_EXTENSION_BOOL ("isProfitable","inputSales", "inputCosts", SUM([Sales]), SUM([Costs]))

MODEL_EXTENSION_INT (nome_modello, argomenti, espressione)


Restituisce il risultato booleano di un'espressione calcolata da un modello con nome distribuito su un servizio esterno TabPy.

Model_name è il nome del modello di analisi distribuito che si desidera utilizzare.

Ogni argomento è una singola stringa che imposta i valori di input accettati dal modello distribuito ed è definita dal modello di analisi.

Utilizza le espressioni per definire i valori inviati da Tableau al modello di analisi. Assicurati di utilizzare le funzioni di aggregazione (SOMMA, AVG e così via) per aggregare i risultati.

Quando si utilizza la funzione, i tipi di dati e l'ordine delle espressioni devono corrispondere a quelli degli argomenti di input.

Esempio

MODEL_EXTENSION_INT ("getPopulation", "inputCity", "inputState", MAX([City]), MAX ([State]))

MODEL_EXTENSION_REAL (nome_modello, argomenti, espressione)


Restituisce un risultato reale di un'espressione calcolata da un modello con nome distribuito su un servizio esterno TabPy.

Model_name è il nome del modello di analisi distribuito che si desidera utilizzare.

Ogni argomento è una singola stringa che imposta i valori di input accettati dal modello distribuito ed è definita dal modello di analisi.

Utilizza le espressioni per definire i valori inviati da Tableau al modello di analisi. Assicurati di utilizzare le funzioni di aggregazione (SOMMA, AVG e così via) per aggregare i risultati.

Quando si utilizza la funzione, i tipi di dati e l'ordine delle espressioni devono corrispondere a quelli degli argomenti di input.

Esempio

MODEL_EXTENSION_REAL ("profitRatio", "inputSales", "inputCosts", SUM([Sales]), SUM([Costs]))

MODEL_EXTENSION_STRING (nome_modello, argomenti, espressione)


Restituisce il risultato stringa di un'espressione calcolata da un modello con nome distribuito su un servizio esterno TabPy.

Model_name è il nome del modello di analisi distribuito che si desidera utilizzare.

Ogni argomento è una singola stringa che imposta i valori di input accettati dal modello distribuito ed è definita dal modello di analisi.

Utilizza le espressioni per definire i valori inviati da Tableau al modello di analisi. Assicurati di utilizzare le funzioni di aggregazione (SOMMA, AVG e così via) per aggregare i risultati.

Quando si utilizza la funzione, i tipi di dati e l'ordine delle espressioni devono corrispondere a quelli degli argomenti di input.

Esempio

MODEL_EXTENSION_STR ("mostPopulatedCity", "inputCountry", "inputYear", MAX ([Country]), MAX([Year]))

MODEL_PERCENTILE(espressione_destinazione, espressione/i_predittore)


Restituisce la probabilità (compresa tra 0 e 1) che il valore previsto sia minore o uguale all'indicatore osservato, definito dall'espressione di destinazione e da altri predittori. Questa è la funzione di distribuzione predittiva posteriore, anche nota come funzione di distribuzione cumulativa (CDF).

Questa funzione è l'inversa di MODEL_QUANTILE. Per informazioni sulle funzioni di modellazione predittiva, consulta Funzionamento delle funzioni di modellazione predittiva in Tableau.

Esempio

La formula seguente restituisce il quantile dell'indicatore per la somma delle vendite, rettificato in base al conteggio degli ordini.

MODEL_PERCENTILE(SUM([Sales]), COUNT([Orders]))

MODEL_QUANTILE(quantile, espressione_destinazione, espressione/i_predittore)


Restituisce un valore numerico di destinazione all'interno dell'intervallo probabile definito dall'espressione di destinazione e da altri predittori, in corrispondenza di un quantile specificato. Questo è il quantile predittivo posteriore.

Questa funzione è l'inversa di MODEL_PERCENTILE. Per informazioni sulle funzioni di modellazione predittiva, consulta Funzionamento delle funzioni di modellazione predittiva in Tableau.

Esempio

La formula seguente restituisce la somma prevista mediana (0,5) delle vendite, rettificata in base al conteggio degli ordini.

MODEL_QUANTILE(0.5, SUM([Sales]), COUNT([Orders]))

PREVIOUS_VALUE(espressione)


Restituisce il valore di questo calcolo nella riga precedente. Restituisce l'espressione data se la riga corrente è la prima riga della partizione.

Esempio

SUM([Profit]) * PREVIOUS_VALUE(1) calcola il prodotto corrente di SUM(Profitto).

RANK(espressione, ['asc' | 'desc'])


Restituisce la classificazione standard della concorrenza per la riga corrente della partizione. A valori identici viene assegnata una classificazione identica. Utilizza l'argomento facoltativo 'asc' | 'desc' per specificare l'ordine crescente o decrescente. L'impostazione predefinita è decrescente.

Con questa funzione, l'insieme dei valori (6, 9, 9, 14) sarebbe classificato (4, 2, 2, 1).

I valori NULL vengono ignorati nelle funzioni di classificazione. Non sono numerati e non vengono conteggiati rispetto al numero totale di record nel calcolo della classificazione percentile.

Per informazioni sulle diverse opzioni di classificazione, consulta Calcolo di classificazione.

Esempio

L'immagine seguente mostra l'effetto delle varie funzioni di classificazione (RANK, RANK_DENSE, RANK_MODIFIED, RANK_PERCENTILE e RANK_UNIQUE) su un insieme di valori. L'insieme di dati contiene informazioni su 14 studenti (da StudentA a StudentN); la colonna Età mostra l'età attuale di ogni studente (tutti gli studenti hanno un'età compresa tra i 17 e i 20 anni). Le colonne rimanenti mostrano l'effetto di ogni funzione di classificazione sull'insieme dei valori di età, presumendo che la funzione conservi l'ordine predefinito (crescente o decrescente).

RANK_DENSE(espressione, ['asc' | 'desc'])


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. Utilizza l'argomento facoltativo 'asc' | 'desc' per specificare l'ordine crescente o decrescente. L'impostazione predefinita è decrescente.

Con questa funzione, l'insieme dei valori (6, 9, 9, 14) sarebbe classificato (3, 2, 2, 1).

I valori NULL vengono ignorati nelle funzioni di classificazione. Non sono numerati e non vengono conteggiati rispetto al numero totale di record nel calcolo della classificazione percentile.

Per informazioni sulle diverse opzioni di classificazione, consulta Calcolo di classificazione.

RANK_MODIFIED(espressione, ['asc' | 'desc'])


Restituisce la classificazione modificata della concorrenza per la riga corrente della partizione. A valori identici viene assegnata una classificazione identica. Utilizza l'argomento facoltativo 'asc' | 'desc' per specificare l'ordine crescente o decrescente. L'impostazione predefinita è decrescente.

Con questa funzione, l'insieme dei valori (6, 9, 9, 14) sarebbe classificato (4, 3, 3, 1).

I valori NULL vengono ignorati nelle funzioni di classificazione. Non sono numerati e non vengono conteggiati rispetto al numero totale di record nel calcolo della classificazione percentile.

Per informazioni sulle diverse opzioni di classificazione, consulta Calcolo di classificazione.

RANK_PERCENTILE(espressione, ['asc' | 'desc'])


Restituisce la classificazione percentile per la riga corrente della partizione. Utilizza l'argomento facoltativo 'asc' | 'desc' per specificare l'ordine crescente o decrescente. Quello predefinito è ascendente.

Con questa funzione, l'insieme dei valori (6, 9, 9, 14) sarebbe classificato (0,00, 0,67, 0,67, 1,00).

I valori NULL vengono ignorati nelle funzioni di classificazione. Non sono numerati e non vengono conteggiati rispetto al numero totale di record nel calcolo della classificazione percentile.

Per informazioni sulle diverse opzioni di classificazione, consulta Calcolo di classificazione.

RANK_UNIQUE(espressione, ['asc' | 'desc'])


Restituisce la classificazione univoca per la riga corrente della partizione. A valori identici sono assegnate classificazioni differenti. Utilizza l'argomento facoltativo 'asc' | 'desc' per specificare l'ordine crescente o decrescente. L'impostazione predefinita è decrescente.

Con questa funzione, l'insieme dei valori (6, 9, 9, 14) sarebbe classificato (4, 2, 3, 1).

I valori NULL vengono ignorati nelle funzioni di classificazione. Non sono numerati e non vengono conteggiati rispetto al numero totale di record nel calcolo della classificazione percentile.

Per informazioni sulle diverse opzioni di classificazione, consulta Calcolo di classificazione.

RUNNING_AVG(espressione)


Restituisce la media mobile dell'espressione data, dalla prima riga della partizione alla riga corrente.

La seguente vista mostra le vendite trimestrali. Quando all'interno della partizione Data viene calcolato RUNNING_AVG(SUM([Sales]), il risultato è una media mobile dei valori di vendita per ogni trimestre.

Esempio

RUNNING_AVG(SUM([Profit])) calcola la media mobile di SUM(Profitto).

RUNNING_COUNT(espressione)


Restituisce il conteggio corrente dell'espressione data, dalla prima riga della partizione alla riga corrente.

Esempio

RUNNING_COUNT(SUM([Profit])) calcola il conteggio corrente di SUM(Profitto).

RUNNING_MAX(espressione)


Restituisce il valore massimo corrente dell'espressione data, dalla prima riga nella partizione alla riga corrente.

Esempio

RUNNING_MAX(SUM([Profit])) calcola il valore massimo corrente di SUM(Profitto).

RUNNING_MIN(espressione)


Restituisce il valore minimo corrente dell'espressione data, dalla prima riga della partizione alla riga corrente.

Esempio

RUNNING_MIN(SUM([Profit])) calcola il valore minimo corrente di SUM(Profitto).

RUNNING_SUM(espressione)


Restituisce la somma corrente dell'espressione data, dalla prima riga della partizione alla riga corrente.

Esempio

RUNNING_SUM(SUM([Profit])) calcola la somma corrente di SUM(Profitto)

SIZE()


Restituisce il numero di righe della partizione. Ad esempio, la seguente vista mostra le vendite trimestrali. All'interno della partizione Data, ci sono sette righe, quindi SIZE() per la partizione Data sarà 7.

Esempio

SIZE() = 5 quando la partizione corrente contiene cinque righe.

SCRIPT_BOOL


Restituisce come risultato un valore booleano dall'espressione specificata. L'espressione viene passata direttamente a un'istanza di servizio di estensione di analisi in esecuzione.

Nelle espressioni R, utilizza .argn (con un punto iniziale) per fare riferimento ai parametri (.arg1, .arg2, ecc.).

Nelle espressioni Python, utilizza _argn (con un carattere di sottolineatura iniziale).

Esempi

Nell'esempio R, .arg1 è uguale a SUM([Profitto]):

SCRIPT_BOOL("is.finite(.arg1)", SUM([Profit]))

Nell'esempio successivo, la funzione restituisce True per gli ID dei negozi nello stato di Washington e False negli altri casi. Questo esempio potrebbe essere la definizione di un campo calcolato intitolato IsStoreInWA.

SCRIPT_BOOL('grepl(".*_WA", .arg1, perl=TRUE)',ATTR([Store ID]))

Un comando per Python assumerebbe questa forma:

SCRIPT_BOOL("return map(lambda x : x > 0, _arg1)", SUM([Profit]))

SCRIPT_INT


Restituisce come risultato un numero intero dall'espressione specificata. L'espressione viene passata direttamente a un'istanza di servizio di estensione di analisi in esecuzione.

Nelle espressioni R, utilizza .argn (con un punto iniziale) per fare riferimento ai parametri (.arg1, .arg2, ecc.)

Nelle espressioni Python, utilizza _argn (con un carattere di sottolineatura iniziale).

Esempi

Nell'esempio R, .arg1 è uguale a SUM([Profitto]):

SCRIPT_INT("is.finite(.arg1)", SUM([Profit]))

Nell'esempio seguente, il clustering k-means viene utilizzato per creare tre cluster:

SCRIPT_INT('result <- kmeans(data.frame(.arg1,.arg2,.arg3,.arg4), 3);result$cluster;', SUM([Petal length]), SUM([Petal width]),SUM([Sepal length]),SUM([Sepal width]))

Un comando per Python assumerebbe questa forma:

SCRIPT_INT("return map(lambda x : int(x * 5), _arg1)", SUM([Profit]))

SCRIPT_REAL


Restituisce come risultato un numero reale dall'espressione specificata. L'espressione viene passata direttamente a un'istanza di servizio di estensione di analisi in esecuzione. Nelle

espressioni R, utilizza .argn (con un punto iniziale) per fare riferimento ai parametri (.arg1, .arg2, ecc.)

Nelle espressioni Python, utilizza _argn (con un carattere di sottolineatura iniziale).

Esempi

Nell'esempio R, .arg1 è uguale a SUM([Profitto]):

SCRIPT_REAL("is.finite(.arg1)", SUM([Profit]))

L'esempio seguente converte i valori di temperatura da Celsius a Fahrenheit.

SCRIPT_REAL('library(udunits2);ud.convert(.arg1, "celsius", "degree_fahrenheit")',AVG([Temperature]))

Un comando per Python assumerebbe questa forma:

SCRIPT_REAL("return map(lambda x : x * 0.5, _arg1)", SUM([Profit]))

SCRIPT_STR


Restituisce come risultato una stringa dall'espressione specificata. L'espressione viene passata direttamente a un'istanza di servizio di estensione di analisi in esecuzione.

Nelle espressioni R, utilizza .argn (con un punto iniziale) per fare riferimento ai parametri (.arg1, .arg2, ecc.)

Nelle espressioni Python, utilizza _argn (con un carattere di sottolineatura iniziale).

Esempi

Nell'esempio R, .arg1 è uguale a SUM([Profitto]):

SCRIPT_STR("is.finite(.arg1)", SUM([Profit]))

L'esempio seguente estrae un'abbreviazione di stato da una stringa più complicata (nella forma originale 13XSL_CA, A13_WA):

SCRIPT_STR('gsub(".*_", "", .arg1)',ATTR([Store ID]))

Un comando per Python assumerebbe questa forma:

SCRIPT_STR("return map(lambda x : x[:2], _arg1)", ATTR([Region]))

TOTAL(espressione)


Restituisce il totale per l'espressione data in una partizione di calcolo tabella.

Esempio

Supponi di iniziare con questa vista:

Apri l'editor di calcolo e crea un nuovo campo denominato Totale:

Trascina Totale su Testo per sostituire SUM(Vendite). La vista cambia in modo tale da sommare i valori in base al valore predefinito Calcola utilizzando:

A questo punto la domanda è: qual è il valore predefinito di Calcola utilizzando? Se nel riquadro Dati fai clic con il pulsante destro del mouse (Control-clic su un Mac) su Totale e selezioni Modifica, avrai a disposizione un'ulteriore informazione:

Il valore predefinito di Calcola utilizzando è Tabella (orizzontale). Il risultato è che Totale sta sommando i valori in orizzontale su ogni riga della tabella. Quindi, il valore che vedi in ogni riga è la somma dei valori della versione originale della tabella.

I valori della riga 2011/T1 nella tabella originale erano 8601 $, 6579 $, 44262 $ e 15006 $. I valori nella tabella dopo che Totale ha sostituito SUM(Vendite) corrispondono tutti a 74.448 $, ovvero la somma dei quattro valori originali.

Nota il triangolo accanto a Totale dopo averlo trascinato su Testo:

Indica che questo campo utilizza un calcolo tabella. Puoi fare clic con il pulsante destro del mouse sul campo e selezionare Modifica calcolo tabella per reindirizzare la funzione a un valore di Calcola utilizzando differente. Ad esempio, puoi impostarlo su Tabella (verticale). In questo caso, la tabella apparirebbe così:

WINDOW_AVG(espressione, [inizio, fine])


Restituisce la media dell'espressione all'interno della finestra. La finestra viene definita mediante offset dalla riga corrente. Utilizza FIRST()+n e LAST()-n per gli offset dalla prima o dall'ultima riga della partizione. Se l'inizio e la fine sono omessi, viene utilizzata l'intera partizione.

Ad esempio, la seguente vista mostra le vendite trimestrali. Una media della finestra all'interno della partizione Data restituisce la media delle vendite in tutte le date.

Esempio

WINDOW_AVG(SUM([Profit]), FIRST()+1, 0) calcola la media di SUM(Profitto) dalla seconda riga a quella corrente.

WINDOW_CORR(espressione1, espressione2, [inizio, fine])


Restituisce il coefficiente di correlazione di Pearson di due espressioni all'interno della finestra. La finestra viene definita come offset dalla riga corrente. Utilizza FIRST()+n e LAST()-n per gli offset dalla prima o dall'ultima riga della partizione. Se l'inizio e la fine sono omessi, viene utilizzata l'intera partizione.

La correlazione di Pearson misura la relazione lineare tra due variabili. I risultati variano da -1 a +1 inclusi, dove 1 denota un'esatta relazione lineare positiva, come quando un cambiamento positivo in una variabile implica un cambiamento positivo di grandezza corrispondente nell'altra; 0 denota l'assenza di relazioni lineari tra la varianza, e -1 è un'esatta relazione negativa.

Esiste una funzione di aggregazione equivalente: CORR. Vedi Funzioni di Tableau (in ordine alfabetico)(Il collegamento viene aperto in una nuova finestra).

Esempio

La seguente formula restituisce la correlazione di Pearson di SUM(Profitto) e SUM(Vendite) dalle cinque righe precedenti alla riga corrente.

WINDOW_CORR(SUM[Profit]), SUM([Sales]), -5, 0)

WINDOW_COUNT(espressione, [inizio, fine])


Restituisce il conteggio dell'espressione all'interno della finestra. La finestra viene definita mediante offset dalla riga corrente. Utilizza FIRST()+n e LAST()-n per gli offset dalla prima o dall'ultima riga della partizione. Se l'inizio e la fine sono omessi, viene utilizzata l'intera partizione.

Esempio

WINDOW_COUNT(SUM([Profit]), FIRST()+1, 0) calcola il conteggio di SUM(Profitto) dalla seconda riga a quella corrente

WINDOW_COVAR(espressione1, espressione2, [inizio, fine])


Restituisce la covarianza del campione di due espressioni all'interno della finestra. La finestra viene definita come offset dalla riga corrente. Utilizza FIRST()+n e LAST()-n per gli offset dalla prima o dall'ultima riga della partizione. Se gli argomenti di inizio e fine vengono omessi, la finestra è l'intera partizione.

Per normalizzare il calcolo della covarianza, la covarianza del campione utilizza il numero di punti dati non NULL n - 1 al posto di n, che viene invece utilizzato dalla covarianza della popolazione (con la funzione WINDOW_COVARP). La covarianza del campione è la scelta appropriata quando i dati sono un campione casuale che viene utilizzato per stimare la covarianza per una popolazione più numerosa.

Esiste una funzione di aggregazione equivalente: COVAR. Vedi Funzioni di Tableau (in ordine alfabetico)(Il collegamento viene aperto in una nuova finestra).

Esempio

La seguente formula restituisce la covarianza del campione di SUM(Profitto) e SUM(Vendite) dalle due righe precedenti alla riga corrente.

WINDOW_COVAR(SUM([Profit]), SUM([Sales]), -2, 0)

WINDOW_COVARP(espressione1, espressione2, [inizio, fine])


Restituisce la covarianza della popolazione di due espressioni all'interno della finestra. La finestra viene definita come offset dalla riga corrente. Utilizza FIRST()+n e LAST()-n per gli offset dalla prima o dall'ultima riga della partizione. Se l'inizio e la fine sono omessi, viene utilizzata l'intera partizione.

La covarianza della popolazione è la covarianza del campione moltiplicata per (n-1)/n, dove n è il numero totale di punti dati non NULL. La covarianza della popolazione è la scelta appropriata quando sono disponibili dati per tutti gli elementi di interesse. Al contrario, quando è presente solo un sottoinsieme casuale di elementi, è preferibile utilizzare la covarianza del campione (con la funzione WINDOW_COVAR).

Esiste una funzione di aggregazione equivalente: COVARP. Funzioni di Tableau (in ordine alfabetico)(Il collegamento viene aperto in una nuova finestra).

Esempio

La seguente formula restituisce la covarianza della popolazione di SUM(Profitto) e SUM(Vendite) dalle due righe precedenti alla riga corrente.

WINDOW_COVARP(SUM([Profit]), SUM([Sales]), -2, 0)

WINDOW_MEDIAN(espressione, [inizio, fine])


Restituisce il valore mediano dell'espressione all'interno della finestra. La finestra viene definita mediante offset dalla riga corrente. Utilizza FIRST()+n e LAST()-n per gli offset dalla prima o dall'ultima riga della partizione. Se l'inizio e la fine sono omessi, viene utilizzata l'intera partizione.

Ad esempio, la seguente vista mostra i profitti trimestrali. Un valore mediano della finestra all'interno della partizione Data restituisce il profitto mediano in tutte le date.

Esempio

WINDOW_MEDIAN(SUM([Profit]), FIRST()+1, 0) calcola la mediana di SUM(Profitto) dalla seconda riga a quella corrente.

WINDOW_MAX(espressione, [inizio, fine])


Restituisce il valore massimo dell'espressione all'interno della finestra. La finestra viene definita mediante offset dalla riga corrente. Utilizza FIRST()+n e LAST()-n per gli offset dalla prima o dall'ultima riga della partizione. Se l'inizio e la fine sono omessi, viene utilizzata l'intera partizione.

Ad esempio, la seguente vista mostra le vendite trimestrali. Un valore massimo della finestra all'interno della partizione Data restituisce il valore massimo delle vendite in tutte le date.

Esempio

WINDOW_MAX(SUM([Profit]), FIRST()+1, 0) calcola il massimo di SUM(Profitto) dalla seconda riga a quella corrente.

WINDOW_MIN(espressione, [inizio, fine])


Restituisce il valore minimo dell'espressione all'interno della finestra. La finestra viene definita mediante offset dalla riga corrente. Utilizza FIRST()+n e LAST()-n per gli offset dalla prima o dall'ultima riga della partizione. Se l'inizio e la fine sono omessi, viene utilizzata l'intera partizione.

Ad esempio, la seguente vista mostra le vendite trimestrali. Un valore minimo della finestra all'interno della partizione Data restituisce il valore minimo delle vendite in tutte le date.

Esempio

WINDOW_MIN(SUM([Profit]), FIRST()+1, 0) calcola il minimo di SUM(Profitto) dalla seconda riga a quella corrente.

WINDOW_PERCENTILE(espressione, numero, [inizio, fine])


Restituisce il valore corrispondente al percentile specificato all'interno della finestra. La finestra viene definita mediante offset dalla riga corrente. Utilizza FIRST()+n e LAST()-n per gli offset dalla prima o dall'ultima riga della partizione. Se l'inizio e la fine sono omessi, viene utilizzata l'intera partizione.

Esempio

WINDOW_PERCENTILE(SUM([Profit]), 0.75, -2, 0) calcola il 75° percentile di SUM(Profitto) dalle due righe precedenti a quella corrente.

WINDOW_STDEV(espressione, [inizio, fine])


Restituisce la deviazione standard del campione dell'espressione all'interno della finestra. La finestra viene definita mediante offset dalla riga corrente. Utilizza FIRST()+n e LAST()-n per gli offset dalla prima o dall'ultima riga della partizione. Se l'inizio e la fine sono omessi, viene utilizzata l'intera partizione.

Esempio

WINDOW_STDEV(SUM([Profit]), FIRST()+1, 0) calcola la deviazione standard di SUM(Profitto) dalla seconda riga a quella corrente.

WINDOW_STDEVP(espressione, [inizio, fine])


Restituisce la deviazione standard distorta dell'espressione all'interno della finestra. La finestra viene definita mediante offset dalla riga corrente. Utilizza FIRST()+n e LAST()-n per gli offset dalla prima o dall'ultima riga della partizione. Se l'inizio e la fine sono omessi, viene utilizzata l'intera partizione.

Esempio

WINDOW_STDEVP(SUM([Profit]), FIRST()+1, 0) calcola la deviazione standard di SUM(Profitto) dalla seconda riga a quella corrente.

WINDOW_SUM(espressione, [inizio, fine])


Restituisce la somma dell'espressione all'interno della finestra. La finestra viene definita mediante offset dalla riga corrente. Utilizza FIRST()+n e LAST()-n per gli offset dalla prima o dall'ultima riga della partizione. Se l'inizio e la fine sono omessi, viene utilizzata l'intera partizione.

Ad esempio, la seguente vista mostra le vendite trimestrali. Una somma della finestra calcolata all'interno della partizione Data restituisce la somma delle vendite in tutti i trimestri.

Esempio

WINDOW_SUM(SUM([Profit]), FIRST()+1, 0) calcola la somma di SUM(Profitto) dalla seconda riga a quella corrente.

WINDOW_VAR(espressione, [inizio, fine])


Restituisce la varianza del campione dell'espressione all'interno della finestra. La finestra viene definita mediante offset dalla riga corrente. Utilizza FIRST()+n e LAST()-n per gli offset dalla prima o dall'ultima riga della partizione. Se l'inizio e la fine sono omessi, viene utilizzata l'intera partizione.

Esempio

WINDOW_VAR((SUM([Profit])), FIRST()+1, 0) calcola la varianza di SUM(Profitto) dalla seconda riga a quella corrente.

WINDOW_VARP(espressione, [inizio, fine])


Restituisce la varianza distorta dell'espressione all'interno della finestra. La finestra viene definita mediante offset dalla riga corrente. Utilizza FIRST()+n e LAST()-n per gli offset dalla prima o dall'ultima riga della partizione. Se l'inizio e la fine sono omessi, viene utilizzata l'intera partizione.

Esempio

WINDOW_VARP(SUM([Profit]), FIRST()+1, 0) calcola la varianza di SUM(Profitto) dalla seconda riga a quella corrente.

Funzioni pass-through (RAWSQL)

Queste funzioni pass-through RAWSQL possono essere utilizzate per inviare espressioni SQL direttamente al database, senza essere prima interpretate da Tableau. Se disponi di funzioni di database personalizzate di cui Tableau non è a conoscenza, utilizza queste funzioni pass-through per richiamare le funzioni personalizzate.

Generalmente, il database non capisce i nomi dei campi che sono mostrati in Tableau. Poiché Tableau non interpreta le espressioni SQL incluse nelle funzione pass-through, l'uso dei nomi dei campi di Tableau nella propria espressione può causare errori. È possibile utilizzare una sintassi di sostituzione per inserire il nome del campo o l'espressione corretta per un calcolo Tableau in SQL pass-through. Ad esempio, se avessi una funzione che calcola il valore mediano di un insieme di valori, potresti richiamare tale funzione nella colonna [Vendite] di Tableau in questo modo:

RAWSQLAGG_REAL("MEDIAN(%1)", [Sales])

Poiché Tableau non interpreta l'espressione, è necessario definire l'aggregazione. È possibile utilizzare le funzioni RAWSQLAGGG descritte di seguito quando si utilizzano espressioni aggregate.

Le funzioni pass-through RAWSQL potrebbero non funzionare con le estrazioni o le origini dati pubblicate se contengono relazioni.

Funzioni RAWSQL

Le seguenti funzioni RAWSQL sono disponibili in Tableau.

RAWSQL_BOOL("sql_expr", [arg1], …[argN])


Restituisce un risultato booleano da una data espressione SQL. L'espressione SQL viene passata direttamente al database sottostante. Utilizza %n nell'espressione SQL come sintassi di sostituzione per i valori del database.

Esempio

Nell'esempio, %1 è uguale a [Vendite] e %2 è uguale a [Profitto].

RAWSQL_BOOL("IIF( %1 > %2, True, False)", [Sales], [Profit])

RAWSQL_DATE("sql_expr", [arg1], …[argN])


Restituisce un risultato Data da un'espressione SQL. L'espressione SQL viene passata direttamente al database sottostante. Utilizza %n nell'espressione SQL come sintassi di sostituzione per i valori del database.

Esempio

In questo esempio, %1 è uguale a [Data ordine].

RAWSQL_DATE(“%1”, [Order Date])

RAWSQL_DATETIME("sql_expr", [arg1], …[argN])


Restituisce un risultato Data e ora da un'espressione SQL. L'espressione SQL viene passata direttamente al database sottostante. Utilizza %n nell'espressione SQL come sintassi di sostituzione per i valori del database. In questo esempio, %1 è uguale a [Data consegna].

Esempio

RAWSQL_DATETIME("MIN(%1)", [Data consegna])

RAWSQL_INT("sql_expr", [arg1], …[argN])


Restituisce come risultato un numero intero da una data espressione SQL. L'espressione SQL viene passata direttamente al database sottostante. Utilizza %n nell'espressione SQL come sintassi di sostituzione per i valori del database. In questo esempio, %1 è uguale a [Vendite].

Esempio

RAWSQL_INT(“500 + %1”, [Sales])

RAWSQL_REAL("sql_expr", [arg1], …[argN])


Restituisce un risultato numerico di una data espressione SQL che viene passato direttamente al database sottostante. Utilizza %n nell'espressione SQL come sintassi di sostituzione per i valori del database. In questo esempio, %1 è uguale a [Vendite]

Esempio

RAWSQL_REAL(“-123.98 * %1”, [Sales])

RAWSQL_SPATIAL


Restituisce uno Spaziale di una data espressione SQL che viene passato direttamente all'origine dati sottostante. Utilizza %n nell'espressione SQL come sintassi di sostituzione per i valori del database.

Esempio

In questo esempio, %1 è uguale a [Geometria]

RAWSQL_SPATIAL("%1", [Geometry])

RAWSQL_STR("sql_expr", [arg1], …[argN])


Restituisce una stringa da una data espressione SQL che viene passato direttamente al database sottostante. Utilizza %n nell'espressione SQL come sintassi di sostituzione per i valori del database. In questo esempio, %1 è uguale a [Nome cliente]

Esempio

RAWSQL_STR(“%1”, [Customer Name])

RAWSQLAGG_BOOL("sql_expr", [arg1], …[argN])


Restituisce un risultato booleano da una data espressione SQL aggregata. L'espressione SQL viene passata direttamente al database sottostante. Utilizza %n nell'espressione SQL come sintassi di sostituzione per i valori del database.

Esempio

Nell'esempio, %1 è uguale a [Vendite] e %2 è uguale a [Profitto].

RAWSQLAGG_BOOL("SUM( %1) >SUM( %2)", [Sales], [Profit])

RAWSQLAGG_DATE("sql_expr", [arg1], …[argN])


Restituisce una Data da un'espressione SQL aggregata. L'espressione SQL viene passata direttamente al database sottostante. Utilizza %n nell'espressione SQL come sintassi di sostituzione per i valori del database. In questo esempio, %1 è uguale a [Data ordine].

Esempio

RAWSQLAGG_DATE(“MAX(%1)”, [Order Date])

RAWSQLAGG_DATETIME("sql_expr", [arg1], …[argN])


Restituisce un risultato Data e ora da un'espressione SQL aggregata. L'espressione SQL viene passata direttamente al database sottostante. Utilizza %n nell'espressione SQL come sintassi di sostituzione per i valori del database. In questo esempio, %1 è uguale a [Data consegna].

Esempio

RAWSQLAGG_DATETIME(“MIN(%1)”, [Delivery Date])

RAWSQLAGG_INT("sql_expr", [arg1,] …[argN])


Restituisce un risultato numero intero da una data espressione SQL aggregata. L'espressione SQL viene passata direttamente al database sottostante. Utilizza %n nell'espressione SQL come sintassi di sostituzione per i valori del database. In questo esempio, %1 è uguale a [Vendite].

Esempio

RAWSQLAGG_INT(“500 + SUM(%1)”, [Sales])

RAWSQLAGG_REAL("sql_expr", [arg1,] …[argN])


Restituisce un risultato numerico di una data espressione SQL aggregata che viene passato direttamente al database sottostante. Utilizza %n nell'espressione SQL come sintassi di sostituzione per i valori del database. In questo esempio, %1 è uguale a [Vendite]

Esempio

RAWSQLAGG_REAL(“SUM( %1)”, [Sales])

RAWSQLAGG_STR("sql_expr", [arg1,] …[argN])


Restituisce una stringa da una data espressione SQL aggregata che viene passato direttamente al database sottostante. Utilizza %n nell'espressione SQL come sintassi di sostituzione per i valori del database. In questo esempio, %1 è uguale a [Sconto]

Esempio

RAWSQLAGG_STR(“AVG(%1)”, [Discount])

Funzioni spaziali

Le funzioni spaziali ti consentono di eseguire analisi spaziali avanzate e di combinare file spaziali con dati in altri formati, come file di testo o fogli di calcolo.

Funzione

Sintassi

Descrizione

AREAAREA(Spatial Polygon, "units")

Restituisce l'area della superficie totale di un poligono spaziale.

Nomi delle unità supportate: metri ("metri", "m"), chilometri ("chilometri", "km"), miglia ("miglia" o "mi"), piedi ("piedi", "ft").

BUFFERBUFFER(Spatial Point, distance, "units")

Restituisce una forma poligonale con un raggio determinato dalla distanza e dai valori di unità definiti nel calcolo.

Nota: il calcolo Buffer funziona solo con un oggetto Punto spaziale.

BUFFER supporta gli stessi nomi di unità della funzione DISTANCE.

DISTANCE

DISTANCE(<Spatial Point1>,<Spatial Point2>,"<units>")

Restituisce la misura della distanza tra due punti in un'unità specificata. Nomi delle unità supportate: metri ("metri", "m"), chilometri ("chilometri", "km"), miglia ("miglia" o "mi"), piedi ("piedi", "ft").

Questa funzione può essere creata solo con una connessione live e continuerà a funzionare quando un'origine dati viene convertita in un'estrazione.

Esempio:

DISTANCE([Origin MakePoint],[Destination MakePoint], "km")

INTERSECTSINTERSECTS (<geometry1>,<geometry2>)

Restituisce un valore booleano (vero/falso) che indica se due geometrie si sovrappongono nello spazio.

Combinazioni supportate: punto/poligono, linea/poligono e poligono/poligono.

MAKELINEMAKELINE(<Spatial Point1>,<Spatial Point2>)

Genera un indicatore di linea tra due punti; utile per costruire mappe di origine-destinazione.

Esempi:

MAKELINE(OriginPoint, DestinationPoint)

MAKELINE(MAKEPOINT(OriginLat],[OriginLong]),MAKEPOINT([DestinationLat],[DestinationLong])

MAKEPOINTMAKEPOINT(<latitude>, <longitude>)

Converte i dati delle colonne di latitudine e longitudine in oggetti spaziali.

Puoi utilizzare MAKEPOINT per abilitare spazialmente un'origine dati in modo che possa essere collegata con un file spaziale utilizzando un join spaziale. Per maggiori informazioni, consulta Creare un join dei file spaziali in Tableau.

Per utilizzare MAKEPOINT, i dati devono contenere le coordinate di latitudine e longitudine.

Esempio:

MAKEPOINT([AirportLatitude],[AirportLongitude])

MAKEPOINT(X,Y, SRID)

MAKEPOINT(<coordinatesX>, <coordinatesY>, <SRID>

Converte i dati delle coordinate geografiche proiettate in oggetti spaziali. SRID è un identificatore spaziale di riferimento che utilizza i codici del sistema di riferimento ESPG per specificare i sistemi di coordinate. Se SRID non è specificato, si presume che WGS84 e i parametri siano trattati come latitudine/longitudine in gradi.

Questa funzione può essere creata solo con una connessione live e continuerà a funzionare quando un'origine dati viene convertita in un'estrazione.

Esempio:

MAKEPOINT([Xcoord],[Ycoord],3493)

LENGTHLength (Spatial lines)Calcola la lunghezza combinata di tutte le stringhe di linea nel parametro spaziale.
OUTLINEOutline (Spatial geometry)Trasforma i poligoni (inclusi quelli all'interno di multipoligoni) in stringhe di linea. Ad esempio, puoi separare il contorno dal riempimento se posizioni il contorno su un altro livello.
SHAPETYPEShapeType (Spatial geometry)Restituisce una stringa che descrive la struttura della geometria spaziale, ad esempio Empty, Point, MultiPoint, LineString, MultiLinestring, Polygon, MultiPolygon, Mixed e unsupported.
Funzioni aggiuntive

Espressioni regolari

REGEXP_REPLACE(stringa, modello, sostituzione)

Restituisce una copia della stringa data in cui lo schema di espressione regolare è sostituito dalla stringa sostitutiva. Questa funzione è disponibile per Text File, Hadoop Hive, Google BigQuery, PostgreSQL, Tableau Data Extract, Microsoft Excel, Salesforce, Vertica, Pivotal Greenplum, Teradata (versione 14.1 e successive), Snowflake e origini dati Oracle.

Per le estrazioni di dati Tableau, il modello e la sostituzione devono essere costanti.

Per informazioni sulla sintassi delle espressioni regolari, consulta la documentazione dell'origine dati. Per gli estratti di Tableau, la sintassi delle espressioni regolari è conforme agli standard dell'ICU (International Components for Unicode), un progetto open source di librerie mature C/C++ e Java per il supporto Unicode, l'internazionalizzazione software e la globalizzazione software. Consulta la pagina Regular Expressions(Il collegamento viene aperto in una nuova finestra) nella guida dell'utente online di ICU.

Esempio

REGEXP_REPLACE ("abc 123", "\s", "-") = "abc-123"

REGEXP_MATCH(stringa, schema)

Restituisce true se una sottostringa della stringa specificata corrisponde al modello dell'espressione regolare. Questa funzione è disponibile per Text File, Google BigQuery, PostgreSQL, Tableau Data Extract, Microsoft Excel, Salesforce, Vertica, Pivotal Greenplum, Teradata (versione 14.1 e successive, Hadoop) Impala 2.3.0 (attraverso le origini dati Cloudera), Snowflake e origini dati Oracle.

Per l'estrazione dei dati di Tableau, il modello deve essere una costante.

Per informazioni sulla sintassi delle espressioni regolari, consulta la documentazione dell'origine dati. Per gli estratti di Tableau, la sintassi delle espressioni regolari è conforme agli standard dell'ICU (International Components for Unicode), un progetto open source di librerie mature C/C++ e Java per il supporto Unicode, l'internazionalizzazione software e la globalizzazione software. Consulta la pagina Regular Expressions(Il collegamento viene aperto in una nuova finestra) nella guida dell'utente online di ICU.

Esempio

REGEXP_MATCH('-([1234].[The.Market])-','\[\s*(\w*\.)(\w*\s*\])')=true

REGEXP_EXTRACT(stringa, schema)


Restituisce la porzione di stringa che corrisponde al modello di espressioni regolari. Questa funzione è disponibile per Text File, Hadoop Hive, Google BigQuery, PostgreSQL, Tableau Data Extract, Microsoft Excel, Salesforce, Vertica, Pivotal Greenplum, Teradata (versione 14.1 e successive), Snowflake e origini dati Oracle.

Per l'estrazione dei dati di Tableau, il modello deve essere una costante.

Per informazioni sulla sintassi delle espressioni regolari, consulta la documentazione dell'origine dati. Per gli estratti di Tableau, la sintassi delle espressioni regolari è conforme agli standard dell'ICU (International Components for Unicode), un progetto open source di librerie mature C/C++ e Java per il supporto Unicode, l'internazionalizzazione software e la globalizzazione software. Consulta la pagina Regular Expressions(Il collegamento viene aperto in una nuova finestra) nella guida dell'utente online di ICU.

Esempio

REGEXP_EXTRACT('abc 123', '[a-z]+\s+(\d+)') = '123'

REGEXP_EXTRACT_NTH(stringa, schema, indice)

Restituisce la porzione di stringa che corrisponde al modello di espressioni regolari. La porzione della stringa è abbinata al gruppo di acquisizione nth, dove n è l'indice dato. Se l'indice è 0, viene restituita l'intera stringa. Questa funzione è disponibile per Text File, PostgreSQL, Tableau Data Extract, Microsoft Excel, Salesforce, Vertica, Pivotal Greenplum, Teradata (versione 14.1 e successive) e origini dati Oracle.

Per l'estrazione dei dati di Tableau, il modello deve essere una costante.

Per informazioni sulla sintassi delle espressioni regolari, consulta la documentazione dell'origine dati. Per gli estratti di Tableau, la sintassi delle espressioni regolari è conforme agli standard dell'ICU (International Components for Unicode), un progetto open source di librerie mature C/C++ e Java per il supporto Unicode, l'internazionalizzazione software e la globalizzazione software. Consulta la pagina Regular Expressions(Il collegamento viene aperto in una nuova finestra) nella guida dell'utente online di ICU.

Esempio

REGEXP_EXTRACT_NTH('abc 123', '([a-z]+)\s+(\d+)', 2) = '123'

Funzioni specifiche di Hadoop Hive

Nota: solo le funzioni PARSE_URL_URL e PARSE_URL_QUERY sono disponibili per le origini dati Cloudera Impala.

GET_JSON_OBJECT(stringa JSON, percorso JSON)

Restituisce l'oggetto JSON all'interno della stringa JSON in base al percorso JSON.

PARSE_URL(stringa, url_parte)

Restituisce un componente della stringa URL data, dove il componente è definito da url_part. I valori validi di url_part includono: "HOST", "PATH", "QUERY", "REF", "PROTOCOL", "AUTHORITY", "FILE" e "USERINFO".

Esempio

PARSE_URL('http://www.tableau.com', 'HOST') = 'www.tableau.com'

PARSE_URL_QUERY(stringa, chiave)

Restituisce il valore del parametro della query specificato nella stringa URL data. Il parametro della query è definito dalla chiave.

Esempio

PARSE_URL_QUERY('http://www.tableau.com?page=1&cat=4', 'page') = '1'

XPATH_BOOLEAN(XML stringa, XStringa espressione percorso)

Restituisce true se l'espressione XPath corrisponde a un nodo o se viene valutata true.

Esempio

XPATH_BOOLEAN('<values> <value id="0">1</value><value id="1">5</value>', 'values/value[@id="1"] = 5') = true

XPATH_DOUBLE(XML stringa, XStringa espressione percorso)

Restituisce il valore a virgola mobile dell'espressione XPath.

Esempio

XPATH_DOUBLE('<values><value>1.0</value><value>5.5</value> </values>', 'sum(value/*)') = 6.5

XPATH_FLOAT(XML stringa, XStringa espressione percorso)

Restituisce il valore a virgola mobile dell'espressione XPath.

Esempio

XPATH_FLOAT('<values><value>1.0</value><value>5.5</value> </values>','sum(value/*)') = 6.5

XPATH_INT(XML stringa, XStringa espressione percorso)

Restituisce il valore numerico dell'espressione XPath o zero se l'espressione XPath non è in grado di valutare un numero.

Esempio

XPATH_INT('<values><value>1</value><value>5</value> </values>','sum(value/*)') = 6

XPATH_LONG(XML stringa, XStringa espressione percorso)

Restituisce il valore numerico dell'espressione XPath o zero se l'espressione XPath non è in grado di valutare un numero.

Esempio

XPATH_LONG('<values><value>1</value><value>5</value> </values>','sum(value/*)') = 6

XPATH_SHORT(XML stringa, XStringa espressione percorso)

Restituisce il valore numerico dell'espressione XPath o zero se l'espressione XPath non è in grado di valutare un numero.

Esempio

XPATH_SHORT('<values><value>1</value><value>5</value> </values>','sum(value/*)') = 6

XPATH_STRING(XML stringa, XStringa espressione percorso)

Restituisce il testo del primo nodo corrispondente.

Esempio

XPATH_STRING('<sites ><url domain="org">http://www.w3.org</url> <url domain="com">http://www.tableau.com</url></sites>', 'sites/url[@domain="com"]') = 'http://www.tableau.com'

Funzioni specifiche di Google BigQuery

DOMAIN(stringa_url)

Data una stringa URL, restituisce il dominio come stringa.

Esempio

DOMAIN('http://www.google.com:80/index.html') = 'google.com'

GROUP_CONCAT(espressione)

Concentra i valori di ogni record in una singola stringa delimitata da virgole. Questa funzione agisce come una SOMMA() per le stringhe.

Esempio

GROUP_CONCAT(Region) = "Central,East,West"

HOST(stringa_url)

Data una stringa URL, restituisce il nome host come stringa.

Esempio

HOST('http://www.google.com:80/index.html') = 'www.google.com:80'

LOG2(numero)

Restituisce il logaritmo base 2 di un numero.

Esempio

LOG2(16) = '4.00'

LTRIM_THIS(stringa, stringa)

Restituisce la prima stringa con l'eventuale occorrenza della seconda stringa rimossa.

Esempio

LTRIM_THIS('[-Sales-]','[-') = 'Sales-]'

RTRIM_THIS(stringa, stringa)

Restituisce la prima stringa con l'eventuale occorrenza finale della seconda stringa rimossa.

Esempio

RTRIM_THIS('[-Market-]','-]') = '[-Market'

TIMESTAMP_TO_USEC(espressione)

Converte un tipo di dati TIMESTAMP in un timestamp UNIX in microsecondi.

Esempio

TIMESTAMP_TO_USEC(#2012-10-01 01:02:03#)=1349053323000000

USEC_TO_TIMESTAMP(espressione)

Converte un timestamp UNIX in microsecondi in un tipo di dati TIMESTAMP.

Esempio

USEC_TO_TIMESTAMP(1349053323000000) = #2012-10-01 01:02:03#

TLD(stringa_url)

Data una stringa URL, restituisce il dominio di primo livello più qualsiasi dominio di paese/area geografica nell'URL.

Esempio

TLD('http://www.google.com:80/index.html') = '.com'

TLD('http://www.google.co.uk:80/index.html') = '.co.uk'



Vuoi sapere di più sulle funzioni?

Leggi gli argomenti relativi alle funzioni(Il collegamento viene aperto in una nuova finestra).

Vedi anche

Funzioni di Tableau (in ordine alfabetico)(Il collegamento viene aperto in una nuova finestra)

Grazie per il tuo feedback.