Ajuda para criação na Web e Tableau Desktop

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

O segundo exemplo retorna o valor absoluto para todos os números contidos no campo Variação de orçamento.

ACOS(-1) = 3.14159265358979

ASIN(1) = 1.5707963267949

ATAN(180) = 1.5652408283942

A função inversa, TAN, toma o ângulo em radianos como argumento e retorna a tangente.

Consulte também ATAN2 e COT.

ATAN2(2, 1) = 1.10714871779409

CEILING(2.1) = 3

CEILING está disponível por meio dos seguintes conectores: Microsoft Excel, Text File, Statistical File, Published Data Source, Amazon EMR Hadoop Hive, Amazon Redshift, Cloudera Hadoop, DataStax Enterprise, Google Analytics, Google BigQuery, Hortonworks Hadoop Hive, MapR Hadoop Hive, Microsoft SQL Server, Salesforce, Spark SQL.

O argumento numérico é o ângulo em radianos.

COS(PI( ) /4) = 0.707106781186548

A função inversa, ACOS, toma o cosseno como argumento e retorna o ângulo em radianos.

Consulte também PI. Para converter um ângulo de graus em radianos, use RADIANS.

O argumento numérico é o ângulo em radianos.

COT(PI( ) /4) = 1

O argumento numérico é o ângulo em radianos.

DEGREES(PI( )/4) = 45.0

A função inversa, RADIANS, obtém um ângulo em graus e retorna o ângulo em radianos.

Consulte também PI().

DIV(11,2) = 5

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

FLOOR(7.9) = 7

FLOOR está disponível por meio dos seguintes conectores: Microsoft Excel, Text File, Statistical File, Published Data Source, Amazon EMR Hadoop Hive, Cloudera Hadoop, DataStax Enterprise, Google Analytics, Google BigQuery, Hortonworks Hadoop Hive, MapR Hadoop Hive, Microsoft SQL Server, Salesforce, Spark SQL.

HEXBINX([Longitude]*2.5, [Latitude]*2.5)

HEXBINY([Longitude]*2.5, [Latitude]*2.5)

Número

A saída é Null se o argumento for menor ou igual a zero.

LN(50) = 3.912023005

Se o argumento base opcional não estiver presente, a base 10 será usada.

LOG(16,4) = 2

Retorna o máximo de dois argumentos, que devem ser do mesmo tipo de dados.

MAX também pode ser aplicada a um único campo em uma agregação.

