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 interpretar esas tablas. Puedes obtener más información sobre los proyectos en las páginas de documentación Proyectos de LookML y modelo de desarrollo 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 a la información del proyecto y edítala.

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 en 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 de modelo, hay algunos que se aplican a nivel de proyecto, como see_lookml, que te permite ver el LookML de un proyecto, y develop, que te permite editarlo.

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

Creando un proyecto

Para crear un proyecto, sigue estos pasos:

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

  2. Selecciona Proyectos en la sección Desarrollar del panel de navegación.

  3. En la página Proyectos de LookML, 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, incluidos el nombre y el punto de partida.

Looker puede crear un proyecto de varias maneras, y los pasos que se deben seguir dependen 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 automáticamente un modelo a partir de tu base de datos

En la página New Project, especifica las siguientes opciones para generar automáticamente un modelo a partir de una base de datos.

  1. Nombre del proyecto: Asígnale un nombre a tu proyecto. Los nombres de los proyectos distinguen mayúsculas de minúsculas y solo permiten caracteres alfanuméricos, _, . y -. Elige el nombre del proyecto con cuidado y considéralo un ID permanente para el proyecto, ya que Looker usa el nombre del proyecto de las siguientes maneras:

    • Identificar el proyecto para 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.
    • Para identificar el proyecto para la importación de proyectos locales.
    • 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 la URL 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.

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

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

  4. Build Views From: Selecciona una de las siguientes opciones:

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

  5. Esquemas: Para 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.

  6. 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. En este campo, se distinguen 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.

Por último, haz clic en Crear proyecto para crear un proyecto que contenga el modelo generado.

  • El generador de LookML crea un archivo de modelo para el proyecto, así como 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 del 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.

En el caso de las conexiones de BigQuery, si generas un proyecto de LookML a partir de tu base de datos, Looker completa automáticamente las descripciones de los campos con las descripciones de los metadatos de las columnas de BigQuery, si las hay.

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.

Clona un repositorio de Git público desde la página Proyecto nuevo

Si seleccionas Clonar repositorio de Git público como punto de partida en la página Nuevo proyecto, Looker copia los archivos de un repositorio de Git público en un proyecto de LookML nuevo.

Looker admite la clonación de un repositorio de Git público con la URL web HTTPS del repositorio.

Para clonar un repositorio de Git público existente en un proyecto de Looker, sigue estos pasos:

  1. Verifica que estés en el Modo de desarrollo.
  2. En la sección Desarrollar del panel de navegación de Looker, selecciona Proyectos.

  3. En la página Proyectos de LookML, según la configuración de tu instancia, realiza una de las siguientes acciones:

    • Haz clic en el botón Nuevo proyecto de LookML para abrir la página Nuevo proyecto.
    • Haz clic en el botón Modelo nuevo para abrir la página Crear un modelo y, luego, en el banner de información de la página Crear un modelo, haz clic en el vínculo haz clic aquí para abrir la página Proyecto nuevo.

  4. En el campo Nombre del proyecto, asigna un nombre a tu proyecto. Los nombres de los proyectos distinguen mayúsculas de minúsculas y no pueden usar espacios ni ciertos caracteres especiales. Elige el nombre del proyecto con cuidado y considéralo un ID permanente para el proyecto, ya que Looker usa el nombre del proyecto de las siguientes maneras:

    • Identificar el proyecto para 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.
    • Para identificar el proyecto para la importación de proyectos locales.
    • 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 la URL 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.

  5. En el campo Punto de partida, selecciona Clonar repositorio de Git público.

  6. En el campo URL del repositorio de Git, ingresa la URL del repositorio de Git público. Asegúrate de que la URL tenga el formato https://github.com/example/my-repository.git.

  7. Haz clic en Crear proyecto. Looker clona el repositorio y abre el IDE de Looker en el nuevo proyecto de LookML con los archivos del proyecto del repositorio clonado.

Una vez que Looker haya creado tu nuevo proyecto de LookML, debes configurar el control de versión de Git conectándote a un repositorio de Git. Consulta la página de documentación Configura y prueba una conexión de Git para conocer los procedimientos de conexión a Git con HTTPS o SSH.

