Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Cet article fournit des recommandations pour un rendu plus rapide des rapports, des tableaux de bord et des vignettes dans votre application.
Note
N’oubliez pas que le temps de chargement dépend principalement des éléments pertinents pour le rapport et les données proprement dits, notamment les visuels, la taille des données et la complexité des requêtes et des mesures. Pour plus d’informations, consultez le guide d’optimisation de Power BI.
Mettre à jour des outils et des packages sdk
Conservez les outils et les packages sdk up-to-date.
- Utilisez la dernière version de Power BI Desktop.
- Installez la dernière version du Kit de développement logiciel (SDK) client Power BI. Nous publions en continu de nouvelles améliorations. Veillez donc à suivre de temps en temps.
- Utilisez la dernière version de l’éditeur tabulaire.
Initialiser l’incorporation
Préchargement
Utilisez powerbi.preload() pour améliorer les performances de l’utilisateur final. La méthode powerbi.preload() télécharge JavaScript, les fichiers css et d’autres éléments, qui sont utilisés ultérieurement pour incorporer un rapport.
Appelez powerbi.preload() si vous n’incorporez pas immédiatement le rapport. Par exemple, si le contenu Power BI incorporé n’apparaît pas dans la page d’accueil, utilisez powerbi.preload() pour télécharger et mettre en cache les éléments utilisés pour incorporer le contenu.
Démarrage de l’iFrame
Note
Le Kit de développement logiciel (SDK) client Power BI version 2.9 est requis pour démarrer l’iFrame.
powerbi.bootstrap(element, config) vous permet de démarrer l’incorporation avant que tous les paramètres requis soient disponibles. L’API bootstrap prépare et initialise l’iFrame.
Lorsque vous utilisez l’API Bootstrap, il est toujours nécessaire d’appeler powerbi.embed(element, config) sur le même élément HTML.
Par exemple, l’un des cas d’usage de cette fonctionnalité consiste à exécuter le démarrage iFrame et les appels principaux pour l’incorporation, en parallèle.
Conseil / Astuce
Utilisez l’API bootstrap si possible pour générer l’iFrame avant qu’elle ne soit visible pour l’utilisateur final.
Lors de l’incorporation d’un rapport ou d’autres éléments Power BI, assurez-vous que le conteneur incorporé fait partie du DOM et que l’attribut CSS d’affichage n’est pas défini sur aucun , car cela peut entraîner des comportements inattendus. Si vous souhaitez masquer le conteneur incorporé, envisagez d’utiliser l’attribut CSS de visibilité.
Incorporer des paramètres
La powerbi.embed(element, config) méthode reçoit un élément et un paramètre de configuration. Le paramètre de configuration inclut des champs qui ont des implications sur les performances.
URL d’incorporation
Évitez de générer vous-même l’URL incorporée. Au lieu de cela, assurez-vous d’obtenir l’URL incorporée en appelant Obtenir des rapports, obtenir des tableaux de bord ou l’API Obtenir des vignettes . Le paramètre de configuration dans l’URL est utilisé pour améliorer les performances.
Permissions
Fournissez des autorisations d’affichage si vous n’avez pas l’intention d’incorporer un rapport en mode édition. De cette façon, le temps n’est pas passé à initialiser les composants qui sont utilisés uniquement en mode édition.
Filtres, signets et segments
En règle générale, les visuels de rapport sont enregistrés avec des données mises en cache. Les rapports affichent les données mises en cache pendant l’exécution des requêtes. Si des filtres, des signets ou des tranches sont fournis, les données mises en cache ne sont pas utilisées et les visuels sont rendus uniquement une fois la requête visuelle terminée.
Si vous intégrez des rapports avec les mêmes filtres, signets et segments de données, enregistrez le rapport avec ces filtres, signets et segments de données déjà appliqués. Lorsque vous enregistrez le rapport ainsi, il est rendu à l'aide des données mises en cache qui incluent les filtres, les signets et les slicers, ce qui améliore les performances.
Basculement entre les rapports
Lors de l’incorporation de plusieurs rapports dans le même espace, ne générez pas de nouvel iFrame pour chaque rapport. Au lieu de cela, incorporez le nouveau rapport dans le même iFrame pour remplacer le rapport précédent. Utiliser powerbi.embed(element, config) avec une autre configuration pour incorporer le nouveau rapport.
Note
L'intégration de rapports pour vos clients (également appelée scénario « application propriétaire des données »), nécessite l'utilisation d'un jeton d'intégration avec des autorisations pour tous les rapports et modèles sémantiques. Pour plus d’informations, consultez l’API de génération de jeton.
Plusieurs visuels
Lors de l’incorporation de plusieurs visuels à partir du même rapport, ne générez pas de nouvel iFrame pour chaque visuel. Utilisez un iFrame unique pour afficher le rapport avec les visuels spécifiés.
Lors de l’incorporation de plusieurs visuels dans un iFrame unique, tenez compte des points suivants :
Power BI utilise des iFrames pour incorporer un rapport. Parfois, vous souhaiterez peut-être ajouter du contenu entre les visuels (par exemple, du texte ou des graphiques qui ne proviennent pas du rapport). Dans ce cas, vous aurez peut-être besoin d’un iFrame différent pour afficher différents visuels. Pour des performances optimales, essayez et organisez les visuels afin que vous utilisiez les plus rares iFrames possibles. Pour réduire le nombre d’iFrames, envisagez d’utiliser la fonctionnalité de disposition personnalisée.
Si vous avez des visuels provenant de différents rapports ou modèles sémantiques différents, envisagez de joindre les modèles sémantiques et de créer un rapport afin de pouvoir inclure tous les visuels dans le même iFrame.
Une autre alternative, si vous avez des régions non liées ou des données provenant de plusieurs modèles sémantiques, consiste à créer un tableau de bord et à épingler les visuels à celui-ci. Cela vous permet d’effectuer les points suivants :
- Incorporez les vignettes individuelles dans des iFrames non incohérents. Les vignettes de tableau de bord sont plus légères que les rapports et chargent plus rapidement.
- Incorporer l’intégralité du tableau de bord dans un iFrame. Cela vous permet d’avoir des visuels provenant de différents rapports ou modèles sémantiques dans un iFrame sans créer de rapport.
Gardez à l’esprit toutefois que les vignettes de tableau de bord ne sont pas interactives et ne sont pas actualisées avec la même fréquence que les visuels.
Mise en cache des requêtes
Les organisations disposant d’une capacité Power BI Premium ou d’une capacité Power BI Embedded peuvent tirer parti de la mise en cache des requêtes pour accélérer les rapports associés à un modèle sémantique.
En savoir plus sur la mise en cache des requêtes dans Power BI.
Mesurer les performances
Événements de performances
Pour mesurer les performances incorporées, vous pouvez utiliser deux événements :
- Événement chargé : heure à laquelle le rapport est initialisé (le logo Power BI disparaît lorsque la charge est terminée).
- Événement rendu : heure jusqu’à ce que le rapport soit entièrement rendu, à l’aide des données réelles. L’événement rendu est déclenché chaque fois que le rapport est recréé (par exemple, après l’application de filtres). Pour mesurer un rapport, assurez-vous d'effectuer les calculs dès le premier événement déclenché.
Les données mises en cache sont rendues lorsqu’elles sont disponibles, mais aucun autre événement n’est généré.
En savoir plus sur la gestion des événements.
Analyseur de performances
Pour examiner les performances des éléments de rapport, vous pouvez utiliser l’analyseur de performances dans Power BI Desktop. L'Analyseur de performances vous permet de visualiser et d'enregistrer des logs qui captent comment chacun de vos éléments de rapport exécute ses performances.
En savoir plus sur Performance Analyzer.
Note
N’oubliez pas de comparer les performances du rapport incorporé aux performances sur powerbi.com. Cela peut vous aider à comprendre l’origine de vos problèmes de performances