Konnektivität mit Datasets mithilfe des XMLA-EndpunktsDataset connectivity with the XMLA endpoint

Power BI Premium-Arbeitsbereiche und Datasets mit dem Kompatibilitätsgrad 1500 und höher unterstützen durch die Verwendung eines XMLA-Endpunkts die Open Platform-Konnektivität von Microsoft- und Drittanbieter-Clientanwendungen und -tools.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.

Was ist ein XMLA-Endpunkt?What's an XMLA endpoint?

Power BI Premium verwendet das XML for Analysis-Protokoll (XMLA) für den Datenaustausch zwischen Clientanwendungen und der Engine, die Ihre Power BI-Arbeitsbereiche und -Datasets verwaltet.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. Diese Kommunikationsvorgänge erfolgen über das, was allgemein als XMLA-Endpunkte bezeichnet wird.These communications are through what are commonly referred to as XMLA endpoints. XMLA ist das gleiche Kommunikationsprotokoll, das von der Microsoft Analysis Services-Engine verwendet wird, die hinter den Kulissen arbeitet und die semantische Modellierung, die Governance, den Lebenszyklus und die Datenverwaltung von Power BI ausführt.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.

Standardmäßig ist die Konnektivität mit Lesezugriff unter Verwendung des Endpunkts für die Datasetworkload in einer Kapazität aktiviert.By default, read-only connectivity using the endpoint is enabled for the Datasets workload in a capacity. Mit schreibgeschützten Anwendungen und Tools für die Datenvisualisierung können Modelldaten, Metadaten, Ereignisse und Schemas von Datasets abgefragt werden.With read-only, data visualization applications and tools can query dataset model data, metadata, events, and schema. Lese-/Schreibvorgänge, die den Endpunkt verwenden, können aktiviert werden und bieten zusätzliche Funktionen für die Verwaltung von Datasets, Governance, erweiterte semantische Modellierung, Debugging und Überwachung.Read-write operations using the endpoint can be enabled providing additional dataset management, governance, advanced semantic modeling, debugging, and monitoring. Mit aktiviertem Lese-/Schreibzugriff sind Power BI Premium-Datasets mit Azure Analysis Services- und SQL Server Analysis Services-Tools und Prozessen für die tabellarische Modellierung auf Unternehmensebene gleichwertiger.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.

Hinweis

Es wird empfohlen, die neue Arbeitsbereichsfunktion zu verwenden, insbesondere wenn Sie eine Verbindung mit Ihren Datasets über den XMLA-Endpunkt herstellen.It's recommended you use the modern workspace experience, especially when connecting to your datasets by using the XMLA endpoint. Vorgänge wie das Erstellen oder Löschen von Datasets werden in klassischen Arbeitsbereichen nicht unterstützt.Operations such as creating or deleting datasets are not supported with classic workspaces. Informationen zum Aktualisieren klassischer Arbeitsbereiche auf die moderne Darstellung finden Sie unter Aktualisieren von klassischen Arbeitsbereichen in Power BI.To upgrade classic workspaces to the modern experience, see Upgrade classic workspaces in Power BI.

Tools für Datenmodellierung und -verwaltungData modeling and management tools

Dies sind einige der am häufigsten verwendeten Tools, die mit Azure Analysis Services und SQL Server Analysis Services verwendet werden und nun von Power BI Premium-Datasets unterstützt werden: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 mit Analysis Services-Projekten  – Auch als SQL Server Data Tools oder einfach SSDT bezeichnet, ist ein Modellierungstool zur Erstellung von tabellarischen Analysis Services-Modellen auf Unternehmensebene.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. Analysis Services-Projekterweiterungen werden von allen Visual Studio 2017- und späteren Editionen unterstützt, wie z.B. der kostenlosen Community-Edition.Analysis Services projects extensions are supported on all Visual Studio 2017 and later editions, including the free Community edition. Für die Bereitstellung von tabellarischen Modellen in einem Premium-Arbeitsbereich ist die Erweiterungsversion 2.9.6 oder höher erforderlich.Extension version 2.9.6 or higher is required to deploy tabular models to a Premium workspace. Beim Einsatz in einem Premium-Arbeitsbereich muss das Modell den Kompatibilitätsgrad 1500 oder höher aufweisen.When deploying to a Premium workspace, the model must be at the 1500 or higher compatibility level. Für die Datasets ist XMLA-Lese-/Schreibzugriff erforderlich.XMLA read-write is required on the datasets workload. Weitere Informationen finden Sie unter Tools für Analysis Services.To learn more, see Tools for Analysis Services.

SQL Server Management Studio (SSMS)   – unterstützt DAX-, MDX- und XMLA-Abfragen.SQL Server Management Studio (SSMS) - Supports DAX, MDX, and XMLA queries. Führen Sie mit der Tabular Model Scripting Language (TMSL) präzise Aktualisierungsvorgänge und Skripterstellungen für Datasetmetadaten durch.Perform fine-grain refresh operations and scripting of dataset metadata by using the Tabular Model Scripting Language (TMSL). Für Abfragevorgänge ist Lesezugriff erforderlich.Read-only is required for query operations. Für das Erstellen von Metadatenskripts ist Lese-/Schreibzugriff erforderlich.Read-write is required for scripting metadata. Erfordert die SSMS-Version 18.4 oder höher.Requires SSMS version 18.4 or above. Hier herunterladen.Download here.

