Este artigo descreve como criar e formatar cálculos no Tableau. Ele lista os componentes básicos dos cálculos e explica a sintaxe correta de cada um.

Blocos de criação de cálculos

Há quatro componentes básicos de cálculos no Tableau:

  • Funções - Instruções usadas para transformar os valores ou membros em um campo.

  • Campos - Dimensões ou medidas da fonte de dados.

  • Operadores - Símbolos que denotam uma operação.

  • Expressões literais - Valores constantes que são representados “tal como estão”, como "Lucrativo" e "Não lucrativo".

    Por exemplo, considere o cálculo a seguir:

    IF [Profit per Day] > 000 THEN "Highly Profitable"
    ELSEIF [Profit per Day] <= 0 THEN "Unprofitable"
    ELSE "Profitable"
    END

    Os componentes deste cálculo podem ser detalhados em:

    Funções: IF, THEN, ELSEIF, ELSE e END

    Campo: lucro por dia

    Operadores: > and <=

    Expressões literais:

    • Literais de cadeia de caracteres: "Altamente lucrativo", "Não lucrativo” e "Lucrativo"
    • Literais numéricos: 2000 e 0

    Nem todos os cálculos precisam conter os quatro componentes. Por exemplo, um cálculo pode não conter uma expressão literal, como o cálculo SUM([Sales])/SUM([Cost]), que contém apenas a função, SUM; o operador de divisão (/); e os campos Vendas e Custo.

Além disso, os cálculos podem conter:

  • Parâmetros - Variáveis de preenchimento que podem ser inseridas em cálculos para substituir valores constantes.

  • Comentários - Notas sobre um cálculo ou suas partes, não incluídas na computação do cálculo.

Para obter maus informações sobre como usar e formatar cada um desses componentes em um cálculo, consulte as seções a seguir.

Visão geral: sintaxe de cálculo

ComponentesSintaxeExemplo

Funções

Consulte Funções do Tableau (em ordem alfabética)(O link abre em nova janela) para obter exemplos de como formatar funções no Tableau.

SUM (expression)

Campos

Um campo em um cálculo está muitas vezes entre colchetes [ ]. Consulte Sintaxe de campo para obter mais informações.

[Sales]

Operadores

+, -, *, /, %, ==, =, >, <, >=, <=, !=, <>, ^, AND, OR, NOT, ( ). Consulte Sintaxe de operador para obter informações sobre os tipos de operadores que podem ser usados em cálculos do Tableau e a ordem em que são executador em uma fórmula.

[Profit] - [Sales]

Expressões literais

Os literais numéricos são escritos como números.

Os literais de cadeia de caracteres são escritos entre aspas.

Os literais de data são escritos com o símbolo #.

Os literais boolianos são escritos como true ou false.

Os literais nulos são escritos como null.

Consulte Sintaxe de expressão literal para obter mais informações.

1.3567 ou 27

"Unprofitable"

#August 22, 2005#

true ou false

Null

Parâmetros

Um parâmetro em um cálculo deve estar entre colchetes [ ]. Consulte Criar parâmetros para obter mais informações.

[Profit Bin Size]

Comentários

Para inserir um comentário em um cálculo, digite duas barras //. Consulte Adicionar comentários a um cálculo para obter mais informações.

Comentários de várias linhas podem ser adicionados digitando /* para iniciar o comentário e */ para encerrá-lo.

SUM([Sales])/SUM([Profit]) //John's calculation

//To be used for profit ratio

//Do not edit

Detalhes da sintaxe de cálculos

Consulte as seções a seguir para saber mais sobre os diferentes componentes dos cálculos do Tableau e como formatá-los para trabalhar no Tableau.

Sintaxe da função

As funções são os componentes principais de um cálculo e podem ser usados para vários objetivos.

As funções são coloridas em azul nos cálculos do Tableau.

Todas as funções no Tableau requerem uma sintaxe específica. Por exemplo, a função SUM requer a sintaxe a seguir: SUM(expression) (por exemplo, SUM([Sales]) ). A função PERCENTILE, por sua vez, requer a sintaxe a seguir: PERCENTILE(expression, number) (por exemplo, PERCENTILE([Sales],0.90) ).

É possível pesquisar como usar e formatar uma função específica a qualquer momento.

Para abrir a lista de funções no Tableau:

  1. Selecione Análise > Criar campo calculado.

  2. No Editor de cálculo, clique no ícone de triângulo (localizado na borda direita do editor).

    Aparecerá uma lista de funções para que possa pesquisar. Ao selecionar uma função da lista, a seção na parte direita atualiza com informações sobre a sintaxe obrigatória dessa função (1) e descrição dela (2) e um ou mais exemplos (3).

Usar várias funções em um cálculo

É possível usar mais de uma função em um cálculo. Por exemplo:

ZN(SUM([Order Quantity])) - WINDOW_AVG(SUM([Order Quantity]))

Há três funções no cálculo: ZN, SUM, e WINDOW_AVG.

As funções ZN e WINDOW_AVG estão separadas por um operador de subtração (-).

Uma função também pode ser parte de outra função (ou aninhada), como é o caso da porção ZN(SUM([Order Quantity])) do exemplo acima. Nesse caso, a soma (SUM) da quantidade do pedido é calculada antes da função ZN, pois está entre parênteses. Para obter informações sobre o porquê, consulte Parênteses.

Sintaxe de campo

Os campos podem ser inseridos nos cálculos. Geralmente, a sintaxe da função indica onde um campo deve ser inserido no cálculo. Por exemplo: SUM(expression).

Os nomes de campo devem aparecer entre colchetes [ ] em um cálculo quando o nome de campo contém um espaço ou não é único. Por exemplo, [Categorias de vendas].

O tipo de função usada determina o tipo de campo usado. Por exemplo, com a função SUM, é possível inserir um campo numérico, mas não é possível inserir um campo de data. Para obter mais informações, consulte Entendendo os tipos de dados nos cálculos.

Os campos escolhidos para serem incluídos nos cálculos dependem do propósito do cálculo. Por exemplo, se deseja calcular um raio de lucro, o cálculo usará os campos Venda e Lucro da fonte de dados:

SUM([Sales])/SUM([Profit])

Para adicionar um campo a um cálculo, faça uma das seguintes opções:

  • Arraste-o do Painel Dados ou da exibição e solte-o no editor de cálculo.

  • No Editor de cálculo, digite o nome de campo. Observação: o Editor de cálculo tenta completar os nome de campo automaticamente.

Os campos são coloridos nos cálculos do Tableau.

Sintaxe de operador

Para criar cálculos, você precisa entender os operadores compatíveis com o Tableau. Esta seção discute os operadores básicos que estão disponíveis e a ordem (precedência) que são executados.

Os operadores são coloridos em preto nos cálculos do Tableau.

+ (addition)

O operador + significa adição quando aplicado a números, e concatenação quando aplicado a cadeias de caracteres. Quando aplicado a datas, pode ser usado para adicionar um número de dias a uma data. Por exemplo:

7 + 3

Profit + Sales

'abc' + 'def' = 'abcdef'

#April 15, 2004# + 15 = #April 30, 2004#

– (subtraction)

O operador - significa subtração quando aplicado a números e negação se aplicado a uma expressão. Quando aplicado a datas, pode ser usado para subtrair um número de dias de uma data. Por isso, também pode ser usado para calcular a diferença em dias entre duas datas. Por exemplo:

7 - 3

Profit - Sales

-(7+3) = -10

#April 16, 2004# - 15 = #April 1, 2004#

#April 15, 2004# - #April 8, 2004# = 7

* (multiplication)

O operador * significa uma multiplicação numérica. Por exemplo, 5 * 4 = 20.

/ (division)

O operador / significa uma divisão numérica. Por exemplo, 20 / 4 = 5.

% (modulo)

O operador % retorna o resto de uma operação de divisão. Por exemplo, 9 % 2 retorna 1, porque 2 cabe quatro vezes no 9, com um resto de um. O módulo somente pode operar em inteiros.

==, =, >, <, >=, <=, !=, <>(comparações)

Esses são operadores de comparação básicos que podem ser usados em expressões. Seus significados são os seguintes: == ou = (igual a), > (maior que), < (menor que), >= (maior que ou igual a), <= (menor que ou igual a), != e <> (diferente de).

Cada operador compara dois números, datas ou cadeias de caracteres e retorna TRUE, FALSE ou NULL.

^ (potência)

Esse símbolo é equivalente à função POWER. Ele eleva o número à potência especificada.

Por exemplo:

6^3 = 216

AND

Esse é um operador lógico. Uma expressão ou um booliano deve aparecer em um dos lados dele. Por exemplo:

IIF(Profit =100 AND Sales =1000, "High", "Low")

Se ambas as expressões forem TRUE (isto é, não for FALSE ou NULL), 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 for 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.

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.

OR

Esse é um operador lógico. Uma expressão ou um booliano deve aparecer em um dos lados dele. Por exemplo:

IIF(Profit =100 OR Sales =1000, "High", "Low")

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 no qual o resultado de uma comparação OR for 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.

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.

NOT

Esse é um operador lógico. Pode ser usado para negar outro booliano ou uma expressão. Por exemplo:

IIF(NOT(Sales = Profit),"Not Equal","Equal")

Precedência do operador

Todos os operadores em um cálculo são avaliados em uma ordem específica. Por exemplo, 2*1+2 é igual a 4, não igual a 6, porque a multiplicação e feita antes da adição (o operador * sempre é avaliado antes do operador +).

Se dois operadores tiverem a mesma precedência (como adição e subtração (+ ou )), eles serão avaliados da esquerda para direita na fórmula.

Os parênteses podem ser usados para alterar a ordem de precedência. Consulte a seção Parênteses para obter mais informações.

PrecedênciaOperador
1– (negar)
2^ (potência)
3*, /, %
4+, –
5==, >, <, >=, <=, !=
6NOT
7AND
8OR

Parênteses

Os parênteses podem ser usados conforme necessário para alterar a ordem de precedência das operações. Os operadores que aparecem entre parênteses são avaliados antes dos que estão fora de parênteses, a partir dos parênteses mais internos e seguindo a partir daí.

Por exemplo,(1 + (2*2+1)*(3*6/3) ) = 31 porque os operadores nos parênteses mais internos são executados primeiro. O cálculo é realizado na seguinte ordem:

  1. (2*2+1) = 5
  2. (3*6/3) = 6
  3. (1+ 5*6) = 31

Sintaxe de expressão literal

Esta seção descreve a sintaxe adequada para usar expressões literais nos cálculos do Tableau. Uma expressão literal significa um valor constante que é representado “como está”. Ao usar funções, às vezes, você vai querer usar expressões literais para representar números, cadeias de caracteres, datas e muito mais.

Por exemplo, talvez haja uma função em que sua entrada é uma data. Em vez de digitar “May 1, 2005” (1º de maio de 2005), que seria interpretado como uma cadeia de caracteres, você digitaria #May 1, 2005#. Isso é equivalente a usar uma função de data para converter o argumento de uma cadeia de caracteres para uma data (consulte Funções de data).

Você pode usar literais numéricos, de cadeia de caracteres, data, booliano e nulo nos cálculos do Tableau. Cada tipo, e como formatá-lo, está descrito abaixo.

As expressões literais são coloridas de preto e cinza nos cálculos do Tableau.

Literais numéricos

Os literais numéricos são escritos como um número. Por exemplo, para inserir o número um como um literal numérico, digite 1. Se quiser inserir o número 0,25 como um literal numérico, digite 0.25.

Literais de cadeia de caracteres

Um literal de cadeia de caracteres pode ser escrito com o uso de aspas simples ou duplas. Se a sua cadeia de caracteres tiver aspas simples ou duplas, simplesmente digite o símbolo duas vezes. Por exemplo, para inserir a cadeia de caracteres como um literal numérico, digite 'cat' ou "cat".

Além disso, se quiser digitar a cadeia de caracteres “She’s my friend.” como um literal de cadeia de caracteres, digite 'She’s my friend.' ou "She’s my friend."

Literais de data

