Referência de funções do Tableau Prep
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 em uma amostra da população. 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:
|