Generar un modelo de LookML

En esta página de documentación se describen los pasos para generar automáticamente un modelo de LookML básico a partir de la conexión de tu base de datos mediante la página Crear un modelo. También puede usar la página Crear un modelo para crear un proyecto que aloje su modelo.

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

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

  • Puede usar el método antiguo para crear proyectos y generar modelos haciendo clic en cualquiera de las siguientes opciones, que le llevarán a la página antigua Nuevo proyecto:

    • El enlace del banner situado en la parte superior de la página Crear un modelo
    • el botón Añadir LookML de la sección Proyectos pendientes de la página Proyectos

    En la página Nuevo proyecto, sigue los pasos que se indican en la documentación sobre cómo crear un proyecto de LookML.

Acceder a la página Crear un modelo

Acceda a la página Crear modelo de las siguientes formas:

Para acceder a la página Crear un modelo, debes estar en el modo Desarrollo.

Para acceder a la página Crear un modelo, debes ser administrador de Looker o tener el permiso develop.

En la sección Desarrollar

Para acceder a la página Crear un modelo desde la sección Desarrollo, sigue estos pasos:

  1. En el panel de navegación de la izquierda, haga clic en Desarrollo.

  2. En el panel de navegación, vaya a la sección Desarrollo y seleccione Proyectos.

  3. Al seleccionar esta opción, se abre la página Proyectos de LookML. La página Proyectos de LookML te permite ver todos los proyectos a los que tienes acceso, así como sus respectivos modelos. En la página Proyectos de LookML, selecciona el botón Nuevo modelo 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, siga estos 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.

Generar un modelo

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

  1. Selecciona 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 nueva conexión en el menú desplegable. Se te dirigirá a la página Conecta tu base de datos a Looker, donde podrás crear una conexión.

    • Si tiene acceso a algún proyecto que ya use la conexión, aparecerá cuando la seleccione. Puedes añadir tu nuevo modelo a un proyecto que ya tengas o crear un proyecto de LookML para tu modelo.

    • Nombre del proyecto de LookML: si quieres crear un proyecto de LookML para el modelo, introduce un nombre en este campo. En los nombres de los proyectos se distingue entre mayúsculas y minúsculas, y solo se permiten caracteres alfanuméricos, _, . y -. Elige el nombre del proyecto con cuidado, ya que será el ID permanente del proyecto. Los proyectos nuevos se configuran mediante un repositorio Git desnudo.

    • Marca la casilla Generar un archivo Readme que proporcione más información sobre el uso de LookML si quieres que Looker añada un archivo README al nuevo proyecto. El archivo README contiene una introducción a LookML, así como enlaces y recursos para ayudar a los nuevos desarrolladores de LookML.

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

  2. Seleccionar tablas:

    • Si usas una conexión de BigQuery, selecciona el proyecto Google Cloud en el que se encuentra 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 Google Cloud proyecto de almacenamiento se muestra en el menú desplegable, si existe. Si no existe, se muestra el Google Cloud proyecto de facturación.
    • En la tabla, seleccione los conjuntos de datos (BigQuery) o los esquemas (otros dialectos) que quiera usar en el modelo.
    • Una vez que hayas seleccionado los conjuntos de datos o los esquemas, usa la flecha situada a la derecha de cada nombre para abrir la pestaña Tablas y selecciona las tablas que quieras incluir. Las vistas se crearán a partir de las tablas.
    • Una vez que hayas seleccionado las tablas, usa la flecha situada a la derecha del nombre de cada tabla para abrir la pestaña Campos y selecciona los campos que quieras incluir.
    • Ignorar prefijos: si quiere ignorar los prefijos de las tablas en los nombres de los archivos de vista generados, introduzca los prefijos de la base de datos en una lista separada por comas en este campo. En este campo se distingue entre mayúsculas y minúsculas. Puedes incluir varios prefijos separados por comas. Por ejemplo, las tablas se titulan dwh_orders y DBS_users. Si introduces dwh, DBS en el campo Ignorar prefijos, Looker creará archivos de vista llamados orders y users.
    • Importar descripciones de campos: marca esta casilla para usar las descripciones de campos disponibles en la base de datos como descripciones de LookML de las dimensiones generadas.
    • Haz clic en el botón Siguiente para guardar tus entradas y pasar a la siguiente sección.

  3. Seleccionar claves principales:

    • Selecciona una clave principal para cada tabla que hayas seleccionado. De esta forma, Looker puede combinar mejor tus tablas.
    • Este paso es opcional. Para saltártelo, no selecciones ninguna clave principal.
    • Haz clic en el botón Siguiente para guardar tus entradas y pasar a la siguiente sección.

  4. Selecciona Exploraciones para crear:

    • Selecciona cada vista que quieras usar como vista base de una Exploración. El sistema unirá automáticamente tantas vistas como sea posible a cada vista seleccionada. Solo se pueden usar en una combinación las vistas que tengan una clave principal identificada en el paso anterior.
    • 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. Nombre del modelo:

  6. Haga clic en uno de los siguientes botones para generar los archivos del modelo y, si lo ha seleccionado, el nuevo proyecto:

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

  7. Si has creado un proyecto y quieres conectarlo a un repositorio diferente del repositorio de Git básico que Looker ha usado para crear el proyecto, haz clic en el botón Restablecer conexión de Git de la pestaña Configuración de la página Configuración del proyecto para completar el proceso.

Cuándo necesitas configurar modelos

Configurar un modelo es útil por los siguientes motivos:

  • Especifica que un nombre de modelo determinado hace referencia a un modelo concreto de un proyecto específico.
  • Define las conexiones que puede usar el modelo.

Los administradores (o los desarrolladores con el permiso manage_models o manage_project_models) no necesitan una configuración de modelo mientras están en el modo Desarrollo. Esto permite a los desarrolladores de LookML trabajar en el modo Desarrollo. Sin embargo, si existe una configuración de modelo, las consultas se limitan a esa configuración incluso en el modo Desarrollo.

Aunque un desarrollador de LookML especifica la conexión prevista en el archivo de 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 la configuración del modelo, la conexión no se permite.

Un modelo debe tener una configuración en los siguientes casos:

  • Cuando un modelo se envía a producción por primera vez. Si el modelo no está configurado, las consultas de ese modelo fallarán cuando esté en el modo de producción. Cuando se envía un modelo del modo Desarrollo a producción por primera vez, Looker lo configura automáticamente si el nombre del modelo es único en la instancia de Looker. Sin embargo, si tiene un modelo configurado con el mismo nombre en otro proyecto, Looker no lo configurará automáticamente.
  • Durante el desarrollo. Si tienes desarrolladores a los que no se les ha concedido el permiso manage_models (que se incluye en el rol admin) ni 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. De esta forma, 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 a los desarrolladores que tienen el permiso manage_models o manage_project_models ejecutar consultas en un modelo sin configurar en el modo Desarrollo. Para ello, Looker busca en los proyectos un modelo con ese nombre. Se usa el primer modelo que se encuentra con ese nombre para ejecutar la consulta.

Configurar modelos planificados

Los administradores de Looker pueden usar el botón Configurar nuevo modelo situado en la parte superior de la página Proyectos de LookML para añadir una configuración a un modelo que ya exista o a un modelo planificado que aún no se haya creado.

Configurar un modelo con antelación es útil si los desarrolladores no tienen el permiso manage_models o 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 bases de datos puede usar el modelo o indicar 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 de modelo qué conexión debe usar el modelo. Si un desarrollador especifica una conexión que un administrador no ha permitido en la configuración del modelo, no se ejecutará ninguna consulta en ese modelo.

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

Generar un proyecto en blanco

Crear un proyecto en blanco puede ser útil si quieres crear tus archivos de LookML desde cero.

La página Crear un modelo genera proyectos con archivos LookML incluidos. Sin embargo, puede minimizar los archivos 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
  • Introduce el nombre del modelo

Deja el resto de las secciones sin completar.

Haz clic en el botón Completar y ver modelo, que te llevará al proyecto en el IDE de Looker. Una vez en el IDE, puedes eliminar los archivos LookML que no quieras para crear un proyecto en blanco.

Pasos siguientes

Una vez que se ha creado un modelo o un proyecto, puede realizar las siguientes acciones: