etiqueta (para campos)

En esta sección, se hace referencia al parámetro label que forma parte de un campo.

label también se puede usar como parte de un modelo, como se describe en la página de documentación del parámetro label (para modelos).

label también se puede usar como parte de una exploración, como se describe en la página de documentación del parámetro label (para exploraciones) .

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

label también se puede usar como parte de una línea de referencia, como se describe en la página de documentación Parámetros de la línea de referencia del panel.

Uso

view: view_name {
  dimension: field_name {
    label: "desired label name"
  }
}

Jerarquía Ver archivo view Tipo de campo label

Tipos de campos posibles Dimensión, grupo de dimensiones, medición, filtro y parámetro Acepta Una string.

Definición

label ayuda a que las exploraciones sean más fáciles de usar, ya que te permite elegir cómo aparecerán los nombres de los campos en el selector de campos y en la tabla de datos de una exploración. Si no se especifica ninguna etiqueta, la etiqueta predeterminada es el nombre del campo.

Nota: label solo afecta la forma en que se muestran los nombres de los campos en el contenido de Looker. label no afecta la forma en que te refieres al campo en LookML ni cambia el valor en la base de datos. Usa la sintaxis ${view_name.field_name} en tus archivos LookML para hacer referencia a los campos con etiquetas.

Variables de Liquid con label

Puedes usar variables de Liquid con el parámetro label. Las variables de Liquid te permiten acceder a datos como información sobre un modelo o una exploración, filtros aplicados a un campo y valores de atributos del usuario. Puedes usar variables de Liquid para cambiar de forma dinámica el valor de label y, así, modificar la apariencia del campo en el selector de campos y las visualizaciones de datos.

Las variables de Liquid que devuelven un valor basado en un filtro, como _filters, o que requieren que primero se ejecute una consulta, como in_query, no cambiarán el nombre del campo en el selector de campos. En esos casos, el nombre del campo solo se cambiará en la visualización resultante.

Por ejemplo, la variable de Liquid {{ _user_attributes['name_of_attribute'] }} reemplaza la variable de Liquid por el valor del atributo del usuario especificado. Si un usuario tenía un atributo de usuario llamado name con el valor "John Smith", la siguiente sintaxis de label cambiaría el nombre del campo en el selector de campos a John Smith:

label: "{{ _user_attributes['name'] }}"

En el siguiente ejemplo, la dimensión name usa la estructura {% if %} {% else %} {% endif %} de Liquid con la variable _user_attributes['name_of_attribute'] de Liquid para cambiar su valor de label según un atributo del usuario company:

dimension: name {
  label: "{% if _user_attributes['company'] == 'Looker' %} Employee Name {% else %} Customer Name {% endif %}"
  sql: ${TABLE}.name ;;
}

Puedes ver ejemplos adicionales del uso de label con variables de Liquid para definir etiquetas dinámicas en la página de prácticas recomendadas Formas interesantes de usar Liquid en las etiquetas.

Ejemplo

Haz que esta métrica aparezca como Cantidad de clientes en lugar de Recuento de clientes distintos en el selector de campos.

measure: customer_count_distinct {
  label: "# of Customers"
  type: count_distinct
  sql: ${customer.id} ;;
}

Aspectos para tener en cuenta

El IDE marca las etiquetas duplicadas en una vista

Para evitar etiquetas de campo duplicadas en la misma vista, el IDE de Looker muestra un ícono de información junto al número de línea de cualquier etiqueta de campo duplicada en un archivo de vista de LookML. Si te desplazas sobre el ícono de información junto al número de línea, la información sobre la herramienta indica que ya hay un campo con la etiqueta en la vista.

El IDE de Looker mostrará esta misma información en el panel Ayuda rápida si seleccionas el texto de la instrucción label en el IDE: