Genera un modelo

En esta página, se proporcionan los pasos para crear un proyecto nuevo y generar automáticamente un modelo básico a partir de tu base de datos.

Existen otras opciones para crear tus archivos de proyecto: puedes crear un proyecto en blanco y crear manualmente su modelo, o clonar un repositorio de Git público existente, consulta la página de documentación Crea un nuevo proyecto de LookML.

Genera automáticamente un modelo a partir de tu base de datos

Puedes generar automáticamente un modelo a partir de tu base de datos en la sección Desarrollar de Looker o con el botón Crear del panel de navegación izquierdo.

Cómo generar un modelo desde la sección Desarrollar

  1. Haz clic en Develop, en el panel de navegación izquierdo, y verifica que estés en Development Mode.

  2. Selecciona Projects en la sección Develop del panel de navegación.

  3. En la página Proyectos de LookML, selecciona Nuevo proyecto de LookML:

    • En la página Proyectos de LookML, puedes ver todos tus proyectos junto con sus respectivos modelos. Usarás esta página para crear, ver y configurar tus proyectos.

  4. En el diálogo New Project, especifica las opciones para tu proyecto:

    • Nombre del proyecto: Asigna un nombre a tu proyecto. Elige el nombre del proyecto con cuidado y considéralo un ID permanente para el proyecto, ya que Looker lo usa de las siguientes maneras:

      • Para identificar el proyecto de las llamadas a la API que tienen el parámetro project_id.
      • Identificar el proyecto en la base de datos interna de la instancia de Looker.
      • A fin de identificar el proyecto para la importación de proyecto local.
      • Para mostrar el proyecto en la página Proyectos de LookML.
      • Para mostrar el proyecto en la sección Develop del panel de navegación de Looker.
      • Como parte de la URL de los archivos del proyecto. Por ejemplo, en una instancia de Looker con una URL de example.looker.com, el archivo de manifiesto del proyecto llamado ecommerce se puede encontrar en esta URL: https://example.looker.com/projects/ecommerce/files/manifest.lkml.

    • Punto de partida: Elige Generate Model from Database Schema.

    • Conexión: En el menú desplegable, selecciona el nombre de la conexión de tu base de datos.

    • Compilar vistas desde: Selecciona una de las siguientes opciones:

      • Todas las tablas: El generador de LookML crea un archivo de vista para cada tabla en tu base de datos.
      • Tabla única: El generador de LookML crea una vista para una tabla en tu base de datos. Si eliges esta opción, ingresa el nombre de la tabla de la base de datos.

    • Esquemas: Si quieres generar archivos para un solo esquema en tu base de datos, ingresa el nombre del esquema en el campo de texto Esquemas. Puedes enumerar varios esquemas separados por comas.

    • Ignorar prefijos: Para dejar los prefijos de tablas fuera de los nombres de los archivos de vista, ingresa los prefijos de tu base de datos en el campo Ignorar prefijos. Este campo distingue mayúsculas de minúsculas. Puedes enumerar varios prefijos separados por comas. Por ejemplo, tus tablas se llaman dwh_orders y DBS_users. Si ingresas dwh, DBS en el campo de texto Ignorar prefijos, Looker creará archivos de vista llamados orders y users.

  5. Haz clic en Crear proyecto.

    • El generador de LookML crea un archivo de modelo para el proyecto y un archivo de vista para cada tabla de la base de datos (a menos que se especifique lo contrario). Luego, Looker abrirá el proyecto nuevo en el IDE de Looker.
    • El generador de LookML crea carpetas IDE para tus archivos de vistas y modelos. Si tu base de datos tiene más de un esquema, el generador de LookML crea una carpeta para los esquemas.

Para las conexiones de BigQuery, si generas un proyecto de LookML a partir de tu base de datos, Looker propagará automáticamente las descripciones de los campos con las descripciones de los metadatos de tus columnas de BigQuery, si las hubiera.

El generador también crea una exploración para cada tabla de la base de datos. Para comenzar a consultar tus datos, usa el panel Explorar y selecciona el nombre de una exploración.

Para cambiar el nombre de tu proyecto después de crearlo, consulta la sección Cómo cambiar el nombre de un proyecto de la página de documentación Cómo acceder a la información de un proyecto y editarla.

Puedes crear modelos nuevos adicionales para tu proyecto de forma manual, como se describe en la página de documentación Información sobre los archivos de modelos y vistas, configurarlos para usarlos en producción, como se explica en la sección Cuándo debes configurar modelos de esta página, y encontrar más instrucciones en la página de documentación Cómo crear un proyecto de LookML.

