SnowConvert AI : Repointage Power BI¶

Ce guide fournit des instructions complètes sur l’utilisation de SnowConvert AI pour le repointage Power BI vers Snowflake. Il détaille le processus de migration de vos rapports et tableaux de bord Power BI existants pour exploiter Snowflake comme source de données sous-jacente. Vous apprendrez à préparer vos rapports Power BI, à exécuter l’outil SnowConvert AI, et à valider les rapports repointés afin de garantir une intégration transparente avec Snowflake.

SnowConvert AI fournit une nouvelle option pour redéfinir les connexions Power BI vers les bases de données migrées dans Snowflake. Cette redéfinition des connexions est appelée « repointage ». Le repointage est exécuté à l’intérieur de la logique de migration SnowConvert AI et utilise le contexte de migration pour identifier et migrer correctement les requêtes SQL intégrées.

Utiliser l’outil¶

Note

Notez que cette fonctionnalité ne prend en charge que les rapports Power BI avec l’extension .pbit. Avant de commencer, veuillez enregistrer vos rapports avec l’extension .pbit.

Conditions préalables¶

Avant de commencer, assurez-vous de disposer des éléments suivants : SnowConvert AI : L’outil doit être installé. Vous pouvez y accéder ici. Rapports Power BI : Vous devez télécharger vos rapports et les enregistrer au format .pbit.

Enregistrer correctement un .pbit¶

Ouvrez votre fichier de rapport (.pbix) et attendez qu’il charge.
Cliquez sur « Fichier ».

![](../../../../images/migrations/sc-assets/Power_BI_Repointing/PBIClickOnFile.png « Clic sur « Fichier »)

Cliquez ensuite sur « Enregistrer sous ».

![](../../../../images/migrations/sc-assets/Power_BI_Repointing/PBISaveButton.png « Enregistrer sous »)

Cliquez ensuite sur « Parcourir cet appareil ».

![](../../../../images/migrations/sc-assets/Power_BI_Repointing/PBIBrowseThisDevice.png « Section Parcourir cet appareil »)

Sélectionnez l’emplacement où vous souhaitez enregistrer votre fichier et choisissez l’extension .pbit.

![](../../../../images/migrations/sc-assets/Power_BI_Repointing/PBIFileNamePbit.png « Enregistrer le modèle »)

Cliquez sur « Enregistrer ».

![](../../../../images/migrations/sc-assets/Power_BI_Repointing/PBISaveButtonReport.png « Bouton Enregistrer le rapport »)

Si vous le souhaitez, ajoutez une description, puis cliquez sur « Ok ».

![](../../../../images/migrations/sc-assets/Power_BI_Repointing/PBISaveTemplateDescription.png « Description du rapport de modèle »)

Étapes de migration¶

Localisez tous les rapports Power BI avec l’extension .pbit dans un dossier.
Dans l’application SnowConvert AI, ajoutez le chemin des projets Power BI dans la section « Où se trouvent vos projets SSIS/Power BI ? ».
Procédez à la migration comme d’habitude.

![](../../../../images/migrations/sc-assets/Power_BI_Repointing/PBISampleAddingPathPBIRepointing.png « Configuration du repointage »)

Rapports : Dans le dossier de sortie, vous pouvez examiner le rapport nommé ETLAndBiRepointing sur la transformation de repointage.
Accès : Dans le dossier de sortie, vous pouvez examiner le « repointing_output » pour accéder aux rapports de repointage Power BI.
Exécution : Avant d’ouvrir vos rapports, il est important d’exécuter l’ensemble de vos DDLs migrées dans votre compte Snowflake. Sinon, l’objet ne sera pas récupéré, car il n’existe pas dans le compte Snowflake. Suivez donc les étapes suivantes :
1. Exécutez vos requêtes migrées.
2. Ouvrez votre rapport Power BI.
3. Renseignez les paramètres Power BI requis : SF_SERVER_LINK, SF_DB_NAME et SF_WAREHOUSE_NAME. Pour plus d’informations, veuillez examiner la documentation relative aux paramètres Power BI.

