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.

Hay otras opciones para crear los archivos de tu proyecto: puedes crear un proyecto en blanco y crear su modelo de forma manual, o clonar un repositorio público de Git, consulta la página de documentación Crea un proyecto de LookML nuevo.

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

  1. Haz clic en Develop en la barra de menú y verifica que estés en Development Mode.

  2. Selecciona Projects en el menú Develop:

  3. En la página LookML Projects, haz clic en New LookML Project:

    • La página LookML Projects te permite ver todos los proyectos junto con sus respectivos modelos. Usarás esta página para crear, ver y configurar tus proyectos.

  4. En el cuadro de diálogo New Project (Proyecto nuevo), especifica las opciones para tu proyecto:

    • Asigna un nombre a tu proyecto.
    • En Punto de partida, elige Generate Model from Database Schema.
    • En el menú desplegable Conexión, selecciona el nombre de tu conexión de base de datos.
    • En Compilar vistas desde, selecciona una opción:
      • 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.
    • Para generar archivos para un solo esquema en tu base de datos, ingresa el nombre del esquema en el campo de texto Esquemas (Schemas). Puedes enumerar varios esquemas, separados por comas.
    • Para dejar los prefijos de tabla fuera de los nombres de archivo de las vistas, ingresa los prefijos de la base de datos en el campo de texto Ignorar prefijos. 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 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 en la base de datos (a menos que se especifique lo contrario). Luego, Looker abrirá el nuevo proyecto en el IDE de Looker.
    • El generador de LookML crea carpetas IDE para tus archivos de vista y modelo. 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 genera un proyecto de LookML a partir de su base de datos, Looker propaga automáticamente las descripciones de los campos con las descripciones de los metadatos de su columna de BigQuery, si las hubiera.

El generador también crea un Explorar para cada tabla de base de datos. Para comenzar a consultar tus datos, usa el menú Explorar a fin de seleccionar el nombre de un objeto Explorar. Si el administrador habilitó la función de Labs de Navegación mejorada, selecciona la opción Explorar en el nuevo panel de navegación izquierdo mejorado. Consulta la página de documentación Explora datos en Looker para obtener más información.

Para cambiar el nombre de tu proyecto después de crearlo, consulta la sección Renombra un proyecto de la página de documentación Acceso y edición de la información del proyecto.

Puedes crear manualmente nuevos modelos para tu proyecto como se describe en la página de documentación Información sobre modelos y archivos de vista, configurarlos para su uso en producción como se explica en la sección Cuándo necesitas configurar modelos en esta página y encontrar más instrucciones en la página de documentación Crea un proyecto de LookML nuevo.

Después de generar o crear manualmente tus archivos de modelos, 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. Puede registrar los cambios en sus archivos LookML y administrar las versiones de sus archivos.

Generación mejorada de LookML

Si el administrador de Looker habilitó la función de labs de generación de LookML mejorada, Looker agrega elementos adicionales a su proyecto cuando usted genera el proyecto desde su 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 desarrolladores nuevos de LookML.
  • Looker agrega varias explicaciones de comentarios intercalados al archivo del modelo y a cada archivo de vista.
  • Si una vista tiene al menos una dimensión de type: number que no contiene la string id en su nombre, Looker crea una medida de type: sum y una medida de type: average, que se basan en la primera dimensión alfabética de type: number que no contiene la string id en su nombre.

Cuando necesita 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 los desarrolladores con el permiso manage_models) no necesitan configurar el modelo mientras se encuentran en el modo de desarrollo. Esto permite que los desarrolladores de LookML trabajen fácilmente en el modo de desarrollo. Sin embargo, si existe una configuración de modelo, cualquier consulta estará restringida por esa configuración, incluso en modo de desarrollo.

Aunque un desarrollador de LookML especifica la conexión deseada en el archivo de modelos, 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, entonces la conexión no está permitida.

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

  • Cuando un modelo se envía a producción por primera vez Si el modelo no está configurado, cualquier consulta sobre ese modelo fallará una vez que esté en modo de producción. Cuando un modelo se envía 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 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 otorgó el permiso manage_models (que se incluye en la función admin), el modelo debe configurarse antes de que esos desarrolladores puedan ejecutar consultas en él. Puedes configurar el modelo antes de que el modelo exista o antes de que este exista. 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.

Para los desarrolladores que no tengan el permiso manage_models, los administradores pueden limitar el acceso a ciertas conexiones si limitan los desarrolladores a conjuntos de modelos específicos y también se limitan las conexiones permitidas para esos modelos.

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