Sugerencias (para campos)

En esta página, se hace referencia al parámetro suggestions que forma parte de una dimensión, un campo de filtro o un parámetro.

También puedes usar suggestions como parte de una vista, como se describe en la página de documentación del parámetro suggestions (para vistas).

Uso

view: view_name {
  dimension: field_name {
    suggestions: ["suggestion string", "suggestion string", "…"]
  }
}

Jerarquía Ver archivo view Tipo de campo suggestions

Tipos de campos posibles Dimensión, filtro y parámetro Acepta Una cadena o una lista de cadenas

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 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 suggestion te permite codificar de forma rígida la lista de valores sugeridos para una dimensión, un campo de filtro o un parámetro que aparecerá cuando alguien use ese campo para filtrar una consulta.

Nota: Si bien Looker almacena en caché hasta 1,000 resultados para esta consulta, solo los primeros 100 se muestran al usuario como sugerencias de filtros.

Si el campo se encuentra en una tabla grande, esta consulta puede ser demasiado lenta o generar una carga demasiado grande en la base de datos. Si usas suggestions, puedes codificar una lista de valores posibles y mejorar el rendimiento.

El parámetro suggestions también es útil porque te permite especificar una lista más limitada si no quieres que ciertos valores de un campo aparezcan como sugerencias.

Precaución: Los valores de label del parámetro case tendrán prioridad sobre las sugerencias que se presenten a los usuarios desde el parámetro suggestions.

Ejemplos

Reemplaza las sugerencias predeterminadas para la dimensión colors por una lista codificada:

dimension: colors {
  type: string
  sql: ${TABLE}.colors ;;
  suggestions: ["red", "yellow", "blue"]
}