Funções do Tableau (por categoria)

A funções do Tableau nesta referência são organizadas por categoria. Clique em uma categoria para navegar pelas funções. Ou pressione Ctrl+F (Command-F em um Mac) para abrir a caixa de pesquisa que pode ser usada para buscar uma função específica na página.

Funções de número

Função

Sintaxe

Descrição

ABS

ABS(number)

Retorna o valor absoluto do número especificado.

Exemplos:

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

O segundo exemplo retorna o valor absoluto para todos os números contidos no campo Budget Variance.

ACOS

ACOS(number)

Retorna o arco cosseno do número especificado. O resultado é em radianos.

Exemplo:

ACOS(-1) = 3.14159265358979

ASIN

ASIN(number)

Retorna o arco seno de um número especificado. O resultado é em radianos.

Exemplo:

ASIN(1) = 1.5707963267949

ATAN

ATAN(number)

Retorna o arco tangente de um número especificado. O resultado é em radianos.

Exemplo:

ATAN(180) = 1.5652408283942

ATAN2

ATAN2(y number, x number)

Retorna o arco tangente de dois números especificados (x e y). O resultado é em radianos.

Exemplo:

ATAN2(2, 1) = 1.10714871779409

CEILING

CEILING(number)

Arredonda um número para o inteiro mais próximo de valor maior ou igual.

Exemplo:

CEILING(3.1415) = 4

Disponibilidade por fonte de dados:

Fonte de dadosSuporte
Microsoft AccessNão suportado
Microsoft ExcelSuportado
Arquivo de textoSuportado
Arquivo de estatísticaSuportado
Tableau ServerSuportado
Actian VectorNão suportado
Amazon Aurora for MySQLNão suportado
Amazon EMR Hadoop HiveSuportado
Amazon RedshiftSuportado
Aster DatabaseNão suportado
Cloudera HadoopSuportado
DataStax EnterpriseSuportado
EXASOLNão suportado
FirebirdNão suportado
Google AnalyticsSuportado
Google BigQuerySuportado
Google Cloud SQLNão suportado
Planilhas GoogleNão suportado
Hortonworks Hadoop HiveSuportado
IBM BigInsightsNão suportado
IBM DB2Não suportado
IBM PDA (Netezza)Não suportado
MapR Hadoop HiveSuportado
MarkLogicNão suportado
Microsoft Analysis ServicesNão suportado
Microsoft PowerPivotNão suportado
Microsoft SQL ServerSuportado
MySQLNão suportado
OracleNão suportado
Oracle EssbaseNão suportado
Actian Matrix (ParAccel)Não suportado
Pivotal GreenplumNão suportado
PostgreSQLNão suportado
Progress OpenEdgeNão suportado
SalesforceSuportado
SAP HANANão suportado
SAP Sybase ASENão suportado
SAP Sybase IQNão suportado
Spark SQLSuportado
SplunkNão suportado
TeradataNão suportado
Teradata OLAP ConnectorNão suportado
VerticaNão suportado

COS

COS(number)

Retorna o cosseno de um ângulo. Especifica o ângulo em radianos.

Exemplo:

COS(PI( ) /4) = 0.707106781186548

COT

COT(number)

Retorna a cotangente de um ângulo. Especifica o ângulo em radianos.

Exemplo:

COT(PI( ) /4) = 1

DEGREES

DEGREES(number)

Converte um determinado número em radianos em graus.

Exemplo:

DEGREES(PI( )/4) = 45.0

DIV

DIV(integer1, integer2)

Retorna a parte inteira de uma operação de divisão, na qual o inteiro1 é dividido pelo inteiro2.

Exemplo:

DIV(11,2) = 5

EXP

EXP(number)

Retorna e elevado à potência do número especificado.

Exemplos:

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

FLOOR

FLOOR(number)

Arredonda um número para o inteiro mais próximo de valor menor ou igual.

Exemplo:

FLOOR(3.1415) = 3

Disponibilidade por fonte de dados:

Fonte de dadosSuporte
Microsoft AccessNão suportado
Microsoft ExcelSuportado
Arquivo de textoSuportado
Arquivo de estatísticaSuportado
Tableau ServerSuportado
Actian VectorNão suportado
Amazon Aurora for MySQLNão suportado
Amazon EMR Hadoop HiveSuportado
Amazon RedshiftNão suportado
Aster DatabaseNão suportado
Cloudera HadoopSuportado
DataStax EnterpriseSuportado
EXASOLNão suportado
FirebirdNão suportado
Google AnalyticsSuportado
Google BigQuerySuportado
Google Cloud SQLNão suportado
Hortonworks Hadoop HiveSuportado
IBM BigInsightsNão suportado
IBM DB2Não suportado
IBM NetezzaNão suportado
MapR Hadoop HiveSuportado
MarkLogicNão suportado
Microsoft Analysis ServicesNão suportado
Microsoft PowerPivotNão suportado
Microsoft SQL ServerSuportado
MySQLNão suportado
OracleNão suportado
Oracle EssbaseNão suportado
ParAccelNão suportado
Pivotal GreenplumNão suportado
PostgreSQLNão suportado
Progress OpenEdgeNão suportado
SalesforceSuportado
SAP HANANão suportado
SAP Sybase ASENão suportado
SAP Sybase IQNão suportado
Spark SQLSuportado
SplunkNão suportado
TeradataNão suportado
Teradata OLAP ConnectorNão suportado
VerticaNão suportado

HEXBINX

HEXBINX(number, number)

Mapeia as coordenadas x, y com a coordenada x do compartimento hexagonal mais próximo. Os compartimentos têm extensão 1, então as entradas podem precisar ser escalonadas corretamente.

HEXBINX e HEXBINY são funções de armazenamento e plotagem dos compartimentos hexagonais. Compartimentos hexagonais são uma opção eficiente e elegante para a visualização de dados em um plano x/y como um mapa. Como os compartimentos são hexagonais, cada um se aproxima de um círculo e minimiza a variação da distância entre o ponto de dados e o centro do compartimento. Isso torna o agrupamento mais preciso e informativo.

Exemplo:

HEXBINX([Longitude], [Latitude])

HEXBINY

HEXBINY(number, number)

Mapeia as coordenadas x, y com a coordenada y do compartimento hexagonal mais próximo. Os compartimentos têm extensão 1, então as entradas podem precisar ser escalonadas corretamente.

Exemplo:

HEXBINY([Longitude], [Latitude])

LN

LN(number)

Retorna o algoritmo natural de um número. Retorna Null se o número for menor que ou igual a 0.

LOG

LOG(number [, base])

Retorna o algoritmo de um número para a base especificada. Se o valor de base for omitido, a base 10 será usada.

MAX

MAX(number, number)

Retorna o máximo de dois argumentos, que devem ser do mesmo tipo. Retorna Null se um dos argumentos for Null. MAX também pode ser aplicada a um único campo em um cálculo agregado.

Exemplos:

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

MIN

MIN(number, number)

Retorna o mínimo de dois argumentos, que devem ser do mesmo tipo. Retorna Null se um dos argumentos for Null. MIN também pode ser aplicada a um único campo em um cálculo agregado.

Exemplos:

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

PI

PI( )

Retorna o pi da constante numérica: 3.14159.

POWER

POWER(number, power)

Eleva o número à potência especificada.

Exemplos:

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

Também é possível usar o símbolo ^:

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

RADIANS

RADIANS(number)

Converte o número especificado de graus em radianos.

Exemplo:

RADIANS(180) = 3.14159

ROUND

ROUND(number, [decimals])

Arredonda os números para um número de dígitos especificado. O argumento decimals especifica quantos pontos decimais de precisão são necessários incluir no resultado final. Se decimals for omitido, number será arredondado para o inteiro mais próximo.

Exemplo:

Este exemplo arredonda todos os valores de Sales para um inteiro:

ROUND(Sales)

Alguns bancos de dados, como o SQL Server, permitem a especificação de um length negativo, em que -1 arredonda o number para múltiplos de 10, -2 arredonda para múltiplos de 100, etc. Isso não é válido para todos os bancos de dados. Por exemplo, isso não é verdadeiro para o Excel ou o Access.

Observação: como ROUND pode ter problemas devido à representação de ponto flutuante subjacente de números - como 9,405 arredondado para 9,40 - pode ser preferível formatar o número para o número desejado de pontos decimais em vez de arredondar. Formatar 9,405 com duas casas decimais produzirá o 9,41 esperado.

SIGN

SIGN(number)

Retorna o sinal de um número: os valores de retorno possíveis são: -1 se o número for negativo, 0 se o número for zero ou 1 se o número for positivo.

Exemplo:

Se a média do campo de lucro for negativa,

SIGN(AVG(Profit)) = -1

SIN

SIN(number)

Retorna o seno de um ângulo. Especifica o ângulo em radianos.

Exemplos:

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

SQRT

SQRT(number)

Retorna a raiz quadrada de um número.

Exemplo:

SQRT(25) = 5

SQUARE

SQUARE(number)

Retorna o quadrado de um número.

Exemplo:

SQUARE(5) = 25

TAN

TAN(number)

Retorna a tangente de um ângulo. Especifique o ângulo em radianos.

Exemplo:

TAN(PI ( )/4) = 1.0

ZN

ZN(expression)

Retorna a expressão se não for nulo, caso contrário, retorna zero. Use essa função para utilizar valores de zero, em vez de valores nulos.

Exemplo:

ZN([Profit]) = [Profit]

Funções de cadeia de caracteres

Função

Sintaxe

Definição

ASCII

ASCII(string)

Retorna o código ASCII do primeiro caractere de string.

Exemplo:

ASCII('A') = 65

CHAR

CHAR(number)

Retorna o caractere codificado pelo código ASCII number.

Exemplo:

CHAR(65) = 'A'

CONTAINS

CONTAINS(string, substring)

Retornará true se a cadeia de caracteres determinada contiver a subcadeia de caracteres especificada.

Exemplo:

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

ENDSWITH

ENDSWITH(string, substring)

Retornará true se a cadeia de caracteres determinada terminar com a subcadeia de caracteres especificada. Espaços em branco à direita são ignorados.

Exemplo:

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

FIND

FIND(string, substring, [start])

Retorna a posição de índice de substring em string ou 0 se a substring não for encontrada. Se o argumento opcional start for adicionado, a função ignorará qualquer instância de substring que apareça antes da posição de índice start. O primeiro caractere na cadeia de caracteres está na posição 1.

Exemplos:

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)

Retorna a posição da nª ocorrência de substring dentro da string especificada, onde n é definido pelo argumento de ocorrência

Observação: FINDNTH não está disponível em todas as fontes de dados.

Exemplo:

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

LEFT

LEFT(string, number)

Retorna o número de caracteres na extremidade esquerda na cadeia de caracteres.

Exemplo:

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

LEN

LEN(string)

Retorna o comprimento da cadeia de caracteres.

Exemplo:

LEN("Matador") = 7

LOWER

LOWER(string)

Retorna string, com todos os caracteres minúsculos.

Exemplo:

LOWER("ProductVersion") = "productversion"

LTRIM

LTRIM(string)

Retorna a cadeia de caracteres com os espaços à esquerda removidos.

Exemplo:

LTRIM(" Matador ") = "Matador "

MAX

MAX(a, b)

 

Retorna o máximo de a e b (que devem ser do mesmo tipo). Esta função é geralmente usada para comparar números, mas também funciona com strings. Com cadeias de caracteres, MAX localiza o valor mais alto na sequência de classificação definida pelo banco de dados para essa coluna. Ele retornará Null se um dos argumentos for Null.

Exemplo:

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

MID

(MID(string, start, [length])

Retorna a cadeia de caracteres que começa na posição de índice start. O primeiro caractere na cadeia de caracteres está na posição 1. Se o argumento opcional length for adicionado, a cadeia de caracteres retornada incluirá apenas esse número de caracteres.

Exemplos:

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

MIN

MIN(a, b)

Retorna o mínimo de a e b (que devem ser do mesmo tipo). Esta função é geralmente usada para comparar números, mas também funciona com strings. Com cadeias de caracteres, MIN localiza o valor menor na sequência de classificação. Ele retornará Null se um dos argumentos for Null.

Exemplo:

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

PROPERPROPER(string)

Converte uma cadeia de caracteres de texto para que a primeira letra de cada palavra seja maiúscula e as letras restantes fiquem em minúsculas. Espaços e caracteres não alfanuméricos, como pontuação, também atuam como separadores.

Exemplo:

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

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

REPLACE

REPLACE(string, substring, replacement)

Procura em string por substring e substitui por replacement. Se a substring não for encontrada, a string não será alterada.

Exemplo:

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

RIGHT

RIGHT(string, number)

Retorna o número de caracteres na extremidade direita em string.

Exemplo:

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

RTRIM

RTRIM(string)

Retorna string com os espaços à direita removidos.

Exemplo:

RTRIM(" Calculation ") = " Calculation"

SPACE

SPACE(number)

Retorna uma cadeia de caracteres composta por number especificado de espaços repetidos.

Exemplo:

SPACE(1) = " "

SPLIT

SPLIT(string, delimiter, token number)

Retorna uma subcadeia de uma cadeia de caracteres, usando um caractere delimitador para dividir a cadeia de caracteres em uma sequência de tokens.

A cadeia de caracteres é interpretada como uma sequência alternada de delimitadores e tokens. Então, para a cadeia de caracteres abc-defgh-i-jkl, onde o caractere delimitador é ‘-‘, os tokens são abc, defgh, i, e jlk. Pense neles como tokens de 1 a 4. DIVIDIR retorna o token correspondente ao número de token. Quando o número do token for positivo, os tokens são contados a partir do lado esquerdo da cadeia de caracteres; quando o número do token for negativo, os tokens são contados da direita.

Exemplos:

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


Observação: os comandos de divisão e divisão personalizada estão disponíveis para os tipos de fontes de dados a seguir: extrações de dados do Tableau, Microsoft Excel, arquivo de texto, arquivo 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.

Algumas fontes de dados impõe limites à cadeia de caracteres de divisão. A tabela a seguir mostra quais as fontes de dados que suportam números negativos de token (divisão da direita) e se existe um limite para o número de divisões permitidas por fonte de dados. Uma função de DIVISÃO que especifica um número de token negativo e seria legítimo com outras fontes de dados retornará este erro com essas fontes de dados: “A divisão a partir da direita não é compatível com a fonte de dados.”

 

Fonte de dadosRestrições de direita/esquerdaNúmero máximo de divisõesLimitações de versão
Extração de dados do TableauAmbosInfinito 
Microsoft ExcelAmbosInfinito 
Arquivo de textoAmbosInfinito 
SalesforceAmbosInfinito 
ODataAmbosInfinito 
Google AnalyticsAmbosInfinito 
Servidor de dados do TableauAmbosInfinitoCompatível com a versão 9.0.
VerticaEsquerda apenas10 
OracleEsquerda apenas10 
MySQLAmbos10 
PostgreSQLEsquerda somente antes da versão 9.0; para a versão 9.0 e posteriores10 
TeradataEsquerda apenas10Versão 14 e posteriores
Amazon RedshiftEsquerda apenas10 
Aster DatabaseEsquerda apenas10 
Google BigQueryEsquerda apenas10 
Hortonworks Hadoop HiveEsquerda apenas10 
Cloudera HadoopEsquerda apenas10Impala compatível a partir da versão 2.3.0.
Microsoft SQL ServerAmbos102008 e posteriores

STARTSWITH

STARTSWITH(string, substring)

Retornará true se string começar com substring. Espaços em branco à esquerda são ignorados.

Exemplo:

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

TRIM

TRIM(string)

Retorna a cadeia de caracteres com os espaços à esquerda e à direita removidos.

Exemplo:

TRIM(" Calculation ") = "Calculation"

UPPER

UPPER(string)

Retorna string, com todos os caracteres maiúsculos.

Exemplo:

UPPER("Calculation") = "CALCULATION"

Funções de data

O Tableau fornece uma variedade de funções de data. Muitos dos exemplos usam o símbolo # com expressões de data. Consulte Sintaxe de expressão literal para obter uma explicação desse símbolo. Além disso, muitas funções de data usam date_part, que é um argumento de cadeia de caracteres constante. Os valores date_part válidos que você pode usar são:

date_partValores
'year'Ano de quatro dígitos
'quarter'1-4
'month'1-12 ou "January", "February" e assim por diante
'dayofyear'Dia do ano; 1 de janeiro é 1, 1 de fevereiro é 32 etc.
'day'1-31
'weekday'1-7 ou "Sunday", "Monday" e assim por diante
'week'1-52
'hour'0-23
'minute'0-59
'second'0-60

Observação: As funções de data não consideram o início do ano fiscal configurado. Consulte Datas fiscais.

Função

Sintaxe

Descrição

DATEADD

DATEADD(date_part, interval, date)

Retorna a data especificada com o interval do número especificado, adicionado a date_part especificada dessa data.

Oferece suporte às datas de ISO 8601.

Exemplo:

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

Essa expressão adiciona três meses à data #2004-04-15#.

DATEDIFF

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

Retorna a diferença entre date1 e date2 expressa em unidades de date_part.

O parâmetro start_of_week, que você pode usar para especificar qual dia deve ser considerado o primeiro dia ou semana, é opcional. Os valores possíveis são 'monday' (segunda-feira), 'tuesday' (terça-feira) etc. Caso isso seja omitido, o início da semana é determinado pela fonte de dados. Consulte Propriedades de data para uma fonte de dados.

Oferece suporte às datas de ISO 8601.

Exemplos:

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

A primeira expressão retorna 1 porque quando start_of_week é 'monday', 22 de setembro (um domingo) e 24 de setembro (uma terça-feira) estão em semanas diferentes. A segunda expressão retorna 2 porque quando start_of_week é 'sunday', 22 de setembro (um domingo) e 24 de setembro (uma terça-feira) estão na mesma semana.

DATENAME

DATENAME(date_part, date, [start_of_week])

Retorna date_part de date como uma cadeia de caracteres. O parâmetro start_of_week, que você pode usar para especificar qual dia deve ser considerado o primeiro dia ou semana, é opcional. Os valores possíveis são 'monday' (segunda-feira), 'tuesday' (terça-feira) etc. Se start_of_week for emitido, o início da semana será determinado pela fonte de dados. Consulte Propriedades de data para uma fonte de dados.

Oferece suporte às datas de ISO 8601.

Exemplos:

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

DATEPARSEDATEPARSE(date_format, [date_string])

Retorna [date_string] como uma data. O argumento date_format descreverá como o campo [string] é organizado. Devido à variedade de maneiras que o campo de cadeia de caracteres pode ser ordenado, o date_format deve ter correspondência exata. Para obter uma explicação completa, consulte Converter um campo em um campo de data.

Exemplo:

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

Observação: essa função está disponível para os seguintes conectores: conexões não herdadas de arquivos de texto e do Excel, Amazon EMR, Hadoop Hive, Cloudera Hadoop, Planilhas Google, Hortonworks Hadoop Hive, MapR Hadoop Hive, MySQL, Oracle, PostgreSQL e extrações do Tableau. Alguns formatos talvez não estejam disponíveis para todas as conexões.

Observação: o DATEPARSE não é compatível nas variantes de Hive. Apenas Denodo, Drill e Snowflake são aceitos.

DATEPART

DATEPART(date_part, date, [start_of_week])

Retorna date_part de date como um inteiro.

O parâmetro start_of_week, que você pode usar para especificar qual dia deve ser considerado o primeiro dia ou semana, é opcional. Os valores possíveis são 'monday' (segunda-feira), 'tuesday' (terça-feira) etc. Se start_of_week for emitido, o início da semana será determinado pela fonte de dados. Consulte Propriedades de data para uma fonte de dados.

Observação: Quando date_part é um dia útil, o parâmetro start_of_week é ignorado. Isso é porque o Tableau usa uma ordenação de dias úteis fixa para aplicar desvios.

Oferece suporte às datas de ISO 8601.

Exemplos:

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

DATETRUNC

DATETRUNC(date_part, date, [start_of_week])

Trunca a data especificada na precisão definida por date_part. Esta função retorna uma nova data. Por exemplo, quando você trunca uma data no meio do mês no nível do mês, essa função retorna o primeiro dia do mês. O parâmetro start_of_week, que você pode usar para especificar qual dia deve ser considerado o primeiro dia ou semana, é opcional. Os valores possíveis são 'monday' (segunda-feira), 'tuesday' (terça-feira) etc. Se start_of_week for emitido, o início da semana será determinado pela fonte de dados. Consulte Propriedades de data para uma fonte de dados.

Oferece suporte às datas de ISO 8601.

Exemplos:

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)

Retorna o dia da data especificada como um inteiro.

Exemplo:

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

ISDATE

ISDATE(string)

Retornará true se uma determinada cadeia de caracteres for uma data válida.

Exemplo:

