Crea un nuevo proyecto de LookML

Un proyecto es una colección de archivos de LookML que describen cómo se relacionan las tablas de tus bases de datos entre sí y cómo Looker debería interpretarlas. Puedes obtener más información sobre los proyectos en las páginas de documentación Proyectos y modelos de desarrollo de Looker y Términos y conceptos de Looker. Para obtener información sobre cómo acceder y editar proyectos existentes, 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 puedan ver y editar LookML de un archivo de modelo específico, te recomendamos que crees un proyecto nuevo. Aunque la mayoría de los permisos en Looker se aplican a nivel del modelo, hay algunos que se aplican a nivel de proyecto, como see_lookml, que te permite ver LookML para un proyecto, y develop, que te permite editar LookML. Si deseas otorgar acceso a los usuarios a un modelo, pero no a otro, es una buena idea crear otro proyecto que contenga el modelo al que no quieres que tengan acceso.

Cómo crear un proyecto

Para crear un proyecto, sigue estos pasos:

  1. Verifica que estés en Modo de desarrollo.

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

  3. En la página Proyectos de Looker, selecciona Nuevo proyecto de LookML para elegir 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 del proyecto y su punto de partida. Looker puede crear un proyecto de varias maneras, y los pasos que se realicen dependerán de la opción Punto de partida que elijas en la página Proyecto nuevo. En las siguientes secciones, se describe cómo funcionan estos puntos de partida:

Genera un modelo de forma automática a partir de tu base de datos

Si seleccionas Generar modelo a partir del esquema de la base de datos como punto de partida, el generador de LookML crea automáticamente tu modelo y ve los archivos del proyecto según 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 que pueda generar automáticamente LookML basado en tu base de datos. Sin embargo, podrás agregar conexiones adicionales más adelante.

Clona un repositorio público de Git

Si seleccionas Clonar repositorio público de Git como punto de partida, Looker copiará los archivos de un repositorio público de Git 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 para editar los archivos. Además, puedes usar los archivos del repositorio clonados como punto de partida y, luego, usar el parámetro extends o los perfeccionamientos de Looker para crear un proyecto a partir de ahí.

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

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

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

  4. En la página Proyecto nuevo, especifica las opciones para tu proyecto:

    • Nombre del proyecto: Asígnale un nombre a tu proyecto.
    • Punto de partida: Elige Clone Public Git Repository (Clonar repositorio público de Git).
    • URL del repositorio de Git: Ingresa la URL del repositorio público de Git. Asegúrate de que la URL tenga el formato git://github.com/example/my-repository.git.

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

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

Crea 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, haz lo siguiente:

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

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

  4. En la página Proyecto nuevo, especifica las opciones para tu proyecto:

    • Nombre del proyecto: Asígnale un nombre a tu proyecto.
    • Punto de partida: Elige Proyecto en blanco.

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

Cuando tengas un proyecto en blanco, podrás crear archivos de model y ver y, luego, conectar tu proyecto a Git para registrar cambios en tus archivos de LookML y administrar versiones de tus archivos.

Cómo configurar un modelo

Usa el botón Configurar modelo nuevo en la parte superior de la página Proyectos de Looker 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 a los desarrolladores no se les otorgaron los permisos manage_models ni manage_project_models, como se describe en la página de documentación Genera un modelo. Si configuras el modelo para los desarrolladores, entonces podrán ejecutar consultas en cuanto generen o creen el archivo del 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 especificar 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 del modelo qué conexión debe usar el modelo. Si un desarrollador especifica una conexión que no permitiste en la configuración del modelo, no se ejecutará ninguna consulta en ese modelo.