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

  1. Haz clic en Develop, en la barra de menú 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: Asígnale un nombre a tu proyecto. Elige el nombre del proyecto con cuidado y considéralo un ID permanente, ya que Looker usa el nombre del proyecto 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 para 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 Generar modelo a partir de esquema de base de datos.

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

    • Crear 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 tabla fuera de los nombres de archivo de la vista, ingresa los prefijos de la 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 Ignore Prefixes, 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 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 Cambia el nombre de un proyecto de la página de documentación Accede y edita la información del proyecto.

Puedes crear manualmente modelos nuevos para tu proyecto como se describe en la página de documentación Comprende los modelos y ver archivos, configurarlos para su uso 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 Crea un nuevo 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.

Generación de LookML mejorada

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, que se basan 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 en particular en un proyecto en particular.
  • Establece las conexiones que el modelo puede usar.

Los administradores (o desarrolladores con los permisos manage_models o manage_project_models) no necesitan configurar un modelo mientras se encuentran en el 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, cualquier consulta estará limitada por esa configuración, incluso en el Modo de desarrollo.

Aunque un desarrollador de LookML especifica la conexión prevista en el archivo de modelo, un administrador controla qué conexiones están permitidas 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 un modelo se envía a producción por primera vez Si el modelo no está configurado, cualquier consulta en ese modelo fallará 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 tienes 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, entonces, se debe configurar el modelo para que esos desarrolladores puedan ejecutar consultas en ese modelo. 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 a los desarrolladores que tienen el permiso manage_models o manage_project_models ejecutar 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.