Exécuter des scripts Python dans Power BI Desktop

11/11/2019 • 7 minutes to read • Edit Online

Vous pouvez exécuter des scripts Python directement dans Power BI Desktop et importer les jeux de données
obtenus dans un modèle de données Power BI Desktop.

Installer Python
Pour exécuter des scripts Python dans Power BI Desktop, vous devez installer Python sur votre ordinateur local.
Vous pouvez télécharger Python à partir de la page de téléchargement officielle de Python. La version actuelle
des scripts Python prend en charge les espaces et les caractères Unicode dans le chemin d’installation.
Installer les packages Python nécessaires
L’intégration de Python dans Power BI nécessite l’installation de deux packages Python :
Pandas : bibliothèque logicielle pour la manipulation et l’analyse des données. Ce package offre des structures
de données et des opérations pour la manipulation de tables numériques et de séries chronologiques. Vos
données importées doivent se trouver dans une trame de données Pandas. Une trame de données est une
structure de données à deux dimensions. Par exemple, les données sont alignées de manière tabulaire dans des
lignes et des colonnes.
Matplotlib : bibliothèque de traçage pour Python et son extension mathématique numérique NumPy. Ce
package fournit une API orientée objet pour incorporer des tracés dans des applications à l’aide d’outils
d’interface utilisateur graphique à usage général (comme Tkinter, wxPython, Qt ou GTK+).
1. Dans une console ou un interpréteur de commandes, utilisez l’outil en ligne de commandepip pour installer les
deux packages. L’outil pip est empaqueté avec des versions plus récentes de Python.

pip install pandas

pip install matplotlib

Activer les scripts Python

Pour activer les scripts Python :
1. Dans Power BI Desktop, sélectionnez Fichier > Options et paramètres > Options > Création de scripts
Python. La page des options de scripts Python s’affiche.
2. Si nécessaire, spécifiez le chemin local d’installation de Python dans la zone de texte Répertoires de base
Python détectés.
Dans l’image ci-dessus, le chemin local d’installation de Python est C:\Python. Vérifiez que le chemin
correspond à l’installation locale de Python que Power BI Desktop doit utiliser.
3. Sélectionnez OK.
Une fois que vous avez spécifié votre installation de Python, vous êtes prêt à exécuter des scripts Python dans
Power BI Desktop.

Exécuter les scripts Python

En quelques étapes, vous pouvez exécuter des scripts Python et créer un modèle de données. À partir de ce
modèle, vous pouvez créer des rapports et les partager sur le service Power BI.
Préparer un script Python
Tout d’abord, créez un script dans votre environnement de développement Python local et vérifiez qu’il s’exécute
correctement. Par exemple, voici un script Python simple qui importe Pandas et utilise une trame de données :
 import pandas as pd
data = [['Alex',10],['Bob',12],['Clarke',13]]
df = pd.DataFrame(data,columns=['Name','Age'],dtype=float)
print (df)

Une fois exécuté, il s’imprime :

Name Age
0 Alex 10.0
1 Bob 12.0
2 Clarke 13.0

Lors de la préparation et de l’exécution d’un script Python dans Power BI Desktop, vous pouvez être confronté à
quelques limitations :
Seules les trames de données Pandas sont importées, donc vérifiez que les données que vous souhaitez
importer dans Power BI sont représentées dans une trame de données.
Tous les scripts Python exécutés pendant plus de 30 minutes expirent.
Les appels interactifs dans le script Python, comme l’attente d’une entrée utilisateur, arrêtent l’exécution du
script.
Lorsque vous définissez le répertoire de travail dans le script Python, vous devez définir un chemin complet
vers le répertoire de travail au lieu d’un chemin relatif.
Actuellement, les tables imbriquées ne sont pas prises en charge.
Exécuter votre script Python et importer des données
Pour exécuter votre script Python dans Power BI Desktop :
1. Dans le ruban Accueil, sélectionnez Obtenir des données > Autres...
2. Sélectionnez Autre > Script Python, comme l’illustre l’image suivante :
3. Sélectionnez Se connecter. La dernière version de Python installée sur votre ordinateur local est
sélectionnée en tant que moteur Python. Copiez votre script dans la boîte de dialogue Script Python qui
s’affiche. Ici, nous entrons le script Python simple montré précédemment.
4. Sélectionnez OK. Si le script s’exécute correctement, la boîte de dialogue Navigateur s’affiche et vous
pouvez charger les données afin de les utiliser. Pour l’exemple, cochez la casedf, comme l’illustre l’image,
puis sélectionnez Charger.

Résolution des problèmes

Si Python n’est pas installé ou identifié, un avertissement s’affiche.Vous pouvez également voir un avertissement
si vous avez plusieurs installations d’ordinateurs locaux. Consultez les sections précédentes sur l’installation de
Python et l’activation des scripts Python.
Actualiser
Vous pouvez actualiser un script Python dans Power BI Desktop. Pour actualiser, accédez au ruban Accueil, puis
sélectionnez Actualiser. Quand vous actualisez un script Python, Power BI Desktop le réexécute.

Étapes suivantes
Consultez les informations supplémentaires suivantes sur Python dans Power BI.
Créer des visuels Python dans Power BI Desktop
Utiliser un IDE Python externe avec Power BI
 Utilisation de Python dans l’Éditeur de requête
11/11/2019 • 9 minutes to read • Edit Online

