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 instalado de forma predeterminada en la instancia. El proyecto de LookML de ejemplo incluye modelos de LookML seleccionados que se basan en el conjunto de datos público de BigQuery the Look eCommerce
. El proyecto de LookML de ejemplo 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 ejemplo. Dado que esta guía de inicio rápido es solo con fines educativos, 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
- Una persona con el rol de IAM de administrador de Looker debe habilitar la API de BigQuery para el proyecto de Google Cloud que contiene tu instancia de Looker (Google Cloud Core).
- Debes tener el rol de Administrador de Looker o el permiso
develop
.
Navega a la página Crear un modelo
- En la página principal de Looker (Google Cloud Core), habilita el modo de desarrollo seleccionando el botón de activación Modo de desarrollo en el menú de navegación principal.
- 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.
- En el menú desplegable, selecciona Modelo de LookML para abrir la página Create a Model.
Define tu modelo
En la página Crea un modelo, sigue estos pasos:
- En la sección Seleccionar conexión de base de datos, selecciona
sample_bigquery_connection
en el menú desplegable. - Selecciona el botón de selección para agregar el modelo al proyecto
sample_thelook_ecommerce
y haz clic en Siguiente. - En la sección Select Tables, deja el proyecto predeterminado Google Cloud en el campo Select GCP project.
- En el campo Conjuntos de datos, selecciona
bq_dataset
. - Haz clic en la flecha que se encuentra a la derecha de
bq_dataset
para ir al campo Tablas. - En el campo Tablas, selecciona
bq_table
. - Haz clic en la flecha que se encuentra a la derecha de
bq_table
para ir al campo Campos. - En el campo Campos, selecciona todos los campos y haz clic en Siguiente.
- En la sección Seleccionar claves primarias, selecciona Nombre como clave primaria y haz clic en Siguiente.
- En la sección Seleccionar Exploraciones para Crear, selecciona el archivo
bq_table.view
y haz clic en Siguiente. - En la sección Enter Model Name, ingresa un nombre de modelo único.
- Haz clic en el botón Completar y ver modelo. Esta acción te llevará 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.
Cómo ver los archivos de modelos en el IDE de Looker
- 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
y3_advanced_lookml
. También verás las carpetas creadas para el modelo generado,models
yviews
. - Expande las carpetas
models
yviews
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 vistabq_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 camposbirthdate
,name
yrating
que seleccionaste y cómo se definen en la tabla de la base de datos de BigQuery, así como una medidacount
predeterminada que agregó Looker.
- El archivo
- 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.
Consulta el modelo en la página Proyectos de LookML
- En el IDE, abre el menú de navegación principal haciendo clic en el ícono Main menu.
- Si aún no estás en el menú Develop, haz clic en Develop.
- En el menú Desarrollo, selecciona Proyectos para navegar a la página Proyectos de LookML.
- Consulta tu modelo en la columna Modelos de la fila sample_thelook_ecommerce. Aparece junto con los modelos
advanced_ecomm
,basic_ecomm
yintermediate_ecomm
del proyecto de LookML de ejemplo.
Cómo ver la exploración que creó el modelo
- En la página Projects, haz clic en el nombre de tu modelo para volver al archivo del modelo en el IDE.
- 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.
- Selecciona Explorar tabla de Bq: nombre_del_modelo en el menú desplegable. Esta selección te llevará a la exploración de Bq Table que creó tu modelo.
- En el selector de campos, ten en cuenta las dimensiones Fecha de nacimiento, Nombre y Calificación que seleccionaste en esta página Crear un modelo, así como la medida predeterminada Cantidad.
Los archivos de modelos, la configuración de modelos y la función Explorar que viste solo están disponibles en tu rama personal de Git mientras estás en modo de desarrollo. Si quisieras que este modelo esté disponible para otros usuarios en tu instancia de Looker (Google Cloud Core), confirmarías los cambios, combinarías la rama y, luego, implementarías la rama de producción. Sin embargo, a los efectos de esta guía de inicio rápido, borrarás este modelo, como se describe en la siguiente sección.
Limpia
Para maximizar el rendimiento de Looker, no se deben implementar modelos innecesarios en producción. Para mantener una rama personal de Git limpia y evitar implementar este modelo en producción por accidente, completa los siguientes pasos para borrarlo:
- En Explorar, haz clic en el vínculo Go to LookML en el selector de campos. Esta acción te llevará al IDE de Looker.
- En el IDE, selecciona el ícono Git Actions.
- En el menú Git Actions, haz clic en Revert to.
En la ventana Revertir a, asegúrate de que esté seleccionada la opción Revertir cambios no confirmados y haz clic en Confirmar.
En el IDE, ya no deberías ver los archivos de tu modelo.
Para borrar la configuración del modelo, navega a la página Projects haciendo clic en Projects en el menú Develop.
Busca tu modelo en la tabla y haz clic en el botón Configurar en su fila.
Asegúrate de que estás en la ventana de tu modelo. Para ello, verifica el nombre en el campo Model y haz clic en Delete Model Configuration.
¿Qué sigue?
- Cómo generar un modelo de LookML
- Descripción general del IDE de Looker
- Cómo administrar archivos y carpetas de LookML
- Patrones comunes de LookML
- Implementa y usa el control de versión