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ção | Sintaxe | Descrição | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ABS |
| Retorna o valor absoluto do número especificado. Exemplos:
O segundo exemplo retorna o valor absoluto para todos os números contidos no campo | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ACOS |
| Retorna o arco cosseno do número especificado. O resultado é em radianos. Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ASIN |
| Retorna o arco seno de um número especificado. O resultado é em radianos. Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ATAN | ATAN(number) | Retorna o arco tangente de um número especificado. O resultado é em radianos. Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ATAN2 |
| Retorna o arco tangente de dois números especificados (x e y). O resultado é em radianos. Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
CEILING |
|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
COS |
| Retorna o cosseno de um ângulo. Especifica o ângulo em radianos. Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
COT |
| Retorna a cotangente de um ângulo. Especifica o ângulo em radianos. Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DEGREES |
| Converte um determinado número em radianos em graus. Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DIV | DIV(integer1, integer2) | Retorna a parte inteira de uma operação de divisão, na qual o inteiro1 é dividido pelo inteiro2. Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
EXP |
| Retorna e elevado à potência do número especificado. Exemplos:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
FLOOR |
|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
HEXBINX |
| Mapeia as coordenadas x, y com a coordenada x do compartimento hexagonal mais próximo. Os compartimentos têm extensão 1, então as entradas podem precisar ser escalonadas corretamente. HEXBINX e HEXBINY são funções de armazenamento e plotagem dos compartimentos hexagonais. Compartimentos hexagonais são uma opção eficiente e elegante para a visualização de dados em um plano x/y como um mapa. Como os compartimentos são hexagonais, cada um se aproxima de um círculo e minimiza a variação da distância entre o ponto de dados e o centro do compartimento. Isso torna o agrupamento mais preciso e informativo. Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
HEXBINY |
| Mapeia as coordenadas x, y com a coordenada y do compartimento hexagonal mais próximo. Os compartimentos têm extensão 1, então as entradas podem precisar ser escalonadas corretamente. Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
LN |
| Retorna o algoritmo natural de um número. Retorna | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
LOG |
| Retorna o algoritmo de um número para a base especificada. Se o valor de base for omitido, a base 10 será usada. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
MAX |
| Retorna o máximo de dois argumentos, que devem ser do mesmo tipo. Retorna Exemplos:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
MIN |
| Retorna o mínimo de dois argumentos, que devem ser do mesmo tipo. Retorna Exemplos:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
PI |
| Retorna o pi da constante numérica: 3.14159. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
POWER |
| Eleva o número à potência especificada. Exemplos:
Também é possível usar o símbolo ^:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
RADIANS |
| Converte o número especificado de graus em radianos. Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ROUND |
| Arredonda os números para um número de dígitos especificado. O argumento Exemplo: Este exemplo arredonda todos os valores de
Alguns bancos de dados, como o SQL Server, permitem a especificação de um Observação: como ROUND pode ter problemas devido à representação de ponto flutuante subjacente de números - como 9,405 arredondado para 9,40 - pode ser preferível formatar o número para o número desejado de pontos decimais em vez de arredondar. Formatar 9,405 com duas casas decimais produzirá o 9,41 esperado. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
SIGN |
| Retorna o sinal de um número: os valores de retorno possíveis são: -1 se o número for negativo, 0 se o número for zero ou 1 se o número for positivo. Exemplo: Se a média do campo de lucro for negativa,
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
SIN |
| Retorna o seno de um ângulo. Especifica o ângulo em radianos. Exemplos:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
SQRT |
| Retorna a raiz quadrada de um número. Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
SQUARE |
| Retorna o quadrado de um número. Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TAN |
| Retorna a tangente de um ângulo. Especifique o ângulo em radianos. Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ZN |
| Retorna a expressão se não for nulo, caso contrário, retorna zero. Use essa função para utilizar valores de zero, em vez de valores nulos. Exemplo:
|
Função | Sintaxe | Definição | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ASCII | ASCII(string) | Retorna o código ASCII do primeiro caractere de Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
CHAR | CHAR(number) | Retorna o caractere codificado pelo código ASCII Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
CONTAINS | CONTAINS(string, substring) | Retornará true se a cadeia de caracteres determinada contiver a subcadeia de caracteres especificada. Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ENDSWITH | ENDSWITH(string, substring) | Retornará true se a cadeia de caracteres determinada terminar com a subcadeia de caracteres especificada. Espaços em branco à direita são ignorados. Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
FIND | FIND(string, substring, [start]) | Retorna a posição de índice de Exemplos:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
FINDNTH | FINDNTH(string, substring, occurrence) | Retorna a posição da nª ocorrência de substring dentro da string especificada, onde n é definido pelo argumento de ocorrência Observação: FINDNTH não está disponível em todas as fontes de dados. Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
LEFT | LEFT(string, number) | Retorna o número de caracteres na extremidade esquerda na cadeia de caracteres. Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
LEN | LEN(string) | Retorna o comprimento da cadeia de caracteres. Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
LOWER | LOWER(string) | Retorna Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
LTRIM | LTRIM(string) | Retorna a cadeia de caracteres com os espaços à esquerda removidos. Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
MAX |
| Retorna o máximo de Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
MID | (MID(string, start, [length]) | Retorna a cadeia de caracteres que começa na posição de índice Exemplos:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
MIN | MIN(a, b) | Retorna o mínimo de Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
PROPER | PROPER(string) | Converte uma cadeia de caracteres de texto para que a primeira letra de cada palavra seja maiúscula e as letras restantes fiquem em minúsculas. Espaços e caracteres não alfanuméricos, como pontuação, também atuam como separadores. Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
REPLACE | REPLACE(string, substring, replacement) | Procura em Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
RIGHT | RIGHT(string, number) | Retorna o número de caracteres na extremidade direita em Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
RTRIM | RTRIM(string) | Retorna Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
SPACE | SPACE(number) | Retorna uma cadeia de caracteres composta por Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
SPLIT(string, delimiter, token number) |
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
STARTSWITH | STARTSWITH(string, substring) | Retornará true se Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TRIM | TRIM(string) | Retorna a cadeia de caracteres com os espaços à esquerda e à direita removidos. Exemplo:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
UPPER | UPPER(string) | Retorna string, com todos os caracteres maiúsculos. Exemplo:
|
O Tableau fornece uma variedade de funções de data. Muitos dos exemplos usam o símbolo #
com expressões de data. Consulte Sintaxe de expressão literal para obter uma explicação desse símbolo. Além disso, muitas funções de data usam date_part
, que é um argumento de cadeia de caracteres constante. Os valores date_part
válidos que você pode usar são:
date_part | Valores |
---|---|
'year' | Ano de quatro dígitos |
'quarter' | 1-4 |
'month' | 1-12 ou "January", "February" e assim por diante |
'dayofyear' | Dia do ano; 1 de janeiro é 1, 1 de fevereiro é 32 etc. |
'day' | 1-31 |
'weekday' | 1-7 ou "Sunday", "Monday" e assim por diante |
'week' | 1-52 |
'hour' | 0-23 |
'minute' | 0-59 |
'second' | 0-60 |
Observação: As funções de data não consideram o início do ano fiscal configurado. Consulte Datas fiscais.
Função | Sintaxe | Descrição |
DATEADD |
| Retorna a data especificada com o Oferece suporte às datas de ISO 8601. Exemplo:
Essa expressão adiciona três meses à data |
DATEDIFF |
| Retorna a diferença entre O parâmetro Oferece suporte às datas de ISO 8601. Exemplos:
A primeira expressão retorna 1 porque quando |
DATENAME |
| Retorna Oferece suporte às datas de ISO 8601. Exemplos:
|
DATEPARSE | DATEPARSE(date_format, [date_string]) | Retorna [date_string] como uma data. O argumento date_format descreverá como o campo [string] é organizado. Devido à variedade de maneiras que o campo de cadeia de caracteres pode ser ordenado, o date_format deve ter correspondência exata. Para obter uma explicação completa, consulte Converter um campo em um campo de data. Exemplo:
Observação: essa função está disponível para os seguintes conectores: conexões não herdadas de arquivos de texto e do Excel, Amazon EMR, Hadoop Hive, Cloudera Hadoop, Planilhas Google, Hortonworks Hadoop Hive, MapR Hadoop Hive, MySQL, Oracle, PostgreSQL e extrações do Tableau. Alguns formatos talvez não estejam disponíveis para todas as conexões. Observação: o DATEPARSE não é compatível nas variantes de Hive. Apenas Denodo, Drill e Snowflake são aceitos. |
DATEPART |
| Retorna O parâmetro Observação: Quando Oferece suporte às datas de ISO 8601. Exemplos:
|
DATETRUNC |
| Trunca a data especificada na precisão definida por date_part. Esta função retorna uma nova data. Por exemplo, quando você trunca uma data no meio do mês no nível do mês, essa função retorna o primeiro dia do mês. O parâmetro Oferece suporte às datas de ISO 8601. Exemplos:
|
DAY |
| Retorna o dia da data especificada como um inteiro. Exemplo:
|
ISDATE |
| Retornará true se uma determinada cadeia de caracteres for uma data válida. Exemplo:
|
MAKEDATE |
| Retorna um valor de data composto por um ano, mês e dia específicos. Disponível para as Extrações de dados do Tableau. Verifique a disponibilidade em outras fontes de dados. Exemplo:
|
MAKEDATETIME |
| Retorna um datetime que combina data e hora. A data pode ser um tipo date, datetime ou string. A hora deve ser um datetime. Observação: esta função está disponível somente para conexões compatíveis com o MySQL (que, para o Tableau, são o MySQL e o Amazon Aurora). Exemplos:
|
MAKETIME |
| Retorna um valor de data composto por uma hora, minuto e segundo específicos. Disponível para as Extrações de dados do Tableau. Verifique a disponibilidade em outras fontes de dados. Exemplo:
|
MAX |
| Normalmente aplicado a números, mas também funciona em datas. Retorna o máximo de Exemplos:
|
MIN |
| Normalmente aplicado a números, mas também funciona em datas. Retorna o mínimo de Exemplos:
|
MONTH |
| Retorna o mês da data especificada como um inteiro. Exemplo:
|
NOW |
| Retorna a data e a hora atuais do sistema local. Exemplo:
|
TRIMESTRE | QUARTER ( ) | Retorna o trimestre da data especificada como um inteiro. Exemplo:
|
TODAY |
| Retorna a data atual. Exemplo:
|
SEMANA | WEEK( ) | Retorna a semana da data especificada como um inteiro. Exemplo:
|
YEAR |
| Retorna o ano da data especificada como um inteiro. Exemplo:
|
ISOQUARTER | ISOQUARTER (date) | Retorna o trimestre baseado em semana ISO8601 de uma data especificada como um inteiro. Exemplo:
|
ISOWEEK | ISOWEEK (date) | Retorna a semana baseada em semana ISO8601 especificada como um inteiro. Exemplo:
|
ISOWEEKDAY | ISOWEEKDAY (date) | Retorna o dia da semana baseado em semana ISO8601 da data especificada como um inteiro. Exemplo:
|
ISOYEAR | ISOYEAR (date) | Retorna o ano baseado em semana ISO8601 de uma data especificada como um inteiro. Exemplo:
|
Função | Sintaxe | Descrição |
IN | <expr1> IN <expr2> | Retorna TRUE se algum valor Os valores Exemplos:
|
AND | IF <expr1> AND <expr2> THEN <then> END | Realiza uma conjunção lógica em duas expressões. Exemplo:
|
CASE | CASE <expression> WHEN <value1> THEN <return1> WHEN
<value2> THEN <return2> ... ELSE <default return> END | Realiza testes lógicos e retorna os valores apropriados. A função CASE avalia CASE também aceita a construção WHEN IN, como
Os valores WHEN IN podem ser um conjunto, lista de valores literais ou campo combinado. Notas adicionais
Exemplos:
|
ELSE | IF <expr> THEN <then> ELSE <else> END | Testa um série de expressões e retorna o valor <then> para a primeira <expr> verdadeira. Exemplo:
|
ELSEIF | IF <expr> THEN <then> [ELSEIF <expr2> THEN <then2>...] [ELSE <else>] END | Testa um série de expressões e retorna o valor <then> para a primeira <expr> verdadeira. Exemplo:
|
END | IF <expr> THEN <then> [ELSEIF <expr2> THEN <then2>...] [ELSE <else>] END | Testa um série de expressões e retorna o valor <then> para a primeira <expr> verdadeira. Deve ser colocada ao final de uma expressão. Exemplo:
|
IF | IF <expr> THEN <then> [ELSEIF <expr2> THEN <then2>...] [ELSE <else>] END | Testa um série de expressões e retorna o valor <then> para a primeira <expr> verdadeira. Exemplo:
|
IFNULL | IFNULL(expr1, expr2) | Retorna <expr1> se não for nulo, caso contrário, retorna <expr2>. Exemplo:
|
IIF | IIF(test, then, else, [unknown]) | Verifica se uma condição é atendida e retorna um valor se VERDADEIRA, outro valor se FALSA e um terceiro valor opcional ou NULO se desconhecida. Exemplo:
|
ISDATE | ISDATE(string) | Retornará true se uma determinada cadeia de caracteres for uma data válida. Exemplo:
|
ISNULL | ISNULL(expression) | Retorna true se a expressão é NULL (não contém dados válidos). Exemplo:
|
MAX | MAX(expression) ou Max(expr1, expr2) | Retorna o máximo de uma expressão única em todos os registros ou o máximo de duas expressões para cada registro. Exemplo:
|
MIN | MIN(expression) ou MIN(expr1, expr2) | Retorna o mínimo de uma expressão em todos os registros ou o mínimo de duas expressões para cada registro. Exemplo:
|
NOT | IF NOT <expr> THEN <then> END | Realiza uma negação lógica em uma expressão. Exemplo:
|
OU | IF <expr1> OR <expr2> THEN <then> END | Realiza uma disjunção lógica em duas expressões. Exemplo:
|
THEN | IF <expre> THEN <then> [ELSEIF ,expr2> THEN <then2>...] [ELSE <else>] END | Testa um série de expressões e retorna o valor <then> para a primeira <expr> verdadeira. Exemplo:
|
WHEN | CASE <expr> WHEN <Value1> THEN <return1> ... [ELSE <else>] END | Encontra o primeiro <value> que corresponde a <expr> e retorna o <return> correspondente. Exemplo:
|
ZN | ZN(expression) | Retorna <expression> se não for nulo, caso contrário, retorna zero. Exemplo:
|
Agregações e aritmética de ponto flutuante: os resultados de algumas agregações nem sempre podem ser exatamente como desejado. Por exemplo, você pode descobrir que a função Sum retorna um valor como -1.42e-14 para uma coluna de número que você sabe que devem somar exatamente 0. Isso acontece porque o padrão de ponto flutuante 754 do IEEE (Institute of Electrical and Electronics Engineers) exige que os números sejam armazenados em formato binário, o que significa que são, às vezes, arredondados em níveis extremamente sutis de precisão. Você pode eliminar essa possível distração usando a função ROUND (ver Funções de número) ou formatando o número para mostrar menos casas decimais.
Função | Sintaxe | Definição |
ATTR |
| Retorna o valor da expressão caso tenha um único valor para todas as linhas. Do contrário, retorna um asterisco. Os valores nulos são ignorados. |
AVG |
| Retorna a média de todos os valores na expressão. AVG pode ser usada com campos numéricos apenas. Os valores nulos são ignorados. |
COLLECT |
| Um cálculo agregado que combina os valores no campo do argumento. Os valores nulos são ignorados. Observação: a função COLLECT pode ser usada apenas com campos espaciais. Exemplo:
|
CORR |
| Retorna o coeficiente de correlação Pearson de duas expressões. A correlação Pearson mede a relação linear entre duas variáveis. Os resultados variam de -1 a +1 inclusive, em que 1 denota uma relação linear positiva e exata, quando uma alteração positiva em uma variável implica na alteração positiva da magnitude correspondente da outra variável, 0 denota nenhuma relação linear entre a variância e −1 é uma relação negativa exata. CORR está disponível com as seguintes fontes de dados:
Para outras fontes de dados, considere extrair os dados ou usar WINDOW_CORR. Consulte Funções de cálculo de tabela. Observação: o quadrado de um resultado CORR é equivalente ao valor quadrado de R para um modelo de linha de tendência linear. Consulte Termos do modelo de linha de tendência. Exemplo: Use CORR para visualizar a correlação em um gráfico de dispersão desagregado. A maneira para fazer isso é usar uma expressão de nível de detalhe com escopo de tabela. Por exemplo:
Com uma expressão de nível de detalhe, a correlação é executada em todas as linhas. Se usou uma fórmula como Consulte Escopo de tabela |
COUNT |
| Retorna o número de itens em um grupo. Os valores Null não são contados. |
COUNTD |
| Retorna o número de itens distintos em um grupo. Os valores Null não são contados. Essa função não está disponível nos seguintes casos: pastas de trabalho criadas antes do Tableau Desktop 8.2 que usam fontes de dados do Microsoft Excel ou de arquivo de texto, pastas de trabalho que usam a conexão herdada e pastas de trabalho que usam fontes de dados do Microsoft Access. Extraia seus dados para um arquivo de extração para usar essa função. Consulte Extrair seus dados. |
COVAR |
| Retorna a covariância de amostra de duas expressões A covariância quantifica como duas variáveis mudam ao mesmo tempo. Uma covariância positiva indica que as variáveis tendem a se mover na mesma direção, como quando valores maiores de uma variável tendem a corresponder aos valores maiores da outra variável, em média. A covariância de amostra usa o número de pontos de dados não nulos, n - 1, para normalizar o cálculo da covariância, em vez de n, que é usado pela covariância populacional (disponível com a função COVARP). A covariância de amostra é a escolha apropriada quando os dados são uma amostra aleatória sendo usada para estimar a covariância de uma população maior. COVAR está disponível com as seguintes fontes de dados:
Para outras fontes de dados, considere extrair os dados ou usar WINDOW_COVAR. Consulte Funções de cálculo de tabela. Se expression1 e expression2 forem iguais — por exemplo, COVAR([profit], [profit]) — COVAR retorna um valor que indica como os valores são distribuídos amplamente. Observação: o valor de COVAR(X, X) é equivalente ao valor de VAR(X) e também ao valor de STDEV(X)^2. Exemplo: A fórmula a seguir retorna a covariância de amostra de Sales e Profit.
|
COVARP |
| Retorna a covariância populacional de duas expressões A covariância quantifica como duas variáveis mudam ao mesmo tempo. Uma covariância positiva indica que as variáveis tendem a se mover na mesma direção, como quando valores maiores de uma variável tendem a corresponder aos valores maiores da outra variável, em média. A covariância populacional é a covariância de amostra multiplicada por (n-1)/n, em que n é o número total de pontos de dados não nulos. A covariância populacional é a escolha apropriada quando há dados disponíveis para todos os itens de interesse, ao invés de somente um subconjunto aleatório de itens, em que a covariância de amostra (com a função COVAR) é apropriada. COVARP está disponível com as seguintes fontes de dados:
Para outras fontes de dados, considere extrair os dados ou usar WINDOW_COVARP. Consulte Funções de cálculo de tabela. Se expression1 e expression2 forem iguais — por exemplo, COVARP([profit], [profit]) — COVARP retorna um valor que indica como os valores são distribuídos amplamente. Observação: o valor de COVARP(X, X) é equivalente ao valor de VARP(X) e também ao valor de STDEVP(X)^2. Exemplo: A fórmula a seguir retorna a covariância populacional de Sales e Profit.
|
MAX |
| Retorna o máximo de uma expressão em todos os registros. Se a expressão for um valor de cadeia de caracteres, essa função retornará o último valor que foi definido em ordem alfabética. |
MEDIAN |
| Retorna o mediano de uma expressão em todos os registros. O mediano pode ser usado apenas com campos numéricos. Os valores nulos são ignorados. Essa função não está disponível para pastas de trabalho criadas antes do Tableau Desktop 8.2 e que usam conexões herdadas. Ela também não está disponível para conexões usando qualquer uma das fontes de dados a seguir:
Para outros tipos de fonte de dados, é possível extrair os dados para um arquivo de extração para usar essa função. Consulte Extrair seus dados. |
MIN |
| Retorna o mínimo de uma expressão em todos os registros. Se a expressão for um valor de cadeia de caracteres, essa função retornará o primeiro valor que foi definido em ordem alfabética. |
PERCENTILE |
| Retorna o valor percentil da expressão indicada correspondente ao número especificado. O número deve estar entre 0 e 1 (inclusive); por exemplo, 0,66, e deve ser uma constante numérica. Essa função está disponível para as fontes de dados a seguir.
Para outros tipos de fonte de dados, é possível extrair os dados para um arquivo de extração para usar essa função. Consulte Extrair seus dados. |
STDEV |
| Retorna o desvio padrão estatístico de todos os valores na expressão atribuída com base em uma amostra da população. |
STDEVP |
| Retorna o desvio padrão estatístico de todos os valores na expressão atribuída com base em uma tendência de população. |
SUM |
| Retorna a soma de todos os valores na expressão. SUM pode ser usada com campos numéricos apenas. Os valores nulos são ignorados. |
VAR |
| Retorna a variação estatística de todos os valores na expressão atribuída com base em uma amostra da população. |
VARP |
| Retorna a variação estatística de todos os valores na expressão atribuída com base na população inteira. |
Função | Sintaxe | Descrição |
FULLNAME |
| Retorna o nome completo do usuário atual. Esse é o nome completo do Tableau Server ou Tableau Cloud quando o usuário está conectado; caso contrário, o local ou o nome completo da rede do usuário do Tableau Desktop. Exemplos:
Isso retorna o nome completo do usuário conectado,
Se o gerente Dave Hallsten estiver conectado, este exemplo retornará True somente se o campo Gerente da exibição contiver Dave Hallsten. Quando usado como um filtro, esse campo calculado poderá ser usado para criar um filtro de usuário que mostra apenas dados relevantes para a pessoa conectada ao servidor. |
ISFULLNAME |
| Retorna true se o nome completo do usuário atual coincide com o nome completo especificado, ou false se não coincide. Essa função usa o nome completo do Tableau Server ou Tableau Cloud quando o usuário está conectado; caso contrário, usa o local ou o nome completo da rede do usuário do Tableau Desktop. Exemplo:
Esse exemplo retornará true se Dave Hallsten for o usuário atual, caso contrário, retornará false. |
ISMEMBEROF |
| Retornará true se a pessoa usando o Tableau atualmente for membro de um grupo que corresponda à cadeia de caracteres especificada. Se a pessoa que está usando o Tableau no momento estiver conectada, a associação ao grupo será determinada pelos grupos no Tableau Server ou Tableau Cloud. Caso a pessoa não tenha entrado, essa função retorna NULL. Observação: a função retornará um valor “True” se a cadeia de caracteres especificada for “Todos os usuários”, conectados no Tableau Server ou no Tableau Cloud. A função ISMEMBEROF() também aceitará domínios do Active Directory. O domínio do Active Directory deve ser declarado no cálculo com o nome do grupo. Exemplo:
|
ISUSERNAME |
| Retorna true se o nome de usuário do usuário atual coincide com o nome de usuário especificado, ou false se não coincide. Essa função usa o nome de usuário do Tableau Server ou Tableau Cloud quando o usuário está conectado; caso contrário, usa o local ou o nome de usuário da rede do usuário do Tableau Desktop. Exemplo:
Retornará true se dhallsten for o usuário atual; caso contrário, retornará false. Observação: “Todos os usuários” sempre será retornado como “true”. |
USERDOMAIN |
| Retorna o domínio do usuário atual quando o usuário está conectado no Tableau Server. Retorna o domínio do Windows se o usuário do Tableau Desktop estiver em um domínio. Caso contrário, essa função retornará uma cadeia de caracteres nula. Exemplo:
|
USERNAME |
| Retorna o nome de usuário do usuário atual. Esse é o nome de usuário do Tableau Server ou Tableau Cloud quando o usuário está conectado; caso contrário, é o local ou nome de usuário da rede para o usuário do Tableau Desktop. Exemplos:
Isso retorna o nome de usuário do usuário conectado,
Se o gerente dhallsten tivesse entrado, essa função só retornaria True quando o campo Gerente na exibição fosse dhallsten. Quando usado como um filtro, esse campo calculado pode ser usado para criar um filtro de usuário que mostra apenas dados relevantes para a pessoa que entrou no servidor. |
USERATRIBUTE | USERATTRIBUTE('attribute_name') | (Para inserir fluxos de trabalho apenas no Tableau Cloud) Retorna uma cadeia de caracteres. Se Observação: você pode usar a função Exemplo: Suponha que ‘Região’ seja o atributo de usuário incluído no JWT e passado para o Tableau usando o aplicativo conectado já configurado pelo administrador do site. Como autor da pasta de trabalho, você pode configurar sua visualização para filtrar dados com base em uma região especificada. Nesse filtro, você pode fazer referência ao seguinte cálculo. [Region]=USERATTRIBUTE('Region') Quando Alan Wang, da região oeste, exibe a visualização incorporada, o Tableau mostra os dados apropriados apenas para a região oeste. |
USERATTRIBUTEINCLUDES | USERATTRIBUTEINCLUDES('attribute_name', 'expected_value') | (Para inserir fluxos de trabalho apenas no Tableau Cloud) Retorna um booleano. Retorna "true" se o seguinte for verdadeiro: 1) Observação: você pode usar a função Exemplo: Suponha que ‘Região’ seja o atributo de usuário definido no JWT e passado para o Tableau usando o aplicativo conectado já configurado pelo administrador do site. Como autor da pasta de trabalho, você pode configurar sua visualização para filtrar dados com base na [Região]. Nesse filtro, você pode fazer referência ao seguinte cálculo. USERATTRIBUTEINCLUDES('Region', [Region]) Se Alan Wang da região Oeste acessar a visualização inserida, o Tableau verificará se o atributo de usuário Região corresponde a um dos valores do campo [Região]. Quando true, a visualização mostra os dados apropriados. Quando outro usuário, Michele Kim, da região Norte, acessa a mesma visualização, ela não consegue ver nenhum dado porque não há correspondência com os valores do campo [Região]. |
FIRST( )
Retorna o número de linhas da linha atual até a primeira linha na partição. Por exemplo, a exibição a seguir mostra as vendas trimestrais. Quando FIRST() é calculado na partição Date, a compensação da primeira linha em relação à segunda linha é -1.
Exemplo
Quando o índice de linha atual for 3, FIRST()
= -2
.
INDEX( )
Retorna o índice da linha atual na partição, sem qualquer classificação em relação ao valor. O índice da primeira linha começa em 1. Por exemplo, a tabela a seguir mostra as vendas trimestrais. Quando INDEX() é calculada na partição Date, o índice de cada linha é 1, 2, 3, 4..., etc.
Exemplo
Para a terceira linha na partição, INDEX() = 3
.
LAST( )
Retorna o número de linhas da linha atual até a última linha na partição. Por exemplo, a tabela a seguir mostra as vendas trimestrais. Quando LAST() é calculado na partição Date, a compensação da última linha em relação à segunda linha é 5.
Exemplo
Quando o índice de linha atual for 3 de 7, LAST() = 4
.
LOOKUP(expression, [offset])
Retorna o valor da expressão em uma linha de destino, especificada como uma compensação relativa da linha atual. Use FIRST() + n e LAST() - n como parte de sua definição de deslocamento para um destino relativo à primeira/última linha da partição. Se offset
for omitido, a linha para comparação poderá ser definida no menu de campo. Esta função retornará NULL se a linha de destino não puder ser determinada.
A exibição a seguir mostra as vendas trimestrais. Quando LOOKUP (SUM(Sales), 2)
é calculado na partição Date, cada linha mostra o valor de vendas de 2 trimestres no futuro.
Exemplo
LOOKUP(SUM([Profit]),
FIRST()+2)
calcula SUM(Profit) na terceira linha da partição.
MODEL_EXTENSION_BOOL (model_name, argumentos, expressão)
Retorna o resultado booleano de uma expressão calculada por um modelo nomeado implantado em um serviço externo TabPy.
Model_name é o nome do modelo de análise implementado que você deseja usar.
Cada argumento é uma única cadeia de caracteres que define os valores de entrada que o modelo implementado aceita e é definido pelo modelo analítico.
Use expressões para definir os valores que são enviados do Tableau para o modelo de análise. Certifique-se de usar funções de agregação (SUM, AVG, etc.) para agregar os resultados.
Ao usar a função, os tipos de dados e a ordem das expressões devem corresponder aos dos argumentos de entrada.
Exemplo
MODEL_EXTENSION_BOOL ("isProfitable","inputSales", "inputCosts", SUM([Sales]), SUM([Costs]))
MODEL_EXTENSION_INT (nome_modelo, argumentos, expressão)
Retorna um resultado inteiro de uma expressão calculada por um modelo nomeado implantado em um serviço externo TabPy.
Model_name é o nome do modelo de análise implementado que você deseja usar.
Cada argumento é uma única cadeia de caracteres que define os valores de entrada que o modelo implementado aceita e é definido pelo modelo analítico.
Use expressões para definir os valores que são enviados do Tableau para o modelo de análise. Certifique-se de usar funções de agregação (SUM, AVG, etc.) para agregar os resultados.
Ao usar a função, os tipos de dados e a ordem das expressões devem corresponder aos dos argumentos de entrada.
Exemplo
MODEL_EXTENSION_INT ("getPopulation", "inputCity", "inputState", MAX([City]), MAX ([State]))
MODEL_EXTENSION_REAL (nome_modelo, argumentos, expressão)
Retorna um resultado real de uma expressão calculada por um modelo nomeado implantado em um serviço externo TabPy.
Model_name é o nome do modelo de análise implementado que você deseja usar.
Cada argumento é uma única cadeia de caracteres que define os valores de entrada que o modelo implementado aceita e é definido pelo modelo analítico.
Use expressões para definir os valores que são enviados do Tableau para o modelo de análise. Certifique-se de usar funções de agregação (SUM, AVG, etc.) para agregar os resultados.
Ao usar a função, os tipos de dados e a ordem das expressões devem corresponder aos dos argumentos de entrada.
Exemplo
MODEL_EXTENSION_REAL ("profitRatio", "inputSales", "inputCosts", SUM([Sales]), SUM([Costs]))
MODEL_EXTENSION_STRING (nome_modelo, argumentos, expressão)
Retorna o resultado da string de uma expressão calculada por um modelo nomeado implantado em um serviço externo TabPy.
Model_name é o nome do modelo de análise implementado que você deseja usar.
Cada argumento é uma única cadeia de caracteres que define os valores de entrada que o modelo implementado aceita e é definido pelo modelo analítico.
Use expressões para definir os valores que são enviados do Tableau para o modelo de análise. Certifique-se de usar funções de agregação (SUM, AVG, etc.) para agregar os resultados.
Ao usar a função, os tipos de dados e a ordem das expressões devem corresponder aos dos argumentos de entrada.
Exemplo
MODEL_EXTENSION_STR ("mostPopulatedCity", "inputCountry", "inputYear", MAX ([Country]), MAX([Year]))
MODEL_PERCENTILE(target_expression, predictor_expression(s))
Retorna a probabilidade (entre 0 e 1) do valor esperado ser menor ou igual à marca observada, definida pela expressão-alvo e outros preditores. Esta é a Função de Distribuição Preditiva Posterior, também conhecida como Função de Distribuição Cumulativa (CDF).
Esta função é o inverso de MODEL_QUANTILE. Para obter informações sobre funções de modelagem preditiva, consulte Como funcionam as funções de modelagem preditiva no Tableau.
Exemplo
A fórmula a seguir devolve o quantil da marca para a soma das vendas, ajustada para contagem de pedidos.
MODEL_PERCENTILE(SUM([Sales]), COUNT([Orders]))
MODEL_QUANTILE(quantile, target_expression, predictor_expression(s))
Retorna um valor numérico de destino dentro do intervalo provável definido pela expressão de destino e outros preditores, em um quantil especificado. Este é o Quantil Preditivo Posterior.
Esta função é o inverso de MODEL_PERCENTILE. Para obter informações sobre funções de modelagem preditiva, consulte Como funcionam as funções de modelagem preditiva no Tableau.
Exemplo
A fórmula a seguir retorna a mediana (0,5) da soma prevista de vendas, ajustada para contagem de pedidos.
MODEL_QUANTILE(0.5, SUM([Sales]), COUNT([Orders]))
PREVIOUS_VALUE(expression)
Retorna o valor desse cálculo na linha anterior. Retornará a expressão especificada se a linha atual for a primeira linha da partição.
Exemplo
SUM([Profit]) * PREVIOUS_VALUE(1)
calcula o produto em execução de SUM(Profit).
RANK(expression, ['asc' | 'desc'])
Retorna a posição na classificação da concorrência padrão para a linha atual da partição. Valores idênticos são colocados em uma posição na classificação idêntica. Use o argumento opcional 'asc' | 'desc'
para especificar a ordem crescente ou decrescente. O padrão é decrescente.
Com esta função, o conjunto de valores (6, 9, 9, 14) seria classificado (4, 2, 2, 1).
Os nulos são ignorados em funções de classificação. Eles não são numerados e não são contabilizados para o número total de registros em cálculos de posição na classificação percentil.
Para obter informações sobre opções de classificação diferentes, consulte Cálculo da posição na classificação.
Exemplo
A imagem a seguir mostra o efeito das várias funções de classificação (RANK, RANK_DENSE, RANK_MODIFIED, RANK_PERCENTILE e RANK_UNIQUE) sobre um conjunto de valores. O conjunto de dados contém informações sobre 14 alunos (do AlunoA até o AlunoN); a coluna Idade mostra a idade atual de cada aluno (todos entre 17 e 20 anos). As colunas restantes mostram o efeito de cada função do ranking no conjunto de valores de idade, sempre assumindo a ordem padrão (ascendente ou descendente) para a função.
RANK_DENSE(expression, ['asc' | 'desc'])
Retorna a posição na classificação densa para a linha atual na partição. Para valores idênticos, são atribuídos uma mesma posição na classificação, mas nenhuma lacuna é inserida na sequência numérica. Use o argumento opcional 'asc' | 'desc'
para especificar a ordem crescente ou decrescente. O padrão é decrescente.
Com esta função, o conjunto de valores (6, 9, 9, 14) seria classificado (3, 2, 2, 1).
Os nulos são ignorados em funções de classificação. Eles não são numerados e não são contabilizados para o número total de registros em cálculos de posição na classificação percentil.
Para obter informações sobre opções de classificação diferentes, consulte Cálculo da posição na classificação.
RANK_MODIFIED(expression, ['asc' | 'desc'])
Retorna a posição na classificação da concorrência modificada para a linha atual na partição. Valores idênticos são colocados em uma posição na classificação idêntica. Use o argumento opcional 'asc' | 'desc'
para especificar a ordem crescente ou decrescente. O padrão é decrescente.
Com esta função, o conjunto de valores (6, 9, 9, 14) seria classificado (4, 3, 3, 1).
Os nulos são ignorados em funções de classificação. Eles não são numerados e não são contabilizados para o número total de registros em cálculos de posição na classificação percentil.
Para obter informações sobre opções de classificação diferentes, consulte Cálculo da posição na classificação.
RANK_PERCENTILE(expression, ['asc' | 'desc'])
Retorna a posição na classificação percentil para a linha atual na partição. Use o argumento opcional 'asc' | 'desc'
para especificar a ordem crescente ou decrescente. O padrão é crescente.
Com esta função, o conjunto de valores (6, 9, 9, 14) seria classificado (0,00, 0,67, 0,67, 1,00).
Os nulos são ignorados em funções de classificação. Eles não são numerados e não são contabilizados para o número total de registros em cálculos de posição na classificação percentil.
Para obter informações sobre opções de classificação diferentes, consulte Cálculo da posição na classificação.
RANK_UNIQUE(expression, ['asc' | 'desc'])
Retorna a posição na classificação exclusiva para a linha atual na partição. Para valores idênticos, são atribuídas diferentes posições na classificação. Use o argumento opcional 'asc' | 'desc'
para especificar a ordem crescente ou decrescente. O padrão é decrescente.
Com esta função, o conjunto de valores (6, 9, 9, 14) seria classificado (4, 2, 3, 1).
Os nulos são ignorados em funções de classificação. Eles não são numerados e não são contabilizados para o número total de registros em cálculos de posição na classificação percentil.
Para obter informações sobre opções de classificação diferentes, consulte Cálculo da posição na classificação.
RUNNING_AVG(expression)
Retorna a média em execução da expressão especificada a partir da primeira linha na partição para a linha atual.
A exibição a seguir mostra as vendas trimestrais. Quando RUNNING_AVG(SUM([Sales])
é calculado na partição Date, o resultado é uma média em execução dos valores de vendas de cada trimestre.
Exemplo
RUNNING_AVG(SUM([Profit]))
calcula a média em execução de SUM(Profit).
RUNNING_COUNT(expression)
Retorna a contagem em execução da expressão especificada a partir da primeira linha na partição para a linha atual.
Exemplo
RUNNING_COUNT(SUM([Profit]))
calcula a contagem em execução de SUM(Profit).
RUNNING_MAX(expression)
Retorna o máximo em execução da expressão especificada a partir da primeira linha na partição para a linha atual.
Exemplo
RUNNING_MAX(SUM([Profit]))
calcula o máximo em execução de SUM(Profit).
RUNNING_MIN(expression)
Retorna o mínimo em execução da expressão especificada a partir da primeira linha na partição para a linha atual.
Exemplo
RUNNING_MIN(SUM([Profit]))
calcula o mínimo em execução de SUM(Profit).
RUNNING_SUM(expression)
Retorna a soma em execução da expressão especificada a partir da primeira linha na partição para a linha atual.
Exemplo
RUNNING_SUM(SUM([Profit]))
calcula a soma em execução de SUM(Profit)
SIZE()
Retorna o número de linhas na partição. Por exemplo, a exibição a seguir mostra as vendas trimestrais. Na partição Date, há sete linhas, portanto, o Size() da partição Date é 7.
Exemplo
SIZE() = 5
quando a partição atual contém cinco linhas.
SCRIPT_BOOL
Retorna um resultado Booliano da expressão especificada. A expressão é transmitida diretamente para uma extensão de análise em execução.
Nas expressões R, use .argn (com um ponto à frente) para fazer referência a parâmetros (.arg1, .arg2 etc.).
Nas expressões de Python, use _argn (com um sublinhado à frente).
Exemplos
Neste exemplo R, .arg1 é igual a SUM([Profit]):
SCRIPT_BOOL("is.finite(.arg1)", SUM([Profit]))
O próximo exemplo retorna True para IDs de loja no estado de Washington e False para os demais. Este exemplo poderia ser a definição de um campo calculado intitulado IsStoreInWA.
SCRIPT_BOOL('grepl(".*_WA", .arg1, perl=TRUE)',ATTR([Store ID]))
Um comando do Python seria dessa forma:
SCRIPT_BOOL("return map(lambda x : x > 0, _arg1)", SUM([Profit]))
SCRIPT_INT
Retorna um resultado do inteiro da expressão especificada. A expressão é transmitida diretamente para uma extensão de análise em execução.
Nas expressões R, use .argn (com um ponto à frente) para fazer referência a parâmetros (.arg1, .arg2 etc.).
Nas expressões de Python, use _argn (com um sublinhado à frente).
Exemplos
Neste exemplo R, .arg1 é igual a SUM([Profit]):
SCRIPT_INT("is.finite(.arg1)", SUM([Profit]))
No próximo exemplo, o agrupamento k-means é usado para criar três clusters:
SCRIPT_INT('result <- kmeans(data.frame(.arg1,.arg2,.arg3,.arg4), 3);result$cluster;', SUM([Petal length]), SUM([Petal width]),SUM([Sepal length]),SUM([Sepal width]))
Um comando do Python seria dessa forma:
SCRIPT_INT("return map(lambda x : int(x * 5), _arg1)", SUM([Profit]))
SCRIPT_REAL
Retorna um resultado real da expressão especificada. A expressão é transmitida diretamente para uma extensão de análise em execução. Nas
expressões R, use .argn (com um ponto à frente) para fazer referência a parâmetros (.arg1, .arg2 etc.).
Nas expressões de Python, use _argn (com um sublinhado à frente).
Exemplos
Neste exemplo R, .arg1 é igual a SUM([Profit]):
SCRIPT_REAL("is.finite(.arg1)", SUM([Profit]))
O próximo exemplo converte valores de temperatura de Celsius em Fahrenheit.
SCRIPT_REAL('library(udunits2);ud.convert(.arg1, "celsius", "degree_fahrenheit")',AVG([Temperature]))
Um comando do Python seria dessa forma:
SCRIPT_REAL("return map(lambda x : x * 0.5, _arg1)", SUM([Profit]))
SCRIPT_STR
Retorna um resultado da cadeia de caracteres da expressão especificada. A expressão é transmitida diretamente para uma extensão de análise em execução.
Nas expressões R, use .argn (com um ponto à frente) para fazer referência a parâmetros (.arg1, .arg2 etc.).
Nas expressões de Python, use _argn (com um sublinhado à frente).
Exemplos
Neste exemplo R, .arg1 é igual a SUM([Profit]):
SCRIPT_STR("is.finite(.arg1)", SUM([Profit]))
O próximo exemplo extrai uma abreviação de estado de uma cadeia de caracteres mais complicada (na forma original 13XSL_CA, A13_WA):
SCRIPT_STR('gsub(".*_", "", .arg1)',ATTR([Store ID]))
Um comando do Python seria dessa forma:
SCRIPT_STR("return map(lambda x : x[:2], _arg1)", ATTR([Region]))
TOTAL(expression)
Retorna o número total da expressão fornecida em uma divisão do cálculo de tabela.
Exemplo
Suponha que você está começando com esta exibição:
Você abre o editor de cálculo e cria um novo campo nomeado de Totalidade:
Em seguida, solte o campo Totalidade em Texto para substituir SUM(Sales). Suas exibições são alteradas de tal forma, que ela soma os valores com base no valor padrão de Calcular usando:
Isso levanta a questão, qual é o valor padrão de Calcular usando? Se você clicar com o botão direito do mouse (clique pressionando a tecla Control, no Mac) na Totalidade, no painel de Dados, e escolher Editar, haverá um pouco de informação adicional disponível:
O valor padrão de Calcular usando é uma Tabela (horizontal). O resultado é que a Totalidade é soma dos valores em cada linha da tabela. Assim, o valor visualizado em cada linha é a soma dos valores da versão original da tabela.
Os valores na linha 2011/Q1 na tabela original foram de US$ 8.601,00; US$ 6.579,00; US$ 44.262,00; e US$ 15.006,00. Os valores na tabela após a Totalidade substituem a SUM(Sales) com um total de US $74.448,00; que é a soma dos quatro valores originais.
Observe o triângulo ao lado de Totalidade depois de soltá-lo em Texto:
Isso indica que este campo está usando um cálculo de tabela. Você pode clicar com o botão direito do mouse no campo e escolher Editar o cálculo de tabela para redirecionar a sua função para um valor de Calcular usando diferente. Por exemplo, você pode defini-lo para Tabela (vertical). Nesse caso, a tabela ficaria assim:
WINDOW_AVG(expression, [start, end])
Retorna a média da expressão na janela. A janela é definida por meio de compensações da linha atual. Use FIRST()+n e LAST()-n como compensações da primeira ou última linha na partição. Se o início e o fim forem omitidos, toda a partição será usada.
Por exemplo, a exibição a seguir mostra as vendas trimestrais. Uma média de janela na partição Date retorna a média de vendas em todas as datas.
Exemplo
WINDOW_AVG(SUM([Profit]), FIRST()+1, 0)
calcula a média de SUM(Profit) a partir da segunda linha até a linha atual.
WINDOW_CORR(expression1, expression2, [start, end])
Retorna o coeficiente de correlação Pearson de duas expressões dentro da janela. A janela é definida como desvios em relação à linha atual. Use FIRST()+n e LAST()-n como compensações da primeira ou última linha na partição. Se o início e o fim forem omitidos, toda a partição será usada.
A correlação Pearson mede a relação linear entre duas variáveis. Os resultados variam de -1 a +1 inclusive, em que 1 denota uma relação linear positiva e exata, quando uma alteração positiva em uma variável implica na alteração positiva da magnitude correspondente da outra variável, 0 denota nenhuma relação linear entre a variância e −1 é uma relação negativa exata.
Há uma função de agregação equivalente: CORR. Consulte Funções do Tableau (em ordem alfabética)(O link abre em nova janela).
Exemplo
A fórmula a seguir retorna a correlação Pearson de SUM(Profit) e SUM(Sales) das cinco linhas anteriores à linha atual.
WINDOW_CORR(SUM[Profit]), SUM([Sales]), -5, 0)
WINDOW_COUNT(expression, [start, end])
Retorna a contagem da expressão na janela. A janela é definida por meio de compensações da linha atual. Use FIRST()+n e LAST()-n como compensações da primeira ou última linha na partição. Se o início e o fim forem omitidos, toda a partição será usada.
Exemplo
WINDOW_COUNT(SUM([Profit]), FIRST()+1, 0)
calcula a contagem de SUM(Profit) a partir da segunda linha até a linha atual
WINDOW_COVAR(expression1, expression2, [start, end])
Retorna a covariância de amostra de duas expressões dentro da janela. A janela é definida como desvios em relação à linha atual. Use FIRST()+n e LAST()-n como compensações da primeira ou última linha na partição. Se os argumentos iniciais e finais forem omitidos, a janela será toda a partição.
A covariância de amostra usa o número de pontos de dados não nulos, n - 1, para normalizar o cálculo da covariância, em vez de n, que é usado pela covariância populacional (disponível com a função WINDOWS_COVARP). A covariância de amostra é a escolha apropriada quando os dados são uma amostra aleatória sendo usada para estimar a covariância de uma população maior.
Há uma função de agregação equivalente: COVAR. Consulte Funções do Tableau (em ordem alfabética)(O link abre em nova janela).
Exemplo
A fórmula a seguir retorna a covariância de amostra de SUM(Profit) e SUM(Sales) das duas linhas anteriores à linha atual.
WINDOW_COVAR(SUM([Profit]), SUM([Sales]), -2, 0)
WINDOW_COVARP(expression1, expression2, [start, end])
Retorna a covariância populacional de duas expressões dentro da janela. A janela é definida como desvios em relação à linha atual. Use FIRST()+n e LAST()-n como compensações da primeira ou última linha na partição. Se o início e o fim forem omitidos, toda a partição será usada.
A covariância populacional é a covariância de amostra multiplicada por (n-1)/n, em que n é o número total de pontos de dados não nulos. A covariância populacional é a escolha apropriada quando há dados disponíveis para todos os itens de interesse, ao invés de somente um subconjunto aleatório de itens, em que a covariância de amostra (com a função WINDOWS_COVAR) é apropriada.
Há uma função de agregação equivalente: COVARP. Funções do Tableau (em ordem alfabética)(O link abre em nova janela)
Exemplo
A fórmula a seguir retorna a covariância populacional de SUM(Profit) e SUM(Sales) das duas linhas anteriores à linha atual.
WINDOW_COVARP(SUM([Profit]), SUM([Sales]), -2, 0)
WINDOW_MEDIAN(expression, [start, end])
Retorna o mediano da expressão na janela. A janela é definida por meio de compensações da linha atual. Use FIRST()+n e LAST()-n como compensações da primeira ou última linha na partição. Se o início e o fim forem omitidos, toda a partição será usada.
Por exemplo, a exibição a seguir mostra o lucro trimestral. Um mediano de janela na partição Date retorna o lucro médio em todas as datas.
Exemplo
WINDOW_MEDIAN(SUM([Profit]), FIRST()+1, 0)
calcula o mediano de SUM(Profit) a partir da segunda linha até a linha atual.
WINDOW_MAX(expression, [start, end])
Retorna o máximo da expressão na janela. A janela é definida por meio de compensações da linha atual. Use FIRST()+n e LAST()-n como compensações da primeira ou última linha na partição. Se o início e o fim forem omitidos, toda a partição será usada.
Por exemplo, a exibição a seguir mostra as vendas trimestrais. Uma máxima de janela na partição Date retorna o máximo de vendas em todas as datas.
Exemplo
WINDOW_MAX(SUM([Profit]), FIRST()+1, 0)
calcula o máximo de SUM(Profit) a partir da segunda linha até a linha atual.
WINDOW_MIN(expression, [start, end])
Retorna o mínimo da expressão na janela. A janela é definida por meio de compensações da linha atual. Use FIRST()+n e LAST()-n como compensações da primeira ou última linha na partição. Se o início e o fim forem omitidos, toda a partição será usada.
Por exemplo, a exibição a seguir mostra as vendas trimestrais. Um mínimo de janela na partição Date retorna o mínimo de vendas em todas as datas.
Exemplo
WINDOW_MIN(SUM([Profit]), FIRST()+1, 0)
calcula o mínimo de SUM(Profit) a partir da segunda linha até a linha atual.
WINDOW_PERCENTILE(expression, number, [start, end])
Retorna o valor correspondente ao percentil especificado dentro da janela. A janela é definida por meio de compensações da linha atual. Use FIRST()+n e LAST()-n como compensações da primeira ou última linha na partição. Se o início e o fim forem omitidos, toda a partição será usada.
Exemplo
WINDOW_PERCENTILE(SUM([Profit]), 0.75, -2, 0)
retorna o 75º percentil para SUM(Profit) das duas linhas anteriores para a linha atual.
WINDOW_STDEV(expression, [start, end])
Retorna o desvio padrão de exemplo da expressão na janela. A janela é definida por meio de compensações da linha atual. Use FIRST()+n e LAST()-n como compensações da primeira ou última linha na partição. Se o início e o fim forem omitidos, toda a partição será usada.
Exemplo
WINDOW_STDEV(SUM([Profit]), FIRST()+1, 0)
calcula o desvio padrão de SUM(Profit) a partir da segunda linha até a linha atual.
WINDOW_STDEVP(expression, [start, end])
Retorna o desvio padrão tendencioso da expressão na janela. A janela é definida por meio de compensações da linha atual. Use FIRST()+n e LAST()-n como compensações da primeira ou última linha na partição. Se o início e o fim forem omitidos, toda a partição será usada.
Exemplo
WINDOW_STDEVP(SUM([Profit]), FIRST()+1, 0)
calcula o desvio padrão de SUM(Profit) a partir da segunda linha até a linha atual.
WINDOW_SUM(expression, [start, end])
Retorna a soma da expressão na janela. A janela é definida por meio de compensações da linha atual. Use FIRST()+n e LAST()-n como compensações da primeira ou última linha na partição. Se o início e o fim forem omitidos, toda a partição será usada.
Por exemplo, a exibição a seguir mostra as vendas trimestrais. Uma soma de janela na partição Date retorna a soma de vendas em todos os trimestres.
Exemplo
WINDOW_SUM(SUM([Profit]), FIRST()+1, 0)
calcula a soma de SUM(Profit) a partir da segunda linha até a linha atual.
WINDOW_VAR(expression, [start, end])
Retorna a variação da expressão na janela. A janela é definida por meio de compensações da linha atual. Use FIRST()+n e LAST()-n como compensações da primeira ou última linha na partição. Se o início e o fim forem omitidos, toda a partição será usada.
Exemplo
WINDOW_VAR((SUM([Profit])), FIRST()+1, 0)
calcula a variância de SUM(Profit) a partir da segunda linha até a linha atual.
WINDOW_VARP(expression, [start, end])
Retorna a variação tendenciosa da expressão na janela. A janela é definida por meio de compensações da linha atual. Use FIRST()+n e LAST()-n como compensações da primeira ou última linha na partição. Se o início e o fim forem omitidos, toda a partição será usada.
Exemplo
WINDOW_VARP(SUM([Profit]), FIRST()+1, 0)
calcula a variância de SUM(Profit) a partir da segunda linha até a linha atual.
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])
As funções espaciais permitem executar a análise espacial avançada e combinar arquivos espaciais com dados em outros formatos, como arquivos de texto ou planilhas.
Função | Sintaxe | Descrição |
ÁREA | AREA(Spatial Polygon, "units") | Retorna a área total da superfície de um polígono espacial. Nomes das unidades compatíveis: metros (“metros”, “metres”, “m”), quilômetros (“quilômetros”, “kilometres”, “km”), milhas (“milhas” ou “mi”), pés (“feet”, “ft”). |
BUFFER | BUFFER(Spatial Point, distance, "units") | Retorna uma forma de polígono com um raio determinado pelos valores de distância e unidade definidos no cálculo. Observação: o cálculo do buffer funcionará apenas com um objeto espacial do Ponto. O BUFFER aceita os mesmos nomes de unidade que a função DISTANCE |
DISTÂNCIA | DISTANCE(<Spatial Point1>,<Spatial Point2>,"<units>") | Retorna a medida de distância entre dois pontos em uma unidade especificada. Nomes das unidades compatíveis: metros (“metros”, “metres”, “m”), quilômetros (“quilômetros”, “kilometres”, “km”), milhas (“milhas” ou “mi”), pés (“feet”, “ft”). Essa função só pode ser criada com uma conexão dinâmica e continuará a funcionar quando uma fonte de dados for convertida em uma extração. Exemplo:
|
INTERSECTS | INTERSECTS (<geometry1>,<geometry2>) | Retorna um Booleano (True/False) indicando se duas geometrias se sobrepõem no espaço. Combinações suportadas: ponto/polígono, linha/polígono e polígono/polígono. |
MAKELINE | MAKELINE(<Spatial Point1>,<Spatial Point2>) | Gera uma marca de linha entre dois pontos; útil para criar mapas de origem-destino. Exemplos:
|
MAKEPOINT | MAKEPOINT(<latitude>, <longitude>) | Converte dados das colunas de latitude e longitude em objetos espaciais. Você pode usar o MAKEPOINT para ativar espacialmente uma fonte de dados para que ela possa ser unida a um arquivo espacial, utilizando uma ligação espacial. Para obter mais informações, consulte Unir arquivos espaciais no Tableau. Para utilizar o MAKEPOINT, os dados devem conter coordenadas de latitude e longitude. Exemplo:
|
MAKEPOINT (X,Y, SRID) |
| Converte dados de coordenadas geográficas projetadas em objetos espaciais. SRID é um identificador de referência espacial que utiliza os códigos do sistema de referência ESPG para especificar sistemas de coordenadas. Se o SRID não for especificado, o WGS84 será considerado e os parâmetros serão tratados como latitude/longitude em graus. Essa função só pode ser criada com uma conexão dinâmica e continuará a funcionar quando uma fonte de dados for convertida em uma extração. Exemplo:
|
LENGTH | Length (Spatial lines) | Calcula o comprimento combinado de todas as strings de linha no parâmetro espacial. |
OUTLINE | Outline (Spatial geometry) | Transforma polígonos (incluindo aqueles dentro de multipolígonos) em cadeias de linha. Por exemplo, você pode separar o contorno do preenchimento se colocar o contorno em outra camada. |
SHAPETYPE | ShapeType (Spatial geometry) | Retorna uma cadeia de caracteres que descreve a estrutura da geometria espacial, como Empty ,Point ,MultiPoint ,LineString ,MultiLinestring ,Polygon ,MultiPolygon ,Mixed eunsupported . |
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)