Vous pouvez utiliser Python, langage de programmation largement utilisé par les analystes de données, les
scientifiques des données et les statisticiens, dans l’Éditeur de requête Power BI Desktop. Cette intégration de
Python dans l’Éditeur de requête vous permet de procéder au nettoyage des données à l’aide de Python et
d’effectuer une mise en forme et une analytique avancées des données des jeux de données, notamment la saisie
de données manquantes, les prédictions et le clustering pour ne citer que quelques exemples. Python est un
langage puissant qui peut être utilisé dans l’Éditeur de requête pour préparer votre modèle de données et créer
des rapports.

Installation de Python
Pour utiliser Python dans l’Éditeur de requête Power BI Desktop, vous devez installer Python sur votre
ordinateur local. Vous pouvez télécharger et installer Python gratuitement à partir de nombreux emplacements,
notamment de la page de téléchargement officielle de Python et d’Anaconda.

Utilisation de Python dans l’Éditeur de requête

Pour comprendre comment utiliser Python dans l’Éditeur de requête, prenez cet exemple qui provient d’un jeu
de données boursières basé sur un fichier CSV (téléchargeable ici). Les étapes de cet exemple sont les suivantes :
1. Tout d’abord, entrez des données dans Power BI Desktop. Dans cet exemple, chargez le fichier
EuStockMarkets_NA.csv et sélectionnez Obtenir des données > CSV dans le ruban Accueil de Power BI
Desktop.

2. Sélectionnez le fichier et choisissez Ouvrir. Le fichier CSV s’affiche dans la boîte de dialogue Fichier CSV.
3. Une fois que les données sont chargées, elles s’affichent dans le volet Champs de Power BI Desktop.

4. Ouvrez l’Éditeur de requête en sélectionnant Modifier les requêtes dans le ruban Accueil de
Power BI Desktop.
5. Sous l’ongletTransformation, sélectionnez Exécuter un script Python. L’éditeur Exécuter un script
Python apparaît (voir l’étape suivante). Notez que les lignes 15 et 20 ont des données manquantes, comme
les autres lignes qui ne figurent pas dans l’image suivante. Les étapes ci-dessous montrent comment Python
peut compléter ces lignes pour vous.

6. Pour cet exemple, entrez le code de script suivant :

import pandas as pd
completedData = dataset.fillna(method='backfill', inplace=False)
dataset["completedValues"] = completedData["SMI missing values"]

NOTE
La bibliothèque pandas doit être installée dans votre environnement Python pour que le code de script précédent
fonctionne correctement. Pour installer pandas, exécutez la commande suivante dans votre installation de Python : | >
pip install pandas

Lorsqu’il est placé dans la boîte de dialogue Exécuter un script Python, le code ressemble à ce qui suit :
7. Une fois que vous avez sélectionné OK, l’Éditeur de requête affiche un avertissement concernant la
confidentialité des données.

8. Pour que les scripts Python fonctionnent correctement dans le service Power BI, toutes les sources de
données doivent être définies comme étant publiques. Pour plus d’informations sur les paramètres de
confidentialité et leurs implications, consultez Niveaux de confidentialité.
 Le volet Champs comporte une nouvelle colonne appelée completedValues. Il existe quelques éléments de
données manquants, par exemple sur les lignes 15 et 18. La section suivante explique de quelle façon
Python gère ce problème.
Avec seulement cinq lignes de script Python, l’Éditeur de requête a renseigné les valeurs manquantes à l’aide
d’un modèle prédictif.

Création de visuels à partir des données de script Python

Maintenant, nous pouvons créer un visuel pour voir comment le script Python a complété les valeurs manquantes
à l’aide de la bibliothèque pandas, comme illustré dans l’image suivante :

Quand vous avez terminé ce visuel et tout autre visuel que vous souhaitiez créer à l’aide de Power BI Desktop,
vous pouvez enregistrer le fichier Power BI Desktop (au format .pbix), puis utiliser le modèle de données,
notamment les scripts Python associés, dans le service Power BI.

NOTE
Vous voulez voir un fichier .pbix complété une fois les étapes ci-dessus terminées ? Vous pouvez télécharger le fichier
Power BI Desktop complet utilisé dans ces exemples ici.

Une fois que vous avez téléchargé le fichier .pbix dans le service Power BI, quelques étapes supplémentaires sont
nécessaires pour activer l’actualisation des données (dans le service) et pour mettre à jour les visuels dans le
service (pour cela, les données doivent accéder à Python). Les étapes supplémentaires sont les suivantes :
Activer l’actualisation planifiée pour le jeu de données : pour activer l’actualisation planifiée pour le
 classeur qui contient votre jeu de données avec des scripts Python, consultez Configuration d’une actualisation
planifiée, qui contient également des informations sur Personal Gateway.
Installer Personal Gateway : vous devez installer Personal Gateway sur l’ordinateur où se trouvent le fichier
et Python. Le service Power BI doit accéder à ce classeur et restituer de nouveau les visuels mis à jour. Vous
pouvez obtenir plus d’informations sur l’installation et la configuration de Personal Gateway.

Limites
Il existe certaines limitations pour les requêtes qui contiennent des scripts Python créés dans l’Éditeur de
requête :
Tous les paramètres de source de données Python doivent être définis comme étant publics et toutes les
autres étapes d’une requête créée dans l’Éditeur de requête doivent également être publiques. Pour
accéder aux paramètres de la source de données, dans Power BI Desktop, sélectionnez Fichier > Options
et paramètres > Paramètres de la source de données.

