Comment migrer de nombreux rapports Tableau et Power BI vers des tableaux de bord AI/BI en une seule exécution /importBI, puis examiner et affiner chacun d'eux avec Genie Code.
par Dipankar Kushari et Archana Shetty
Dans notre article précédent, Migrate Your Dashboards to AI/BI with Genie Code, nous avons vu comment migrer un seul rapport Tableau ou Power BI vers Databricks AI/BI à l'aide de la compétence /importBI dans Genie Code. Ce processus rapport par rapport est parfait pour un projet pilote, mais la plupart des organisations possèdent des centaines de rapports accumulés au fil des ans, et les migrer individuellement transforme un effort de modernisation stratégique en une corvée manuelle de plusieurs mois.
La migration en masse des tableaux de bord change la donne. Vous pouvez désormais cibler un dossier entier de rapports avec l'agent de migration et les convertir en AI/BI Dashboards en une seule exécution, sans avoir à lancer les migrations rapport par rapport.
Ce guide est pour vous si :
/importBI sur un ou deux rapports et êtes prêts à passer à l'échelle.La migration en masse étend l'expérience de migration Databricks AI/BI afin que, au lieu d'importer un rapport à la fois, vous puissiez en traiter plusieurs ensemble à partir d'une seule commande. L'agent de migration lit vos fichiers BI sources, génère les AI/BI Dashboards correspondants sur Databricks et les associe au catalogue et au schéma cibles que vous spécifiez.
Cette fonctionnalité est désormais généralement disponible et prête à être utilisée dans votre espace de travail dès aujourd'hui. Avant de commencer, vérifiez que les fonctionnalités d'IA optimisées par des partenaires sont activées au niveau du compte et de l'espace de travail.
Pour les équipes qui standardisent sur Databricks AI/BI, la migration en masse supprime le plus grand goulet d'étranglement lors d'une migration de tableaux de bord à grande échelle : la répétition pure et simple du déplacement des rapports un par un. En migrant un dossier entier de rapports Tableau ou Power BI en une seule exécution — et en les plaçant directement dans le catalogue et le schéma de votre choix —, vous transformez un projet de migration d'un arriéré manuel en un flux de travail reproductible, dossier par dossier.
Le guide ci-dessous détaille une migration en masse de bout en bout. Il est divisé en trois phases :
| Phase | Étapes |
|---|---|
| Préparer | (1) Exporter vos rapports BI (2) Les stocker dans un volume Unity Catalog |
| Exécuter | (3) Démarrer l'importation en masse (4) Choisir le catalogue et le schéma cibles (5) Suivre le traitement par lots |
| Examiner et affiner | (6) Examiner chaque rapport (7) Suivre le plan de migration (8) Affiner et peaufiner |
Exportez chaque rapport Tableau ou Power BI que vous souhaitez migrer vers un type de fichier pris en charge. Cela inclut : .twb, .twbx, .tds, .tdsx, .pbit ou .tmdl. La documentation d'exportation Tableau et les guides sur les modèles de rapports Power BI vous guident tout au long de l'exportation.
Astuce : Vous travaillez avec un classeur Tableau qui se connecte à une source de données publiée ? Exportez également cette source de données (.tds ou .tdsx) et conservez-la à côté du classeur.
Placez les fichiers de rapports BI que vous souhaitez migrer dans un répertoire au sein d'un volume Unity Catalog. Les regrouper dans un seul dossier vous permet de les migrer par lot. Une exécution en masse récupère toujours ses fichiers à partir du volume ; glisser des fichiers directement dans le chat ne fonctionne que pour les importations ponctuelles de rapports uniques.
À partir d'un brouillon de tableau de bord, ouvrez Genie Code et soumettez :
/importBI <path/to/volume/directory>

