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, 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, Looker sugerirá de forma predeterminada 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 afectar 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 para los valores del campo en el filtro de una exploración:

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

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

  • sql_always_where
  • access_filter
  • always_join
  • conditionally_filter
  Notas:

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

Comportamiento predeterminado

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

• Para las exploraciones que usan sql_always_where o access_filter, o always_join, Looker usa de forma predeterminada el comportamiento full_suggestions: yes. Debido a que los parámetros access_filter, sql_always_where y always_join aplican restricciones a las consultas de exploración, estas mismas restricciones se aplican a las consultas de sugerencias de filtros. Consulta Consideraciones para las exploraciones con sql_always_where o access_filter para obtener información adicional sobre cómo Looker proporciona sugerencias para las exploraciones con restricciones de consulta.
• De lo contrario, Looker usa de forma predeterminada el comportamiento full_suggestions: no, consultando solo la vista del campo de filtro y sin incluir ninguna de las lógicas de la exploración. La configuración full_suggestions: no hace que las sugerencias de filtros tengan un mejor rendimiento, ya que Looker consulta una sola tabla sin uniones, sin usar ninguna de las lógicas definidas en la exploración.

Ejemplo

Para solicitarle a Looker que use la lógica de la exploración 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. Cada vez 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 exploración (full_suggestions:yes) se aplique a las sugerencias de valores de filtros en la exploración. Por lo tanto, si una exploración se define 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 una exploración con sql_always_where o access_filter, y tienes un campo que sabes que no requiere la lógica 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 solicita a Looker que proporcione la lista completa de sugerencias de valores de filtros.