Formatação de cálculos no Tableau
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.
- As funções exigem argumentos ou informações específicas. Dependendo da função, os argumentos podem ser campos, literais, parâmetros ou funções aninhadas.
- Campos: dimensões ou medidas da fonte de dados.
- Operadores: símbolos que denotam uma operação.
- Expressões literais: valores constantes codificados, como "Alto" ou 1.500.
Nem todos os cálculos precisam conter os quatro componentes. 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. Para obter mais informações parâmetros, consulte Criar parâmetros.
- Comentários: 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.
Exemplo de cálculo explicado
Por exemplo, considere o cálculo a seguir, que adiciona 14 dias a uma data ([Initial Visit]). Um cálculo como esse pode ser útil para encontrar automaticamente a data de um acompanhamento de duas semanas.
DATEADD('day', 14, [Initial Visit)
Os componentes deste cálculo podem ser detalhados em:
- Função:
DATEADD, que requer três argumentos.- date_part ('day')
- intervalo (14)
- data ([Initial Visit]).
- Campo: ([Initial Visit]).
- Operadores: n/a
- Expressões literais:
- Literal de cadeia de caracteres: 'day'
- Literal numérico: 14
Neste exemplo, a constante codificada 14 poderia ser substituída por um parâmetro que permitiria ao usuário selecionar quantos dias faltam para procurar uma consulta de acompanhamento.
DATEADD('day', [How many days out?], [Initial Visit)
Visão geral: sintaxe de cálculo
| Componentes | Sintaxe | Exemplo |
Funções | Consulte Funções do Tableau (em ordem alfabética)(O link abre em nova janela) ou Funções do Tableau (por categoria) para obter exemplos de como formatar funções no Tableau. |
|
Campos | Um campo em um cálculo está muitas vezes entre colchetes [ ]. Consulte Sintaxe de campo para obter mais informações. |
|
Operadores |
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. |
|
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 booleanos 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. |
|
Parâmetros | Um parâmetro em um cálculo deve estar entre colchetes [ ], como um campo. Consulte Criar parâmetros para obter mais informações. |
|
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. |
|
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.
Todas as funções no Tableau requerem uma sintaxe específica. Por exemplo, o cálculo a seguir usa duas funções, LEN e LEFT, bem como vários operadores lógicos (IF, THEN, ELSE, END e > ).
IF LEN([Name])> 5 THEN LEFT([Name],5) ELSE [Name] END
- LEN aceita um único argumento, como
LEN([Name])que retorna o número de caracteres (ou seja, o comprimento) para cada valor no campo Name. - LEFT aceita dois argumentos, um campo e um número, como
LEFT([Name], 5)que retorna os primeiros cinco caracteres de cada valor no campo Name, começando da esquerda. - Os operadores lógicos IF , THEN, ELSE e END trabalham juntos para criar um teste lógico.
Esse cálculo avalia o comprimento de um nome e, se tiver mais de cinco caracteres, retorna apenas os cinco primeiros. Caso contrário, ele retorna o nome completo.
No editor de cálculo, as funções tem a cor azul.
Use o painel de referência do editor de cálculo
É possível pesquisar como usar e formatar uma função específica a qualquer momento. Para abrir a lista de funções no Tableau:
- Selecione Análise > Criar campo calculado.
- No Editor de cálculo, clique no ícone de expansão (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 (
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 + 3Profit + Sales'abc' + 'def' = 'abcdef'#April 15, 2024# + 15 = #April 30, 2024#
– (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 - 3Profit - Sales-(7+3) = -10#April 16, 2024# - 15 = #April 1, 2024##April 15, 2024# - #April 8, 2024# = 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 restante de uma operação de divisão. O módulo somente pode operar em inteiros.
Por exemplo: 9 % 2 = 1. (Porque 2 cabe quatro vezes no 9, com um resto de 1.)
==, =, >, <, >=, <=, !=, <> (comparações)
Esses são operadores de comparação básicos que podem ser usados em expressões. Os significados são os seguintes:
- == ou = (igual a)
- > (maior que)
- < (menor que)
- >= (maior que ou igual a)
- <= (menor que ou igual a)
- != ou <> (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 booleano deve aparecer em um dos lados dele.
Por exemplo: IIF(Profit
=100 AND Sales =1000, "High", "Low")
Consulte AND em Funções lógicas para obter mais informações.
OR
Esse é um operador lógico. Uma expressão ou um booleano deve aparecer em um dos lados dele.
Por exemplo: IIF(Profit
=100 OR Sales =1000, "High", "Low")
Consulte OR em Funções lógicas para obter mais informações.
NOT
Esse é um operador lógico. Pode ser usado para negar outro booleano ou uma expressão. Por exemplo:
IIF(NOT(Sales
= Profit),"Not Equal","Equal")
Outros operadores
CASE, ELSE, ELSEIF, IF, THEN, WHEN e END também são operadores usados para Funções lógicas.
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ência | Operador |
|---|---|
| 1 | – (negar) |
| 2 | ^ (potência) |
| 3 | *, /, % |
| 4 | +, – |
| 5 | ==, =, >, <, >=, <=, !=, <> |
| 6 | NOT |
| 7 | AND |
| 8 | OR |
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:
- (2*2+1) = 5
- (3*6/3) = 6
- (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, booleano 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 sua cadeia de caracteres tiver aspas simples ou duplas, use a outra opção para os literais de string mais externos.
Por exemplo, para inserir a cadeia de caracteres "cat" como um literal de cadeia de caracteres, digite '"cat"'. Para 'cat' digite "'cat'". Se você quiser digitar a string She's my friend como uma cadeia de caracteres literal, use aspas duplas para os literais, como em "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 booleanos
Os literais booleanos são escritos como true ou false. Para inserir “true” como um literal booleano, digite true.
Literais nulos
Os literais nulos são escritos como null. Para inserir “Null” como um literal booleano, 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.
Os parâmetros são coloridos em roxo nos cálculos do Tableau.
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]) //My calculation
Neste exemplo, //My calculation é 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])
/* This calculation is
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
Se você criar campos calculados, deverá saber como usar e combinar os diferentes tipos de dados(O link abre em nova janela) 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',#2024-04-15#) e esperar um resultado válido: 2024. 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.
Cadeia de caracteres
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.
Número
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 ROUND em Funções de número disponíveis no Tableau.
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.
Booleano
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 booleanos desconhecidos são convertidos automaticamente em Null.
Consulte também
Como entender os cálculos no Tableau