Dans la boîte de dialogue Paramètres de la source de données, sélectionnez la ou les sources de données,
puis sélectionnez Modifier les autorisations... et vérifiez que le niveau de confidentialité est défini sur
Public.
 Pour activer l’actualisation planifiée de votre jeu de données ou de vos visuels Python, vous devez activer
l’actualisation planifiée et installer Personal Gateway sur l’ordinateur qui héberge le classeur et
l’installation de Python. Pour plus d’informations à ce sujet, consultez les liens indiqués dans la section
précédente de cet article.
Actuellement, les tables imbriquées (table de tables) ne sont pas prises en charge.
Vous pouvez effectuer toutes sortes d’opérations avec Python et les requêtes personnalisées. Par conséquent,
explorez et mettez en forme vos données de la façon dont vous souhaitez qu’elles apparaissent.
 Utiliser un IDE Python externe avec Power BI
11/11/2019 • 8 minutes to read • Edit Online

Avec Power BI Desktop, vous pouvez utiliser un IDE (environnement de développement intégré) Python externe
pour créer et affiner des scripts Python, puis utiliser ces scripts dans Power BI.

Activer un IDE Python externe

Vous pouvez lancer votre IDE Python externe à partir de Power BI Desktop et importer et afficher vos données
automatiquement dans l’IDE Python. À partir de là, vous pouvez modifier le script dans cet IDE Python externe,
puis le coller dans Power BI Desktop pour créer des rapports et des visuels Power BI.
Vous pouvez spécifier les IDE Python que vous souhaitez utiliser et les lancer automatiquement à partir de Power
BI Desktop.
Configuration requise
Pour utiliser cette fonctionnalité, vous devez installer un IDE Python sur votre ordinateur local.
Power BI Desktop ne contient pas, ne déploie pas ni n’installe le moteur Python. Vous devez donc installer
Python séparément sur votre ordinateur local. Vous pouvez choisir l’IDE Python à utiliser avec les options
suivantes :
Vous pouvez installer votre IDE Python favori, nombre d’entre eux sont gratuits, à partir de la page de
téléchargement Visual Studio Code.
 Power BI Desktop prend également en charge Visual Studio.
Vous pouvez également installer un autre IDE Python et configurer Power BI Desktop pour lancer cet IDE
Python en effectuant l’une des opérations suivantes :
Vous pouvez associer des fichiers .PY à l’IDE externe que vous souhaitez lancer à l’aide de
Power BI Desktop.
Vous pouvez spécifier l’exécutable quePower BI Desktop doit lancer en sélectionnant Autres à
partir de la section Options de script Python de la boîte de dialogue Options. Pour ouvrir la boîte
de dialogue Options, accédez à Fichier > Options et paramètres > Options.

Si vous avez plusieurs IDE Python installés, vous pouvez spécifier lequel lancer en le sélectionnant dans la liste
déroulante IDE Python détectés de la boîte de dialogue Options.
Par défaut, Power BI Desktop lance Visual Studio Code en tant qu’IDE Python externe s’il est installé sur votre
ordinateur local ; si Visual Studio Code n’est pas installé et que vous avez Visual Studio, ce dernier est lancé à la
place. Si aucun de ces IDE Python n’est installé, l’application associée aux fichiers.PY est lancée.
Si aucune association au fichier .PY n’existe, il est possible de spécifier un chemin à un IDE personnalisé dans la
section Accédez à votre IDE Python préféré de la boîte de dialogue Options. Vous pouvez également lancer un
autre IDE Python en sélectionnant l’icône en forme d’engrenage Paramètres à côté de l’icône représentant une
flèche Lancer un IDE Python dans Power BI Desktop.

Lancer un IDE Python à partir de Power BI Desktop

Pour lancer un IDE Python à partir de Power BI Desktop, effectuez les étapes suivantes :
1. Chargez des données dans Power BI Desktop.
2. Sélectionnez quelques champs que vous souhaitez utiliser dans le volet Champs. Si vous n’avez pas encore
activé les éléments visuels de script, vous êtes invité à le faire.

3. Lorsque les visuels de script sont activés, vous pouvez sélectionner un visuel Python à partir du volet
Visualisations, qui crée un visuel Python vide prêt à afficher les résultats de votre script. Le volet Éditeur
de script Python s’affiche également.

4. Vous pouvez maintenant sélectionner les champs que vous souhaitez utiliser dans votre script Python.
Lorsque vous sélectionnez un champ, le champ Éditeur de script Python crée automatiquement un code
de script basé sur le ou les champs que vous sélectionnez. Vous pouvez créer (ou coller) votre script Python
directement dans le volet Éditeur de script Python, ou le laisser vide.
 NOTE
Le type d’agrégation par défaut pour les visuels Python est Ne pas synthétiser.

5. Vous pouvez maintenant lancer votre IDE Python directement à partir de Power BI Desktop. Sélectionnez
le bouton Lancer l’IDE Python qui se trouve à droite de la barre de titre Éditeur de script Python,
comme indiqué ci-dessous.

6. L’IDE Python spécifié est lancé par Power BI Desktop, comme illustré dans l’image suivante (où Visual
Studio Code est l’IDE Python par défaut).
 NOTE
Power BI Desktop ajoute les trois premières lignes du script afin qu’il puisse importer vos données à partir de
Power BI Desktop une fois que vous exécutez le script.

7. Les scripts que vous avez créés dans le volet Éditeur de script Python de Power BI Desktop
apparaissent à partir de la ligne 4 de votre IDE Python. À ce stade, vous pouvez créer votre script Python
dans l’IDE Python. Une fois que votre script Python est terminé dans votre IDE Python, vous devez le copier
et le coller dans le volet Éditeur de script Python de Power BI Desktop, à l’exclusion des trois premières
lignes du script générées automatiquement par Power BI Desktop. Ne recopiez pas les trois premières
lignes du script dans Power BI Desktop, car elles ont été utilisées uniquement pour importer vos données
dans votre IDE Python à partir de Power BI Desktop.
Limites connues
Le lancement de l’IDE Python directement à partir de Power BI Desktop présente quelques limitations :
L’exportation automatique de votre script de l’IDE Python vers Power BI Desktop n’est pas prise en charge.

Étapes suivantes
Consultez les informations supplémentaires suivantes sur Python dans Power BI.
Exécution de scripts Python dans Power BI Desktop
Créer des visuels Power BI avec Python
 Créer des visuels Power BI avec Python
11/11/2019 • 11 minutes to read • Edit Online

Power BI Desktop vous permet d’utiliser Python pour visualiser vos données.

Conditions préalables
Suivez le tutoriel Exécuter des scripts Python dans Power BI Desktop à l’aide du script Python suivant :

import pandas as pd
df = pd.DataFrame({
'Fname':['Harry','Sally','Paul','Abe','June','Mike','Tom'],
'Age':[21,34,42,18,24,80,22],
'Weight': [180, 130, 200, 140, 176, 142, 210],
'Gender':['M','F','M','M','F','M','M'],
'State':['Washington','Oregon','California','Washington','Nevada','Texas','Nevada'],
'Children':[4,1,2,3,0,2,0],
'Pets':[3,2,2,5,0,1,5]
})
print (df)

L’article Exécuter des scripts Python dans Power BI Desktop vous montre comment installer Python sur votre
ordinateur local et l’activer pour l’écriture de scripts Python dans Power BI Desktop. Ce tutoriel utilise les
données du script ci-dessus pour illustrer la création de visuels Python.

Créer des visuels Python dans Power BI Desktop

1. Sélectionnez l’icône Visuel Python dans le volet Visualisation.

2. Dans la boîte de dialogue Activer les éléments visuels de script qui s’affiche, sélectionnez Activer.
Quand vous ajoutez un visuel Python à un rapport, Power BI Desktop exécutent les actions suivantes :
Une image de visuel Python apparaît sous forme d’espace réservé sur le canevas de rapport.
L’Éditeur de script Python s’affiche en bas du volet central.
3. Ensuite, faites glisser les champs Age (Âge), Children (Enfants), Fname (Prénom), Gender (Sexe), Pets
(Animaux), State (État) et Weight (Poids) dans la section Valeurs où est indiqué « Ajouter des champs de
données ici ».

Votre script Python peut seulement utiliser des champs ajoutés à la section Valeurs. Vous pouvez ajouter
ou supprimer des champs dans la section Valeurs tout en travaillant sur votre script Python. Power BI
Desktop détecte automatiquement les modifications apportées aux champs.

NOTE
Le type d’agrégation par défaut pour les visuels Python est Ne pas synthétiser.

4. Vous pouvez à présent utiliser les données sélectionnées pour créer un tracé.
Quand vous sélectionnez ou supprimez des champs, le code correspondant est automatiquement généré ou
 supprimé dans l’Éditeur de script Python.
Suite à vos sélections, l’Éditeur de script Python génère le code de liaison ci-après.
L’éditeur a créé un dataframe de jeu de données, avec les champs que vous avez ajoutés.
L’agrégation par défaut est Ne pas synthétiser.
À l’instar des visuels de table, les champs sont regroupés et les lignes en double n’apparaissent
qu’une fois.

TIP
Dans certains cas, il peut être dans votre intérêt de ne pas avoir recours au regroupement automatique ou bien
d’afficher toutes les lignes, notamment les doublons. Si c’est le cas, vous pouvez ajouter un champ d’index à votre jeu
de données. De cette façon, toutes les lignes sont considérées comme étant uniques, ce qui empêche le
regroupement.

Vous pouvez accéder aux colonnes du jeu de données par leurs noms respectifs. Par exemple, vous pouvez
coder dataset["Age"] dans votre script Python pour accéder au champ de l’âge.
5. Une fois la trame de données générée automatiquement par les champs que vous avez sélectionnés, vous
pouvez écrire un script Python qui aboutit au traçage sur l’appareil Python par défaut. Une fois le script
terminé, sélectionnez Exécuter dans la barre de titre de l’Éditeur de script Python.
Power BI Desktop retrace le visuel si l’un des événements suivants se produit :
Lorsque vous sélectionnez Exécuter dans la barre de titres Éditeur de script Python
À chaque changement de données dû à l’actualisation des données, au filtrage ou à la mise en
surbrillance
Quand vous exécutez un script Python qui génère une erreur, le visuel Python n’est pas tracé et un message
d’erreur de canevas s’affiche. Pour plus d’informations sur l’erreur, sélectionnezAfficher les détails à partir
du message.
Pour obtenir une plus grande vue des visualisations, vous pouvez réduire l’Éditeur de script Python.
Nous allons à présent créer des visuels.

