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

ABS

SintaxeABS(number)
SaídaNúmero (positivo)
DefiniçãoRetorna o valor absoluto do <number> especificado.
Exemplo
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.

ObservaçõesConsulte também SIGN.

ACOS

SintaxeACOS(number)
SaídaNúmero (ângulo em radianos)
DefiniçãoRetorna o arco cosseno (ângulo) do <number> fornecido.
Exemplo
ACOS(-1) = 3.14159265358979
ObservaçõesA função inversa, COS, toma o ângulo em radianos como argumento e retorna o cosseno.

ASIN

SintaxeASIN(number)
SaídaNúmero (ângulo em radianos)
DefiniçãoRetorna o arco seno (ângulo) de um determinado <number>.
Exemplo
ASIN(1) = 1.5707963267949
ObservaçõesA função inversa, SIN, toma o ângulo em radianos como argumento e retorna o seno.

ATAN

SintaxeATAN(number)
SaídaNúmero (ângulo em radianos)
DefiniçãoRetorna o arco tangente (ângulo) de um determinado <number>.
Exemplo
ATAN(180) = 1.5652408283942
Observações

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

Consulte também ATAN2 e COT.

ATAN2

SintaxeATAN2(y number, x number)
SaídaNúmero (ângulo em radianos)
DefiniçãoRetorna o ângulo entre dois números especificados (x e y). O resultado é em radianos.
Exemplo
ATAN2(2, 1) = 1.10714871779409
ObservaçõesConsulte também ATAN, TAN e COT.

CEILING

SintaxeCEILING(number)
SaídaInteiro
DefiniçãoArredonda um para o <number> inteiro mais próximo de valor maior ou igual.
Exemplo
CEILING(2.1) = 3
ObservaçõesConsulte também FLOOR e ROUND.
Limitações do banco de dados

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.

COS

SintaxeCOS(number)

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

SaídaNúmero
DefiniçãoRetorna o cosseno de um ângulo.
Exemplo
COS(PI( ) /4) = 0.707106781186548
Observações

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.

COT

SintaxeCOT(number)

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

SaídaNúmero
DefiniçãoRetorna a cotangente de um ângulo.
Exemplo
COT(PI( ) /4) = 1
ObservaçõesConsulte também ATAN, TAN e PI. Para converter um ângulo de graus em radianos, use RADIANS.

DEGREES

SintaxeDEGREES(number)

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

SaídaNúmero (graus)
DefiniçãoConverte um ângulo em radianos em graus.
Exemplo
DEGREES(PI( )/4) = 45.0
Observações

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

Consulte também PI().

DIV

SintaxeDIV(integer1, integer2)
SaídaInteiro
DefiniçãoRetorna a parte inteira de uma operação de divisão, na qual o <integer1> é dividido pelo <integer2>.
Exemplo
DIV(11,2) = 5

EXP

SintaxeEXP(number)
SaídaNúmero
DefiniçãoRetorna e elevado à potência do especificado <number>.
Exemplo
EXP(2) = 7.389
EXP(-[Growth Rate]*[Time])
ObservaçõesConsulte também LN.

FLOOR

SintaxeFLOOR(number)
SaídaInteiro
DefiniçãoArredonda um número para o <number> mais próximo de valor menor ou igual.
Exemplo
FLOOR(7.9) = 7
ObservaçõesConsulte também CEILING e ROUND.
Limitações do banco de dados

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

SintaxeHEXBINX(number, number)
SaídaNúmero
DefiniçãoMapeia 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.
Exemplo
HEXBINX([Longitude]*2.5, [Latitude]*2.5)
ObservaçõesHEXBINX 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.

HEXBINY

SintaxeHEXBINY(number, number)
SaídaNúmero
DefiniçãoMapeia 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]*2.5, [Latitude]*2.5)
ObservaçõesConsulte também HEXBINX.

LN

SintaxeLN(number)
Saída

Número

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

DefiniçãoRetorna o algoritmo natural de um <number>.
Exemplo
LN(50) = 3.912023005
ObservaçõesConsulte também EXP e LOG.

LOG

SintaxeLOG(number, [base])

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

SaídaNúmero
DefiniçãoRetorna o algoritmo de um número para a base especificada.
Exemplo
LOG(16,4) = 2
ObservaçõesConsulte também POWER LN.

MAX

SintaxeMAX(expression) ou MAX(expr1, expr2)
SaídaMesmo tipo de dados do argumento ou NULL  se alguma parte do argumento for nula.
Definição

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.

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

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.

MIN

SintaxeMIN(expression) ou MIN(expr1, expr2)
SaídaMesmo tipo de dados do argumento ou NULL  se alguma parte do argumento for nula.
Definição

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.

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

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

SintaxePI()
SaídaNúmero
DefiniçãoRetorna o pi da constante numérica: 3,14159...
Exemplo
PI() = 3.14159
ObservaçõesÚtil para funções trigonométricas que recebem informações em radianos. Consulte também RADIANS.

