Power BI à partir d’Azure Stream AnalyticsPower BI output from Azure Stream Analytics

Vous pouvez utiliser Power BI comme sortie d’une tâche Stream Analytics pour fournir une expérience de visualisation riche des résultats d’analyse.You can use Power BI as an output for a Stream Analytics job to provide for a rich visualization experience of analysis results. Vous pouvez utiliser cette fonctionnalité pour les tableaux de bord opérationnels, la génération de rapports et la création de rapports pilotés par des métriques.You can use this capability for operational dashboards, report generation, and metric-driven reporting.

La sortie Power BI de Stream Analytics n’est pas disponible dans les régions Azure - Chine 21Vianet et Azure - Allemagne (T-Systems International).Power BI output from Stream Analytics is currently not available in the Azure China 21Vianet and Azure Germany (T-Systems International) regions.

Configuration de la sortieOutput configuration

Le tableau suivant répertorie les noms de propriétés et leur description pour configurer votre sortie Power BI.The following table lists property names and their descriptions to configure your Power BI output.

Nom de la propriétéProperty name DescriptionDescription
Alias de sortieOutput alias Fournit un nom convivial qui est utilisé dans les requêtes pour diriger la sortie de requête vers cette sortie Power BI.Provide a friendly name that's used in queries to direct the query output to this Power BI output.
Espace de travail de groupeGroup workspace Pour permettre le partage de données avec d’autres utilisateurs de Power BI, vous pouvez sélectionner des groupes à l’intérieur de votre compte Power BI ou choisir Mon espace de travail si vous ne souhaitez pas écrire dans un groupe.To enable sharing data with other Power BI users, you can select groups inside your Power BI account or choose My Workspace if you don't want to write to a group. La mise à jour d’un groupe existant nécessite le renouvellement de l’authentification Power BI.Updating an existing group requires renewing the Power BI authentication.
Nom du jeu de donnéesDataset name Fournissez un nom de jeu de données qui doit être utilisé pour la sortie Power BI.Provide a dataset name that you want the Power BI output to use.
Nom de la tableTable name Fournissez un nom de table sous le jeu de données de la sortie Power BI.Provide a table name under the dataset of the Power BI output. Actuellement, une sortie Power BI des travaux Stream Analytics ne peut avoir qu’une table dans un jeu de données.Currently, Power BI output from Stream Analytics jobs can have only one table in a dataset.
Autoriser la connexionAuthorize connection Vous devez autoriser la connexion avec Power BI pour configurer vos paramètres de sortie.You need to authorize with Power BI to configure your output settings. Après avoir accordé à cette sortie l’accès à votre tableau de bord Power BI, vous pouvez le révoquer en modifiant le mot de passe du compte d’utilisateur, en supprimant la sortie du travail ou en effaçant le travail Stream Analytics.Once you grant this output access to your Power BI dashboard, you can revoke access by changing the user account password, deleting the job output, or deleting the Stream Analytics job.

Pour une vue d’ensemble de la configuration d’un tableau de bord et d’une sortie Power BI, consultez le didacticiel sur Azure Stream Analytics et Power BI.For a walkthrough of configuring a Power BI output and dashboard, see the Azure Stream Analytics and Power BI tutorial.

Notes

Ne créez pas explicitement le jeu de données et la table dans le tableau de bord Power BI.Don't explicitly create the dataset and table in the Power BI dashboard. Le jeu de données et la table seront automatiquement remplis au démarrage du travail et lorsque celui-ci commence à extraire des sorties dans Power BI.The dataset and table are automatically populated when the job is started and the job starts pumping output into Power BI. Si la requête de travail ne génère aucun résultat, le jeu de données et la table ne sont pas créés.If the job query doesn't generate any results, the dataset and table aren't created. De même, si Power BI dispose déjà d’un jeu de données et d’une table portant le même nom que celui saisi dans le travail Stream Analytics, alors ces données sont écrasées.If Power BI already had a dataset and table with the same name as the one provided in this Stream Analytics job, the existing data is overwritten.

Créer un schémaCreate a schema

Azure Stream Analytics crée un jeu de données et un schéma de table Power BI pour l’utilisateur s’il n’en existe pas encore.Azure Stream Analytics creates a Power BI dataset and table schema for the user if they don't already exist. Dans tous les autres cas, la table est mise à jour de façon à inclure les nouvelles valeurs.In all other cases, the table is updated with new values. Actuellement, seule une table peut exister dans un jeu de données.Currently, only one table can exist within a dataset.

Power BI utilise la stratégie de rétention FIFO (premier entré, premier sorti).Power BI uses the first-in, first-out (FIFO) retention policy. Les données sont collectées dans une table jusqu’à ce qu’elle atteigne 200 000 lignes.Data will collect in a table until it hits 200,000 rows.

Notes

Nous vous déconseillons d’utiliser plusieurs sorties pour écrire dans le même jeu de données, car cela peut entraîner plusieurs problèmes.We do not recommend using multiple outputs to write to the same dataset because it can cause several issues. Chaque sortie tente de créer le jeu de données Power BI indépendamment, ce qui peut entraîner l’affichage de plusieurs jeux de données portant le même nom.Each output tries to create the Power BI dataset independently which can result in multiple datasets with the same name. En outre, si les sorties n’ont pas de schémas cohérents, le jeu de données modifie le schéma sur chaque écriture, ce qui génère un trop grand nombre de demandes de modification de schéma.Additionally, if the outputs don't have consistent schemas, the dataset changes the schema on each write, which leads to too many schema change requests. Même si ces problèmes sont évités, les sorties multiples seront moins performantes qu’une seule sortie fusionnée.Even if these issues are avoided, multiple outputs will be less performant than a single merged output.

Convertir un type de données Stream Analytics vers Power BIConvert a data type from Stream Analytics to Power BI

Azure Stream Analytics met à jour le modèle de données dynamiquement lors de l’exécution si le schéma de sortie est modifié.Azure Stream Analytics updates the data model dynamically at runtime if the output schema changes. L’intégralité des modifications de nom de colonne, modifications de type de colonne et ajouts ou suppressions de colonnes sont suivis.Column name changes, column type changes, and the addition or removal of columns are all tracked.

Ce tableau décrit les conversions des types de données Stream Analytics vers les types Entity Data Model (EDM) de Power BI si un jeu de données et une table Power BI n’existent pas.This table covers the data type conversions from Stream Analytics data types to Power BI Entity Data Model (EDM) types, if a Power BI dataset and table don't exist.

De Stream AnalyticsFrom Stream Analytics Vers Power BITo Power BI
bigintbigint Int64Int64
nvarchar(max)nvarchar(max) StringString
DATETIMEdatetime DatetimeDatetime
floatfloat DoubleDouble
Tableau d’enregistrementsRecord array Type chaîne, valeur constante « IRecord » ou « IArray »String type, constant value "IRecord" or "IArray"

Mettre à jour le schémaUpdate the schema

Steam Analytics déduit le schéma de modèle de données sur la base du premier ensemble d’événements de la sortie.Stream Analytics infers the data model schema based on the first set of events in the output. Plus tard, si nécessaire, le schéma de modèle de données est mis à jour pour prendre en compte les événements entrants qui peuvent ne pas correspondre au schéma d’origine.Later, if necessary, the data model schema is updated to accommodate incoming events that might not fit into the original schema.

Évitez d’utiliser la requête SELECT * pour empêcher la mise à jour dynamique du schéma entre les lignes.Avoid the SELECT * query to prevent dynamic schema update across rows. En plus de l’impact potentiel sur les performances, le temps nécessaire pour la création des résultats devient impossible à déterminer.In addition to potential performance implications, it might result in uncertainty of the time taken for the results. Sélectionnez les champs exacts qui doivent être présentés dans le tableau de bord Power BI.Select the exact fields that need to be shown on the Power BI dashboard. En outre, les valeurs de données doivent être compatibles avec le type de données choisi.Additionally, the data values should be compliant with the chosen data type.

Précédent/actuelPrevious/current Int64Int64 StringString DatetimeDatetime DoubleDouble
Int64Int64 Int64Int64 StringString StringString DoubleDouble
DoubleDouble DoubleDouble StringString StringString DoubleDouble
StringString StringString StringString StringString StringString
DatetimeDatetime StringString StringString DatetimeDatetime StringString

Taille de lot de sortieOutput batch size

Pour la taille du lot de sortie, consultez Limites d’API REST de Power BI.For output batch size, see Power BI Rest API limits.

Étapes suivantesNext steps