Expressões de filtro do Looker

As expressões de filtro são uma forma avançada de filtrar consultas do Looker, e esta página descreve como criá-las. 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

Como incluir caracteres especiais em filtros de string

Observe estas regras para incluir caracteres especiais em filtros de string:

• Para incluir ", % ou _, adicione 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 ^, faça o escape como ^^.
• Para incluir uma vírgula em um filtro de string regular UI, inclua um caractere de barra invertida como prefixo, \. Por exemplo, Santa Cruz\, CA.
• Para incluir uma vírgula com a opção matches (advanced) em um filtro, prefixe a vírgula com o caractere de escape ^. Por exemplo: Santa Cruz^, CA.
• Para incluir uma vírgula em uma expressão de filtro no LookML, use o prefixo com o caractere de escape ^. 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 de 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 frase usada determina se a {interval} vai incluir períodos parciais ou apenas períodos completos. Por exemplo, a expressão 3 days inclui o dia parcial atual, 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 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:

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, colocar before 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 os valores de data específicos para gerar os resultados da consulta. Eles são úteis ao criar consultas para períodos específicos.

Datas relativas

Os filtros de data relativa permitem criar consultas com valores de data contínua relativos à data atual. Eles são úteis ao criar consultas que são atualizadas toda vez 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

Minutos

Horas

Dias

Semanas

Meses

Trimestres

Anos

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.

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 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 de números também podem usar a notação algébrica de intervalos para filtrar campos numéricos.

Local

As expressões de filtro de local são baseadas na latitude e na longitude, mas podem aceitar linguagem natural para definir caixas e círculos nos quais limitar uma pesquisa.

Unidades de medida compatíveis

Para filtrar uma área ao redor de um local específico, 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.