always_filter

Uso

explore: explore_name {
  always_filter:  {
    filters:  [field_name: "filter expression", field_name: "filter expression", ...]
  }
}

Jerarquía Archivo del modelo explore always_filter

Valor predeterminado Ninguno Acepta Un nombre de campo y una expresión de filtro de Looker

Definición

El parámetro always_filter te permite exigir a los usuarios que incluyan un conjunto de filtros para una exploración. Después de definir los filtros y sus valores predeterminados con el parámetro always_filter, la función Explorar mostrará automáticamente la configuración de filtros que estableciste.

Los filtros que especifiques en el parámetro always_filter no se pueden quitar de Explorar. Sin embargo, los usuarios pueden modificar el filtro cambiando sus valores o su condición en el menú desplegable de condiciones. Tus usuarios también pueden quitar todos los valores del filtro, lo que tiene el mismo efecto que quitar el filtro.

Si deseas que una exploración tenga filtros que no se puedan modificar ni quitar, usa uno de los siguientes parámetros:

• Para configurar filtros que sean iguales para todos y que no se puedan ver ni cambiar de ninguna manera, puedes usar sql_always_where.
• Para configurar filtros específicos para cada usuario que no se puedan ver ni cambiar de ninguna manera, puedes usar access_filter.

En el parámetro always_filter, el campo al que se hace referencia en el subparámetro filters puede ser una dimensión, una medida, un filtro o un parámetro. Si necesitas hacer referencia a una dimensión o métrica que forma parte de una vista combinada en lugar de formar parte de esta exploración, usa view_name.field_name. Por ejemplo:

explore: order {
  always_filter: {
    filters: [id: "123", customer.id: "789"]
  }
  join: customer {
    sql_on: ${order.customer_id} = ${customer.id} ;;
  }
}

Aquí, el filtro id hace referencia al campo id de order. El filtro customer.id hace referencia al campo id de customer. Este ejemplo también demuestra que puedes agregar varios filtros.

Para cada par field_name: "filter expression", la expresión de filtro puede ser un valor absoluto o puedes usar expresiones de filtro de Looker, según el tipo de campo por el que filtres.

Ejemplos

Configura un filtro predeterminado para la exploración en el campo ID de pedido (con un valor predeterminado de "123"):

explore: order {
  always_filter: {
    filters: [id: "123"]
  }
}

Configura un filtro predeterminado para la exploración en el campo Order Created Date (con un valor predeterminado de los últimos siete días):

explore: order {
  always_filter: {
    filters: [created_date: "7 days"]
  }
}

Configura un filtro predeterminado para la exploración en el campo ID de pedido (valor predeterminado "123"), el campo Ciudad del pedido (valor predeterminado "Chicago") y el campo Edad del cliente (valor predeterminado mayor o igual a 18):

explore: order {
  always_filter: {
    filters: [id: "123", city: "Chicago", customer.age: ">=18"]
  }
  join: customer {
    sql_on: ${order.customer_id} = ${customer.id} ;;
  }
}

Aspectos para tener en cuenta

Los usuarios no pueden quitar un filtro especificado por always_filter

Aunque los usuarios pueden cambiar la condición o el valor predeterminado de su búsqueda, no pueden quitar un filtro que haya agregado always_filter. Si deseas precargar filtros para una exploración de forma que los usuarios puedan quitarlos por completo, considera crear una consulta que incluya filtros sugeridos y, luego, compartir la consulta con los usuarios para que puedan usarla y sus filtros como punto de partida.

Cómo establecer un valor predeterminado en blanco

Si deseas crear un filtro predeterminado con un valor predeterminado en blanco, puedes hacerlo especificando "-EMPTY" en los valores del filtro:

always_filter: {
  filters: [products.category: "-EMPTY"]
}

El parámetro always_filter anula un parámetro de configuración del filtro default_value

El parámetro always_filter anula el parámetro de configuración default_value para el campo. Si declaras un valor con always_filter, ese valor será el predeterminado en Explorar. Si no declaras un valor con always_filter, "es cualquier valor" será el filtro predeterminado en Explorar.

always_filter afecta las Vistas y los mosaicos de panel existentes

Si agregas el parámetro always_filter a una definición de explore existente, se agrega el conjunto de filtros con los valores predeterminados a cualquier Look, Explorar o tarjeta del panel que se base en ese explore, incluidos los Looks y las tarjetas del panel guardados anteriormente que se basen en el explore.