Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Cette page explique comment utiliser les dossiers Git Databricks pour le développement de tableaux de bord collaboratifs et de contrôle de version. Il décrit également comment implémenter des processus CI/CD pour développer et déployer des tableaux de bord sur différents espaces de travail.
Important
Cette fonctionnalité est disponible en préversion publique.
Aperçu
Les dossiers Databricks Git effectuent le suivi des modifications et de l’historique des tableaux de bord, la collaboration de l’équipe de support et vous permettent de déployer des tableaux de bord en production et de récupérer les versions précédentes.
Activer la gestion du code source du tableau de bord
Les administrateurs d’espace de travail peuvent gérer l’accès à l’aperçu public depuis la page Aperçus. Par défaut, les tableaux de bord de support dans la préversion du dossier Git sont activés.
Fonctionnement de l’intégration git avec les tableaux de bord
Les dossiers Git de Databricks suivent et gèrent les modifications des tableaux de bord brouillons. Le brouillon de tableau de bord reflète toutes les modifications d’un tableau de bord suivi. Git ne suit pas les configurations de publication et de planification, telles que la sélection de l’entrepôt et la création de planification. Pour gérer ces configurations, utilisez l’interface utilisateur ou automatisez les modifications avec databricks Asset Bundles ou l’API REST IA/BI.
- Pour utiliser des offres groupées pour la gestion des tableaux de bord, consultez le tableau de bord.
- Pour publier et planifier des tableaux de bord avec l’API REST, consultez la référence de l’API Lakeview .
Remarque
L’API Lakeview utilise le nom précédent pour les tableaux de bord IA/BI.
Les dossiers Git Databricks gèrent les opérations Git courantes pour les tableaux de bord et d’autres objets d’espace de travail. Pour en savoir plus, consultez les dossiers Git Azure Databricks.
Application du contrôle de code source aux tableaux de bord
Pour suivre les tableaux de bord avec Git, placez-les dans un dossier Databricks Git. Utilisez l’une des options suivantes :
- Nouveaux tableaux de bord : Créez votre tableau de bord dans un dossier Databricks Git existant pour appliquer le contrôle de code source à partir du début.
- Tableaux de bord existants : Déplacez un tableau de bord existant dans un dossier Databricks Git pour le suivre avec Git.
Gestion des autorisations pour les tableaux de bord contrôlés par la source
Les autorisations au niveau du dossier s’appliquent à tous les objets de ce dossier, y compris les tableaux de bord. Les tableaux de bord d’un dossier Git héritent des autorisations du dossier parent en plus des autorisations spécifiques au tableau de bord. La plupart des opérations Git nécessitent l’autorisation CAN MANAGE. Pour plus d’informations, consultez listes de contrôle d’accès des dossiers et listes de contrôle d’accès de dossier Git.
Workflow de développement recommandé
Clonez le référentiel dans votre propre dossier Git Databricks, utilisez des branches de fonctionnalités et envoyez des demandes de tirage. Le tableau suivant explique comment utiliser des dossiers Git pour gérer les tableaux de bord pendant différentes phases de développement et de déploiement.
Important
Le changement de branches Git est une opération destructrice pour les tableaux de bord. Azure Databricks supprime les tableaux de bord qui n’existent pas sur la branche cible. Si vous revenez, les tableaux de bord réapparaissent avec de nouvelles URL et identifiants, ce qui entraîne l'interruption des liens publiés, des signets et des intégrations d’API. Vérifiez la branche cible avant de changer et mettez à jour toutes les références par la suite.
| Phase de projet | Flux de travail | Résultat attendu | Limitations connues |
|---|---|---|---|
| Validation initiale |
|
Git effectue le suivi du tableau de bord dans un référentiel distant. | |
| Développement |
|
|
Les fichiers de tableau de bord utilisent JSON le format. Les requêtes SQL sont affichées sur une seule ligne, ce qui peut rendre difficile la révision des différences dans les pull requests. |
| Déploiement |
|
|
Databricks ne fournit pas de prise en charge intégrée pour la synchronisation d’une branche distante avec un dossier Git dans l’espace de travail ou le déploiement de Bundles de ressources Databricks avec une ressource de tableau de bord à distance. Configurez l’automatisation CI/CD pour automatiser :
|
Pour plus d’informations sur la collaboration dans les dossiers Git Databricks, consultez Collaborer à l’aide de dossiers Git.
Limites
Le contrôle de code source avec les tableaux de bord IA/BI présente les limitations suivantes :
- Vous pouvez valider un maximum de 100 tableaux de bord dans un seul dossier Git. Cette limite peut changer pendant la préversion publique.
- Les travaux git, tels que les travaux faisant référence à des URL Git au lieu d’ID ou de chemins d’accès de ressources d’espace de travail, ne fonctionnent pas avec des tableaux de bord.
- La sérialisation du tableau de bord génère de longues chaînes, ce qui rend difficile la lecture et l’examen des différences lors des pull requests.
- Le format de fichier du tableau de bord change régulièrement pour inclure de nouveaux champs et d’autres améliorations. Pendant la préversion publique, ces modifications peuvent apparaître comme des différences dans Git que vous n’avez pas lancées.