Os literais de data são indicados pelo sinal (#). Para inserir a data “22 de agosto de 2005” como uma data literal, digite a data no formato ISO #2005-08-22#.

Literais boolianos

Os literais boolianos são escritos como true ou false. Para inserir “true” como um literal booliano, digite true.

Literais nulos

Os literais nulos são escritos como null. Para inserir “Null” como um literal booliano, digite Null.

Adicionar parâmetros a um cálculo

Parâmetros são variáveis de espaço reservado que podem ser inseridas em cálculos para substituir valores constantes. Quando você usa um parâmetro no cálculo, é possível, então, expor um controle de parâmetro em uma exibição ou painel para permitir que os usuários alterem dinamicamente o valor.

Para obter detalhes, consulte Usar um parâmetro em um cálculo.

Os parâmetros são coloridos em roxo nos cálculos do Tableau.

Observação: não é possível criar parâmetros durante a edição de uma exibição na Web.

Adicionar comentários a um cálculo

É possível adicionar comentários a um cálculo para fazer observações sobre o mesmo ou suas partes. Os comentários não são incluídos na computação do cálculo.

Para adicionar um comentário em um cálculo, digite duas barras (//) .

Por exemplo:

SUM([Sales])/SUM([Profit]) //John’s calculation

Neste exemplo, //cálculo do John é um comentário.

Um comentário inicia nas duas barras (//) e se estende até o final da linha. Para prosseguir com o cálculo, é necessário iniciar uma nova linha.

Um comentário de várias linhas pode ser escrito iniciando-o com uma barra seguida por um asterisco (/*) e encerrando-o com um asterisco seguido por uma barra (*/). Por exemplo:

SUM([Sales])/SUM([Profit]) /* John's calculation
To be used for profit ratio
Do not edit */

Os comentários são coloridos em cinza nos cálculos do Tableau.

Entendendo os tipos de dados nos cálculos

O Tableau oferece suporte para os tipos de dados string, date/datetime, number e boolean. Se você criar campos calculados, deverá saber como usar e combinar os diferentes tipos de dados em cálculos. Muitas funções que estão disponíveis durante a definição de um cálculo funcionam somente quando aplicadas a tipos de dados específicos.

Por exemplo, a função DATEPART() pode aceitar apenas um tipo de dados date/datetime como um argumento. Você pode inserir DATEPART('year',#2004-04-15#) e esperar um resultado válido: 2004. Não possível inserir DATEPART('year',"Tom Sawyer") e esperar um resultado válido. Na verdade, esse exemplo retorna um erro porque "Tom Sawyer" é uma cadeia de caracteres, e não uma data/hora.

Observação: embora o Tableau tente validar completamente todos os cálculos, alguns erros de tipos de dados só serão encontrados quando a consulta for executada em relação ao banco de dados. Os problemas aparecem como caixas de diálogo de erro no momento da consulta, em vez de na caixa de diálogo de cálculo.

Os tipos de dados com suporte do Tableau são descritos abaixo. Consulte Conversão de tipo para saber como converter de um tipo de dados em outro.

STRING

Uma sequência de zero ou mais caracteres. Por exemplo, "Wisconsin", "ID-44400" e "Tom Sawyer" são todas cadeias de caracteres. Os tipos de dados string são reconhecidos por aspas simples ou duplas. O caractere de aspa em si pode ser incluído em uma cadeia de caracteres por meio de sua repetição. Por exemplo, ‘O''Hanrahan’.

DATE/DATETIME

Um tipo de dados date ou datetime. Por exemplo, "January 23, 1972" ou "January 23, 1972 12:32:00 AM". Se você quiser que uma data escrita em estilo longo seja interpretada como date/datetime, coloque o sinal # em um dos lados dela. Por exemplo, “January 23, 1972” é tratado como um tipo de dados string, mas #January 23, 1972# é tratado como um tipo de dados date/datetime.

NUMBER

Os valores numéricos no Tableau podem ser inteiros ou números de ponto flutuante.

Com números 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 um campo de números que deveria 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. É possível eliminar essa possível distração ao formatar o número para mostrar menos casas decimais. Para obter mais informações, consulte Funções do Tableau (por categoria)(O link abre em nova janela) e selecione Números.

Operações que testam os valores de ponto flutuante para a igualdade podem se comportar de forma imprevisível, pelo mesmo motivo. Tais comparações podem ocorrer ao usar expressões com nível de detalhes, como dimensões, na filtragem categórica, a criação de grupos ad-hoc, criando definições de ENTRADA/SAÍDA e com a combinação de dados.

Observação: O maior inteiro de 64 bits assinado é 9.223.372.036.854.775.807. Ao conectar-se a uma nova fonte de dados, qualquer coluna com um tipo de dados definido para Número (inteiro), pode incluir valores até esse limite; para valores maiores, como Número (inteiro) não usa pontos flutuantes, o Tableau exibe "Nulo". Quando o tipo de dados é definido para Número (decimal), os valores maiores podem ser acomodados.

BOOLEAN

Um campo que contém os valores TRUE ou FALSE. Um valor desconhecido surge quando o resultado de uma comparação é desconhecido. Por exemplo, a expressão 7 > Null gera desconhecido. Os boolianos desconhecidos são convertidos automaticamente em Null.

Consulte também

Como entender os cálculos no Tableau

Criar um campo calculado simples

Introdução a cálculos no Tableau

Agradecemos seu feedback!