SQL Server Profiler  – Dieses mit SSMS installierte Tool ermöglicht das Verfolgen und Debuggen von Datasetereignissen.SQL Server Profiler – Installed with SSMS, this tool provides tracing and debugging of dataset events. Trotz der offiziellen Einstufung als veraltet für SQL Server ist der Profiler auch weiterhin in SSMS enthalten und wird für Analysis Services und Power BI Premium weiterhin unterstützt.While officially deprecated for SQL Server, Profiler continues to be included in SSMS and remains supported for Analysis Services and Power BI Premium. XMLA-Lesezugriff ist erforderlich.XMLA read-only is required. Weitere Informationen finden Sie unter  SQL Server Profiler für Analysis Services.To learn more, see SQL Server Profiler for Analysis Services.

Bereitstellungs-Assistent für Analysis Services  – Dieses mit SSMS installierte Tool ermöglicht die Bereitstellung von mit Visual Studio erstellten Projekten mit tabellarischen Modellen in Analysis Services und Power BI Premium-Arbeitsbereichen.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. Er kann interaktiv oder über die Befehlszeile zur automatischen Ausführung gestartet werden.It can be run interactively or from the command line for automation. XMLA-Schreib-/Lesezugriff ist erforderlich.XMLA read-write is required. Weitere Informationen finden Sie unter Bereitstellungs-Assistent für Analysis Services.To learn more, see Analysis Services Deployment Wizard.

PowerShell-Cmdlets  – Analysis Services-Cmdlets können zur Automatisierung von Dataset-Verwaltungsaufgaben wie Aktualisierungsvorgängen verwendet werden.PowerShell cmdlets – Analysis Services cmdlets can be used to automate dataset management tasks like refresh operations. XMLA-Schreib-/Lesezugriff ist erforderlich.XMLA read-write is required. Version 21.1.18221 oder höher des SqlServer-PowerShell-Moduls ist erforderlich.Version 21.1.18221 or higher of the SqlServer PowerShell module is required. Die Azure Analysis Services-Cmdlets im Az.AnalysisServices-Modul werden für Power BI Premium nicht unterstützt.Azure Analysis Services cmdlets in the Az.AnalysisServices module are not supported for Power BI Premium. Einzelheiten dazu finden Sie unter PowerShell-Referenz zu Analysis Services.To learn more, see Analysis Services PowerShell Reference.

Power BI-Berichts-Generator  – Ein Tool, das für das Erstellen von paginierten Berichten verwendet wird.Power BI Report Builder - A tool for authoring paginated reports. Erstellen Sie eine Berichtsdefinition, die angibt, welche Daten abgerufen werden sollen, wo Sie abgerufen werden können und wie sie angezeigt werden sollen.Create a report definition that specifies what data to retrieve, where to get it, and how to display it. Sie können eine Vorschau Ihres Berichts im Berichts-Generator anzeigen und dann im Power BI-Dienst veröffentlichen.You can preview your report in Report Builder and then publish your report to the Power BI service. XMLA-Lesezugriff ist erforderlich.XMLA read-only is required. Weitere Informationen finden Sie unter  Power BI-Berichts-Generator.To learn more, see Power BI Report Builder.

Tabellen-Editor – Ein Open-Source-Tool zur Erstellung, Bearbeitung und Verwaltung tabellarischer Modelle mit einem intuitiven, benutzerfreundlichen Editor.Tabular Editor - An open-source tool for creating, maintaining, and managing tabular models using an intuitive, lightweight editor. Eine hierarchische Ansicht zeigt alle Objekte in Ihrem tabellarischen Modell.A hierarchical view shows all objects in your tabular model. Objekte sind in Anzeigeordnern mit Unterstützung für die Bearbeitung mehrerer ausgewählter Eigenschaften und die Hervorhebung der DAX-Syntax organisiert.Objects are organized by display folders with support for multi-select property editing and DAX syntax highlighting. Für Abfragevorgänge ist XMLA-Lesezugriff erforderlich.XMLA read-only is required for query operations. Für Metadatenvorgänge ist Lese-/Schreibzugriff erforderlich.Read-write is required for metadata operations. Weitere Informationen erhalten Sie unter tabulareditor.github.io.To learn more, see tabulareditor.github.io.

DAX Studio  – Ein Open-Source-Tool für die Erstellung, Diagnose, Leistungsoptimierung und Analyse von DAX.DAX Studio – An open-source tool for DAX authoring, diagnosis, performance tuning, and analysis. Zu den Features gehören Objektsuche, Integrierte Ablaufverfolgung, Aufschlüsselung der Abfrageausführung mit detaillierten Statistiken, Hervorhebung und Formatierung der DAX-Syntax.Features include object browsing, integrated tracing, query execution breakdowns with detailed statistics, DAX syntax highlighting and formatting. Für Abfragevorgänge ist XMLA-Lesezugriff erforderlich.XMLA read-only is required for query operations. Weitere Informationen finden Sie unter  daxstudio.org.To learn more, see daxstudio.org.

ALM-Toolkit – Ein Open-Source-Schemavergleichstool für Power BI-Datasets, das am häufigsten für ALM-Szenarios (Application Lifecycle Management) verwendet wird.ALM Toolkit - An open-source schema compare tool for Power BI datasets, most often used for application lifecycle management (ALM) scenarios. Führen Sie die Bereitstellung in verschiedenen Umgebungen durch und behalten Sie die inkrementelle Aktualisierung der Verlaufsdaten bei.Perform deployment across environments and retain incremental refresh historical data. Vergleichen Sie Metadatendateien, Branches und Repositorys und führen Sie sie zusammen.Diff and merge metadata files, branches and repos. Verwenden Sie gängige Definitionen zwischen den einzelnen Datasets wieder.Reuse common definitions between datasets. Für Abfragevorgänge ist Lesezugriff erforderlich.Read-only is required for query operations. Für Metadatenvorgänge ist Lese-/Schreibzugriff erforderlich.Read-write is required for metadata operations. Weitere Informationen finden Sie unter  alm-toolkit.com.To learn more, see alm-toolkit.com.

Microsoft Excel  – Excel-Pivottabellen sind eines der gängigsten Tools, mit denen Sie Übersichtsdaten aus Power BI-Datasets zusammenfassen, analysieren, untersuchen und darstellen können.Microsoft Excel – Excel PivotTables are one of the most common tools used to summarize, analyze, explore, and present summary data from Power BI datasets. Für Abfragevorgänge ist Lesezugriff erforderlich.Read-only is required for query operations. Klick-und-Los-Version 16.0.11326.10000 oder höher von Office ist erforderlich.Click-to-Run version of Office 16.0.11326.10000 or higher is required.

Drittanbieter  – Dazu gehören Clientanwendungen zur Datenvisualisierung und Tools, mit denen Verbindungen zu Datasets in Power BI Premium hergestellt, diese abgefragt und verbraucht werden können.Third party - Includes client data visualization applications and tools that can connect to, query, and consume datasets in Power BI Premium. Für die meisten Tools sind die aktuellsten Versionen der MSOLAP-Clientbibliotheken erforderlich, für einige jedoch möglicherweise ADOMD.Most tools require the latest versions of MSOLAP client libraries, but some may use ADOMD. Der XMLA-Endpunkt mit Lese- oder Lese-/Schreibzugriff hängt von den Vorgängen ab.Read-only or read-write XMLA Endpoint is dependent on the operations.

ClientbibliothekenClient libraries

Clientanwendungen kommunizieren nicht direkt mit dem XMLA-Endpunkt.Client applications don't communicate directly with the XMLA endpoint. Stattdessen verwenden sie Clientbibliotheken als Abstraktionsschicht.Instead, they use client libraries as an abstraction layer. Dies sind die gleichen Clientbibliotheken, die von den Anwendungen zur Verbindung mit Azure Analysis Services und SQL Server Analysis Services verwendet werden.These are the same client libraries applications use to connect to Azure Analysis Services and SQL Server Analysis Services. Microsoft-Anwendungen wie Excel, SQL Server Management Studio (SSMS) und Analysis Services-Projekterweiterungen für Visual Studio installieren alle drei Clientbibliotheken und aktualisieren sie im Rahmen der regulären Anwendungs- und Erweiterungsupdates.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. Entwickler können auch die Clientbibliotheken verwenden, um benutzerdefinierte Anwendungen zu erstellen.Developers can also use the client libraries to build custom applications. In manchen Fällen, insbesondere bei der Arbeit mit Drittanbieteranwendungen, müssen möglicherweise neuere Versionen der Clientbibliotheken installiert werden, falls diese nicht mit der Anwendung installiert wurden.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. Clientbibliotheken werden monatlich aktualisiert.Client libraries are updated monthly. Weitere Informationen finden Sie unter  Clientbibliotheken zum Herstellen einer Verbindung mit Analysis Services.To learn more, see Client libraries for connecting to Analysis Services.

Optimieren von Datasets für Schreibvorgänge durch Aktivieren von großen ModellenOptimize datasets for write operations by enabling large models

Es wird empfohlen, bei der Verwendung des XMLA-Endpunkts für die Verwaltung von Datasets mit Schreibvorgängen das Dataset für große Modelle zu aktivieren.When using the XMLA endpoint for dataset management with write operations, it's recommended you enable the dataset for large models. Dadurch wird der Aufwand von Schreibvorgängen reduziert, wodurch diese erheblich beschleunigt werden.This reduces the overhead of write operations, which can make them considerably faster. Bei Datasets mit einer Größe von mehr als 1 GB (nach der Komprimierung) kann dies einen erheblichen Unterschied ausmachen.For datasets over 1 GB in size (after compression), the difference can be significant. Weitere Informationen finden Sie unter Große Modelle in Power BI Premium.To learn more, see Large models in Power BI Premium.

Aktivieren von XMLA-Lese-/SchreibzugriffEnable XMLA read-write

Standardmäßig ist bei einer Premium-Kapazität die Einstellung der Eigenschaften für XMLA-Endpunkte auf Lesezugriff gesetzt.By default, a Premium capacity has the XMLA Endpoint property setting enabled for read-only. Das bedeutet, dass Anwendungen nur ein Dataset abfragen können.This means applications can only query a dataset. Damit Anwendungen Schreibvorgänge ausführen können, muss für den XMLA-Endpunkt der Lese-/Schreibzugriff zunächst über die Eigenschaft aktiviert werden.For applications to perform write operations, the XMLA Endpoint property must be enabled for read-write. Die Einstellung der Eigenschaft für den XMLA-Endpunkt für diese Kapazität können Sie in der Datasetworkload vornehmen.The XMLA Endpoint property setting for a capacity is configured in the Datasets workload. Die Einstellung des XMLA-Endpunkts gilt für alle Arbeitsbereiche und Datasets, die dieser Kapazität zugewiesen sind.The XMLA Endpoint setting applies to all workspaces and datasets assigned to the capacity.

So aktivieren Sie den Lese-/Schreibzugriff für eine KapazitätTo enable read-write for a capacity

  1. Klicken Sie im Verwaltungsportal auf Kapazitätseinstellungen > Power BI Premium, und wählen Sie dann den Kapazitätsnamen aus.In the Admin portal, click Capacity settings > Power BI Premium > capacity name.

  2. Erweitern Sie Workloads.Expand Workloads. Wählen Sie in der Einstellung XMLA-Endpunkt die Option Lesen Schreiben aus.In the XMLA Endpoint setting, select Read Write.

    Aktivieren des XMLA-Endpunkts

Herstellen einer Verbindung mit einem Premium-ArbeitsbereichConnecting to a Premium workspace

Arbeitsbereiche, die einer Kapazität zugewiesen sind, weisen eine Verbindungszeichenfolge im URL-Format auf, z. B.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].

Anwendungen, die eine Verbindung mit dem Arbeitsbereich herstellen, verwenden die URL gewissermaßen als Analysis Services-Servernamen.Applications connecting to the workspace use the URL as it were an Analysis Services server name. Beispiel:For example,
powerbi://api.powerbi.com/v1.0/contoso.com/Sales Workspace.powerbi://api.powerbi.com/v1.0/contoso.com/Sales Workspace.

Benutzer mit UPNs im gleichen Mandanten (nicht B2B) können den Namen des Mandanten durch myorg ersetzen.Users with UPNs in the same tenant (not B2B) can replace the tenant name with myorg. Beispiel:   powerbi://api.powerbi.com/v1.0/myorg/Sales Workspace.For example,  powerbi://api.powerbi.com/v1.0/myorg/Sales Workspace.

B2B-Benutzer müssen den UPN ihrer Organisation im Mandantennamen angeben.B2B users must specify their organization UPN in tenant name. Beispiel:For example,
powerbi://api.powerbi.com/v1.0/fabrikam.com/Sales Workspace.powerbi://api.powerbi.com/v1.0/fabrikam.com/Sales Workspace.

So rufen Sie die Arbeitsbereichverbindungs-URL abTo get the workspace connection URL

Klicken Sie im Arbeitsbereich auf Einstellungen > Premium > Arbeitsbereichsverbindung und dann auf Kopieren.In workspace Settings > Premium > Workspace Connection, click Copy.

Arbeitsbereichs-Verbindungszeichenfolge

VerbindungsanforderungenConnection requirements

AnfangskatalogInitial catalog

Bei einigen Tools, wie etwa SQL Server Profiler, müssen Sie möglicherweise einen Anfangskatalog angeben.With some tools, such as SQL Server Profiler, you may need to specify an Initial Catalog. Geben Sie ein Dataset (eine Datenbank) in Ihrem Arbeitsbereich an.Specify a dataset (database) in your workspace. Geben Sie im Dialogfeld Mit Server verbinden unter Optionen > Verbindungseigenschaften > Mit Datenbank verbinden den Namen des Datasets ein.In the Connect to Server dialog, click Options > Connection Properties > Connect to database, enter the dataset name.

Doppelte ArbeitsbereichsnamenDuplicate workspace names

Neue Arbeitsbereiche (erstellt mithilfe der neuen Arbeitsbereichsfunktion) in Power BI erzwingen eine Prüfung, um das Erstellen oder Umbenennen von Arbeitsbereichen mit doppelten Namen zu unterbinden.New workspaces (created using the new workspace experience) in Power BI impose validation to disallow creation or renaming workspaces with duplicate names. Arbeitsbereiche, die nicht migriert wurden, können zu doppelten Namen führen.Workspaces that have not been migrated can result in duplicate names. Beim Herstellen einer Verbindung mit einem Arbeitsbereich, der den gleichen Namen wie ein anderer Arbeitsbereich aufweist, wird möglicherweise der folgende Fehler angezeigt:When connecting to a workspace with the same name as another workspace, you may get the following error:

Verbindung zu „powerbi://api.powerbi.com/v1.0/[Name des Mandanten]/[Name des Arbeitsbereichs] kann nicht hergestellt werden.“Cannot connect to powerbi://api.powerbi.com/v1.0/[tenant name]/[workspace name].

Um diesen Fehler zu umgehen, geben Sie über den Namen des Arbeitsbereichs hinaus die ObjectIDGuid ein, die Sie aus der objectID des Arbeitsbereichs in die URL kopieren können.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. Fügen Sie die objectID an die Verbindungs-URL an.Append the objectID to the connection URL. Beispiel:For example,
„powerbi://api.powerbi.com/v1.0/myorg/Contoso Vertrieb - 9d83d204-82a9-4b36-98f2-a40099093830“'powerbi://api.powerbi.com/v1.0/myorg/Contoso Sales - 9d83d204-82a9-4b36-98f2-a40099093830'.

Doppelter DatasetnameDuplicate dataset name

Beim Herstellen der Verbindung mit einem Dataset mit dem gleichen Namen wie ein weiteres Dataset im selben Arbeitsbereich fügen Sie die Dataset-Guid an den Namen des Datasets an.When connecting to a dataset with the same name as another dataset in the same workspace, append the dataset guid to the dataset name. Sie können sowohl den Namen des Datasets als auch seine GUID abrufen, wenn eine Verbindung mit dem Arbeitsbereich in SSMS besteht.You can get both dataset name and guid when connected to the workspace in SSMS.

Verzögerung bei der Anzeige von DatasetsDelay in datasets shown

Bei Verbindungen mit einem Arbeitsbereich kann es bis zu 5 Minuten dauern, bis Änderungen aus neuen, gelöschten und umbenannten Datasets angezeigt werden.When connecting to a workspace, changes from new, deleted, and renamed datasets can take up to a few minutes to appear.

Nicht unterstützte DatasetsUnsupported datasets

Auf die folgenden Datasets kann nicht von XMLA-Endpunkten aus zugegriffen werden.The following datasets are not accessible by the XMLA endpoint. Diese Datasets werden in SSMS oder anderen Tools nicht unter dem Arbeitsbereich angezeigt:These datasets will not appear under the workspace in SSMS or in other tools:

  • Datasets, die auf einer Liveverbindung mit einem Azure Analysis Services- oder SQL Server Analysis Services-Modell basieren.Datasets based on a live connection to an Azure Analysis Services or SQL Server Analysis Services model.
  • Datasets, die auf einer Liveverbindung mit einem Power BI-Dataset in einem anderen Arbeitsbereich basieren.Datasets based on a live connection to a Power BI dataset in another workspace. Weitere Informationen finden Sie unter Einführung in die Verwendung von Datasets in mehreren Arbeitsbereichen.To learn more, see Intro to datasets across workspaces.
  • Datasets mit Push-Datenübertragung mithilfe der REST-API.Datasets with Push data by using the REST API.
  • Datasets in Excel-Arbeitsmappen.Excel workbook datasets.

SicherheitSecurity

Zusätzlich zur Aktivierung der Eigenschaft des XMLA-Endpunkts durch den Kapazitätsadministrator muss die Einstellung Daten exportieren auf Mandantenebene im Power BI-Verwaltungsportal, die auch für die Analyse in Excel erforderlich ist, aktiviert werden.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.

Aktivieren der Option „Daten exportieren“

Beim Zugriff über den XMLA-Endpunkt wird die auf Arbeitsbereichs-/Anwendungsebene festgelegte Mitgliedschaft in der Sicherheitsgruppe berücksichtigt.Access through the XMLA endpoint will honor security group membership set at the workspace/app level.

Mitwirkende im Arbeitsbereich und höhere Berechtigungen haben Schreibzugriff auf das Dataset und sind daher mit den Analysis Services-Datenbankadministratoren gleichgestellt.Workspace contributors and above have write access to the dataset and are therefore equivalent to Analysis Services database admins. Sie können neue Datasets aus Visual Studio bereitstellen und TMSL-Skripts in SSMS ausführen.They can deploy new datasets from Visual Studio and execute TMSL scripts in SSMS.

Vorgänge, die Analysis Services Server-Administrationsberechtigungen (statt Datenbankadministration) erfordern, wie z.B. Ablaufverfolgung auf Serverebene und Identitätswechsel von Benutzern unter Verwendung der Eigenschaft EffectiveUserName für Verbindungszeichenfolgen, werden derzeit in Power BI Premium nicht unterstützt.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.

Andere Benutzer, die über eine Berechtigung „Erstellen“ für ein Dataset verfügen, sind mit Analysis Services-Datenbanklesern gleichgestellt.Other users who have Build permission on a dataset are equivalent to Analysis Services database readers. Sie können eine Verbindung mit Datasets herstellen und Daten für die Nutzung und Visualisierung durchsuchen.They can connect to and browse datasets for data consumption and visualization. Regeln für die Sicherheit auf Zeilenebene (Row-Level Security, RLS) werden berücksichtigt, und es werden keine internen Datasetmetadaten angezeigt.Row-level security (RLS) rules are honored and they cannot see internal dataset metadata.

ModellrollenModel roles

Mithilfe des XMLA-Endpunkts können Rollen für ein Dataset, Rollenmitgliedschaften für Azure Active Directory-Benutzer (Azure AD) und Filter für die Sicherheit auf Zeilenebene (Row-Level Security, RLS) definiert werden.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. Modellrollen in Power BI werden nur für RLS verwendet.Model roles in Power BI are used only for RLS. Verwenden Sie das Power BI-Sicherheitsmodell, um Berechtigungen über RLS hinaus zu steuern.Use the Power BI security model to control permissions beyond RLS.

Für Tabellenmodellprojekte, die in Visual Studio erstellt werden, können Rollen mithilfe des Rollen-Managers im Modell-Designer definiert werden.For tabular model projects being authored in Visual Studio, roles can be defined by using Role Manager in the model designer. Für Datasets in Power BI können Rollen mithilfe von SSMS definiert werden, um Rollenobjekte zu erstellen und Rolleneigenschaften zu definieren.For datasets in Power BI, roles can be defined by using SSMS to create role objects and define role properties. In den meisten Fällen können jedoch mithilfe von TMSL Skripts für Rollenobjektdefinitionen erstellt werden, um das Rollenobjekt zu erstellen oder zu bearbeiten.In most cases, however, role object definitions can be scripted by using TMSL to create or modify the Roles object. TMSL-Skripts können in SSMS oder über das PowerShell-Cmdlet Invoke-ASCmd ausgeführt werden.TMSL scripts can be executed in SSMS or with the Invoke-ASCmd PowerShell cmdlet.

Beim Arbeiten mit Datasetrollen über den XMLA-Endpunkt gelten die folgenden Einschränkungen:The following limitations apply when working with dataset roles through the XMLA endpoint:

  • Die einzige Berechtigung für eine Rolle, die für Power BI-Datasets festgelegt werden kann, ist die Leseberechtigung.The only permission for a role that can be set for Power BI datasets is the Read permission. Andere Berechtigungen werden über des Power BI-Sicherheitsmodell erteilt.Other permissions are granted using the Power BI security model.
  • Für den Lesezugriff über den XMLA-Endpunkt ist eine Berechtigung zum Erstellen eines Datasets erforderlich, unabhängig davon, ob Datasetrollen vorhanden sind.Build permission for a dataset is required for read access through the XMLA endpoint, regardless of the existence of dataset roles.
  • Regeln für die Sicherheit auf Objektebene (Object-Level Security, OLS) werden in Power BI derzeit nicht unterstützt.Object-level security (OLS) rules are currently not supported in Power BI.

Weitere Informationen finden Sie unter Rollen in tabellarischen Modellen.To learn more, see Roles in tabular models.

Festlegen der Anmeldeinformationen für DatenquellenSetting data-source credentials

Über den XMLA-Endpunkt spezifizierte Metadaten können Verbindungen zu Datenquellen herstellen, aber keine Anmeldeinformationen für die Datenquellen festlegen.Metadata specified through the XMLA endpoint can create connections to data sources, but cannot set data-source credentials. Stattdessen können die Anmeldeinformationen auf der Seite für die Dataseteinstellungen im Power BI-Dienst festgelegt werden.Instead, credentials can be set in the dataset settings page in the Power BI Service.

DienstprinzipaleService principals

Dienstprinzipale sind eine App-Registrierung in Azure Active Directory, die Sie in Ihrem Mandanten erstellen, um unbeaufsichtigte Vorgänge auf Ressourcen- und Dienstebene auszuführen.Service principals are an Azure Active Directory app registration you create within your tenant to perform unattended resource and service level operations. Es handelt sich dabei um eine besondere Art von Benutzeridentität mit einem App-Namen, einer Anwendungs-ID und einer Mandanten-ID sowie einem geheimen Clientschlüssel oder Zertifikat als Kennwort.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 verwendet dieselbe Dienstprinzipalfunktion wie Power BI Embedded.Power BI Premium uses the same service principal functionality as Power BI Embedded.

In Power BI Premium können Dienstprinzipale auch mit dem XMLA-Endpunkt verwendet werden. So können Dataset-Verwaltungsaufgaben wie das Bereitstellen von Arbeitsbereichen und Modellen sowie das Aktualisieren von Datasets automatisiert werden mit: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
  • Benutzerdefinierten ClientanwendungenCustom client applications

Weitere Informationen finden Sie unter Automatisieren von Arbeitsbereichs- und Datasetaufgaben in Power BI Premium mithilfe von Dienstprinzipalen.To learn more, see Automate Premium workspace and dataset tasks with service principals.

Bereitstellen von Modellprojekten aus Visual Studio (SSDT)Deploy model projects from Visual Studio (SSDT)

Die Bereitstellung eines tabellarischen Modellprojekts in Visual Studio für einen Power BI Premium-Arbeitsbereich entspricht in etwa der Bereitstellung auf einem Azure- oder SQL Server Analysis Services-Server.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. Die einzigen Unterschiede bestehen in der für das Projekt angegebenen Bereitstellungsservereigenschaft und darin, wie die Anmeldeinformationen für die Datenquelle angegeben werden, damit Verarbeitungsvorgänge Daten aus Datenquellen in das neue Dataset im Arbeitsbereich importieren können.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.

Um ein in Visual Studio erstelltes tabellarisches Modellprojekt bereitzustellen, müssen Sie zunächst die Verbindungs-URL des Arbeitsbereichs in der Eigenschaft Bereitstellungsserver des Projekts festlegen.To deploy a tabular model project authored in Visual Studio, you must first set the workspace connection URL in the project Deployment Server property. Klicken Sie in Visual Studio im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt, und wählen Sie Eigenschaften aus.In Visual Studio, in Solution Explorer, right-click the project > Properties. Fügen Sie in der Eigenschaft Server die Arbeitsbereichverbindungs-URL ein.In the Server property, paste the workspace connection URL.

Bereitstellungseigenschaft

Wenn die Eigenschaft „Bereitstellungsserver“ angegeben wurde, kann das Projekt bereitgestellt werden.When the Deployment Server property has been specified, the project can then be deployed.

Bei der erstmaligen Bereitstellung wird im Arbeitsbereich mithilfe von Metadaten aus der model.bim-Datei ein Dataset erstellt.When deployed the first time, a dataset is created in the workspace by using metadata from the model.bim. Im Rahmen des Bereitstellungsvorgangs schlägt nach der Erstellung des Datasets im Arbeitsbereich aus den Modell-Metadaten die Verarbeitung zum Laden von Daten aus Datenquellen in das Dataset fehl.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.

Bei der Verarbeitung tritt ein Fehler auf, da bei der Bereitstellung in einer Azure- oder SQL Server Analysis-Serverinstanz, wo die Anmeldeinformationen für die Datenquelle als Teil des Bereitstellungsvorgangs abgefragt werden, im Gegensatz zur Bereitstellung in einem Premium-Arbeitsbereich die Anmeldeinformationen für die Datenquelle nicht als Teil des Bereitstellungsvorgangs angegeben werden können.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. Stattdessen werden nach der erfolgreichen Bereitstellung von Metadaten und der Erstellung des Datasets die Anmeldeinformationen für die Datenquelle im Power BI-Dienst in den Einstellungen des Datasets angegeben.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. Klicken Sie im Arbeitsbereich auf Datasets > Einstellungen > Anmeldeinformationen für Quelle > Anmeldeinformationen bearbeiten.In the workspace, click Datasets > Settings > Data source credentials > Edit credentials.

Anmeldeinformationen für die Datenquelle

Wenn die Anmeldeinformationen für die Datenquelle festgelegt sind, können Sie dann das Dataset im Power BI-Dienst aktualisieren, die zeitgesteuerte Aktualisierung konfigurieren oder die Verarbeitung über SQL Server Management Studio durchführen, um Daten in das Dataset zu laden.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.

Die im Projekt in Visual Studio spezifizierte Bereitstellungseigenschaft Verarbeitungsoption wird berücksichtigt.The deployment Processing Option property specified in the project in Visual Studio is observed. Wenn jedoch für eine Datenquelle noch keine Anmeldeinformationen im Power BI-Dienst angegeben wurden, schlägt die Verarbeitung selbst dann fehl, wenn die Bereitstellung der Metadaten erfolgreich ist.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. Sie können die Eigenschaft auf Nicht verarbeiten setzen, wodurch ein Versuch der Verarbeitung im Rahmen der Bereitstellung verhindert wird. Sie können die Eigenschaft jedoch auch wieder auf Standard setzen, da die Verarbeitung im Rahmen nachfolgender Bereitstellungsvorgänge erfolgreich ist, sobald die Anmeldeinformationen für die Datenquelle in deren Einstellungen für das neue Dataset angegeben sind.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.

Herstellen einer Verbindung mit SSMSConnect with SSMS

Die Verwendung von SSMS zur Verbindung mit einem Arbeitsbereich ähnelt einer Verbindung mit einem Azure- oder SQL Server Analysis Services-Server.Using SSMS to connect to a workspace is just like connecting to an Azure or SQL Server Analysis Services server. Der einzige Unterschied besteht darin, dass Sie die Arbeitsbereichs-URL im Servernamen angeben, und Sie müssen die Authentifizierung Active Directory: universell mit MFA verwenden.The only difference is you specify the workspace URL in server name, and you must use Active Directory - Universal with MFA authentication.

Herstellen einer Verbindung mit einem Arbeitsbereich mithilfe von SSMSConnect to a workspace by using SSMS

  1. Klicken Sie in SQL Server Management Studio auf Verbinden > Verbindung mit Server herstellen.In SQL Server Management Studio, click Connect > Connect to Server.

  2. Wählen Sie unter Servertyp die Option Analysis Services aus.In Server Type, select Analysis Services. Geben Sie in Servername die Arbeitsbereichs-URL ein.In Server name, enter the workspace URL. Wählen Sie in Authentifizierung die Option Active Directory: universell mit MFA aus, und geben Sie dann in Benutzername Ihre Organisationsbenutzer-ID ein.In Authentication, select Active Directory - Universal with MFA, and then in User name, enter your organizational user ID.

    Herstellen einer Verbindung in SSMS

Bei hergestellter Verbindung wird der Arbeitsbereich als Analysis Services-Server angezeigt, und im Arbeitsbereich vorhandene Datasets werden als Datenbanken angezeigt.When connected, the workspace is shown as an Analysis Services server, and datasets in the workspace are shown as databases.

SSMS

Weitere Informationen über die Verwendung von SSMS zur Erstellung von Metadaten finden Sie unter Erstellen von Analysis Services-Skripts und Tabular Model Scripting Language (TMSL).To learn more about using SSMS to script metadata, see Create Analysis Services scripts and Tabular Model Scripting Language (TMSL).

DatasetaktualisierungDataset refresh

Der XMLA-Endpunkt ermöglicht eine Vielzahl von Szenarios für detaillierte Aktualisierungsfunktionen mit SSMS, Automatisierung mit PowerShell, Azure Automation und Azure Functions mit 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. Sie können z.B. bestimmte inkrementelle Aktualisierungen von historischen Partitionen vornehmen, ohne alle Verlaufsdaten neu laden zu müssen.You can, for example, refresh certain incremental refresh historical partitions without having to reload all historical data.

Anders als bei der Konfiguration von Aktualisierungen im Power BI-Dienst sind Aktualisierungsvorgänge über den XMLA-Endpunkt nicht auf 48 Aktualisierungen pro Tag beschränkt. Außerdem gilt der Timeout für geplante Aktualisierungen nicht.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.

Dynamische Verwaltungssichten (Dynamic Management Views, DMVs)Dynamic Management Views (DMV)

Analysis Services DMVs ermöglichen die Sichtbarkeit von Metadaten, der Datenherkunft und der Ressourcennutzung von Datensets.Analysis Services DMVs provide visibility of dataset metadata, lineage, and resource usage. DMVs, die für Abfragen in Power BI über den XMLA-Endpunkt verfügbar sind, beschränken sich höchstens auf diejenigen, die Datenbankadministratorberechtigungen erfordern.DMVs available for querying in Power BI through the XMLA endpoint are limited to, at most, those that require database-admin permissions. Auf manche DMVs kann beispielsweise nicht zugegriffen werden, weil sie Administratorberechtigungen für Analysis Services-Server benötigen.Some DMVs for example are not accessible because they require Analysis Services server-admin permissions.

Erstellte Power BI Desktop-DatasetsPower BI Desktop authored datasets

Erweiterte MetadatenEnhanced metadata

XMLA-Schreibvorgänge für Datasets, die in Power BI Desktop erstellt und in einem Premium-Arbeitsbereich veröffentlicht wurden und erweiterte Metadaten erfordern, sind aktiviert.XMLA write operations on datasets authored in Power BI Desktop and published to a Premium workspace require enhanced metadata is enabled. Weitere Informationen finden Sie unter Aktivieren erweiterter Datasetmetadaten.To learn more, see Enhanced dataset metadata.

Achtung

Zu diesem Zeitpunkt verhindert ein Schreibvorgang für ein in Power BI Desktop erstelltes Dataset, dass es als PBIX-Datei wieder heruntergeladen wird.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. Stellen Sie sicher, dass Sie die ursprüngliche PBIX-Datei beibehalten.Be sure to retain your original PBIX file.

DatenquellendeklarationData-source declaration

Bei der Verbindung mit Datenquellen und der Abfrage von Daten verwendet Power BI Desktop Power Query M-Ausdrücke als Inline-Datenquellendeklarationen.When connecting to data sources and querying data, Power BI Desktop uses Power Query M expressions as inline data source declarations. Zwar wird die Inline-Datenquellendeklaration von Power Query M in Power BI Premium-Arbeitsbereichen unterstützt, jedoch nicht von Azure Analysis Services oder 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. Stattdessen erstellen Analysis Services-Datenmodellierungstools wie Visual Studio Metadaten mithilfe von strukturierten und/oder Anbieter-Datenquellendeklarationen.Instead, Analysis Services data modeling tools like Visual Studio create metadata using structured and/or provider data source declarations. Mit dem XMLA-Endpunkt unterstützt Power BI Premium auch strukturierte und Anbieterdatenquellen, jedoch nicht als Teil von Power Query M-Inline-Datenquellendeklarationen in Power BI Desktop-Modellen.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. Weitere Informationen finden Sie unter Grundlegendes zu Anbietern.To learn more, see Understanding providers.

Power BI Desktop im LiveverbindungsmodusPower BI Desktop in live connect mode

Power BI Desktop kann über eine Liveverbindung mit einem Power BI Premium-Dataset verbunden werden.Power BI Desktop can connect to a Power BI Premium dataset using a live connection. Wird eine Liveverbindung verwendet, müssen die Daten nicht lokal repliziert werden. Dadurch wird es für Benutzer einfacher, Semantikmodelle zu verwenden.When using a live connection, data doesn't need to be replicated locally, making it easier for users to consume semantic models. Es gibt zwei Möglichkeiten, wie Benutzer eine Verbindung herstellen können:There are two ways users can connect:

Durch Auswählen von Power BI-Datasets und dann Auswählen eines Datasets, um einen Bericht zu erstellen.By selecting Power BI datasets, and then selecting a dataset to create a report. Dies ist die empfohlene Vorgehensweise für Benutzer, um Liveverbindungen mit Datasets herzustellen.This is the recommended way for users to connect live to datasets. Diese Methode bietet eine verbesserte Erkundungsumgebung, die den Zustimmungsgrad von Datasets zeigt.This method provides an improved discover experience showing the endorsement level of datasets. Benutzer müssen keine Arbeitsbereichs-URLs finden und nachverfolgen.Users don't need to find and keep track of workspace URLs. Um ein Dataset zu finden, geben Benutzer einfach den Datasetnamen ein, oder sie scrollen, bis sie das gesuchte Dataset gefunden haben.To find a dataset, users simply type in the dataset name or scroll to find the dataset they're looking for.

Herstellen einer Liveverbindung mit einem Dataset

Die andere Möglichkeit zur Herstellung einer Verbindung besteht darin, Daten abrufen > Analysis Services zu verwenden, den Namen eines Power BI Premium-Arbeitsbereichs als URL anzugeben, Live verbinden auszuwählen und dann im Navigator ein Dataset auszuwählen.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 . In diesem Fall verwendet Power BI Desktop den XMLA-Endpunkt, um eine Liveverbindung mit dem Dataset so herzustellen, als wäre dieses ein Analysis Services-Datenmodell.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.

Herstellen einer Liveverbindung mit Analysis Services

Organisationen, in denen mit Berichten gearbeitet wird, die über Liveverbindungen mit Analysis Services-Datenmodellen verbunden sind, und die beabsichtigen, zu Power BI Premium-Datasets zu migrieren, müssen nur die Servername-URL in Daten transformieren > Datenquelleneinstellungen ändern.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.

ÜberwachungsprotokolleAudit logs

Wenn Anwendungen eine Verbindung mit einem Arbeitsbereich herstellen, wird der Zugriff über XMLA-Endpunkte in den Power BI-Überwachungsprotokollen mit den folgenden Vorgängen protokolliert:When applications connect to a workspace, access through XMLA endpoints is logged in the Power BI audit logs with the following operations:

Anzeigename für VorgangOperation friendly name VorgangsnameOperation name
Verbunden mit Power BI-Dataset aus einer externen AnwendungConnected to Power BI dataset from an external application ConnectFromExternalApplicationConnectFromExternalApplication
Aktualisierung von mit Power BI-Dataset aus einer externen Anwendung angefordertRequested Power BI dataset refresh from an external application RefreshDatasetFromExternalApplicationRefreshDatasetFromExternalApplication
Power BI-Dataset aus einer externen Anwendung erstelltCreated Power BI dataset from an external application CreateDatasetFromExternalApplicationCreateDatasetFromExternalApplication
Power BI-Dataset aus einer externen Anwendung bearbeitetEdited Power BI dataset from an external application EditDatasetFromExternalApplicationEditDatasetFromExternalApplication
Power BI-Dataset aus einer externen Anwendung gelöschtDeleted Power BI dataset from an external application DeleteDatasetFromExternalApplicationDeleteDatasetFromExternalApplication

Weitere Informationen finden Sie unter  Power BI-Überwachung.To learn more, see Auditing Power BI.

Siehe auchSee also

Weitere Fragen?More questions? Stellen Sie Ihre Frage in der Power BI-Community.Try asking the Power BI Community