POWER

SintaxePOWER(number, power)
SaídaNúmero
DefiniçãoEleva o <number> à <power> especificada.
Exemplo
POWER(5,3) = 125
POWER([Temperature], 2)
ObservaçõesVocê também pode usar o símbolo ^, como 5^3 = POWER(5,3) = 125

Consulte também EXP, LOG e SQUARE.

RADIANS

SintaxeRADIANS(number)
SaídaNúmero (ângulo em radianos)
DefiniçãoConverte o <number> determinado de graus para radianos.
Exemplo
RADIANS(180) = 3.14159
ObservaçõesA função inversa, DEGREES, obtém um ângulo em radianos e retorna o ângulo em graus.

ROUND

SintaxeROUND(number, [decimals])
SaídaNúmero
Definição

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.

Exemplo
ROUND(1/3, 2) = 0.33
Observações

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

SintaxeSIGN(number)
Saída-1, 0 ou 1
DefiniçãoRetorna o sinal de um <number>: 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
SIGN(AVG(Profit)) = -1
ObservaçõesConsulte também ABS.

SIN

SintaxeSIN(number)

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

SaídaNúmero
DefiniçãoRetorna o seno de um ângulo.
Exemplo
SIN(0) = 1.0
SIN(PI( )/4) = 0.707106781186548
Observações

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

SintaxeSQRT(number)
SaídaNúmero
DefiniçãoRetorna a raiz quadrada de um <number>.
Exemplo
SQRT(25) = 5
ObservaçõesConsulte também SQUARE.

SQUARE

SintaxeSQUARE(number)
SaídaNúmero
DefiniçãoRetorna o quadrado de um <number>.
Exemplo
SQUARE(5) = 25
ObservaçõesConsulte também SQRT e POWER.

TAN

SintaxeTAN(number)

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

SaídaNúmero
DefiniçãoRetorna a tangente de um ângulo.
Exemplo
TAN(PI ( )/4) = 1.0
ObservaçõesConsulte também ATAN, ATAN2,COT e PI. Para converter um ângulo de graus em radianos, use RADIANS.

ZN

SintaxeZN(expression)
SaídaQualquer, ou o
Definição

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

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

Exemplo
ZN(Grade) = 0
ObservaçõesEsta é uma função muito útil ao usar campos que podem conter valores nulos em um cálculo. Envolvendo o campo com ZN pode evitar erros causados pelo cálculo com nulos.
Funções de cadeia de caracteres

ASCII

SintaxeASCII(string)
SaídaNúmero
DefiniçãoRetorna o código ASCII do primeiro caractere de <string>.
Exemplo
ASCII('A') = 65
ObservaçõesEsse é o inverso da função CHAR.

CHAR

SintaxeCHAR(number)
SaídaCadeia de caracteres
DefiniçãoRetorna o caractere codificado pelo código ASCII <number>.
Exemplo
CHAR(65) = 'A'
ObservaçõesEsse é o inverso da função ASCII.

CONTAINS

SintaxeCONTAINS(string, substring)
SaídaBooleano
DefiniçãoRetornará true se a cadeia de caracteres determinada contiver a subcadeia de caracteres especificada.
Exemplo
CONTAINS("Calculation", "alcu") = true
ObservaçõesVeja também a função lógica(O link abre em nova janela) IN bem como RegEx aceito na documentação de funções adicionais(O link abre em nova janela).

ENDSWITH

SintaxeENDSWITH(string, substring)
SaídaBooleano
DefiniçãoRetornará 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
ObservaçõesVeja também o RegEx aceito na documentação de funções adicionais(O link abre em nova janela).

FIND

SintaxeFIND(string, substring, [start])
SaídaNúmero
Definição

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.

Exemplo
FIND("Calculation", "alcu") = 2
FIND("Calculation", "Computer") = 0
FIND("Calculation", "a", 3) = 7
FIND("Calculation", "a", 2) = 2
FIND("Calculation", "a", 8) = 0
ObservaçõesVeja também o RegEx aceito na documentação de funções adicionais(O link abre em nova janela).

FINDNTH

SintaxeFINDNTH(string, substring, occurrence)
SaídaNúmero
DefiniçãoRetorna a posição da nª ocorrência de substring dentro da string especificada, onde n é definido pelo argumento de ocorrência
Exemplo
FINDNTH("Calculation", "a", 2) = 7
Observações

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

Sintaxe LEFT(string, number)
SaídaCadeia de caracteres
DefiniçãoRetorna o <number> mais à esquerda de caracteres na cadeia de caracteres.
Exemplo
LEFT("Matador", 4) = "Mata"
ObservaçõesVeja também MID e RIGHT.

LEN

