Cómo generar un modelo de LookML

En esta página de la documentación, se describen los pasos para generar automáticamente un modelo de LookML básico a partir de tu conexión a la base de datos con la página Create a Model. La página Crear un modelo también se puede usar para crear un proyecto que alojará tu modelo.

También hay otras opciones para crear archivos de modelos:

  • Puedes crear manualmente archivos de modelos y otros archivos de proyecto desde el IDE.

  • Para usar el método heredado para crear proyectos y generar modelos, haz clic en cualquiera de las siguientes opciones, que te llevarán a la página heredada New Project:

    • el vínculo en el banner de la parte superior de la página Crear un modelo
    • el botón Agregar LookML en la sección Proyectos pendientes de la página Proyectos

    Una vez en la página Nuevo proyecto, sigue los pasos que se indican en la documentación Cómo crear un proyecto de LookML.

Accede a la página Crear un modelo.

Accede a la página Crear un modelo de las siguientes maneras:

Para acceder a la página Crear un modelo, debes estar en el Modo de desarrollo.

Para acceder a la página Create a Model, debes ser administrador de Looker o tener el permiso develop.

En la sección Desarrollo

Para acceder a la página Create a Model desde la sección Develop, completa los siguientes pasos.

  1. Haz clic en Desarrollar en el panel de navegación izquierdo.

  2. Selecciona Proyectos en la sección Desarrollo del panel de navegación.

  3. Esta selección abre la página Proyectos de LookML. La página Proyectos de LookML te permite ver todos los proyectos a los que tienes acceso, junto con sus respectivos modelos. En la página Proyectos de LookML, selecciona el botón Modelo nuevo para abrir la página Crear un modelo.

Desde el botón Crear

Para acceder a la página Crear un modelo desde el botón Crear, completa los siguientes pasos.

  1. En el menú de navegación principal, haz clic en el botón Crear.
  2. Selecciona Modelo de LookML en el menú desplegable. Se abrirá la página Crear un modelo.

Genera un modelo

La página Crear un modelo se divide en secciones. Para generar un modelo, completa los pasos que se indican en las siguientes secciones. Después de cada sección, haz clic en Siguiente para guardar la información que ingresaste y pasar a la siguiente sección.

  1. Seleccionar conexión de base de datos:

    • Seleccionar conexión de base de datos: Selecciona una conexión de base de datos en el menú desplegable. También puedes elegir la opción Crear conexión nueva en el menú desplegable. Se te dirigirá a la página Conecta tu base de datos a Looker, en la que puedes crear una conexión nueva.

    • Si tienes acceso a proyectos que ya usan la conexión, aparecerán una vez que la selecciones. Puedes agregar tu modelo nuevo a un proyecto existente disponible o crear un proyecto de LookML nuevo para tu modelo.

    • Nombre del proyecto de LookML: Si deseas crear un proyecto de LookML nuevo para el modelo, ingresa un nombre en este campo. Los nombres de los proyectos distinguen mayúsculas de minúsculas y solo permiten caracteres alfanuméricos, _, . y -. Elige el nombre del proyecto con cuidado y considéralo un ID permanente para el proyecto. Los proyectos nuevos se configuran con un repositorio de Git sin procesar.

    • Selecciona la casilla de verificación Genera un archivo readme que brinde más información sobre el uso de LookML si deseas que Looker agregue un archivo README al proyecto nuevo. El archivo README contiene una introducción a LookML, junto con vínculos y recursos para ayudar a los desarrolladores nuevos de LookML.

    • Haz clic en el botón Siguiente para guardar tus entradas y pasar a la siguiente sección.

  2. Selecciona las tablas:

    • Si usas una conexión de BigQuery, selecciona el proyecto de Google Cloud en el que reside el conjunto de datos en el menú desplegable Seleccionar proyecto de GCP o busca el proyecto en el campo Buscar nombre de proyecto. De forma predeterminada, el proyecto de almacenamiento de Google Cloud se muestra en el menú desplegable, si existe. De lo contrario, se muestra el proyecto de facturación de Google Cloud .
    • En la tabla, selecciona los conjuntos de datos (BigQuery) o los esquemas (otros dialectos) que deseas usar en el modelo.
    • Una vez que se seleccionen los conjuntos de datos o esquemas, usa la flecha a la derecha de cada nombre de conjunto de datos o esquema para abrir la pestaña Tablas y selecciona cada tabla que quieras incluir. Las vistas se crearán a partir de las tablas.
    • Una vez que se seleccionen las tablas, usa la flecha a la derecha de cada nombre de tabla para abrir la pestaña Campos y selecciona cada campo que quieras incluir.
    • Ignorar prefijos: Si deseas ignorar los prefijos de tablas en los nombres de los archivos de vista generados, ingresa los prefijos de la base de datos en una lista separada por comas en este campo. Este campo distingue mayúsculas de minúsculas. Puedes enumerar varios prefijos separados por comas. Por ejemplo, tus tablas se titulan dwh_orders y DBS_users. Si ingresas dwh, DBS en el campo Ignorar prefijos, Looker crea archivos de vista llamados orders y users.
    • Importar descripciones de campos: Selecciona esta casilla de verificación para usar las descripciones de campos disponibles en la base de datos como descripciones de LookML para las dimensiones generadas.
    • Haz clic en el botón Siguiente para guardar tus entradas y pasar a la siguiente sección.

  3. Seleccionar claves primarias:

    • Selecciona una clave primaria para cada tabla que seleccionaste. Esto ayuda a Looker a unir mejor tus tablas.
    • Este paso es opcional. Para omitirlo, no selecciones ninguna clave primaria.
    • Haz clic en el botón Siguiente para guardar tus entradas y pasar a la siguiente sección.

  4. Selecciona Exploraciones para crear:

    • Selecciona las vistas que quieras usar como la vista base de una Exploración. Para cada vista seleccionada, el sistema unirá automáticamente la mayor cantidad de vistas adicionales posibles. Solo las vistas con una clave primaria identificada en el paso anterior se pueden usar en una unión.
    • Este paso es opcional. Para omitirlo, no selecciones ninguna vista.
    • Haz clic en el botón Siguiente para guardar tus entradas y pasar a la siguiente sección.

  5. Ingresar nombre del modelo:

  6. Haz clic en uno de los siguientes botones para generar los archivos del modelo y, si se selecciona, el proyecto nuevo:

    • Completar y ver modelo: Looker te dirige a los archivos del IDE de Looker.
    • Completar y explorar datos: Looker te dirige a la exploración que corresponde al primer archivo de vista seleccionado en la sección Seleccionar exploraciones para crear.

  7. Si creaste un proyecto nuevo y quieres conectarlo a un repositorio diferente del repositorio de Git sin procesar que usó Looker para crearlo, haz clic en el botón Restablecer conexión de Git en la pestaña Configuración de la página Configuración del proyecto del proyecto para completar el proceso.

Cuando necesites configurar modelos

Configurar un modelo es útil por los siguientes motivos:

  • Especifica que un nombre de modelo determinado hace referencia a un modelo en particular en un proyecto en particular.
  • Establece las conexiones que el modelo puede usar.

Los administradores (o desarrolladores con el permiso manage_models o manage_project_models) no necesitan configurar un modelo mientras están en modo de desarrollo. Esto permite que los desarrolladores de LookML trabajen en el modo de desarrollo. Sin embargo, si existe una configuración de modelo, todas las consultas se ven limitadas por esa configuración, incluso en el modo de desarrollo.

Aunque un desarrollador de LookML especifique la conexión deseada en el archivo del modelo, un administrador controla qué conexiones se permiten en la página Proyectos de LookML. Si un modelo especifica el uso de una conexión que no está permitida en su configuración, la conexión no se permite.

Un modelo debe tener una configuración en las siguientes situaciones:

  • Cuando se envía un modelo a producción por primera vez. Si el modelo no está configurado, las consultas sobre él fallarán una vez que esté en modo de producción. Cuando se envía un modelo del modo de desarrollo a producción por primera vez, Looker lo configura automáticamente si el nombre del modelo es único para la instancia de Looker. Sin embargo, si tienes un modelo configurado con el mismo nombre en otro proyecto, Looker no lo configurará automáticamente.
  • Durante el desarrollo. Si hay desarrolladores a los que no se les otorgó el permiso manage_models (que se incluye en el rol admin) o el permiso manage_project_models, el modelo debe configurarse antes de que esos desarrolladores puedan ejecutar consultas en él. Puedes configurar el modelo antes de que exista o antes de que exista el proyecto. Luego, cuando un desarrollador de LookML crea el modelo, las conexiones permitidas del modelo ya están configuradas, y el desarrollador puede ejecutar consultas correctamente.

Looker permite que los desarrolladores que tengan el permiso manage_models o manage_project_models ejecuten consultas en un modelo no configurado en modo de desarrollo. Para ello, Looker busca un modelo con ese nombre en los proyectos. Se usa el primer modelo que se encuentra con ese nombre para ejecutar la consulta.

Cómo configurar modelos planificados

Los administradores de Looker pueden usar el botón Configure New Model en la parte superior de la página LookML Projects para agregar una configuración para un modelo existente o para un modelo planificado que aún no existe.

Configurar un modelo con anticipación es útil si los desarrolladores no tienen el permiso manage_models ni el permiso manage_project_models. Si un administrador configura el modelo para los desarrolladores, estos podrán ejecutar consultas en cuanto generen o creen el archivo del modelo.

Los administradores también pueden especificar qué conexiones de base de datos puede usar el modelo o pueden especificar que el modelo puede usar cualquier conexión actual o futura. Los desarrolladores de Looker usan el parámetro connection de LookML para especificar en el archivo del modelo qué conexión debe usar. Si un desarrollador especifica una conexión que un administrador no permitió en la configuración del modelo, no se ejecutará ninguna consulta en ese modelo.

Cuando un administrador configura un modelo nuevo con anticipación y crea un proyecto nuevo como parte de esa configuración, ese proyecto se muestra en la sección Proyectos pendientes de la página Proyectos.

Genera un proyecto en blanco

Crear un proyecto en blanco o vacío puede ser útil cuando deseas crear tus archivos de LookML desde cero.

La página Crear un modelo genera proyectos con archivos de LookML incluidos. Sin embargo, puedes minimizar los archivos de LookML que se generan completando solo las siguientes secciones de la página Crear un modelo:

  • Seleccionar conexión de base de datos
  • Seleccionar tablas
  • Ingresar nombre del modelo

Deja las secciones restantes sin completar.

Haz clic en el botón Complete and View Model, que te llevará al proyecto en el IDE de Looker. Una vez en el IDE, puedes borrar los archivos de LookML que no quieras para crear un proyecto en blanco.

Próximos pasos

Después de crear un modelo o un proyecto, puedes realizar las siguientes acciones: