As expressões de filtro são uma maneira avançada de filtrar consultas do Looker. Esta página descreve como fazer isso. Na seção "Explorar" do Looker, adicione um filtro e escolha a opção correspondências (avançado). Elas também são usadas no LookML para elementos que recebem um parâmetro filter
.
String
Exemplo | Descrição |
---|---|
FOO |
é igual a "FOO", exatamente |
FOO,BAR |
é igual a "FOO" ou "BAR", exatamente |
%FOO% |
contém "FOO" e corresponde a "buffoon" e "fast food" |
FOO% |
começa com "FOO", corresponde a "foolish" e "food", mas não a "buffoon" ou "fast food" |
%FOO |
termina com "FOO" e corresponde a "buffoo" e "fast foo" mas não "buffoon" ou "fast food" |
F%OD |
começa com um "F" e termina com "OD", corresponde a "fast food" |
EMPTY |
a string está vazia (não tem nenhum caractere) ou é nula (sem valor); |
NULL |
o valor é nulo (quando usado como parte de uma expressão de filtro do LookML, coloque NULL entre aspas, conforme mostrado na página de documentação filters ). |
-FOO |
não é igual a "FOO" (é qualquer valor, exceto "FOO"), corresponde a "pizza", "trash", "fun" mas não "foo" |
-FOO,-BAR |
não é igual a "FOO" ou "BAR", corresponde a qualquer valor, exceto "FOO" e "BAR" |
-%FOO% |
não contém "FOO", não corresponde a "bufão" ou "fast food" |
-FOO% |
não começa com "FOO", não corresponde a "foolish" ou "comida" |
-%FOO |
não termina com "FOO", não corresponde a "buffoo" ou "fast foo" |
-EMPTY |
a string não está vazia (tem pelo menos um caractere) |
-NULL |
O valor da coluna não é nulo (quando usado como parte de uma expressão de filtro do LookML, coloque -NULL entre aspas, conforme mostrado na página de documentação filters ) |
FOO%,BAR |
começa com "FOO" ou "BAR" corresponde exatamente a "comida" e corresponde a "bar" mas não "barfood" |
FOO%,-FOOD |
começa com "FOO" mas não é "ALIMENTO" |
_UF |
tem qualquer caractere único seguido por "UF", corresponde a "buffoon" |
Como incluir caracteres especiais em filtros de string
Observe estas regras para incluir caracteres especiais em filtros de string:
- Para incluir
"
,%
ou_
, use o prefixo com o caractere de escape^
. Por exemplo:^"
,^%
e^_
- Para incluir um
-
inicial, faça o escape dele como^-
. Isso só é necessário se o-
for o caractere inicial. Não é necessário escapar de-
se ele estiver dentro da string. - Para incluir
^
, use o caractere de escape^^
. - Para incluir uma vírgula em um filtro de string regular UI, insira um caractere de barra invertida antes da vírgula,
\
. Por exemplo,Santa Cruz\, CA
. - Para incluir uma vírgula com a opção corresponde a (avançado), em um filtro, acrescente o caractere de escape
^
antes dela. Por exemplo:Santa Cruz^, CA
. - Para incluir uma vírgula em uma expressão de filtro no LookML, adicione o caractere de escape
^
como prefixo. Por exemplo:
field: filtered_count {
type: count
filters: [city: "Santa Cruz^, CA"]
}
Data e hora
A filtragem de datas do Looker permite o uso de frases em inglês em vez de funções de data do SQL.
Estrutura básica dos filtros de data e hora
Para os exemplos a seguir:
{n}
é um número inteiro.{interval}
é um incremento de tempo, como horas, dias, semanas ou meses.A frase usada determina se a
{interval}
vai incluir períodos parciais ou apenas períodos completos. Por exemplo, a expressão3 days
inclui o dia parcial atual, bem como os dois dias anteriores. A expressão3 days ago for 3 days
inclui os três dias completos anteriores e exclui o dia parcial atual. Consulte a seção Datas relativas para mais informações.{time}
pode especificar um horário no formato AAAA-MM-DD HH:MM:SS ou AAAA/MM/DD HH:MM:SS, ou uma data no formato AAAA-MM-DD ou AAAA/MM/DD. Ao usar o formato AAAA-MM-DD, inclua os dois dígitos do mês e do dia, por exemplo, 2016-01. A truncagem de um mês ou dia para um único dígito é interpretada como um deslocamento, não como uma data. Por exemplo, 2016-1 é interpretado como 2016 menos um ano, ou 2015.
Estas são todas as combinações possíveis de filtros de data:
Combinação | Exemplo | Observações |
---|---|---|
this {interval} |
this month |
Você pode usar this week , this month , this quarter ou this year . Observe que this day não é compatível. Se você quiser receber os dados do dia atual, use today . |
{n} {interval} |
3 days |
|
{n} {interval} ago |
3 days ago |
|
{n} {interval} ago for {n} {interval} |
3 months ago for 2 days |
|
before {n} {interval} ago |
before 3 days ago |
|
before {time} |
before 2018-01-01 12:00:00 |
before não inclui o horário especificado. A expressão before 2018-01-01 retornará dados de todas as datas anteriores a 01/01/2018, mas não retornará dados de 01/01/2018. |
after {time} |
after 2018-10-05 |
after inclui o horário especificado. Assim, a expressão after 2018-10-05 retornará dados de 05/10/2018 e todas as datas posteriores a 05/10/2018. |
{time} to {time} |
2018-05-18 12:00:00 to 2018-05-18 14:00:00 |
O valor de tempo inicial é inclusivo, mas o último não é. Portanto, a expressão 2018-05-18 12:00:00 to 2018-05-18 14:00:00 retornará dados com o horário "2018-05-18 12:00:00" até "2018-05-18 13:59:59". |
this {interval} to {interval} |
this year to second |
O início de cada intervalo é usado. Por exemplo, a expressão this year to second retorna dados do início do ano em que a consulta é executada até o início do segundo em que ela é executada. this week to day retorna dados do início da semana em que a consulta é executada até o início do dia em que ela é executada. |
{time} for {n} {interval} |
2018-01-01 12:00:00 for 3 days |
|
today |
today |
|
yesterday |
yesterday |
|
tomorrow |
tomorrow |
|
{day of week} |
Monday |
Especificar um dia da semana com um campo Data do grupo de dimensões retorna a data mais recente que corresponde ao dia da semana especificado. Por exemplo, a expressão Dimension Group Date matches (advanced) Monday retorna a segunda-feira mais recente.Também é possível usar {day of week} com as palavras-chave before e after nesse contexto. Por exemplo, a expressão Dimension Group Date matches (advanced) after Monday retorna a segunda-feira mais recente e tudo que vem depois da segunda-feira mais recente. A expressão Dimension Group Date matches (advanced) before Monday é retornada todos os dias antes da segunda-feira mais recente, mas não retorna a segunda-feira mais recente.Especificar um dia da semana com um campo Dia da semana do grupo de dimensão retorna todos os dias que correspondem ao dia da semana especificado. Portanto, a expressão Dimension Group Day of Week matches (advanced) Monday retorna todas as segundas-feiras. |
next {week, month, quarter, fiscal quarter, year, fiscal year} |
next week |
A palavra-chave next é exclusiva porque exige um dos intervalos listados anteriormente e não funcionará com outros intervalos. |
{n} {interval} from now |
3 days from now |
|
{n} {interval} from now for {n} {interval} |
3 days from now for 2 weeks |
Os filtros de data também podem ser combinados:
- Para acessar a lógica OR:digite várias condições no mesmo filtro, separadas por vírgulas. Por exemplo,
today, 7 days ago
significa "hoje ou sete dias atrás". - Para usar a lógica AND: digite suas condições, uma por vez, em vários filtros de data ou hora. Por exemplo, é possível colocar
after 2014-01-01
em um filtro Data de criação e, em seguida, colocarbefore 2 days ago
em um filtro Horário de criação. Significa "1o de janeiro de 2014 em diante e antes de dois dias atrás".
Datas absolutas
Os filtros de data absoluta usam valores de data específicos para gerar resultados de consulta. Eles são úteis ao criar consultas para períodos específicos.
Exemplo | Descrição |
---|---|
2018/05/29 |
em algum momento em 29/05/2018 |
2018/05/10 for 3 days |
de 10/05/2018 00:00:00 a 12/05/2018 23:59:59 |
after 2018/05/10 |
10/05/2018 00:00:00 e depois |
before 2018/05/10 |
antes de 10/05/2018 00:00:00 |
2018/05 |
no mês inteiro de 2018/05 |
2018/05 for 2 months |
nos meses inteiros de 2018/05 e 2018/06 |
2018/05/10 05:00 for 5 hours |
de 10/05/2018 às 05:00:00 a 10/05/2018 às 09:59:59 |
2018/05/10 for 5 months |
de 10/05/2018 00:00:00 a 09/10/2018 23:59:59 |
2018 |
Todo o ano de 2018 (01/01/2018 00:00:00 a 31/12/2018 23:59:59) |
FY2018 |
todo o ano fiscal a partir de 2018 (se os desenvolvedores do Looker tiverem especificado que o ano fiscal começa em abril, será 2018/04/01 00:00 até 2019/03/31 23:59) |
FY2018-Q1 |
primeiro trimestre do ano fiscal a partir de 2018 (se os desenvolvedores do Looker tiverem especificado que o ano fiscal começa em abril, será 2018/04/01 00:00:00 até 2018/06/30 23:59:59) |
Datas relativas
Os filtros de data relativa permitem criar consultas com valores de datas variáveis em relação à data atual. Eles são úteis ao criar consultas que são atualizadas sempre que você executa a consulta.
Para todos os exemplos a seguir, suponha que hoje é Sexta-feira, 18/05/2018 18:30:02. No Looker, as semanas começam na segunda-feira, a menos que você mude essa configuração com week_start_day
.
Segundos
Exemplo | Descrição |
---|---|
1 second |
o segundo atual (2018/05/18 18:30:02) |
60 seconds |
Há 60 segundos por 60 segundos (18/05/2018 18:29:02 até 18/05/2018 18:30:01) |
60 seconds ago for 1 second |
Há 60 segundos por 1 segundo (18/05/2018 18:29:02) |
Minutos
Exemplo | Descrição |
---|---|
1 minute |
o minuto atual (2018/05/18 18:30:00 a 18:30:59) |
60 minutes |
Há 60 minutos por 60 minutos (18/05/2018 17:31:00 até 18:30:59) |
60 minutes ago for 1 minute |
Há 60 minutos por 1 minuto (2018/05/18 17:30:00 até 2018/05/18 17:30:59) |
Horas
Exemplo | Descrição |
---|---|
1 hour |
no horário atual (18/05/2018, 18h a 18/05/2018, 18h59) |
24 hours |
a mesma hora do dia que foi há 24 horas por 24 horas (2018/05/17 19:00 até 2018/05/18 18:59) |
24 hours ago for 1 hour |
a mesma hora do dia que foi há 24 horas por uma hora (18:00 de 17/05/2018 até 18:59 de 17/05/2018) |
Dias
Exemplo | Descrição |
---|---|
today |
o dia atual (2018/05/18 00:00 a 2018/05/18 23:59) |
2 days |
todo o dia de ontem e hoje (2018/05/17 00:00 até 2018/05/18 23:59) |
1 day ago |
ontem (2018/05/17 00:00 até 2018/05/17 23:59) |
7 days ago for 7 days |
nos últimos 7 dias completos (11/05/2018 00:00 até 17/05/2018 às 23:59) |
today for 7 days |
o dia atual, começando à meia-noite, por sete dias (2018/05/18 00:00 até 2018/05/24 23:59) |
last 3 days |
De 2 dias atrás até o fim do dia atual (16/05/2018 00:00 até 18/05/2018 23:59) |
7 days from now |
Sete dias no futuro (2018/05/18 00:00 até 2018/05/25 23:59) |
Semanas
Exemplo | Descrição |
---|---|
1 week |
início da semana atual (2018/05/14 00:00 até 2018/05/20 23:59) |
this week |
a partir da semana atual (14/05/2018, 00:00 até 20/05/2018, 23:59) |
before this week |
até o topo desta semana (antes de 14/05/2018 à meia-noite) |
after this week |
em qualquer data após o início desta semana (14/05/2018, à meia-noite) |
next week |
na segunda-feira seguinte daqui para frente uma semana (21/05/2018 00:00 até 2018/05/27 23:59) |
2 weeks |
uma semana atrás, na segunda-feira a partir de agora (07/05/2018, 00:00 até 20/05/2018, 23:59) |
last week |
sinônimo de "há uma semana" |
1 week ago |
1 semana atrás, de segunda-feira até uma semana depois (2018/05/07 00:00 até 2018/05/13 23:59) |
Meses
Exemplo | Descrição |
---|---|
1 month |
Mês atual (01/05/2018, 00:00 a 31/05/2018, 23:59) |
this month |
sinônimo para "0 meses atrás" (01/05/2018, 00h, a 31/05/2018, 23h59) |
2 months |
nos últimos dois meses (01/04/2018, 00:00 a 31/05/2018, 23:59) |
last month |
tudo de 04/2018 |
2 months ago |
tudo de 03/2018 |
before 2 months ago |
todo o tempo antes de 2018/03/01 |
next month |
tudo de 2018/06 |
2 months from now |
todo o mês de julho de 2018 |
6 months from now for 3 months |
De 11/2018 a 01/2019 |
Trimestres
Exemplo | Descrição |
---|---|
1 quarter |
o trimestre atual (01/04/2018 00:00 até 30/06/2018 23:59) |
this quarter |
sinônimo de "0 trimestres atrás" (2018/04/01 00:00 até 2018/06/30 23:59) |
2 quarters |
os dois últimos trimestres (2018/01/01 00:00 até 2018/06/30 23:59) |
last quarter |
Todo o 1o trimestre (01/01/2018, 00:00 a 31/03/2018, 23:59) |
2 quarters ago |
todo o quarto trimestre do ano passado (2017/010/01 00:00 até 2017/12/31 23:59) |
before 2 quarters ago |
antes do 4o trimestre do ano passado |
next quarter |
todo o trimestre seguinte (2018/07/01 00:00 até 2018/09/30 23:59) |
2018-07-01 for 1 quarter |
todo o terceiro trimestre (2018/07/01 00:00 até 2018/09/30 23:59) |
2018-Q4 |
Todo o quarto trimestre (01/10/2018, às 00h, a 31/12/2018, às 23h59) |
Anos
Exemplo | Descrição |
---|---|
1 year |
todo o ano atual (2018/01/01 00:00 até 2018/12/31 23:59) |
this year |
todo o ano atual (2018/01/01 00:00 até 2018/12/31 23:59) |
next year |
Todo o ano seguinte (2019/01/01 00:00 a 2019/12/31 23:59) |
2 years |
nos últimos dois anos (01/01/2017, 00:00 a 31/12/2018, 23:59) |
last year |
todo o ano de 2017 |
2 years ago |
todo o ano de 2016 |
before 2 years ago |
todo o período antes de 2016/01/01 (não inclui dias entre 2016/01/01 e 2016/05/18) |
Booleano
Filtrar em valores de tipo verdadeiro ou falso no Looker exige que você saiba com qual tipo de valor verdadeiro ou falso você está interagindo.
Exemplo | Descrição |
---|---|
yes ou Yes |
campo é avaliado como verdadeiro
Desenvolvedores do Looker: para dimensões type: yesno , use letras minúsculas para parâmetros filters (como aqueles usados em uma medição ou usado em um always_filter ) usam letras maiúsculas. |
no ou No |
campo é avaliado como falso
Desenvolvedores do Looker: para dimensões type: yesno , use letras minúsculas. Para parâmetros filters (como aqueles usados em uma medida ou usados em um always_filter ), use letras maiúsculas. |
TRUE |
campo contém "true" (para campos que contêm valores de banco de dados booleanos) |
FALSE |
o campo contém false (para campos que contêm valores de banco de dados booleanos) |
Número
Os filtros de números oferecem suporte a expressões de linguagem natural (por exemplo, 3 to 10
) e operadores relacionais (por exemplo, >20
). O Looker oferece suporte ao operador OR
para expressar vários intervalos de filtro (por exemplo, 3 to 10 OR 30 to 100
). O operador AND
pode ser usado para expressar intervalos numéricos com operadores relacionais (por exemplo, >=3 AND <=10
) para especificar um intervalo. Os filtros de números também podem usar a notação algébrica de intervalos para filtrar campos numéricos.
Exemplo | Descrição |
---|---|
5 |
é exatamente 5 |
NOT 5
<>5
!=5 |
é qualquer valor, exceto 5 |
1, 3, 5, 7 |
é exatamente um dos valores 1, 3, 5 ou 7 |
NOT 66, 99, 4 |
não for um dos valores 66, 99 ou 4. |
>1 AND <100, NOT 2 |
é maior que 1 e menor que 100, não é 2 |
NOT >1, 2, <100 |
é menor ou igual a 1, não é 2 e é maior ou igual a 100. O Looker reconhece que essa é uma condição impossível e, em vez disso, vai gravar o SQL "IS NULL". |
5, NOT 6, NOT 7 |
é 5, não é 6 ou 7 |
5.5 to 10
>=5.5 AND <=10 |
é 5,5 ou maior, mas também 10 ou menos |
NOT 3 to 80.44
<3 OR >80.44 |
é menor que 3 ou maior que 80,44 |
1 to
>=1 |
é 1 ou mais |
to 10
<=10 |
é 10 ou menos |
>10 AND <=20 OR 90 |
é maior que 10 e menor ou igual a 20 ou é exatamente 90 |
>=50 AND <=100 OR >=500 AND <=1000 |
está entre 50 e 100 ou entre 500 e 1.000 |
NULL |
não tenha dados (quando for usado como parte de uma expressão de filtro do LookML, coloque NULL entre aspas, conforme mostrado na página de documentação do filters ). |
NOT NULL |
tem alguns dados (quando usado como parte de uma expressão de filtro do LookML, coloque NOT NULL entre aspas, conforme mostrado na página de documentação filters ) |
(1, 7) |
interpretado como 1 < x < 7, em que os endpoints não estão incluídos. Embora essa notação se assemelha a um par ordenado, neste contexto, ela se refere ao intervalo em que você está trabalhando. |
[5, 90] |
interpretada como 5 <= x <= 90, em que os endpoints estão incluídos |
(12, 20] |
interpretado como 12 < x <= 20, em que 12 não está incluído, mas 20 está incluído |
[12, 20) |
interpretado como 12 <= x < 20, em que 12 está incluído, mas 20 não está |
(500, inf) |
interpretado como x > 500, em que 500 não está incluído e o infinito é sempre expresso como "aberto" (não incluído). inf pode ser omitido e (500, inf) pode ser escrito como (500,) |
(-inf, 10] |
interpretado como x <= 10, em que 10 está incluído e o infinito é sempre expresso como "aberto" (não incluído). inf pode ser omitido e (-inf, 10] pode ser escrito como (,10] |
[0,9],[20,29] |
os números entre 0 e 9 ou de 20 a 29 |
[0,10],20 |
De 0 a 10 ou 20 |
NOT (3,12) |
interpretado como x < 3 e x > 12 |
Local
As expressões de filtro de local são baseadas em latitude e longitude, mas podem aceitar alguma linguagem natural para definir caixas e círculos para limitar uma pesquisa.
Exemplo | Descrição |
---|---|
36.97, -122.03 |
A localização está exatamente na latitude 36,97 e na longitude 122,03 |
40 miles from 36.97, -122.03 |
A localização está a 64 km de latitude 36,97 e longitude -122,03 |
inside box from 72.33, -173.14 to 14.39, -61.70 |
localização está dentro de uma caixa cujo canto noroeste está na latitude 72,33, longitude -173,14 e cujo canto sudeste está na latitude 14,39, longitude -61,70 |
NOT NULL (works the same as -NULL) |
location tem uma latitude não nula e uma longitude não nula (quando for usado como parte de uma expressão de filtro do LookML, coloque NOT NULL entre aspas, como mostrado na página de documentação filters ). |
-NULL (works the same as NOT NULL) |
location tem uma latitude não nula e uma longitude não nula (quando for usado como parte de uma expressão de filtro do LookML, coloque -NULL entre aspas, como mostrado na página de documentação filters ). |
NULL |
O local tem uma latitude, uma longitude nula ou ambos são nulos. Quando for usado como parte de uma expressão de filtro do LookML, coloque NULL entre aspas, conforme mostrado na página de documentação do filters . |
Unidades de medida compatíveis
Para filtrar uma área ao redor de um determinado local, use estas unidades:
- Metros
- Pés
- Quilômetros
- Milhas
Não é possível usar unidades de medida únicas. Por exemplo, a filtragem por um raio de 1 milha precisa ser escrita como within 1 miles of 36.97, -122.03
.
Valores de atributo do usuário
Para usar o valor de um atributo de usuário em uma expressão de filtro, faça referência ao atributo com a variável líquida _user_attributes
usando a sintaxe exigida pelo dialeto do banco de dados:
{{ _user_attributes['name_of_attribute'] }}
Por exemplo, suponha que você precise aplicar um prefixo sf_
ao valor do atributo de usuário salesforce_username
porque é assim que os valores são armazenados no seu banco de dados. Para adicionar o prefixo ao valor do atributo do usuário, adicione um filtro de correspondências (avançado) no campo relevante e use a variável líquida _user_attributes
na expressão de filtro da seguinte maneira:
sf_{{_user_attributes['salesforce_username']}}
Você pode usar o mesmo padrão para inserir atributos de usuário nos filtros de painel e nos filtros de elemento do painel do LookML.