Créer un nuage de points

Nous allons créer un nuage de points pour voir s’il existe une corrélation entre l’âge et le poids.
1. Sous Collez ou tapez votre code de script ici, entrez ce code :
 import matplotlib.pyplot as plt
dataset.plot(kind='scatter', x='Age', y='Weight', color='red')
plt.show()

Le volet de l’Éditeur de script Python doit maintenant ressembler à ceci :

La bibliothèque matplotlib est importée pour tracer et créer nos visuels.

2. Quand vous sélectionnez le bouton Exécuter le script, le nuage de points suivant est généré dans l’espace
réservé de l’image du visuel Python.

Créer un tracé de ligne avec plusieurs colonnes

Nous allons créer un tracé de ligne pour chaque personne qui indique leur nombre d’enfants et d’animaux.
Supprimez ou commentez le code indiqué sous Collez ou tapez votre code de script ici, puis entrez ce code
Python :

import matplotlib.pyplot as plt

ax = plt.gca()
dataset.plot(kind='line',x='Fname',y='Children',ax=ax)
dataset.plot(kind='line',x='Fname',y='Pets', color='red', ax=ax)
plt.show()

Quand vous sélectionnez le bouton Exécuter le script, le tracé de ligne suivant est généré avec plusieurs colonnes.
Créer un tracé à barres
Créons un tracé à barres pour l’âge de chaque personne. Supprimez ou commentez le code indiqué sous Collez
ou tapez votre code de script ici, puis entrez ce code Python :

import matplotlib.pyplot as plt

dataset.plot(kind='bar',x='Fname',y='Age')
plt.show()

Quand vous sélectionnez le bouton Exécuter le script, le tracé à barres suivant est généré :

Sécurité
 IMPORTANT
Sécurité des scripts Python : Les éléments visuels Python sont créés à partir de scripts Python, qui peuvent contenir du
code qui présente des risques pour la sécurité ou la confidentialité. Quand un utilisateur tente de voir ou d’utiliser un visuel
Python pour la première fois, un message d’avertissement de sécurité lui est présenté. Activez les visuels Python seulement si
vous faites confiance à l’auteur et à la source ou après avoir examiné et compris le script Python.

Informations supplémentaires sur le tracé avec Matprolib, Pandas et

Python
Ce tutoriel est conçu pour vous aider à commencer à créer des visuels avec Python dans Power BI Desktop. Il
aborde rapidement les nombreuses options et fonctionnalités permettant de créer des rapports visuels à l’aide de
Python, Pandas et la bibliothèque Matprolib. De nombreuses informations supplémentaires sont disponibles, ainsi
que des liens pour vous aider à bien démarrer.
Documentation du site web Matplotlib.
Tutoriel Matplotlib : Guide de base pour utiliser Matplotlib avec Python
Tutoriel Matplotlib : Bibliothèque Matplotlib Python avec des exemples
Informations de référence sur l’API Pandas
Visualisations Python dans le service Power BI
Utilisation de visuels Python dans Power BI

Limites connues
Les visuels Python dans Power BI Desktop présentent quelques limitations :
Limites concernant la taille des données : les données utilisées par les visuels Python pour le traçage sont
limitées à 150 000 lignes. Si plus de 150 000 lignes sont sélectionnées, seules les 150 000 premières lignes
sont utilisées et un message s’affiche sur l’image.
Limite concernant la durée du calcul : si le calcul d’un visuel Python prend plus de 5 minutes, le délai
d’exécution est dépassé et une erreur est générée.
Relations : comme avec d’autres éléments visuels Power BI Desktop, si des champs de données issus de
différentes tables avec aucune relation définie entre elles sont sélectionnés, une erreur se produit.
Les visuels Python sont actualisés lors de la mise à jour, du filtrage et de la sélection des données.Toutefois,
l’image elle-même n’est pas interactive et ne peut pas être la source du filtrage croisé.
Les visuels Python répondent à la sélection d’autres visuels, mais vous ne pouvez pas cliquer sur des éléments
dans le visuel Python pour appliquer un filtre croisé à d’autres éléments.
Seuls les tracés représentés sur l’écran Python par défaut s’affichent correctement sur le canevas. Évitez
d’utiliser explicitement un autre écran Python.

Étapes suivantes
Consultez les informations supplémentaires suivantes sur Python dans Power BI.
Exécuter des scripts Python dans Power BI Desktop
Utiliser un IDE Python externe avec Power BI
 Exécuter des scripts R dans Power BI Desktop
11/11/2019 • 6 minutes to read • Edit Online

Vous pouvez exécuter des scripts R directement dans Power BI Desktop et importer les jeux de données obtenus
dans un modèle de données Power BI Desktop.

Installer R
Pour exécuter des scripts R dans Power BI Desktop, vous devez installer R sur votre ordinateur local. Vous pouvez
télécharger et installer R gratuitement à partir de nombreux emplacements, dont les pages Download Revolution
R Open et CRAN Repository. La version actuelle des scripts R dans Power BI Desktop prend en charge les
caractères Unicode ainsi que les espaces (caractères vides) dans le chemin d’installation.

Exécuter des scripts R

