Connectivité des jeux de données avec le point de terminaison XMLADataset connectivity with the XMLA endpoint

Les espaces de travail et les jeux de données Power BI Premium au niveau de compatibilité 1500 et supérieur prennent en charge la connectivité Open-plateforme à partir d’applications et d’outils clients Microsoft et tiers à l’aide d’un point de terminaison XMLA.Power BI Premium workspaces and datasets at the 1500 and higher compatibility level support open-platform connectivity from Microsoft and third-party client applications and tools by using an XMLA endpoint.

Qu’est-ce qu’un point de terminaison XMLA ?What's an XMLA endpoint?

Power BI Premium utilise le protocole XML for Analysis (XMLA) pour les communications entre des applications clientes et le moteur qui gère vos espaces de travail et jeux de données Power BI.Power BI Premium uses the XML for Analysis (XMLA) protocol for communications between client applications and the engine that manages your Power BI workspaces and datasets. Ces communications s’effectuent via ce qui est communément appelé « points de terminaison XMLA ».These communications are through what are commonly referred to as XMLA endpoints. XMLA est le même protocole de communication que celui utilisé par le moteur Microsoft Analysis Services, qui, sous le capot, exécute la modélisation sémantique, la gouvernance, le cycle de vie et la gestion des données de Power BI.XMLA is the same communication protocol used by the Microsoft Analysis Services engine, which under the hood, runs Power BI's semantic modeling, governance, lifecycle, and data management.

Par défaut, la connexion en lecture seule à l’aide du point de terminaison est activée pour la charge de travail des jeux de données dans une capacité.By default, read-only connectivity using the endpoint is enabled for the Datasets workload in a capacity. Avec l’accès en lecture seule, les applications et les outils de visualisation des données peuvent interroger les données, les métadonnées, les événements et le schéma du modèle de jeux de données.With read-only, data visualization applications and tools can query dataset model data, metadata, events, and schema. Les opérations en lecture/écriture utilisant le point de terminaison peuvent être activées pour fournir une gestion, une gouvernance, une modélisation sémantique avancée, un débogage et une surveillance des jeux de données supplémentaires.Read-write operations using the endpoint can be enabled providing additional dataset management, governance, advanced semantic modeling, debugging, and monitoring. Avec l’option lecture-écriture activée, les jeux de données Power BI Premium ont plus de parité avec les outils et les processus de modélisation tabulaire de niveau entreprise Azure Analysis Services et SQL Server Analysis Services.With read-write enabled, Power BI Premium datasets have more parity with Azure Analysis Services and SQL Server Analysis Services enterprise grade tabular modeling tools and processes.

Notes

Il est recommandé d’utiliser l’expérience d’espace de travail moderne, en particulier lors de la connexion à vos jeux de données à l’aide du point de terminaison XMLA.It's recommended you use the modern workspace experience, especially when connecting to your datasets by using the XMLA endpoint. Les opérations telles que la création ou la suppression de jeux de données ne sont pas prises en charge avec les espaces de travail classiques.Operations such as creating or deleting datasets are not supported with classic workspaces. Pour mettre à niveau les espaces de travail classiques vers l’expérience moderne, consultez Mettre à niveau les espaces de travail classiques dans Power BI.To upgrade classic workspaces to the modern experience, see Upgrade classic workspaces in Power BI.

Outils de gestion et de modélisation des donnéesData modeling and management tools

Voici quelques-uns des outils les plus courants utilisés avec Azure Analysis Services et SQL Server Analysis Services, et désormais pris en charge par les jeux de données Power BI Premium :These are some of the most common tools used with Azure Analysis Services and SQL Server Analysis Services, and now supported by Power BI Premium datasets:

Visual Studio avec Analysis Services projets , également appelé SQL Server Data Tools ou simplement SSDT, est un outil de création de modèles de niveau entreprise pour les modèles tabulaires Analysis Services.Visual Studio with Analysis Services projects – Also known as SQL Server Data Tools, or simply SSDT, is an enterprise grade model authoring tool for Analysis Services tabular models. Les extensions de projets Analysis Services sont prises en charge sur toutes les éditions de Visual Studio 2017 et versions ultérieures, y compris l’édition Communauté gratuite.Analysis Services projects extensions are supported on all Visual Studio 2017 and later editions, including the free Community edition. La version d’extension 2.9.6 ou ultérieure est requise pour déployer des modèles tabulaires dans un espace de travail Premium.Extension version 2.9.6 or higher is required to deploy tabular models to a Premium workspace. Lors du déploiement vers un espace de travail Premium, le modèle doit être au niveau de compatibilité 1500 ou supérieur.When deploying to a Premium workspace, the model must be at the 1500 or higher compatibility level. La lecture-écriture XMLA est requise sur la charge de travail des jeux de données.XMLA read-write is required on the datasets workload. Pour en savoir plus, consultez Outils pour Analysis Services.To learn more, see Tools for Analysis Services.

SQL Server Management Studio (SSMS)   : prend en charge les requêtes DAX, MDX et XMLA.SQL Server Management Studio (SSMS) - Supports DAX, MDX, and XMLA queries. Effectuez des opérations d’actualisation précises et des scripts de métadonnées du jeu de données à l’aide du Langage de script de modèle tabulaire (TMSL).Perform fine-grain refresh operations and scripting of dataset metadata by using the Tabular Model Scripting Language (TMSL). L’accès en lecture seule est requis pour les opérations de requête.Read-only is required for query operations. L’accès en lecture/écriture est requis pour les métadonnées de script.Read-write is required for scripting metadata. Requiert SSMS version 18.4 ou ultérieure.Requires SSMS version 18.4 or above. Téléchargez ici.Download here.

