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 doit d'abord créer un connecteur Power BI.
Remarque : Le connecteur ne peut pas se connecter à Power BI lorsque l'authentification multifactorielle (MFA) est activée.
Ajouter des lignes à l'ensemble de données
Pour ajouter de nouvelles lignes de données à un tableau dans l'ensemble 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é |
Détail |
| ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
| ID de l'ensemble de données |
Saisissez l'ID de l'ensemble 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 |
Choisissez si les données de sont JSON ou CSV. |
| Séparateur |
Si le type de données est CSV, indiquez le délimiteur utilisé dans le fichier. |
Sorties
| Sortie |
Type de sortie |
| Lignes ajoutées |
Entier |
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Réussite |
| 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 par la passerelle de données sur site.
Propriétés
| Propriété |
Détail |
| ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
| ID de l'ensemble de données |
Saisissez l'ID de l'ensemble de données. |
| Passerelle |
Saisissez l'ID de la passerelle. |
Sorties
Aucune
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Réussite |
| 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é |
Détail |
| ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
| ID de rapport |
Saisissez l'ID du rapport. |
| Nom |
Saisissez le nom du nouveau rapport créé. |
| ID de l'ensemble de données cible |
Saisissez l'ID de l'ensemble de données pour le nouveau rapport. Pour associer le nouveau rapport au même ensemble 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 Workspace ID, laissez un espace vide. |
Sorties
| Sortie |
Type de sortie |
| Rapport |
JSON |
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Réussite |
| 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é |
Détail |
| ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
| Nom |
Saisissez le nom de l'ensemble de données. |
| Tableaux |
Saisissez les tableaux de l'ensemble de données. |
Sorties
| Sortie |
Type de sortie |
| Jeu de données |
JSON |
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Réussite |
| 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 temporaire pour le téléchargement
Pour créer un espace de stockage temporaire, par exemple pour importer des fichiers .PBIX de 1 à 10 Go, utilisez la commande Create temporary upload location.
Pour importer des fichiers .PBIX volumineux, créez un emplacement de téléchargement temporaire, téléchargez le fichier .PBIX à l'aide de l'URL de signature d'accès partagé (SAS) de la réponse, puis appelez Post Import to Group et spécifiez l'adresse fileUrl comme étant l'URL SAS dans le corps de la requête.
Remarque : L'importation de fichiers .PBIX volumineux n'est disponible que pour les espaces de travail de capacité supérieure et pour les fichiers .PBIX d'une taille comprise entre 1 Go et 10 Go.
Propriétés
| Propriété |
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 |
Réussite |
Réussite |
| 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 toutes les lignes du tableau
Pour supprimer toutes les lignes d'une table dans l'ensemble de données d'un espace de travail, utilisez la commande Delete all rows in table.
Propriétés
| Propriété |
Détail |
| ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
| ID de l'ensemble de données |
Saisissez l'ID de l'ensemble de données. |
| Nom du tableau |
Saisissez le nom de la table dont vous souhaitez supprimer des lignes. |
Sorties
Aucun
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Réussite |
| 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 l'ensemble 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é |
Détail |
| ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
| ID de l'ensemble de données |
Saisissez l'ID de l'ensemble de données. |
Sorties
| Sortie |
Type de sortie |
| Jeu de données |
Chaîne |
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Réussite |
| 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 Delete report.
Propriétés
| Propriété |
Détail |
| ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
| ID de 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 |
Réussite |
Réussite |
| 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é |
Détail |
| ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
| ID de rapport |
Saisissez l'ID du rapport. |
Sorties
| Sortie |
Type de sortie |
| Exportation de rapports (.PBIX) |
Fichier |
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Réussite |
| 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 extraire un jeu de données d'un espace de travail, utilisez la commande Get dataset.
Propriétés
| Propriété |
Détail |
| ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
| ID de l'ensemble de données |
Saisissez l'ID de l'ensemble de données. |
Sorties
| Sortie |
Type de sortie |
| Jeu de données |
JSON |
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Réussite |
| 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 la liste des sources de données d'un ensemble de données d'un espace de travail, utilisez la commande Get dataset datasources.
Propriétés
| Propriété |
Détail |
| ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
| ID de l'ensemble de données |
Saisissez l'ID de l'ensemble de données. |
Sorties
| Sortie |
Type de sortie |
| Sources de données |
JSON |
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Réussite |
| 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 tables de l'ensemble de données d'un espace de travail, utilisez la commande Get dataset tables.
Note : Cette commande ne prend en charge que les ensembles de données Push.
Propriétés
| Propriété |
Détail |
| ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
| ID de l'ensemble de données |
Saisissez l'ID de l'ensemble de données. |
Sorties
| Sortie |
Type de sortie |
| Tableaux |
JSON |
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Réussite |
| 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é |
Détail |
| ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
| ID de rapport |
Saisissez l'ID du rapport. |
Sorties
| Sortie |
Type de sortie |
| Rapport |
JSON |
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Réussite |
| 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é |
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, y compris l'extension du 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, entrez le fichier à importer. Le fichier doit être inférieur à 1GB. |
| Importer des informations |
Si vous importez un fichier .PBIX volumineux, entrez ses détails. |
| Exécution 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 |
Réussite |
Réussite |
| 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é |
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 |
Réussite |
Réussite |
| 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 ensembles de données
Pour dresser la liste des ensembles 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é |
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 |
Réussite |
Réussite |
| 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 répertorier les sources de données d'une passerelle, utilisez la commande List gateway datasources.
Propriétés
| Propriété |
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 |
Réussite |
Réussite |
| 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 répertorier la passerelle dont l'utilisateur est administrateur, utilisez la commande List gateways.
Propriétés
Aucune
Sorties
| Sortie |
Type de sortie |
| Passerelles |
JSON |
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Réussite |
| 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 rapports
Pour dresser la liste des rapports d'un espace de travail, utilisez la commande List reports.
Propriétés
| Propriété |
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 |
Réussite |
Réussite |
| 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 à l'ensemble de données
Pour relier un rapport d'un espace de travail à un ensemble de données, utilisez la commande Rebind reports to dataset.
Propriétés
| Propriété |
Détail |
| ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
| ID de rapport |
Saisissez l'ID du rapport. |
| ID de l'ensemble de données |
Saisissez l'ID du nouvel ensemble de données pour le rapport de rebond. |
Sorties
| Sortie |
Type de sortie |
| ID de rapport |
Chaîne |
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Réussite |
| 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 l'ensemble de données d'un espace de travail, utilisez la commande Refresh dataset.
Propriétés
| Propriété |
Détail |
| ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
| ID de l'ensemble de données |
Saisissez l'ID de l'ensemble 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 |
Réussite |
Réussite |
| 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é |
Détail |
| ID de l'espace de travail |
Saisissez l'ID de l'espace de travail. |
| ID de rapport |
Saisissez l'ID du rapport. |
| ID du rapport source |
Saisir 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 |
Réussite |
Réussite |
| 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 |