Después de generar o crear manualmente tus archivos de modelo, consulta la página de documentación Configura y prueba una conexión de Git para obtener información sobre cómo conectar tu proyecto de Looker a Git. Puedes registrar cambios en tus archivos de LookML y administrar las versiones de tus archivos.

Genera un modelo con el botón Crear

Para crear un proyecto y generar un modelo con el botón Crear, sigue estos pasos:

  1. Haz clic en el botón Crear en el panel de navegación izquierdo.
  2. Selecciona la opción de menú Modelo de LookML.
  3. Verifica que estás en el Modo de desarrollo.
  4. Una vez que estés en modo de desarrollo, se abrirá la página Create a Project.
  5. Habilita la opción Creación avanzada de proyectos si deseas seleccionar vistas base para las exploraciones o personalizar otras opciones avanzadas, como ignorar prefijos de tablas en nombres de archivos de vista generados, importar metadatos de descripción de campo de la base de datos, determinar la creación de archivos de modelos y seleccionar archivos readme generados automáticamente.
  6. Selecciona una conexión de base de datos en el menú desplegable Seleccionar una conexión de base de datos. Si tienes acceso a proyectos que ya usen la conexión, aparecerán una vez que se seleccione la conexión. Puedes elegir usar un proyecto disponible y agregarle un modelo nuevo o crear un proyecto de LookML nuevo. Si decides agregar el modelo a un proyecto, aparecerá una sección Create Model como primer paso en la página Create a Project, en la que puedes asignarle un nombre al modelo. Una vez que hayas realizado tus selecciones, haz clic en Siguiente.
  7. En la sección Seleccionar datos, elige los esquemas, las tablas y los campos que usarás en el modelo. Se crearán vistas a partir de las tablas. Una vez que hayas realizado las selecciones, haz clic en Next.
  8. Selecciona una clave primaria para cada tabla. Esto ayuda a Looker a unir mejor tus tablas. Una vez que hayas realizado tus selecciones, haz clic en Siguiente.
  9. Si habilitaste la opción Creación de proyectos avanzados, selecciona las vistas básicas para las Exploraciones. Selecciona las vistas que quieras usar como vista base para 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. Una vez que hayas realizado tus selecciones, haz clic en Siguiente.
  10. Si habilitaste la opción Creación de proyectos avanzados, realiza las siguientes selecciones en la sección Opciones avanzadas:
    • Ignorar prefijos: Para ignorar los prefijos de tabla 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 de texto Ignorar prefijos, Looker crea archivos de vista llamados orders y users.
    • Descripciones de los campos: Selecciona la casilla de verificación Importar metadatos de descripción de los campos para usar las descripciones de los campos disponibles en la base de datos como descripciones de LookML para las dimensiones generadas.
    • Manejo de archivos de modelo: elige si quieres crear un archivo de modelo. Si decides crear un archivo de modelo, ingresa el nombre que quieras para el archivo en el campo Nombre del modelo.
    • Guía de introducción: Selecciona la casilla de verificación Generar un archivo readme que describa cómo usar el resultado para generar un archivo readme que describa cómo usar el proyecto.
  11. Haz clic en Generate Model para generar los archivos del proyecto. Looker te lleva a los archivos en el IDE de Looker una vez que se generan.

Generación mejorada de LookML

Si el administrador de Looker habilitó la función de Labs de Generación de LookML mejorada, Looker agregará elementos adicionales a tu proyecto cuando lo generes desde tu base de datos:

  • Looker agrega 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 nuevos desarrolladores de LookML.
  • Looker agrega varias explicaciones de comentarios intercaladas al archivo de modelo y a cada archivo de vista.
  • Si una vista tiene al menos una dimensión de type: number que no contiene la cadena id en su nombre, Looker crea una medida de type: sum y una medida de type: average, ambas basadas en la primera dimensión alfabéticamente de type: number que no contiene la cadena id en su nombre.

Cuando necesitas configurar modelos

Configurar un modelo es útil por los siguientes motivos:

  • Especifica que el nombre de un modelo dado se refiere a un modelo determinado 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 especifica 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 no permitida en la configuración del modelo, entonces 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 un modelo pasa del Modo de desarrollo a la producción por primera vez, Looker lo configura automáticamente si su nombre 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 proyecto y 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. Looker lo hace buscando proyectos para un modelo con ese nombre. El primer modelo encontrado con ese nombre se usa para ejecutar la consulta.