Dans Power BI Desktop, quelques étapes suffisent pour exécuter des scripts R et créer un modèle de données à
partir duquel vous pouvez générer des rapports et les partager sur le service Power BI. Les scripts R dans Power
BI Desktop prennent maintenant en charge les formats de nombres qui contiennent des virgules (,) et des points
(.).
Préparer un script R
Pour exécuter un script R dans Power BI Desktop, créez-le dans votre environnement de développement R local,
puis assurez-vous qu’il fonctionne correctement.
Pour exécuter le script dans Power BI Desktop, assurez-vous qu’il s’exécute correctement dans un espace de travail
nouveau et non modifié. Cela signifie que l’ensemble des packages et dépendances doivent être explicitement
chargés et exécutés. Vous pouvez utiliser source() pour exécuter des scripts dépendants.
Lors de la préparation et l’exécution d’un script R dans Power BI Desktop, vous pouvez être confronté à quelques
limitations :
Seules les trames de données sont importées ; assurez-vous donc que les données que vous souhaitez
importer dans Power BI sont représentées dans une trame de données
Les colonnes qui sont de type Complexe et Vecteur ne sont pas importées et sont remplacées par des valeurs
d’erreur dans la table créée
Les valeurs marquées comme non applicables (N/A) sont converties en valeurs NULL dans Power BI Desktop
Tous les scripts exécutés pendant plus de 30 minutes expirent
Les appels interactifs dans le script R, comme l’attente pour l’entrée d’un utilisateur, arrêtent l’exécution du
script
Lorsque vous définissez le répertoire de travail dans le script R, vous devez définir un chemin d’accès complet
vers le répertoire de travail, au lieu d’un chemin d’accès relatif
Exécuter votre script R et importer des données
1. Dans Power BI Desktop, le connecteur de données du script R se trouve dans Obtenir des données. Pour
exécuter votre script R, sélectionnez Obtenir des données > Plus... , puis sélectionnez Autres > Script R,
comme illustré dans l’image suivante :
2. Si R est installé sur votre ordinateur local, la dernière version installée est sélectionnée comme votre
moteur R. Copiez simplement votre script dans la fenêtre de script, puis cliquez sur OK.

3. Si R n’est pas installé, n’est pas identifié ou s’il existe plusieurs installations sur votre ordinateur local,
développez Paramètres d’installation de R pour afficher les options d’installation ou pour sélectionner
l’installation pour laquelle vous souhaitez exécuter le script R.
 Si R est installé mais n’est pas identifié, vous pouvez indiquer explicitement son emplacement dans la zone
de texte fournie lorsque vous développez Paramètres d’installation de R. Dans l’illustration ci-dessus, le
chemin d’accès C:\Program Files\R\R -3.2.0 est explicitement fourni dans la zone de texte.
Les paramètres d’installation de R sont centralisés dans la section des scripts R de la boîte de dialogue
Options. Pour spécifier vos paramètres d’installation de R, sélectionnez Fichier > Options et paramètres,
puis Options > Scripts R. Si plusieurs installations de R sont disponibles, un menu déroulant s’affiche pour
sélectionner l’installation à utiliser.

4. Sélectionnez OK pour exécuter le script R. Lorsque le script s’exécute correctement, vous pouvez choisir les
trames de données obtenues pour les ajouter au modèle Power BI.
Actualisation
Vous pouvez actualiser un script R dans Power BI Desktop. Lorsque vous actualisez un script R, Power BI Desktop
réexécute le script R dans l’environnement de Power BI Desktop.

Étapes suivantes
Consultez les informations supplémentaires suivantes sur R dans Power BI.
Créer des visuels Power BI avec R
Utiliser un IDE R externe avec Power BI
 Utiliser le langage R dans l’Éditeur de requête
11/11/2019 • 8 minutes to read • Edit Online

R est un langage de programmation puissant qui est utilisé par de nombreux statisticiens, scientifiques des
données et analystes de données. Vous pouvez utiliser R dans l’éditeur de requête de Power BI Desktop pour :
Préparer des modèles de données
Créer des rapports
Procéder au nettoyage de données, à la mise en forme avancée de données et à l’analytique de jeux de
données, ce qui inclut la saisie semi-automatique des données, les prédictions, le clustering, et bien plus
encore.

Installer R
Vous pouvez télécharger R gratuitement à partir de la page de téléchargement de Revolution Open et du dépôt
CRAN.
Installer mice
La bibliothèque mice doit être installée dans votre environnement R. Sans mice, l’exemple de code de script ne
fonctionnera pas correctement. Le package mice implémente une méthode pour traiter les données manquantes.
Pour installer mice :
1. Lancez le programme R.exe (par exemple, C:\Program Files\Microsoft\R Open\R -3.5.3\bin\R.exe)
2. Exécutez la commande d’installation :

> install.packages('mice')

Utiliser le langage R dans l’Éditeur de requête

Pour illustrer l’utilisation de R dans l’Éditeur de requête, nous allons utiliser un exemple de jeu de données
boursières contenues dans un fichier .csv et suivre les étapes suivantes :
1. Téléchargez le fichier EuStockMarkets_NA.csv. Notez l’endroit où vous l’enregistrez.
2. Chargez le fichier dans Power BI Desktop : dans le ruban Accueil, sélectionnez Obtenir des données >
Texte/CSV.
3. Sélectionnez le fichier, puis Ouvrir. Les données CSV s’affichent dans la boîte de dialogue
Fichier texte/CSV.

4. Une fois les données chargées, vous pouvez les voir dans le volet Champs.
5. Pour ouvrir l’Éditeur de requête, dans le ruban Accueil, sélectionnez Modifier les requêtes .

6. Dans le ruban Transformer, sélectionnez Exécuter un script R. L’éditeur Exécuter un script R s’affiche.
Les lignes 15 et 20 ont des données manquantes, tout comme d’autres lignes qui ne sont pas visibles dans
l’image. Les étapes ci-dessous montrent comment R complète ces lignes pour vous.
7. Pour cet exemple, entrez le code de script suivant. Veillez à remplacer « <Your File Path> » (Chemin de
votre fichier) par le chemin de EuStockMarkets_NA.csv dans votre système de fichiers local ; par exemple,
C:/Users/John Doe/Documents/Microsoft/EuStockMarkets_NA.csv

dataset <- read.csv(file="<Your File Path>/EuStockMarkets_NA.csv", header=TRUE, sep=",")

library(mice)
tempData <- mice(dataset,m=1,maxit=50,meth='pmm',seed=100)
completedData <- complete(tempData,1)
output <- dataset
output$completedValues <- completedData$"SMI missing values"

NOTE
Vous devrez peut-être remplacer une variable nommée output pour créer correctement le nouveau jeu de données
avec les filtres appliqués.

8. Une fois que vous avez sélectionné OK, l’Éditeur de requête affiche un avertissement concernant la
confidentialité des données.
9. Pour que les scripts R fonctionnent correctement dans le service Power BI, vous devez définir toutes les
sources de données comme étant publiques. Pour plus d’informations sur les paramètres de confidentialité
et leurs implications, consultez Niveaux de confidentialité.

Une fois que vous avez sélectionné Enregistrer, le script s’exécute. Le volet Champs comporte une
nouvelle colonne appelée completedValues. Il existe quelques éléments de données manquants, par
exemple sur les lignes 15 et 18. La section suivante explique de quelle façon R gère ce problème.
Avec seulement cinq lignes de script R, l’Éditeur de requête a renseigné les valeurs manquantes à l’aide
d’un modèle de prévision.

Créer des visuels à partir des données de script R

Maintenant, nous pouvons créer un visuel pour voir comment le script R a complété les valeurs manquantes à
l’aide de la bibliothèque mice, comme illustré dans l’image suivante :
Vous pouvez enregistrer tous les visuels terminés dans un fichier .pbix Power BI Desktop, et utiliser le modèle de
données et ses scripts R dans le service Power BI.

NOTE
Vous pouvez télécharger un fichier .pbix une fois toutes ces étapes terminées.

Une fois que vous avez téléchargé le fichier .pbix vers le service Power BI, vous devez effectuer des étapes
supplémentaires pour activer l’actualisation des données du service et les visuels mis à jour :
Activer l’actualisation planifiée pour le jeu de données : pour activer l’actualisation planifiée pour le
classeur contenant votre jeu de données avec des scripts R, consultez Configuration d’une actualisation
planifiée, qui inclut également des informations sur la passerelle personnelle.
Installer la passerelle personnelle : une passerelle personnelle doit être installée sur l’ordinateur où se
trouvent le fichier et R. Le service Power BI accède à ce classeur et restitue de nouveau tous les visuels mis à
jour. Pour plus d’informations, consultez Installer et configurer la passerelle personnelle.

Limites
Il existe certaines limitations pour les requêtes qui incluent des scripts R créés dans l’Éditeur de requête :
Tous les paramètres de source de données R doivent être définis comme étant publics. Toutes les autres
étapes d’une requête de l’Éditeur de requête doivent également être publiques. Pour accéder aux
paramètres de la source de données, dans Power BI Desktop, sélectionnez Fichier > Options et
paramètres > Paramètres de la source de données.
Dans la boîte de dialogue Paramètres de la source de données, sélectionnez la ou les sources de
données, puis Modifier les autorisations... . Définissez le Niveau de confidentialité sur Public.

Pour activer l’actualisation planifiée de vos visuels R ou d’un jeu de données, vous devez activer
l’Actualisation planifiée et avoir une Passerelle personnelle installée sur l’ordinateur contenant le
classeur et R. Pour plus d’informations à ce sujet, consultez les liens indiqués dans la section précédente de
cet article.
Il existe toutes sortes d’opérations que vous pouvez faire avec R et les requêtes personnalisées. Par conséquent,
explorez et mettez en forme vos données de la façon dont vous souhaitez qu’elles apparaissent.

Étapes suivantes
Présentation de R
Exécuter des scripts R dans Power BI Desktop
Utiliser un IDE R externe avec Power BI
Packages R du service Power BI
 Utiliser un IDE R externe avec Power BI
11/11/2019 • 8 minutes to read • Edit Online

Avec Power BI Desktop, vous pouvez utiliser un IDE (environnement de développement intégré) R externe pour
créer et affiner les scripts R, puis utiliser ces scripts dans Power BI.

Activer un IDE R externe

