Looker BlocksTM son modelos de datos previamente compilados para patrones de análisis y fuentes de datos comunes. En esta página, se describe cómo los desarrolladores pueden personalizar los bloques de Looker que se instalan desde Looker Marketplace. Looker Marketplace es una ubicación central para encontrar, implementar y administrar muchos tipos de contenido de Looker, como aplicaciones, visualizaciones y complementos.
Para obtener más información sobre todos los bloques de Looker disponibles, incluidos los que no están disponibles actualmente en Looker Marketplace, así como otros métodos de personalización de bloques, consulta la página de documentación de los bloques de Looker.
Requisitos para instalar y administrar bloques de Looker desde Looker Marketplace
Antes de que puedas instalar y usar algunos bloques de Looker Marketplace, el administrador de Looker debe habilitar estas funciones:
- Si instalas el bloqueo a través de Looker Marketplace, el administrador de Looker debe habilitar la función Marketplace.
Si el bloque específico contiene un parámetro
local_dependency
, el administrador de Looker también debe habilitar la función Importación de proyectos locales Labs. Estos bloques contienen un parámetrolocal_dependency
:- Analítica de marketing digital
- Estadísticas de ventas
- Estadísticas web
Los usuarios deben tener los permisos develop
, manage_models
y deploy
para instalar y administrar paquetes desde Marketplace.
Consulta la página de documentación de Looker Marketplace para obtener información sobre cómo instalar y administrar bloques de Looker desde Looker Marketplace.
Acceder a LookML en busca de un bloqueo de Marketplace
Los bloques basados en proyectos que usan mejoras se instalan desde Marketplace como un único proyecto de CONFIG que se puede editar y que importa de forma remota el proyecto CORE, que contiene todo el código de LookML y la parametrización constante.
Una vez que un bloque esté instalado desde Marketplace, puedes acceder a su proyecto desde el menú Desarrollar haciendo clic en el nombre del proyecto en la lista de proyectos. El nombre de un bloque de mejoras de Marketplace suele anteponer marketplace_ seguido del ID de la ficha.
Aunque no puedes modificar directamente el proyecto CORE de solo lectura de un bloque, te recomendamos que uses el LookML que se define en los archivos CORE de solo lectura del bloque como referencia cuando personalices los archivos CONFIG del bloque. Para ver los archivos CORE del bloque, navega a los archivos del proyecto del bloque en el IDE y expande el directorio imported_projects
en el navegador de archivos IDE.
Bloquea la estructura de archivos
Cuando instalas un bloque creado para perfeccionar, estos archivos se crean automáticamente como parte de la parte CONFIG del proyecto de bloque:
Nombre del archivo | Acceso | Función |
---|---|---|
<model_name>.model.lkml |
Solo lectura para todos los usuarios | Archivo de modelo Virtualque está vinculado a la instalación del bloque controla la importación de cualquier modelo del proyecto CORE del bloque. Cuando se desinstala o actualiza un bloque, se borran los archivos de modelo asociados, lo que evita conflictos de modelos entre varias instalaciones de bloque. |
manifest.lkml |
La pueden editar los usuarios con permisos de develop |
Describe el proyecto y sus dependencias externas. Contiene el ID de la ficha de Marketplace para la instalación del bloque y facilita la importación remota de los archivos del proyecto CORE del bloque a través de la palabra clave marketplace . |
marketplace_lock.lkml |
Solo lectura para todos los usuarios | Contiene una referencia a la palabra clave marketplace_ref del archivo de manifiesto que controla la importación remota del proyecto CORE. Proporciona la ficha específica, la versión y la información del modelo asociada con la instalación. Contiene información sobre las constantes que se configuran durante la instalación (y que se pueden actualizar con la opción Administrar en la IU de Marketplace). |
refinements.lkml |
La pueden editar los usuarios con permisos de develop |
Permite a los desarrolladores definir mejor las vistas y las exploraciones definidas en los archivos de proyecto CORE importados. |
Personaliza un bloqueo de Marketplace
Habilita el Modo de desarrollo para personalizar los archivos editables del bloque.
Si tienes permisos develop
, puedes personalizar el código LookML en el archivo refinements.lkml
del proyecto CONFIG del bloque. Puedes definir mejor las vistas y exploraciones que ya están definidas en el proyecto CORE del bloque, o incluso agregar nuevas vistas y exploraciones que aún no están definidas en el proyecto CORE. Todo lo que es posible con las definiciones más precisas de LookML en otros proyectos de LookML es posible en el archivo refinements.lkml
del bloque. La combinación de la definición y la versión original de LookML se comporta como si fuera la versión original de LookML para el objeto.
También puedes realizar cambios en el archivo manifest.lkml
del proyecto CONFIG para especificar las dependencias que se deben capturar para ese bloque.
No estás limitado a modificar estos archivos para obtener las personalizaciones que deseas. También puedes crear archivos nuevos en el proyecto CONFIG. Solo asegúrate de aplicar include
en cualquier archivo nuevo en el archivo refinements.lkml
.
Cómo personalizar el archivo de mejoras
Si tienes permisos develop
, puedes agregar LookML personalizado al proyecto CONFIG para mezclar datos adicionales o cambiar el modelo analítico principal del bloque. Puedes crear vistas nuevas y unirlas a las exploraciones existentes, definir campos nuevos o redefinir campos existentes, o aplicar etiquetas según sea necesario para crear un modelo para el análisis que quieras proporcionar. Si creaste archivos nuevos en el proyecto CONFIG, debes include
en el archivo de perfeccionamiento.
Por ejemplo, supongamos que instalaste un bloque y su archivo refinements.lkml
contiene lo siguiente:
include: "//<listing_id>/**/*.view.lkml"
include: "//<listing_id>/**/*.explore.lkml"
donde listing_id
es el valor del parámetro listing
del archivo manifest.lkml
.
Puedes definir mejor las opciones para agregar una nueva dimensión a una vista llamada flights
:
include: "//<listing_id>/**/*.view.lkml"
include: "//<listing_id>/**/*.explore.lkml"
view: +flights {
dimension: air_carrier {
type: string
sql: ${TABLE}.air_carrier ;;
}
}
También puedes aplicar una etiqueta a una exploración llamada aircraft
para que aparezca en la IU como Aircraft Simplified:
include: "//<listing_id>/**/*.view.lkml"
include: "//<listing_id>/**/*.explore.lkml"
explore: +aircraft {
label: "Aircraft Simplified"
}
El archivo refinements.lkml
se incluye automáticamente en el archivo de modelo "virtual" del bloque, que, en esencia, importa los modelos del proyecto CORE.
Consulta la documentación sobre las mejoras en LookML para obtener más información sobre este tema avanzado.
Cómo personalizar el archivo de manifiesto editable
En los bloques que usan mejoras, los proyectos CORE y CONFIG tienen archivos de manifiesto. sin embargo, solo se puede editar el archivo de manifiesto del proyecto CONFIG.
Puedes editar el archivo CONFIG manifest.lkml
para agregar parámetros del proyecto a los que ya aparecen en el archivo de manifiesto del proyecto CORE. Por ejemplo, puedes agregar una local_dependency
para unir tu bloque a otro bloque en la misma instancia de Looker.
Antes de que puedas usar o compilar un bloque que contenga un parámetro
local_dependency
, un administrador de Looker debe habilitar la función Importación de proyectos locales Labs.
Cómo actualizar valores de constantes
Las constantes del bloque se definen en el archivo de manifiesto del proyecto CORE importado. Si se permite anular el valor de una constante, se debe hacer en la IU de Marketplace durante la configuración o actualizando el bloque. Para actualizar un bloqueo, los usuarios deben tener los permisos develop
, manage_models
y deploy
.
Actualiza un bloque para anular el valor de una constante:
- En Looker Marketplace, navega al bloque que quieres actualizar.
- Haz clic en el botón Administrar.
- Junto al nombre del bloque que quieres actualizar, haz clic en el ícono de ajustes. Se abrirá la ventana de configuración de bloques.
- Realiza cambios en los valores constantes según sea necesario.
- Haz clic en Update para cerrar la ventana de configuración de bloques y actualizar el bloque con tus cambios.
Los cambios se reflejan en el archivo de solo lectura marketplace_lock.lkml
del proyecto instalado.
Preservar las personalizaciones de un bloque de Marketplace que usa extensiones
Algunos de los bloques disponibles en Looker Marketplace estaban compuestos por proyectos que usan extensiones de LookML. Looker está convirtiendo todos los bloqueos de Marketplace para las instancias de Looker 21.8 o versiones posteriores en una estructura de proyecto que usa mejoras en LookML y quitará la compatibilidad con los bloques basados en extends.
Looker te recomienda que instales la versión basada en perfeccionamientos de cualquier bloque de Marketplace que tengas en tu instancia a medida que estos bloques estén disponibles, y se reemplazarán los creados con extensiones. Aunque este proceso de reemplazo es sencillo: puedes instalar el nuevo bloque (refinamientos) de la lista de bloques de Looker Marketplace y desinstalar el bloque original (extends) en la página Administrar de Looker Marketplace, pero no conservará ninguna de las personalizaciones que se hayan realizado al bloque que se creó con extensiones. Tampoco se transferirá ningún contenido ni función de Looker que se base en ese contenido (paneles, Exploraciones, publicaciones de contenido programadas, alertas) del bloque original al nuevo.
En esta sección, se describe cómo conservar las personalizaciones en un bloque compilado con proyectos que usan extensiones que, de otro modo, serían difíciles o llevarían mucho tiempo replicar desde cero.
Para conservar las personalizaciones de tu bloque, un usuario con la capacidad de instalar y administrar paquetes desde Marketplace debe hacer lo siguiente:
- Actualizar el proyecto CONFIG del bloque original a fin de prepararlo para la migración
- Instala la nueva versión del bloque desde Looker Marketplace
- Cómo transferir las personalizaciones al nuevo bloque de mercado
- Cómo volver a crear contenido de Looker según el bloque original
- Desinstala la versión del bloque que se compiló con las extensiones.
Actualiza un bloque personalizado a fin de prepararte para la migración
En esta sección, se describe cómo actualizar archivos de proyecto clave en un bloque que se compiló con extensiones para que puedas copiar las personalizaciones del bloque en una nueva versión del bloque basada en ajustes. Un bloque basado en un proyecto que usa extensiones se instala desde Marketplace como un proyecto de CORE de solo lectura y un proyecto CONFIG editable.
Navega al proyecto CONFIG del bloque desde la sección Develop de una de las siguientes maneras:
- Haz clic en la opción Projects y, luego, en el nombre del proyecto.
- Haz clic en el nombre del proyecto CONFIG del bloque en la lista de proyectos.
Los nombres de los proyectos de CONFIG suelen terminar en _config, mientras que el nombre del proyecto CORE no suele tener un sufijo.
Abre el archivo de modelo del proyecto, que puede ser similar al siguiente:
explore: ga_sessions_config {
extends: [ga_sessions_core]
extension: required
join: user_sales_data {
sql_on: ${user_sales_data.full_visitor_id} = ${ga_sessions.full_visitor_id} ;;
}
join: sales__by__category {
sql: LEFT JOIN UNNEST(${user_sales_data.sales_by_category}) as sales__by__category;;
}
}
explore: future_input_config {
extends: [future_input_core]
extension: required
join: future_purchase_prediction {
type: left_outer
sql_on: ${future_input.full_visitor_id} = ${future_purchase_prediction.full_visitor_id} ;;
relationship: one_to_one
}
}
En el modo de desarrollo:
- Borra las líneas
extends
yextension
completas. - Borra
_config
de los nombres deexplore
. - Antepón
+
a los nombresexplore
.
El ejemplo de archivo de modelo anterior se vería de la siguiente manera:
- Borra las líneas
explore: +ga_sessions {
join: user_sales_data {
sql_on: ${user_sales_data.full_visitor_id} = ${ga_sessions.full_visitor_id} ;;
}
join: sales__by__category {
sql: LEFT JOIN UNNEST(${user_sales_data.sales_by_category}) as sales__by__category;;
}
}
explore: +future_input {
join: future_purchase_prediction {
type: left_outer
sql_on: ${future_input.full_visitor_id} = ${future_purchase_prediction.full_visitor_id} ;;
relationship: one_to_one
}
}
- Copia y conserva el contenido de este archivo para un paso futuro.
Cómo instalar el nuevo bloque de mercado
Un bloque que se basa en un proyecto que usa mejoras se instala desde Marketplace como un solo proyecto de LookML editable que importa de forma remota el proyecto que contiene todo LookML y la parametrización constante.
- Selecciona el ícono de tienda en la barra de menú de Looker para navegar a Looker Marketplace.
- Haz clic en la ficha para el nuevo bloqueo de Marketplace basado en mejoras. Este bloque tiene el mismo nombre que el bloque existente que se compiló con extensiones.
- Haz clic en Install para instalar el bloque nuevo. Una vez que se instale este bloque, verás dos fichas idénticas en la página Administrar de Looker Marketplace.
Transfiriendo las personalizaciones al nuevo bloqueo de Marketplace
En esta sección, se describe cómo transferir las actualizaciones que hiciste al bloque original (extends) al nuevo bloque (refinamientos).
Desde la sección Develop, abre el proyecto del bloque nuevo de una de las siguientes maneras:
- Haz clic en la opción Proyectos y, luego, en el nombre del proyecto.
- Haz clic en el nombre del proyecto del bloque en la lista de proyectos.
El nombre de un bloque de mejoras de Marketplace suele anteponer marketplace_ seguido del ID de la ficha.
En el archivo
refinements.lkml
, pega el contenido actualizado del archivo de modelo del bloque original (extiende). Asegúrate de conservar las sentenciasinclude
que ya estén en el archivo de mejoras.
Recrea contenido de Looker a partir del bloque original
El último paso para adoptar la versión basada en mejoras de un bloque de Marketplace es desinstalar la versión original del bloque basada en extensiones. Algunos bloques basados en extensiones contienen paneles y Explorar de LookML precompilados. Si los usuarios crearon alertas o entregas programadas basadas en cualquier panel de LookML definido en el bloque original (extender), esas alertas o programas se inhabilitarán o fallarán, respectivamente, una vez que el bloqueo se desinstale de Looker Marketplace.
Debes volver a crear estas alertas o entregas programadas en los paneles de LookML del nuevo bloque (perfeccionamientos). Los administradores y usuarios de Looker con los permisos adecuados para los programas y las alertas pueden usar las Alertas y Programa páginas en la sección Administrador para buscar los nombres de los paneles del bloque (extender) y, luego, crear nuevas alertas o entregas programadas según sea necesario en los paneles correspondientes del bloque (perfeccionamiento).
También debes modificar cualquier otro contenido de Looker que haga referencia a las exploraciones o los paneles de LookML del bloque original (extiende) para que apunten al nuevo bloque (perfeccionamientos), según sea necesario.
Desinstalar el bloque original
Para desinstalar la versión del bloque que se compiló con las extensiones, haz lo siguiente:
Selecciona el ícono de tienda en la barra de menú de Looker para navegar a Looker Marketplace.
En Looker Marketplace, selecciona Administrar en el menú de navegación del lado izquierdo para abrir la página Administrar.
En la página Administrar, haz clic en el ícono de papelera para desinstalar el bloque original (extiende). Puedes diferenciar la lista de bloques de extensiones de la lista de bloques de refinamientos si observas los números de versión. El bloque de extensiones será una versión principal detrás del bloque de mejoras. Por ejemplo, el bloque de extensiones puede ser la versión
1.0.4
y el bloque de refinamiento puede ser la versión2.0.0
.
Una vez que se desinstale el bloque, la lista de bloques original (extendida) desaparecerá del panel de navegación izquierdo en la instancia de Looker, sus exploraciones desaparecerán de la sección Explorar, sus paneles de LookML desaparecerán de la carpeta Paneles de LookML y las alertas o entregas programadas basadas en los paneles de LookML del bloque se inhabilitarán o fallarán, respectivamente.
Solucionar problemas de un bloqueo
Si un bloque de mercado muestra errores, es posible que tu esquema no coincida con la estructura del bloque.
También puedes comprobar que se hayan definido correctamente las constantes que se proporcionaron durante la instalación del bloque, que representan la conexión, la base de datos o el esquema del bloque. Para ello, puedes hacer lo siguiente:
Selecciona el ícono de tienda en la barra de menú de Looker para navegar a Looker Marketplace.
En Looker Marketplace, selecciona Administrar en el menú de navegación del lado izquierdo para abrir la página Administrar.
En la página Administrar, haz clic en el ícono de ajustes del bloque para ver sus ajustes de configuración.
En la ventana Update configurations, confirma que el bloque esté configurado correctamente. Después de realizar cualquier cambio, haz clic en Update para guardar las actualizaciones y cerrar la ventana de configuración de bloques.