Pour exporter et importer des données dans Microsoft Power BI® et gérer les différents objets qui composent votre déploiement Power BI dans le cadre d'une chaîne, ajoutez une étape qui inclut une commande de connexion à Microsoft Power BI.
Pour activer ces commandes, un administrateur informatique commence par créer un connecteur Power BI.
Note : Le connecteur ne peut pas se connecter à Power BI avec l'authentification multi-facteurs (MFA) activée.
Ajouter des lignes au jeu de données
Pour ajouter de nouvelles lignes de données à une table dans le jeu de données d'un espace de travail, utilisez la commande Add rows to dataset.
Note : Cette commande considère les lignes dupliquées comme ajoutées même si elles sont ignorées dans Power BI.
Propriétés
Propriétés |
Détail |
ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
ID du jeu de données |
Saisissez l'ID du jeu de données. |
Nom du tableau |
Saisissez le nom du tableau auquel ajouter des lignes. |
Données |
Saisissez le fichier qui contient les données à ajouter au tableau. |
Type de données |
Sélectionnez si les données de sont au format JSON ou CSV. |
Séparateur |
Si le type de données est CSV, entrez le délimiteur utilisé dans le fichier. |
Sorties
Sortie |
Type de sortie |
Lignes ajoutées |
Entier |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite pendant l'exécution |
2 |
Erreur |
Une erreur s'est produite lors de l'authentification avec Power BI |
Lier le jeu de données à la passerelle
Pour lier un jeu de données d'un espace de travail à une passerelle, utilisez la commande Bind dataset to gateway. Pris en charge uniquement à partir de la passerelle de données sur site.
Propriétés
Propriétés |
Détail |
ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
ID du jeu de données |
Saisissez l'ID du jeu de données. |
Passerelle |
Saisissez l'ID de la passerelle. |
Sorties
Aucun
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite pendant l'exécution |
2 |
Erreur |
Une erreur s'est produite lors de l'authentification avec Power BI |
Rapport sur les clones
Pour cloner un rapport à partir d'un espace de travail, utilisez la commande Clone report.
Propriétés
Propriétés |
Détail |
ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
ID du rapport |
Saisissez l'ID du rapport. |
Nom |
Entrez le nom du nouveau rapport créé. |
ID du jeu de données cible |
Saisissez l'ID du jeu de données pour le nouveau rapport. Pour associer le nouveau rapport au même jeu de données que Report ID, ne rien indiquer. |
ID de l'espace de travail cible |
Saisissez l'ID de l'espace de travail pour le nouveau rapport. Pour "Mon espace de travail", entrez un GUID vide de 00000000-0000-0000-0000-0000000000 . Pour associer le nouveau rapport au même espace de travail que ID de l'espace de travail, laissez un espace vide. |
Sorties
Sortie |
Type de sortie |
Rapport |
JSON |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite pendant l'exécution |
2 |
Erreur |
Une erreur s'est produite lors de l'authentification avec Power BI |
Créer un jeu de données
Pour créer un nouveau jeu de données dans un espace de travail, utilisez la commande Create dataset.
Propriétés
Propriétés |
Détail |
ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
Nom |
Saisissez le nom du jeu de données. |
Tableaux |
Saisissez les tableaux du jeu de données. |
Sorties
Sortie |
Type de sortie |
Jeu de données |
JSON |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite pendant l'exécution |
2 |
Erreur |
Une erreur s'est produite lors de l'authentification avec Power BI |
Créer un emplacement de chargement temporaire
Pour créer un espace de stockage temporaire, par exemple pour importer des fichiers .PBIX de 1 Go à 10 Go, utilisez la commande Create temporary upload location.
Pour importer des fichiers .PBIX volumineux, créez un emplacement de chargement temporaire, chargez le fichier .PBIX à l'aide de l'URL de la signature d'accès partagée (SAS) de la réponse, puis appelez Post Import to Group et spécifiez le fichier
comme étant l'URL SAS dans le corps du demandeur.
Note : Importer des fichiers .PBIX volumineux n'est disponible que pour les espaces de travail de capacité supérieure et pour les fichiers .PBIX dont la taille est comprise entre 1 Go et 10 Go.
Propriétés
Propriétés |
Détail |
ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
Sorties
Sortie |
Type de sortie |
URL |
Chaîne |
Expire le |
Date |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite pendant l'exécution |
2 |
Erreur |
Une erreur s'est produite lors de l'authentification avec Power BI |
Supprimez toutes les lignes du tableau
Pour supprimer toutes les lignes d'un tableau dans le jeu de données d'un espace de travail, utilisez la commande Delete all rows in table.
Propriétés
Propriétés |
Détail |
ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
ID du jeu de données |
Saisissez l'ID du jeu de données. |
Nom du tableau |
Saisissez le nom du tableau dont les lignes doivent être supprimées. |
Sorties
Aucun
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite pendant l'exécution |
2 |
Erreur |
Une erreur s'est produite lors de l'authentification avec Power BI |
Supprimez le jeu de données
Pour supprimer un jeu de données d'un espace de travail, utilisez la commande Delete dataset.
Propriétés
Propriétés |
Détail |
ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
ID du jeu de données |
Saisissez l'ID du jeu de données. |
Sorties
Sortie |
Type de sortie |
Jeu de données |
Chaîne |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite pendant l'exécution |
2 |
Erreur |
Une erreur s'est produite lors de l'authentification avec Power BI |
Supprimer le rapport
Pour supprimer un rapport d'un espace de travail, utilisez la commande Supprimer le rapport.
Propriétés
Propriétés |
Détail |
ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
ID du rapport |
Saisissez l'ID du rapport. |
Sorties
Sortie |
Type de sortie |
ID du rapport supprimé |
Chaîne |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite pendant l'exécution |
2 |
Erreur |
Une erreur s'est produite lors de l'authentification avec Power BI |
Rapport d'exportation
Pour exporter un rapport d'un espace de travail vers un fichier .PBIX, utilisez la commande Export report.
Propriétés
Propriétés |
Détail |
ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
ID du rapport |
Saisissez l'ID du rapport. |
Sorties
Sortie |
Type de sortie |
Exportation de rapports (.PBIX) |
Fichier |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite pendant l'exécution |
2 |
Erreur |
Une erreur s'est produite lors de l'authentification avec Power BI |
Obtenir le jeu de données
Pour récupérer un jeu de données d'un espace de travail, utilisez la commande Get dataset.
Propriétés
Propriétés |
Détail |
ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
ID du jeu de données |
Saisissez l'ID du jeu de données. |
Sorties
Sortie |
Type de sortie |
Jeu de données |
JSON |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite pendant l'exécution |
2 |
Erreur |
Une erreur s'est produite lors de l'authentification avec Power BI |
Obtenir le jeu de données datasources
Pour obtenir une liste des sources de données pour le jeu de données d'un espace de travail, utilisez la commande Get dataset datasources.
Propriétés
Propriétés |
Détail |
ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
ID du jeu de données |
Saisissez l'ID du jeu de données. |
Sorties
Sortie |
Type de sortie |
Sources de données |
JSON |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite pendant l'exécution |
2 |
Erreur |
Une erreur s'est produite lors de l'authentification avec Power BI |
Obtenir les tableaux du jeu de données
Pour obtenir la liste des tableaux contenus dans le jeu de données d'un espace de travail, utilisez la commande Get dataset tables.
Note : Cette commande ne prend en charge que les jeux de données Push.
Propriétés
Propriétés |
Détail |
ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
ID du jeu de données |
Saisissez l'ID du jeu de données. |
Sorties
Sortie |
Type de sortie |
Tableaux |
JSON |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite pendant l'exécution |
2 |
Erreur |
Une erreur s'est produite lors de l'authentification avec Power BI |
Obtenir le rapport
Pour récupérer un rapport à partir d'un espace de travail, utilisez la commande Get report.
Propriétés
Propriétés |
Détail |
ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
ID du rapport |
Saisissez l'ID du rapport. |
Sorties
Sortie |
Type de sortie |
Rapport |
JSON |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite pendant l'exécution |
2 |
Erreur |
Une erreur s'est produite lors de l'authentification avec Power BI |
Importer un fichier
Pour créer un nouveau contenu sur un espace de travail à partir d'un fichier .PBIX, utilisez la commande Import file.
Propriétés
Propriétés |
Détail |
ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
Nom du jeu de données |
Saisissez le nom d'affichage des données, en incluant leur extension de fichier. |
Sur le conflit de noms |
Sélectionnez ce qu'il faut faire si un jeu de données portant le même nom existe déjà. Par défaut, ignore . |
Fichier .PBIX |
Lors de l'importation d'un fichier .PBIX, saisissez le fichier à importer. Le fichier doit être inférieur à 1 Go. |
Importer des informations |
Si vous importez un fichier .PBIX volumineux, entrez ses coordonnées. |
Exécuter de manière asynchrone |
Pour ne pas attendre la fin de l'importation, cochez cette case. |
Sorties
Sortie |
Type de sortie |
Importer |
JSON |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite pendant l'exécution |
2 |
Erreur |
Une erreur s'est produite lors de l'authentification avec Power BI |
Liste des tableaux de bord
Pour dresser la liste des tableaux de bord qui existent dans un espace de travail et auxquels l'utilisateur peut accéder, utilisez la commande List dashboards.
Propriétés
Propriétés |
Détail |
ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
Sorties
Sortie |
Type de sortie |
Tableaux de bord |
JSON |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite pendant l'exécution |
2 |
Erreur |
Une erreur s'est produite lors de l'authentification avec Power BI |
Lister les jeux de données
Pour dresser la liste des jeux de données qui existent dans un espace de travail et auxquels l'utilisateur peut accéder, utilisez la commande List datasets.
Propriétés
Propriétés |
Détail |
ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
Sorties
Sortie |
Type de sortie |
Jeux de données |
JSON |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite pendant l'exécution |
2 |
Erreur |
Une erreur s'est produite lors de l'authentification avec Power BI |
Liste des sources de données de la passerelle
Pour dresser la liste des sources de données d'une passerelle, utilisez la commande List gateway datasources.
Propriétés
Propriétés |
Détail |
ID de la passerelle |
Saisissez l'ID de la passerelle. |
Sorties
Sortie |
Type de sortie |
Sources de données |
JSON |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite pendant l'exécution |
2 |
Erreur |
Une erreur s'est produite lors de l'authentification avec Power BI |
Liste des passerelles
Pour dresser la liste des passerelles dont l'utilisateur est l'admin, utilisez la commande List gateways.
Propriétés
Aucun
Sorties
Sortie |
Type de sortie |
Passerelles |
JSON |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite pendant l'exécution |
2 |
Erreur |
Une erreur s'est produite lors de l'authentification avec Power BI |
Lister les rapports
Pour dresser la liste des rapports d'un espace de travail, utilisez la commande List reports.
Propriétés
Propriétés |
Détail |
ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
Sorties
Sortie |
Type de sortie |
Rapports |
JSON |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite pendant l'exécution |
2 |
Erreur |
Une erreur s'est produite lors de l'authentification avec Power BI |
Rattachement des rapports au jeu de données
Pour lier à nouveau un rapport d'un espace de travail à un jeu de données, utilisez la commande Rebind reports to dataset.
Propriétés
Propriétés |
Détail |
ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
ID du rapport |
Saisissez l'ID du rapport. |
ID du jeu de données |
Saisissez l'ID du nouveau jeu de données pour le rapport de rebond. |
Sorties
Sortie |
Type de sortie |
ID du rapport |
Chaîne |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite pendant l'exécution |
2 |
Erreur |
Une erreur s'est produite lors de l'authentification avec Power BI |
Actualiser le jeu de données
Pour actualiser le jeu de données d'un espace de travail, utilisez la commande Refresh dataset.
Propriétés
Propriétés |
Détail |
ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
ID du jeu de données |
Saisissez l'ID du jeu de données. |
Type de notification |
Sélectionnez le type de notification à envoyer lorsque l'actualisation est terminée. |
Sorties
Aucun
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite pendant l'exécution |
2 |
Erreur |
Une erreur s'est produite lors de l'authentification avec Power BI |
Mise à jour du contenu du rapport
Pour mettre à jour un rapport d'un espace de travail afin qu'il ait le même contenu qu'un autre rapport, utilisez la commande Update report content.
Propriétés
Propriétés |
Détail |
ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
ID du rapport |
Saisissez l'ID du rapport. |
ID du rapport source |
Saisissez l'ID du rapport source. |
ID de l'espace de travail source |
Saisissez l'ID de l'espace de travail contenant le rapport source. |
Sorties
Sortie |
Type de sortie |
Rapport |
JSON |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite pendant l'exécution |
2 |
Erreur |
Une erreur s'est produite lors de l'authentification avec Power BI |