Ci-dessus : Exécution de /importBI sur un répertoire de volume à partir d'un brouillon de tableau de bord.
Cibler le répertoire avec la commande (plutôt qu'un seul fichier) déclenche le flux en masse pour tous les rapports de ce dossier.
Si vous préférez le langage naturel, une demande telle que « Migrer chaque rapport Power BI dans /Volumes/finance/bi/reports vers AI/BI Dashboards » fonctionne tout aussi bien.
Vous pouvez également nommer des fichiers spécifiques au lieu d'un dossier entier : « Migrer les rapports Tableau Dashboard1.twb, Dashboard2.twb dans /Volumes/finance/bi/reports vers AI/BI Dashboards ».
Enfin, vous devez ajouter des instructions qui s'aient à l'ensemble du lot — par exemple, demander à Genie Code de « créer uniquement les vues de métriques ».
L'agent reconnaît le lot et liste les rapports qu'il a trouvés dans le volume, associant de lui-même chaque classeur Tableau à son fichier de source de données compagnon et vous demandant confirmation en cas de doute sur une association. Il vous invite ensuite à indiquer le catalogue et le schéma de destination afin que les vues de métriques et les vues SQL des tableaux de bord migrés se trouvent au bon endroit.

Ci-dessus : Genie Code liste les rapports trouvés et demande le catalogue et le schéma cibles.
Une fois que vous avez vérifié la liste des fichiers et donné votre accord, la migration en masse démarre et un panneau de statut affiche chaque rapport à mesure qu'il commence. Les rapports sont mis en file d'attente et traités par petits groupes, et chaque rapport réutilise les tables et vues Unity Catalog existantes dans la mesure du possible avant d'en créer de nouvelles.
Remarque : pour connaître les limites actuelles concernant le nombre et la taille des fichiers pris en charge dans une seule importation en masse, consultez toujours la documentation publique sur /importBI.
Une carte de statut dans le chat tient un compte actualisé du lot, chaque rapport étant marqué comme En file d'attente (non démarré), En cours ou Terminé (session close). Vous pouvez arrêter un rapport individuel, ou interrompre tout ce qui est encore en cours, à partir de la même carte.

Ci-dessus : La carte de statut suit chaque rapport du lot.
Étant donné que chaque rapport s'exécute dans sa propre tâche en arrière-plan, il n'est pas nécessaire de garder l'onglet ouvert — revenez à tout moment au chat d'origine dans votre historique Genie Code pour voir la progression du lot.
Chaque nom de fichier sur la carte de statut renvoie à la conversation Genie Code propre à ce rapport, qui s'ouvre dans un onglet séparé. Si une exécution s'arrête pour poser une question, répondez-y là-bas et la migration reprendra là où elle s'était arrêtée.

Ci-dessus : Une exécution qui s'est mise en pause pour demander des informations. Dans cet exemple, la source de données publiée derrière le classeur.
Comme pour une migration de fichier unique /importBI, chaque rapport passe par la phase de planification de Genie Code — par exemple, l'analyse et l'évaluation du classeur, l'énumération de la couche sémantique, la création de vues de métriques, la construction des pages du tableau de bord et la validation de la migration.

Ci-dessus : Le plan de migration pour un seul rapport, suivi étape par étape.
Une fois l'exécution du plan terminée, vous pouvez afficher le tableau de bord AI/BI final produit par la migration. Vous pouvez l'améliorer ou le personnaliser davantage à l'aide de prompts Genie Code de suivi. Chaque réponse de Genie Code peut être annulée en une seule étape, il est donc sans danger de faire des essais, et vous pouvez même demander à Genie Code d'embellir l'apparence visuelle du tableau de bord.

Ci-dessus : Un tableau de bord AI/BI final produit par la migration en masse.
Avant de mettre hors service un rapport source, vérifiez que le tableau de bord migré fournit les mêmes réponses que l'original.
Conseil : Si vous avez connecté Tableau ou Power BI via une connexion MCP en lecture seule (voir l'aide-mémoire ci-dessous), Genie Code peut vérifier les chiffres directement par rapport au rapport en direct plutôt que de lire les valeurs d'une capture d'écran.
Configurez bien les choses avant d'exécuter /importBI pour obtenir la migration la plus fidèle dès le premier essai :
| Bonne pratique | Détails |
|---|---|
| Connectez votre outil BI source via MCP (facultatif / recommandé) | • Configurez une connexion MCP en lecture seule à Tableau ou Power BI pour que Genie Code puisse utiliser le rapport en direct comme source de vérité, en validant les résultats par rapport à l'original plutôt que de s'en remettre uniquement au fichier exporté, ce qui améliore considérablement la précision.
|
| Téléchargez les définitions de sources de données partagées ou publiées | • Dans Tableau, exportez toute source de données publiée vers son propre fichier .tds ; dans Power BI, exportez le modèle de données partagé sous la forme d'un .pbit. Téléchargez-les en même temps que le rapport pour que l'agent voie toute la couche sémantique. |
| Assurez-vous que les données sous-jacentes sont accessibles dans Databricks | • Les tableaux de bord migrés sont mappés aux tables Unity Catalog (via Lakeflow Connect, Lakehouse Federation ou des tables UC existantes).
Exemple : “Les tables source de ce rapport sont disponibles dans le schéma dev.finance” “Utilisez prod.finance.table1, prod.finance.table2 et prod.finance.mv_revenue comme source pour ce rapport” |
| Ajoutez des captures d'écran du tableau de bord d'origine | • Le téléchargement de captures d'écran « avant » dans le chat Genie Code améliore considérablement la fidélité visuelle et de mise en page. Conseil : Enregistrez les captures d'écran de vos tableaux de bord d'origine dans un volume Unity Catalog avant de migrer, afin de pouvoir y faire référence par chemin d'accès dans l'invite Genie Code. |
| Attendez-vous à affiner avec une invite de suivi | • Traitez Genie Code comme n'importe quel agent IA — une deuxième invite pour ajuster un graphique, un filtre ou un calcul après le premier passage est normale. |
| Promouvez les vues métriques terminées vers Unity Catalog | • Les importations Tableau génèrent par défaut des vues métriques étendues au tableau de bord (locales), tandis que les importations Power BI génèrent des vues métriques Unity Catalog.
|
| Vérifiez les limites de fichiers documentées | • Le nombre de fichiers et les limites de taille pouvant changer, reportez-vous toujours à la documentation publique /importBI pour connaître les limites actuelles.
|
| Examinez chaque résultat avant de lui faire confiance | • « Terminé » signifie que l'exécution s'est achevée, et non que chaque élément visuel est définitif. Validez chaque rapport avant de fermer sa session. |
Déplacer des centaines de rapports Tableau ou Power BI vers Databricks AI/BI ne signifie plus forcément réaliser des centaines de migrations individuelles. Avec la migration en bloc, vous préparez un dossier de rapports une seule fois, exécutez une seule commande /importBI et laissez Genie Code traiter le lot en arrière-plan pendant que vous examinez et affinez chaque résultat.
Si vous planifiez un effort de modernisation de la BI, téléchargez un dossier de rapports dans un volume Unity Catalog et essayez /importBI à partir d'un projet de tableau de bord pour voir la migration en bloc en action.
Si vous êtes prêt à commencer, placez simplement vos fichiers de rapport dans un volume Unity Catalog, ouvrez un projet de tableau de bord et exécutez /importBI dans Genie Code.
Pour des détails étape par étape, consultez la documentation sur l'importation de fichiers BI avec Genie Code. Si vous débutez avec AI/BI, commencez par notre article précédent : Migrez vos tableaux de bord vers AI/BI avec Genie Code. Vous devriez également lire la documentation produit sur la migration en bloc.
Q : Qu'est-ce que la migration en bloc pour Databricks AI/BI ?
R : La migration en bloc vous permet de traiter de nombreux rapports Tableau ou Power BI en une seule fois, au lieu d'importer un rapport par un. L'agent de migration lit vos fichiers BI source, génère les tableaux de bord AI/BI correspondants sur Databricks et les mappe à votre catalogue et schéma cible.
Q : Quels formats de fichier la migration en bloc prend-elle en charge ?
R : La migration en bloc prend en charge les formats de fichier .twb, .twbx, .tds, .tdsx, .pbit et .tmdl des rapports Tableau et Power BI.
Q : Où dois-je stocker mes fichiers de rapport BI pour la migration en bloc ?
R : Stockez tous les fichiers de rapport BI que vous souhaitez migrer dans un répertoire d'un volume Unity Catalog. Vous pouvez ensuite pointer la commande /importBI vers ce répertoire pour déclencher le flux de travail de migration en bloc.
Q : Comment démarrer une migration en bloc dans Genie Code ?
R : À partir d'un projet de tableau de bord, ouvrez Genie Code et soumettez la commande /importBI <chemin/vers/volume/repertoire>. Vous pouvez également utiliser le langage naturel, par exemple "Migre tous les rapports Power BI de /Volumes/finance/bi/reports vers des tableaux de bord AI/BI."
Q : Que dois-je faire une fois la migration en bloc terminée ?
R : Une fois l'opération terminée, vous pouvez examiner chaque tableau de bord migré, le comparer avec le rapport d'origine et utiliser les invites de Genie Code pour affiner ou personnaliser le tableau de bord. Vous pouvez également promouvoir des vues métriques locales vers Unity Catalog pour qu'elles puissent être réutilisées par d'autres tableaux de bord et applications.
(Cet article de blog a été traduit à l'aide d'outils basés sur l'intelligence artificielle) Article original
Abonnez-vous à notre blog et recevez les derniers articles directement dans votre boîte mail.