full_suggestions

Uso

view: view_name {
  dimension: field_name {
    full_suggestions: yes 
  }
}

Jerarquía Ver archivo view Tipo de campo full_suggestions

Tipos de campos posibles Dimensión, grupo de dimensiones, filtro y parámetro Acepta Un valor booleano (sí o no)

Definición

Cuando un usuario filtra una exploración en un tipo de campo que admite sugerencias, de forma predeterminada, Looker sugerirá valores posibles para el campo (consulta la página de documentación Cómo cambiar las sugerencias de filtros para obtener información sobre cómo puedes influir en las sugerencias de filtros). Para proporcionar sugerencias para un campo de filtro, Looker ejecuta una consulta en tu base de datos para recuperar una lista de valores distintos para el campo. Por lo general, Looker genera estas sugerencias ejecutando una consulta como la siguiente en el campo de filtro:

SELECT DISTINCT field_name FROM table
WHERE (field_name LIKE '%' OR field_name LIKE '% %')
GROUP BY 1 ORDER BY 1 LIMIT 1000

El parámetro full_suggestions controla cómo Looker consulta tu base de datos para proporcionar sugerencias sobre los valores del campo en el filtro de un Explorar:

• full_suggestions: no: Looker usará su consulta de sugerencia de filtro típica y solo consultará la vista que contiene el campo de filtro.

• full_suggestions: yes: Looker agregará la lógica de Explorar a su consulta de sugerencias de filtros, lo que significa que incluirá cualquiera de las uniones de Explorar que sean necesarias para consultar el campo del filtro, y también incluirá la lógica de los parámetros de Explorar, incluidos los siguientes:

  • sql_always_where
  • access_filter
  • always_join
  • conditionally_filter
  Notas:

  • Las sugerencias que se presentan a un usuario para una dimensión de case no se restringirán cuando la dimensión se defina con full_suggestions:yes. Todas las opciones que incluyas en un parámetro case serán visibles para todos los usuarios.
  • El parámetro always_filter no se aplica a las búsquedas de sugerencias de filtros.

Comportamiento predeterminado

Si no se especifica el parámetro full_suggestions para un campo, Looker consulta los valores de sugerencia con el siguiente comportamiento:

• En el caso de los Explores que usan sql_always_where o access_filter, o always_join, Looker usa el comportamiento full_suggestions: yes de forma predeterminada. Dado que los parámetros access_filter, sql_always_where y always_join aplican restricciones a las consultas de Explorar, estas mismas restricciones se aplican a las consultas de sugerencias de filtros. Consulta Consideraciones para los Explores con sql_always_where o access_filter para obtener información adicional sobre cómo Looker proporciona sugerencias para los Explores con restricciones de consultas.
• De lo contrario, Looker usará el comportamiento predeterminado de full_suggestions: no, consultará solo la vista del campo de filtro y no incluirá ninguna lógica del Explorar. El parámetro de configuración full_suggestions: no hace que las sugerencias de filtros sean más eficaces, ya que Looker consulta una sola tabla sin ninguna unión, sin usar ninguna de las lógicas definidas en el Explorar.

Ejemplo

Para solicitarle a Looker que use la lógica del Explorar para consultar tu base de datos cuando proporcione sugerencias de filtros para una dimensión, agrega full_suggestions: yes a la definición de la dimensión:

dimension: project_name {
  type: string
  sql: ${TABLE}.project_name ;;
  full_suggestions: yes
}

Consideraciones para las exploraciones con sql_always_where o access_filter

Los parámetros sql_always_where y access_filter se suelen usar para controlar el acceso a los datos. Siempre que se usan sql_always_where o access_filter en una exploración, Looker aplica esas restricciones a las sugerencias de filtros que realiza para los tipos de campos que admiten sugerencias. Para evitar que los usuarios vean una sugerencia de filtro que no se aplica a ellos, Looker requiere que la lógica de Explorar (full_suggestions:yes) se aplique a las sugerencias de valores de filtro en Explorar. Por lo tanto, si se define una exploración con sql_always_where o access_filter, Looker no proporcionará ninguna sugerencia para un filtro en un campo definido con full_suggestions:no.

Si tienes un Explore con sql_always_where o access_filter, y tienes un campo que sabes que no requiere la lógica de sql_always_where o access_filter, puedes anular el comportamiento agregando bypass_suggest_restrictions:yes a la definición del campo. La instrucción bypass_suggest_restrictions:yes le indica a Looker que proporcione la lista completa de sugerencias de valores de filtro.