Acceso y edición de la información del proyecto

En la página Proyectos de Looker, se proporciona una lista de todos los proyectos de LookML en la instancia de Looker y se muestran todos los modelos de cada proyecto.

Para acceder a la página Proyectos de Looker, sigue estos pasos:

1. Abre el panel Develop. Para ello, selecciona la opción Develop en el panel de navegación.
2. En el panel Develop, selecciona Projects.

Nota: En esta página, se supone que creaste un proyecto o que trabajas con un proyecto existente.

Visualiza proyectos existentes y sus modelos

Para ver una lista de proyectos existentes, navega a la página Proyectos de LookML.

En el Modo de producción, la página Proyectos de LookML enumera los proyectos que se generaron y enviaron a producción. En Modo de desarrollo, la página enumera los proyectos que extrajiste de producción o que generaste tú mismo en Modo de desarrollo. En la página Proyectos de LookerML, se incluyen las siguientes categorías básicas:

• Sección superior: Se crearon los proyectos que se indican en la sección superior y pueden incluir archivos de vista y modelo generado. Si eres administrador de Looker o si tienes permiso develop para al menos un modelo de 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 se enumeran 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 han generado el proyecto ni el modelado. Si tienes el permiso develop, puedes ver estos proyectos.
• Sección Proyectos de Marketplace: Los proyectos que figuran en la sección Proyectos de Marketplace se crearon cuando se instaló una aplicación, un bloque o un complemento a través de Looker Marketplace.

Nota: Para ver un proyecto, debes tener el permiso manage_models o develop para, al menos, un modelo del proyecto. Si tienes el permiso manage_models o el permiso manage_project_models para al menos un modelo del proyecto, puedes agregar o editar la configuración de cualquier modelo asociado con un proyecto de la lista.

Si quieres 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 Crea un proyecto nuevo de LookML.

Visualiza la ficha de un proyecto

En la página LookML Projects, se muestran los siguientes elementos para cada proyecto:

• Columna Project: Es el nombre del proyecto. Cada proyecto puede tener uno o más modelos enumerados junto a él. Selecciona el nombre del proyecto para navegar a LookML.
• Columna Modelos: Es el conjunto de archivos de modelo de LookML para el proyecto determinado. Si tu entorno de Modo de desarrollo difiere del de producción, esta lista puede cambiar entre Modo de desarrollo y Modo de producción. Por ejemplo, es posible que hayas creado un modelo nuevo en Modo de desarrollo que aún no enviaste a 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ó un archivo de LookML correspondiente para él.
Configuración necesaria para el uso	Verás este problema si alguien creó un archivo de modelo nuevo de LookML en un proyecto existente, pero aún no lo configuró en esta página.
La conexión "x" no existe	El connection declarado en el archivo de modelo no existe (por ejemplo, si alguien lo escribió mal o aún no lo creó).
El modelo “x” no puede usar la conexión “y”	El connection declarado en el archivo de modelo no se permite según la configuración de esta página.
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 proyectos diferentes.

Visualiza la ficha de un proyecto de Marketplace

En la sección Proyectos de Marketplace de la página Proyectos de Looker, 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 Marketplace incluye los siguientes elementos:

• Ficha: Es un vínculo a la ficha de la aplicación, el bloque o el complemento en Looker Marketplace.
• Project (Proyecto): 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: Puedes navegar a un proyecto de Marketplace; para ello, selecciona el botón Ver LookML en el proyecto principal de solo lectura de un bloque de Marketplace o Editar LookML en el proyecto de configuración. Puedes personalizar este último. Si quieres obtener más información para personalizar los bloqueos de Marketplace, consulta la página de documentación Personaliza los bloques de Looker Marketplace.
• Modelos: Es el conjunto de archivos de modelo 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.

Visualiza la ficha de un proyecto pendiente

La sección Proyectos pendientes contiene modelos que están configurados con un nombre de proyecto, pero que aún no se generaron. Por lo tanto, la sección Proyectos pendientes contiene proyectos y modelos que solo están configurados y que aún no tienen LookML.

Configurar modelos antes de que exista el proyecto es útil si tienes desarrolladores a los que no se les otorgó el permiso manage_models o manage_project_models. Debido a que el modelo ya está configurado, los desarrolladores pueden ejecutar consultas en cuanto crean el proyecto y ese modelo. Cuando se genere el proyecto, su ficha se trasladará a la sección superior de la página Proyectos de Looker.