SQL Server Profiler  : installé avec SSMS, cet outil fournit le traçage et le débogage des événements des jeux de données.SQL Server Profiler – Installed with SSMS, this tool provides tracing and debugging of dataset events. Bien qu’officiellement déprécié pour SQL Server, Profiler continue à être inclus dans SSMS. Il reste pris en charge pour Analysis Services et Power BI Premium.While officially deprecated for SQL Server, Profiler continues to be included in SSMS and remains supported for Analysis Services and Power BI Premium. L’accès en lecture seule XMLA est requis.XMLA read-only is required. Pour en savoir plus, consultez  SQL Server Profiler pour Analysis Services.To learn more, see SQL Server Profiler for Analysis Services.

Assistant de déploiement Analysis Services  : installé avec SSMS, cet outil permet de déployer des projets de modèles tabulaires créés par Visual Studio dans des espaces de travail Analysis Services et Power BI Premium.Analysis Services Deployment Wizard – Installed with SSMS, this tool provides deployment of Visual Studio authored tabular model projects to Analysis Services and Power BI Premium workspaces. Il peut être exécuté de manière interactive ou à partir de la ligne de commande pour l’automatisation.It can be run interactively or from the command line for automation. L’accès en lecture/écriture XMLA est requis.XMLA read-write is required. Pour en savoir plus, consultez Assistant de déploiement Analysis Services.To learn more, see Analysis Services Deployment Wizard.

Cmdlets PowerShell  : les cmdlets Analysis Services peuvent être utilisées pour automatiser des tâches de gestion de jeux de données telles que les opérations d’actualisation.PowerShell cmdlets – Analysis Services cmdlets can be used to automate dataset management tasks like refresh operations. L’accès en lecture/écriture XMLA est requis.XMLA read-write is required. La version 21.1.18221 ou une version ultérieure du module SqlServer PowerShell est requise.Version 21.1.18221 or higher of the SqlServer PowerShell module is required. Les cmdlets Azure Analysis Services dans le module Az. AnalysisServices ne sont pas prises en charge pour Power BI Premium.Azure Analysis Services cmdlets in the Az.AnalysisServices module are not supported for Power BI Premium. Pour en savoir plus, consultez Référence Analysis Services PowerShell .To learn more, see Analysis Services PowerShell Reference.

Power BI Report Builder  : outil qui permet de créer des rapports paginés.Power BI Report Builder - A tool for authoring paginated reports. Créez une définition de rapport qui spécifie les données à récupérer, où les obtenir et comment les afficher.Create a report definition that specifies what data to retrieve, where to get it, and how to display it. Vous pouvez prévisualiser votre rapport dans le Générateur de rapports, puis, publier votre rapport dans le service Power BI.You can preview your report in Report Builder and then publish your report to the Power BI service. L’accès en lecture seule XMLA est requis.XMLA read-only is required. Pour en savoir plus, consultez  Power BI Report Builder.To learn more, see Power BI Report Builder.

Éditeur tabulaire : outil Open source permettant de créer, de maintenir et de gérer des modèles tabulaires à l’aide d’un éditeur simplifié et intuitif.Tabular Editor - An open-source tool for creating, maintaining, and managing tabular models using an intuitive, lightweight editor. Une vue hiérarchique affiche tous les objets de votre modèle tabulaire.A hierarchical view shows all objects in your tabular model. Les objets sont organisés par dossiers d’affichage avec support de la modification de propriété à sélection multiple et de la mise en surbrillance de la syntaxe DAX.Objects are organized by display folders with support for multi-select property editing and DAX syntax highlighting. L’accès en lecture seule XMLA est requis pour les opérations de requête.XMLA read-only is required for query operations. L’accès en lecture/écriture est requis pour les opérations de métadonnées.Read-write is required for metadata operations. Pour en savoir plus, consultez tabulareditor.github.io.To learn more, see tabulareditor.github.io.

DAX Studio  : outil Open source pour la création, le diagnostic, le réglage des performances et l’analyse DAX.DAX Studio – An open-source tool for DAX authoring, diagnosis, performance tuning, and analysis. Les fonctionnalités incluent l’exploration des objets, le traçage intégré, l’analyse de l’exécution de la requête avec des statistiques détaillées, la mise en surbrillance et la mise en forme de la syntaxe DAX.Features include object browsing, integrated tracing, query execution breakdowns with detailed statistics, DAX syntax highlighting and formatting. L’accès en lecture seule XMLA est requis pour les opérations de requête.XMLA read-only is required for query operations. Pour en savoir plus, consultez daxstudio.org.To learn more, see daxstudio.org.

ALM Toolkit : outil de comparaison de schémas Open source pour les jeux de données Power BI, le plus souvent utilisé pour les scénarios de gestion du cycle de vie des applications (ALM).ALM Toolkit - An open-source schema compare tool for Power BI datasets, most often used for application lifecycle management (ALM) scenarios. Effectuez le déploiement dans des environnements et conservez les données historiques de l’actualisation incrémentielle.Perform deployment across environments and retain incremental refresh historical data. Comparez et fusionnez des fichiers de métadonnées, branches et référentiels.Diff and merge metadata files, branches and repos. Réutilisez les définitions communes entre les jeux de données.Reuse common definitions between datasets. L’accès en lecture seule est requis pour les opérations de requête.Read-only is required for query operations. L’accès en lecture/écriture est requis pour les opérations de métadonnées.Read-write is required for metadata operations. Pour plus d’informations, consultez alm-toolkit.com.To learn more, see alm-toolkit.com.

Microsoft Excel  : les tableaux croisés dynamiques Excel sont l’un des outils les plus courants utilisés pour résumer, analyser, explorer et présenter des données de synthèse à partir de jeux de données Power BI.Microsoft Excel – Excel PivotTables are one of the most common tools used to summarize, analyze, explore, and present summary data from Power BI datasets. L’accès en lecture seule est requis pour les opérations de requête.Read-only is required for query operations. La version « démarrer en un clic » d’Office 16.0.11326.10000 ou une version ultérieure est requise.Click-to-Run version of Office 16.0.11326.10000 or higher is required.

Tiers  : inclut des applications et des outils de visualisation de données clients qui peuvent se connecter aux jeux de données, les interroger et les consommer dans Power BI Premium.Third party - Includes client data visualization applications and tools that can connect to, query, and consume datasets in Power BI Premium. La plupart des outils nécessitent les dernières versions des bibliothèques clientes MSOLAP, mais certains peuvent utiliser ADOMD.Most tools require the latest versions of MSOLAP client libraries, but some may use ADOMD. Le point de terminaison XMLA en lecture seule ou en lecture-écriture dépend des opérations.Read-only or read-write XMLA Endpoint is dependent on the operations.

Bibliothèques clientesClient libraries

Les applications clientes ne communiquent pas directement avec le point de terminaison XMLA.Client applications don't communicate directly with the XMLA endpoint. Au lieu de cela, ils utilisent des bibliothèques clientes en tant que couche d’abstraction.Instead, they use client libraries as an abstraction layer. Il s’agit des mêmes applications de bibliothèques clientes que celles utilisées pour se connecter à Azure Analysis Services et SQL Server Analysis Services.These are the same client libraries applications use to connect to Azure Analysis Services and SQL Server Analysis Services. Les applications Microsoft telles que Excel, SQL Server Management Studio (SSMS), ainsi que les extensions de projets Analysis Services pour Visual Studio installent les trois bibliothèques clientes et les mettent à jour avec des mises à jour régulières des applications et des extensions.Microsoft applications like Excel, SQL Server Management Studio (SSMS), and Analysis Services projects extension for Visual Studio install all three client libraries and update them along with regular application and extension updates. Les développeurs peuvent également utiliser les bibliothèques clientes pour générer des applications personnalisées.Developers can also use the client libraries to build custom applications. Dans certains cas, en particulier avec les applications tierces, si elles ne sont pas installées avec l’application, vous devrez peut-être installer des versions plus récentes des bibliothèques clientes.In some cases, particularly with third-party applications, if not installed with the application, it may be necessary to install newer versions of the client libraries. Les bibliothèques clientes sont mises à jour tous les mois.Client libraries are updated monthly. Pour en savoir plus, consultez  Bibliothèques clientes pour se connecter à Analysis Services.To learn more, see Client libraries for connecting to Analysis Services.

Optimiser les jeux de données pour les opérations d’écriture en activant les grands modèlesOptimize datasets for write operations by enabling large models

Lorsque vous utilisez le point de terminaison XMLA pour la gestion des jeux de données avec des opérations d’écriture, il est recommandé d’activer le jeu de données pour les grands modèles.When using the XMLA endpoint for dataset management with write operations, it's recommended you enable the dataset for large models. Cela réduit la surcharge des opérations d’écriture, ce qui peut les rendre beaucoup plus rapides.This reduces the overhead of write operations, which can make them considerably faster. Pour les jeux de données dont la taille est supérieure à 1 Go (après compression), la différence peut être importante.For datasets over 1 GB in size (after compression), the difference can be significant. Pour en savoir plus, consultez Grands modèles dans Power BI Premium.To learn more, see Large models in Power BI Premium.

Activer l’accès en lecture-écriture XMLAEnable XMLA read-write

Par défaut, une capacité Premium a le paramètre de propriété de point de terminaison XMLA activé pour la lecture seule.By default, a Premium capacity has the XMLA Endpoint property setting enabled for read-only. Cela signifie que les applications peuvent uniquement interroger un jeu de données.This means applications can only query a dataset. Pour que les applications effectuent des opérations d’écriture, la propriété de point de terminaison XMLA doit être activée pour l’accès en lecture-écriture.For applications to perform write operations, the XMLA Endpoint property must be enabled for read-write. Le paramètre de propriété de point de terminaison XMLA pour une capacité est configuré dans la Charge de travail des jeux de données.The XMLA Endpoint property setting for a capacity is configured in the Datasets workload. Le paramètre de point de terminaison XMLA s’applique à tous les espaces de travail et jeux de données affectés à la capacité.The XMLA Endpoint setting applies to all workspaces and datasets assigned to the capacity.

Pour activer l’accès en lecture/écriture pour une capacitéTo enable read-write for a capacity

  1. Dans le portail d’administrateur, cliquez sur Paramètres de capacité > Power BI Premium > nom de la capacité.In the Admin portal, click Capacity settings > Power BI Premium > capacity name.

  2. Développez Charges de travail.Expand Workloads. Dans le paramètre Point de terminaison XMLA, sélectionnez Accès en lecture/écriture.In the XMLA Endpoint setting, select Read Write.

    Activer le point de terminaison XMLA

Connexion à un espace de travail PremiumConnecting to a Premium workspace

Les espaces de travail affectés à une capacité ont une chaîne de connexion au format d’URL, comme ceci :Workspaces assigned to a capacity have a connection string in URL format like this,
powerbi://api.powerbi.com/v1.0/[tenant name]/[workspace name].powerbi://api.powerbi.com/v1.0/[tenant name]/[workspace name].

Les applications se connectant à l’espace de travail utilisent l’URL, comme un nom de serveur Analysis Services.Applications connecting to the workspace use the URL as it were an Analysis Services server name. Par exemple,For example,
powerbi://api.powerbi.com/v1.0/contoso.com/Sales Workspace.powerbi://api.powerbi.com/v1.0/contoso.com/Sales Workspace.

Les utilisateurs avec des UPN dans le même abonné (non B2B) peuvent remplacer le nom de l’abonné par myorg.Users with UPNs in the same tenant (not B2B) can replace the tenant name with myorg. Par exemple,   powerbi://api.powerbi.com/v1.0/myorg/Sales Workspace.For example,  powerbi://api.powerbi.com/v1.0/myorg/Sales Workspace.

Les utilisateurs B2B doivent spécifier l’UPN de leur organisation dans le nom du locataire.B2B users must specify their organization UPN in tenant name. Par exemple,For example,
powerbi://api.powerbi.com/v1.0/fabrikam.com/Sales Workspace.powerbi://api.powerbi.com/v1.0/fabrikam.com/Sales Workspace.

Pour accéder à l’URL de connexion de l’espace de travailTo get the workspace connection URL

Dans Paramètres > Premium > Connexion à l’espace de travail de l’espace de travail, cliquez sur Copier.In workspace Settings > Premium > Workspace Connection, click Copy.

Chaîne de connexion d’espace de travail

Exigences relatives aux connexionsConnection requirements

Catalogue initialInitial catalog

Pour certains outils, comme SQL Server Profiler, vous devrez peut-être spécifier un Catalogue initial.With some tools, such as SQL Server Profiler, you may need to specify an Initial Catalog. Spécifiez un jeu de données (une base de données) dans votre espace de travail.Specify a dataset (database) in your workspace. Dans la boîte de dialogue Se connecter au serveur, cliquez sur Options > Propriétés de la connexion > Se connecter à une base de données, entrez le nom du jeu de données.In the Connect to Server dialog, click Options > Connection Properties > Connect to database, enter the dataset name.

Noms d’espaces de travail dupliquésDuplicate workspace names

Nouveaux espaces de travail (créés à l’aide de la nouvelle expérience de l’espace de travail) dans Power BI imposent la validation pour interdire la création ou le changement de nom des espaces de travail par des noms dupliqués.New workspaces (created using the new workspace experience) in Power BI impose validation to disallow creation or renaming workspaces with duplicate names. Les espaces de travail qui n’ont pas été migrés peuvent entraîner des noms dupliqués.Workspaces that have not been migrated can result in duplicate names. Quand vous vous connectez à un espace de travail portant le même nom qu’un autre espace de travail, l’erreur suivante peut s’afficher :When connecting to a workspace with the same name as another workspace, you may get the following error:

Impossible de se connecter à powerbi://api.powerbi.com/v1.0/[nom_locataire]/[nom_espace_de_travail].Cannot connect to powerbi://api.powerbi.com/v1.0/[tenant name]/[workspace name].

Pour contourner cette erreur, spécifiez, en plus du nom de l’espace de travail, l’ObjectIDGuid, qui peut être copié à partir de l’objectID de l’espace de travail dans l’URL.To work around this error, in addition to the workspace name, specify the ObjectIDGuid, which can be copied from the workspace objectID in the URL. Ajoutez l’ID d’objet (objectID) à l’URL de connexion.Append the objectID to the connection URL. Par exemple,For example,
'powerbi://api.powerbi.com/v1.0/myorg/Contoso Sales - 9d83d204-82a9-4b36-98f2-a40099093830'.'powerbi://api.powerbi.com/v1.0/myorg/Contoso Sales - 9d83d204-82a9-4b36-98f2-a40099093830'.

Nom de jeu de données en doubleDuplicate dataset name

Quand vous vous connectez à un jeu de données portant le même nom qu’un autre jeu de données du même espace de travail, ajoutez le GUID du jeu de données à son nom.When connecting to a dataset with the same name as another dataset in the same workspace, append the dataset guid to the dataset name. Vous pouvez obtenir le nom et le GUID du jeu de données quand vous vous connectez à l’espace de travail dans SSMS.You can get both dataset name and guid when connected to the workspace in SSMS.

Retards dans les jeux de données affichésDelay in datasets shown

Lors de la connexion à un espace de travail, les changements des jeux de données nouveaux, supprimés et renommés peuvent mettre plusieurs minutes à s’afficher.When connecting to a workspace, changes from new, deleted, and renamed datasets can take up to a few minutes to appear.

Jeux de données non pris en chargeUnsupported datasets

Les jeux de données suivants ne sont pas accessibles par le point de terminaison XMLA.The following datasets are not accessible by the XMLA endpoint. Ces jeux de données ne s’affichent pas sous l’espace de travail dans SSMS ou dans d’autres outils :These datasets will not appear under the workspace in SSMS or in other tools:

  • Jeux de données basés sur une connexion active à un modèle Azure Analysis Services ou SQL Server Analysis Services.Datasets based on a live connection to an Azure Analysis Services or SQL Server Analysis Services model.
  • Jeux de données basés sur une connexion active à un jeu de données Power BI dans un autre espace de travail.Datasets based on a live connection to a Power BI dataset in another workspace. Pour en savoir plus, consultez Présentation de jeux de données dans des espaces de travail.To learn more, see Intro to datasets across workspaces.
  • Jeux de données avec des données push à l’aide de l’API REST.Datasets with Push data by using the REST API.
  • Jeux de données de classeur Excel.Excel workbook datasets.

SécuritéSecurity

En plus de la propriété de point de terminaison XMLA activée en lecture-écriture par l’administrateur de capacité, le paramètre Exporter des données au niveau de l’abonné, dans le portail d’administrateur Power BI, également requis pour l’analyse dans Excel, doit être activé.In addition to the XMLA Endpoint property being enabled read-write by the capacity admin, the tenant-level Export data setting in the Power BI Admin Portal, also required for Analyze in Excel, must be enabled.

Activer les données d’exportation

L’accès via le point de terminaison XMLA respectera l’appartenance au groupe de sécurité définie au niveau de l’espace de travail/application.Access through the XMLA endpoint will honor security group membership set at the workspace/app level.

Les contributeurs de l’espace de travail et les versions ultérieures ont accès en écriture au jeu de données et sont donc équivalents aux administrateurs de bases de données Analysis Services.Workspace contributors and above have write access to the dataset and are therefore equivalent to Analysis Services database admins. Ils peuvent déployer de nouveaux jeux de données à partir de Visual Studio et exécuter des scripts TMSL dans SSMS.They can deploy new datasets from Visual Studio and execute TMSL scripts in SSMS.

Les opérations qui requièrent des autorisations d’administrateur de serveur Analysis Services (plutôt que l’administrateur de base de données), tels que les suivis au niveau du serveur et l’emprunt d’identité d’utilisateur à l’aide de la propriété de chaîne de connexion EffectiveUserName ne sont pas prises en charge dans Power BI Premium pour l’instant.Operations that require Analysis Services server admin permissions (rather than database admin) such as server-level traces and user impersonation using the EffectiveUserName connection-string property are not supported in Power BI Premium at this time.

Les autres utilisateurs qui ont une autorisation Build sur un jeu de données sont équivalents aux lecteurs de base de données Analysis Services.Other users who have Build permission on a dataset are equivalent to Analysis Services database readers. Ils peuvent se connecter et parcourir les jeux de données pour la consommation et la visualisation des données.They can connect to and browse datasets for data consumption and visualization. Les règles de sécurité au niveau des lignes (RLS) sont respectées et ils ne peuvent pas voir les métadonnées du jeu de données interne.Row-level security (RLS) rules are honored and they cannot see internal dataset metadata.

Rôles de modèleModel roles

Avec le point de terminaison XMLA, il est possible de définir des rôles pour un jeu de données, une appartenance à un rôle pour des utilisateurs Azure Active Directory (AAD) ainsi que des filtres de sécurité au niveau des lignes.With the XMLA endpoint, roles can be defined for a dataset, role membership can be defined for Azure Active Directory (AAD) users, and row-level security (RLS) filters can be defined. Les rôles de modèle dans Power BI sont utilisés uniquement pour la sécurité au niveau des lignes.Model roles in Power BI are used only for RLS. Utilisez le modèle de sécurité Power BI pour contrôler les autorisations au-delà de la RLS.Use the Power BI security model to control permissions beyond RLS.

Pour les projets de modèles tabulaires créés dans Visual Studio, il est possible de définir des rôles en utilisant le Gestionnaire de rôles dans le concepteur de modèles.For tabular model projects being authored in Visual Studio, roles can be defined by using Role Manager in the model designer. Pour les jeux de données dans Power BI, il est possible de définir des rôles en utilisant SSMS pour créer des objets de rôle et définir des propriétés de rôle.For datasets in Power BI, roles can be defined by using SSMS to create role objects and define role properties. Cependant, dans la plupart des cas, les définitions d’objet de rôle peuvent être scriptées en utilisant TMSL pour créer ou modifier l’objet Roles.In most cases, however, role object definitions can be scripted by using TMSL to create or modify the Roles object. Les scripts TMSL peuvent être exécutés dans SSMS ou avec l’applet de commande PowerShell Invoke-ASCmd.TMSL scripts can be executed in SSMS or with the Invoke-ASCmd PowerShell cmdlet.

Les limitations suivantes s’appliquent lorsque vous utilisez des rôles de jeu de données via le point de terminaison XMLA :The following limitations apply when working with dataset roles through the XMLA endpoint:

  • La seule autorisation pour un rôle qui peut être définie pour les jeux de données Power BI est l’autorisation d’accès en lecture.The only permission for a role that can be set for Power BI datasets is the Read permission. D’autres autorisations sont accordées à l’aide du modèle de sécurité Power BI.Other permissions are granted using the Power BI security model.
  • L’autorisation build pour un jeu de données est requise pour l’accès en lecture via le point de terminaison XMLA, indépendamment de l’existence de rôles de jeu de données.Build permission for a dataset is required for read access through the XMLA endpoint, regardless of the existence of dataset roles.
  • Actuellement, les règles de sécurité au niveau de l’objet (OLS) ne sont pas prises en charge dans Power BI.Object-level security (OLS) rules are currently not supported in Power BI.

Pour en savoir plus, consultez Rôles dans les modèles tabulaires.To learn more, see Roles in tabular models.

Définition des informations d'identification pour la source de donnéesSetting data-source credentials

Les métadonnées spécifiées via le point de terminaison XMLA peuvent créer des connexions aux sources de données, mais ne peuvent pas définir les informations d’identification de la source de données.Metadata specified through the XMLA endpoint can create connections to data sources, but cannot set data-source credentials. Au lieu de cela, les informations d’identification peuvent être définies dans la page Paramètres du jeu de données dans le service Power BI.Instead, credentials can be set in the dataset settings page in the Power BI Service.

Principaux de serviceService principals

Les principaux de service sont une inscription d’application Azure Active Directory que vous créez à l’intérieur de votre locataire pour effectuer des opérations sans assistance au niveau du service et des ressources.Service principals are an Azure Active Directory app registration you create within your tenant to perform unattended resource and service level operations. Il s’agit d’un type unique d’identité d’utilisateur avec un nom d’application, un ID d’application, un ID de locataire, et une clé secrète client ou un certificat en guise de mot de passe.They're a unique type of user identity with an app name, application ID, tenant ID, and client secret or certificate for a password. Power BI Premium utilise la même fonctionnalité de principal de service que Power BI Embedded.Power BI Premium uses the same service principal functionality as Power BI Embedded.

Dans Power BI Premium, les principaux de service peuvent également être utilisés avec le point de terminaison XMLA pour automatiser des tâches de gestion de jeu de données telles que le provisionnement d’espaces de travail, le déploiement de modèles et l’actualisation de jeux de données avec :In Power BI Premium, service principals can also be used with the XMLA endpoint to automate dataset management tasks such as provisioning workspaces, deploying models, and dataset refresh with:

  • PowerShellPowerShell
  • Azure AutomationAzure Automation
  • Azure Logic AppsAzure Logic Apps
  • Des applications clientes personnaliséesCustom client applications

Pour en savoir plus, consultez Automatiser des tâches d’espace de travail et de jeu de données avec des principaux de service.To learn more, see Automate Premium workspace and dataset tasks with service principals.

Déployez des projets de modèle à partir de Visual Studio (SSDT)Deploy model projects from Visual Studio (SSDT)

Le déploiement d’un projet de modèle tabulaire dans Visual Studio vers un espace de travail Power BI Premium est très similaire au déploiement sur un serveur Azure ou SQL Server Analysis Services.Deploying a tabular model project in Visual Studio to a Power BI Premium workspace is much the same as deploying to an Azure or SQL Server Analysis Services server. Les seules différences se trouvent dans la propriété du serveur de déploiement spécifiée pour le projet, et la façon dont les informations d’identification de la source de données sont spécifiées afin que les opérations de traitement puissent importer des données à partir de sources de données dans le nouveau jeu de données sur l’espace de travail.The only differences are in the Deployment Server property specified for the project, and how data source credentials are specified so processing operations can import data from data sources into the new dataset on the workspace.

Pour déployer un projet de modèle tabulaire créé dans Visual Studio, vous devez d’abord définir l’URL de connexion de l’espace de travail dans la propriété Serveur de déploiement du projet.To deploy a tabular model project authored in Visual Studio, you must first set the workspace connection URL in the project Deployment Server property. Dans Visual Studio, Explorateur de solutions, cliquez avec le bouton de droite sur le projet > Propriétés.In Visual Studio, in Solution Explorer, right-click the project > Properties. Dans la propriété Serveur, collez l’URL de connexion à l’espace de travail.In the Server property, paste the workspace connection URL.

Propriété de déploiement

Une fois la propriété Serveur de déploiement spécifiée, le projet peut alors être déployé.When the Deployment Server property has been specified, the project can then be deployed.

Lors du premier déploiement, un jeu de données est créé dans l’espace de travail à l’aide des métadonnées du modèle.bim.When deployed the first time, a dataset is created in the workspace by using metadata from the model.bim. Dans le cadre de l’opération de déploiement, une fois le jeu de données créé dans l’espace de travail à partir des métadonnées du modèle, le traitement pour charger des données dans le jeu de données à partir de sources de données échoue.As part of the deployment operation, after the dataset has been created in the workspace from model metadata, processing to load data into the dataset from data sources will fail.

Le traitement échoue car, contrairement au déploiement sur une instance Azure ou SQL Server Analysis Server, où les informations d’identification de la source de données sont demandées dans le cadre de l’opération de déploiement, lors du déploiement sur un espace de travail Premium, les informations d’identification de la source de données ne peuvent pas être spécifiées dans le cadre de l’opération de déploiement.Processing fails because unlike when deploying to an Azure or SQL Server Analysis Server instance, where data source credentials are prompted for as part of the deployment operation, when deploying to a Premium workspace data source credentials cannot be specified as part of the deployment operation. Au lieu de cela, une fois le déploiement des métadonnées réussi et le jeu de données créé, les informations d’identification de la source de données sont spécifiées dans le service Power BI, dans les paramètres du jeu de données.Instead, after metadata deployment has succeeded and the dataset has been created, data source credentials are then specified in the Power BI Service in dataset settings. Dans l’espace de travail, cliquez sur Jeux de données > Paramètres > Informations d’identification de la source de données > Modifier les informations d’identification.In the workspace, click Datasets > Settings > Data source credentials > Edit credentials.

Informations d’identification de la source de données

Une fois les informations d’identification de la source de données spécifiées, vous pouvez actualiser le jeu de données dans le service Power BI, configurer, planifier, actualiser ou traiter (actualiser) à partir de SQL Server Management Studio pour charger des données dans le jeu de données.When data source credentials are specified, you can then refresh the dataset in the Power BI service, configure schedule refresh, or process (refresh) from SQL Server Management Studio to load data into the dataset.

La propriété de déploiement Option de traitement spécifiée dans le projet, dans Visual Studio, est observée.The deployment Processing Option property specified in the project in Visual Studio is observed. Toutefois, si une source de données n’a pas encore d’informations d’identification spécifiées dans le service Power BI, même si le déploiement des métadonnées réussit, le traitement échoue.However, if a data source has not yet had credentials specified in the Power BI service, even if the metadata deployment succeeds, processing will fail. Vous pouvez définir la propriété sur Ne pas traiter, en empêchant toute tentative de traitement dans le cadre du déploiement, mais vous pouvez redéfinir la propriété sur Par défaut, car une fois les informations d’identification de la source de données spécifiées dans les paramètres de source de données pour le nouveau jeu de données, le traitement dans le cadre des opérations de déploiement ultérieures réussit.You can set the property to Do Not Process, preventing an attempt to process as part of the deployment, but you might want to set the property back to Default because once the data source credentials are specified in the data source settings for the new dataset, processing as part of subsequent deployment operations will then succeed.

Se connecter à SSMSConnect with SSMS

L’utilisation de SSMS pour se connecter à un espace de travail est similaire à la connexion à un serveur Azure ou SQL Server Analysis Services.Using SSMS to connect to a workspace is just like connecting to an Azure or SQL Server Analysis Services server. La seule différence est que vous spécifiez l’URL de l’espace de travail dans le nom du serveur et que vous devez utiliser Active Directory-Universal avec l’authentification MFA.The only difference is you specify the workspace URL in server name, and you must use Active Directory - Universal with MFA authentication.

Se connecter à un espace de travail à l’aide de SSMSConnect to a workspace by using SSMS

  1. Dans SQL Server Management Studio, cliquez sur Se connecter > Se connecter au serveur.In SQL Server Management Studio, click Connect > Connect to Server.

  2. Dans Type de serveur, sélectionnez Analysis Services.In Server Type, select Analysis Services. Dans Nom du serveur, entrez l’URL de l’espace de travail.In Server name, enter the workspace URL. Dans Authentification, sélectionnez Active Directory - Universel avec MFA, puis dans Nom d’utilisateur, entrez votre ID d’utilisateur d’organisation.In Authentication, select Active Directory - Universal with MFA, and then in User name, enter your organizational user ID.

    Se connecter au serveur dans SSMS

Une fois que vous êtes connecté, l’espace de travail est affiché en tant que serveur Analysis Services, et les jeux de données de l’espace de travail sont affichés en tant que bases de données.When connected, the workspace is shown as an Analysis Services server, and datasets in the workspace are shown as databases.

SSMS

Pour en savoir plus sur l’utilisation de SSMS pour des scripts de métadonnées, consultez Créer des scripts Analysis Services et TMSL (Tabular Model Scripting Language).To learn more about using SSMS to script metadata, see Create Analysis Services scripts and Tabular Model Scripting Language (TMSL).

Actualisation du jeu de donnéesDataset refresh

Le point de terminaison XMLA active un large éventail de scénarios pour les fonctionnalités d’actualisation affinées à l’aide de SSMS, l’automation avec PowerShell, Azure Automation et Azure Functions à l’aide de TOM.The XMLA endpoint enables a wide range of scenarios for fine-grain refresh capabilities using SSMS, automation with PowerShell, Azure Automation, and Azure Functions using TOM. Vous pouvez, par exemple, actualiser certaines partitions historiques d’actualisation incrémentielle sans avoir à recharger toutes les données d’historique.You can, for example, refresh certain incremental refresh historical partitions without having to reload all historical data.

Contrairement à la configuration de l’actualisation dans le service Power BI, les opérations d’actualisation via le point de terminaison XMLA ne sont pas limitées à 48 actualisations par jour et le délai d’expiration d’actualisation planifié n’est pas imposé.Unlike configuring refresh in the Power BI service, refresh operations through the XMLA endpoint are not limited to 48 refreshes per day, and the scheduled refresh timeout is not imposed.

Vues de gestion dynamique (DMV)Dynamic Management Views (DMV)

Les DMV Analysis Services assurent la visibilité des métadonnées du jeu de données, la traçabilité et l’utilisation des ressources.Analysis Services DMVs provide visibility of dataset metadata, lineage, and resource usage. Les DMV disponibles pour l’interrogation dans Power BI via le point de terminaison XMLA sont limitées, au moins, à celles qui nécessitent des autorisations d’administrateur de base de données.DMVs available for querying in Power BI through the XMLA endpoint are limited to, at most, those that require database-admin permissions. Par exemple, certaines DMV ne sont pas accessibles car elles exigent des autorisations d’administrateur de serveur Analysis Services.Some DMVs for example are not accessible because they require Analysis Services server-admin permissions.

Jeux de données créés par Power BI DesktopPower BI Desktop authored datasets

Métadonnées amélioréesEnhanced metadata

Les opérations d’écriture XMLA sur les jeux de données créés dans Power BI Desktop et publiées dans un espace de travail Premium nécessitent l’activation de métadonnées améliorées.XMLA write operations on datasets authored in Power BI Desktop and published to a Premium workspace require enhanced metadata is enabled. Pour en savoir plus, consultez Métadonnées de jeu de données améliorées.To learn more, see Enhanced dataset metadata.

Attention

À ce stade, une opération d’écriture sur un jeu de données créé dans Power BI Desktop empêche son nouveau téléchargement en tant que fichier PBIX.At this time, a write operation on a dataset authored in Power BI Desktop will prevent it from being downloaded back as a PBIX file. Veillez à conserver votre fichier PBIX d’origine.Be sure to retain your original PBIX file.

