Las definiciones de los campos de LookML pueden cambiar con el tiempo. Por ejemplo, puede que cambie el nombre de una columna de la base de datos o que tengas que cambiar la definición de un campo de LookML por otros motivos.
Si usa la sintaxis {TABLE}.field_name
para hacer referencia a una columna de la base de datos directamente en varios lugares, debe actualizar cada referencia manualmente. Si olvidas actualizar los campos que hacen referencia a esa dimensión, pueden dejar de funcionar y Looker mostrará un error:
Para que tus proyectos de LookML sean más eficientes y fáciles de mantener, puedes definir campos en un solo lugar y usar el operador de sustitución ($
) para hacer referencia a esos campos en cualquier otro lugar.
En esta página se ofrece un ejemplo de uso del operador de sustitución (con la sintaxis ${field_name}
) para hacer referencia a una sola dimensión en las definiciones de varios campos de LookML.
Ingredientes
- Operadores de sustitución
- Parámetro
dimension
de LookML - Parámetro
sql
de LookML - Parámetro
sql_table_name
de LookML
Requisitos previos
Ejemplo: hacer referencia a la columna de la base de datos subyacente solo una vez para una dimensión
Define una columna de tabla de base de datos en un proyecto de LookML una vez con la sintaxis ${TABLE}.field_name
en el parámetro sql
de la dimensión. A continuación, haga referencia a la dimensión con la sintaxis ${field_name}
o ${view_name.field_name}
en otra parte del proyecto. De esta forma, puedes mantener la definición de LookML de la columna de la base de datos en un solo lugar (la dimensión ${TABLE}.field_name
original), lo que resulta útil si necesitas hacer referencia a ella en varios lugares de tu proyecto.
Por ejemplo, puedes usar la sintaxis ${TABLE}.sale_price
para definir una dimensión base llamada sale_price
en una vista llamada order_items
:
dimension: sale_price {
type: number
value_format_name: usd
sql: ${TABLE}.sale_price ;;
description: "The price at which an item is set to sell."
}
Cuando defina otros campos que hagan referencia a la dimensión sale_price
, puede usar la sintaxis ${sale_price}
en la vista order_items
(o la sintaxis ${order_items.sale_price}
para hacer referencia a la dimensión sale_price
en otras vistas).
dimension: profit {
type: number
value_format_name: usd
sql: ${sale_price} - ${inventory_items.cost} ;;
description: "The difference between an item's sale price and an item's cost."
}
dimension: item_gross_margin {
type: number
value_format_name: percent_2
sql: 1.0 * ${profit}/NULLIF(${sale_price},0) ;;
}
measure: total_sale_price {
type: sum
value_format_name: usd
sql: ${sale_price} ;;
}
En este ejemplo, si cambia el nombre de la columna de la dimensión sale_price
, solo tendrá que actualizar la referencia ${TABLE}.sale_price
una vez, en la definición de la dimensión sale_price
base. Este cambio se propagará automáticamente a los campos profit
, item_gross_margin
y total_sale_price
, así como a todos los demás campos que hagan referencia a la dimensión sale_price
.