Generar un modelo a partir de datos de muestra

Aprende a usar Looker (Google Cloud Core) para generar automáticamente un modelo de datos básico a partir de una conexión que se incluye en cada instancia.

Cada instancia de Looker (Google Cloud Core) incluye el proyecto de LookML de muestra que se instala de forma predeterminada en la instancia. El proyecto de LookML de muestra incluye modelos de LookML seleccionados que se basan en el conjunto de datos públicos de BigQuery the Look eCommerce. El proyecto de LookML de muestra usa una conexión, sample_bigquery_connection. Puedes usar esta conexión para generar un nuevo modelo de datos basado en una de las tablas del proyecto de muestra. Como esta guía de inicio rápido solo tiene fines didácticos, borrarás el modelo de datos al final del proceso.

Antes de comenzar

Para seguir esta guía de inicio rápido, necesitarás lo siguiente:

  • Acceso a una instancia de Looker (Google Cloud Core) que incluya el proyecto de LookML de muestra
  • Habilita la API de BigQuery para el Google Cloud proyecto que contiene tu instancia de Looker (Google Cloud Core).

    Habilita la API

Roles obligatorios

Para completar este inicio rápido, necesitas el rol de Identity and Access Management (IAM) y el rol de Looker adecuados.

Roles de Identity and Access Management

Tu administrador de Looker (Google Cloud Core) te otorga acceso a la aplicación de Looker (Google Cloud Core) a través del sistema de Identity and Access Management de Google Cloud.

Para obtener el permiso que necesitas para acceder a la aplicación de Looker (Google Cloud Core), pídele a tu administrador que te otorgue el rol de IAM de Usuario de la instancia de Looker (roles/looker.instanceUser) en el proyecto Google Cloud que contiene la instancia de Looker (Google Cloud Core). Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene el permiso looker.instances.login, que se requiere para acceder a la aplicación de Looker (Google Cloud Core).

También puedes obtener este permiso con roles personalizados o con otros roles predefinidos.

Permisos de Looker

Debes tener el rol de administrador de Looker o el permiso develop.

Navega a la página Crear un modelo

  1. En la página principal de Looker (Google Cloud Core), haz clic en el ícono del menú principal de Looker y selecciona el botón de activación Modo de desarrollo en la parte inferior del menú para habilitar el modo de desarrollo.
  2. En la página principal de Looker (Google Cloud Core), haz clic en el botón Crear en el menú de navegación principal para abrir el menú desplegable.
  3. En el menú desplegable, selecciona Modelo de LookML para abrir la página Crear un modelo.

Define tu modelo

En la página Create a Model, sigue estos pasos:

  1. En la sección Select Database Connection, selecciona sample_bigquery_connection en el menú desplegable.
  2. Selecciona el botón de selección para agregar el modelo al proyecto sample_thelook_ecommerce y haz clic en Siguiente.
  3. En la sección Select Tables, deja el proyecto predeterminado Google Cloud en el campo Select GCP project.
  4. En el campo Conjuntos de datos, selecciona bq_dataset.
  5. Haz clic en la flecha que se encuentra a la derecha de bq_dataset para acceder al campo Tablas.
  6. En el campo Tablas, selecciona bq_table.
  7. Haz clic en la flecha que se encuentra a la derecha de bq_table para acceder al campo Campos.
  8. En el campo Fields, selecciona todos los campos y haz clic en Next.
  9. En la sección Select Primary Keys, selecciona Name como clave primaria y haz clic en Next.
  10. En la sección Select Explores to Create, selecciona el archivo bq_table.view y haz clic en Next.
  11. En la sección Enter Model Name, ingresa un nombre de modelo único.
  12. Haz clic en el botón Completar y ver modelo. Esta acción te lleva al IDE de Looker.

Cómo ver tu modelo

Una vez que hayas completado todos los campos de la página Create a Model, consulta el modelo que generó Looker.

