Para escribir LookML eficaz, debes poder hacer referencia a dimensiones, medidas, vistas o tablas derivadas existentes, incluso si no están en el alcance actual. También debes hacer referencia a las columnas de la tabla subyacente y usar las llamadas a funciones del dialecto de tu base de datos para manipular esos valores.
Operador de sustitución ($)
El operador de sustitución, $, hace que el código de LookML sea más reutilizable y modular, lo que te permite hacer referencia a otras vistas y tablas derivadas, columnas en una tabla de SQL o dimensiones y medidas de LookML. Esto es bueno por dos motivos. Primero, es posible que ya hayas resuelto una dimensión o medida muy compleja, y no tendrás que volver a escribir toda la complejidad. En segundo lugar, si cambias algo sobre una dimensión o medida, ese cambio puede propagarse a todo lo demás que dependa de ella.
Hay varias formas de usar el operador de sustitución:
${TABLE}.column_name hace referencia a una columna de la tabla que está conectada a la vista en la que estás trabajando. Por ejemplo:
dimension: customer_id {
type: number
sql: ${TABLE}.customer_id ;;
}
${field_name} hace referencia a una dimensión o medida dentro de la vista en la que estás trabajando. Por ejemplo:
measure: total_population {
type: sum
sql: ${population} ;;
}
${view_name.field_name} hace referencia a una dimensión o medida de otra vista. Por ejemplo:
dimension: lifetime_orders {
type: number
sql: ${user_order_facts.lifetime_orders} ;;
}
${view_name.SQL_TABLE_NAME} hace referencia a otra vista o tabla derivada. Ten en cuenta que SQL_TABLE_NAME en esta referencia es una cadena literal; no necesitas reemplazarla por nada. Por ejemplo:
explore: trips {
view_label: "Long Trips"
# This will ensure that we only see trips that are longer than average!
sql_always_where: ${trips.trip_duration}>=(SELECT tripduration FROM ${average_trip_duration.SQL_TABLE_NAME});;
}
${view_name.SQL_TABLE_NAME}no funciona con el parámetrosql_triggerque se usa con los grupos de datos.
Alcance y nombres
Puedes nombrar Exploraciones, vistas, campos y conjuntos. Estos identificadores de Looker se escriben sin comillas.
Los campos y conjuntos de LookML tienen nombres completos y nombres cortos:
- Los nombres completos tienen el formato
<view>.<field-name | set-name>. El lado izquierdo indica el alcance, que es la vista que contiene el campo o el conjunto. El lado derecho especifica el campo o el nombre del conjunto en particular. - Los nombres cortos tienen el formato
<field-name | set-name>, sin un punto de separación. Looker expande los nombres cortos a nombres completos usando el alcance en el que se usan.
A continuación, se muestra un ejemplo que muestra muchas formas de nombres y alcance. Este es un grupo de campos poco realista, pero se muestra para demostrar una variedad de expresiones de alcance posibles.
view: orders { # "orders" becomes the containing scope
measure: count { # short name, equivalent to orders.count
type: count
}
dimension: customer_id { # short name, equivalent to orders.customer_id
type: number
sql: ${TABLE}.customer_id ;;
}
dimension: customer_address { # short name, equivalent to orders.customer_address
sql: ${customer.address} ;; # full name, references a field defined in the "customer" view
}
set: drill_fields { # short name, equivalent to orders.drill_fields
fields: [
count, # short name, equivalent to orders.count
customer.id # full name, references a field defined in the "customer" view
]
}
}
En la declaración dimension: customer_address, ten en cuenta que la vista subyacente para el bloque de SQL (customer) es diferente del alcance de la vista de inclusión (orders). Esto puede ser útil cuando necesitas comparar campos entre dos vistas diferentes.
Cuando una vista (la llamaremos "vista A") hace referencia a un campo definido en una vista diferente (la llamaremos "vista B"), debes tener en cuenta lo siguiente:
- El archivo de la vista B debe incluirse en el mismo modelo que la vista A, con el
includeparámetro. - La vista B debe unirse a la vista A en una o más Exploraciones. Consulta nuestra página Trabajar con uniones en LookML para obtener información sobre las uniones.
Dialecto de SQL
Looker admite muchos tipos de bases de datos, como MySQL, Postgres, Redshift y BigQuery. Cada base de datos admite un conjunto de funciones ligeramente diferente con nombres de funciones diferentes, al que se hace referencia como el dialecto de SQL.
LookML está diseñado para funcionar con todos los dialectos de SQL, y LookML no prefiere un dialecto sobre el otro. Sin embargo, deberás incluir expresiones de código SQL (conocidas como bloques de SQL) en ciertos parámetros de LookML. Con estos parámetros, Looker pasa la expresión de SQL directamente a tu base de datos, por lo que debes usar el dialecto de SQL que coincida con tu base de datos. Por ejemplo, si usas una función de SQL, debe ser una función que admita tu base de datos.
Bloques de SQL
Algunos parámetros de LookML requieren que proporciones expresiones de SQL sin procesar para que Looker pueda comprender cómo recuperar datos de tu base de datos.
Los parámetros de LookML que comienzan con sql_ esperan una expresión de SQL de alguna forma. Algunos ejemplos son: sql_always_where, sql_on y sql_table_name. El parámetro de LookML más común para los bloques de SQL es sql, que se usa en las definiciones de campos de dimensión y medida para especificar la expresión de SQL que define la dimensión o la medida.
El código que especificas en un bloque de SQL puede ser solo un nombre de campo o tan complejo como una subselección correlacionada. El contenido puede ser bastante complejo y adaptarse a casi cualquier necesidad que puedas tener para expresar la lógica de consulta personalizada en SQL sin procesar. Ten en cuenta que el código que usas en los bloques de SQL debe coincidir con el dialecto de SQL que usa la base de datos.
Ejemplos de bloques de SQL para dimensiones y medidas
A continuación, se muestran ejemplos de bloques de SQL para dimensiones y medidas. El operador de sustitución de LookML ($) puede hacer que estas sql declaraciones parezcan engañosamente diferentes de SQL. Sin embargo, después de que se realiza la sustitución, la cadena resultante es SQL puro, que Looker inserta en la cláusula SELECT de la consulta.
dimension: id {
primary_key: yes
sql: ${TABLE}.id ;; # Specify the primary key, id
}
measure: average_cost {
type: average
value_format: "0.00"
sql: ${order_items.cost} ;; # Specify the field that you want to average
}
dimension: name {
sql: CONCAT(${first_name}, ' ', ${last_name}) ;;
}
dimension: days_in_inventory {
type: int
sql: DATEDIFF(${sold_date}, ${created_date}) ;;
}
Como se muestra en las últimas dos dimensiones, los bloques de SQL pueden usar funciones compatibles con la base de datos subyacente (como las funciones CONCAT y DATEDIFF de MySQL en este ejemplo).
Ejemplo de bloque de SQL con una subselección correlacionada
Puedes colocar cualquier instrucción de SQL en el bloque de SQL de un campo, incluida una subselección correlacionada. A continuación, se muestra un ejemplo:
view: customers {
dimension: id {
primary_key: yes
sql: ${TABLE}.id ;;
}
dimension: first_order_id {
sql: (SELECT MIN(id) FROM orders o WHERE o.customer_id=customers.id) ;;
# correlated subselect to derive the value for "first_order_id"
}
}
Ejemplo de bloque de SQL para tablas derivadas
Las tablas derivadas usan el bloque de SQL para especificar la consulta que deriva la tabla. A continuación, se muestra un ejemplo:
view: user_order_facts {
derived_table: {
sql: # Get the number of orders for each user
SELECT
user_id
, COUNT(*) as lifetime_orders
FROM orders
GROUP BY 1 ;;
}
# later, dimension declarations reference the derived column(s)
dimension: lifetime_orders {
type: number
}
}
Referencias de tipo de campo de LookML
Cuando haces referencia a un campo de LookML existente dentro de otro campo, puedes indicarle a Looker que trate el campo al que se hace referencia como un tipo de datos específico usando dos puntos (::) seguidos del tipo elegido. Por ejemplo, si haces referencia a la dimensión orders.created_date dentro de otro campo, puedes usar la sintaxis ${orders.created_date::date} para asegurarte de que el campo created_date se trate como un campo de fecha en el SQL que genera Looker, en lugar de convertirse en una cadena.
El tipo de datos que puedes usar en una referencia depende del tipo de datos del campo original al que haces referencia. Por ejemplo, si haces referencia a un campo de cadena, el único tipo de datos que puedes especificar es ::string. Esta es la lista completa de referencias de tipo de campo permitidas que puedes usar para cada tipo de campo:
- En una referencia a un campo de cadena, puedes usar
::string. - En una referencia a un campo numérico, puedes usar
::stringy::number. - En una referencia a un campo de fecha o hora, puedes usar
::string,::datey::datetime.Las referencias que usan::stringy::datemuestran datos en la zona horaria de la consulta, mientras que las referencias que usan::datetimemuestran datos en la zona horaria de la base de datos. - En una referencia a un campo yesno, puedes usar
::string,::numbery::boolean. Las referencias de campo que usan el tipo::booleanno están disponibles para los dialectos de bases de datos que no admiten el tipo de datos Boolean. - En una referencia a un campo de ubicación, puedes usar
::latitudey::longitude.
Usa referencias de tipo de campo de LookML con campos de fecha
Por ejemplo, supongamos que tienes una dimensión enrollment_month y una dimensión graduation_month, las cuales se crearon dentro de grupos de dimensiones de type: time. En este ejemplo, la dimensión enrollment_month se produce con el siguiente grupo de dimensiones de type: time:
dimension_group: enrollment {
type: time
timeframes: [time, date, week, month, year, raw]
sql: ${TABLE}.enrollment_date ;;
}
Del mismo modo, la dimensión graduation_month se crea con el siguiente grupo de dimensiones de type: time:
dimension_group: graduation {
type: time
timeframes: [time, date, week, month, year, raw]
sql: ${TABLE}.graduation_date ;;
}
Con las dimensiones enrollment_month y graduation_month, puedes calcular cuántos meses o años pasaron entre la inscripción y la graduación de un estudiante creando un grupo de dimensiones de type: duration. Sin embargo, debido a que algunos campos de fecha se convierten en cadenas en el SQL que genera Looker, establecer las dimensiones enrollment_month y graduation_month como los valores de sql_start y sql_end puede generar un error.
Para evitar un error que resulte de que estos campos de hora se conviertan en cadenas, una opción es crear un grupo de dimensiones de type: duration, que haga referencia a los períodos raw de los grupos de dimensiones enrollment y graduation en los parámetros sql_start y sql_end:
dimension_group: enrolled {
type: duration
intervals: [month, year]
sql_start: ${enrollment_raw} ;;
sql_end: ${graduation_raw} ;;
}
En la IU de Exploración, esto genera un grupo de dimensiones llamado Duration Enrolled, con dimensiones individuales Months Enrolled y Years Enrolled.
Una alternativa más simple a usar el período raw en un grupo de dimensiones de type: duration es especificar el tipo de referencia ::date o ::datetime para los campos a los que se hace referencia en los parámetros sql_start y sql_end.
dimension_group: enrolled {
type: duration
intervals: [month, year]
sql_start: ${enrollment_month::date} ;;
sql_end: ${graduation_month::date} ;;
}
El LookML de este ejemplo también crea un grupo de dimensiones Duration Enrolled, pero usar la referencia ::date permite que las dimensiones enrollment_month y graduation_month se usen sin usar un período raw ni convertirlas en cadenas con SQL.
Para obtener un ejemplo adicional de cómo se pueden usar las referencias de tipo de campo de LookML para crear grupos de dimensiones personalizadas de type: duration, consulta la dimension_group página de documentación del parámetro.
Esta sintaxis no está disponible con las medidas de
type: list, a las que no se puede hacer referencia a partir de Looker 6.8.
Constantes de LookML
El parámetro constant te permite especificar una constante que puedes usar en todo un proyecto de LookML. Con las constantes de LookML, puedes definir un valor una vez y hacer referencia a él en cualquier parte de tu proyecto en la que se acepten cadenas, lo que reduce la repetición en tu código de LookML.
Las constantes se deben declarar en un archivo de manifiesto del proyecto, y el valor de una constante debe ser una cadena. Por ejemplo, puedes definir una constante city con el valor "Okayama" de la siguiente manera:
constant: city {
value: "Okayama"
}
Luego, se puede hacer referencia a la constante city en todo el proyecto con la sintaxis @{city}. Por ejemplo, puedes usar la constante city con el parámetro label en la Exploración users:
explore: users {
label: "@{city} Users"
}
Luego, Looker muestra Okayama Users en el menú Explorar y en el título de la Exploración, en lugar de Users predeterminado.
Para obtener más información y ejemplos de cómo puedes usar las constantes de LookML para escribir código reutilizable, consulta la página de documentación del parámetro constant.