Cómo crear un proyecto de LookML nuevo

Un proyecto es una colección de archivos de LookML que describen cómo se relacionan las tablas de tu base de datos entre sí y cómo Looker debe interpretarlas. Puedes obtener más información sobre los proyectos en las páginas de documentación Modelo de desarrollo y proyectos de LookML y Términos y conceptos de LookML. Para obtener información sobre cómo acceder a proyectos existentes y editarlos, consulta la página de documentación Accede y edita la información del proyecto.

Un proyecto de LookML puede contener más de un archivo de modelo. Sin embargo, si quieres especificar permisos para que los usuarios vean y editen LookML de un archivo de modelo específico, es posible que desees crear un proyecto nuevo. Aunque la mayoría de los permisos en Looker se aplican a nivel de modelo, hay algunos que se aplican a nivel de proyecto, como see_lookml, que te permite ver LookML de un proyecto, y develop, que te permite editar LookML. Si deseas otorgarles a los usuarios acceso a un modelo, pero no a otro, te recomendamos que crees un proyecto independiente que contenga el modelo al que no deseas que tengan acceso.

Los usuarios de Looker con el permiso manage_models pueden crear modelos de LookML en una instancia de Looker.

Crea un proyecto

Para crear un proyecto, sigue estos pasos:

  1. Verifica que estés en el modo de desarrollo.

  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 para seleccionar las opciones de tu proyecto.

Esta acción abre la página New Project, en la que puedes especificar la configuración de tu proyecto, incluido el nombre y el punto de partida.

Looker puede crear un proyecto de varias maneras, y los pasos que se siguen dependen de la opción Starting Point que elijas en la página New Project. En las siguientes secciones, se describe cómo funcionan estos puntos de partida:

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

Si seleccionas Generate Model from Database Schema como punto de partida, el generador de LookML creará automáticamente tu modelo y los archivos del proyecto de vista en función de las tablas de tu base de datos. Consulta la página de documentación Genera un modelo para obtener más información.

Con esta opción, Looker solicita el nombre de la conexión para poder generar automáticamente LookML en función de tu base de datos. Sin embargo, puedes agregar conexiones adicionales más adelante.

Clona un repositorio público de Git

Si seleccionas Clone Public Git Repository como punto de partida, Looker copiará los archivos de un repositorio de Git público en tu nuevo proyecto de LookML.

Los proyectos de Looker que se clonan desde repositorios públicos de Git son de solo lectura. Sin embargo, puedes importar el proyecto de solo lectura a otro de tus proyectos de Looker, en el que podrás editar los archivos. Además, puedes usar los archivos del repositorio clonado como punto de partida y, luego, usar el parámetro extends o las definiciones más precisas de Looker para compilar un proyecto a partir de allí.

Sigue estos pasos para clonar un repositorio público de Git existente en un proyecto de Looker:

  1. Verifica que estés en el modo de desarrollo.
  2. Selecciona Administrar proyectos de LookML en el menú Desarrollo.

  3. En la página Proyectos de LookML, selecciona Nuevo proyecto de LookML para abrir la página Proyecto nuevo.

  4. En la página 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 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 Desarrollar 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 Clonar repositorio público de Git.

    • Git Repository URL (URL del repositorio de Git): Ingresa la URL del repositorio público de Git. Asegúrate de que la URL esté en el formato git://github.com/example/my-repository.git.

      Si tienes una URL como https://github.com/llooker/blocks_redshift_admin, puedes editarla y usarla con el formato correcto. Para ello, reemplaza "https://" por "git://" y, luego, agrega ".git" al final. La URL que ingresarías sería git://github.com/llooker/blocks_redshift_admin.git.

  5. Selecciona Create Project. Looker extraerá todos los archivos del repositorio público a un proyecto nuevo de LookML y lo abrirá en el IDE de Looker.

Cómo crear un proyecto en blanco

Si seleccionas Proyecto en blanco como punto de partida, Looker creará un proyecto vacío para que puedas crear tus archivos de LookML desde cero.

Para crear un proyecto en blanco, sigue estos pasos:

  1. Verifica que estés en el modo de desarrollo.
  2. Selecciona Manage LookML Projects en el menú Develop.

  3. En la página Proyectos de LookML, selecciona Nuevo proyecto de LookML para abrir la página Proyecto nuevo.

  4. En la página 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 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.
      • Para 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 Desarrollar 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 Proyecto en blanco.

  5. Selecciona Crear proyecto. Looker crea el proyecto y lo abre en el IDE de Looker.

Una vez que tengas un proyecto en blanco, podrás crear archivos de modelo y vista. Luego, podrás conectar tu proyecto a Git para registrar los cambios en tus archivos de LookML y administrar sus versiones.

Configura un modelo

Usa el botón Configurar modelo nuevo en la parte superior de la página Proyectos de LookML para agregar una configuración para un modelo existente o planificado.

Configurar un modelo para un proyecto que aún no existe es útil si los desarrolladores no tienen el permiso manage_models ni el permiso manage_project_models, como se describe en la página de documentación Cómo generar un modelo. Si configuras el modelo para los desarrolladores, estos podrán ejecutar consultas en cuanto generen o creen el archivo de modelo. Para obtener más información sobre los proyectos que solo tienen una configuración, consulta la página de documentación Accede y edita la información del proyecto.

También puedes especificar qué conexiones de base de datos puede usar el modelo o puedes especificar que el modelo pueda 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 no permitiste en la configuración del modelo, no se ejecutará ninguna consulta en ese modelo.