Puedes usar varios parámetros de LookML para que tus Exploraciones sean más fáciles de usar. Para ello, cambia la forma en que aparecen los campos en la interfaz de usuario sin modificar el LookML subyacente. En esta página se ofrece una descripción general de los parámetros de LookML que modifican la apariencia del menú Explorar de Looker y del selector de campos.
| En Looker, los usuarios pueden ver las exploraciones en el menú Explorar. | En Explorar, los usuarios pueden usar el selector de campos para elegir los campos (dimensiones y medidas) que quieran usar para consultar sus datos. |
|
|
En esta página se incluye una lista de los parámetros que se usan con frecuencia, así como un enlace a la página de referencia completa, una breve descripción de su función y una imagen que muestra lo que hace.
Para obtener consejos y sugerencias sobre cómo crear Exploraciones fáciles de usar, consulta la página de prácticas recomendadas Práctica recomendada: crea una experiencia positiva para los usuarios de Looker.
Explorar nombre y menú
En esta sección se describe el comportamiento predeterminado del nombre y la apariencia de una exploración en el menú Explorar. A continuación, se describen los parámetros de LookML que permiten cambiar ese comportamiento:
Comportamiento predeterminado del menú Explorar
Nombres de modelos
De forma predeterminada, el menú Explorar se organiza por nombres de modelo, que se determinan por el nombre de cada archivo de modelo. En el menú Explorar, se muestra una versión con formato del nombre del modelo, en la que los guiones bajos se han sustituido por espacios y se ha puesto en mayúscula la primera letra de cada palabra. Debajo del nombre de cada modelo, verás una lista de las Exploraciones definidas en ese archivo de modelo.
Explorar nombres
El nombre de cada Exploración del menú se basa en el parámetro explore correspondiente del archivo de modelo. Al igual que con los nombres de los modelos, los nombres de Explorar se formatean en el menú de forma que los guiones bajos se cambian por espacios y cada palabra empieza por mayúscula. El nombre de la exploración también se muestra como título de la exploración en el panel de selección de campos.
En el siguiente ejemplo, la Exploración order_items se define en el archivo de modelo e_commerce_model.model:
explore: order_items {
join: orders {
type: left_outer
sql_on: ${order_items.order_id} = ${orders.id} ;;
relationship: many_to_one
}
}
La exploración order_items se muestra como Artículos del pedido en el menú Explorar y en el selector de campos.
| Menú Explorar: | Selector de campos: |
 |
 |