Visualiza los archivos del modelo en el IDE de Looker

  1. Después de hacer clic en el botón Complete and View Model, estarás en el IDE de Looker. En el navegador de archivos del IDE, verás las carpetas de los modelos de LookML de muestra preexistentes, que son 0_start_here, 1_basic_lookml, 2_intermediate_lookml y 3_advanced_lookml. También verás las carpetas creadas para el modelo generado, models y views.
  2. Expande las carpetas models y views para ver los archivos de LookML que Looker creó para el modelo que definiste en la página Crear un modelo. El punto azul junto a cada archivo indica que son archivos nuevos y que aún no se implementaron en producción.
    • El archivo .model define el modelo. En el archivo del modelo, puedes ver la conexión que seleccionaste, la vista bq_table y otros parámetros de configuración predeterminados.
    • El archivo bq_table.view define la vista. En el archivo de vista, puedes ver los campos birthdate, name y rating que seleccionaste y cómo se definen en la tabla de la base de datos de BigQuery, así como una medida count predeterminada que agregó Looker.
  3. También verás el archivo README.md que generó Looker porque la casilla de verificación Generate a Readme file that gives more information about using LookML en la página Create a Model se seleccionó de forma predeterminada.

Cómo ver el modelo en la página Proyectos de LookML

  1. En el IDE, haz clic en el ícono Menú principal para abrir el menú de navegación principal.
  2. Si aún no estás en el menú Develop, haz clic en Develop.
  3. En el menú Develop, selecciona Projects para navegar a la página Proyectos de LookML.
  4. Consulta tu modelo en la columna Models de la fila sample_thelook_ecommerce. Aparece junto con los modelos advanced_ecomm, basic_ecomm y intermediate_ecomm del proyecto de LookML de muestra.

Cómo ver la función Explorar que creó el modelo

  1. En la página Proyectos, haz clic en el nombre de tu modelo para volver al archivo del modelo en el IDE.
  2. Con el archivo del modelo abierto en el IDE, haz clic en la flecha Ver acciones del archivo junto al nombre del archivo en la parte superior del IDE.
  3. Selecciona Explorar tabla de Bq: tu_nombre_de_modelo en el menú desplegable. Esta selección te lleva al Explorar Tabla de Bq que creó tu modelo.
  4. En el selector de campos, observa las dimensiones Fecha de nacimiento, Nombre y Calificación que seleccionaste en esta página Crear un modelo, así como la métrica predeterminada Recuento.

Los archivos del modelo, la configuración del modelo y la función Explorar que viste solo están disponibles en tu rama personal de Git mientras estás en el modo de desarrollo. Si quisieras que este modelo esté disponible para otros usuarios de tu instancia de Looker (Google Cloud Core), confirmarías tus cambios, combinarías tu rama y lanzarías la rama de producción. Sin embargo, para los fines de esta guía de inicio rápido, borrarás este modelo, como se describe en la siguiente sección.

Realiza una limpieza

Para maximizar el rendimiento de Looker, no se deben implementar modelos innecesarios en producción. Para mantener una rama de Git personal limpia y evitar implementar accidentalmente este modelo en producción, completa los siguientes pasos para borrar el modelo:

  1. En el Explorar, haz clic en el vínculo Ir a LookML en el selector de campos. Esta acción te lleva al IDE de Looker.
  2. En el IDE, selecciona el ícono Git Actions.
  3. En el menú Git Actions, haz clic en Revert to.

  4. En la ventana Revertir a, asegúrate de que esté seleccionada la opción Revertir cambios no confirmados y haz clic en Confirmar.

  5. En el IDE, ya no deberías ver los archivos de tu modelo.

  6. Para borrar la configuración del modelo, haz clic en Proyectos en el menú Desarrollo para navegar a la página Proyectos.

  7. Ubica tu modelo en la tabla y haz clic en el botón Configurar en su fila.

  8. Asegúrate de estar en la ventana de tu modelo. Para ello, verifica el nombre en el campo Modelo y haz clic en Borrar configuración del modelo.

¿Qué sigue?