Personaliza los bloques de Looker Marketplace

Los bloques de Looker son modelos de datos prediseñados para patrones analíticos 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 y los métodos alternativos de personalización de bloques, consulta la página de documentación de bloques de Looker.

Requisitos para instalar y administrar bloques de Looker desde Looker Marketplace

Antes de instalar y usar algunos bloques de Looker Marketplace, ten en cuenta los siguientes requisitos:

• Si instalas tu bloque a través de Looker Marketplace, tu administrador de Looker debe habilitar la función Marketplace.
• Los usuarios deben tener permisos de develop, manage_models y deploy para instalar y administrar paquetes de Marketplace.

• Si el bloque en particular contiene un parámetro local_dependency, el bloque usa el proceso de importación de proyectos locales. Consulta la página de documentación Cómo importar archivos de otros proyectos para obtener detalles sobre la importación de proyectos. Los siguientes bloques contienen un parámetro local_dependency:

  • Estadísticas de marketing digital
  • Estadísticas de ventas
  • Estadísticas web

Consulta la página de documentación de Looker Marketplace para obtener información sobre cómo instalar y administrar Looker Blocks desde Looker Marketplace.

Cómo acceder al LookML de un bloque de Marketplace

Los bloques basados en proyectos que usan refinamientos se instalan desde Marketplace como un solo proyecto CONFIG editable que importa de forma remota el proyecto CORE, que contiene todo el código LookML y la parametrización constante.

Una vez que se instala un bloque desde Marketplace, puedes acceder a su proyecto desde el menú Develop haciendo clic en el nombre del proyecto en la lista de proyectos. Por lo general, el nombre de un bloque de refinamientos de Marketplace comienza con marketplace_ seguido del ID de la ficha.

Aunque no puedes modificar directamente un proyecto CORE de solo lectura de un bloque, es posible que desees usar 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 explorador de archivos del IDE.

Estructura del archivo de bloqueo

Cuando instalas un bloque creado para refinamientos, estos archivos se crean automáticamente como parte de la sección CONFIG del proyecto de bloque:

Cómo personalizar un bloque de Marketplace

Habilita el modo de desarrollo para personalizar los archivos editables del bloque.

Si tienes permisos de develop, puedes personalizar el LookML en el archivo refinements.lkml del proyecto CONFIG del bloque. Puedes definir mejor las vistas y las Exploraciones que ya están definidas en el proyecto CORE del bloque o incluso agregar vistas y Exploraciones nuevas que aún no estén definidas en el proyecto CORE. Todo lo que es posible con los refinamientos de LookML en otros proyectos de LookML también es posible en el archivo refinements.lkml del bloque. La combinación del perfeccionamiento y el LookML original se comporta como si fuera el LookML original del 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 include los archivos nuevos en el archivo refinements.lkml.

Cómo personalizar el archivo de refinamientos

Si tienes permisos de develop, puedes agregar LookML personalizado al proyecto CONFIG para combinar datos adicionales o cambiar el modelo analítico principal del bloque. Puedes crear vistas nuevas y unirlas a los Explorar existentes, definir campos nuevos o redefinir los existentes, o bien aplicar etiquetas según sea necesario para crear un modelo para el análisis que deseas proporcionar. Si creaste archivos nuevos en el proyecto CONFIG, debes include en el archivo de refinamientos.

Por ejemplo, supongamos que instalaste un bloque y su archivo refinements.lkml contiene el siguiente código LookML:

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 usar refinamientos 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 ;;
  }
}

O bien, puedes aplicar una etiqueta a un Explore llamado 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 básicamente importa los modelos del proyecto CORE.

Consulta la documentación sobre refinamientos de LookML para obtener más información sobre este tema avanzado.

Cómo personalizar el archivo de manifiesto editable

En los bloques que usan refinamientos, tanto los proyectos CORE como 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 un local_dependency para unir tu bloque a otro bloque en la misma instancia de Looker.

Actualiza los valores de las 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, esto 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.

Para anular el valor de una constante actualizando un bloque, sigue estos pasos:

1. En Looker Marketplace, navega al bloque que deseas actualizar.
2. Haz clic en el botón Administrar.
3. Junto al nombre del bloque que deseas actualizar, haz clic en el ícono de ajustes. Se abrirá la ventana de configuración del bloque.
4. Realiza los cambios necesarios en los valores constantes.
5. Haz clic en Actualizar para cerrar la ventana de configuración del bloque y actualizarlo con tus cambios.

Los cambios se reflejan en el archivo marketplace_lock.lkml de solo lectura del proyecto instalado.

Cómo conservar las personalizaciones de un bloque de Marketplace que usa extends

Algunos de los bloques disponibles en Looker Marketplace se componían de proyectos que usaban extends de LookML. Looker convertirá todos los bloques de Marketplace para las instancias en Looker 21.8 o versiones posteriores a una estructura de proyecto que utilice refinamientos de LookML y quitará la compatibilidad con los bloques basados en extends.

Looker recomienda que instales la versión basada en refinamientos de los bloques de Marketplace que tengas en tu instancia a medida que estén disponibles, y que reemplaces los bloques que se compilaron con extends. Si bien este proceso de reemplazo es simple (puedes instalar el nuevo bloque de refinamientos desde la lista de bloques de Looker Marketplace y desinstalar el bloque original de extensiones en la página Administrar de Looker Marketplace), no se conservará ninguna de las personalizaciones que se hayan realizado en el bloque creado con extensiones. Looker tampoco transferirá ningún contenido ni función de Looker basados en ese contenido (paneles, Explorar, entregas de contenido programadas, alertas) del bloque original al bloque nuevo.

