MAQL

MAQL
Analytics
15/08/2016
Versão 2.0
Título do documento
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | São Paulo - Brasil
Sumário
1. O que é o MAQL? ............................................................................... 3
2. Usando MAQL ...................................................................................... 3
3. Categorias Funções ............................................................................ 3
3.1. Função Agregação ............................................................................ 4
3.2. Função Numérica ............................................................................... 7
3.3. Granularidade ................................................................................... 10
3.4. Expressões Lógicas ........................................................................... 13
3.5. Expressões de Filtro ........................................................................... 15
1. O que é o MAQL?
Multi-Dimensão Analytical Query Language (MAQL) é uma linguagem
proprietária para a criação de métricas em seus projetos. Usando MAQL, você
pode construir métricas flexíveis e poderosas para entregar percepções sem
precedentes para os usuários do seu projeto.
2. Usando MAQL
As métricas são usadas para a montagem de relatórios. Você pode criar
métricas básicas através do editor de relatório no Analytics, que converte as
suas seleções em declarações MAQL e armazena-os no projeto.
As possibilidades de construção de métricas são baseados na arquitetura do
modelo de dados (representação dos atributos e fatos nos dados do seu
projeto e as relações entre eles).
3. Categorias Funções
MAQL inclui uma variedade de funções, que podem ser aplicados aos fatos e
atributos de seu projeto.
3.1. Função Agregação
Calcula a média de um conjunto de fatos para formar
uma métrica.
SELECT AVG (...)
AVG/RUNAVG SELECT RUNAVG (…)
Exemplos:
SELECT AVG (salário pago)
SELECT RUNAVG (salário pago)
Coeficiente de correlação entre dois conjuntos de

valores.
CORREL
SELECT CORREL (..., ...)
Exemplo:
SELECT CORREL (Receita Bruta, a Receita Líquida)
Número de valores exclusivos em um atributo.
SELECT COUNT (...)

COUNT SELECT COUNT (..., ...)
Exemplo:
SELECT COUNT (empregado, registros de

Departamento)
Covariância entre dois conjuntos de factos ou valores

de métrica para populações de amostras.
Covariância entre dois conjuntos de factos ou valores

COVAR/COVARP de métrica para as populações tendenciosas.
SELECT COVAR (..., ...)
SELECT COVARP (..., ...)
Exemplo:
SELECT COVAR (salário pago, Receita de Vendas)
Calcula valores linha de tendência futuras usando

regressão linear.
FORECAST
FORECAST (..., numero de períodos)
Exemplo:
FORECAST (Vendas Média, 6)
MAX/RUNMAX Máximo de todos os valores de um fato ou métrica.
SELECT MAX (...)
SELECT RUNMAX (...)
Exemplos:
SELECT MAX (salário pago)
SELECT RUNMAX (salário pago)
MEDIAN Valor médio de todos os valores de um fato ou

métrica.
SELECT MEDIAN (...)
Exemplo:
SELECT MEDIAN (salário pago)
MIN/RUNMIN Mínima de todos os valores de um fato ou métrica.
SELECT MIN (...)
SELECT RUNMIN (...)
Exemplos:
SELECT MIN (salário pago)
SELECT RUNMIN (salário pago)
PERCENTILE Calcula o x percentagem de um conjunto de valores,
onde x é especificado como o segundo parâmetro.
SELECT PERCENTILE (... , x)
Exemplo:
SELECT PERCENTILE (receita de vendas, 0,75)
SELECT PERCENTILE (resolução Full Time, 90%)
RSQ O quadrado do coeficiente de correlação entre dois

conjuntos de valores.
SELECT RSQ (... , ...)
Exemplo:
SELECT RSQ (Receita Bruta, a Receita Líquida)
STDEV/RUNSTDEV O desvio padrão entre um conjunto de valores de

