Jeux de données incorporés dans le rapport (Générateur de rapport Power BI)
S’APPLIQUE À : Générateur de rapports Power BI
Power BI Desktop
Un dataset spécifie les données que vous souhaitez utiliser à partir d'une connexion de données. Un jeu de données est basé sur une connexion de données qui a été enregistrée dans le rapport en tant que source de données incorporée. Le dataset inclut une requête qui spécifie un ensemble de champs. Lorsque vous faites glisser ces champs vers l'aire de conception, vous créez des expressions qui correspondent aux données effectives lorsque le rapport s'exécute.
Les rapports paginés sur le service Power BI prennent en charge les jeux de données incorporés.
- Dataset incorporé. Un dataset incorporé est uniquement défini dans et utilisé par le rapport dans lequel il est incorporé. Utilisez un dataset incorporé lorsque vous souhaitez obtenir des données d'une source de données externe à utiliser uniquement dans un rapport. Les modifications apportées à un jeu de données incorporé affectent uniquement ce rapport.
Un dataset inclut également des paramètres, filtres et options de données qui spécifient des informations de classement, pour le respect de la casse, des caractères de type Kana, de la largeur des caractères et des accents.
Jeux de données dans le volet Données du rapport Un jeu de données s'affiche dans le volet Données du rapport une fois que vous avez créé un jeu de données incorporé. Un dataset repose sur une source de données.
Concepteur de requêtes Lorsque vous concevez une requête de dataset, le concepteur de requêtes associé au type de source de données s'ouvre.
Commande de requête Le concepteur de requêtes vous aide à générer une commande de requête. La syntaxe de commande est déterminée par le fournisseur de données.
Extension de données/Fournisseur de données : la connexion aux données peut s’effectuer via plusieurs couches d’accès aux données.
Sources de données externes Récupérez des données à partir de bases de données relationnelles, de bases de données multidimensionnelles, etc.
Résultats de la requête Vous pouvez exécuter la requête et consulter un exemple de jeu de résultats. Vous devez disposer d'informations d'identification au moment de la conception pour exécuter une requête.
Métadonnées du schéma Le fournisseur de données exécute une commande de requête de schéma indépendamment de la requête afin de récupérer des métadonnées pour la collection de champs de dataset. Par exemple, une instruction Transact-SQL SELECT retourne les noms de colonnes d’une table de base de données. Utilisez le volet Données du rapport pour développer le dataset afin d'afficher la collection de champs de dataset.
Comprendre les jeux de données et les requêtes de rapport
Un dataset de rapport contient une commande de requête qui s'exécute sur la source de données externe et spécifie les données à récupérer. Pour générer la commande de requête, vous utilisez le concepteur de requêtes associé à l'extension de données pour la source de données externe. Dans le concepteur de requêtes, vous pouvez exécuter la commande de requête et afficher un jeu de résultats. Le jeu de résultats est un ensemble de lignes rectangulaire qui a des noms de colonnes et des lignes avec le même nombre de valeurs dans chaque ligne. Les données hiérarchiques, également appelées hiérarchies déséquilibrées, ne sont pas prises en charge. Les noms des colonnes sont enregistrés dans la définition de rapport sous forme de liste de champs de dataset.
Après avoir ajouté des datasets à votre rapport, vous faites glisser des champs de leurs collections de champs dans le volet Données du rapport vers les tables, graphiques et autres éléments de rapport que vous utilisez pour concevoir le modèle de rapport. Pour plus d’informations sur l’utilisation des champs, consultez Collection de champs de jeu de données (Générateur de rapport Power BI).
Comprendre les données d’un jeu de données de rapport
Selon l'extension de données, un dataset de rapport peut être constitué des types de données suivants :
Jeu de résultats provenant d'une base de données relationnelle, qui peut résulter de l'exécution de commandes de base de données, de procédures stockées ou de fonctions définies par l'utilisateur. Si plusieurs jeux de résultats sont extraits par l'intermédiaire d'une requête unique, seul le premier jeu de résultats est traité et tous les autres jeux de résultats sont ignorés. Par exemple, lorsque vous exécutez la requête suivante dans le concepteur de requêtes textuel, seul le jeu de résultats pour
Production.Product
apparaît dans le volet de résultats :SELECT ProductID FROM Production.Product GO SELECT ContactID FROM Person.Contact
Ensemble de lignes aplati extrait de sources de données multidimensionnelles qui utilisent le protocole XMLA (XML for Analysis). Certains fournisseurs de données fournissent des propriétés de cellule et de dimension supplémentaires à partir de la source de données qui ne sont pas affichées dans le jeu de résultats, mais qui sont disponibles dans votre rapport.
Jeu de résultats extrait de tous les fournisseurs de données .NET Framework enregistrés et configurés.
Lorsque le rapport est traité au moment de l'exécution, le jeu de résultats réel retourné pour une requête peut comporter aucune ou plusieurs lignes. Les colonnes définies dans la requête peuvent également être manquantes dans la source de données. Les valeurs Null de la source de données sont mappées à la valeur .NET FrameworkSystem.DBNull.Value.
Pour plus d’informations sur les champs de jeu de données, consultez Collection de champs de jeu de données (Générateur de rapport Power BI).
Requête de dataset
Lorsque vous exécutez une requête de dataset dans un concepteur de requêtes lors de la conception, vous voyez s'afficher un ensemble de lignes extrait de la source de données en guise de données d'exemple. Au moment de l'exécution, lorsqu'un utilisateur consulte le rapport, la requête de dataset peut produire des valeurs différentes, car les données sur la source de données ont changé. Chaque fois que le rapport est traité, de nouvelles données peuvent apparaître.
Lorsque vous définissez chaque jeu de données, le générateur de rapport Power BI ouvre le concepteur de requêtes qui correspond au type de source de données, pour vous aider à concevoir des requêtes. Par exemple, pour définir une requête pour des données d'une base de données relationnelle SQL Server, les Assistants Tableau, Matrice, Graphique et Carte ouvrent une simple interface graphique qui vous aide à générer la requête ; vous n'avez plus qu'à sélectionner les champs souhaités dans votre dataset.
Dans un concepteur de requêtes, vous pouvez effectuer les tâches suivantes :
Basculer entre l'affichage des requêtes graphique et textuel. Utilisez l'affichage graphique pour explorer des schémas, tables, vues et procédures stockées sur la source de données. Utilisez l'affichage textuel pour taper, coller ou visualiser une requête existante, utilisée en général pour une requête complexe qui ne peut pas être affichée dans un concepteur de requêtes graphique.
Exécuter la requête pour afficher les données. La requête retourne un jeu de résultats. Les colonnes dans le jeu de résultats deviennent la collection de champs pour le dataset. Les lignes dans le résultat deviennent les données pour le dataset. Vous pouvez modifier la requête jusqu'à ce que vous obteniez les colonnes escomptées.
Ajouter des paramètres de requête pour récupérer les données à inclure dans votre rapport. Les paramètres de requête génèrent automatiquement des paramètres de rapport correspondants. Pour une source de données de modèle de rapport, le filtre que vous spécifiez génère automatiquement un paramètre de rapport correspondant. Les paramètres de rapport permettent aux utilisateurs de spécifier les données de rapport qu'ils souhaitent afficher lors de l'exécution du rapport. Par exemple, l'utilisateur sélectionne les catégories de produits pour lesquelles il souhaite des données et, lors de l'exécution du rapport, seules les données pour ces catégories de produits s'affichent dans le rapport.
Les concepteurs de requêtes peuvent fournir un mode graphique ou un mode texte selon le type de source de données. Si vous choisissez le mode texte, vous devez utiliser la syntaxe de requête appropriée pour la source de données.
Lorsque vous définissez un dataset de rapport, vous pouvez définir des propriétés de données dans la requête ou accepter les paramètres par défaut définis par le fournisseur de données. Pour modifier un type de données, vous pouvez utiliser l'une des méthodes suivantes :
Réécrivez la requête de dataset pour convertir spécifiquement un champ en un type de données différent.
Modifiez le champ dans le dataset et fournissez un format personnalisé.
Créez un champ personnalisé en fonction d'un champ de base de données et fournissez un format personnalisé.
Pour plus d’informations, consultez Collection de champs de jeu de données (Générateur de rapport Power BI).
Filtrer, trier et regrouper des données dans un jeu de données
Les données dans un dataset proviennent de l'exécution d'une commande de requête sur une source de données externe. La syntaxe de commande de requête pour une extension de données détermine si les données peuvent être triées ou regroupées. Le tri et le regroupement ont lieu dans la requête avant que les données ne soient récupérées pour un rapport. Le filtrage se déroule une fois que les données ont été récupérées pour un rapport.
Pour plus d’informations, consultez Filtrer, regrouper et trier des données (Power BI Report Builder).
Filtrer des données dans un jeu de données
Les filtres font partie de la définition de dataset dans un rapport. Utilisez les filtres de dataset pour spécifier les données d'un dataset à inclure dans un rapport. Lorsque vous spécifiez des filtres sur un dataset, toutes les régions de données basées sur le dataset affichent uniquement les données qui traversent les filtres de dataset.
Vous pouvez définir des filtres supplémentaires sur une région de données ou un groupe de régions de données. Vous pouvez également utiliser une combinaison de paramètres et de filtres pour permettre aux utilisateurs de choisir les données qu'ils souhaitent voir dans un rapport. Pour plus d’informations, consultez Paramètre de rapport (Générateur de rapport Power BI).
Trier des données dans une requête de jeu de données
Dans un dataset, l'ordre des données est celui dans lequel elles sont récupérées de la source de données externe. Il s'agit du même ordre que celui que vous voyez quand vous exécutez la requête dans le concepteur de requêtes. Si la syntaxe de commande de requête prend en charge le tri, vous pouvez modifier la requête pour trier les données à la source, avant qu'elles ne soient retournées comme données de rapport. Par exemple, pour une requête Transact-SQL, l’instruction ORDER BY contrôle l’ordre de tri.
Pour trier les données après qu'elles ont été retournées au rapport, définissez des expressions de tri sur les régions de données et les groupes de régions de données. Pour plus d’informations, consultez la rubrique relative au type spécifique de région de données, par exemple Tables, matrices et listes (Générateur de rapport Power BI).
Vous pouvez également utiliser une combinaison de paramètres et d'expressions de tri pour permettre aux utilisateurs de choisir l'ordre de tri pour les données dans un rapport. Pour plus d’informations, consultez Paramètre de rapport (Générateur de rapport Power BI).
Regrouper des données dans un jeu de données
Vous ne pouvez pas regrouper de données dans un dataset. Pour agréger des données dans un dataset, vous pouvez modifier la commande de requête pour calculer des agrégats avant que les données ne soient récupérées pour un rapport. Elles sont connues sous le nom d' agrégats de serveur. Dans les expressions, pour identifier ces valeurs comme agrégats calculés à l'avance, utilisez la fonction Aggregate. Pour obtenir plus d’informations, consultez Fonction d’agrégation (Report Builder).
Utiliser les paramètres et les jeux de données
Pour une requête de dataset incorporé qui comprend des variables de requête, des paramètres de requête et paramètres de rapport correspondants sont créés automatiquement. Lors de l'exécution du rapport, la valeur du paramètre de rapport est liée au paramètre de requête du dataset. De cette façon, la commande de requête qui s'exécute sur la source de données externe inclut les valeurs spécifiées pour les paramètres de rapport. Les paramètres de rapport permettent à un utilisateur de choisir les données qu'il souhaite voir dans le rapport. Vous pouvez voir la manière dont les paramètres de requête et les paramètres de rapport sont liés dans la boîte de dialogue Propriétés du dataset, page Paramètres.
La liste suivante décrit la prise en charge des valeurs de paramètres de requête :
Peut être basé sur une expression.
Peut inclure des valeurs par défaut.
Peut être en lecture seule. Les paramètres en lecture seule ne peuvent pas être modifiés dans une instance du dataset partagé dans un rapport.
Impossible d’inclure des références à la collection intégrée Parameters, qui représente les paramètres de rapport.
Pour certaines sources de données tabulaires, telles que Analysis Services, le concepteur de requêtes graphique vous permet de spécifier des filtres de requête et de sélectionner une option pour créer un paramètre de requête correspondant. Lorsque vous sélectionnez l'option de paramètre, l'extension de données crée automatiquement un dataset de rapport séparé afin de fournir des valeurs disponibles pour une liste déroulante pour ce paramètre. Par défaut, ces datasets masqués n'apparaissent pas dans le volet Données du rapport.
Les paramètres de rapport liés aux paramètres de requête permettent de filtrer les données avant qu'elles ne soient retournées de la source de données externe. Vous pouvez également filtrer les données dans le rapport en créant des filtres qui font partie de la définition de rapport. Pour plus d’informations, consultez Filtrer, regrouper et trier des données (Power BI Report Builder).
Afficher des jeux de données masqués
Lorsque vous créez une requête paramétrable pour certaines sources de données tabulaires, les jeux de données qui fournissent des valeurs valides pour le paramètre sont automatiquement créés. Sur certains concepteurs de requêtes, vous effectuez cette opération en spécifiant des filtres, puis en sélectionnant l'option pour créer des paramètres. Par défaut, ces datasets n'apparaissent pas dans le volet Données du rapport, mais ils peuvent être affichés.
Utiliser des mappages et des jeux de données
Si vous incluez une carte dans votre rapport, vous devez fournir des données spatiales. Les données spatiales peuvent provenir d’un jeu de données de rapport. Les données spatiales d’un rapport n’apparaissent pas en tant que jeu de données dans le volet Données du rapport. Pour plus d’informations, consultez Cartes (Power BI Report Builder).
Afficher les données de plusieurs jeux de données
Un rapport comporte généralement plusieurs datasets. La liste suivante décrit la manière dont vous pouvez utiliser les datasets dans un rapport :
Vous affichez les données provenant de chaque dataset à l'aide d'une région de données distincte. Pour plus d’informations, consultez Régions et mappages de données (Générateur de rapport Power BI).
Vous pouvez lier plusieurs régions de données à un dataset et fournir plusieurs vues des mêmes données.
Vous pouvez utiliser des datasets pour fournir une liste déroulante des valeurs disponibles et des valeurs par défaut pour un paramètre de rapport. Pour plus d’informations, consultez Paramètre de rapport (Générateur de rapport Power BI).
À l'aide de paramètres, vous pouvez associer des données liées provenant de plusieurs datasets à des rapports ou des sous-rapports d'extraction. Par exemple, un état des ventes peut afficher les données de synthèse pour tous les magasins et un lien d'extraction peut spécifier l'identificateur de magasin en tant que paramètre à un rapport avec une requête de dataset qui extrait les ventes individuelles pour le magasin spécifié. Pour plus d’informations, consultez Extraction, exploration technique et régions de données imbriquées (Générateur de rapport Power BI) et Sous-rapports (Générateur de rapport Power BI).
Vous ne pouvez pas afficher de données de détail provenant de plusieurs datasets dans une région de données unique. Toutefois, vous pouvez afficher des valeurs de fonction d'agrégation ou de fonction intégrée pour plusieurs datasets dans une région de données. Pour plus d’informations, consultez Référence sur les fonctions d’agrégation (Power BI Report Builder). Si vous devez combiner les données de détail de plusieurs datasets en une région de données unique, vous devez réécrire votre requête pour extraire les données sous la forme d'un dataset unique.
Afficher un message lorsqu’aucune ligne de données n'est disponible
Durant le traitement du rapport, lorsque la requête pour un dataset s'exécute, le jeu de résultats peut ne contenir aucune ligne. Dans le rapport rendu, une région de données liée à un dataset vide s'affiche comme une région de données vide. Vous pouvez spécifier le texte à afficher à la place de la région de données vide dans le rapport rendu. Vous pouvez également spécifier un message pour les sous-rapports lorsque les requêtes pour tous les datasets ne produisent aucune donnée lors de l'exécution. Pour plus d’informations, consultez Définir un message d’absence de données pour une région de données (Générateur de rapport Power BI).
Définir les options de jeu de données
Pour les sources de données qui prennent en charge des données internationales, vous devrez éventuellement modifier les propriétés d'un dataset qui affectent l'ordre de tri, les propriétés des caractères internationaux et le respect de la casse. Ces propriétés incluent : casse, jeu de caractères Kana, largeur, accent et classement. Pour plus d’informations sur la définition de ces propriétés, consultez Boîte de dialogue Propriétés du jeu de données, options (Générateur de rapport Power BI).