Paneles de control de versiones con Git

En esta página se explica cómo usar carpetas de Git de Databricks para el control de versiones y el desarrollo de paneles colaborativos. También se describe cómo implementar procesos de CI/CD para desarrollar e implementar paneles en diferentes áreas de trabajo.

Visión general

Las carpetas de Git de Databricks realizan un seguimiento de los cambios y el historial del panel, la colaboración del equipo de soporte técnico y permiten implementar paneles en producción y recuperar versiones anteriores.

Habilitación del control de código fuente del panel

Los administradores del área de trabajo pueden controlar el acceso al área de trabajo desde la página Vistas previas. De forma predeterminada, la opción Paneles de soporte técnico en la carpeta Git es Activado.

Alternativa: Control de versiones manual

Si no puede habilitar carpetas de Git, use el siguiente flujo de trabajo manual para realizar un seguimiento de las versiones del panel:

  1. Exporte el panel como un archivo JSON. El formato de archivo es lvdash.json. Consulte Exportación, importación o reemplazo de un panel para obtener instrucciones de exportación.
  2. Agregue ese archivo a un sistema de control de versiones, como Git.
  3. Edite el archivo. Puede editar los valores en el archivo de texto directamente o volver a cargarlos en el área de trabajo y realizar cambios en la interfaz de usuario.
  4. Guarde el nuevo archivo. Si ha realizado cambios en la interfaz de usuario, exporte el nuevo archivo. Use el sistema de control de versiones para realizar un seguimiento de los cambios y versiones del panel.
  5. Actualice el panel existente. En el panel de borrador existente:
    1. Haz clic en el menú de kebab Icono de menú Kebab en la esquina superior derecha y, después, en Reemplazar panel.
    2. Haga clic en Elija de archivo en el cuadro de diálogo Reemplazar panel del de archivos. Después, haga clic en Sobrescribir.

Funcionamiento de la integración de Git con paneles

Las carpetas de Git de Databricks realizan un seguimiento y administran los cambios en los paneles de borrador . El borrador del panel refleja todos los cambios realizados en un panel con seguimiento. Git no realiza un seguimiento de las configuraciones de publicación y programación, como la selección de almacenamiento y la creación de la programación. Para administrar estas configuraciones, use la interfaz de usuario o automatice los cambios con agrupaciones de automatización declarativa o la API REST de AI/BI.

  • Para usar agrupaciones para la administración de paneles, consulte panel.
  • Para publicar y programar paneles con la API REST, consulte la referencia de la API de Lakeview .

Nota:

La API de Lakeview usa el nombre anterior para los paneles de AI/BI.

Las carpetas de Git de Databricks administran operaciones comunes de Git para paneles y otros objetos de área de trabajo. Para más información, consulte Carpetas de Git de Azure Databricks.

Aplicación del control de código fuente a los paneles

Para realizar un seguimiento de los paneles con Git, colóquelos en una carpeta de Git de Databricks. Use una de las siguientes opciones:

  • Nuevos paneles: Cree el panel dentro de una carpeta de Git de Databricks existente para aplicar el control de código fuente desde el principio.
  • Paneles existentes: Mueva un panel existente a una carpeta de Git de Databricks para realizar el seguimiento con Git.

Administración de permisos para paneles controlados por código fuente

Los permisos de nivel de carpeta se aplican a todos los objetos de esa carpeta, incluidos los paneles. Los paneles de una carpeta git heredan los permisos de la carpeta primaria, además de los permisos específicos del panel. La mayoría de las operaciones de Git requieren el permiso CAN MANAGE. Para más información, consulte ACL de carpetas y ACL de carpetas de Git.

Clona el repositorio en tu propia carpeta Git de Databricks, utiliza ramas de características y envía solicitudes de incorporación de cambios. En la tabla siguiente se describe cómo usar carpetas de Git para administrar paneles durante diferentes fases de desarrollo e implementación.

Importante

Cambiar de rama de Git es una operación destructiva para los paneles. Azure Databricks elimina los paneles que no existen en la rama de destino. Si vuelve a cambiar, los paneles reaparecerán con nuevas URL e ID, lo que romperá los enlaces publicados, los marcadores y las integraciones de API. Compruebe la rama de destino antes de cambiar y actualizar todas las referencias después.

Fase del proyecto Flujo de trabajo Resultados esperados Limitaciones conocidas
Confirmación inicial
  • Mueva el panel a una carpeta de Git en el área de trabajo.
  • Confirme e inserte en el repositorio de Git remoto.
 Git realiza un seguimiento del panel en un repositorio remoto.
Desarrollo
  • Los desarrolladores crean carpetas de Git en ramas de desarrollo independientes, normalmente en sus carpetas principales.
  • Confirme los cambios en la rama de desarrollo.
  • Combine ramas de desarrollo a Main mediante solicitudes de incorporación de cambios.
  • Los desarrolladores trabajan de forma independiente.
  • Git realiza un seguimiento de las versiones del panel.
Implementación
  • Cree una carpeta git en la rama de implementación en una carpeta de nivel superior que no sea de usuario. Consulte CI/CD con carpetas Git de Databricks.
  • Extraiga los cambios en la carpeta de implementación.
  • Publicar paneles desde esta carpeta.
  • Quite el acceso edit+ y restrinja las actualizaciones a Git.
  • Compartir paneles con consumidores.
  • Los consumidores acceden a una versión coherente y publicada del panel.
  • Puede compartir paneles en la misma carpeta con diferentes audiencias.
 Databricks no proporciona compatibilidad integrada para sincronizar una rama remota con una carpeta git en el área de trabajo o implementar agrupaciones de Automatización declarativa con un recurso de panel desde remoto. Configure la automatización de CI/CD para automatizar:
  • Extraer actualizaciones del repositorio remoto.
  • Publicar paneles después de la sincronización.
  • Implementación de agrupaciones de automatización declarativa después de una actualización.

Para obtener más procedimientos recomendados sobre la colaboración en carpetas de Git de Databricks, consulte Colaboración con carpetas de Git.

Limitaciones

El control de código fuente con paneles de IA/BI tiene las siguientes limitaciones:

  • Los trabajos basados en Git, como los trabajos que hacen referencia a direcciones URL de Git en lugar de identificadores de recursos o rutas de acceso del área de trabajo, no funcionan con paneles.
  • Last updated on