La página Proyectos de LookML proporciona una lista de todos los proyectos de LookML en la instancia de Looker y muestra todos los modelos de cada proyecto.
Para acceder a la página Proyectos de LookML, sigue estos pasos:
- Para abrir el panel Develop, selecciona la opción Develop en el panel de navegación.
- En el panel Desarrollo, selecciona Proyectos.
Creación de proyectos
En esta página de documentación, se da por sentado que ya creaste un proyecto con uno de los siguientes métodos:
- como parte de la generación de modelos a través de la página Crear un modelo en Looker
- como un proyecto en blanco a través de la página Crear un modelo en Looker
- con el proceso heredado para crear un proyecto
Cómo ver los proyectos existentes y sus modelos
Para ver una lista de los proyectos existentes, navega a la página Proyectos de LookML.
En el modo de producción, la página Proyectos de LookML muestra los proyectos que se generaron y enviaron a producción. En el modo de desarrollo, la página muestra los proyectos que extrajiste de producción o que generaste en el modo de desarrollo. La página Proyectos de LookML incluye las siguientes categorías básicas:
- Sección superior: Los proyectos que se enumeran en la sección superior se crearon y pueden incluir archivos de modelo y vista generados. Si eres administrador de Looker o tienes permiso
developpara al menos un modelo en un proyecto, puedes ver el proyecto en el panel Desarrollar y en la sección superior de la página. - Sección Proyectos pendientes: Los proyectos que aparecen en la sección Proyectos pendientes son proyectos en los que el administrador de Looker configuró las conexiones permitidas para un modelo, pero los desarrolladores de Looker aún no agregan el código de LookML. Si tienes el permiso
develop, puedes ver estos proyectos. - Sección Marketplace Projects: Los proyectos que aparecen en la sección Marketplace Projects se crearon cuando se instaló una aplicación, un bloque o un complemento con Looker Marketplace.
Para obtener información sobre cómo especificar un proyecto nuevo o un modelo nuevo para un proyecto existente, consulta la página de documentación Cómo generar un modelo.
Visualiza la ficha de un proyecto
La página Proyectos de LookML muestra los siguientes elementos para cada proyecto:
- Columna Project: Es el nombre del proyecto. Cada proyecto puede tener uno o más modelos junto a él. Selecciona el nombre del proyecto para navegar a su modelo de LookML.
- Columna Models: Es el conjunto de archivos de modelos de LookML para el proyecto determinado. Si tu entorno de modo de desarrollo difiere del de producción, esta lista puede cambiar entre el modo de desarrollo y el modo de producción. Por ejemplo, es posible que hayas creado un modelo nuevo en el modo de desarrollo que aún no publicaste en producción.
- Columna de problemas de configuración: Si hay un problema con un modelo, este muestra un estado que indica el problema con la configuración.
- Botón Configurar: Si el botón Configurar está disponible para un proyecto, puedes agregar o editar la configuración del modelo de ese proyecto.
Si hay un problema con un modelo, este muestra un estado que indica el problema con la configuración.
| Problema | Explicación |
|---|---|
| El archivo de modelo de LookML aún no existe | Verás este problema si alguien configuró un modelo en esta página, pero aún no creó el archivo de LookML correspondiente. |
| Configuración necesaria para el uso | Verás este problema si alguien creó un nuevo archivo de modelo de LookML en un proyecto existente, pero aún no lo configuró en esta página. |
| La conexión “x” no existe | No existe el connection declarado en el archivo del modelo (por ejemplo, si alguien escribió mal o aún no lo creó). |
| El modelo “x” no tiene permitido usar la conexión “y” | Según la configuración de esta página, no se permite el connection declarado en el archivo del modelo. |
| Ya hay un modelo llamado “x” configurado en el proyecto “y” | Los nombres de los modelos deben ser únicos en tu instancia de Looker, incluso si están en diferentes proyectos. |
Cómo ver la ficha de un proyecto de Marketplace
En la sección Marketplace Projects de la página LookML Projects, se enumeran los proyectos que se crearon durante la instalación de una aplicación, un bloque o un complemento de Marketplace. La ficha de cada proyecto de mercado incluye los siguientes elementos:
- Ficha: Es un vínculo a la ficha de la aplicación, el bloque o el complemento en el Mercado de Looker.
- Project: Es el nombre del proyecto. Puedes hacer clic en el nombre del proyecto para ver o editar su LookML.
- Botón Ver LookML o Editar LookML: Para navegar a un proyecto de mercado, selecciona el botón Ver LookML para el proyecto principal de solo lectura de un bloque de mercado o el botón Editar LookML para su proyecto de configuración, que se puede personalizar. Para obtener más información sobre la personalización de bloques del mercado, consulta la página de documentación Cómo personalizar bloques del mercado de Looker.
- Modelos: Es el conjunto de archivos de modelos de LookML para el proyecto determinado.
- Botón Configurar: Si el botón Configurar está disponible junto a la ficha del proyecto, puedes agregar o editar la configuración del modelo del proyecto.
Cómo ver la ficha de un proyecto pendiente
La sección Proyectos pendientes contiene proyectos y modelos que están configurados, pero que aún no tienen LookML generado ni definido de forma manual.
Configurar modelos antes de que exista el proyecto es útil si tienes desarrolladores a los que no se les otorgó el permiso manage_models ni manage_project_models. Dado que el modelo ya se configuró, esos desarrolladores pueden ejecutar consultas en cuanto crean el proyecto y ese modelo. Cuando se genera el proyecto, la ficha de ese proyecto se mueve a la sección superior de la página Proyectos de LookML.
La sección Proyectos pendientes incluye los siguientes elementos:
- Columna Project: En esta sección, se enumeran los proyectos que están configurados, pero que aún no se generaron. El nombre del proyecto en este campo es el nombre previsto del proyecto. Selecciona el nombre del proyecto para mostrar la página Nuevo proyecto, en la que puedes generarlo. Debes estar en el modo de desarrollo para acceder a la página New Project.
- Columna Models: Es el nombre del modelo que se especificó cuando se creó la configuración del modelo.
- Columna Conexiones permitidas: La columna a la derecha del nombre del modelo muestra las conexiones permitidas para este modelo cuando se creó la configuración del modelo.
- Botón Configurar: El botón Configuración te permite cambiar el nombre del proyecto y las conexiones permitidas para este modelo.
- Botón Add LookML: El botón Add LookML abre la página New Project para ese proyecto, en la que puedes generar LookML automáticamente en función de un conjunto de tablas de tu base de datos.
Cómo agregar y editar configuraciones de modelos
Si el botón Configurar está disponible junto a la ficha de un proyecto existente, puedes agregar o editar la configuración del modelo del proyecto.
Si el modelo no tiene una configuración, cuando hagas clic en Configurar, Looker mostrará la ventana Configurar un modelo. En la ventana Configure a Model, puedes especificar el nombre del modelo, el nombre del proyecto y las conexiones que están disponibles para el modelo.
La lista de conexiones solo incluye las que se pueden usar con el proyecto del modelo. Las conexiones que se configuran para usarse en todos los proyectos tienen la etiqueta (Instance wide).
También puedes hacer clic en el botón Configurar modelo nuevo en la parte superior de la página Proyectos para abrir la ventana Configurar un modelo. En este caso, puedes usar la ventana Configure a Model para crear y configurar un modelo nuevo. El modelo nuevo no tendrá ningún LookML, pero se asociará con una conexión. Para completar este proceso, ingresa un nombre nuevo para el modelo en el campo Modelo y completa el campo Proyecto con un nombre nuevo o selecciona el mismo nombre que el modelo, selecciona las conexiones y haz clic en Guardar. Más adelante, tú o algún otro desarrollador de Looker pueden agregar LookML al proyecto nuevo para definir el modelo.
Si el modelo tiene una configuración, cuando hagas clic en Configurar, Looker mostrará la ventana Editar configuración del modelo. En la ventana Editar configuración del modelo, puedes cambiar las conexiones disponibles para el modelo.
Cuando editas la configuración de un modelo, puedes ver el nombre del modelo, pero no cambiarlo. Los modelos se nombran según los nombres de archivo que usas cuando editas los archivos de modelo en el IDE de Looker.
En el campo Project, puedes especificar que el modelo se asocie con un proyecto diferente. Por ejemplo, si creaste un proyecto nuevo que incluye un modelo con el mismo nombre, puedes migrar la configuración del modelo para que se asocie con el modelo del proyecto nuevo.
En el campo Conexiones permitidas, puedes limitar el modelo para que use una lista de conexiones específicas o permitir que use cualquier conexión (todas las conexiones actuales y futuras).
Cómo cambiar el nombre de un proyecto
Cuando un administrador de Looker crea un proyecto de LookML, proporciona un nombre para él. El nombre del proyecto debe considerarse 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
project_idcomo parámetro. - 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 una URL de
example.looker.com, el archivo de manifiesto del proyecto llamadoecommercese puede encontrar en esta URL:https://example.looker.com/projects/ecommerce/files/manifest.lkml.
Si tienes el permiso manage_models de Looker, puedes cambiar el nombre de un proyecto de LookML en la página Configuración del proyecto del proyecto. Los desarrolladores de Looker que no son administradores pueden ver la página Configuración del proyecto, pero no pueden cambiar las opciones de la página.
Para cambiar el nombre de un proyecto, sigue estos pasos:
- Verifica que el Modo de desarrollo esté activado.
- Navega a tu proyecto en el IDE de Looker.
- En tu proyecto, haz clic en Settings en la barra de navegación del IDE para abrir el panel de configuración del proyecto.
- Selecciona Configuración en el panel de configuración del proyecto.
- Usa el campo Nombre en Configuración del proyecto para editar el nombre de tu proyecto.
- En la página Project Configuration, haz clic en Save Project Configuration para guardar el nombre del proyecto nuevo.
Borra un proyecto
Si eres administrador de Looker, puedes borrar un proyecto existente con la configuración del proyecto. Para ver la configuración del proyecto, ábrelo y haz clic en Configuración en la barra de navegación del IDE.
Un proyecto borrado ya no aparece en la sección Proyectos de la página Proyectos de LookML, pero aún aparece en la sección Proyectos configurados.
Para quitar la configuración del proyecto, que lo quita por completo de tu entorno de desarrollo, haz lo siguiente:
- Navega a tu proyecto en el IDE de Looker.
- En tu proyecto, haz clic en Configuración en la barra de navegación del IDE para abrir el panel de configuración del proyecto.
- En el panel de configuración del proyecto, elige Configuración para ver la configuración del proyecto.
- En Project Configuration, selecciona Delete Project.
- En la ventana Borrar proyecto, verifica las advertencias y los cambios no sincronizados que se perderán si se borra el proyecto.
- Si estás seguro de que se debe borrar el proyecto, escribe su nombre en el campo. Para cancelar la operación y volver a tu proyecto, usa el botón Atrás del navegador.
- Haz clic en el botón Borrar de forma permanente <nombre del proyecto>.