MAX(4,7) = 7
MAX(#3/25/1986#, #2/20/2021#) = #2/20/2021# 
MAX([Name]) = "Zander"

Para cadeia de caracteres

MAX geralmente é o valor que vem por último em ordem alfabética.

Para fontes de dados de bancos de dados, o valor de cadeia de caracteres MAX é o mais alto na sequência de classificação definida pelo banco de dados para essa coluna.

Para datas

Para datas, MAX é a data mais recente. Se MAX for uma agregação, o resultado não terá uma hierarquia de datas. Se MAX for uma comparação, o resultado manterá a hierarquia de datas.

Como uma agregação

MAX(expression) é uma função agregada e retorna um único resultado agregado. Isso é exibido como AGG(expression) na visualização.

Como comparação

MAX(expr1, expr2) compara os dois valores e retorna um valor em nível de linha.

Consulte também MIN.

Retorna, no mínimo, dois argumentos, que devem ser do mesmo tipo de dados.

MIN também pode ser aplicada a um único campo em uma agregação.

MIN(4,7) = 4
MIN(#3/25/1986#, #2/20/2021#) = #3/25/1986#
MIN([Name]) = "Abebi"

Para cadeia de caracteres

MIN geralmente é o valor que vem primeiro em ordem alfabética.

Para fontes de dados de bancos de dados, o valor de cadeia de caracteres MIN é o mais baixo na sequência de classificação definida pelo banco de dados para essa coluna.

Para datas

Para datas, o MIN é a data mais antiga. Se MIN for uma agregação, o resultado não terá uma hierarquia de datas. Se MIN for uma comparação, o resultado manterá a hierarquia de datas.

Como uma agregação

MIN(expression) é uma função agregada e retorna um único resultado agregado. Isso é exibido como AGG(expression) na visualização.

Como comparação

MIN(expr1, expr2) compara os dois valores e retorna um valor em nível de linha.

Consulte também MAX.

PI() = 3.14159

POWER(5,3) = 125
POWER([Temperature], 2)

Consulte também EXP, LOG e SQUARE.

RADIANS(180) = 3.14159

Arredonda o <number> para um de dígitos especificado.

O argumento de decimals opcional especifica quantos pontos decimais de precisão são necessários incluir no resultado final. Se os decimals forem omitidos, o número será arredondado para o inteiro mais próximo.

ROUND(1/3, 2) = 0.33

Alguns bancos de dados, como o SQL Server, permitem a especificação de um comprimento negativo, em que -1 arredonda o número 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.

Dica: 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.

Consulte também CEILING e FLOOR.

SIGN(AVG(Profit)) = -1

O argumento numérico é o ângulo em radianos.

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

A função inversa, ASIN, toma o seno como argumento e retorna o ângulo em radianos.

Consulte também PI. Para converter um ângulo de graus em radianos, use RADIANS.

SQRT(25) = 5

SQUARE(5) = 25

O argumento numérico é o ângulo em radianos.

TAN(PI ( )/4) = 1.0

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

Use esta função para substituir valores nulos por zeros.

ZN(Grade) = 0

ASCII('A') = 65

CHAR(65) = 'A'

CONTAINS("Calculation", "alcu") = true

ENDSWITH("Tableau", "leau") = true

Retorna a posição de índice de uma subcadeia de caracteres em uma cadeia de caracteres, ou 0 se a subcadeia de caracteres não for encontrada. O primeiro caractere na cadeia de caracteres está na posição 1.

Se o argumento opcional start for adicionado, a função ignorará qualquer instância de subcadeia de caracteres de uma cadeia de caracteres específica que apareça antes da posição de início.

FIND("Calculation", "alcu") = 2

FIND("Calculation", "Computer") = 0

FIND("Calculation", "a", 3) = 7

FIND("Calculation", "a", 2) = 2

FIND("Calculation", "a", 8) = 0

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

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

Veja também o RegEx aceito na documentação de funções adicionais(O link abre em nova janela).

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

LEN("Matador") = 7

LOWER("ProductVersion") = "productversion"

LTRIM(" Matador ") = "Matador "

Retorna o máximo de dois argumentos, que devem ser do mesmo tipo de dados.

MAX também pode ser aplicada a um único campo em uma agregação.

MAX(4,7) = 7
MAX(#3/25/1986#, #2/20/2021#) = #2/20/2021# 
MAX([Name]) = "Zander"

Para cadeia de caracteres

MAX geralmente é o valor que vem por último em ordem alfabética.

Para fontes de dados de bancos de dados, o valor de cadeia de caracteres MAX é o mais alto na sequência de classificação definida pelo banco de dados para essa coluna.

Para datas

Para datas, MAX é a data mais recente. Se MAX for uma agregação, o resultado não terá uma hierarquia de datas. Se MAX for uma comparação, o resultado manterá a hierarquia de datas.

Como uma agregação

MAX(expression) é uma função agregada e retorna um único resultado agregado. Isso é exibido como AGG(expression) na visualização.

Como comparação

MAX(expr1, expr2) compara os dois valores e retorna um valor em nível de linha.

Consulte também MIN.

Retorna uma cadeia de caracteres começando na posição start especificada. O primeiro caractere na cadeia de caracteres está na posição 1.

Se o argumento numérico opcional length for adicionado, a cadeia de caracteres retornada incluirá apenas esse número de caracteres.

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

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

Retorna, no mínimo, dois argumentos, que devem ser do mesmo tipo de dados.

MIN também pode ser aplicada a um único campo em uma agregação.

MIN(4,7) = 4
MIN(#3/25/1986#, #2/20/2021#) = #3/25/1986#
MIN([Name]) = "Abebi"

Para cadeia de caracteres

MIN geralmente é o valor que vem primeiro em ordem alfabética.

Para fontes de dados de bancos de dados, o valor de cadeia de caracteres MIN é o mais baixo na sequência de classificação definida pelo banco de dados para essa coluna.

Para datas

Para datas, o MIN é a data mais antiga. Se MIN for uma agregação, o resultado não terá uma hierarquia de datas. Se MIN for uma comparação, o resultado manterá a hierarquia de datas.

Como uma agregação

MIN(expression) é uma função agregada e retorna um único resultado agregado. Isso é exibido como AGG(expression) na visualização.

Como comparação

MIN(expr1, expr2) compara os dois valores e retorna um valor em nível de linha.

Consulte também MAX.

Retorna a <string> fornecida com primeira letra de cada palavra maiúscula, e as letras restantes em minúsculas.

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

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

Espaços e caracteres não alfanuméricos, como pontuação, são tratados como separadores.

Veja também LOWER e UPPER.

REPLACE("Version 3.8", "3.8", "4x") = "Version 4x"

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

RTRIM(" Calculation ") = " Calculation"

SPACE(2) = "  "

SPLIT ("a-b-c-d", "-", 2) = "b"

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

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, em que o caracter delimitador é '-', os tokens são (1) abc, (2) defgh, (3) i e (4) jlk.

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

Consulte também o REGEX compatível na documentação de funções adicionais(O link abre em nova janela).

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 às cadeias de caracteres de divisão. Consulte Limitações da função SPLIT posteriormente neste tópico.

STARTSWITH("Matador, "Ma") = TRUE

TRIM(" Calculation ") = "Calculation"

UPPER("Calculation") = "CALCULATION"

DATE([Employee Start Date])

DATE("September 22, 2018") 

DATE("9/22/2018")

DATE(#2018-09-22 14:52#)

Ao contrário de DATEPARSE, não há necessidade de fornecer um padrão como DATE, pois reconhece automaticamente muitos formatos de data padrão. Se DATE não reconhecer a entrada, no entanto, tente usar DATEPARSE e especificar o formato.

MAKEDATE é outra função semelhante, mas MAKEDATE requer a entrada de valores numéricos para ano, mês e dia.

Adie todas as datas de vencimento em uma semana

DATEADD('week', 1, [due date])

Adicione 280 dias à data 20 de fevereiro de 2021

DATEADD('day', 280, #2/20/21#) = #November 27, 2021#

Número de dias entre 25 de março de 1986 e 20 de fevereiro de 2021

DATEDIFF('day', #3/25/1986#, #2/20/2021#) = 12,751

Quantos meses alguém estava em uma banda

DATEDIFF('month', [date joined band], [date left band])

DATENAME('year', #3/25/1986#) = "1986"

DATENAME('month', #1986-03-25#) = "March"

Oferece suporte às datas de ISO 8601.

Um cálculo muito semelhante é DATEPART, que retorna o valor da parte da data especificada como um inteiro contínuo. DATEPART pode ser mais rápido porque é uma operação numérica.

Alterando os atributos do resultado do cálculo (dimensão ou medida, contínua ou discreta) e a formatação da data, os resultados de DATEPART e DATENAME podem ser formatados para serem idênticos.

Uma função inversa é DATEPARSE, que recebe um valor de cadeia de caracteres e o formata como uma data.

DATEPARSE('yyyy-MM-dd', "1986-03-25") = #March 25, 1986#

DATE é uma função semelhante que reconhece automaticamente muitos formatos de data padrão. DATEPARSE pode ser uma opção melhor se DATE não reconhecer o padrão de entrada.

MAKEDATE é outra função semelhante, mas MAKEDATE requer a entrada de valores numéricos para ano, mês e dia.

As funções inversas, que separam datas e retornam o valor de suas partes, são DATEPART (saída de inteiro) e DATENAME (saída de cadeia de caracteres).

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

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

DATEPART('year', #1986-03-25#) = 1986

DATEPART('month', #1986-03-25#) = 3

Oferece suporte às datas de ISO 8601.

Um cálculo muito semelhante é DATENAME, que retorna o nome da parte da data especificada como uma cadeia de caracteres discreta. DATEPART pode ser mais rápido porque é uma operação numérica. Alterando os atributos do resultado do campo (dimensão ou medida, contínua ou discreta) e a formatação da data, os resultados de DATEPART e DATENAME podem ser formatados para serem idênticos.

Uma função inversa é DATEPARSE, que recebe um valor de cadeia de caracteres e o formata como uma data.

DATETRUNC('day', #9/22/2018#) = #9/22/2018#

DATETRUNC('iso-week', #9/22/2018#) = #9/17/2018#

(a segunda-feira da semana contendo 9/22/2018)

DATETRUNC(quarter, #9/22/2018#) = #7/1/2018# 

(primeiro dia do trimestre contendo 9/22/2018)

Observação: para semana e iso-semana, o start_of_week é usado. Os dias da semana do ISO sempre começam na segunda-feira. Para a localidade deste exemplo, um start_of_week não especificado significa que a semana começa no domingo.

Oferece suporte às datas de ISO 8601.

Você não deveria usar DATETRUNC para, por exemplo, parar de mostrar a hora de um campo de data e hora em uma visualização. Se você quiser truncar a exibição de uma data em vez de arredondar sua precisão, ajuste a formatação(O link abre em nova janela).

Por exemplo, DATETRUNC('day', #5/17/2022 3:12:48 PM#), se formatado na visualização para exibir segundos, seria exibido como 5/17/2022 12:00:00 AM.

Day(#September 22, 2018#) = 22

ISDATE(09/22/2018) = true

ISDATE(22SEP18) = false

ISOQUARTER(#1986-03-25#) = 1

ISOWEEK(#1986-03-25#) = 13

ISOWEEKDAY(#1986-03-25#) = 2

ISOYEAR(#1986-03-25#) = 1,986

MAKEDATE(1986,3,25) = #1986-03-25#

Observação: os valores inseridos incorretamente serão ajustados em uma data, como MAKEDATE(2020,4,31) = May 1, 2020 em vez de retornar um erro informando que não há 31 de abril.

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

MAKEDATE requer entradas numéricas para as partes de uma data. Se os dados são uma cadeia de caracteres que deveria ser uma data, tente a função DATE. DATE reconhece automaticamente muitos formatos de data padrão. Se DATE não reconhecer a entrada, tente usar DATEPARSE.

MAKEDATETIME("1899-12-30", #07:59:00#) = #12/30/1899 7:59:00 AM#

MAKEDATETIME([Date], [Time]) = #1/1/2001 6:00:00 AM#

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

MAKETIME é uma função semelhante disponível para Extrações de dados do Tableau e algumas outras fontes de dados.

MAKETIME(14, 52, 40) = #1/1/1899 14:52:40#

Como o Tableau não oferece suporte a um tipo de dados de hora, apenas DATETIME e hora, a saída é uma datetime. A parte de data do campo será 1/1/1899.

Função semelhante a MAKEDATETIME, que só está disponível para conexões compatíveis com MYSQL.

Retorna o máximo de dois argumentos, que devem ser do mesmo tipo de dados.

MAX também pode ser aplicada a um único campo em uma agregação.

MAX(4,7) = 7
MAX(#3/25/1986#, #2/20/2021#) = #2/20/2021# 
MAX([Name]) = "Zander"

Para cadeia de caracteres

MAX geralmente é o valor que vem por último em ordem alfabética.

Para fontes de dados de bancos de dados, o valor de cadeia de caracteres MAX é o mais alto na sequência de classificação definida pelo banco de dados para essa coluna.

Para datas

Para datas, MAX é a data mais recente. Se MAX for uma agregação, o resultado não terá uma hierarquia de datas. Se MAX for uma comparação, o resultado manterá a hierarquia de datas.

Como uma agregação

MAX(expression) é uma função agregada e retorna um único resultado agregado. Isso é exibido como AGG(expression) na visualização.

Como comparação

MAX(expr1, expr2) compara os dois valores e retorna um valor em nível de linha.

Consulte também MIN.

Retorna, no mínimo, dois argumentos, que devem ser do mesmo tipo de dados.

MIN também pode ser aplicada a um único campo em uma agregação.

MIN(4,7) = 4
MIN(#3/25/1986#, #2/20/2021#) = #3/25/1986#
MIN([Name]) = "Abebi"

Para cadeia de caracteres

MIN geralmente é o valor que vem primeiro em ordem alfabética.

Para fontes de dados de bancos de dados, o valor de cadeia de caracteres MIN é o mais baixo na sequência de classificação definida pelo banco de dados para essa coluna.

Para datas

Para datas, o MIN é a data mais antiga. Se MIN for uma agregação, o resultado não terá uma hierarquia de datas. Se MIN for uma comparação, o resultado manterá a hierarquia de datas.

Como uma agregação

MIN(expression) é uma função agregada e retorna um único resultado agregado. Isso é exibido como AGG(expression) na visualização.

Como comparação

MIN(expr1, expr2) compara os dois valores e retorna um valor em nível de linha.

Consulte também MAX.

MONTH(#1986-03-25#) = 3

NOW() = 1986-03-25 1:08:21 PM

NOW não aceita um argumento.

Consulte também TODAY, um cálculo semelhante que retorna uma data em vez de uma data e hora.

Se a fonte de dados for uma conexão ativa, a data e a hora do sistema podem estar em outro fuso horário. Para obter mais informações sobre como abordar isso, consulte Base de dados de conhecimento.

QUARTER(#1986-03-25#) = 1

TODAY() = 1986-03-25

TODAY não aceita um argumento.

Consulte também NOW, um cálculo semelhante que retorna uma data e hora em vez de uma data.

Se a fonte de dados for uma conexão em tempo real, a data do sistema pode estar em outro fuso horário. Para obter mais informações sobre como abordar isso, consulte Base de dados de conhecimento.

WEEK(#1986-03-25#) = 13

YEAR(#1986-03-25#) = 1,986

IF [Season] = "Spring" AND "[Season] = "Fall" 
THEN "It's the apocalypse and footwear doesn't matter" 
END

"Se ambos (Season = Spring) e (Season = Fall) forem true simultaneamente, então retorna It's the apocalypse and footwear doesn't matter."

Frequentemente usado com IF e IIF. Veja também NOT e OU.

Se ambas as expressões forem TRUE (ou seja, não FALSE ou NULL), então o resultado será TRUE. Se uma das expressões for NULL, o resultado será NULL. Em todos os outros casos, o resultado será FALSE.

Se você criar um cálculo no qual o resultado de uma comparação AND e exibido em uma planilha, o Tableau exibirá TRUE e FALSE. Para alterar isso, use a área Formatar na caixa de diálogo de formatação.

Observação: o operador AND emprega short circuit evaluation. Isso significa que se a primeira expressão for avaliada como FALSE, a segunda expressão não será avaliada. Isso poderá ser útil se a segunda expressão resultar em um erro quando a primeira for FALSE, pois a segunda expressão nesse caso nunca será avaliada.

Avalia expression e compara com as opções especificadas (<value1>, <value2>, etc.). Quando um value que corresponde à expressão é encontrado, CASE retorna o return correspondente. Se nenhuma correspondência for encontrada, a (opcional) padrão será retornada. Se não houver padrão e nenhuma correspondência de valor, Null será retornado.

CASE [Season] 
WHEN 'Summer' THEN 'Sandals' 
WHEN 'Winter' THEN 'Boots' 
ELSE 'Sneakers' 
END

"Olhe para o campo Season. Se o valor for Summer, retorna Sandals. Se o valor for Winter, retorna Boots. Se nenhuma das opções do cálculo corresponder ao que está no campo Season, retorna um Sneakers."

Veja também IF e IIF.

Usado com WHEN, THEN, ELSE e END.

Dica: muitas vezes você pode usar um grupo para obter os mesmos resultados de uma função CASE complicada ou usar CASE para substituir a funcionalidade de agrupamento nativo, como no exemplo anterior. Você pode querer testar qual é o melhor desempenho para o seu cenário.

IF [Season] = "Summer" THEN 'Sandals' 
ELSEIF [Season] = "Winter" THEN 'Boots' 
ELSE 'Sneakers' 
END

CASE [Season] 
WHEN 'Summer' THEN 'Sandals' 
WHEN 'Winter' THEN 'Boots' 
ELSE 'Sneakers' 
END

Usado com CASE, WHEN, IF, ELSEIF, THEN e END

ELSE é opcional com CASE e IF. Em um cálculo onde ELSE não for especificado, se nenhum dos <test> forem true, o cálculo geral retornará nulo.

ELSE não requer uma condição (como [Season] = "Winter") e pode ser considerado uma forma de tratamento nulo.

IF [Season] = "Summer" THEN 'Sandals' 
ELSEIF [Season] = "Winter" THEN 'Boots' 
ELSEIF [Season] = "Spring" THEN 'Sneakers' 
ELSEIF [Season] = "Autumn" THEN 'Sneakers'
ELSE 'Bare feet' 
END

Usado com IF, THEN, ELSE e END

ELSEIF pode ser considerado cláusulas adicionais IF. ELSEIF é opcional e pode ser repetido várias vezes.

Diferente de ELSE, ELSEIF requer uma condição (como [Season] = "Winter").

IF [Season] = "Summer" THEN 'Sandals' 
ELSEIF [Season] = "Winter" THEN 'Boots' 
ELSE 'Sneakers' 
END

"Se Season = Summer, então retorna Sandals. Caso contrário, observe a próxima expressão. Se Season = Winter, então retorna Boots. Se nenhuma das expressões for true, retorna Sneakers."

CASE [Season] 
WHEN 'Summer' THEN 'Sandals' 
WHEN 'Winter' THEN 'Boots' 
ELSE 'Sneakers' 
END

"Olhe para o campo Season. Se o valor for Summer, retorna Sandals. Se o valor for Winter, retorna Boots. Se nenhuma das opções do cálculo corresponder ao que está no campo Season, retorna um Sneakers."

Usado com CASE, WHEN, IF, ELSEIF, THEN e ELSE.

Testa uma série de expressões e retorna o valor <then> para o primeiro <test> true.

IF [Season] = "Summer" THEN 'Sandals' 
ELSEIF [Season] = "Winter" THEN 'Boots' 
ELSE 'Sneakers' 
END

"Se Season = Summer, então retorna Sandals. Caso contrário, observe a próxima expressão. Se Season = Winter, então retorna Boots. Se nenhuma das expressões for true, retorna Sneakers."

Veja também IF e IIF.

Usado com ELSEIF, THEN, ELSE e END

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

IFNULL([Assigned Room], "TBD")

"Se o campo Assigned Room não for nulo, retorna seu valor. Se o campo Assigned Room for nulo, retorna TBD."

Compare com ISNULL. IFNULL sempre retorna um valor. ISNULL retorna um booleano (true ou false).

Consulte também ZN.

IIF([Season] = 'Summer', 'Sandals', 'Other footwear')

"Se Season = Summer, então retorna Sandals. Caso contrário, retorna Other footwear"

IIF([Season] = 'Summer', 'Sandals', 
   IIF('Season' = 'Winter', 'Boots',  'Other footwear')
)

"Se Season = Summer, então retorna Sandals. Caso contrário, observe a próxima expressão. Se Season = Winter, então retorna Boots. Se nenhuma for true, retrona Sneakers."

IIF('Season' = 'Summer', 'Sandals', 
   IIF('Season' = 'Winter', 'Boots',  
      IIF('Season' = 'Spring', 'Sneakers', 'Other footwear')
   )
)

"Se Season = Summer, então retorna Sandals. Caso contrário, observe a próxima expressão. Se Season = Winter, então retorna Boots. Se nenhuma das expressões for true, retorna Sneakers.”

Consulte também IF e CASE.

IIF não tem equivalente a ELSEIF (como IF) ou cláusulas WHEN repetidas (como CASE). Em vez disso, vários testes podem ser avaliados sequencialmente aninhando as declarações IIF como o elemento <unknown>. O primeiro true (mais externo) é retornado.

Ou seja, no cálculo abaixo o resultado será Red e não Orange, pois a expressão deixa de ser avaliada assim que A=A for avaliada como true:

IIF('A' = 'A', 'Red', IIF('B' = 'B', 'Orange', IIF('C' = 'D', 'Yellow', 'Green')))

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

"O valor do campo Custo é 1000, 15 ou 200?"

[Field] IN [Set]

"O valor do campo está presente no conjunto?"

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

Consulte também WHEN.

ISDATE("2018-09-22")

"A cadeia de caracteres 2018-09-22 é uma data formatada corretamente?"

O que é considerado uma data válida depende da localidade(O link abre em nova janela) do sistema que avalia o cálculo. Por exemplo:

Nos Estados Unidos:

• ISDATE("2018-09-22") = TRUE
• ISDATE("2018-22-09") = FALSE

No Reino Unido:

• ISDATE("2018-09-22") = FALSE
• ISDATE("2018-22-09") = TRUE

Retorna true se <expression> é NULL (não contém dados válidos).

ISNULL([Assigned Room])

"O campo Sala Atribuída é nulo?"

Compare com IFNULL. IFNULL sempre retorna um valor. ISNULL retorna um booleano.

Consulte também ZN.

Retorna o máximo de dois argumentos, que devem ser do mesmo tipo de dados.

MAX também pode ser aplicada a um único campo em uma agregação.

MAX(4,7) = 7
MAX(#3/25/1986#, #2/20/2021#) = #2/20/2021# 
MAX([Name]) = "Zander"

Para cadeia de caracteres

MAX geralmente é o valor que vem por último em ordem alfabética.

Para fontes de dados de bancos de dados, o valor de cadeia de caracteres MAX é o mais alto na sequência de classificação definida pelo banco de dados para essa coluna.

Para datas

Para datas, MAX é a data mais recente. Se MAX for uma agregação, o resultado não terá uma hierarquia de datas. Se MAX for uma comparação, o resultado manterá a hierarquia de datas.

Como uma agregação

MAX(expression) é uma função agregada e retorna um único resultado agregado. Isso é exibido como AGG(expression) na visualização.

Como comparação

MAX(expr1, expr2) compara os dois valores e retorna um valor em nível de linha.

Consulte também MIN.

Retorna, no mínimo, dois argumentos, que devem ser do mesmo tipo de dados.

MIN também pode ser aplicada a um único campo em uma agregação.

MIN(4,7) = 4
MIN(#3/25/1986#, #2/20/2021#) = #3/25/1986#
MIN([Name]) = "Abebi"

Para cadeia de caracteres

MIN geralmente é o valor que vem primeiro em ordem alfabética.

Para fontes de dados de bancos de dados, o valor de cadeia de caracteres MIN é o mais baixo na sequência de classificação definida pelo banco de dados para essa coluna.

Para datas

Para datas, o MIN é a data mais antiga. Se MIN for uma agregação, o resultado não terá uma hierarquia de datas. Se MIN for uma comparação, o resultado manterá a hierarquia de datas.

Como uma agregação

MIN(expression) é uma função agregada e retorna um único resultado agregado. Isso é exibido como AGG(expression) na visualização.

Como comparação

MIN(expr1, expr2) compara os dois valores e retorna um valor em nível de linha.

Consulte também MAX.

IF NOT [Season] = "Summer" 
THEN 'Don't wear sandals' 
ELSE 'Wear sandals' 
END

"Se Season não é igual a Summer, então retorna Don't wear sandals. Caso contrário, retorna Wear sandals"

Frequentemente usado com IF e IIF. Veja também DATE e OU.

IF [Season] = "Spring" OR [Season] = "Fall" 
THEN "Sneakers" 
END

"Se (Season = Spring) ou (Season = Fall) for true, retorna Sneakers."

Frequentemente usado com IF e IIF. Veja também DATE e NOT.

Se uma das expressões for TRUE, o resultado será TRUE. Se ambas as expressões forem FALSE, o resultado será FALSE. Se ambas as expressões forem NULL, o resultado será NULL.

Se você criar um cálculo que exibe o resultado de uma comparação OR em uma planilha, o Tableau exibirá TRUE e FALSE. Para alterar isso, use a área Formatar na caixa de diálogo de formatação.

Observação: o operador OR emprega short circuit evaluation. Isso significa que se a primeira expressão for avaliada como TRUE, a segunda expressão não será avaliada. Isso poderá ser útil se a segunda expressão resultar em um erro quando a primeira for TRUE, pois a segunda expressão nesse caso nunca será avaliada.

IF [Season] = "Summer" THEN 'Sandals' 
ELSEIF [Season] = "Winter" THEN 'Boots' 
ELSE 'Sneakers' 
END

"Se Season = Summer, então retorna Sandals. Caso contrário, observe a próxima expressão. Se Season = Winter, então retorna Boots. Se nenhuma das expressões for true, retorna Sneakers."

CASE [Season] 
WHEN 'Summer' THEN 'Sandals' 
WHEN 'Winter' THEN 'Boots' 
ELSE 'Sneakers' 
END

"Olhe para o campo Season. Se o valor for Summer, retorna Sandals. Se o valor for Winter, retorna Boots. Se nenhuma das opções do cálculo corresponder ao que está no campo Season, retorna um Sneakers."

Usado com CASE, WHEN, IF, ELSEIF, THEN, ELSE e END

CASE [Season] 
WHEN 'Summer' THEN 'Sandals' 
WHEN 'Winter' THEN 'Boots' 
ELSE 'Sneakers' 
END

"Olhe para o campo Season. Se o valor for Summer, retorna Sandals. Se o valor for Winter, retorna Boots. Se nenhuma das opções do cálculo corresponder ao que está no campo Season, retorna um Sneakers."

Usado com CASE, THEN, ELSE e END.

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

CASE <expression> 
WHEN IN <set1> THEN <then1> 
WHEN IN <combinedfield> THEN <then2> 
... 
ELSE <default> 
END

Os valores aos quais WHEN IN se compara precisam ser um conjunto, lista de valores literais ou campo combinado. Consulte também IN.

ZN([Test Grade])

"Se Test Grade não for nulo, retorne o valor. Se Test Grade for nulo, retorne 0."

ZN é um caso especializado de IFNULL onde a alternativa é se a expressão for nula é sempre 0, em vez de ser especificada no cálculo.

ZN é especialmente útil ao realizar cálculos adicionais, e um valor nulo tornaria todo o cálculo nulo. No entanto, tenha cuidado ao interpretar esses resultados, pois nulo nem sempre é sinônimo de 0 e pode representar dados ausentes.

Consulte também ISNULL.

example

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, 0 denota nenhuma relação linear entre a variância e −1 é uma relação negativa exata.

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(O link abre em nova janela).

Use com expressões LOD no escopo da tabela:

Você pode usar CORR para visualizar a correlação em uma dispersão desagregada usando uma Expressão de nível de detalhe com escopo de tabela(O link abre em nova janela). 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.

CORR está disponível com as seguintes fontes de dados: extrações de dados do Tableau, 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 da tabela(O link abre em nova janela).

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.

Se <expression1> e <expression2> forem as mesmas, por exemplo COVAR([profit], [profit]), COVAR retorna um valor que indica quão amplamente os valores são distribuídos.

O valor de COVAR(X, X) é equivalente ao valor de VAR(X) e também ao valor de STDEV(X)^2.

COVAR está disponível com as seguintes fontes de dados: extrações de dados do Tableau, 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 da tabela(O link abre em nova janela).

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.

Se <expression1> e <expression2> forem as mesmas, por exemplo COVARP([profit], [profit]), COVARP retorna um valor que indica quão amplamente os valores são distribuídos. Observação: O valor de COVARP(X, X) é equivalente ao valor de VARP(X) e também ao valor de STDEVP(X)^2.

COVARP está disponível com as seguintes fontes de dados: extrações de dados do Tableau, 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 da tabela(O link abre em nova janela).

Retorna o máximo de dois argumentos, que devem ser do mesmo tipo de dados.

MAX também pode ser aplicada a um único campo em uma agregação.

MAX(4,7) = 7
MAX(#3/25/1986#, #2/20/2021#) = #2/20/2021# 
MAX([Name]) = "Zander"

Para cadeia de caracteres

MAX geralmente é o valor que vem por último em ordem alfabética.

Para fontes de dados de bancos de dados, o valor de cadeia de caracteres MAX é o mais alto na sequência de classificação definida pelo banco de dados para essa coluna.

Para datas

Para datas, MAX é a data mais recente. Se MAX for uma agregação, o resultado não terá uma hierarquia de datas. Se MAX for uma comparação, o resultado manterá a hierarquia de datas.

Como uma agregação

MAX(expression) é uma função agregada e retorna um único resultado agregado. Isso é exibido como AGG(expression) na visualização.

Como comparação

MAX(expr1, expr2) compara os dois valores e retorna um valor em nível de linha.

Consulte também MIN.

MEDIAN não está disponível para as seguintes fontes de dados: 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(O link abre em nova janela).

Retorna, no mínimo, dois argumentos, que devem ser do mesmo tipo de dados.

MIN também pode ser aplicada a um único campo em uma agregação.

MIN(4,7) = 4
MIN(#3/25/1986#, #2/20/2021#) = #3/25/1986#
MIN([Name]) = "Abebi"

Para cadeia de caracteres

MIN geralmente é o valor que vem primeiro em ordem alfabética.

Para fontes de dados de bancos de dados, o valor de cadeia de caracteres MIN é o mais baixo na sequência de classificação definida pelo banco de dados para essa coluna.

Para datas

Para datas, o MIN é a data mais antiga. Se MIN for uma agregação, o resultado não terá uma hierarquia de datas. Se MIN for uma comparação, o resultado manterá a hierarquia de datas.

Como uma agregação

MIN(expression) é uma função agregada e retorna um único resultado agregado. Isso é exibido como AGG(expression) na visualização.

Como comparação

MIN(expr1, expr2) compara os dois valores e retorna um valor em nível de linha.

Consulte também MAX.

PERCENTILE([Score], 0.9)

Esta função está disponível para as seguintes fontes de dados: conexões não legadas do Microsoft Excel e de arquivo de texto, extrações e tipos de fontes de dados somente de extração (por exemplo, Google Analytics, OData ou Salesforce), fontes de dados Sybase IQ 15.1 e posteriores, fontes de dados Oracle 10 e posteriores, fontes de dados Cloudera Hive e Hortonworks Hadoop Hive, fontes de dados EXASolution 4.2 e 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(O link abre em nova janela).

Retorna o nome completo do usuário atual.

FULLNAME( )

Isso retorna o nome completo do usuário conectado, como "Hamlin Myrer".

[Manager] = FULLNAME( )

Se o gerente "Hamlin Myrer" estiver conectado, este exemplo retornará TRUE se o campo Gerente da exibição contiver "Hamlin Myrer".

Esta função verifica:

• Tableau Cloud e Tableau Server: o nome completo do usuário conectado
• Tableau Desktop: o nome completo local ou de rede do usuário

Filtros de usuário

Quando usado como um filtro, esse campo calculado, como [Username field] = FULLNAME( ), poderá ser usado para criar um filtro de usuário que mostra apenas dados relevantes para a pessoa conectada ao servidor.

Retorna TRUE se o nome completo do usuário atual coincide com o nome completo ou FALSE se não coincide.

ISFULLNAME("Hamlin Myrer")

O argumento <"User Full Name"> deve ser uma cadeia de caracteres constante, e não um de campo.

Esta função verifica:

• Tableau Cloud e Tableau Server: o nome completo do usuário conectado
• Tableau Desktop: o nome completo local ou de rede do usuário

Retorna TRUE se a pessoa que usa o Tableau atualmente for membro de um grupo que corresponda à cadeia de caracteres fornecida, FALSE se eles não forem membros, e NULL se eles não estiverem conectados.

ISMEMBEROF('Superstars')

ISMEMBEROF('domain.lan\Sales')

O argumento <"Group Full Name"> deve ser uma cadeia de caracteres constante, e não um de campo.

Se o usuário estiver conectado ao Tableau Cloud ou Tableau Server, a associação ao grupo é determinada pelos grupos do Tableau. A função retornará TRUE se a cadeia de caracteres fornecida for "Todos os usuários"

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.

Se for feita uma alteração na associação ao grupo de um usuário, a alteração nos dados baseados na associação ao grupo será refletida em uma pasta de trabalho ou exibição com uma nova sessão. A sessão existente refletirá dados obsoletos.

ISUSERNAME("hmyrer")

O argumento <"username"> deve ser uma cadeia de caracteres constante, e não um de campo.

Esta função verifica:

• Tableau Cloud e Tableau Server: o nome completo do usuário conectado
• Tableau Desktop: o nome de usuário local ou de rede do usuário

Esta função verifica:

• Tableau Cloud e Tableau Server: o domínio do usuário conectado
• Tableau Desktop: o domínio local se o usuário do estiver em um domínio

USERNAME( )

Isso retorna o nome do usuário do usuário conectado, como "hmyrer".

[Manager] = USERNAME( )

Se o gerente "hmyrer" estiver conectado, este exemplo retornará TRUE se o campo Gerente da exibição contiver "hmyrer".

Esta função verifica:

• Tableau Cloud e Tableau Server: o nome completo do usuário conectado
• Tableau Desktop: o nome de usuário local ou de rede do usuário

Filtros de usuário

Quando usado como um filtro, esse campo calculado, como [Username field] = USERNAME( ), poderá ser usado para criar um filtro de usuário que mostra apenas dados relevantes para a pessoa conectada ao servidor.

Se <'attribute_name'> fizer parte do da Web do JSON(JWT ) passado para o Tableau, o cálculo retorna o primeiro valor de <'attribute_name'>.

Retorna nulo se <'attribute_name'> não existe.

Suponha que "Region" seja o atributo de usuário incluído no JWT para o Tableau (usando o aplicativo conectado já configurado pelo administrador de 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 User2, da região oeste, exibe a visualização incorporada, o Tableau mostra os dados apropriados apenas para a região oeste.

Retorna TRUE se ambos os seguintes são verdadeiros:

• <'attribute_name'> faz parte do token Web JSON (JWT) passado ao Tableau
• um dos valores <'attribute_name'> são iguais a <'expected_value'>.

Caso contrário, retorna FALSE.

Suponha que "Region" seja o atributo de usuário incluído no JWT para o Tableau (usando o aplicativo conectado já configurado pelo administrador de 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.

USERATTRIBUTEINCLUDES('Region', [Region])

Se User2 da região Oeste acessar a visualização inserida, o Tableau verificará se o atributo de usuário Region corresponde a um dos valores do campo [Region]. Quando true, a visualização mostra os dados apropriados.

Quando User3 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].

AREA([Geometry], 'feet')

Nomes de unidades aceitas (devem estar entre aspas no cálculo, como 'miles'):

• metros: metros, m
• quilômetros: quilômetros, km
• milhas: milhas, mi
• pés: pés

BUFFER(Linestring, distance, 'units')

Para pontos espaciais, retorna uma forma poligonal centrada sobre um <spatial point>, com raio determinado pelos valores <distance> e <unit>.

Para cadeias de caracteres de linhas, calcula os polígonos formados incluindo todos os pontos dentro da distância do raio da cadeia de caracteres de linhas.

BUFFER([Spatial Point Geometry], 25, 'mi')

BUFFER(MAKEPOINT(47.59, -122.32), 3, 'km')

BUFFER(MAKELINE(MAKEPOINT(0, 20),MAKEPOINT (30, 30)),20,'km'))

Nomes de unidades aceitas (devem estar entre aspas no cálculo, como 'miles'):

• metros: metros, m
• quilômetros: quilômetros, km
• milhas: milhas, mi
• pés: pés

DISTANCE([Origin Point],[Destination Point], 'km')

Nomes de unidades aceitas (devem estar entre aspas no cálculo, como 'miles'):

• metros: metros, m
• quilômetros: quilômetros, km
• milhas: milhas, mi
• pés: pés

MAKELINE(MAKEPOINT(47.59, -122.32), MAKEPOINT(48.5, -123.1))

Converte dados das colunas <latitude> e <longitude> em objetos espaciais.

Se o argumento opcional <SRID> é adicionado, as entradas podem ser outras coordenadas geográficas projetadas.

MAKEPOINT(48.5, -123.1)

MAKEPOINT([AirportLatitude], [AirportLongitude])

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

MAKEPOINT não pode usar os campos de latitude e longitude gerados automaticamente. A fonte de dados deve conter as coordenadas nativamente.

SRID é um identificador de referência espacial que utiliza os códigos do sistema de referência ESPG(O link abre em nova janela) 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.

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.

LENGTH([Spatial], 'metres')

Útil para criar uma camada separada para um contorno que pode ter um estilo diferente do preenchimento.

Aceita polígonos dentro de multipolígonos.

SHAPETYPE(MAKEPOINT(48.5, -123.1)) = "Point"

UNION(VALIDATE([Geometry]))