métrico fato ou com base numa amostra de população.
SELECT STDEV (...)
Exemplo:
SELECT STDEV (Receita de Vendas)
SUM/RUNSUM Soma de todos os valores de um fato ou métrica.
SELECT SUM (...)
SELECT RUNSUM (...)
Exemplos:
SELECT SUM (salário pago)
SELECT RUNSUM (salário pago)
VAR/RUNVAR Variância entre dois conjuntos de valores para uma

amostra da população.
SELECT VAR (...)
SELECT RUNVAR (...)
Exemplos:
SELECT VAR (salário pago)
SELECT RUNVAR (salário pago)
3.2. Função Numérica

Simples operadores aritméticos.
SELECT … - …
+, -, *, /
Exemplo:
SELECT Receitas - Despesas
Valor absoluto de um fato ou métrica.
ABS SELECT ABS (...)
Exemplo:
SELECT ABS (Receita)
Devolve a constante e elevado à

potência de um fato ou métrica.
EXP SELECT EXP (...)
Exemplo:
SELECT EXP (taxa anual)
Retorna um valor de substituição se o
fato ou, avalia métricas para um valor
NULL.
SELECT IFNULL (..., 0)
IFNULL Exemplos:
SELECT IFNULL ((preço , 0) * IFNULL

( Discount , 1)
SELECT IFNULL ((SELECT SUM ( Cost )

WHERE Cliente IN (João , Ana )), 0)
Calcula o logaritmo de um valor, dada a

base especificada no segundo
LOG/LN parâmetro.
Calcula o logaritmo natural de um

valor.
SELECT LOG (...)
SELECT LN (...)
Exemplos:
SELECT LOG (Valor [MIN] * 4, Valor

[MAX])
SELECT LN (SUM (Valor))
Retorna um fato ou métrico valor

elevado para o valor especificado no
POWER segundo parâmetro.
SELECT POWER (..., n)
Exemplos:
SELECT POWER (Receita, 2)
SELECT POWER (Receita, 1/12)
Retorna a posição numérica para fatos
ou valores de métrica em ascendente,
RANK descendente, padrão ou menor-
primeira ordem.
SELECT RANK (...)
Exemplo:
SELECT RANK (Valor)
SELECT RANK (Pagamento) DESC

WITHIN (Ano (Fechado))
Movimenta um fato ou métrica para o

número de casas decimais especificado
ROUND/FLOOR/CEILING/TRUNC no segundo parâmetro.
Movimenta um valor de entrada para o

número inteiro mais próximo que é
menor do que.
Movimenta um valor de entrada para o

número inteiro mais próximo que é
maior do que isso.
Trunca um número com base no

número de casas decimais especificado
no segundo parâmetro.
SELECT ROUND (...)
SELECT FLOOR (...)
SELECT CEILING (...)
SELECT TRUNC (...)
Exemplos:
SELECT ROUND (Custo)
SELECT FLOOR (-42,8)
SELECT CEILING (Receita)
SELECT TRUNC (preço, 2)
Retorna -1 para valores negativos, 0

para os valores zero, e 1 para valores
SIGN positivos.
SELECT SIGN (...)
Exemplo:
SELECT SIGN (Receita)
Retorna a raiz quadrada de um

valor. Os valores negativos gerar um
SQRT valor NULL.
SELECT SQRT (...)
Exemplo:
SELECT SQRT (Receita)
3.3. Granularidade
Bloqueia o nível de agregação do fato
ou métrica, conforme especificado pelo
atributo que está listado após BY.
BY SELECT … / (SELECT … BY … )
Exemplo:
SELECT Receitas /
(SELECT Receita BY Ano)
Bloqueia o nível de agregação do fato
ou métrica ao mais alto nível possível
de agregação na hierarquia de atributo.
BY ALL attributes SELECT … / (SELECT … BY ALL …)
Exemplo:
SELECT Pagamento BY ALL Ano
Bloqueia o valor do fato ou métrica ao

mais alto nível de agregação possível
em todas as dimensões.
SELECT … / (SELECT … BY ALL IN ALL

BY ALL IN ALL OTHER DIMENSIONS OTHER DIMENSIONS)
Exemplo:
SELECT Receita / (SELECT Receita BY

ALL IN ALL OTHER DIMENSIONS)
Bloqueia o nível de agregação para o

atributo ou atributo especificado após
a palavra-chave, e ao mais alto nível
para todas as outras dimensões.
BY Attr, ALL OTHER SELECT … / (SELECT … BY …, ALL IN ALL

OTHER DIMENSIONS)
Exemplo:
SELECT Receita / (SELECT Receita BY

Ano, ALL IN ALL OTHER DIMENSIONS)
Refere-se aos valores a partir do

próximo período de tempo
FOR Next/FOR Previous especificado como o parâmetro.
Refere-se aos valores do período de

tempo anterior especificado como o
parâmetro.
SELECT ... FOR Next (...)
SELECT ... FOR Previous (...)
Exemplos:
SELECT Receita FOR Next (trimeste)
SELECT Receita FOR Previous (Mês, 3)
Refere-se os valores a partir do

próximo período de tempo, como
FOR NextPeriod/FOR PreviousPeriod indicado pelo nível de atributo mais
granular no relatório.
Refere-se aos valores do período de

tempo anterior, tal como especificado
pelo nível de atributo mais granular no
relatório.
SELECT … FOR NextPeriod (…)
SELECT … FOR PreviousPeriod (…)
Exemplos:
SELECT Receita FOR NextPeriod (Mês)
SELECT Receita FOR PreviousPeriod

(Quarter)
Funciona como o ALL IN ALL outra

palavra-chave DIMENSIONSBY BY,
BY ALL IN ALL OTHER DIMENSIONS exceto para os atributos definidos,
EXCEPT (FOR) após exceto. A métrica é permitida
para ser cortado em cubos e por estes
atributos, contanto que estejam
presentes no relatório.
SELECT … BY ALL IN ALL OTHER

DIMENSIONS EXCEPT …
Exemplo:
SELECT Estimado BY ALL IN ALL OTHER
DIMENSIONS EXCEPT Data
Instantânea
Especifica um sub-grupo no relatório, o

que pode respeitar ou ignorar a
dimensionalidade relatório definido
por atributos relatório.
WITHIN
SELECT RANK(...) WITHIN (...)
Exemplo:
SELECT RANK(Receita) WITHIN

(Operação Fechar ano)
Isto especifica uma janela de

rolamento sobre o qual executando
ROWS BETWEEN funções totais (por exemplo RUNAVG)
são computados.
SELECT RUNAVG(…) ROWS BETWEEN 6

PRECEDING AND CURRENT ROW
Exemplo:
SELECT RUNAVG(Receita) ROWS

BETWEEN 6 PRECEDING AND CURRENT
ROW
3.4. Expressões Lógicas

Se ambas as expressões são verdadeiras,
então o resultado é verdadeiro.
AND
SELECT ... WHERE ... = ... AND … = ...
Exemplo:
SELECT Receita WHERE Ano = 2016 AND

Mês = Agosto
Declaração avalia uma série de condições

especificadas após uma QUANDO palavra-
chave. A primeira condição que é avaliada
como verdadeira força a expressão para
retornar o resultado especificado após a
palavra-chave correspondente e em
seguida.
CASE SELECT CASE WHEN … > … THEN 1, WHEN

… < … THEN 2 ELSE 3 END
Exemplo:
SELECT CASE WHEN tipo de atividade IN

( e-mail , em pessoa ) THEN 1, WHEN tipo
de atividade IN ( telefone , VOIP ) THEN 2
ELSE 0 END
Declaração avalia a condição especificada

após IF. Se o resultado for verdadeiro, o
valor expresso depois, então é devolvido.
SELECT IF … > 0.5 THEN … * 10 ELSE … / 10

IF / THEN / ELSE END
Exemplo:
SELECT IF Probabilidade > 0,5

THEN Valor * 10 ELSE Montante / 10 END
A expressão é avaliada, o valor booleano

oposto é retornado. Se a expressão for
verdadeira, então o resultado é falso, e
NOT vice-versa.
SELECT … WHERE NOT (… = …)
Exemplo:
SELECT Receita WHERE NOT (Ano = 2006)
Se qualquer expressão for verdadeira,

então o resultado é verdadeiro.
OR
SELECT ... WHERE ... = ... OR ... = ...
Exemplo:
SELECT
Receita WHERE Ano = 2014 OR Ano = 2016
3.5. Expressões de Filtro

Um operador de filtragem que inclui
apenas um único valor de atributo de
interesse. Ele também pode ser usado
para definir a condição do filtro, onde
dois atributos têm o mesmo valor.
Um operador de filtragem que exclui

um valor único atributo. Este operador
também pode ser utilizado para definir
a condição do filtro, onde dois
atributos têm valores diferentes.
= (equals), <> (does not equal), >
SELECT ... WHERE ... = ...
(greater), < (less), >= (greater or
equal), <= (less or equal) SELECT … WHERE … <> …
SELECT … WHERE … > …
SELECT … WHERE … < …
SELECT … WHERE … >= …
SELECT … WHERE … <= …
Exemplos:
SELECT Receita WHERE Ano <> 2006
SELECT Receita WHERE Quarter =
Anterior
Calcula métrica para valores de entrada

entre um intervalo especificado,
incluindo ou excluindo endpoints.
Calcula métrica para valores de entrada

fora de um intervalo especificado,
incluindo ou excluindo endpoints.
SELECT … WHERE … BETWEEN … AND

…
BETWEEN/NOT BETWEEN
SELECT … WHERE … NOT BETWEEN …
AND …
Exemplos:
SELECT Receita WHERE Ano BETWEEN

2001 AND 2006
SELECT Receita WHERE Ano NOT

BETWEEN 2001 AND 2006
Calcula filtrada métrica por vários

valores listados do atributo
especificado.
Calcula métrica pelo atributo

especificado, excluindo os valores de
atributos listados.
SELECT … WHERE … IN (…, …)

IN/NOT IN
SELECT … WHERE … NOT IN (…, …)
Exemplos:
SELECT Receita WHERE Ano IN

(2014,2016)
SELECT Receita WHERE Ano NOT IN

(2014, 2016)
Retornos de nível superior valores,
conforme especificado por uma
porcentagem ou uma contagem
numérica, da entrada.
Devoluções bottommost valores,

conforme especificado por uma
porcentagem ou uma contagem
numérica, da entrada.
SELECT … WHERE TOP(5) IN (SELECT …

TOP/BOTTOM (%/n) BY …)
SELECT … WHERE BOTTOM (25%) IN

(SELECT … BY …)
Exemplos:
SELECT Valor WHERE TOP(5) IN

(SELECT Méd Ganhou BY Produto)
SELECT Valor WHERE BOTTOM (25%)

IN (SELECT Receita BY Região)
Calcula métrica ignorando quaisquer

filtros aplicados em qualquer nível
WITHOUT PARENT FILTER acima da métrica (métrica, relatório ou
dashboard).
SELECT ... - (SELECT ... BY ALL ...

WITHOUT PARENT FILTER)
Exemplo:
SELECT Receita – (SELECT Receita BY

ALL Ano WITHOUT PARENT FILTER)
WITH PARENT FILTER Calcula métricas filtros aplicáveis a

todos os níveis acima da métrica
(métrica, relatório ou dashboard). Este
é o comportamento padrão.
WITH PARENT FILTER EXCEPT Calcula métricas filtros aplicáveis a
todos os níveis acima da métrica
(métrica, relatório ou dashboard),
exceto para os filtros especificados.
WITH PARENT FILTER EXCEPT ...
Exemplo:
SELECT SUM(Receita) WITH PF

EXCEPT Produto
THIS, PREVIOUS, NEXT Flutuante de referência para o valor

atual atributo relacionado a data.
Flutuante de referência para o valor do

atributo relacionados com data
anterior.
Flutuação de referência para o próximo

valor de atributo relacionados com
data.
THIS
PREVIOUS
NEXT
Exemplo:
SELECT AVG (SELECT THIS

– Data(fechado) BY Número Chamado)
Filtros para o padrão de cadeia e

é caso sensível.
LIKE, NOT LIKE, ILIKE, NOT ILIKE
é caso insensível.

é caso insensível.
Retorna nada que não seja definido no
padrão de corda e é caso insensível.
SELECT … WHERE … LIKE ""
SELECT … WHERE … NOT LIKE ""
SELECT … WHERE … ILIKE ""
SELECT … WHERE … NOT ILIKE ""
Exemplo:
SELECT SUM (Receita) WHERE Nome

do produto [do produto] LIKE "%
vermelha%"

MAQL

Transféré par

Informations du document

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

MAQL

Transféré par

Droits d'auteur :

Formats disponibles

MAQL

SELECT AVG (...)

AVG/RUNAVG SELECT RUNAVG (…)

SELECT AVG (salário pago)

SELECT RUNAVG (salário pago)

Coeficiente de correlação entre dois conjuntos de

SELECT CORREL (Receita Bruta, a Receita Líquida)

Número de valores exclusivos em um atributo.

SELECT COUNT (...)

SELECT COUNT (empregado, registros de

Covariância entre dois conjuntos de factos ou valores

Covariância entre dois conjuntos de factos ou valores

SELECT COVAR (..., ...)

SELECT COVARP (..., ...)

SELECT COVAR (salário pago, Receita de Vendas)

Calcula valores linha de tendência futuras usando

FORECAST (Vendas Média, 6)

MAX/RUNMAX Máximo de todos os valores de um fato ou métrica.

SELECT MAX (...)

SELECT RUNMAX (...)

SELECT MAX (salário pago)

SELECT RUNMAX (salário pago)

MEDIAN Valor médio de todos os valores de um fato ou

SELECT MEDIAN (...)

SELECT MEDIAN (salário pago)

MIN/RUNMIN Mínima de todos os valores de um fato ou métrica.

SELECT MIN (...)

SELECT RUNMIN (...)

SELECT MIN (salário pago)

SELECT RUNMIN (salário pago)

SELECT PERCENTILE (... , x)

SELECT PERCENTILE (receita de vendas, 0,75)

SELECT PERCENTILE (resolução Full Time, 90%)

RSQ O quadrado do coeficiente de correlação entre dois

SELECT RSQ (... , ...)

SELECT RSQ (Receita Bruta, a Receita Líquida)

STDEV/RUNSTDEV O desvio padrão entre um conjunto de valores de

SELECT STDEV (...)

SELECT STDEV (Receita de Vendas)

SUM/RUNSUM Soma de todos os valores de um fato ou métrica.

SELECT SUM (...)

SELECT RUNSUM (...)

SELECT SUM (salário pago)

SELECT RUNSUM (salário pago)

VAR/RUNVAR Variância entre dois conjuntos de valores para uma

SELECT VAR (...)

SELECT VAR (salário pago)

SELECT RUNVAR (salário pago)

3.2. Função Numérica

SELECT Receitas - Despesas

Valor absoluto de um fato ou métrica.

ABS SELECT ABS (...)

SELECT ABS (Receita)

Devolve a constante e elevado à

EXP SELECT EXP (...)

SELECT EXP (taxa anual)

SELECT IFNULL (..., 0)

SELECT IFNULL ((preço , 0) * IFNULL

SELECT IFNULL ((SELECT SUM ( Cost )

Calcula o logaritmo de um valor, dada a

Calcula o logaritmo natural de um

SELECT LOG (...)

SELECT LOG (Valor [MIN] * 4, Valor

SELECT LN (SUM (Valor))