Según tu situación, es posible que quieras configurar tu conexión de Git para enviar cambios a tu propio repositorio de Git o que quieras enviar cambios de vuelta al repositorio de Git original clonado:

  • Si quieres usar los archivos clonados como punto de partida para tu propio proyecto, independientemente del repositorio de Git público, configura la conexión de Git de tu proyecto para que apunte a tu propio repositorio de Git y envía los cambios allí.
  • Si quieres contribuir con actualizaciones al repositorio de Git público que clonaste y tienes un token de acceso personal con acceso de lectura y escritura al repositorio público, configura la conexión de Git de tu proyecto para que apunte al repositorio de Git público y envía tus cambios allí.

Después de configurar la conexión de Git a un repositorio, puedes editar los archivos en el IDE de Looker y, luego, usar el control de versión y, además, implementar los cambios en producción como con cualquier proyecto de LookML estándar.

Método alternativo para clonar un repositorio de Git público

La forma más sencilla de clonar un repositorio de Git público es usar la página Nuevo proyecto en Looker.

Como alternativa, puedes bifurcar el repositorio y conectarlo a un proyecto en blanco en Looker siguiendo estos pasos:

  1. Navega a tu proveedor de Git y bifurca el repositorio.
  2. En Looker, crea un proyecto en blanco como se describe en la sección Crea un proyecto en blanco de esta página.
  3. Una vez que crees el nuevo proyecto de LookML en blanco, configura la conexión de Git del proyecto con la bifurcación de tu repositorio de Git con HTTPS o SSH.

Después de configurar la conexión de Git a la bifurcación de tu repositorio, puedes editar los archivos en el IDE de Looker y, luego, usar el control de versión y, además, implementar los cambios en producción como con cualquier proyecto de LookML estándar.

Cómo crear un proyecto en blanco

Si seleccionas Proyecto en blanco como punto de partida en la página Proyecto nuevo, 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. En la sección Desarrollar del panel de navegación de Looker, selecciona Proyectos.

  3. En la página Proyectos de LookML, según la configuración de tu instancia, realiza una de las siguientes acciones:

    • Haz clic en el botón Nuevo proyecto de LookML para abrir la página Nuevo proyecto.
    • Haz clic en el botón Modelo nuevo para abrir la página Crear un modelo y, luego, en el banner de información de la página Crear un modelo, haz clic en el vínculo haz clic aquí para abrir la página Proyecto nuevo.

  4. En el campo Nombre del proyecto, asigna un nombre a tu proyecto. Los nombres de los proyectos distinguen mayúsculas de minúsculas y no pueden usar espacios ni ciertos caracteres especiales. Elige el nombre del proyecto con cuidado y considéralo un ID permanente para el proyecto, ya que Looker usa el nombre del proyecto de las siguientes maneras:

    • Identificar el proyecto para 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.
    • Para identificar el proyecto para la importación de proyectos locales.
    • 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 la URL 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.

  5. En el campo Punto de partida, elige Proyecto en blanco.

  6. Haz clic en Crear proyecto. Looker creará el proyecto y lo abrirá en el IDE de Looker.

Soluciona el error "El proyecto ya existe"

Cuando creas un proyecto nuevo en el IDE de Looker, es posible que recibas un error Project already exists, incluso si el proyecto no es visible en la IU de Looker (incluidos los usuarios con permisos de administrador). Este problema se produce si un usuario creó anteriormente un proyecto con el mismo nombre en el modo de desarrollo, pero no implementó un modelo ni envió los cambios a producción. En Looker, un proyecto en este estado sin confirmar solo es visible para el usuario que lo creó.

Para resolver este problema, identifica al creador del proyecto y actúa como ese usuario para confirmar y, luego, implementar el proyecto o borrarlo, como se indica a continuación. Debes ser administrador de Looker o tener el permiso sudo para usar sudo como creador del proyecto.

1. Identifica al creador del proyecto: Ejecuta una consulta en las exploraciones de la actividad del sistema con el nombre del proyecto para identificar al usuario que lo creó originalmente. 1 Usar la identidad del creador: Usa la función Sudo de Looker para usar la identidad del usuario identificado. 1 Administra o borra el proyecto: Mientras estés conectado como creador, cambia al Modo de desarrollo. Ahora, el proyecto es visible en el IDE. Puedes configurar o implementar el proyecto, o bien borrarlo para liberar su nombre.

Próximos pasos

Después de crear un proyecto, puedes hacer lo siguiente: