Expresiones de filtro de Looker

Las expresiones de filtro son una forma avanzada de filtrar las consultas de Looker. Puedes usar expresiones de filtro de las siguientes formas:

• En la sección Explorar de Looker, puedes añadir un filtro, elegir la opción coincide (avanzado) y, a continuación, introducir una de las expresiones que se indican en esta página para el tipo de filtro como valor del filtro.
• En elementos de LookML que usan un filter parámetro.

En esta página se indican los valores que puede introducir en un filtro que use la opción de condición coincide (avanzado) en una exploración de Looker. En función del tipo de filtro y del valor que introduzcas, Looker puede convertir la opción Coincide (avanzado) en una condición de filtro que sea más adecuada.

Qué debes saber sobre las expresiones de filtro

Ten en cuenta las siguientes notas cuando trabajes con expresiones de filtro de Looker:

• Las expresiones de filtro de esta página también se admiten en algunos tipos de filtros de Looker Studio cuando el conector de Looker hace referencia a una exploración de Looker como fuente de datos y el filtro usa la condición Coincide (avanzado). La condición Coincide (avanzado) se comporta de forma algo diferente en Looker Studio que en una Exploración de Looker. Looker puede convertir la condición Coincide (avanzado) en una condición más adecuada en función de lo que haya introducido el usuario. Sin embargo, Looker Studio usa la opción Coincide (avanzado) como condición comodín cuando la entrada del usuario no es adecuada para las demás condiciones de filtro que admite Looker Studio, pero Looker Studio no convierte la condición.
• En Exploraciones, los filtros básicos usan algunas frases cuyo significado es diferente al de las expresiones de filtro que se documentan en esta página.
• Cuando uses expresiones de filtro en LookML, coloca la expresión entre comillas (consulta la página de documentación filters para saber cómo usarlas correctamente). Esto es especialmente importante en el caso de los valores lógicos, como NULL. Cuando se usan expresiones de filtro en la sección Explorar de Looker, no es necesario poner la expresión entre comillas.
• Las expresiones de filtro no se admiten con las concesiones de acceso. Para obtener más información, consulta la página de documentación de access_grant.

Expresiones de filtro de cada tipo de filtro

Introduce los siguientes ejemplos como valores de filtro en los filtros de Explorar de Looker que usen la opción de condición Coincide (avanzado). Se admiten expresiones de filtro para los siguientes tipos de filtros:

• String
• Fecha y hora
• Booleano
• Número
• Ubicación

Cadena

Incluir caracteres especiales en filtros de cadena

Ten en cuenta estas reglas para incluir caracteres especiales en los filtros de cadena:

• Para incluir ", % o _, añade el carácter de escape ^ antes. Por ejemplo: ^", ^% y ^_
• Para incluir un - inicial, escríbelo como ^-. Esto solo es necesario si - es el primer carácter. No es necesario usar el carácter de escape - si está dentro de la cadena.
• Para incluir ^, escríbelo como ^^.
• Para incluir una coma en un filtro de cadena de interfaz de usuario normal, añade una barra inversa delante de la coma (\). Por ejemplo: Santa Cruz\, CA.
• Para incluir una coma con la opción Coincidencias (avanzado) en un filtro, añade el carácter de escape ^ antes de la coma. Por ejemplo: Santa Cruz^, CA.
• Para incluir una coma en una expresión de filtro de LookML, añade el carácter de escape ^ antes. Por ejemplo:

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

Fecha y hora

El filtrado de fechas de Looker permite usar frases en inglés en lugar de funciones de fecha de SQL.

Estructura básica de los filtros de fecha y hora

En los siguientes ejemplos:

• {n} es un número entero.

• {interval} es un incremento de tiempo, como horas, días, semanas o meses.

  La forma en que lo formules determinará si el {interval} incluirá periodos parciales o solo periodos completos. Por ejemplo, la expresión 3 days incluye el día actual (aunque no haya terminado) y los dos días anteriores. La expresión 3 days ago for 3 days incluye los tres días completos anteriores y excluye el día actual, que no está completo. Para obtener más información, consulta la sección Fechas relativas.

• {time} puede especificar una hora con el formato AAAA-MM-DD HH:MM:SS o AAAA/MM/DD HH:MM:SS, o una fecha con el formato AAAA-MM-DD o AAAA/MM/DD. Cuando utilices el formato AAAA-MM-DD, asegúrate de incluir los dos dígitos del mes y del día (por ejemplo, 2016-01). Si se trunca un mes o un día a un solo dígito, se interpreta como un desplazamiento, no como una fecha. Por ejemplo, 2016-1 se interpreta como 2016 menos un año, es decir, 2015.

Estas son todas las combinaciones posibles de filtros de fecha:

Los filtros de fecha también se pueden combinar:

• Para usar el operador lógico O: escribe varias condiciones en el mismo filtro, separadas por comas. Por ejemplo, today, 7 days ago significa "hoy o hace 7 días".
• Para usar el operador lógico AND: escribe las condiciones una a una en varios filtros de fecha u hora. Por ejemplo, puedes poner after 2014-01-01 en un filtro Fecha de creación y, a continuación, poner before 2 days ago en un filtro Hora de creación. Esto significaría "1 de enero del 2014 y después, y antes de hace 2 días".

Fechas absolutas

Los filtros de fecha absoluta usan valores de fecha específicos para generar resultados de consulta. Son útiles cuando se crean consultas para intervalos de fechas específicos.

Fechas relativas

Los filtros de fecha relativa te permiten crear consultas con valores de fecha variables en relación con la fecha actual. Son útiles para crear consultas que se actualizan cada vez que las ejecutas.

En todos los ejemplos siguientes, se presupone que hoy es viernes, 18/05/2018, a las 18:30:02. En Looker, las semanas empiezan el lunes, a menos que cambies ese ajuste con week_start_day.

Segundos

Minutos

Horas

Días

Semanas

Meses

Trimestres

Años

Booleano

Para filtrar por valores de tipo verdadero o falso en Looker, debes saber con qué tipo de valor verdadero o falso estás interactuando.

Número

Los filtros de números admiten expresiones en lenguaje natural (por ejemplo, 3 to 10) y operadores relacionales (por ejemplo, >20). Looker admite el operador OR para expresar varios intervalos de filtros (por ejemplo, 3 to 10 OR 30 to 100). El operador AND se puede usar para expresar intervalos numéricos con operadores relacionales (por ejemplo, >=3 AND <=10) para especificar un intervalo. Los filtros de números también pueden usar la notación de intervalos algebraicos para filtrar campos numéricos.

Ubicación

Las expresiones de filtro de ubicación se basan en la latitud y la longitud, pero pueden aceptar lenguaje natural para definir cuadros y círculos en los que limitar una búsqueda.

Unidades de medida admitidas

Para filtrar por una zona alrededor de una ubicación determinada, puedes usar estas unidades:

• Metros
• Pies
• Kilómetros
• Millas

No se admiten unidades de medida en singular. Por ejemplo, para filtrar por un radio de una milla, debe escribir within 1 miles of 36.97, -122.03.

Valores de atributo de usuario

Para usar el valor de un atributo de usuario en una expresión de filtro, haga referencia al atributo de usuario con la _user_attributes variable de Liquid mediante la sintaxis que requiera el dialecto de su base de datos:

{{ _user_attributes['name_of_attribute'] }}

Por ejemplo, supongamos que necesitas aplicar un prefijo sf_ al valor del atributo de usuario salesforce_username porque así es como se almacenan los valores en tu base de datos. Para añadir el prefijo al valor del atributo de usuario, puede añadir un filtro coincide (avanzado) en el campo correspondiente y usar la variable de Liquid _user_attributes en la expresión del filtro de la siguiente manera:

sf_{{_user_attributes['salesforce_username']}}

Puedes usar el mismo patrón para insertar atributos de usuario en los filtros de panel de LookML y en los filtros de elementos de panel.