Auparavant, vous deviez utiliser l’éditeur de script R dans Power BI Desktop pour créer et exécuter des scripts R.
Avec cette version, vous pouvez lancer votre IDE R externe à partir de Power BI Desktop et importer et afficher
vos données automatiquement dans l’IDE R. À partir de là, vous pouvez modifier le script dans cet IDE R externe,
puis le coller dans Power BI Desktop pour créer des rapports et des éléments visuels Power BI.
À partir de la version de septembre 2016 de Power BI Desktop (version 2.39.4526.362), vous pouvez spécifier
l’IDE R que vous souhaitez utiliser et le lancer automatiquement à partir de Power BI Desktop.
Configuration requise
Pour utiliser cette fonctionnalité, vous devez installer un IDE R sur votre ordinateur local. Power BI Desktop
n’inclut pas, ne déploie pas et n’installe pas le moteur R. Vous devez donc installer R séparément sur votre
ordinateur local. Vous pouvez choisir l’IDE R à utiliser avec les options suivantes :
Vous pouvez installer votre IDE R favori (nombre des IDE R étant disponibles gratuitement), tel que
Revolution Open et CRAN Repository.
Power BI Desktop prend également en charge R Studio et Visual Studio 2015 avec les éditeurs Outils R
pour Visual Studio.
 Vous pouvez également installer un autre IDE R et configurer Power BI Desktop pour lancer cet IDE R en
effectuant l’une des opérations suivantes :
Vous pouvez associer des fichiers .R à l’IDE externe que vous souhaitez lancer à l’aide de
Power BI Desktop.
Vous pouvez spécifier l’exécutable quePower BI Desktop doit lancer en sélectionnant Autres à
partir de la section Options de script R de la boîte de dialogue Options. Pour ouvrir la boîte de
dialogue Options, accédez à Fichier > Options et paramètres > Options.

Si vous avez plusieurs IDE R installés, vous pouvez spécifier lequel lancer en le sélectionnant à partir de la liste
déroulante IDE R détectés dans la boîte de dialogue Options.
Par défaut, Power BI Desktop lance R Studio en tant qu’IDE R externe s’il est installé sur votre ordinateur local ;
si R Studio n’est pas installé et que vous avez Visual Studio 2015 avec les Outils R pour Visual Studio, ces
derniers seront lancés à la place. Si aucun de ces IDE R n’est installé, l’application associée aux fichiers.R est
lancée.
Si aucune association au fichier .R n’existe, il est possible de spécifier un chemin d’accès à un IDE personnalisé
dans la section Accédez à votre IDE R préféré de la boîte de dialogue Options. Vous pouvez également lancer un
autre IDE R en sélectionnant l’icône en forme d’engrenage Paramètres en regard de l’icône représentant une
flèche Lancer un IDE R, dans Power BI Desktop.

Lancer un IDE R à partir de Power BI Desktop

Pour lancer un IDE R à partir de Power BI Desktop, effectuez les étapes suivantes :
1. Chargez des données dans Power BI Desktop.
2. Sélectionnez quelques champs que vous souhaitez utiliser dans le volet Champs. Si vous n’avez pas encore
activé les éléments visuels de script, vous êtes invité à le faire.
3. Lorsque les éléments visuels de script sont activés, vous pouvez sélectionner un élément visuel R à partir
du volet Visualisations, qui crée un élément visuel R vide qui est prêt à afficher les résultats de votre script.
Le volet Éditeur de script R s’affiche également.

4. Vous pouvez maintenant sélectionner les champs que vous souhaitez utiliser dans votre script R. Lorsque
vous sélectionnez un champ, le champ Éditeur de script R crée automatiquement un code de script basé
sur le ou les champs que vous sélectionnez. Vous pouvez créer (ou coller) votre script R directement dans le
volet Éditeur de script R, ou le laisser vide.
 NOTE
Le type d’agrégation par défaut pour les éléments visuels R est Ne pas résumer.

5. Vous pouvez maintenant lancer votre IDE R directement à partir de Power BI Desktop. Sélectionnez le
bouton Lancer l’IDE R qui se trouve à droite de la barre de titre Éditeur de script R, comme indiqué ci-
dessous.

6. L’IDE R spécifié est lancé par Power BI Desktop, comme illustré dans l’image suivante où RStudio est
l’IDE R par défaut.
 NOTE
Power BI Desktop ajoute les trois premières lignes du script afin qu’il puisse importer vos données à partir de
Power BI Desktop une fois que vous exécutez le script.

7. Les scripts que vous avez créés dans le volet Éditeur de script R de Power BI Desktop apparaissent à
partir de la ligne 4 de votre IDE R. À ce stade, vous pouvez créer votre script R dans l’IDE R. Une fois que
votre script R est terminé dans votre IDE R, vous devez le copier et le coller dans le volet Éditeur de
script R de Power BI Desktop, à l’exclusion des trois premières lignes du script générées
automatiquement par Power BI Desktop. Ne recopiez pas les trois premières lignes du script dans
Power BI Desktop. Celles-ci ont été utilisées uniquement pour importer vos données dans votre IDE R à
partir de Power BI Desktop.
Limites connues
Le lancement de l’IDE R directement à partir de Power BI Desktop présente quelques limitations :
L’exportation automatique de votre script de l’IDE R vers Power BI Desktop n’est pas prise en charge.
L’éditeur R Client (RGui.exe) n’est pas pris en charge, car l’éditeur lui-même ne prend pas en charge
l’ouverture de fichiers.

Étapes suivantes
Consultez les informations supplémentaires suivantes sur R dans Power BI.
Exécution de scripts R dans Power BI Desktop
Créer des visuels Power BI avec R