ISDATE("April 15, 2004") = true

MAKEDATE

MAKEDATE(year, month, day)

Retorna um valor de data composto por um ano, mês e dia específicos.

Disponível para as Extrações de dados do Tableau. Verifique a disponibilidade em outras fontes de dados.

Exemplo:

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

MAKEDATETIME

MAKEDATETIME(date, time)

Retorna um datetime que combina data e hora. A data pode ser um tipo date, datetime ou string. A hora deve ser um datetime.

Observação: esta função está disponível somente para conexões compatíveis com o MySQL (que, para o Tableau, são o MySQL e o Amazon Aurora).

Exemplos:

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)

Retorna um valor de data composto por uma hora, minuto e segundo específicos.

Disponível para as Extrações de dados do Tableau. Verifique a disponibilidade em outras fontes de dados.

Exemplo:

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

MAX

MAX(expression) or MAX(expr1, expr2)

Normalmente aplicado a números, mas também funciona em datas. Retorna o máximo de a e b (a e b devem ser do mesmo tipo). Retorna Null se um dos argumentos for Null.

Exemplos:

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

MIN

MIN(expression) or MIN(expr1, expr2)

Normalmente aplicado a números, mas também funciona em datas. Retorna o mínimo de a e b (a e b devem ser do mesmo tipo). Retorna Null se um dos argumentos for Null.

Exemplos:

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

MONTH

MONTH(date)

Retorna o mês da data especificada como um inteiro.

Exemplo:

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

NOW

NOW( )

Retorna a data e a hora atuais do sistema local.

Exemplo:

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

TRIMESTREQUARTER ( )

Retorna o trimestre da data especificada como um inteiro.

Exemplo:

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

TODAY

TODAY( )

Retorna a data atual.

Exemplo:

TODAY( ) = 2004-04-15

SEMANAWEEK( )

Retorna a semana da data especificada como um inteiro.

Exemplo:

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

YEAR

YEAR (date)

Retorna o ano da data especificada como um inteiro.

Exemplo:

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

ISOQUARTERISOQUARTER (date)

Retorna o trimestre baseado em semana ISO8601 de uma data especificada como um inteiro.

Exemplo:

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

ISOWEEKISOWEEK (date)

Retorna a semana baseada em semana ISO8601 especificada como um inteiro.

Exemplo:

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

ISOWEEKDAYISOWEEKDAY (date)

Retorna o dia da semana baseado em semana ISO8601 da data especificada como um inteiro.

Exemplo:

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

ISOYEARISOYEAR (date)

Retorna o ano baseado em semana ISO8601 de uma data especificada como um inteiro.

Exemplo:

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

Funções lógicas

Função

Sintaxe

Descrição

IN<expr1> IN <expr2>

Retorna TRUE se algum valor <expr1> corresponder a qualquer valor em <expr2>.

Os valores <expr2> podem ser um conjunto, lista de valores literais ou campo combinado.

Exemplos:

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

[Field] IN [SET]

AND

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

Realiza uma conjunção lógica em duas expressões.

Exemplo:

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

Realiza testes lógicos e retorna os valores apropriados. A função CASE avalia expression, compara com uma sequência de valores, value1, value2, etc., e retorna um resultado. Quando um valor correspondente a expression for encontrado, CASE retornará o valor de retorno correspondente. Se nenhuma correspondência for encontrada, a expressão de retorno padrão será usada. Se não houver retorno padrão e nenhuma correspondência de valor, Null será retornado.

CASE também aceita a construção WHEN IN, como

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

Os valores WHEN IN podem ser um conjunto, lista de valores literais ou campo combinado.

Notas adicionais

  • CASE versus IF: CASE é geralmente mais fácil de usar do que IIF ou IF THEN ELSE. Normalmente, uma função SE executa uma sequência de testes arbitrários e uma função CASE procura uma correspondência para uma expressão. Mas uma função CASE pode ser sempre reescrita como uma função IF, embora a função CASE seja geralmente mais concisa.
  • CASE versus grupos: muitas vezes, você pode usar um grupo para obter os mesmos resultados de uma função CASE complicada. Você pode querer ver qual é o melhor desempenho para o seu cenário.

Exemplos:

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 um série de expressões e retorna o valor <then> para a primeira <expr> verdadeira.

Exemplo:

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

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

Testa um série de expressões e retorna o valor <then> para a primeira <expr> verdadeira.

Exemplo:

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 um série de expressões e retorna o valor <then> para a primeira <expr> verdadeira. Deve ser colocada ao final de uma expressão.

Exemplo:

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 um série de expressões e retorna o valor <then> para a primeira <expr> verdadeira.

Exemplo:

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

IFNULLIFNULL(expr1, expr2)

Retorna <expr1> se não for nulo, caso contrário, retorna <expr2>.

Exemplo:

IFNULL([Profit], 0)

IIFIIF(test, then, else, [unknown])

Verifica se uma condição é atendida e retorna um valor se VERDADEIRA, outro valor se FALSA e um terceiro valor opcional ou NULO se desconhecida.

Exemplo:

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

ISDATEISDATE(string)

Retornará true se uma determinada cadeia de caracteres for uma data válida.

Exemplo:

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

ISNULLISNULL(expression)

Retorna true se a expressão é NULL (não contém dados válidos).

Exemplo:

ISNULL([Profit])

MAXMAX(expression) ou Max(expr1, expr2)

Retorna o máximo de uma expressão única em todos os registros ou o máximo de duas expressões para cada registro.

Exemplo:

MAX([Sales])

MINMIN(expression) ou MIN(expr1, expr2)

Retorna o mínimo de uma expressão em todos os registros ou o mínimo de duas expressões para cada registro.

Exemplo:

MIN([Profit])

NOTIF NOT <expr> THEN <then> END

Realiza uma negação lógica em uma expressão.

Exemplo:

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

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

Realiza uma disjunção lógica em duas expressões.

Exemplo:

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

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

Testa um série de expressões e retorna o valor <then> para a primeira <expr> verdadeira.

Exemplo:

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

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

Encontra o primeiro <value> que corresponde a <expr> e retorna o <return> correspondente.

Exemplo:

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

ZNZN(expression)

Retorna <expression> se não for nulo, caso contrário, retorna zero.

Exemplo:

ZN([Profit])

Funções de agregação

Agregações e aritmética de ponto flutuante: os resultados de algumas agregações nem sempre podem ser exatamente como desejado. Por exemplo, você pode descobrir que a função Sum retorna um valor como -1.42e-14 para uma coluna de número que você sabe que devem somar exatamente 0. Isso acontece porque o padrão de ponto flutuante 754 do IEEE (Institute of Electrical and Electronics Engineers) exige que os números sejam armazenados em formato binário, o que significa que são, às vezes, arredondados em níveis extremamente sutis de precisão. Você pode eliminar essa possível distração usando a função ROUND (ver Funções de número) ou formatando o número para mostrar menos casas decimais.

Função

Sintaxe

Definição

ATTR

ATTR(expression)

Retorna o valor da expressão caso tenha um único valor para todas as linhas. Do contrário, retorna um asterisco. Os valores nulos são ignorados.

AVG

AVG(expression)

Retorna a média de todos os valores na expressão. AVG pode ser usada com campos numéricos apenas. Os valores nulos são ignorados.

COLLECT

COLLECT (spatial)

Um cálculo agregado que combina os valores no campo do argumento. Os valores nulos são ignorados.

Observação: a função COLLECT pode ser usada apenas com campos espaciais.

Exemplo:

COLLECT ([Geometry])

CORR

CORR(expression 1, expression2)

Retorna o coeficiente de correlação Pearson de duas expressões.

A correlação Pearson mede a relação linear entre duas variáveis. Os resultados variam de -1 a +1 inclusive, em que 1 denota uma relação linear positiva e exata, quando uma alteração positiva em uma variável implica na alteração positiva da magnitude correspondente da outra variável, 0 denota nenhuma relação linear entre a variância e −1 é uma relação negativa exata.

CORR está disponível com as seguintes fontes de dados:

  • Extrações de dados do Tableau (crie uma extração a partir de qualquer fonte de dados)
  • Cloudera Hive
  • EXASolution
  • Firebird (versão 3.0 e posterior)
  • Google BigQuery
  • Hortonworks Hadoop Hive
  • IBM PDA (Netezza)
  • Oracle
  • PostgreSQL
  • Presto
  • SybaseIQ
  • Teradata
  • Vertica

Para outras fontes de dados, considere extrair os dados ou usar WINDOW_CORR. Consulte Funções de cálculo de tabela.

Observação: o quadrado de um resultado CORR é equivalente ao valor quadrado de R para um modelo de linha de tendência linear. Consulte Termos do modelo de linha de tendência.

Exemplo:

Use CORR para visualizar a correlação em um gráfico de dispersão desagregado. A maneira para fazer isso é usar uma expressão de nível de detalhe com escopo de tabela. Por exemplo:

{CORR(Sales, Profit)}

Com uma expressão de nível de detalhe, a correlação é executada em todas as linhas. Se usou uma fórmula como CORR(Sales, Profit) (sem estar entre colchetes, para torná-la uma expressão de nível de detalhe), a exibição mostraria a correlação de cada ponto individual no gráfico de dispersão em relação ao outro ponto, que está indefinido.

Consulte Escopo de tabela

COUNT

COUNT(expression)

Retorna o número de itens em um grupo. Os valores Null não são contados.

COUNTD

COUNTD(expression)

Retorna o número de itens distintos em um grupo. Os valores Null não são contados. Essa função não está disponível nos seguintes casos: pastas de trabalho criadas antes do Tableau Desktop 8.2 que usam fontes de dados do Microsoft Excel ou de arquivo de texto, pastas de trabalho que usam a conexão herdada e pastas de trabalho que usam fontes de dados do Microsoft Access. Extraia seus dados para um arquivo de extração para usar essa função. Consulte Extrair seus dados.

COVAR

COVAR(expression 1, expression2)

Retorna a covariância de amostra de duas expressões

A covariância quantifica como duas variáveis mudam ao mesmo tempo. Uma covariância positiva indica que as variáveis tendem a se mover na mesma direção, como quando valores maiores de uma variável tendem a corresponder aos valores maiores da outra variável, em média. A covariância de amostra usa o número de pontos de dados não nulos, n - 1, para normalizar o cálculo da covariância, em vez de n, que é usado pela covariância populacional (disponível com a função COVARP). A covariância de amostra é a escolha apropriada quando os dados são uma amostra aleatória sendo usada para estimar a covariância de uma população maior.

COVAR está disponível com as seguintes fontes de dados:

  • Extrações de dados do Tableau (crie uma extração a partir de qualquer fonte de dados)
  • Cloudera Hive
  • EXASolution
  • Firebird (versão 3.0 e posterior)
  • Google BigQuery
  • Hortonworks Hadoop Hive
  • IBM PDA (Netezza)
  • Oracle
  • PostgreSQL
  • Presto
  • SybaseIQ
  • Teradata
  • Vertica

Para outras fontes de dados, considere extrair os dados ou usar WINDOW_COVAR. Consulte Funções de cálculo de tabela.

Se expression1 e expression2 forem iguais — por exemplo, COVAR([profit], [profit]) — COVAR retorna um valor que indica como os valores são distribuídos amplamente.

Observação: o valor de COVAR(X, X) é equivalente ao valor de VAR(X) e também ao valor de STDEV(X)^2.

Exemplo:

A fórmula a seguir retorna a covariância de amostra de Sales e Profit.

COVAR([Sales], [Profit])

COVARP

COVARP(expression 1, expression2)

Retorna a covariância populacional de duas expressões

A covariância quantifica como duas variáveis mudam ao mesmo tempo. Uma covariância positiva indica que as variáveis tendem a se mover na mesma direção, como quando valores maiores de uma variável tendem a corresponder aos valores maiores da outra variável, em média. A covariância populacional é a covariância de amostra multiplicada por (n-1)/n, em que n é o número total de pontos de dados não nulos. A covariância populacional é a escolha apropriada quando há dados disponíveis para todos os itens de interesse, ao invés de somente um subconjunto aleatório de itens, em que a covariância de amostra (com a função COVAR) é apropriada.

COVARP está disponível com as seguintes fontes de dados:

  • Extrações de dados do Tableau (crie uma extração a partir de qualquer fonte de dados)
  • Cloudera Hive
  • EXASolution
  • Firebird (versão 3.0 e posterior)
  • Google BigQuery
  • Hortonworks Hadoop Hive
  • IBM PDA (Netezza)
  • Oracle
  • PostgreSQL
  • Presto
  • SybaseIQ
  • Teradata
  • Vertica

Para outras fontes de dados, considere extrair os dados ou usar WINDOW_COVARP. Consulte Funções de cálculo de tabela.

Se expression1 e expression2 forem iguais — por exemplo, COVARP([profit], [profit]) — COVARP retorna um valor que indica como os valores são distribuídos amplamente.

Observação: o valor de COVARP(X, X) é equivalente ao valor de VARP(X) e também ao valor de STDEVP(X)^2.

Exemplo:

A fórmula a seguir retorna a covariância populacional de Sales e Profit.

COVARP([Sales], [Profit])

MAX

MAX(expression)

Retorna o máximo de uma expressão em todos os registros. Se a expressão for um valor de cadeia de caracteres, essa função retornará o último valor que foi definido em ordem alfabética.

MEDIAN

MEDIAN(expression)

Retorna o mediano de uma expressão em todos os registros. O mediano pode ser usado apenas com campos numéricos. Os valores nulos são ignorados. Essa função não está disponível para pastas de trabalho criadas antes do Tableau Desktop 8.2 e que usam conexões herdadas. Ela também não está disponível para conexões usando qualquer uma das fontes de dados a seguir:

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

Para outros tipos de fonte de dados, é possível extrair os dados para um arquivo de extração para usar essa função. Consulte Extrair seus dados.

MIN

MIN(expression)

Retorna o mínimo de uma expressão em todos os registros. Se a expressão for um valor de cadeia de caracteres, essa função retornará o primeiro valor que foi definido em ordem alfabética.

PERCENTILE

PERCENTILE(expression, number)

Retorna o valor percentil da expressão indicada correspondente ao número especificado. O número deve estar entre 0 e 1 (inclusive); por exemplo, 0,66, e deve ser uma constante numérica.

Essa função está disponível para as fontes de dados a seguir.

  • Conexões do Microsoft Excel e de arquivo de texto não herdadas.

  • Extrações e tipos de fonte de dados somente de extração (por exemplo, Google Analytics, OData ou Salesforce).

  • Fontes de dados do Sybase IQ 15.1 e posterior.

  • Fontes de dados do Oracle 10 e versões posteriores.

  • Fontes de dados do Cloudera Hive e Hortonworks Hadoop Hive.

  • Fontes de dados do EXASolution 4.2 e versões posteriores.

Para outros tipos de fonte de dados, é possível extrair os dados para um arquivo de extração para usar essa função. Consulte Extrair seus dados.

STDEV

STDEV(expression)

Retorna o desvio padrão estatístico de todos os valores na expressão atribuída com base em uma amostra da população.

STDEVP

STDEVP(expression)

Retorna o desvio padrão estatístico de todos os valores na expressão atribuída com base em uma tendência de população.

SUM

SUM(expression)

Retorna a soma de todos os valores na expressão. SUM pode ser usada com campos numéricos apenas. Os valores nulos são ignorados.

VAR

VAR(expression)

Retorna a variação estatística de todos os valores na expressão atribuída com base em uma amostra da população.

VARP

VARP(expression)

Retorna a variação estatística de todos os valores na expressão atribuída com base na população inteira.

Funções de usuário

Função

Sintaxe

Descrição

FULLNAME

FULLNAME( )

Retorna o nome completo do usuário atual. Esse é o nome completo do Tableau Server ou Tableau Cloud quando o usuário está conectado; caso contrário, o local ou o nome completo da rede do usuário do Tableau Desktop.

Exemplos:

FULLNAME( ) 

Isso retorna o nome completo do usuário conectado, Dave Hallsten.

[Manager]=FULLNAME( )

Se o gerente Dave Hallsten estiver conectado, este exemplo retornará True somente se o campo Gerente da exibição contiver Dave Hallsten. Quando usado como um filtro, esse campo calculado poderá ser usado para criar um filtro de usuário que mostra apenas dados relevantes para a pessoa conectada ao servidor.

ISFULLNAME

ISFULLNAME(string)

Retorna true se o nome completo do usuário atual coincide com o nome completo especificado, ou false se não coincide. Essa função usa o nome completo do Tableau Server ou Tableau Cloud quando o usuário está conectado; caso contrário, usa o local ou o nome completo da rede do usuário do Tableau Desktop.

Exemplo:

ISFULLNAME("Dave Hallsten")

Esse exemplo retornará true se Dave Hallsten for o usuário atual, caso contrário, retornará false.

ISMEMBEROF

ISMEMBEROF(string)

Retornará true se a pessoa usando o Tableau atualmente for membro de um grupo que corresponda à cadeia de caracteres especificada. Se a pessoa que está usando o Tableau no momento estiver conectada, a associação ao grupo será determinada pelos grupos no Tableau Server ou Tableau Cloud. Caso a pessoa não tenha entrado, essa função retorna NULL.

Observação: a função retornará um valor “True” se a cadeia de caracteres especificada for “Todos os usuários”, conectados no Tableau Server ou no Tableau Cloud.

A função ISMEMBEROF() também aceitará domínios do Active Directory. O domínio do Active Directory deve ser declarado no cálculo com o nome do grupo.

Exemplo:

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

ISUSERNAME

ISUSERNAME(string)

Retorna true se o nome de usuário do usuário atual coincide com o nome de usuário especificado, ou false se não coincide. Essa função usa o nome de usuário do Tableau Server ou Tableau Cloud quando o usuário está conectado; caso contrário, usa o local ou o nome de usuário da rede do usuário do Tableau Desktop.

Exemplo:

ISUSERNAME("dhallsten")

Retornará true se dhallsten for o usuário atual; caso contrário, retornará false.

Observação: “Todos os usuários” sempre será retornado como “true”.

USERDOMAIN

USERDOMAIN()

Retorna o domínio do usuário atual quando o usuário está conectado no Tableau Server. Retorna o domínio do Windows se o usuário do Tableau Desktop estiver em um domínio. Caso contrário, essa função retornará uma cadeia de caracteres nula.

Exemplo:

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

USERNAME

USERNAME( )

Retorna o nome de usuário do usuário atual. Esse é o nome de usuário do Tableau Server ou Tableau Cloud quando o usuário está conectado; caso contrário, é o local ou nome de usuário da rede para o usuário do Tableau Desktop.

Exemplos:

USERNAME( ) 

Isso retorna o nome de usuário do usuário conectado, dhallsten.

[Manager]=USERNAME( )

Se o gerente dhallsten tivesse entrado, essa função só retornaria True quando o campo Gerente na exibição fosse dhallsten. Quando usado como um filtro, esse campo calculado pode ser usado para criar um filtro de usuário que mostra apenas dados relevantes para a pessoa que entrou no servidor.

USERATRIBUTEUSERATTRIBUTE('attribute_name')

(Para inserir fluxos de trabalho apenas no Tableau Cloud)

Retorna uma cadeia de caracteres. Se 'attribute_name' faz parte do JWT passado para o Tableau, o cálculo retorna o primeiro valor de 'attribute_name'. Retorna nulo se 'attribute_name' não existe.

Observação: você pode usar a função USERATTRIBUTEINCLUDES se você espera 'attribute_name' para retornar vários valores.

Exemplo:

Suponha que ‘Região’ seja o atributo de usuário incluído no JWT e passado para o Tableau usando o aplicativo conectado já configurado pelo administrador do site. Como autor da pasta de trabalho, você pode configurar sua visualização para filtrar dados com base em uma região especificada. Nesse filtro, você pode fazer referência ao seguinte cálculo.

[Region]=USERATTRIBUTE('Region')

Quando Alan Wang, da região oeste, exibe a visualização incorporada, o Tableau mostra os dados apropriados apenas para a região oeste.

USERATTRIBUTEINCLUDESUSERATTRIBUTEINCLUDES('attribute_name', 'expected_value')

(Para inserir fluxos de trabalho apenas no Tableau Cloud)

Retorna um booleano. Retorna "true" se o seguinte for verdadeiro: 1) 'attribute_name' faz parte do JWT passado para o Tableau e 2) um dos valores de'attribute_name' equivale a 'expected_value' . Caso contrário, retorna "false".

Observação: você pode usar a função USERATTRIBUTE se espera que 'attribute_name' retorne um único valor de cadeia de caracteres.

Exemplo:

Suponha que ‘Região’ seja o atributo de usuário definido no JWT e passado para o Tableau usando o aplicativo conectado já configurado pelo administrador do site. Como autor da pasta de trabalho, você pode configurar sua visualização para filtrar dados com base na [Região]. Nesse filtro, você pode fazer referência ao seguinte cálculo.

USERATTRIBUTEINCLUDES('Region', [Region])

Se Alan Wang da região Oeste acessar a visualização inserida, o Tableau verificará se o atributo de usuário Região corresponde a um dos valores do campo [Região]. Quando true, a visualização mostra os dados apropriados. Quando outro usuário, Michele Kim, da região Norte, acessa a mesma visualização, ela não consegue ver nenhum dado porque não há correspondência com os valores do campo [Região].

Cálculos de tabela

FIRST( )


Retorna o número de linhas da linha atual até a primeira linha na partição. Por exemplo, a exibição a seguir mostra as vendas trimestrais. Quando FIRST() é calculado na partição Date, a compensação da primeira linha em relação à segunda linha é -1.

Exemplo

Quando o índice de linha atual for 3, FIRST() = -2.

INDEX( )


Retorna o índice da linha atual na partição, sem qualquer classificação em relação ao valor. O índice da primeira linha começa em 1. Por exemplo, a tabela a seguir mostra as vendas trimestrais. Quando INDEX() é calculada na partição Date, o índice de cada linha é 1, 2, 3, 4..., etc.

Exemplo

Para a terceira linha na partição, INDEX() = 3.

LAST( )


Retorna o número de linhas da linha atual até a última linha na partição. Por exemplo, a tabela a seguir mostra as vendas trimestrais. Quando LAST() é calculado na partição Date, a compensação da última linha em relação à segunda linha é 5.

Exemplo

Quando o índice de linha atual for 3 de 7, LAST() = 4.

LOOKUP(expression, [offset])


Retorna o valor da expressão em uma linha de destino, especificada como uma compensação relativa da linha atual. Use FIRST() + n e LAST() - n como parte de sua definição de deslocamento para um destino relativo à primeira/última linha da partição. Se offset for omitido, a linha para comparação poderá ser definida no menu de campo. Esta função retornará NULL se a linha de destino não puder ser determinada.

A exibição a seguir mostra as vendas trimestrais. Quando LOOKUP (SUM(Sales), 2) é calculado na partição Date, cada linha mostra o valor de vendas de 2 trimestres no futuro.

Exemplo

LOOKUP(SUM([Profit]), FIRST()+2) calcula SUM(Profit) na terceira linha da partição.

MODEL_EXTENSION_BOOL (model_name, argumentos, expressão)


Retorna o resultado booleano de uma expressão calculada por um modelo nomeado implantado em um serviço externo TabPy.

Model_name é o nome do modelo de análise implementado que você deseja usar.

Cada argumento é uma única cadeia de caracteres que define os valores de entrada que o modelo implementado aceita e é definido pelo modelo analítico.

Use expressões para definir os valores que são enviados do Tableau para o modelo de análise. Certifique-se de usar funções de agregação (SUM, AVG, etc.) para agregar os resultados.

Ao usar a função, os tipos de dados e a ordem das expressões devem corresponder aos dos argumentos de entrada.

Exemplo

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

MODEL_EXTENSION_INT (nome_modelo, argumentos, expressão)


Retorna um resultado inteiro de uma expressão calculada por um modelo nomeado implantado em um serviço externo TabPy.

Model_name é o nome do modelo de análise implementado que você deseja usar.

Cada argumento é uma única cadeia de caracteres que define os valores de entrada que o modelo implementado aceita e é definido pelo modelo analítico.

Use expressões para definir os valores que são enviados do Tableau para o modelo de análise. Certifique-se de usar funções de agregação (SUM, AVG, etc.) para agregar os resultados.

Ao usar a função, os tipos de dados e a ordem das expressões devem corresponder aos dos argumentos de entrada.

Exemplo

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

MODEL_EXTENSION_REAL (nome_modelo, argumentos, expressão)


Retorna um resultado real de uma expressão calculada por um modelo nomeado implantado em um serviço externo TabPy.

Model_name é o nome do modelo de análise implementado que você deseja usar.

Cada argumento é uma única cadeia de caracteres que define os valores de entrada que o modelo implementado aceita e é definido pelo modelo analítico.

Use expressões para definir os valores que são enviados do Tableau para o modelo de análise. Certifique-se de usar funções de agregação (SUM, AVG, etc.) para agregar os resultados.

Ao usar a função, os tipos de dados e a ordem das expressões devem corresponder aos dos argumentos de entrada.

Exemplo

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

MODEL_EXTENSION_STRING (nome_modelo, argumentos, expressão)


Retorna o resultado da string de uma expressão calculada por um modelo nomeado implantado em um serviço externo TabPy.

Model_name é o nome do modelo de análise implementado que você deseja usar.

Cada argumento é uma única cadeia de caracteres que define os valores de entrada que o modelo implementado aceita e é definido pelo modelo analítico.

Use expressões para definir os valores que são enviados do Tableau para o modelo de análise. Certifique-se de usar funções de agregação (SUM, AVG, etc.) para agregar os resultados.

Ao usar a função, os tipos de dados e a ordem das expressões devem corresponder aos dos argumentos de entrada.

Exemplo

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

MODEL_PERCENTILE(target_expression, predictor_expression(s))


Retorna a probabilidade (entre 0 e 1) do valor esperado ser menor ou igual à marca observada, definida pela expressão-alvo e outros preditores. Esta é a Função de Distribuição Preditiva Posterior, também conhecida como Função de Distribuição Cumulativa (CDF).

Esta função é o inverso de MODEL_QUANTILE. Para obter informações sobre funções de modelagem preditiva, consulte Como funcionam as funções de modelagem preditiva no Tableau.

Exemplo

A fórmula a seguir devolve o quantil da marca para a soma das vendas, ajustada para contagem de pedidos.

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

MODEL_QUANTILE(quantile, target_expression, predictor_expression(s))


Retorna um valor numérico de destino dentro do intervalo provável definido pela expressão de destino e outros preditores, em um quantil especificado. Este é o Quantil Preditivo Posterior.

Esta função é o inverso de MODEL_PERCENTILE. Para obter informações sobre funções de modelagem preditiva, consulte Como funcionam as funções de modelagem preditiva no Tableau.

Exemplo

A fórmula a seguir retorna a mediana (0,5) da soma prevista de vendas, ajustada para contagem de pedidos.

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

PREVIOUS_VALUE(expression)


Retorna o valor desse cálculo na linha anterior. Retornará a expressão especificada se a linha atual for a primeira linha da partição.

Exemplo

SUM([Profit]) * PREVIOUS_VALUE(1) calcula o produto em execução de SUM(Profit).

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


Retorna a posição na classificação da concorrência padrão para a linha atual da partição. Valores idênticos são colocados em uma posição na classificação idêntica. Use o argumento opcional 'asc' | 'desc' para especificar a ordem crescente ou decrescente. O padrão é decrescente.

Com esta função, o conjunto de valores (6, 9, 9, 14) seria classificado (4, 2, 2, 1).

Os nulos são ignorados em funções de classificação. Eles não são numerados e não são contabilizados para o número total de registros em cálculos de posição na classificação percentil.

Para obter informações sobre opções de classificação diferentes, consulte Cálculo da posição na classificação.

Exemplo

A imagem a seguir mostra o efeito das várias funções de classificação (RANK, RANK_DENSE, RANK_MODIFIED, RANK_PERCENTILE e RANK_UNIQUE) sobre um conjunto de valores. O conjunto de dados contém informações sobre 14 alunos (do AlunoA até o AlunoN); a coluna Idade mostra a idade atual de cada aluno (todos entre 17 e 20 anos). As colunas restantes mostram o efeito de cada função do ranking no conjunto de valores de idade, sempre assumindo a ordem padrão (ascendente ou descendente) para a função.

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


Retorna a posição na classificação densa para a linha atual na partição. Para valores idênticos, são atribuídos uma mesma posição na classificação, mas nenhuma lacuna é inserida na sequência numérica. Use o argumento opcional 'asc' | 'desc' para especificar a ordem crescente ou decrescente. O padrão é decrescente.

Com esta função, o conjunto de valores (6, 9, 9, 14) seria classificado (3, 2, 2, 1).

Os nulos são ignorados em funções de classificação. Eles não são numerados e não são contabilizados para o número total de registros em cálculos de posição na classificação percentil.

Para obter informações sobre opções de classificação diferentes, consulte Cálculo da posição na classificação.

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


Retorna a posição na classificação da concorrência modificada para a linha atual na partição. Valores idênticos são colocados em uma posição na classificação idêntica. Use o argumento opcional 'asc' | 'desc' para especificar a ordem crescente ou decrescente. O padrão é decrescente.

Com esta função, o conjunto de valores (6, 9, 9, 14) seria classificado (4, 3, 3, 1).

Os nulos são ignorados em funções de classificação. Eles não são numerados e não são contabilizados para o número total de registros em cálculos de posição na classificação percentil.

Para obter informações sobre opções de classificação diferentes, consulte Cálculo da posição na classificação.

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


Retorna a posição na classificação percentil para a linha atual na partição. Use o argumento opcional 'asc' | 'desc' para especificar a ordem crescente ou decrescente. O padrão é crescente.

Com esta função, o conjunto de valores (6, 9, 9, 14) seria classificado (0,00, 0,67, 0,67, 1,00).

Os nulos são ignorados em funções de classificação. Eles não são numerados e não são contabilizados para o número total de registros em cálculos de posição na classificação percentil.

Para obter informações sobre opções de classificação diferentes, consulte Cálculo da posição na classificação.

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


Retorna a posição na classificação exclusiva para a linha atual na partição. Para valores idênticos, são atribuídas diferentes posições na classificação. Use o argumento opcional 'asc' | 'desc' para especificar a ordem crescente ou decrescente. O padrão é decrescente.

Com esta função, o conjunto de valores (6, 9, 9, 14) seria classificado (4, 2, 3, 1).

Os nulos são ignorados em funções de classificação. Eles não são numerados e não são contabilizados para o número total de registros em cálculos de posição na classificação percentil.

Para obter informações sobre opções de classificação diferentes, consulte Cálculo da posição na classificação.

RUNNING_AVG(expression)


Retorna a média em execução da expressão especificada a partir da primeira linha na partição para a linha atual.