En la sección Proyectos pendientes, se incluyen 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 New Project (Proyecto nuevo) en la que puedes generar ese proyecto. Debes estar en Modo de desarrollo para llegar a la página Proyecto nuevo.
• Columna Modelos: Es el nombre del modelo que se especificó cuando se creó la configuración del modelo.
• Columna de conexiones permitidas: La columna a la derecha del nombre del modelo muestra las conexiones que se permitieron para este modelo cuando se creó su configuración.
• Botón Configure: El botón Configuration te permite cambiar el nombre del proyecto y las conexiones que se permiten para este modelo.
• Botón Agregar LookML: El botón Agregar LookML abre la página Proyecto nuevo de ese proyecto, lo que te permite usar el generador de LookML para generar automáticamente LookML basado en un conjunto de tablas en tu base de datos.

Agrega y edita configuraciones

Si el botón Configurar está disponible junto a la ficha del proyecto, 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 disponibles para el modelo.

La lista de conexiones incluye solo las conexiones que se pueden usar con el proyecto del modelo. Las conexiones configuradas para usarse en todos los proyectos tienen la etiqueta (Instance wide).

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 renombrarlo. Los modelos se nombran según los nombres de archivo que usas cuando editas los archivos del modelo en el IDE de Looker.

En el campo Project, puedes especificar que el modelo se debe asociar con un proyecto diferente. Por ejemplo, si creaste un proyecto nuevo que incluye un modelo con el mismo nombre, puedes hacer la transición de 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 el modelo use cualquier conexión (todas las conexiones actuales y futuras).

Cambia el nombre de un proyecto

Cuando un administrador de Looker crea un proyecto de LookML, el administrador proporciona un nombre de proyecto. El nombre del proyecto debe considerarse un ID permanente, ya que Looker lo usa de las siguientes maneras:

• A fin de identificar el proyecto para las llamadas a la API que tengan project_id como parámetro
• Identificar el proyecto en la base de datos interna de la instancia de Looker.
• A fin de identificar el proyecto para su importación de proyecto local.
• Mostrar el proyecto en la página Proyectos de Looker.
• Mostrar el proyecto en la sección Desarrollar del panel de navegación de Looker.
• Como parte de la URL para los archivos del proyecto. Por ejemplo, en una instancia de Looker con una 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.

Si tienes el permiso manage_models de Looker, puedes cambiar el nombre de un proyecto de LookML mediante 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 en la página.

Advertencia: Si cambias el nombre de un proyecto de LookML, deberás hacer lo siguiente:

• Actualiza el parámetro local_dependency en el archivo de manifiesto de LookML de cualquier proyecto de LookML que use la importación de proyectos locales para importar el proyecto al que le cambiaste el nombre.
• Actualiza todas las apps web con llamadas a la API que usen el parámetro project_id para hacer referencia al proyecto.
• Actualiza el parámetro project_name en el archivo de manifiesto de LookML del proyecto de LookML con nombre cambiado, si el proyecto tiene un archivo de manifiesto.
• Actualiza los favoritos del navegador o las URLs guardadas si tú o cualquiera de tus desarrolladores de LookML dependen de las URLs para acceder a los archivos de LookML del proyecto a los que se le cambió el nombre.

Para cambiar el nombre de un proyecto, sigue estos pasos:

1. Verifica que el Modo de desarrollo esté activado.
2. Navega a tu proyecto en el IDE de Looker.
3. En tu proyecto, haz clic en Settings en la barra de navegación del IDE para abrir el panel de configuración del proyecto.
4. Selecciona Configuración en el panel de configuración del proyecto.
5. Usa el campo Nombre en Configuración del proyecto para editar el nombre de tu proyecto.
6. 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 en la página Configuración del proyecto. Para ver la página Configuración del proyecto, abre tu proyecto y haz clic en Configuración en la barra de navegación del IDE.

Importante: Si seleccionas el botón Borrar proyecto, se quitará todo LookML del proyecto en todos los entornos de desarrollo y producción de tu instancia de Looker. Antes de seleccionar este botón, asegúrate de que quieres borrar un proyecto. Una vez que borras un proyecto, la operación de eliminación no se puede revertir y es difícil y difícil recuperar un proyecto borrado.

Los proyectos borrados ya no aparecerán en la sección Proyectos de la página Proyectos de Looker, pero seguirán apareciendo en la sección Proyectos configurados.

Para quitar la configuración del proyecto, lo que quita por completo el proyecto de tu entorno de desarrollo, haz lo siguiente:

1. Navega a tu proyecto en el IDE de Looker.
2. En tu proyecto, haz clic en Settings en la barra de navegación del IDE para abrir el panel Project Settings.
3. En el panel de configuración del proyecto, elige Configuración para ver la configuración del proyecto.
4. En Configuración del proyecto, selecciona Borrar proyecto.
5. En la ventana Delete Project, verifica las advertencias y los cambios no sincronizados que se perderán si se borra el proyecto.
6. Si sabes con certeza 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.
7. Haz clic en el botón Borrar definitivamente <nombre del proyecto>.