Déclaration de la source de donnéesData-source declaration

Lors de la connexion à des sources de données et de l’interrogation de données, Power BI Desktop utilise des expressions Power Query M comme déclarations de la source de données en ligne.When connecting to data sources and querying data, Power BI Desktop uses Power Query M expressions as inline data source declarations. Bien que prise en charge dans les espaces de travail Power BI Premium, la déclaration de la source de données en ligne Power Query M n’est pas prise en charge par Azure Analysis Services ou SQL Server Analysis Services.While supported in Power BI Premium workspaces, Power Query M inline data-source declaration is not supported by Azure Analysis Services or SQL Server Analysis Services. Au lieu de cela, les outils de modélisation des données Analysis Services, tels que Visual Studio, créent des métadonnées à l’aide de déclarations de la source de données structurées et/ou fournisseur.Instead, Analysis Services data modeling tools like Visual Studio create metadata using structured and/or provider data source declarations. Avec le point de terminaison XMLA, Power BI Premium prend également en charge les sources de données structurées et fournisseur, mais pas dans le cadre des déclarations de la source de données en ligne Power Query M dans les modèles Power BI Desktop.With the XMLA endpoint, Power BI Premium also supports structured and provider data sources, but not as part of Power Query M inline data source declarations in Power BI Desktop models. Pour plus d’informations, consultez Compréhension des fournisseurs.To learn more, see Understanding providers.

Power BI Desktop en mode de connexion activePower BI Desktop in live connect mode

Power BI Desktop peut se connecter à un jeu de données Power BI Premium à l’aide d’une connexion active.Power BI Desktop can connect to a Power BI Premium dataset using a live connection. Lorsqu’une connexion active est utilisée, il n’est pas nécessaire de répliquer les données localement, ce qui permet aux utilisateurs de consommer plus facilement des modèles sémantiques.When using a live connection, data doesn't need to be replicated locally, making it easier for users to consume semantic models. Les utilisateurs peuvent se connecter de deux manières :There are two ways users can connect:

En sélectionnant Jeux de données Power BI, puis en sélectionnant un jeu de données pour créer un rapport.By selecting Power BI datasets, and then selecting a dataset to create a report. C’est ce qui est recommandé aux utilisateurs pour se connecter en temps réel à des jeux de données.This is the recommended way for users to connect live to datasets. Cette méthode fournit une expérience de découverte améliorée qui montre le niveau d’approbation de jeux de données.This method provides an improved discover experience showing the endorsement level of datasets. Les utilisateurs n’ont besoin ni de trouver les URL de l’espace de travail, ni d’effectuer leur suivi.Users don't need to find and keep track of workspace URLs. Pour trouver un jeu de données, les utilisateurs tapent simplement le nom du jeu de données ou font défiler pour trouver le jeu de données qu’ils recherchent.To find a dataset, users simply type in the dataset name or scroll to find the dataset they're looking for.

Se connecter en temps réel à un jeu de données

Les utilisateurs peuvent également se connecter en utilisant Obtenir des données > Analysis Services, spécifier un nom d’espace de travail Power BI Premium en tant qu’URL, sélectionner Connecter en direct, puis sélectionner un jeu de données dans le navigateur.The other way users can connect is by using Get Data > Analysis Services, specify a Power BI Premium workspace name as a URL, select Connect live, and then in Navigator, select a dataset . Dans ce cas, Power BI Desktop utilise le point de terminaison XMLA pour se connecter en temps réel au jeu de données comme s’il s’agissait d’un modèle de données Analysis Services.In this case, Power BI Desktop uses the XMLA endpoint to connect live to the dataset as though it were an Analysis Services data model.

Se connecter en temps réel au jeu de données Analysis Services

Les organisations qui ont des rapports existants connectés en temps réel à des modèles de données Analysis Services destinés à migrer vers des jeux de données Power BI Premium doivent uniquement modifier l’URL du nom de serveur dans Transformer des données > Paramètres de source de données.Organizations that have existing reports connected live to Analysis Services data models intending to migrate to Power BI premium datasets only have to change the server name URL in Transform data > Data source settings.

Journaux d'auditAudit logs

Quand des applications se connectent à un espace de travail, l’accès via les points de terminaison XMLA est enregistré dans les journaux d’audit Power BI sous les opérations suivantes :When applications connect to a workspace, access through XMLA endpoints is logged in the Power BI audit logs with the following operations:

Nom convivial de l’opérationOperation friendly name Nom de l’opérationOperation name
Connecté au jeu de données Power BI à partir d’une application externeConnected to Power BI dataset from an external application ConnectFromExternalApplicationConnectFromExternalApplication
Actualisation du jeu de données Power BI demandée à partir d’une application externeRequested Power BI dataset refresh from an external application RefreshDatasetFromExternalApplicationRefreshDatasetFromExternalApplication
Jeu de données Power BI créé à partir d’une application externeCreated Power BI dataset from an external application CreateDatasetFromExternalApplicationCreateDatasetFromExternalApplication
Jeu de données Power BI modifié à partir d’une application externeEdited Power BI dataset from an external application EditDatasetFromExternalApplicationEditDatasetFromExternalApplication
Jeu de données Power BI supprimé d’une application externeDeleted Power BI dataset from an external application DeleteDatasetFromExternalApplicationDeleteDatasetFromExternalApplication

Pour en savoir plus, consultez  Audit Power BI.To learn more, see Auditing Power BI.

Voir aussiSee also

D’autres questions ?More questions? Essayez d’interroger la communauté Power BITry asking the Power BI Community