A exibição a seguir mostra as vendas trimestrais. Quando RUNNING_AVG(SUM([Sales]) é calculado na partição Date, o resultado é uma média em execução dos valores de vendas de cada trimestre.

Exemplo

RUNNING_AVG(SUM([Profit])) calcula a média em execução de SUM(Profit).

RUNNING_COUNT(expression)


Retorna a contagem em execução da expressão especificada a partir da primeira linha na partição para a linha atual.

Exemplo

RUNNING_COUNT(SUM([Profit])) calcula a contagem em execução de SUM(Profit).

RUNNING_MAX(expression)


Retorna o máximo em execução da expressão especificada a partir da primeira linha na partição para a linha atual.

Exemplo

RUNNING_MAX(SUM([Profit])) calcula o máximo em execução de SUM(Profit).

RUNNING_MIN(expression)


Retorna o mínimo em execução da expressão especificada a partir da primeira linha na partição para a linha atual.

Exemplo

RUNNING_MIN(SUM([Profit])) calcula o mínimo em execução de SUM(Profit).

RUNNING_SUM(expression)


Retorna a soma em execução da expressão especificada a partir da primeira linha na partição para a linha atual.

Exemplo

RUNNING_SUM(SUM([Profit])) calcula a soma em execução de SUM(Profit)

SIZE()


Retorna o número de linhas na partição. Por exemplo, a exibição a seguir mostra as vendas trimestrais. Na partição Date, há sete linhas, portanto, o Size() da partição Date é 7.

Exemplo

SIZE() = 5 quando a partição atual contém cinco linhas.

SCRIPT_BOOL


Retorna um resultado Booliano da expressão especificada. A expressão é transmitida diretamente para uma extensão de análise em execução.

Nas expressões R, use .argn (com um ponto à frente) para fazer referência a parâmetros (.arg1, .arg2 etc.).

Nas expressões de Python, use _argn (com um sublinhado à frente).

Exemplos

Neste exemplo R, .arg1 é igual a SUM([Profit]):

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

O próximo exemplo retorna True para IDs de loja no estado de Washington e False para os demais. Este exemplo poderia ser a definição de um campo calculado intitulado IsStoreInWA.

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

Um comando do Python seria dessa forma:

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

SCRIPT_INT


Retorna um resultado do inteiro da expressão especificada. A expressão é transmitida diretamente para uma extensão de análise em execução.

Nas expressões R, use .argn (com um ponto à frente) para fazer referência a parâmetros (.arg1, .arg2 etc.).

Nas expressões de Python, use _argn (com um sublinhado à frente).

Exemplos

Neste exemplo R, .arg1 é igual a SUM([Profit]):

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

No próximo exemplo, o agrupamento k-means é usado para criar três clusters:

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

Um comando do Python seria dessa forma:

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

SCRIPT_REAL


Retorna um resultado real da expressão especificada. A expressão é transmitida diretamente para uma extensão de análise em execução. Nas

expressões R, use .argn (com um ponto à frente) para fazer referência a parâmetros (.arg1, .arg2 etc.).

Nas expressões de Python, use _argn (com um sublinhado à frente).

Exemplos

Neste exemplo R, .arg1 é igual a SUM([Profit]):

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

O próximo exemplo converte valores de temperatura de Celsius em Fahrenheit.

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

Um comando do Python seria dessa forma:

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

SCRIPT_STR


Retorna um resultado da cadeia de caracteres da expressão especificada. A expressão é transmitida diretamente para uma extensão de análise em execução.

Nas expressões R, use .argn (com um ponto à frente) para fazer referência a parâmetros (.arg1, .arg2 etc.).

Nas expressões de Python, use _argn (com um sublinhado à frente).

Exemplos

Neste exemplo R, .arg1 é igual a SUM([Profit]):

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

O próximo exemplo extrai uma abreviação de estado de uma cadeia de caracteres mais complicada (na forma original 13XSL_CA, A13_WA):

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

Um comando do Python seria dessa forma:

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

TOTAL(expression)


Retorna o número total da expressão fornecida em uma divisão do cálculo de tabela.

Exemplo

Suponha que você está começando com esta exibição:

Você abre o editor de cálculo e cria um novo campo nomeado de Totalidade:

Em seguida, solte o campo Totalidade em Texto para substituir SUM(Sales). Suas exibições são alteradas de tal forma, que ela soma os valores com base no valor padrão de Calcular usando:

Isso levanta a questão, qual é o valor padrão de Calcular usando? Se você clicar com o botão direito do mouse (clique pressionando a tecla Control, no Mac) na Totalidade, no painel de Dados, e escolher Editar, haverá um pouco de informação adicional disponível:

O valor padrão de Calcular usando é uma Tabela (horizontal). O resultado é que a Totalidade é soma dos valores em cada linha da tabela. Assim, o valor visualizado em cada linha é a soma dos valores da versão original da tabela.

Os valores na linha 2011/Q1 na tabela original foram de US$ 8.601,00; US$ 6.579,00; US$ 44.262,00; e US$ 15.006,00. Os valores na tabela após a Totalidade substituem a SUM(Sales) com um total de US $74.448,00; que é a soma dos quatro valores originais.

Observe o triângulo ao lado de Totalidade depois de soltá-lo em Texto:

Isso indica que este campo está usando um cálculo de tabela. Você pode clicar com o botão direito do mouse no campo e escolher Editar o cálculo de tabela para redirecionar a sua função para um valor de Calcular usando diferente. Por exemplo, você pode defini-lo para Tabela (vertical). Nesse caso, a tabela ficaria assim:

WINDOW_AVG(expression, [start, end])


Retorna a média da expressão na janela. A janela é definida por meio de compensações da linha atual. Use FIRST()+n e LAST()-n como compensações da primeira ou última linha na partição. Se o início e o fim forem omitidos, toda a partição será usada.

Por exemplo, a exibição a seguir mostra as vendas trimestrais. Uma média de janela na partição Date retorna a média de vendas em todas as datas.

Exemplo

WINDOW_AVG(SUM([Profit]), FIRST()+1, 0) calcula a média de SUM(Profit) a partir da segunda linha até a linha atual.

WINDOW_CORR(expression1, expression2, [start, end])


Retorna o coeficiente de correlação Pearson de duas expressões dentro da janela. A janela é definida como desvios em relação à linha atual. Use FIRST()+n e LAST()-n como compensações da primeira ou última linha na partição. Se o início e o fim forem omitidos, toda a partição será usada.

A correlação Pearson mede a relação linear entre duas variáveis. Os resultados variam de -1 a +1 inclusive, em que 1 denota uma relação linear positiva e exata, quando uma alteração positiva em uma variável implica na alteração positiva da magnitude correspondente da outra variável, 0 denota nenhuma relação linear entre a variância e −1 é uma relação negativa exata.

Há uma função de agregação equivalente: CORR. Consulte Funções do Tableau (em ordem alfabética)(O link abre em nova janela).

Exemplo

A fórmula a seguir retorna a correlação Pearson de SUM(Profit) e SUM(Sales) das cinco linhas anteriores à linha atual.

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

WINDOW_COUNT(expression, [start, end])


Retorna a contagem da expressão na janela. A janela é definida por meio de compensações da linha atual. Use FIRST()+n e LAST()-n como compensações da primeira ou última linha na partição. Se o início e o fim forem omitidos, toda a partição será usada.

Exemplo

WINDOW_COUNT(SUM([Profit]), FIRST()+1, 0) calcula a contagem de SUM(Profit) a partir da segunda linha até a linha atual

WINDOW_COVAR(expression1, expression2, [start, end])


Retorna a covariância de amostra de duas expressões dentro da janela. A janela é definida como desvios em relação à linha atual. Use FIRST()+n e LAST()-n como compensações da primeira ou última linha na partição. Se os argumentos iniciais e finais forem omitidos, a janela será toda a partição.

A covariância de amostra usa o número de pontos de dados não nulos, n - 1, para normalizar o cálculo da covariância, em vez de n, que é usado pela covariância populacional (disponível com a função WINDOWS_COVARP). A covariância de amostra é a escolha apropriada quando os dados são uma amostra aleatória sendo usada para estimar a covariância de uma população maior.

Há uma função de agregação equivalente: COVAR. Consulte Funções do Tableau (em ordem alfabética)(O link abre em nova janela).

Exemplo

A fórmula a seguir retorna a covariância de amostra de SUM(Profit) e SUM(Sales) das duas linhas anteriores à linha atual.

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

WINDOW_COVARP(expression1, expression2, [start, end])


Retorna a covariância populacional de duas expressões dentro da janela. A janela é definida como desvios em relação à linha atual. Use FIRST()+n e LAST()-n como compensações da primeira ou última linha na partição. Se o início e o fim forem omitidos, toda a partição será usada.

A covariância populacional é a covariância de amostra multiplicada por (n-1)/n, em que n é o número total de pontos de dados não nulos. A covariância populacional é a escolha apropriada quando há dados disponíveis para todos os itens de interesse, ao invés de somente um subconjunto aleatório de itens, em que a covariância de amostra (com a função WINDOWS_COVAR) é apropriada.

Há uma função de agregação equivalente: COVARP. Funções do Tableau (em ordem alfabética)(O link abre em nova janela)

Exemplo

A fórmula a seguir retorna a covariância populacional de SUM(Profit) e SUM(Sales) das duas linhas anteriores à linha atual.

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

WINDOW_MEDIAN(expression, [start, end])


Retorna o mediano da expressão na janela. A janela é definida por meio de compensações da linha atual. Use FIRST()+n e LAST()-n como compensações da primeira ou última linha na partição. Se o início e o fim forem omitidos, toda a partição será usada.

Por exemplo, a exibição a seguir mostra o lucro trimestral. Um mediano de janela na partição Date retorna o lucro médio em todas as datas.

Exemplo

WINDOW_MEDIAN(SUM([Profit]), FIRST()+1, 0) calcula o mediano de SUM(Profit) a partir da segunda linha até a linha atual.

WINDOW_MAX(expression, [start, end])


Retorna o máximo da expressão na janela. A janela é definida por meio de compensações da linha atual. Use FIRST()+n e LAST()-n como compensações da primeira ou última linha na partição. Se o início e o fim forem omitidos, toda a partição será usada.

Por exemplo, a exibição a seguir mostra as vendas trimestrais. Uma máxima de janela na partição Date retorna o máximo de vendas em todas as datas.

Exemplo

WINDOW_MAX(SUM([Profit]), FIRST()+1, 0) calcula o máximo de SUM(Profit) a partir da segunda linha até a linha atual.

WINDOW_MIN(expression, [start, end])


Retorna o mínimo da expressão na janela. A janela é definida por meio de compensações da linha atual. Use FIRST()+n e LAST()-n como compensações da primeira ou última linha na partição. Se o início e o fim forem omitidos, toda a partição será usada.

Por exemplo, a exibição a seguir mostra as vendas trimestrais. Um mínimo de janela na partição Date retorna o mínimo de vendas em todas as datas.

Exemplo

WINDOW_MIN(SUM([Profit]), FIRST()+1, 0) calcula o mínimo de SUM(Profit) a partir da segunda linha até a linha atual.

WINDOW_PERCENTILE(expression, number, [start, end])


Retorna o valor correspondente ao percentil especificado dentro da janela. A janela é definida por meio de compensações da linha atual. Use FIRST()+n e LAST()-n como compensações da primeira ou última linha na partição. Se o início e o fim forem omitidos, toda a partição será usada.

Exemplo

WINDOW_PERCENTILE(SUM([Profit]), 0.75, -2, 0) retorna o 75º percentil para SUM(Profit) das duas linhas anteriores para a linha atual.

WINDOW_STDEV(expression, [start, end])


Retorna o desvio padrão de exemplo da expressão na janela. A janela é definida por meio de compensações da linha atual. Use FIRST()+n e LAST()-n como compensações da primeira ou última linha na partição. Se o início e o fim forem omitidos, toda a partição será usada.

Exemplo

WINDOW_STDEV(SUM([Profit]), FIRST()+1, 0) calcula o desvio padrão de SUM(Profit) a partir da segunda linha até a linha atual.

WINDOW_STDEVP(expression, [start, end])


Retorna o desvio padrão tendencioso da expressão na janela. A janela é definida por meio de compensações da linha atual. Use FIRST()+n e LAST()-n como compensações da primeira ou última linha na partição. Se o início e o fim forem omitidos, toda a partição será usada.

Exemplo

WINDOW_STDEVP(SUM([Profit]), FIRST()+1, 0) calcula o desvio padrão de SUM(Profit) a partir da segunda linha até a linha atual.

WINDOW_SUM(expression, [start, end])


Retorna a soma da expressão na janela. A janela é definida por meio de compensações da linha atual. Use FIRST()+n e LAST()-n como compensações da primeira ou última linha na partição. Se o início e o fim forem omitidos, toda a partição será usada.

Por exemplo, a exibição a seguir mostra as vendas trimestrais. Uma soma de janela na partição Date retorna a soma de vendas em todos os trimestres.

Exemplo

WINDOW_SUM(SUM([Profit]), FIRST()+1, 0) calcula a soma de SUM(Profit) a partir da segunda linha até a linha atual.

WINDOW_VAR(expression, [start, end])


Retorna a variação da expressão na janela. A janela é definida por meio de compensações da linha atual. Use FIRST()+n e LAST()-n como compensações da primeira ou última linha na partição. Se o início e o fim forem omitidos, toda a partição será usada.

Exemplo

WINDOW_VAR((SUM([Profit])), FIRST()+1, 0) calcula a variância de SUM(Profit) a partir da segunda linha até a linha atual.

WINDOW_VARP(expression, [start, end])


Retorna a variação tendenciosa da expressão na janela. A janela é definida por meio de compensações da linha atual. Use FIRST()+n e LAST()-n como compensações da primeira ou última linha na partição. Se o início e o fim forem omitidos, toda a partição será usada.

Exemplo

WINDOW_VARP(SUM([Profit]), FIRST()+1, 0) calcula a variância de SUM(Profit) a partir da segunda linha até a linha atual.

Funções de passagem (RAWSQL)

As funções de passagem RAWSQL podem ser usadas para enviar expressões SQL diretamente ao banco de dados, sem serem interpretadas pelo Tableau. Se houver funções de banco de dados personalizadas que o Tableau não conheça, você poderá usar as funções de passagem para chamar essas funções personalizadas.

Em geral, seu banco de dados não entenderá os nomes de campo mostrados no Tableau. Como o Tableau não interpreta as expressões SQL que você inclui nas funções de passagem, o uso de nomes de campo do Tableau na sua expressão pode causar erros. Você pode usar uma sintaxe de substituição para inserir o nome do campo correto ou a expressão para um cálculo do Tableau no SQL de passagem. Por exemplo, se você tivesse uma função que calculasse o mediano de um conjunto de valores, você poderia chamar essa função na coluna [Sales] do Tableau, desta forma:

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

Como o Tableau não interpreta a expressão, você deve definir a agregação. É possível usar as funções RAWSQLAGG quando você estiver utilizando expressões agregadas.

As funções de passagem RAWSQL podem não funcionar com extrações ou fontes de dados publicadas se contiverem relacionamentos.

Funções RAWSQL

As funções RAWSQL a seguir estão disponíveis no Tableau.

RAWSQL_BOOL(“sql_expr”, [arg1], …[argN])


Retorna um resultado booliano de uma determinada expressão SQL. A expressão SQL é passada diretamente ao banco de dados subjacente. Use %n na expressão SQL como uma sintaxe substituta para os valores de banco de dados.

Exemplo

No exemplo, %1 é igual a [Sales] e %2 é igual a [Profit].

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

RAWSQL_DATE(“sql_expr”, [arg1], …[argN])


Retorna um resultado de Data de uma determinada expressão SQL. A expressão SQL é passada diretamente ao banco de dados subjacente. Use %n na expressão SQL como uma sintaxe substituta para os valores de banco de dados.

Exemplo

Neste exemplo, %1 é igual a [Order Date].

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

RAWSQL_DATETIME(“sql_expr”, [arg1], …[argN])


Retorna um resultado de Data e hora de uma determinada expressão SQL. A expressão SQL é passada diretamente ao banco de dados subjacente. Use %n na expressão SQL como uma sintaxe substituta para os valores de banco de dados. Neste exemplo, %1 é igual a [Delivery Date].

Exemplo

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

RAWSQL_INT(“sql_expr”, [arg1], …[argN])


Retorna um resultado de inteiro de uma determinada expressão SQL. A expressão SQL é passada diretamente ao banco de dados subjacente. Use %n na expressão SQL como uma sintaxe substituta para os valores de banco de dados. Neste exemplo, %1 é igual a [Sales].

Exemplo

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

RAWSQL_REAL(“sql_expr”, [arg1], …[argN])


Retorna um resultado numérico de uma expressão SQL conhecida que é passada diretamente ao banco de dados subjacente. Use %n na expressão SQL como uma sintaxe substituta para os valores de banco de dados. Neste exemplo, %1 é igual a [Sales]

Exemplo

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

RAWSQL_SPATIAL


Retorna um espacial de uma determinada expressão SQL que é passada diretamente aos dados subjacentes. Use %n na expressão SQL como uma sintaxe substituta para os valores de banco de dados.

Exemplo

Neste exemplo, %1 é igual a [Geometry].

RAWSQL_SPATIAL("%1", [Geometry])

RAWSQL_STR(“sql_expr”, [arg1], …[argN])


Retorna uma cadeia de caracteres de uma expressão SQL conhecida que é passada diretamente ao banco de dados subjacente. Use %n na expressão SQL como uma sintaxe substituta para os valores de banco de dados. Neste exemplo, %1 é igual a [Customer Name].

Exemplo

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

RAWSQLAGG_BOOL(“sql_expr”, [arg1], …[argN])


Retorna um resultado booliano de uma determinada expressão SQL de agregação. A expressão SQL é passada diretamente ao banco de dados subjacente. Use %n na expressão SQL como uma sintaxe substituta para os valores de banco de dados.

Exemplo

No exemplo, %1 é igual a [Sales] e %2 é igual a [Profit].

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

RAWSQLAGG_DATE(“sql_expr”, [arg1], …[argN])


Retorna um resultado de Data de uma determinada expressão SQL de agregação. A expressão SQL é passada diretamente ao banco de dados subjacente. Use %n na expressão SQL como uma sintaxe substituta para os valores de banco de dados. Neste exemplo, %1 é igual a [Order Date].

Exemplo

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

RAWSQLAGG_DATETIME(“sql_expr”, [arg1], …[argN])


Retorna um resultado de Data e hora de uma determinada expressão SQL de agregação. A expressão SQL é passada diretamente ao banco de dados subjacente. Use %n na expressão SQL como uma sintaxe substituta para os valores de banco de dados. Neste exemplo, %1 é igual a [Delivery Date].

Exemplo

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

RAWSQLAGG_INT(“sql_expr”, [arg1,] …[argN])


Retorna um resultado de inteiro de uma determinada expressão SQL de agregação. A expressão SQL é passada diretamente ao banco de dados subjacente. Use %n na expressão SQL como uma sintaxe substituta para os valores de banco de dados. Neste exemplo, %1 é igual a [Sales].

Exemplo

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

RAWSQLAGG_REAL(“sql_expr”, [arg1,] …[argN])


Retorna um resultado numérico de uma expressão SQL agregada que é passada diretamente ao banco de dados subjacente. Use %n na expressão SQL como uma sintaxe substituta para os valores de banco de dados. Neste exemplo, %1 é igual a [Sales]

Exemplo

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

RAWSQLAGG_STR(“sql_expr”, [arg1,] …[argN])


Retorna uma cadeia de caracteres de uma expressão SQL agregada conhecida que é passada diretamente ao banco de dados subjacente. Use %n na expressão SQL como uma sintaxe substituta para os valores de banco de dados. Neste exemplo, %1 é igual a [Discount].

Exemplo

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

Funções espaciais

As funções espaciais permitem executar a análise espacial avançada e combinar arquivos espaciais com dados em outros formatos, como arquivos de texto ou planilhas.

Função

Sintaxe

Descrição

ÁREAAREA(Spatial Polygon, "units")

Retorna a área total da superfície de um polígono espacial.

Nomes das unidades compatíveis: metros (“metros”, “metres”, “m”), quilômetros (“quilômetros”, “kilometres”, “km”), milhas (“milhas” ou “mi”), pés (“feet”, “ft”).

BUFFERBUFFER(Spatial Point, distance, "units")

Retorna uma forma de polígono com um raio determinado pelos valores de distância e unidade definidos no cálculo.

Observação: o cálculo do buffer funcionará apenas com um objeto espacial do Ponto.

O BUFFER aceita os mesmos nomes de unidade que a função DISTANCE

DISTÂNCIA

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

Retorna a medida de distância entre dois pontos em uma unidade especificada. Nomes das unidades compatíveis: metros (“metros”, “metres”, “m”), quilômetros (“quilômetros”, “kilometres”, “km”), milhas (“milhas” ou “mi”), pés (“feet”, “ft”).

Essa função só pode ser criada com uma conexão dinâmica e continuará a funcionar quando uma fonte de dados for convertida em uma extração.

Exemplo:

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

INTERSECTSINTERSECTS (<geometry1>,<geometry2>)

Retorna um Booleano (True/False) indicando se duas geometrias se sobrepõem no espaço.

Combinações suportadas: ponto/polígono, linha/polígono e polígono/polígono.

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

Gera uma marca de linha entre dois pontos; útil para criar mapas de origem-destino.

Exemplos:

MAKELINE(OriginPoint, DestinationPoint)

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

MAKEPOINTMAKEPOINT(<latitude>, <longitude>)

Converte dados das colunas de latitude e longitude em objetos espaciais.

Você pode usar o MAKEPOINT para ativar espacialmente uma fonte de dados para que ela possa ser unida a um arquivo espacial, utilizando uma ligação espacial. Para obter mais informações, consulte Unir arquivos espaciais no Tableau.

Para utilizar o MAKEPOINT, os dados devem conter coordenadas de latitude e longitude.

Exemplo:

MAKEPOINT([AirportLatitude],[AirportLongitude])

MAKEPOINT (X,Y, SRID)

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

Converte dados de coordenadas geográficas projetadas em objetos espaciais. SRID é um identificador de referência espacial que utiliza os códigos do sistema de referência ESPG para especificar sistemas de coordenadas. Se o SRID não for especificado, o WGS84 será considerado e os parâmetros serão tratados como latitude/longitude em graus.

Essa função só pode ser criada com uma conexão dinâmica e continuará a funcionar quando uma fonte de dados for convertida em uma extração.

Exemplo:

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

LENGTHLength (Spatial lines)Calcula o comprimento combinado de todas as strings de linha no parâmetro espacial.
OUTLINEOutline (Spatial geometry)Transforma polígonos (incluindo aqueles dentro de multipolígonos) em cadeias de linha. Por exemplo, você pode separar o contorno do preenchimento se colocar o contorno em outra camada.
SHAPETYPEShapeType (Spatial geometry)Retorna uma cadeia de caracteres que descreve a estrutura da geometria espacial, como Empty,Point,MultiPoint ,LineString,MultiLinestring,Polygon,MultiPolygon,Mixed eunsupported.
Funções adicionais

Expressões regulares

REGEXP_REPLACE(string, padrão, substituição)

Retorna uma cópia de uma cadeia de caracteres determinada, onde o padrão de expressão regular é substituído pela cadeia de caracteres de substituição. Esta função está disponível para fontes de dados de arquivo de texto, Hadoop Hive, Google BigQuery, PostgreSQL, Extração de dados do Tableau, Microsoft Excel, Salesforce, Vertica, Pivotal Greenplum, Teradata (versão 14.1 e posterior), Snowflake e Oracle.

Para extrações de dados do Tableau, o padrão e a reposição devem ser constantes.

Para obter mais informações sobre sintaxe de expressão regular, consulte a documentação da sua fonte de dados. Para extrações do Tableau, a sintaxe da expressão regular atende aos padrões de ICU (International Components for Unicode), um projeto de fonte aberta de bibliotecas de C/C++ e Java antigas para suporte de Unicode, internacionalização de software e globalização de software. Consulte a página Regular Expressions(O link abre em nova janela) (Expressões regulares) no ICU User Guide, disponível on-line.

Exemplo

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

REGEXP_MATCH(cadeia de caracteres, padrão)

Retorna true se uma subcadeia de caracteres de uma cadeia de caracteres específica corresponder ao padrão de expressão regular. Esta função está disponível para fontes de dados de arquivo de texto, Google BigQuery, PostgreSQL, Extração de dados do Tableau, Microsoft Excel, Salesforce, Vertica, Pivotal Greenplum, Teradata (versão 14.1 e posterior), Impala 2.3.0 (por meio de fontes de dados do Cloudera Hadoop), Snowflake e Oracle.

Para extrações de dados do Tableau, o padrão deve ser uma constante.

Para obter mais informações sobre sintaxe de expressão regular, consulte a documentação da sua fonte de dados. Para extrações do Tableau, a sintaxe da expressão regular atende aos padrões de ICU (International Components for Unicode), um projeto de fonte aberta de bibliotecas de C/C++ e Java antigas para suporte de Unicode, internacionalização de software e globalização de software. Consulte a página Regular Expressions(O link abre em nova janela) (Expressões regulares) no ICU User Guide, disponível on-line.

Exemplo

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

REGEXP_EXTRACT(cadeia de caracteres, padrão)


Retorna a parte de uma cadeia de caracteres que corresponda ao padrão de expressão regular. Esta função está disponível para fontes de dados de arquivo de texto, Hadoop Hive, Google BigQuery, PostgreSQL, Extração de dados do Tableau, Microsoft Excel, Salesforce, Vertica, Pivotal Greenplum, Teradata (versão 14.1 e posterior), Snowflake e Oracle.

Para extrações de dados do Tableau, o padrão deve ser uma constante.

Para obter mais informações sobre sintaxe de expressão regular, consulte a documentação da sua fonte de dados. Para extrações do Tableau, a sintaxe da expressão regular atende aos padrões de ICU (International Components for Unicode), um projeto de fonte aberta de bibliotecas de C/C++ e Java antigas para suporte de Unicode, internacionalização de software e globalização de software. Consulte a página Regular Expressions(O link abre em nova janela) (Expressões regulares) no ICU User Guide, disponível on-line.

Exemplo

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

REGEXP_EXTRACT_NTH(cadeia de caracteres, padrão, início)

Retorna a parte de uma cadeia de caracteres que corresponda ao padrão de expressão regular. A subcadeia é comparada com o grupo de captura nth, onde n é o índice dado. Se o índice for 0, toda a cadeia de caracteres é retornada. Esta função está disponível para fontes de dados de arquivo de texto, PostgreSQL, Extração de dados do Tableau, Microsoft Excel, Salesforce, HP Vertica, Pivotal Greenplum, Teradata (versão 14.1 e posterior) e Oracle.

Para extrações de dados do Tableau, o padrão deve ser uma constante.

Para obter mais informações sobre sintaxe de expressão regular, consulte a documentação da sua fonte de dados. Para extrações do Tableau, a sintaxe da expressão regular atende aos padrões de ICU (International Components for Unicode), um projeto de fonte aberta de bibliotecas de C/C++ e Java antigas para suporte de Unicode, internacionalização de software e globalização de software. Consulte a página Regular Expressions(O link abre em nova janela) (Expressões regulares) no ICU User Guide, disponível on-line.

Exemplo

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

Funções específicas do Hadoop Hive

Observação: somente as funções PARSE_URL e PARSE_URL_QUERY estão disponíveis para as fontes de dados do Cloudera Impala.

GET_JSON_OBJECT(cadeia de caracteres JSON, caminho JSON)

Retorna o objeto JSON dentro da cadeia de caracteres JSON baseando-se no caminho JSON.

PARSE_URL(string, parte_url)

Retorna um componente da cadeia de caractere de URL dada quando o componente é definido por parte_url. Valores url_part válidos incluem: 'HOST', 'PATH', 'QUERY', 'REF', 'PROTOCOL', 'AUTHORITY', 'FILE' e 'USERINFO'.

Exemplo

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

PARSE_URL_QUERY(string, chave)

Retorna o valor do parâmetro de consulta especificado na cadeia de caracteres de URL dada. O parâmetro de consulta é definido pela chave.

Exemplo

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

XPATH_BOOLEAN(cadeia de caracteres XML, cadeia de caracteres de expressão XPath)

Retorna verdadeiro se a expressão XPath corresponde a um nó ou é avaliada como verdadeira.

Exemplo

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

XPATH_DOUBLE(cadeia de caracteres XML, cadeia de caracteres da expressão XPath)

Retorna o valor de ponto flutuante da expressão XPath.

Exemplo

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

XPATH_FLOAT(cadeia de caracteres XML, cadeia de caracteres da expressão XPath)

Retorna o valor de ponto flutuante da expressão XPath.

Exemplo

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

XPATH_INT(cadeia de caracteres XML, cadeia de caracteres da expressão XPath)

Retorna o valor numérico da expressão XPath, ou zero, se a expressão XPath não pode ser avaliada como número.

Exemplo

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

XPATH_LONG(cadeia de caracteres XML, cadeia de caracteres da expressão XPath)

Retorna o valor numérico da expressão XPath, ou zero, se a expressão XPath não pode ser avaliada como número.

Exemplo

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

XPATH_SHORT(cadeia de caracteres XML, cadeia de caracteres da expressão XPath)

Retorna o valor numérico da expressão XPath, ou zero, se a expressão XPath não pode ser avaliada como número.

Exemplo

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

XPATH_STRING(cadeia de caracteres XML, cadeia de caracteres da expressão XPath)

Retorna o texto do primeiro nó correspondente.

Exemplo

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'

Funções específicas do Google BigQuery

DOMAIN(string_url)

Dada uma cadeia de caracteres de URL, retorna o domínio como uma cadeia de caractere.

Exemplo

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

GROUP_CONCAT(expressão)

Concatena os valores de cada registro em uma única string delimitada por vírgula. Esta função atua como uma SUM() para strings.

Exemplo

GROUP_CONCAT(Região) = "Central,Leste,Oeste"

HOST(string_url)

Dada uma cadeia de caracteres de URL, retorna o nome do host como uma cadeia de caracteres.

Exemplo

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

LOG2(número)

Retorna o logaritmo de um número na base 2.

Exemplo

LOG2(16) = '4.00'

LTRIM_THIS(string, string)

Retorna a primeira cadeia de caracteres com qualquer ocorrência da segunda cadeia de caracteres à esquerda removida.

Exemplo

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

RTRIM_THIS(cadeia de caracteres, cadeia de caracteres)

Retorna a primeira cadeia de caracteres com qualquer ocorrência da segunda cadeia de caracteres à direita removida.

Exemplo

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

TIMESTAMP_TO_USEC(expressão)

Converte um tipo de dado TIMESTAMP em um carimbo de data/hora UNIX em microssegundos.

Exemplo

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

USEC_TO_TIMESTAMP(expressão)

Converte um carimbo de data/hora UNIX em microssegundos em um tipo de dados TIMESTAMP.

Exemplo

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

TLD(string_url)

Dada uma cadeia de caracteres de URL, retorna o domínio de nível superior mais qualquer domínio de país/região na URL.

Exemplo

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

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



Deseja saber mais sobre as funções?

Leia os tópicos sobre funções(O link abre em nova janela).

Consulte também

Funções do Tableau (em ordem alfabética)(O link abre em nova janela)

Agradecemos seu feedback!