Expressões de filtro do Looker

As expressões de filtro são uma forma avançada de filtrar consultas do Looker. Pode usar expressões de filtro das seguintes formas:

• Na secção Explorar do Looker, pode adicionar um filtro, escolher a opção corresponde (avançado) e, em seguida, introduzir uma das expressões apresentadas nesta página para o tipo de filtro como valor do filtro.
• Em elementos LookML que usam um parâmetro filter.

Esta página apresenta os valores que pode introduzir para um filtro que usa a opção de condição corresponde (avançado) numa análise detalhada do Looker. Consoante o tipo de filtro e a sua entrada para o valor do filtro, o Looker pode converter a opção corresponde (avançado) numa condição de filtro que pode ser mais adequada.

Aspetos a ter em conta sobre as expressões de filtro

Tenha em atenção as seguintes notas quando trabalhar com expressões de filtro do Looker:

• As expressões de filtro nesta página também são suportadas para alguns tipos de filtros no Looker Studio quando o conetor do Looker faz referência a uma opção Explorar do Looker como origem de dados e o filtro usa uma condição Corresponde (avançado). A condição Corresponde a (avançado) tem um comportamento ligeiramente diferente no Looker Studio do que numa exploração do Looker. O Looker pode converter a condição corresponde (avançado) numa condição mais adequada, com base na entrada do utilizador. No entanto, o Looker Studio usa a opção Corresponde (avançado) como uma condição geral quando a entrada do utilizador é inadequada para as outras condições de filtro suportadas pelo Looker Studio, mas o Looker Studio não converte a condição.
• Nas explorações, os filtros básicos usam algumas expressões que diferem no significado das expressões de filtro documentadas nesta página.
• Quando usar expressões de filtro em LookML, coloque a expressão entre aspas (consulte a página de documentação filters para uma utilização adequada). Isto é especialmente importante para valores lógicos, como NULL. Quando usa expressões de filtro na secção Explorar do Looker, não precisa de colocar a expressão entre aspas.
• As expressões de filtro não são suportadas com concessões de acesso. Consulte a página de documentação access_grant para mais informações.

Expressões de filtro para cada tipo de filtro

Introduza os seguintes exemplos como valores de filtro nos filtros do Looker Explore que usam a opção de condição corresponde (avançado). As expressões de filtro são suportadas para os seguintes tipos de filtros:

• String
• Data e hora
• Boolean
• Número
• Localização

String

Incluir carateres especiais em filtros de string

Tenha em atenção estas regras para incluir carateres especiais em filtros de strings:

• Para incluir ", % ou _, adicione o caráter de escape ^ antes. Por exemplo: ^", ^% e ^_
• Para incluir um - à esquerda, escape-o como ^-. Isto só é necessário se o caráter - for o primeiro caráter. Não precisa de usar o caráter de escape - se estiver dentro da string.
• Para incluir ^, escape-o como ^^.
• Para incluir uma vírgula num filtro de string da IU normal, adicione um caráter 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) num filtro, adicione o caráter de escape, ^, antes da vírgula. Por exemplo: Santa Cruz^, CA.
• Para incluir uma vírgula numa expressão de filtro em LookML, adicione o caráter de escape ^ antes. Por exemplo:

  field: filtered_count {
      type: count
      filters: [city: "Santa Cruz^, CA"]
    }

Data e hora

A filtragem de datas do Looker permite a utilização de expressões em inglês em vez de funções de data SQL.

Estrutura básica dos filtros de data e hora

Para os seguintes exemplos:

• {n} é um número inteiro.

• {interval} é um incremento de tempo, como horas, dias, semanas ou meses.

  A expressão que usa determina se o {interval} inclui períodos parciais ou apenas períodos completos. Por exemplo, a expressão 3 days inclui o dia atual parcial, bem como os dois dias anteriores. A expressão 3 days ago for 3 days inclui os três dias completos anteriores e exclui o dia atual, que está incompleto. Consulte a secção Datas relativas para mais informações.

• {time} pode especificar uma hora formatada como AAAA-MM-DD HH:MM:SS ou AAAA/MM/DD HH:MM:SS, ou uma data formatada como AAAA-MM-DD ou AAAA/MM/DD. Quando usar o formato AAAA-MM-DD, certifique-se de que inclui os dois dígitos do mês e do dia, por exemplo, 2016-01. A redução de um mês ou um dia a um único dígito é interpretada como uma compensação e 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 datas:

Também pode combinar filtros de data:

• Para usar a lógica OU: escreva várias condições no mesmo filtro, separadas por vírgulas. Por exemplo, today, 7 days ago significa "hoje ou há 7 dias".
• Para usar a lógica E: escreva as condições, uma a uma, em vários filtros de data ou hora. Por exemplo, pode colocar after 2014-01-01 num filtro Data de criação e, em seguida, colocar before 2 days ago num filtro Hora de criação. Isto significaria "1 de janeiro de 2014 e depois, e antes de 2 dias atrás".

Datas absolutas

Os filtros de datas absolutas usam os valores de datas específicos para gerar resultados de consultas. Estes são úteis quando cria consultas para intervalos de datas específicos.

Datas relativas

Os filtros de datas relativas permitem-lhe criar consultas com valores de datas contínuos relativos à data atual. Estas são úteis quando cria consultas que são atualizadas sempre que as executa.

Para todos os exemplos seguintes, considere que hoje é sexta-feira, 18/05/2018 às 18:30:02. No Looker, as semanas começam à segunda-feira, a menos que altere essa definição com week_start_day.

Segundos

Minutos

Horas

Dias

Semanas

Meses

Trimestres

Anos

Booleano

A filtragem em valores do tipo verdadeiro ou falso no Looker requer que saiba com que tipo de valor verdadeiro ou falso está a interagir.

Número

Os filtros em números suportam expressões de linguagem natural (por exemplo, 3 to 10) e operadores relacionais (por exemplo, >20). O Looker suporta o operador OR para expressar vários intervalos de filtros (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 em números também podem usar a notação de intervalo algébrico para filtrar campos numéricos.

Location

As expressões de filtro de localização baseiam-se na latitude e longitude, mas podem aceitar alguma linguagem natural para definir caixas e círculos nos quais limitar uma pesquisa.

Unidades de medida suportadas

Para filtrar numa área em torno de uma determinada localização, pode usar estas unidades:

• Metros
• Pés
• Quilómetros
• Milhas

As unidades de medida singulares não são suportadas. Por exemplo, o filtro para um raio de 1,6 km deve ser escrito within 1 miles of 36.97, -122.03.

Valores de atributos do utilizador

Para usar o valor de um atributo do utilizador numa expressão de filtro, consulte o atributo do utilizador com a _user_attributes variável Liquid usando a sintaxe exigida pelo dialeto da sua base de dados:

{{ _user_attributes['name_of_attribute'] }}

Por exemplo, suponhamos que tem de aplicar um prefixo sf_ ao valor do atributo do utilizador salesforce_username porque é assim que os valores são armazenados na sua base de dados. Para adicionar o prefixo ao valor do atributo do utilizador, pode adicionar um filtro corresponde (avançado) no campo relevante e usar a variável Liquid _user_attributes na expressão do filtro da seguinte forma:

sf_{{_user_attributes['salesforce_username']}}

Pode usar o mesmo padrão para inserir atributos do utilizador em filtros do painel de controlo e filtros de elementos do painel de controlo do LookML.