SintaxeLEN(string)
SaídaNúmero
DefiniçãoRetorna o comprimento da cadeia de caracteres.
Exemplo
LEN("Matador") = 7
ObservaçõesNão confundir com a função espacial(O link abre em nova janela) LENGTH.

LOWER

SintaxeLOWER(string)
SaídaCadeia de caracteres
DefiniçãoRetorna a <string> fornecida em todos os caracteres minúsculos.
Exemplo
LOWER("ProductVersion") = "productversion"
ObservaçõesVeja também UPPER e PROPER.

LTRIM

Sintaxe LTRIM(string)
SaídaCadeia de caracteres
DefiniçãoRetorna a <string> fornecida com os espaços à esquerda removidos.
Exemplo
LTRIM(" Matador ") = "Matador "
ObservaçõesConsulte também RTRIM.

MAX

SintaxeMAX(expression) ou MAX(expr1, expr2)
SaídaMesmo tipo de dados do argumento ou NULL  se alguma parte do argumento for nula.
Definição

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.

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

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.

MID

Sintaxe(MID(string, start, [length])
SaídaCadeia de caracteres
Definição

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.

Exemplo
MID("Calculation", 2) = "alculation"
MID("Calculation", 2, 5) ="alcul"
ObservaçõesVeja também o RegEx aceito na documentação de funções adicionais(O link abre em nova janela).

MIN

SintaxeMIN(expression) ou MIN(expr1, expr2)
SaídaMesmo tipo de dados do argumento ou NULL  se alguma parte do argumento for nula.
Definição

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.

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

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.

PROPER

SintaxePROPER(string)
SaídaCadeia de caracteres
Definição

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

Exemplo
PROPER("PRODUCT name") = "Product Name"
PROPER("darcy-mae") = "Darcy-Mae"
Observações

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

Veja também LOWER e UPPER.

Limitações do banco de dadosPROPER está disponível apenas para alguns arquivos simples e em extrações. Se você precisar usar PROPER em uma fonte de dados que de outra forma não oferece suporte, considere usar uma extração.

REPLACE

SintaxeREPLACE(string, substring, replacement
SaídaCadeia de caracteres
DefiniçãoProcura em <string> por <substring> e substitui por <replacement>. Se a <substring> não for encontrada, a string não será alterada.
Exemplo
REPLACE("Version 3.8", "3.8", "4x") = "Version 4x"
ObservaçõesVeja também REGEXP_REPLACE no documentação de funções adicionais(O link abre em nova janela).

RIGHT

SintaxeRIGHT(string, number)
SaídaCadeia de caracteres
DefiniçãoRetorna o <number> mais à direita dos caracteres na cadeia de caracteres.
Exemplo
RIGHT("Calculation", 4) = "tion"
ObservaçõesVeja também LEFT e MID.

RTRIM

SintaxeRTRIM(string)
SaídaCadeia de caracteres
DefiniçãoRetorna a <string> fornecida com os espaços à direita removidos.
Exemplo
RTRIM(" Calculation ") = " Calculation"
ObservaçõesVeja também LTRIM e TRIM.

SPACE

SintaxeSPACE(number)
SaídaCadeia de caracteres (especificamente, apenas espaços)
DefiniçãoRetorna uma cadeia de caracteres composta por um número especificado de espaços repetidos.
Exemplo
SPACE(2) = "  "

SPLIT

SintaxeSPLIT(string, delimiter, token number)
SaídaCadeia de caracteres
DefiniçãoRetorna uma subcadeia de uma cadeia de caracteres, usando um caractere delimitador para dividir a cadeia de caracteres em uma sequência de tokens.
Exemplo
SPLIT ("a-b-c-d", "-", 2) = "b"
SPLIT ("a|b|c|d", "|", -2) = "c"
Observações

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

Limitações do banco de dados

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

SintaxeSTARTSWITH(string, substring)
SaídaBooleano
DefiniçãoRetornará true se string começar com substring. Espaços em branco à esquerda são ignorados.
Exemplo
STARTSWITH("Matador, "Ma") = TRUE
ObservaçõesConsulte também CONTAINS, bem como REGEX compatível na documentação de funções adicionais(O link abre em nova janela).

TRIM

SintaxeTRIM(string)
SaídaCadeia de caracteres
DefiniçãoRetorna a <string> com os espaços à esquerda e à direita removidos.
Exemplo
TRIM(" Calculation ") = "Calculation"
ObservaçõesVeja também LTRIM e RTRIM.

UPPER

SintaxeUPPER(string)
SaídaCadeia de caracteres
DefiniçãoRetorna a <string> fornecida com todos os caracteres maiúsculos.
Exemplo
UPPER("Calculation") = "CALCULATION"
ObservaçõesVeja também PROPER e LOWER.
Funções de data

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

DATE

Função de conversão de tipo que altera as expressões de cadia de caracteres e número em datas, desde que estejam em um formato reconhecível.

SintaxeDATE(expression)
SaídaData
DefiniçãoRetorna uma data de acordo com um número, cadeia de caracteres ou de data <expression>.
Exemplo
DATE([Employee Start Date])
DATE("September 22, 2018") 
DATE("9/22/2018")
DATE(#2018-09-22 14:52#)
Observações

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.

DATEADD

Adiciona um número especificado de partes de data (meses, dias etc) à data de início.

SintaxeDATEADD(date_part, interval, date)
SaídaData
DefiniçãoRetorna a <date> com o <interval> do número especificado, adicionado a <date_part> especificada dessa data. Por exemplo, adicionar três meses ou 12 dias a uma data de início.
Exemplo

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#
ObservaçõesOferece suporte às datas de ISO 8601.

DATEDIFF

Retorna o número de partes da data (semanas, anos etc.) entre duas datas.

SintaxeDATEDIFF(date_part, date1, date2, [start_of_week])
SaídaInteiro
DefiniçãoRetorna a diferença entre <date1> e <date2> expressa em unidades de <date_part>. Por exemplo, subtraindo as datas que alguém entrou e saiu de uma banda para ver quanto tempo eles estavam na banda.
Exemplo

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])
ObservaçõesOferece suporte às datas de ISO 8601.

DATENAME

Retorna o nome da parte de data especificada como uma cadeia de caracteres discreta.

SintaxeDATENAME(date_part, date, [start_of_week])
SaídaCadeia de caracteres
DefiniçãoRetorna <date_part> de <date> como uma cadeia de caracteres.
Exemplo
DATENAME('year', #3/25/1986#) = "1986"
DATENAME('month', #1986-03-25#) = "March"
Observações

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

Retorna cadeias de caracteres especificamente formatadas como datas.

SintaxeDATEPARSE(date_format, date_string)
SaídaData
DefiniçãoO argumento <date_format> como o campo <date_string> é organizado. Devido à variedade de maneiras que o campo de cadeia de caracteres pode ser ordenado, o <date_format> precisa ter correspondência exata. Para obter uma explicação completa e os detalhes de formatação, consulte Converter um campo em um campo de data(O link abre em nova janela).
Exemplo
DATEPARSE('yyyy-MM-dd', "1986-03-25") = #March 25, 1986#
Observações

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

Limitações do banco de dados

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

Retorna o nome da parte de data especificada como um inteiro.

SintaxeDATEPART(date_part, date, [start_of_week])
SaídaInteiro
DefiniçãoRetorna <date_part> de <date> como um inteiro.
Exemplo
DATEPART('year', #1986-03-25#) = 1986
DATEPART('month', #1986-03-25#) = 3
Observações

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

Esta função pode ser considerada como arredondamento de data. Leva uma data específica e retorna uma versão dessa data na especificidade desejada. Como cada data deve ter um valor para dia, mês, trimestre e ano, DATETRUNC define os valores como o valor mais baixo para cada parte da data até a parte da data especificada. Consulte o exemplo para obter mais informações.

SintaxeDATETRUNC(date_part, date, [start_of_week])
SaídaData
DefiniçãoTrunca a <date> 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.
Exemplo
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.

Observações

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 as exibições 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. O valor é truncado para o dia, mas a exibição vai para os segundos.

DAY

Retorna o dia do mês (1 a 31) especificada como um inteiro.

SintaxeDAY(date)
SaídaInteiro
DefiniçãoRetorna o dia da <date> especificada como um inteiro.
Exemplo
Day(#September 22, 2018#) = 22
ObservaçõesConsulte também WEEK, MONTH, TRIMESTRE, YEAR e os equivalentes ISO.

ISDATE

Verifica se a cadeia de caracteres é um formato de data válido.

SintaxeISDATE(string)
SaídaBooliano
DefiniçãoRetornará true se uma determinada <string> for uma data válida.
Exemplo
ISDATE(09/22/2018) = true
ISDATE(22SEP18) = false
ObservaçõesO argumento necessário deve ser uma cadeia de caracteres. ISDATE não pode ser usado para um campo com um tipo de dados de data – o cálculo retornará um erro.

ISOQUARTER

SintaxeISOQUARTER(date)
SaídaInteiro
DefiniçãoRetorna o trimestre baseado em semana ISO8601 de uma <date> especificada como um inteiro.
Exemplo
ISOQUARTER(#1986-03-25#) = 1
ObservaçõesConsulte também ISOWEEK, ISOWEEKDAY, ISOYEAR, e não equivalentes ao ISO.

ISOWEEK

SintaxeISOWEEK(date)
SaídaInteiro
DefiniçãoRetorna a semana baseada em semana ISO8601 especificada de <date> como um inteiro.
Exemplo
ISOWEEK(#1986-03-25#) = 13
ObservaçõesConsulte também ISOWEEKDAY, ISOQUARTER, ISOYEAR, e não equivalentes ao ISO.

ISOWEEKDAY

SintaxeISOWEEKDAY(date)
SaídaInteiro
DefiniçãoRetorna dia da semana baseado em semana ISO8601 de uma <date> especificada como um inteiro.
Exemplo
ISOWEEKDAY(#1986-03-25#) = 2
ObservaçõesConsulte também ISOWEEK, ISOQUARTER, ISOYEAR, e não equivalentes ao ISO.

ISOYEAR

SintaxeISOYEAR(date)
SaídaInteiro
DefiniçãoRetorna ano baseado em semana ISO8601 de uma <date> especificada como um inteiro.
Exemplo
ISOYEAR(#1986-03-25#) = 1,986
ObservaçõesConsulte também ISOWEEK, ISOWEEKDAY, ISOQUARTER, e não equivalentes ao ISO.

MAKEDATE

SintaxeMAKEDATE(year, month, day)
SaídaData
DefiniçãoRetorna um valor de data composto por <year>, <month> e <day> especificados.
Exemplo
MAKEDATE(1986,3,25) = #1986-03-25#
Observações

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

SintaxeMAKEDATETIME(date, time)
SaídaDatetime
DefiniçãoRetorna um datetime que combina <date> e <time>. A data pode ser um tipo date, datetime ou string. A hora deve ser um datetime.
Exemplo
MAKEDATETIME("1899-12-30", #07:59:00#) = #12/30/1899 7:59:00 AM#
MAKEDATETIME([Date], [Time]) = #1/1/2001 6:00:00 AM#
Observações

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

SintaxeMAKETIME(hour, minute, second)
SaídaDatetime
DefiniçãoRetorna um valor de data composto por <hour>, <minute> e <second> especificados.
Exemplo
MAKETIME(14, 52, 40) = #1/1/1899 14:52:40#
Observações

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.

MAX

SintaxeMAX(expression) ou MAX(expr1, expr2)
SaídaMesmo tipo de dados do argumento ou NULL se alguma parte do argumento for nula.
Definição

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.

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

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.

MIN

SintaxeMIN(expression) ou MIN(expr1, expr2)
SaídaMesmo tipo de dados do argumento ou NULL  se alguma parte do argumento for nula.
Definição

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.

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

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

SintaxeMONTH(date)
SaídaInteiro
DefiniçãoRetorna o mês da <date> especificada como um inteiro.
Exemplo
MONTH(#1986-03-25#) = 3
ObservaçõesConsulte também DAY, WEEK, TRIMESTRE, YEAR e os equivalentes ISO

NOW

SintaxeNOW()
SaídaDatetime
DefiniçãoRetorna a data e a hora atuais do sistema local.
Exemplo
NOW() = 1986-03-25 1:08:21 PM
Observações

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.

TRIMESTRE

SintaxeQUARTER(date)
SaídaInteiro
DefiniçãoRetorna o trimestre da <date> especificada como um inteiro.
Exemplo
QUARTER(#1986-03-25#) = 1
ObservaçõesConsulte também DAY, WEEK, MONTH, YEAR e os equivalentes ISO

TODAY

SintaxeTODAY()
SaídaData
DefiniçãoRetorna a data atual do sistema local.
Exemplo
TODAY() = 1986-03-25
Observações

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

SintaxeWEEK(date)
SaídaInteiro
DefiniçãoRetorna a semana da <date> especificada como um inteiro.
Exemplo
WEEK(#1986-03-25#) = 13
ObservaçõesConsulte também DAY, MONTH, TRIMESTRE, YEAR e os equivalentes ISO

YEAR

SintaxeYEAR(date)
SaídaInteiro
DefiniçãoRetorna o ano da <date> especificada como um inteiro.
Exemplo
YEAR(#1986-03-25#) = 1,986
ObservaçõesConsulte também DAY, WEEK, MONTH, TRIMESTRE e os equivalentes ISO

date_part

Muitas funções de data no Tableau aceitam o argumento date_part, que é uma constante de cadeia de caracteres que informa à função qual parte de uma data deve ser considerada, como dia, semana, trimestre, etc. O valores válidos de date_part 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
'iso-year'Ano de ISO 8601 com quatro dígitos
'iso-quarter'1-4
'iso-week'1-52, o início da semana é sempre segunda-feira
'iso-weekday'1-7, o início da semana é sempre segunda-feira

Funções lógicas

AND

Sintaxe<expr1> AND <expr2>
DefiniçãoRealiza uma conjunção lógica em duas expressões. (Se ambos os lados forem true, o teste lógico retornará true.)
SaídaBooleano (true ou false)
Exemplo
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."

Observações

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.

CASE

SintaxeCASE <expression>
WHEN <value1> THEN <then1>
WHEN <value2> THEN <then2>
...
[ELSE <default>]
END
SaídaDepende do tipo de dados dos valores <then>.
Definição

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.

Exemplo
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."

Observações

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.

ELSE

SintaxeCASE <expression>
WHEN <value1> THEN <then1>
WHEN <value2> THEN <then2>
...
[ELSE <default>]
END
DefiniçãoUma parte opcional da expressão IF ou CASE usada para especificar um valor padrão a ser retornado se nenhuma das expressões testadas for true.
Exemplo
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
Observações

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.

ELSEIF

Sintaxe[ELSEIF <test2> THEN <then2>]
DefiniçãoUma parte opcional de uma expressão IF usada para especificar condições adicionais além do IF inicial.
Exemplo
IF [Season] = "Summer" THEN 'Sandals' 
ELSEIF [Season] = "Winter" THEN 'Boots'
ELSEIF [Season] = "Spring" THEN 'Sneakers'
ELSEIF [Season] = "Autumn" THEN 'Sneakers'
ELSE 'Bare feet'
END
Observações

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

END

DefiniçãoUsado para fechar uma expressão IF ou CASE.
Exemplo
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."

Observações

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

IF

SintaxeIF <test1> THEN <then1>
[ELSEIF <test2> THEN <then2>...]
[ELSE <default>]
END
SaídaDepende do tipo de dados dos valores <then>.
Definição

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

Exemplo
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."

Observações

Veja também IF e IIF.

Usado com ELSEIF, THEN, ELSE e END

IFNULL

SintaxeIFNULL(expr1, expr2)
SaídaDepende do tipo de dados dos valores <expr>.
Definição

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

Exemplo
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."

Observações

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

Consulte também ZN.

IIF

SintaxeIIF(<test>, <then>, <else>, [<unknown>])
SaídaDepende do tipo de dados dos valores na expressão.
DefiniçãoVerifica se uma condição foi atendida (<test>) e retorna <then> se o teste for true, <else> se o teste for false e um valor opcional para <unknown>, se o teste for nulo. Se o desconhecido opcional não for especificado, IIF retorna nulo.
Exemplo
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.”

Observações

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

IN

Sintaxe<expr1> IN <expr2>
SaídaBooleano (true ou false)
DefiniçãoRetorna TRUE se qualquer valor em <expr1> corresponde a qualquer valor em <expr2>.
Exemplo
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?"

Observações

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

Consulte também WHEN.

ISDATE

SintaxeISDATE(string)
SaídaBooleano (true ou false)
DefiniçãoRetornará true se uma <string> for uma data válida. A expressão de entrada precisa ser um campo de cadeia de caracteres (texto).
Exemplo
ISDATE("2018-09-22")

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

Observações

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

ISNULL

SintaxeISNULL(expression)
SaídaBooleano (true ou false)
Definição

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

Exemplo
ISNULL([Assigned Room])

"O campo Sala Atribuída é nulo?"

Observações

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

Consulte também ZN.

MAX

SintaxeMAX(expression) ou MAX(expr1, expr2)
SaídaMesmo tipo de dados do argumento ou NULL  se alguma parte do argumento for nula.
Definição

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.

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

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.

MIN

SintaxeMIN(expression) ou MIN(expr1, expr2)
SaídaMesmo tipo de dados do argumento ou NULL  se alguma parte do argumento for nula.
Definição

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.

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

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.

NOT

SintaxeNOT <expression>
SaídaBooleano (true ou false)
DefiniçãoRealiza uma negação lógica em uma expressão.
Exemplo
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"

Observações

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

OU

Sintaxe<expr1> OR <expr2>
SaídaBooleano (true ou false)
DefiniçãoRealiza uma disjunção lógica em duas expressões.
Exemplo
IF [Season] = "Spring" OR [Season] = "Fall" 
THEN "Sneakers"
END

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

Observações

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.

THEN

SintaxeIF <test1> THEN <then1>
[ELSEIF <test2> THEN <then2>...]
[ELSE <default>]
END
DefiniçãoUma parte obrigatória de uma expressaõ IF, ELSEIF ou CASE, usada para definir qual resultado retornar se um valor ou teste específico for true.
Exemplo
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."

Observações

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

WHEN

SintaxeCASE <expression>
WHEN <value1> THEN <then1>
WHEN <value2> THEN <then2>
...
[ELSE <default>]
END
DefiniçãoUma parte obrigatória de uma expressão CASE. Encontra o primeiro <<value>> que corresponde <expression>> e retorna ao <then> correspondente.
Exemplo
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."

Observações

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

SintaxeZN(expression)
SaídaDepende do tipo de dados de <expression>ou 0.
DefiniçãoRetorna <expression> se não for nulo, caso contrário, retorna zero.
Exemplo
ZN([Test Grade])

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

Observações

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.

Funções de agregação

ATTR

SintaxeATTR(expression)
DefiniçãoRetorna 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

SintaxeAVG(expression)
DefiniçãoRetorna a média de todos os valores na expressão. Os valores nulos são ignorados.
ObservaçõesAVG pode ser usado apenas com campos numéricos.

COLLECT

SintaxeCOLLECT(spatial)
DefiniçãoUm cálculo agregado que combina os valores no campo do argumento. Os valores nulos são ignorados.
ObservaçõesCOLLECT pode ser usado apenas com campos espaciais.

CORR

SintaxeCORR(expression1, expression2)
SaídaNúmero de -1 a 1
DefiniçãoRetorna o coeficiente de correlação Pearson de duas expressões.
Exemplo
example
Observaçõ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, 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.

Limitações do banco de dados

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

COUNT

SintaxeCOUNT(expression)
DefiniçãoRetorna o número de itens. Os valores Null não são contados.

COUNTD

SintaxeCOUNTD(expression)
DefiniçãoRetorna o número de itens distintos em um grupo. Os valores Null não são contados.

COVAR

SintaxeCOVAR(expression1, expression2)
DefiniçãoRetorna a covariância de amostra de duas expressões
Observaçõ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.

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.

Limitações do banco de dados

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

COVARP

SintaxeCOVARP(expression 1, expression2)
DefiniçãoRetorna a covariância populacional de duas expressões.
Observaçõ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.

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.

Limitações do banco de dados

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

MAX

SintaxeMAX(expression) ou MAX(expr1, expr2)
SaídaMesmo tipo de dados do argumento ou NULL  se alguma parte do argumento for nula.
Definição

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.

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

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

SintaxeMEDIAN(expression)
DefiniçãoRetorna o mediano de uma expressão em todos os registros. Os valores nulos são ignorados.
ObservaçõesMEDIAN pode ser usado apenas com campos numéricos.
Limitações do banco de dados

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

MIN

SintaxeMIN(expression) ou MIN(expr1, expr2)
SaídaMesmo tipo de dados do argumento ou NULL  se alguma parte do argumento for nula.
Definição

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.

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

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

SintaxePERCENTILE(expression, number)
DefiniçãoRetorna o valor percentil da expressão indicada correspondente ao <number> especificado. O <number> deve estar entre 0 e 1 (inclusive) e deve ser uma constante numérica.
Exemplo
PERCENTILE([Score], 0.9)
Limitações do banco de dados

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

STDEV

SintaxeSTDEV(expression)
DefiniçãoRetorna o desvio padrão estatístico de todos os valores na expressão atribuída com base em uma amostra da população.

STDEVP

SintaxeSTDEVP(expression)
DefiniçãoRetorna 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

SintaxeSUM(expression)
DefiniçãoRetorna a soma de todos os valores na expressão. Os valores nulos são ignorados.
ObservaçõesSUM pode ser usado apenas com campos numéricos.

VAR

SintaxeVAR(expression)
DefiniçãoRetorna a variação estatística de todos os valores na expressão atribuída com base em uma amostra da população.

VARP

SintaxeVARP(expression)
DefiniçãoRetorna 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

FULLNAME( )

SintaxeFULLNAME( )
SaídaCadeia de caracteres
Definição

Retorna o nome completo do usuário atual.

Exemplo
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".

Observações

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.

ISFULLNAME

SintaxeISFULLNAME("User Full Name")
SaídaBooleano
Definição

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

Exemplo
ISFULLNAME("Hamlin Myrer")
Observações

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

ISMEMBEROF

SintaxeISMEMBEROF("Group Name")
SaídaBooleano ou nulo
Definição

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.

Exemplo
ISMEMBEROF('Superstars')
ISMEMBEROF('domain.lan\Sales')
Observações

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

SintaxeISUSERNAME("username")
SaídaBooleano
DefiniçãoRetorna 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.
Exemplo
ISUSERNAME("hmyrer")
Observações

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

USERDOMAIN( )

SintaxeUSERDOMAIN( )
SaídaCadeia de caracteres
DefiniçãoRetorna o domínio de usuário do usuário atual.
Observações

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

SintaxeUSERNAME( )
SaídaCadeia de caracteres
DefiniçãoRetorna o nome de usuário do usuário atual.
Exemplo
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".

Observações

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.

USERATRIBUTE

Observação: para inserir fluxos de trabalho apenas no Tableau Cloud Para obter mais informações, consulte Autenticação e exibições inseridas(O link abre em nova janela).

SintaxeUSERATTRIBUTE('attribute_name')
SaídaCadeia de caracteres ou nulo
Definição

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.

Exemplo

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.

ObservaçõesVocê pode usar a função USERATTRIBUTEINCLUDES se espera que <'attribute_name'> retorne vários valores.

USERATTRIBUTEINCLUDES

Observação: para inserir fluxos de trabalho apenas no Tableau Cloud Para obter mais informações, consulte Autenticação e exibições inseridas(O link abre em nova janela).

SintaxeUSERATTRIBUTEINCLUDES('attribute_name', 'expected_value')
SaídaBooleano
Definição

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.

Exemplo

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

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.

Funções MODEL_EXTENSION

As funções de extensão do modelo:

  • MODEL_EXTENSION_BOOL

  • MODEL_EXTENSION_INT

  • MODEL_EXTENSION_REAL

  • MODEL_EXTENSION_STRING

são usadas para passar dados para um modelo implantado em um serviço externo, como R, TabPy ou Matlab. Consulte Extensões do Analytics(O link abre em nova janela).

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 Aluno A até Aluno N); a coluna Idade mostra a idade atual de cada aluno (todos os alunos são 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.

Funções SCRIPT_

As funções script:

  • SCRIPT_BOOL

  • SCRIPT_INT

  • SCRIPT_REAL

  • SCRIPT_STRING

são usadas para passar dados para um serviço externo, como R, TabPy ou Matlab. Consulte Extensões do Analytics(O link abre em nova janela).

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:

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

ÁREA

SintaxeAREA(Spatial Polygon, 'units')
SaídaNúmero
DefiniçãoRetorna a área total da superfície de um <spatial polygon>.
Exemplo
AREA([Geometry], 'feet')
Observações

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

SintaxeBUFFER(Spatial Point, distance, 'units')

BUFFER(Linestring, distance, 'units')

  • metros: metros, m
  • quilômetros: quilômetros, km
  • milhas: milhas, mi
  • pés: pés
SaídaGeometria
Definição

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.

Exemplo
BUFFER([Spatial Point Geometry], 25, 'mi')
BUFFER(MAKEPOINT(47.59, -122.32), 3, 'km')
BUFFER(MAKELINE(MAKEPOINT(0, 20),MAKEPOINT (30, 30)),20,'km'))
Observações

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

DISTÂNCIA

SintaxeDISTANCE(SpatialPoint1, SpatialPoint2, 'units')
SaídaNúmero
DefiniçãoRetorna a medida da distância entre dois pontos na <unit> especificada.
Exemplo
DISTANCE([Origin Point],[Destination Point], 'km')
Observações

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
Limitações do banco de dadosEssa função só pode ser criada com uma conexão em tempo real, mas continuará a funcionar se uma fonte de dados for convertida em uma extração.

INTERSECTS

SintaxeINTERSECTS (geometry1, geometry2)
SaídaBooliano
DefiniçãoRetorna true ou false indicando se duas geometrias se sobrepõem no espaço.
ObservaçõesCombinações suportadas: ponto/polígono, linha/polígono e polígono/polígono.

MAKELINE

SintaxeMAKELINE(SpatialPoint1, SpatialPoint2)
SaídaGeometria (linha)
DefiniçãoGera uma marca de linha entre dois pontos
Exemplo
MAKELINE(MAKEPOINT(47.59, -122.32), MAKEPOINT(48.5, -123.1))
ObservaçõesÚtil para construir mapas de origem-destino.

MAKEPOINT

SintaxeMAKEPOINT(latitude, longitude, [SRID])
SaídaGeometria (ponto)
Definição

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.

Exemplo
MAKEPOINT(48.5, -123.1)
MAKEPOINT([AirportLatitude], [AirportLongitude])
MAKEPOINT([Xcoord],[Ycoord], 3493)
Observações

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

SintaxeLENGTH(geometry, 'units')
SaídaNúmero
DefiniçãoRetorna o comprimento do caminho geodésico da sequência de linhas ou sequências no <geometry> usando <units> fornecido.
Exemplo
LENGTH([Spatial], 'metres')
ObservaçõesO resultado será <NaN> se o argumento de geometria não tiver cadeias de linha, embora outros elementos sejam permitidos.

OUTLINE

SintaxeOUTLINE(spatial polygon)
SaídaGeometria
DefiniçãoConverte uma geometria poligonal em cadeias de linhas.
Observações

Ú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

SintaxeSHAPETYPE(geometry)
SaídaCadeia de caracteres
DefiniçãoRetorna uma cadeia de caracteres descrevendo a estrutura do espaço <geometry>, como Empty, Point, MultiPoint, LineString, MultiLinestring, Polygon, MultiPolygon, Mixed e unsupported (Vazio, Ponto, Multiponto, Cadeia de caracteres de linha, Cadeia de caracteres de várias linhas, Polígono, VáriosPolígonos, Combinado e sem suporte).
Exemplo
SHAPETYPE(MAKEPOINT(48.5, -123.1)) = "Point"

VALIDATE

SintaxeVALIDATE(spatial geometry)
SaídaGeometria
DefiniçãoConfirma a correção topológica da geometria no seu valor espacial. Se o valor não puder ser usado para análise devido a problemas como o perímetro de um polígono se cruzando, o resultado será nulo. Se a geometria estiver correta, o resultado será a geometria original.
Exemplo

UNION(VALIDATE([Geometry]))

Funções adicionais
Para obter mais informações, consulte Funções de passagem (RAWSQL)(O link abre em nova janela).

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!Seu feedback foi enviado. Obrigado!