En esta sección, se describe cómo conservar las personalizaciones de un bloque creado con proyectos que usan la función extends, 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 seguir estos pasos:

1. Actualiza el proyecto CONFIG del bloque original para prepararte para la migración
2. Instala la nueva versión del bloque desde Looker Marketplace
3. Transfiere las personalizaciones al nuevo bloque de Marketplace
4. Cómo volver a crear contenido de Looker basado en el bloque original
5. Desinstala la versión del bloque que se compiló con extends

Actualiza un bloque personalizado para prepararlo para la migración

En esta sección, se describe cómo actualizar los archivos clave del proyecto en un bloque que se compiló con extends para que puedas copiar las personalizaciones del bloque en una nueva versión del bloque basada en refinamientos. Un bloque basado en un proyecto que usa la extensión se instala desde Marketplace como un proyecto CORE de solo lectura y un proyecto CONFIG editable.

1. Navega al proyecto CONFIG del bloque desde la sección Develop 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 CONFIG del bloque en la lista de proyectos.

   Por lo general, los nombres de los proyectos de CONFIG terminan en _config, mientras que el nombre del proyecto de CORE no suele tener un sufijo.

2. Abre el archivo del modelo del proyecto, que podría verse de la siguiente manera:

    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
      }
    }

1. En Modo de desarrollo, sigue estos pasos:

   1. Borra todas las líneas extends y extension.
   2. Borra _config de los nombres de explore.
   3. Antepón + a los nombres de explore.

   El ejemplo anterior del archivo del modelo se vería de la siguiente manera:

    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
      }
    }

1. Copia y conserva el contenido de este archivo para un paso futuro.

Cómo instalar el nuevo bloque de Marketplace

Un bloque basado en un proyecto que usa refinamientos se instala desde Marketplace como un solo proyecto de LookML editable que importa de forma remota el proyecto que contiene todos los parámetros de LookML y constantes.

1. Selecciona el ícono de tienda en la barra de menú de Looker para navegar a Looker Marketplace.
2. Haz clic en la ficha del nuevo bloque de Marketplace basado en refinamientos. Este bloque tiene el mismo nombre que el bloque existente que se compiló con extends.
3. Haz clic en Instalar 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.

Cómo transferir personalizaciones al nuevo bloque de Marketplace

En esta sección, se describe cómo transferir las actualizaciones que realizaste en el bloque original (extiende) al bloque nuevo (refinamientos).

1. En 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.

   Por lo general, el nombre de un bloque de refinamientos de Marketplace comienza con marketplace_ seguido del ID de la ficha.

2. En el archivo refinements.lkml, pega el contenido actualizado del archivo del modelo del bloque original (extiende). Asegúrate de conservar las instrucciones include que ya se encuentren en el archivo de refinamientos.

Cómo volver a crear contenido de Looker basado en el bloque original

El último paso para adoptar la versión basada en refinamientos de un bloque de Marketplace es desinstalar la versión original del bloque basada en extensiones. Algunos bloques basados en extends contienen paneles y Explorar de LookML prediseñados. Si los usuarios crearon alertas o entregas programadas basadas en cualquier panel de LookML definido en el bloque original (extends), esas alertas o programaciones se inhabilitarán o fallarán, respectivamente, una vez que se desinstale ese bloque de Looker Marketplace.

Deberás volver a crear estas alertas o entregas programadas en los paneles de LookML del nuevo bloque (refinamientos). Los administradores y los usuarios de Looker con los permisos adecuados para programaciones y alertas pueden usar las páginas Alertas y programaciones en la sección de administración para buscar los nombres de los paneles del bloque (extends) y, luego, crear alertas nuevas o entregas programadas según sea necesario en los paneles correspondientes del bloque (refinements).

También debes modificar cualquier otro contenido de Looker que haga referencia a los paneles de Explorar o de LookML del bloque original (extiende) para que apunten al nuevo bloque (refinamientos), según sea necesario.

Cómo desinstalar el bloqueo original

Para desinstalar la versión del bloque que se compiló con extends, sigue estos pasos:

1. Selecciona el ícono de tienda en la barra de menú de Looker para navegar a Looker Marketplace.

2. En Looker Marketplace, selecciona Administrar en la navegación lateral izquierda para abrir la página Administrar.

3. En la página Administrar, haz clic en el ícono de papelera para desinstalar el bloque original (extiende). Puedes diferenciar la lista de bloqueo de extensiones de la lista de bloqueo de refinamientos observando los números de versión. El bloque extends estará una versión principal detrás del bloque refinements. Por ejemplo, el bloque extends puede ser la versión 1.0.4 y el bloque refinements puede ser la versión 2.0.0.

Cómo solucionar problemas relacionados con un bloqueo

Si un bloque de Marketplace muestra errores, es posible que tu esquema no coincida con la estructura del bloque.

También puedes verificar que 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, se hayan definido correctamente. Para ello, sigue estos pasos:

1. Selecciona el ícono de tienda en la barra de menú de Looker para navegar a Looker Marketplace.

2. En Looker Marketplace, selecciona Administrar en el panel de navegación principal para abrir la página Administrar.

3. En la página Administrar, haz clic en el ícono de ajustes del bloque para ver su configuración.

4. En la ventana Update configurations, confirma que el bloque esté configurado correctamente. Haz clic en Actualizar después de realizar cualquier cambio para guardar las actualizaciones y cerrar la ventana de configuración del bloque.