Funções de dimensão calculada
Você pode usar Funções ao criar dimensões calculadas.
Edições obrigatórias
| Disponível em: Relatórios de inteligência avançados |
As funções são divididas nestas categorias:
- Funções de número
- Funções de texto
- Funções de data
- Funções de agregação
- Funções lógicas
- Conversão de tipo
- Funções de conteúdo
As seguintes tabelas resumem as funções disponíveis para dimensões calculadas.
| Nome da função | Sintaxe | Descrição |
|---|---|---|
| ABS | ABS(number) | Retorna o valor absoluto de um número. |
| CEILING | CEILING(number, significance) | Arredonda o número para cima, longe de zero, para a significância múltipla mais próxima. |
| FLOOR | FLOOR(number, significance) | Arredonda o número para baixo em direção a zero, para a significância múltipla mais próxima. |
| RAND | RAND() | Obtém um número aleatório entre 0 e 1. |
| ROUND | ROUND(number) | Arredonda um número para o número integral mais próximo. |
| ROUND | ROUND(number, num_digits) | Arredonda um número para um número especificado de dígitos. |
| Nome da função | Sintaxe | Descrição |
|---|---|---|
| CHAR | CHAR(number) | Retorna um caractere especificado por um número. |
| COALESCE | COALESCE([value1, value2,...]) | Retorna o primeiro valor da lista que não está vazio. |
| CODE | CODE(text) | Retorna um código numérico para o primeiro caractere em uma string de texto. |
| COUNT_CHAR | COUNT_CHAR(text, charToCount) | Conta quantas vezes um caractere específico aparece em um texto. |
| EXTRACT | EXTRACT(text, delimiter, position) | Extrai do texto definido a substring na posição determinada após a divisão pelo delimitador definido. Por exemplo, EXTRACT('a,b,c','_',1) retorna 'b'. |
| FIND | FIND(findText, withinText) | Retorna a posição inicial do findText withinText. Retorna -1 se withinText não contiver findText. |
| FUZZYMATCH | FUZZYMATCH(valueToMatch, array, threshold) | Pesquisa uma string em uma matriz de valores que potencialmente combinam usando algoritmos de detecção duplicada que calculam a similaridade de dois fluxos de dados. Retornará a string correspondente da matriz se houver uma correspondência; se não houver correspondência, retornará uma string vazia. Por exemplo, FUZZYMATCH("ABC Company",{"ABC Company Inc","Apple Inc","IBM Company"},0.8) retorna "ABC Company Inc". O parâmetro de limite deve ter um valor entre 0 e 1. Um limite de 1 significa uma correspondência exata. |
| GET_EXCHANGE_RATE | GET_EXCHANGE_RATE(date, fromISO, toISO) | Obtém a taxa de câmbio para as moedas e a data especificadas. A variável de "date" na fórmula pode ser um campo de data mapeado ou uma função de data Por exemplo:
em que [Day] é um campo de data mapeado
em que DATE('YYYY','MM','DD') é uma função de data.
em que YESTERDAY() é uma função de data. |
| INDEXOF | INDEXOF(array, findText) | Pesquisa a matriz para o item especificado e retorna sua posição. Retorna -1 se o item não for encontrado. Se o item estiver presente mais de uma vez, a função INDEXOF retornará a posição da primeira ocorrência. Por exemplo, INDEXOF(csv['row'], 'Campaign ID') == 0 retornará true se 'Campaign ID' for encontrado na primeira célula. Nota: O primeiro item tem a posição 0, o segundo item tem a posição 1, e assim por diante. |
| ISEMPTY | ISEMPTY(value) | Retorna se o valor estiver vazio ou não. |
| LEFT | LEFT(text, numOfChars) | Retorna o número de caracteres solicitado da esquerda. |
| LEN | LEN(text) | Retorna o número de caracteres no texto especificado |
| LOWER | LOWER(text) | Converte todas letras maiúsculas em uma string em letras minúsculas. |
| MATCH | MATCH(valueToMatch, array) | Pesquisa um item especificado em uma matriz de valores e retorna um resultado booleano. Por exemplo, MATCH(1,{1,2,3}) retorna true porque o valor '1' existe na matriz. |
| PROPER | PROPER(text) | Coloca em maiúscula a primeira letra em uma string de texto e todas as outras letras no texto que seguem qualquer caractere que não seja uma letra. Converte todas as outras letras em minúsculas. |
| REPLACE | REPLACE(SourceStr, pattern, targetStr) | Substitui cada correspondência de um padrão ( uma expressão regex) em sourceStr por targetStr. Por exemplo, REPLACE('All-The-Best', '-', ' ') retorna 'All The Best'. Em outro exemplo, REPLACE('Let It Be','\\s','-') retorna 'Let-It-Be'. |
| RIGHT | RIGHT(text, numOfChars) | Retorna o número de caracteres solicitado da direita. |
| SELECT | SELECT(sourceStr, pattern) | Seleciona a primeira correspondência do padrão (uma expressão regex) em sourceStr. Por exemplo, SELECT('Hello B wow E Goodbye', 'B(.*?)E') retorna 'B wow E'. |
| SENTIMEN | SENTIMEN(text) | Extrai um sentimento positivo, neutro ou negativo do texto especificado. |
| SPLIT | SPLIT(text, delimiter) | Divide uma string de texto em uma matriz usando um caractere delimitador. Retorna uma matriz de base zero unidimensional que contém as partes da string de texto original. Por exemplo, SPLIT('a,b,c', ',') retorna uma matriz com três itens. |
| SUBSTITUTE | SUBSTITUTE(text,oldText,newText) | Substitui newText por oldText em uma string de texto. Use SUBSTITUTE quando você deseja substituir texto específico em uma string de texto. |
| SUBSTRING | SUBSTRING(text,beginIndex,endIndex) | Retorna a substring do texto começando em beginIndex (incluindo) e terminando em endIndex (excluindo). |
| TRIM | TRIM(text) | Remove todos os espaços do texto, exceto por espaços simples entre palavras. |
| UPPER | UPPER(text) | Converte todas as letras minúsculas em uma string de texto em maiúsculas. |
| URL_DECODE | URL_DECODE(text) | Decodifica uma string application/x-www-form-urlencoded usando um esquema de codificação UTF-8. |
| URL_ENCODE | URL_ENCODE(text) | Traduz um texto para um formato application/x-www-form-urlencoded usando um esquema de codificação UTF-8. |
| VALUE_FROM_JSON | VALUE_FROM_JSON(JSON string, key) | Retorna o valor de uma chave atribuída em uma string JSON. Se a chave não existir ou o JSON estiver vazio, uma string vazia será retornada. |
| Nome da função | Sintaxe | Descrição |
|---|---|---|
| DATE | DATE(year, month) | Retorna o primeiro dia do mês no ano informado. |
| DATE | DATE(year, month, day) | Retorna a data que representa os critérios especificados. |
| DATEADD | DATEADD(interval, number, date) | Retorna a data após um intervalo de data ou hora específico ser adicionado. O intervalo deve ser um dos seguintes: 'yyyy' (ano), 'q' (trimestre), 'm' (mês), 'd' (dia), 'ww' (semana), 'h' (hora), 'n' (minuto) ou 's' (segundo). |
| DATEDIFF | DATEDIFF(interval,startDate,endDate) | Retorna o número de unidades de tempo especificadas pelo intervalo entre startDate e endDate. Os argumentos startDate e endDate devem ser objetos de data ou strings de data no formato padrão. O intervalo deve ser um dos seguintes: 'yyyy' (ano), 'q' (trimestre), 'm' (mês), 'd' (dia), 'ww' (semana), 'h' (hora), 'n' (minuto) ou 's' (segundo). |
| DAYPRECISION | DAYPRECISION(date) | Retorna a data fornecida com precisão de dia, o que significa que os campos de horas, minutos e segundos estão todos definidos como 0. Por exemplo, a data "12-Jun-2012 16:34" é convertida em "12-Jun-2012 00:00". |
| DAYSBETWEEN | DAYSBETWEEN(startDate, endDate) | Retorna o número de dias entre a startDate e a endDate definidas. Os argumentos devem ser objetos de data ou strings de data no formato padrão. |
| DAYSINMONTH | DAYSINMONTH(date) | Retorna o número de dias em um mês especificado. |
| NETWORKDAYS | NETWORKDAYS(startDate, endDate) | Retorna o número de dias úteis entre duas datas, excluindo fins de semana. Os argumentos devem ser objetos de data ou strings de data no formato padrão. |
| NOW | NOW() | Retorna a data e a hora do sistema atual. |
| SETHOUR | SETHOUR(date, hour) | Retorna o conjunto de datas informado com as horas informadas, sendo as horas um valor numérico de 0 a 23. |
| TODAY | TODAY() | Retorna a data do sistema atual. |
| TOSECONDS | TOSECONDS(duration) | Retorna o número de segundos representado pela string de duração informada, com formato HH:mm:ss/HH:mm:ss.SSS. |
| YESTERDAY | YESTERDAY() | Retorna a data do sistema de ontem. |
| Nome da função | Sintaxe | Descrição |
|---|---|---|
| GROUPCONCAT | GROUPCONCAT(groupedDimension, keyDimension, separator) | Concatena os valores de groupedDimension por keyDimension com a string separadora entre cada dois valores agrupados. Esse processo é feito de modo exclusivo, ou seja, o mesmo valor repetido não é concatenado duas vezes. Por exemplo, GROUPCONCAT({Media Buy Name}, {Campaign Name}, ',' ) resulta em todos os nomes de compra de mídia concatenados (sem repetições) para cada campanha. |
| Nome da função | Sintaxe | Descrição |
|---|---|---|
| E | AND(condition1, condition2) | AND lógico, verifica se ambas as condições são true. |
| IF | IF(condition,resultifTrue,resultifFalse) | Retorna o segundo argumento, se o primeiro argumento for verdadeiro; caso contrário, retorna o terceiro argumento. |
| IFERROR | IFERROR(someExpression, number) | Retorna someExpression se for um número válido, em caso contrário, número. |
| NOT | NOT(condition) | NOT lógico, reverte a lógica de seu argumento, true se torna false e vice-versa. |
| OR | OR(condition) | OR lógico, verifica se uma das condições é true. |
| Nome da função | Sintaxe | Descrição |
|---|---|---|
| COMPRESS | COMPRESS(value1) | Compacta uma string usando gzip e a retorna em base64. |
| DECODE_BASE64 | DECODE_BASE64(value1) | Decodifica uma string de base64. |
| DOUBLE | DOUBLE(value1) | Converte uma string em um dobro. |
| ENCODE_BASE64 | ENCODE_BASE64(value1) | Codifica uma string em base64. |
| FORMATDATE | FORMATDATE(date, pattern) | Retorna a representação da string da data informada conforme o padrão fornecido. Por exemplo, 'yyyy-MM-dd' --> 2014-02-25, 'dd MMM-yyyy' --> 25 Feb-2014 etc. |
| FORMATDATE_DEFAULT | FORMATDATE_DEFAULT(date) | Retorna a representação de string de Relatórios de inteligência padrão (yyyy-MM-dd HH:mm:ss.S) da data informada. |
| MD5 | MD5(stringToHash) | Retorne um hash MD5 da string informada. |
| NUMBER | NUMBER(value1) | Converte uma string em um número |
| PARSEDATE | PARSEDATE(dateString, pattern) | Retorna o objeto de data especificado pela dateString informada usando o padrão informado. Por exemplo, '2014-02-25' ---> 'yyyy-MM-dd', '25 Feb-2014' ---> 'dd MMM-yyyy' etc. |
| SHA256 | SHA256(stringToHash) | Retorne um hash SHA256 da string informada. |
| STRIP_HTML | STRIP_HTML(value1) | Remove o HTML de uma string. |
| UNCOMPRESS | UNCOMPRESS(value1) | Descompacta uma string base64 usando gzip. |
| Nome da função | Sintaxe | Descrição |
|---|---|---|
| CONTEXT_DIMENSION_CONTAINS | CONTEXT_DIMENSIONS_CONTAIN(dimension) | Retorna um valor "true" se a dimensão especificada estiver incluída na consulta. |
| CONTEXT_DIMENSION_EQUALS | CONTEXT_DIMENSIONS_EQUALS(dimension) | Retorna um valor "true" se as dimensões dadas forem exatamente iguais às dimensões do contexto. Insira todas as dimensões relevantes, mas a ordem de exibição não é importante. |
| FilterEndDate | FilterEndDate() | Retorna a data de término do filtro de consulta. |
| FilterStartDate | FilterStartDate() | Retorna a data de início do filtro de consulta. |
| GET_ENV | GET_ENV(variableName) | Retorna o valor para a variável ambiente especificada. Valores possível para variableName são: WORKSPACE_ID |
| QUERY_DIMENSIONS_CONTAIN | QUERY_DIMENSIONS_CONTAIN(dimension) | Retorna um valor "true" se a dimensão informada for uma das dimensões de consulta. |
| QUERY_DIMENSIONS_EQUAL | QUERY_DIMENSIONS_EQUAL([dimensions]) | Retorna um valor "true" se as dimensões da questão forem exatamente iguais às dimensões da consulta. Insira todas as dimensões relevantes, mas a ordem de exibição não é importante. |
Este artigo resolveu seu problema?
Diga-nos para podermos melhorar!