![](../../../../images/migrations/sc-assets/Power_BI_Repointing/PBIParameters.png « Paramètres Power BI »

Cliquez sur Charger et attendez que le rapport charge les informations.
Fournissez vos identifiants de connexion à l’application Power BI. Par ailleurs, si vous disposez de l’authentification à deux facteurs, il peut vous être demandé d’accepter chaque demande de connexion provenant de Power BI. Sachez qu’il peut y avoir plusieurs fenêtres contextuelles pour l’autorisation.
Examinez le rapport ETLAndBiRepointing et résolvez chaque entité de données présentant des problèmes.
Assurez-vous que tout fonctionne correctement.
Actualisez les données et enregistrez votre rapport dans le format de votre choix. Ce dernier est maintenant prêt à être partagé.

Structure du projet¶

Veuillez vous référer à la documentation Snowflake relative au langage source spécifique que vous repointez :

Vue d’ensemble de la structure de sortie¶

La structure de sortie ressemblera à ceci et inclura les rapports repointés. Le dossier de sortie de repointage nommé repointing_output contiendra les rapports repointés.

De plus, un dossier dédié contenant les requêtes extraites sera fourni, nommé power_bi_sql_queries. Ce dossier sert un objectif crucial : permettre une double vérification approfondie de toutes les instructions SQL intégrées. Ces instructions SQL auront été soigneusement extraites des connecteurs applicables au sein de l’environnement Power BI.

Output/
├── repointing_output/
│   ├── report1.pbit
│   ├── report2.pbit
│   └── reportN.pbit
└── power_bi_sql_queries/
    ├── query1.sql
    ├── query2.sql
    └── queryN.sql

Copy

D’autre part, le dossier d’entrée contiendra toujours les fichiers SQL non migrés provenant de chaque connecteur. Si nécessaire, examinez ces derniers.

 Input/
└── power_bi_sql_queries/
    ├── query1.sql
    ├── query2.sql
    └── queryN.sql

Copy

Capacités d’assistance¶

La version actuelle prend en charge :¶

Repointage des tables, des vues et des requêtes SQL intégrées.
Gestion des étapes logiques restantes après les étapes de connexion dans le langage M (plusieurs lignes).
Fourniture des paramètres dans Power BI pour traiter correctement les informations relatives au lien vers le serveur Snowflake, à l’entrepôt et au nom de la base de données.
Conversion des requêtes enregistrées sous forme d’expressions (lorsque la propriété « Activer le chargement » a été désactivée).
Renommage des colonnes en fonction des DDLs associées lors de la migration ou des références du rapport Power BI si les DDLs ne sont pas fournies.
Identification des vues, si les DDLs associées sont fournies lors de la migration.
Repointage de plusieurs bases de données et schémas, si ces éléments utilisent le connecteur de plateforme sélectionné dans SnowConvert AI.

Considérations¶

Le nom du schéma des connexions sources est utilisé comme schéma dans la connexion repointée. Les objets de la base de données Snowflake sont supposés avoir été créés sous le même schéma.
Les objets de la base de données doivent être déployés dans Snowflake avant d’essayer d’ouvrir le rapport repointé.
Si l’étape de renommage des colonnes dans le langage M est vide, cela signifie qu’aucune information n’a été trouvée dans le contexte de migration ou dans les références du projet Power BI pour la créer.
Les fonctions et procédures ne sont pas prises en charge dans les connecteurs autres que SQL Server et Azure Synapse. Ces cas ne sont donc pas pris en charge.
Toutes les connexions de base de données trouvées liées au langage source dans les paramètres de migration seront repointées, et les paramètres seront ajoutés.
Notez que les autres connexions provenant d’autres sources que celles sélectionnées dans les paramètres de migration ne sont pas modifiées.

Rapports de migration¶

Le ETLAndBiRepointing contient des informations sur le processus de repointage. Certains connecteurs ne sont pas applicables pour le repointage, comme les fichiers CSV, les fichiers JSON et les connexions SharePoint. Il est peu probable que ces connecteurs non applicables soient modifiés, mais il est recommandé de procéder à une vérification approfondie. Voilà à quoi cela ressemble :

![](../../../../images/migrations/sc-assets/Power_BI_Repointing/PBIReportSample.png « Exemple de rapport de repointage Power BI »)

Résolution des problèmes¶

Si l’utilisateur ne saisit pas les paramètres globaux requis après le repointage, le chargement des objets n’est pas déclenché par Power BI. Par conséquent, assurez-vous que les informations relatives aux paramètres sont ajoutées. If
Si l’utilisateur clique sur Annuler et que les rapports ne chargent pas, il est recommandé de fermer et de rouvrir le rapport.
Si une visualisation ne charge pas, il se peut qu‘une définition de colonne ne corresponde pas à la casse du texte. Notez que le connecteur Snowflake de Power BI récupère toujours les entités et les colonnes en majuscules.
Si vous rencontrez des problèmes avec le cache des identifiants de connexion, vous pouvez accéder aux paramètres dans Power BI et effacez la connexion pour saisir de nouveaux identifiants de connexion.
Il peut y avoir des problèmes avec les requêtes SQL complexes après la migration. Ces cas peuvent nécessiter une intervention supplémentaire pour résoudre les messages d’avertissement émis lors du processus de migration (EWI - PRF - FDM).

Limitations¶

SQL dynamique intégré dans les connecteurs.
Le renommage des colonnes est crucial pour le chargement de la visualisation. La précision de ce renommage n’est pas garantie en raison de limitations dans les informations traitées. Si aucune colonne n’est trouvée lors du repointage, la méthode par défaut consiste à renommer les colonnes selon une sensibilité à la casse prédéfinie. Les valeurs par défaut sont en majuscules, car le connecteur Snowflake natif récupère toutes les informations en majuscules.