Para obtener más información sobre los archivos de modelo, consulta la página de documentación Información sobre los archivos de modelo y de vista. Para obtener más información sobre cómo definir Exploraciones, consulta la página de documentación del parámetro explore.
label (modelo)
El parámetro label de un modelo cambia el nombre de un modelo en el menú Explorar sin modificar la forma en que se hace referencia a él en LookML. Las URLs de Exploraciones, el IDE de Looker y SQL Runner siguen reflejando el nombre real del modelo. La forma en que se debe hacer referencia al modelo en LookML y en la configuración de administrador no cambia.
De forma predeterminada, el modelo market_research.model aparece como Investigación de mercado en el menú Explorar.
Puedes usar el parámetro label para cambiar el nombre del modelo en el menú Explorar. Por ejemplo, añade el código label: "Marketing R&D" al archivo de modelo market_research.model:
label: "Marketing R&D"
En este ejemplo, Looker muestra el nombre del modelo en el menú Explorar de la siguiente manera:
label (Explorar)
El parámetro label de una exploración cambia el nombre de la exploración en el menú Explorar y en la página Exploración sin modificar la forma en que se hace referencia a ella en LookML.
Si no se usa el parámetro label, el nombre de Explorar se muestra según su comportamiento predeterminado.
group_label (Explorar)
El parámetro group_label de Explorar cambia la organización predeterminada del menú Explorar. En lugar de enumerar cada Exploración en el nombre de su modelo, group_label te permite definir un encabezado personalizado en el que se incluyan una o varias Exploraciones.
En este ejemplo, las exploraciones Clientes, Inventario, Artículos de pedido y Datos de usuario se incluyen en la etiqueta de grupo Consultas de tienda online:
description (Explorar)
El parámetro description de Exploración te permite añadir una descripción de una Exploración a la interfaz de usuario para que los usuarios puedan obtener información adicional al crear consultas de Exploración.
Los usuarios pueden ver la descripción colocando el cursor sobre el icono de información, situado junto al nombre Explorar en la parte superior del selector de campos. El icono de información también aparece en la lista desplegable de Exploraciones. Si no añades explícitamente una descripción a un Exploración, no se mostrará ninguna.
hidden (Explorar)
El parámetro hidden de una exploración oculta la exploración del menú Explorar. De forma predeterminada, hidden está desactivado y se mostrará la sección Explorar. hidden no oculta LookML ni impide el acceso a Explorar a través de la URL. hidden no es una función de seguridad, sino una función de presentación.
Por ejemplo, si añade el código LookML hidden: yes al LookML de la Exploración inventory del siguiente ejemplo, se ocultará la Exploración Inventario del menú Explorar:
explore: inventory {
hidden: yes
join: order_facts {
view_label: "Orders"
relationship: many_to_one
sql_on: ${order_facts.order_id} = ${order_items.order_id} ;;
}
}
Selector de campos
En esta sección se describe el comportamiento predeterminado del selector de campos y, a continuación, se explican los parámetros de LookML que permiten cambiar ese comportamiento.
Cambia la forma en que aparecen los nombres de las vistas en el selector de campos con lo siguiente:
Cambia la forma en que aparecen los nombres de los campos en el selector de campos con las siguientes opciones:
Cambia la forma en que se organizan los campos en el selector de campos con las siguientes opciones:
Comportamiento predeterminado del selector de campos
De forma predeterminada, el selector de campos se organiza por encabezados que corresponden a las vistas especificadas por el parámetro view de LookML. Los campos de cada vista se agrupan en el selector de campos. El tipo de campo (dimensión, grupo de dimensiones, medida, campo de filtro y campo de parámetro) determina dónde se muestra el campo en la vista. A menos que se use el parámetro label para modificar el nombre visible, el selector de campos mostrará una versión formateada del nombre de la vista o del campo de LookML, con los guiones bajos sustituidos por espacios y cada palabra en mayúsculas.
En el siguiente ejemplo, Looker muestra la accounts vista como Cuentas en el selector de campos, que es el comportamiento predeterminado:
view: accounts {
sql_table_name: accounts ;;
}
En el siguiente ejemplo se muestra cómo se muestran de forma predeterminada los nombres de una dimensión, un grupo de dimensiones y una métrica. El mismo formato se aplicará a los nombres de los campos de filtro y de los campos de parámetros.
dimension: account_number {
primary_key: yes
type: number
sql: ${TABLE}.account_number ;;
}
dimension: name {
type: string
sql: ${TABLE}.name ;;
}
dimension_group: created {
type: time
timeframes: [raw, time, date, week, month, quarter, year]
sql: ${TABLE}.created_date ;;
}
measure: average_annual_revenue {
type: average
sql: ${annual_revenue} ;;
value_format_name: custom_amount_value_format
}
En este ejemplo, el selector de campos muestra los nombres de campo predeterminados Número de cuenta, Nombre, Fecha de creación y Ingresos anuales medios de las dimensiones account_number y name, del grupo de dimensiones created y de la medida average_annual_revenue, respectivamente.
Si cambia el nombre de un campo, el selector de campos se adaptará al nuevo nombre, pero puede que le interese añadir un parámetro alias con el nombre anterior del campo. Este parámetro proporciona nombres alternativos para un campo que puede aparecer en la URL de una consulta. Puede ser útil en los casos en los que cambian los nombres de los campos de un modelo, pero algunos usuarios han compartido enlaces a datos y quieres que esas URLs sigan funcionando.
view_label (Explorar)
El parámetro view_label de una Exploración cambia la forma en que se etiqueta el grupo de campos de la vista base de una Exploración en el selector de campos, sin cambiar la forma en que se hace referencia a la Exploración y a sus campos en LookML.
Por ejemplo, si unes una vista order_facts a una exploración llamada order_items, puedes usar el parámetro view_label para definir la etiqueta que Looker muestra de la vista order_facts en el selector de campos de la siguiente manera:
explore: order_items {
label: "Order Items"
join: order_facts {
view_label: "Orders and more"
relationship: many_to_one
sql_on: ${order_facts.order_id} = ${order_items.order_id} ;;
}
}
En este ejemplo, la vista order_facts aparece como Pedidos y más en el selector de campos de la sección Explorar Elementos de pedido.
view_label (unirse)
El parámetro view_label de una combinación le permite agrupar campos de una vista con el nombre de otra vista en el selector de campos. Si no añades explícitamente un view_label a una combinación, el view_label se asigna de forma predeterminada al nombre de la combinación.
Por ejemplo, puedes unir la vista products a la exploración product_facts:
explore: product_facts {
join: products {
type: left_outer
sql_on: ${product_facts.product_id} = ${products.id} ;;
relationship: many_to_one
}
}
En este ejemplo, como no se ha especificado ninguna etiqueta de vista, los campos de la vista products se agrupan en la etiqueta de vista Productos del selector de campos, que está separada de la vista Datos del producto:
Puedes usar el parámetro view_label para añadir una etiqueta de vista a la vista products combinada, como en el siguiente ejemplo:
explore: product_facts {
join: products {
view_label: "Product Facts"
type: left_outer
sql_on: ${product_facts.product_id} = ${products.id} ;;
relationship: many_to_one
}
}
De esta forma, los campos de la vista products se agrupan en el selector de campos con la etiqueta de vista Datos del producto:
label (ver)
El parámetro label de una vista cambia la etiqueta de la vista en el selector de campos sin modificar la forma en que se hace referencia a ella en LookML. Si no se especifica, la etiqueta toma de forma predeterminada el nombre de la vista. A diferencia de view_label (Explorar) y view_label (Unión), este parámetro afecta a todas las exploraciones que usan la vista.
Por ejemplo, puedes usar el parámetro label para especificar una etiqueta de la vista inventory_items de la siguiente manera:
view: inventory_items {
label: "Items in Inventory"
sql_table_name: inventory_items ;;
}
En este ejemplo, el selector de campos muestra la etiqueta Elementos del inventario para la vista inventory_items, en lugar de la etiqueta predeterminada Elementos de inventario.
description (campo)
Puedes añadir un description a cualquier campo. En el caso de las conexiones de BigQuery, si generas un proyecto de LookML a partir de tu base de datos, Looker rellenará automáticamente las descripciones de los campos con las descripciones de los metadatos de las columnas de BigQuery, si las hay.
El usuario puede ver esta descripción en varios lugares. Looker muestra la descripción cuando el usuario selecciona el icono de información situado a la derecha del nombre del campo en el selector de campos.
Además, Looker también muestra la descripción cuando el usuario coloca el cursor sobre el nombre de la columna en una tabla o en una visualización de tabla de un Exploración, un panel de control o un Look.
hidden (campo)
De forma predeterminada, los campos especificados en una vista se mostrarán en el selector de campos. El parámetro hidden de un campo oculta un campo en el selector de campos.
Se puede seguir accediendo a los campos ocultos en la interfaz de usuario si se añaden manualmente a la URL y se mostrarán en algunas ventanas de Looker. Por lo tanto, considera hidden como una forma de mantener limpio el selector de campos, no como una función de seguridad.
Por ejemplo, si añade el código LookML hidden: yes a la dimensión product_id en el siguiente ejemplo, se ocultará la dimensión ID de producto del selector de campos:
dimension: product_id {
hidden: yes
type: number
sql: ${TABLE}.product_id ;;
}
fields (campo)
El parámetro fields le permite especificar qué campos de la vista base y las combinaciones de una exploración se muestran en el selector de campos. Si no usa el parámetro fields, Looker expondrá todos los campos.
Para especificar los campos que quieres que se muestren en el selector de campos, usa una lista de campos o conjuntos separada por comas. Para especificar los campos que quieres ocultar en el selector de campos, usa el conjunto ALL_FIELDS* con una lista separada por comas de los campos o conjuntos que quieras excluir. Cada uno de ellos debe ir precedido de un guion (-).
Por ejemplo, puedes usar el siguiente código de LookML para mostrar solo una selección de campos de la exploración aircraft en el selector de campos:
explore: aircraft {
fields: [
aircraft.aircraft_model_code,
aircraft.aircraft_engine_code,
aircraft.count,
aircraft.city,
aircraft.country,
aircraft.zip,
]
}
En este ejemplo, la Exploración Aircraft (Avión) solo muestra las dimensiones Aircraft Model Code (Código de modelo de avión), Aircraft Engine Code (Código de motor de avión), City (Ciudad), Country (País) y Zip (Código postal), así como la medida Count (Recuento) en el selector de campos.
label (campo)
El parámetro label de un campo te permite cambiar el nombre que se muestra en el selector de campos sin modificar la forma en que se hace referencia a él en LookML. Si no se especifica ninguna etiqueta, se usará el nombre del campo de forma predeterminada.
Por ejemplo, puedes usar el parámetro label para definir una etiqueta de la dimensión cost de la siguiente manera:
dimension: cost {
label: "price"
type: number
sql: ${TABLE}.cost ;;
}
En este ejemplo, la dimensión Coste tiene la etiqueta price en el selector de campos.
view_label (campo)
El parámetro view_label de un campo te permite cambiar el nombre de la vista en la que se muestra el campo en el selector de campos sin modificar la forma en que se hace referencia a él en LookML. Si no se especifica ninguna etiqueta, el campo aparece en la etiqueta de la vista en la que se define.
Por ejemplo, puedes usar el parámetro view_label de la siguiente manera para especificar una etiqueta de vista de la dimensión cost:
dimension: cost {
view_label: "Cost Information"
type: number
sql: ${TABLE}.cost ;;
}
En este ejemplo, Looker muestra la dimensión Coste en la etiqueta de vista Información de costes del selector de campos.
group_label (campo)
El parámetro group_label le permite combinar campos en una lista desplegable común dentro de una vista del selector de campos.
En este ejemplo, el grupo Información de envío incluye los campos Ciudad de envío, País de envío y Provincia de envío:
group_item_label (campo)
Cuando los campos se muestran en una etiqueta de grupo, es posible que no sea necesario que se muestren sus nombres o etiquetas completos en el selector de campos. En el ejemplo que se ha mostrado anteriormente para group_label (campo), la etiqueta del grupo ya indica que los campos están relacionados con el envío. En estos casos, puede añadir el parámetro group_item_label a cada uno de estos campos agrupados para cambiar su aspecto en la etiqueta del grupo.
En este ejemplo, el grupo Información de envío incluye los campos Ciudad, País y Estado:
