As funções de cálculo do Tableau Prep permitem usar campos calculados para criar novos dados usando dados que já existem na sua fonte de dados.
Funções de número
| Sintaxe | Descrição |
|---|---|
ABS(number) | Retorna o valor absoluto do número especificado. Exemplos:
|
ACOS(number) | Retorna o arco cosseno do número especificado. O resultado é em radianos. Exemplo:
|
ASIN(number) | Retorna o arco seno de um número especificado. O resultado é em radianos. Exemplo:
|
ATAN(number) | Retorna o arco tangente de um número especificado. O resultado é em radianos. Exemplo:
|
ATAN2(y number, x number) | Retorna o arco tangente de dois números especificados (x e y). O resultado é em radianos.Exemplo:
|
CEILING(number) | Arredonda um número para o inteiro mais próximo de valor maior ou igual. Exemplo:
|
COS(number) | Retorna o cosseno de um ângulo. Especifica o ângulo em radianos. Exemplo:
|
COT(angle) | Retorna a cotangente de um ângulo. Especifica o ângulo em radianos. Exemplo:
|
DIV(integer1, integer2) | Retorna a parte inteira de uma operação de divisão, na qual o integer1 é dividido pelo integer2.Exemplo:
|
EXP(number) | Retorna e elevado à potência do número especificado. Exemplos:
|
FLOOR(number) | Arredonda um número para o inteiro mais próximo de valor menor ou igual. Exemplo:
|
HEXBINX(number, number) | 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. Exemplo:
|
HEXBINY(number, number) | 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(number) | Retorna o algoritmo natural de um número. Retorna Null se o número for menor que ou igual a 0. Exemplo:
|
LOG(number [, base]) | Retorna o algoritmo de um número para a base especificada. Se o valor de base for omitido, a base 10 será usada. Exemplo:
|
MAX(number, number) | Retorna o máximo de dois argumentos, que devem ser do mesmo tipo. Retorna Null se algum argumento for Null. MAX também pode ser aplicada a um único campo em um cálculo agregado.Exemplos:
|
MIN(number, number) | Retorna o mínimo de dois argumentos, que devem ser do mesmo tipo. Retorna Null se algum argumento for Null. MIN também pode ser aplicada a um único campo em um cálculo agregado.Exemplos:
|
PI( ) | Retorna o pi da constante numérica: 3.14159. Exemplo:
|
POWER(number, power) | Eleva o número à potência especificada. Exemplos:
Também é possível usar o símbolo ^:
|
RADIANS(number) | Converte o número especificado de graus em radianos. Exemplo:
|
ROUND(number, [decimals]) | Arredonda os números para um número de dígitos especificado. O argumento de decimais especifica quantos pontos decimais de precisão são necessários incluir no resultado final. Se os decimais forem omitidos, o número será arredondado para o inteiro mais próximo. Exemplo: Este exemplo arredonda cada valor de Vendas para um número inteiro:
|
SIGN(number) | 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(number) | Retorna o seno de um ângulo. Especifica o ângulo em radianos. Exemplos:
|
SQRT(number) | Retorna a raiz quadrada de um número. Exemplo:
|
SQUARE(number) | Retorna o quadrado de um número. Exemplo:
|
TAN(number) | Retorna a tangente de um ângulo. Especifica o ângulo em radianos. Exemplo:
|
ZN(expression) | 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ções de cadeia de caracteres
| Sintaxe | Descrição |
|---|---|
ASCII(string) | Retorna o código ASCII do primeiro caractere de uma cadeia de caracteres. Exemplo:
|
CHAR(number) | Retorna o caractere codificado pelo número de código ASCII. Exemplo:
|
CONTAINS(string, substring) | Retornará true se a cadeia de caracteres determinada contiver a subcadeia de caracteres especificada. Exemplo:
|
ENDSWITH(string, substring) | Retornará true se a cadeia de caracteres determinada terminar com a substring especificada. Espaços em branco à direita são ignorados.Exemplo:
|
FIND(string, substring, [start]) | Retorna a posição de índice de uma substring em uma cadeia de caracteres, ou 0 se a subcadeia de caracteres não for encontrada. Se o argumento de iniciar opcional for adicionado, a função ignora quaisquer instâncias de substring que aparecem antes do início da posição do índice. O primeiro caractere na cadeia de caracteres está na posição 1.Exemplos:
|
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 Exemplo:
|
ISDATE(string) | Retornará true se uma determinada cadeia de caracteres for uma data válida. Exemplo:
|
LEFT(string, number) | Retorna o número de caracteres na extremidade esquerda na cadeia de caracteres. Exemplo:
|
LEN(string) | Retorna o comprimento da cadeia de caracteres. Exemplo:
|
LOWER(string) | Retorna cadeia de caracteres, com todos os caracteres maiúsculos. Exemplo:
|
LTRIM(string) | Retorna a cadeia de caracteres com os espaços à esquerda removidos. Exemplo:
|
(MID(string, start, [length]) | Retorna a cadeia de caracteres que começa no início da posição de índice. O primeiro caractere na cadeia de caracteres está na posição 1. Se o comprimento de argumento opcional for adicionado, a cadeia de caracteres retornada incluirá apenas esse número de caracteres. Exemplos:
|
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:
|
REGEXP_EXTRACT(string, pattern) | Retorna uma subcadeia de caracteres da cadeia de caracteres fornecida que corresponde ao grupo de captura dentro do padrão de expressão regular. O padrão de expressão regular requer exatamente um grupo de captura Exemplo:
|
REGEXP_EXTRACT_NTH(string, pattern, index) | Retorna uma subcadeia de caracteres da cadeia de caracteres fornecida usando o padrão de expressão regular. A subcadeia é comparada com o grupo de captura nth, onde n é o índice dado. Exemplo:
|
REGEXP_MATCH(string, pattern) | Retorna true se uma subcadeia de caracteres de uma cadeia de caracteres fornecida corresponder ao padrão de expressão regular. Exemplo:
|
REGEXP_REPLACE(string, pattern, replacement) | Retorna uma cópia da cadeia de caracteres fornecida onde o padrão correspondente é substituído pela cadeia de caracteres de substituição. Exemplo:
|
REPLACE(string, substring, replacement) | Procura uma cadeia de caracteres para uma subcadeia de caracteres e substitui. Se a subcadeia de caracteres não for encontrada, a string não será alterada. Exemplo:
|
RIGHT(string, number) | Retorna o número de caracteres na extremidade direita na cadeia de caracteres. Exemplo:
|
RTRIM(string) | Retorna cadeia de caracteres com os espaços à direita removidos. Exemplo:
|
SPACE(number) | Retorna uma cadeia de caracteres composta por um número especificado de espaços repetidos. Exemplo:
|
SPLIT(string, delimiter, token number)
| Retorna uma subcadeia de caracteres de uma cadeia de caracteres, conforme determinado por um delimitador que extrai os caracteres do início ou do fim da cadeia de caracteres. Exemplo:
|
STARTSWITH(string, substring) | Retorna true se a cadeia de caracteres começa com substring. Espaços em branco à esquerda são ignorados.Exemplo:
|
TRIM(string) | Retorna a cadeia de caracteres com os espaços à esquerda e à direita removidos. Exemplo:
|
UPPER(string) | Retorna string, com todos os caracteres maiúsculos. Exemplo:
|
Funções de agregação
| Sintaxe | Descrição |
|---|---|
AVG(expression) | 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 Exemplo;
|
COUNT(expression) | Retorna o número de itens em um grupo. Os valores Null não são contados. Exemplo:
|
COUNTD(expression) | Retorna o número de itens distintos em um grupo. Os valores NULL não são contados. Cada valor exclusivo é contado apenas uma vez. Exemplo:
|
MEDIAN(expression) | Retorna a mediana de uma única expressão. MEDIAN pode ser usada com campos numéricos apenas. Os valores nulos são ignorados. Exemplo:
|
PERCENTILE(expression, number) | Cálculo agregado que retorna o valor percentil da expressão fornecida correspondente ao número especificado. Os valores válidos para o número são de 0 a 1. PERCENTILE([expression], 0,50) sempre retornará o valor mediano na expressão. Exemplo:
|
STDEV(expression) | Retorna o desvio padrão de exemplo da expressão. Exemplo:
|
STDEVP(expression) | Retorna o desvio padrão de exemplo da expressão na janela. Exemplo:
|
SUM(expression) | 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. Exemplo:
|
VAR(expression) | Retorna a variação estatística de todos os valores na expressão atribuída com base em uma amostra da população. Exemplo:
|
VARP(expression) | Retorna a variação estatística de todos os valores na expressão atribuída com base na população inteira. Exemplo:
|
ZN(expression) | 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ções de conversão de tipo
| Sintaxe | Descrição |
|---|---|
DATE | Retorna uma data de acordo com um número, cadeia de caracteres ou expressão de data. Exemplo:
Observe que as aspas são obrigatórias. |
DATETIME(expression) | Retorna uma datetime de acordo com um número, cadeia de caracteres ou expressão de data. Exemplo:
Observe que as aspas são obrigatórias. |
FLOAT(expression) | Retorna um flutuante dada uma expressão de qualquer tipo. Essa função requer números não formatados, o que significa excluir vírgulas e outros símbolos. Exemplo:
|
INT(expression) | Retorna um número inteiro dada uma expressão. Essa função trunca os resultados para o inteiro mais próximo de zero. Exemplo:
|
MAKEDATE(year, month, day) | Retorna um valor de data composto por um ano mês e um dia do mês. Exemplo:
|
MAKEDATETIME(date, time) | Retorna um valor de data e hora de acordo com uma expressão de data e uma expressão de hora. Exemplo:
|
MAKETIME(hour, minute, second) | Retorna um valor de hora composto por minutos e segundos. Exemplo:
|
STR(expression) | Retorna uma cadeia de caracteres dada uma expressão. Exemplo:
Retorna todos os valores da medida Idade como cadeia de caracteres. |
Funções de data
| Sintaxe | Descrição |
|---|---|
DATEADD(date_part, interval, date) | Adiciona um incremento à data especificada e retorna a nova data. O incremento é definido pelo intervalo e pela data_parte. Exemplo:
|
DATEDIFF(date_part, start_date, end_date, [start_of_week]) | Retorna a diferença entre duas datas onde data_inicial é subtraída de data_final. A diferença é expressa em unidades de date_part. Se start_of_week for omitido, o dia de início da semana será determinado pelo dia de início configurado para a origem de dados. Exemplo:
|
DATENAME(date_part, date, [start_of_week]) | Retorna uma parte da data fornecida como uma cadeia de caracteres, onde a parte é definida por date_part. Se start_of_week for omitido, o dia de início da semana será determinado pelo dia de início configurado para a origem de dados. Exemplo:
|
DATEPARSE(format, string) | Converte uma cadeia de caracteres em uma data no formato especificado. Exemplo:
|
DATEPARTT(date_part, date, [start_of_week]) | Retorna uma parte da data fornecida como um inteiro onde a parte é definida por date_part. Se start_of_week for omitido, o dia de início da semana será determinado pelo dia de início configurado para a origem de dados. Exemplo:
|
DATETRUNC(date_part, date, [start_of_week]) | Trunca a data especificada na precisão definida por date_part e retorna a nova data. Se start_of_week for omitido, o dia de início da semana será determinado pelo dia de início configurado para a origem de dados. Exemplo:
|
DAY(date) | Retorna o dia da data especificada como um inteiro. Exemplo:
|
ISDATE(string) | Retornará true se uma determinada cadeia de caracteres for uma data válida. Exemplo:
|
MONTH(date) | Retorna o mês da data especificada como um inteiro. Exemplo:
|
NOW() | Retorna a data e a hora atuais. Exemplo:
|
TODAY() | Retorna a data atual. Exemplo:
|
YEAR(date) | Retorna o ano da data especificada como um inteiro. Exemplo:
|
Funções lógicas
| Sintaxe | Descrição |
|---|---|
IFNULL(expr1, expr2) | Retorna <expr1> se for não nulo, caso contrário, retorna <expr2>.Exemplo:
|
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(string) | Retornará true se uma determinada cadeia de caracteres for uma data válida. Exemplo:
|
ISNULL(expression) | Retorna true se a expressão não contiver dados válidos (Null).Exemplo:
|
ZN(expression) | 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ções analíticas
| Sintaxe | Descrição |
|---|---|
LAST_VALUE(expression, [return_last_non-null_value]) | Retorna o último valor da expressão especificada a partir da primeira linha na partição para a linha atual. Aceita um segundo parâmetro booliano opcional para retornar o último valor não nulo. Exemplo:
|
LOOKUP(expression, [offset]) | Retorna o valor da expressão especificada em uma linha de destino, especificada como uma compensação relativa da linha atual. Retornará NULL se a linha de destino não puder ser determinada. O parâmetro [ Exemplo:
Retorna o valor SALES da linha anterior. |
NTILE(number) | Distribui linhas em uma partição selecionada em um número especificado de grupos ou blocos. Com esta função o conjunto de valores (6,9,9,14) distribuídos por 3 peças seria atribuído às peças (1,2,2,3) em ordem crescente. Exemplo:
|
RANK() | 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. Exemplo:
|
RANK_DENSE() | 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. Exemplo:
|
RANK_MODIFIED() | 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. Exemplo:
|
RANK_PERCENTILE() | Retorna a posição na classificação percentil para a linha atual na partição. Exemplo:
|
ROW_NUMBER() | Retorna uma ID de linha sequencial exclusivo para cada linha. Exemplo:
|
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. Exemplo:
|
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:
|
Palavras-chave
| Função | Descrição |
|---|---|
AND | Executa uma conjunção lógica em duas expressões Exemplo:
|
ASC | Define a ordem crescente para operações ORDERBY .Exemplo
|
CASE | Encontra o primeiro <value> que corresponde <expr> e retorna ao <return> correspondente.Exemplo:
|
DESC | Define a ordem decrescente para operações ORDERBY . Exemplo:
|
ELSE | Testa uma série de expressões retornando o valor <then> para o primeiro <expr> true. Exemplo:
|
ELSEIF | Testa uma série de expressões retornando o valor <then> para o primeiro <expr> true. Equivale a colocar uma instrução if dentro de uma operação ELSE.Exemplo:
|
END | Encerra uma operação introduzida pela diretiva correspondente. Exemplo:
|
{ FIXED } | As expressões de nível de detalhe FIXED calculam valores usando as dimensões especificadas sem referência ao nível de detalhe da visualização. Exemplo:
|
IF | Criar declaração condicional (instruções IF) e permite que você execute somente se uma condição for True.Exemplo:
|
NOT | Executa uma negação lógica em uma expressão. Exemplo:
|
OR | Executa uma disjunção lógica em uma expressão. Exemplo:
|
{ ORDERBY } | Define a ordem de aplicação das funções analíticas. Use o argumento asc | desc opcional para especificar a ordem crescente ou decrescente para cada campo. Exemplo:
|
{ PARTITION } | Define o grupo para funções analíticas. ORDERBY deve estar dentro da partição. Exemplo:
|
THEN | Testa uma série de expressões retornando o valor <then> para o primeiro <expr> true. Exemplo:
|
WHEN | Encontra o primeiro <value> que corresponde expr> e retorna ao <return> correspondente. Exemplo:
|