PowerBI-Metadatensammler

Der PowerBI-Metadatensammler bietet schreibgeschützten Zugriff auf Metadaten aus einem PowerBI-Account.

Leistung BI Ist eine Sammlung von Softwareservices, Apps und Connectors, die zusammenarbeiten, um nicht zugehörige Datenquellen in kohärente, visuell immersive und interaktive Einblicke umzuwandeln. Datenquellen können Excel-Tabellen, cloudbasierte Data Warehouses oder lokale Hybrid Data Warehouses umfassen. Mit Power BI können Sie eine Verbindung zu Datenquellen herstellen, wichtige Informationen visualisieren und erkennen und Einblicke in die gesamte Organisation teilen.

Der Power BI-Sammler sammelt Metadaten aus Power BI-Service-Arbeitsbereichen. Verwenden Sie gesammelte Metadaten, um Berichte und Dashboards in Arbeitsbereichen zu erkennen und Auswirkungsanalysen durchzuführen, um zu verstehen, wie sich Änderungen an vorgelagerten Datenquellen auf Power BI-Berichte auswirken.

Version unterstützt

Der Sammler unterstützt Power BI Cloud API V 1,0.

Authentifizierung unterstützt

Power BI unterstützt zwei Authentifizierungsmethoden:

• Service-Prinzipal
• Anwender und Passwort

Der Sammler sammelt Metadaten für alle Power BI-Apps und -Arbeitsbereiche, auf die der authentifizierte Account Zugriff hat.

Metadaten katalogisiert

Der Power BI-Sammler katalogisiert die folgenden Informationen:

Tabelle : 1. Metadaten erfasst

Objekt	Informationen erfasst
Arbeitsbereiche	Titel, Beschreibung
Apps	Titel, Beschreibung
Power BI-Messungen	Titel, Beschreibung, ist ausgeblendet, Ausdruck
Berichte	Titel, Berichtstyp, externe URL, URL einbetten, Vorschaubild (nicht unterstützt für paginierte Berichtstypen), Erstellungsdatum, zuletzt geändert, erstellt von, zuletzt geändert von, Beschreibungen
Berichtsseiten	Titelhinweis: Berichtsseiten in Apps können aufgrund von Einschränkungen in den Power BI-APIs bei Verwendung der Serviceprinzipalauthentifizierung nicht katalogisiert werden.
Dashboards	Titel, externe URL, Einbettungs-URL
Dashboard-Kacheln	Titel, Einbettungs-URL
Datenquellen	Titel, Datenquellentyp, Verbindungsdetails (Art und Pfad)
Semantisches Modell	Titel, externe URL, Beschreibung, Erstellungsdatum, erstellt von, Aktualisieren Sie Den Zeitplan
Datenflüsse	Titel, zuletzt geändert, Beschreibung, erstellt von, Zeitplan aktualisieren
Power BI-Tabellen (semantisches Modell und Datenflüsse)	Titel, ist ausgeblendet, wird „Daten“, „Beschreibung“, „Quellausdruck“ eingegeben
Berechnete BI-Tabelle für Leistung	Titel, ist ausgeblendet, wird „Daten“, „Beschreibung“, „Quellausdruck“ eingegeben
Power BI-Spalten	Titel, Beschreibungen, Datentyp, Spaltentyp, ist ausgeblendet, Ausdruck
Tabellendatei	Dateipfad, Dateiname
Dateiverzeichnis	Verzeichnispfad
Datenbank	Titel, Typ, Bezeichner, Server, Port
Datenbankschema	Titel
Datenbanktabelle	Titel
Datenbankspalte	Titel
Tabelle	Titel, Beschreibung
Spalte	Titel, Typ
Berechnungsgruppe	Titel, Beschreibung
Berechnungselement	Titel, Beschreibung, Ausdruck

Beziehungen zwischen Objekten

Katalogseiten zeigen Beziehungen zwischen den folgenden Daten-Asset-Typen an:

Tabelle : 2. Beziehungen zwischen katalogisierten Objekten

Daten-Asset-Seite	Beziehung
App	Bericht, Dashboard, Arbeitsbereich
Power BI-Spalte	Power BI-Tabelle
Datenquelle	Semantisches Modell, Datenfluss, tabellarische Datenquelle (Datenbank, Tabellendatei)
Kachel	Dashboard, Bericht, semantisches Modell
Dashboard	Kachel, Arbeitsbereich
Dashboard-Kachel	Zugehöriges semantisches Modell
Semantisches Modell	Dashboard-Kachel, Bericht
Bericht	Kachel, Arbeitsbereich, Berichtsseiten (gilt nicht für paginierte Berichtstypen), semantisches Modell (gilt nicht für paginierte Berichtstypen), Bericht Hinweis: In Power BI sind App-Berichte und die zugehörigen Arbeitsbereichsberichte zwei separate Berichte mit eindeutigen Berichts-IDs. Der Sammler katalogisiert die Beziehung zwischen ihnen.
Berichtsseiten	Bericht (gilt nicht für paginierte Berichtstypen)
Semantisches Modell	Kachel, Arbeitsbereich, Bericht, Tabelle, Datenquelle, semantisches Modell, Datenfluss
Arbeitsbereich	Bericht, semantisches Modell, Datenfluss, Dashboard, App
Datenfluss	Arbeitsbereich, Tabelle, Datenquelle, Datenfluss
Power BI-Tabelle	Semantisches Modell, Datenfluss, Leistung BI-Spalte, Leistung BI-Messung
BI-Messung für Leistung	Power BI-Tabelle
Tabellarische Datenquelle (Datenbank, Tabellendatei)	Datenquelle
Berechnungsgruppe	Power BI-Tabelle
Berechnungselement	Berechnungsgruppe

Herkunft für PowerBI

Die folgenden Abstammungsinformationen werden vom Power BI-Sammler erfasst. Der Sammler verwendet Power BI-Scanner-APIs Dient zum Einrichten der Herkunft zu Quelltabellen und -Spalten. Stellen Sie sicher, dass Sie sich mit vertraut machen Einschränkungen der Scanner-APIs

Tabelle : 3. Herkunft-Verfügbarkeit nach Objekt

Objekt	Herkunft verfügbar
Dashboard-Kachel	Zugehöriges semantisches Modell
Semantisches Modell	Zugeordneter Datenfluss, semantisches Modell
Datenfluss	Datenfluss
Power BI-Spalte	Zugeordnete Spalten, aus denen die Spalte ihre Daten bezieht oder ihre Werte berechnet. Hinweis: Herkunft kann aus Power BI-Ausdrücken erfasst werden, die Parameter anstelle von Server-, Schema-, Tabellen- oder Datenbanknamen verwenden. Herkunft und Katalogbeziehungen auf Tabellen- und Spaltenebene sind nicht zwischen Tabellen oder Spalten und Berichten über die Power BI-API verfügbar.
Power BI-Tabelle	Zugeordnete Tabellen, aus denen die Tabelle ihre Daten bezieht. Hinweis: Hinweis: Der Sammler verwendet von den APIs zurückgegebene Power BI-Ausdrücke, um die Herkunft zu den Quellspalten/-Tabellen zu analysieren.
Berechnete BI-Tabelle für Leistung	Power BI-Tabellen und -Spalten, aus denen die berechnete Tabelle ihre Werte ableitet.
BI-Messung für Leistung	Zugeordnete Spalten, aus denen die Messung die Daten bezieht

Die folgende Tabelle listet unterstützte und nicht unterstützte Tabellenvorgänge und -Transformationen auf. Dies umfasst Quellausdrücke, berechnete Spalten und Messausdrücke, die beim Sammeln von Stammdaten verwendet werden. Nicht aufgelistete Vorgänge werden nicht erfasst.

Tabelle : 4. Unterstützte Transformationen und Ausdrücke zum Sammeln von Metadaten zur Herkunft

Kategorie	Kategorie
Unterstützte Parametrisierte Ausdrücke	Der Sammler analysiert Quellausdrücke, die Parameter anstelle der folgenden Werte verwenden: Vollständige Quelle, Server oder Host, Warehouse, Datenbankname, Schemaname, Tabellenname und SQL-Ausdrücke.
Unterstützte Datenfunktionen	Csv.Dokument, Excel.Arbeitsmappe, Datei.Inhalte, Ordner.Inhalte, Ordner.Dateien, JSON.Dokument, ODBC.DataSource, ODBC.InferOptions, ODBC.Abfrage, XML.Dokument, Web.Content, Web.Header, Web.BrowserContents, AmazonRedshift.Database, SQL.Database, SQL.Datenbanken, Snowflake.Datenbanken, PostgreSQL.Datenbank, Databricks.Kataloge, Oracle.Datenbank, Denodo.Inhalte, Databricks.Abfrage, DatabricksMultiCloud.Kataloge, Analyseservices.Datenbank, GoogleBigQuery.Datenbank
Unterstützte Tabellenfunktionen	Tabelle.AddSpalte, Tabelle.AddIndexSpalte, Tabelle.UmbenameSpalten, Tabelle.NestedJoin, Tabelle.ExpandTabellenSpalte, Tabelle.SplitSpalte, Tabelle.DuplikatSpalte, Table.CombineColumns
Nicht unterstützte Tabellenvorgänge	Tabelle.Pivot, Tabelle.PromoteHeader, Tabelle.DemoteHeader, Tabelle.Präfixspalten, Tabelle.TransformSpaltennamen, Tabelle.UnpIVOT, Tabelle.UnpivotOderSpalten, Tabelle.hinzugefügte FuzzyClusterSpalte, Tabelle.hinzugefügte JoinSpalte, Tabelle.AggregateTabellenSpalte, Table.Combine, Table.CombineColumnsToRecord, Table.ExpandRecordColumn, Table.Join, Table.transpose
Unterstützte Datenflussfunktionen	PowerPlatform.Datenflüsse, PowerBI.Datenflüsse
Unterstützte Wertfunktionen	Wert.native Abfrage
Unterstützte berechnete Spalten	Herkunft aus berechneten Spaltenausdrücken, die Spalten mit und ohne Tabellenreferenzen, Spalten oder Tabellen mit alphanumerischen Zeichen, Leerzeichen, Bindestrichen und Unterstrichen enthalten, werden unterstützt
Unterstützte Maßnahmen	Herkunft von Maßausdrücken, die Spalten oder Tabellen mit alphanumerischen Zeichen, Leerzeichen, Bindestrichen, Unterstrichen und umgebenden Anführungszeichen enthalten, wird unterstützt

Bereiten Sie die Ausführung des PowerBI-Sammlers vor

Richten Sie die Registrierung, Authentifizierung und Berechtigungen der Azure-Anwendung ein, bevor Sie den Sammler ausführen.

Vorbereitungen

Erforderliche Rolle: Administrator

Wichtig:

Ein Power BI-Administrator ist erforderlich, um Einstellungen im Power BI-Administratorportal zu aktivieren.

Warum und wann dieser Vorgang ausgeführt wird

Der Sammler verwendet die Azure-Anwendungsregistrierung und unterstützt zwei Authentifizierungsmethoden: Service-Prinzipal oder Anwendername und Passwort. Sie müssen eine Anwendung registrieren, die Authentifizierung konfigurieren, das Metadatenscan aktivieren und die Mandanten-ID abrufen. Konfigurieren Sie optional die Erfassung von Berichtsbildern und die Zuordnung der Herkunft.

Prozedur

1. Registrieren Sie eine Anwendung in Azure, und erstellen Sie Client-Anmeldeinformationen.

   Weitere Informationen finden Sie unter Registrieren Sie die Power BI-Anwendung.

2. Konfigurieren Sie die Authentifizierung basierend auf Ihrer bevorzugten Methode.

   • Informationen zur Service-Prinzipal-Authentifizierung finden Sie unter Konfigurieren Sie die Authentifizierung des Power BI-Service-Prinzips.

   • Informationen zur Anwendername- und Passwortauthentifizierung finden Sie unter Konfigurieren Sie den Power BI-Anwendernamen und die Passwortauthentifizierung.

3. Aktivieren Sie das Scannen von Metadaten, um auf detaillierte Datenquelleninformationen zuzugreifen.

   Weitere Informationen finden Sie unter Konfigurieren Sie das Scannen von Power BI-Metadaten.

4. Ruft die Power BI-Mandanten-ID ab.

   Weitere Informationen finden Sie unter Power BI-Mandanten-ID abrufen.

5. Wahlweise: Konfigurieren Sie die Erfassung von Berichtsbildern, um Vorschaubilder aus Power BI-Berichten zu erfassen.

   Weitere Informationen finden Sie unter Konfigurieren Sie die Erfassung von Power BI-Berichtsbildern.

6. Wahlweise: Konfigurieren Sie die Herkunftszuordnung für ODBC-Verbindungen, Server-Aliasse oder anwenderdefinierte SQL-Anweisungen.

   Weitere Informationen finden Sie unter Konfigurieren Sie die Zuordnung der Power BI-Herkunft.

Registrieren Sie die Power BI-Anwendung

Registrieren Sie eine Anwendung in Azure, und erstellen Sie Client-Anmeldeinformationen für die Authentifizierung des Power BI-Sammlers.

Vorbereitungen

Erforderliche Rolle: Administrator

Sie müssen über Berechtigungen zum Registrieren von Anwendungen in Azure Active Directory verfügen.

Warum und wann dieser Vorgang ausgeführt wird

Registrieren Sie eine Anwendung in Azure, um die Client-ID und den geheimen Clientschlüssel zu erhalten, die für die Authentifizierung des Power BI-Sammlers erforderlich sind.

Prozedur

1. Registrieren Sie eine neue Anwendung in Azure.
   1. Navigieren Sie zu Azure-Portal .
   2. Wählen Sie Aus App-Registrierungen Von Azure Services.
   3. Wählen Sie Aus Neue Registrierung .
   4. Geben Sie die Registrierungsinformationen ein.
      • Anwendungsname: DataDotWorldPowerBIApplication
      • Unterstützte Account-Typen: Accounts nur in diesem Organisationsverzeichnis
   5. Wählen Sie Aus Registrieren Zum Abschließen der Registrierung.
2. Erstellen Sie ein geheimes Clientgeheimnis.
   1. Wählen Sie auf der Anwendungsseite aus Zertifikate und Geheimnisse .
   2. Wählen Sie Aus Neues geheimes Clientgeheimnis .
   3. Fügen Sie eine Beschreibung für das Geheimnis hinzu.
   4. Wählen Sie das gewünschte Ablaufdatum aus.
   5. Wählen Sie Hinzufügen.
   6. Kopieren Sie den geheimen Wert.

      Speichern Sie diesen Wert sicher. Sie verwenden sie beim Konfigurieren des Power BI-Sammlers.

3. Rufen Sie die Client-ID ab.
   1. Wählen Sie aus Übersicht Registerkarte in der linken Sidebar der Anwendungsseite.
   2. Kopieren Sie die Client-ID aus dem Abschnitt „Grundlagen“.

      Speichern Sie diesen Wert. Sie verwenden sie beim Konfigurieren des Power BI-Sammlers.

Konfigurieren Sie die Authentifizierung des Power BI-Service-Prinzips

Richten Sie die Service-Prinzipal-Authentifizierung ein, um die Power BI-Metadatensammlung zu aktivieren.

Vorbereitungen

Erforderliche Rolle: Administrator

Sie müssen ein Power BI-Administrator sein, um Service-Prinzipaleinstellungen zu aktivieren.

Wichtig:

Bei der Ausführung unter einem Serviceprinzip dürfen für Ihre App keine Berechtigungen festgelegt sein, die für die Administrator-Zustimmung erforderlich sind. Weitere Informationen finden Sie unter Microsoft-Dokumentation .

Warum und wann dieser Vorgang ausgeführt wird

Bei Verwendung der Service-Prinzipal-Authentifizierung erfasst der Sammler alle Objekte außer persönlichen Arbeitsbereichen, Anwenderarbeitsbereichen und Berichtsseiten. Um alle Apps und Arbeitsbereiche im Mandanten zu sammeln, aktivieren Sie Katalog für alle Arbeitsbereiche und Apps im Mandanten. Um persönliche Arbeitsbereiche und Anwenderarbeitsbereiche einzubeziehen, aktivieren Sie Kataloginhalte von „mein Arbeitsbereich“ des Anwenders.

Hinweis:

Um Berichtsseiten zu sammeln, gewähren Sie dem Serviceprinzipal Zugriff auf jeden Arbeitsbereich. Die Administrator-API hat keinen Endpunkt für Berichtsseiten.

Prozedur

1. Melden Sie sich mit einem Power BI-Administrator-Account bei Power BI an.
2. Navigieren zu Einstellungen > Administratorportalan.
3. Aktivieren Sie den API-Zugriff für den Service-Prinzipal
   1. Unter Entwicklereinstellungen , Suchen Service-Prinzipale können Fabric-APIs verwenden .
   2. Aktivieren Sie die Einstellung.
   3. Wählen Sie aus, ob die Einstellung für die gesamte Organisation oder bestimmte Sicherheitsgruppen gilt.

      Wenn Sie bestimmte Sicherheitsgruppen verwenden, bestätigen Sie, dass die Gruppe den Service-Prinzipal enthält.

   4. Wählen Sie Aus Anwenden Zum Speichern der Änderungen.
4. Wahlweise: Fügen Sie den Service-Prinzipal Arbeitsbereichen für den Datenfluss- und Berichtsseitenzugriff hinzu.

   Datenflüsse erfordern, dass der Service-Prinzipal mindestens über Beitragenden-Zugriff auf den Arbeitsbereich verfügt. Für Berichtsseiten benötigt der Service-Prinzipal auch Zugriff auf den Arbeitsbereich, da die Administrator-API keinen Endpunkt für Berichtsseiten bereitstellt.

   1. Öffnen Sie den Arbeitsbereich.
   2. Wählen Sie Aus Verwalten Sie den Zugriff .
   3. Suchen Sie nach dem Service-Prinzipal oder der Sicherheitsgruppe, zu der der Service-Prinzipal gehört.
   4. Wählen Sie die entsprechende Zugriffsebene aus.

      Wenn Datenflüsse verwendet werden, wählen Sie mindestens Zugriff auf Beitragenden aus. Wählen Sie andernfalls Viewer aus.

   5. Wählen Sie Hinzufügen.

Konfigurieren Sie den Power BI-Anwendernamen und die Passwortauthentifizierung

Richten Sie API-Berechtigungen für die Anwendername- und Passwortauthentifizierung ein, um die Power BI-Metadatensammlung zu aktivieren.

Vorbereitungen

Erforderliche Rolle: Administrator

Sie müssen über Berechtigungen zum Konfigurieren von API-Berechtigungen in Azure Active Directory verfügen.

Hinweis:

Nur Administratoren des Mandanten können dem Administrator die Einwilligung erteilen.

Warum und wann dieser Vorgang ausgeführt wird

Bei Verwendung der Anwenderauthentifizierung erfasst der Sammler alle Objekte außer persönlichen Arbeitsbereichen, Anwenderarbeitsbereichen und Berichtsseiten. Um alle Apps und Arbeitsbereiche im Mandanten zu sammeln, aktivieren Sie „Katalog aller Arbeitsbereiche und Apps im Mandanten“. Um persönliche Arbeitsbereiche und Anwenderarbeitsbereiche einzubeziehen, aktivieren Sie Kataloginhalte von „mein Arbeitsbereich“ des Anwenders.

Um Berichtsseiten zu sammeln, gewähren Sie dem Anwender Zugriff auf jeden Arbeitsbereich. Die Administrator-API hat keinen Endpunkt für Berichtsseiten.

Hinweis:

Für den Katalog aller Arbeitsbereiche und Apps im Mandanten muss der Anwender über die Rechte „globaler Microsoft 365-Administrator“ oder „Power BI-Serviceadministrator“ für das Scannen von Metadaten verfügen. Weitere Informationen finden Sie unter Power BI-Dokumentation .

Prozedur

1. Navigieren Sie zum Azure-Portal, und öffnen Sie die Anwendungsregistrierung.
2. Wählen Sie Aus API-Berechtigungen .
3. Fügen Sie Microsoft Graph-Berechtigungen hinzu.
   1. Wählen Sie Aus Fügen Sie eine Berechtigung hinzu .
   2. Suchen Sie nach, und wählen Sie aus Microsoft Graph .
   3. Fügen Sie die folgenden Berechtigungen hinzu.
      • Anwendungsberechtigung: Anwendung.Lesen.alle
      • Delegierte Berechtigung: Anwender.Lesen (standardmäßig zugewiesen)
4. Fügen Sie Power BI-Serviceberechtigungen hinzu.
   1. Wählen Sie Aus Fügen Sie eine Berechtigung hinzu .
   2. Suchen Sie nach, und wählen Sie aus Power BI-Service .
   3. Wählen Sie Aus Delegierte Berechtigungen .
   4. Fügen Sie die folgenden Berechtigungen hinzu.
      • App.Lesen.Alle
      • Dashboard.Lesen.Alle
      • Datenfluss.Lesen.Alle
      • Datensatz.Lesen.Alle
      • Bericht.Lesen.Alle
      • Mandant.Lesen.Alle
      • Arbeitsbereich.Lesen.Alle
5. Wählen Sie aus Gewähren Sie dem Administrator die Einwilligung Schaltfläche neben Fügen Sie eine Berechtigung hinzu Schaltfläche.

   Mit dieser Berechtigung kann der Sammler ausgeführt werden, ohne Sie um die Berechtigung für jede Ausführung zu bitten.

Konfigurieren Sie das Scannen von Power BI-Metadaten

Aktivieren Sie das Metadatenscan, um auf detaillierte Datenquelleninformationen einschließlich Tabellen und Spalten zuzugreifen.

Vorbereitungen

Erforderliche Rolle: Administrator

Sie müssen ein Power BI-Administrator sein, um Einstellungen für das Metadatenscan zu aktivieren.

Warum und wann dieser Vorgang ausgeführt wird

Metadaten-Scan Bietet Zugriff auf detaillierte Datenquelleninformationen, z. B. Tabellen und Spalten, über schreibgeschützte Power BI-Administrator-APIs. Der Sammler verwendet die Power BI Scanner-APIs, um eine Herkunft zu Quelltabellen und -Spalten einzurichten. Überprüfen Sie Einschränkungen der Scanner-APIs Vor der Konfiguration des Sammlers.

Prozedur

Aktivieren Sie das Scannen von Metadaten basierend auf Ihrer Authentifizierungsmethode.

• Für Service-Prinzipal-Authentifizierung:

  1. Folgen Sie Power BI-Dokumentation Dient zum Aktivieren der Serviceprinzipalauthentifizierung für schreibgeschützte Power BI-APIs
  2. Aktivieren Sie die folgenden erweiterten Mandanteneinstellungen für Metadaten-Scans:
     • Verbessern Sie Administrator-APIs-Antworten mit detaillierten Metadaten
     • Verbessern Sie Administrator-APIs-Antworten mit DAX- und Mashup-Ausdrücken

• Aktivieren Sie für die Anwendername- und Passwortauthentifizierung die folgenden erweiterten Mandanteneinstellungen für das Scannen von Metadaten:

  Wichtig:

  Der Anwender muss über Administratorrechte (globaler Microsoft 365-Administrator oder Power BI-Serviceadministrator) verfügen, um Metadaten-Scans verwenden zu können. Weitere Informationen finden Sie unter Power BI-Dokumentation .
  • Verbessern Sie Administrator-APIs-Antworten mit detaillierten Metadaten
  • Verbessern Sie Administrator-APIs-Antworten mit DAX- und Mashup-Ausdrücken

Power BI-Mandanten-ID abrufen

Ruft die Mandanten-ID aus der Power BI-Anwendung ab.

Vorbereitungen

Erforderliche Rolle: Administrator

Warum und wann dieser Vorgang ausgeführt wird

Die Mandanten-ID ist beim Konfigurieren des Power BI-Sammlers erforderlich. Rufen Sie diesen Wert aus der Power BI-Anwendung ab.

Prozedur

1. Wählen Sie in der Power BI-Anwendung das Fragezeichensymbol aus.
2. Wählen Sie Aus Über Power BI .
3. Kopieren Sie die Mandanten-ID vom Ende der Mandanten-URL.

   Speichern Sie diesen Wert. Sie verwenden sie beim Konfigurieren des Power BI-Sammlers.

Konfigurieren Sie die Erfassung von Power BI-Berichtsbildern

Aktivieren Sie die Erfassung von Berichtsbildern, um Vorschaubilder aus Power BI-Berichten zu erfassen.

Vorbereitungen

Erforderliche Rolle: Administrator

Hinweis:

Das Sammeln von Berichtsbildern wird für Power BI Apps nicht unterstützt.

Warum und wann dieser Vorgang ausgeführt wird

Aktivieren Sie die Erfassung von Berichtsbildern, um Vorschaubilder aus Power BI-Berichten zur Anzeige im Datenkatalog zu sammeln.

Prozedur

1. Aktivieren Sie die Exporteinstellung im Power BI-Administratorportal.
   1. Melden Sie sich mit einem Power BI-Administrator-Account bei Power BI an.
   2. Navigieren zu Einstellungen > Administratorportalan.
   3. Suchen und aktivieren Sie Exportieren Sie Berichte als Bilddateien Einstellung von Administratoreinstellungen .
2. Überprüfen Sie die Kapazität des Arbeitsbereichs.

   Bestätigen Sie, dass sich die zu exportierenden Berichte in einem Arbeitsbereich mit Premium-, Embedded- oder Fabric-Kapazität befinden. Weitere Informationen finden Sie unter Power BI-Dokumentation .

Konfigurieren Sie die Zuordnung der Power BI-Herkunft

Erstellen Sie eine YAML-Datei, um Datenquellen für die Erfassung von Herkunft zuzuordnen.

Vorbereitungen

Erforderliche Rolle: Administrator

Warum und wann dieser Vorgang ausgeführt wird

Dies ist eine optionale Aufgabe zum Sammeln von Abstammungsinformationen. Erstellen Sie eine YAML-Datei, und übergeben Sie sie mit der Option „Datenquellennamen-Zuordnungsdatei“, wenn Sie den Sammler ausführen.

Richten Sie eine YAML-Datei in den folgenden Szenarien ein:

Tabelle : 5. Szenarien der Stammeszuordnung

Szenario	Details	Aktion
ODBC-Verbindungen in Power BI	Sie haben eine Datenquelle in Power BI, die eine ODBC-Verbindung verwendet. In diesen Instanzen stellt Power BI nicht den Host- oder Datenbanktyp der Quelle bereit	Ordnen Sie die DSN in der YAML-Datei einem bestimmten Datenbankhost und -Typ zu. Wenn der Datenbankname in der Power BI-Datenquelle fehlt, fügen Sie der Datenquelle in der YAML-Datei die Option defaultDatabaseName hinzu
Aliasse Für Mehrere Servernamen	Sie haben mehrere Servernamen (Aliasse) für dieselbe Datenbankinstanz (Host), und der Datenbanksammler verwendet einen anderen Alias als den in der Power BI-Verbindung definierten	Verwenden Sie die YAML-Datei, um den Datenbankhost anwenderdefinierten Aliassen zuzuordnen
Anwenderdefinierte SQL-Anweisungen	Anwenderdefinierte SQL-Anweisungen werden in Power BI-Tabellenquellendefinitionen verwendet. Der Power BI-Sammler unterstützt derzeit die Verbindung mit den folgenden Datenbanktypen, um die Herkunft aus SQL-Anweisungen aufzulösen: Snowflake, SQL Server, PostgreSQL, Redshift, Oracle, Databricks, Denodo, BigQuery. Die Abstammungsauflösung für Tabellenquellen, die SQL-Anweisungen verwenden, unterstützt nur SQL, die aus einer einzelnen SELECT-Anweisung besteht	Konfigurieren Sie Datenbanken, die in anwenderdefinierten SQL-Anweisungen angegeben sind, indem Sie datasourceKey, Host und sichere Anmeldeinformationen mithilfe von Umgebungsvariablen einschließen

Hinweis:

Sie können Umgebungsvariablen in der Datei für vertrauliche Informationen wie Passwörter verwenden.

Prozedur

1. Erstellen Sie eine YAML-Datei mit dem Namen „datasources.yml“.
2. Konfigurieren Sie die YAML-Datei basierend auf Ihrem Szenario.

   • Für mehrere Servernamen-Aliasse:

     Fügen Sie Folgendes hinzu, um einen Host-Alias zuzuordnen:

     datasources:
      - datasourceKey: "<host or data source key in Power BI source>"
       host: <my-datasource-host>

     Wenn Ihre Power BI-Tabellenquelle beispielsweise:

     let Source = Snowflake.Database("host-alias.snowflakecomputing.com", "KOS_TEST"),
     PowerBiTest_Test_Table = Source{[Schema="POWERBI_TEST",Item="TEST_TABLE"]}[Data]
     in PowerBiTest_Test_Table

     Dann lautet die datenquelleKey host-alias.snowflakecomputing.com. Ihre Datei „datasources.yml“ sieht folgendermaßen aus:

     datasources:
     - datasourceKey: host-alias.snowflakecomputing.com
     host: host-actual.snowflakecomputing.com

   • Für anwenderdefinierte SQL-Anweisungen:

     Fügen Sie Folgendes für Datenbanken hinzu, die in anwenderdefinierten SQL-Anweisungen angegeben sind. Umgebungsvariablen werden unterstützt:

     datasources:
       - datasourceKey: "<host or data source key in Power BI source>"
       OR
      - name: <data source name>
      host: <my-datasource-host>
      databaseUsername: <username> # recommend setting up env variable
      databasePassword: <password> # recommend setting up env variable

     Verwenden Sie die folgende Option, um anzugeben, für welche Datenbanken eine Datenquellenkonfiguration gilt. Wenn nicht angegeben, wird davon ausgegangen, dass die Datenquelleneinstellungen für alle Datenbanken auf dem angegebenen Host gelten:

     applicableDatabases:
       - <database_name>

     Zum Beispiel:

     datasources:
     - datasourceKey: "example.cpcnqsn422gx.us-east-1.rds.amazonaws.com, 1433"
      host: example.cpcnqsn422gx.us-east-1.rds.amazonaws.com
      databaseUsername: ${DB_USERNAME}
      databasePassword: ${DB_PASSWORD}
      applicableDatabases:
      - 8bank_database

   • Für ODBC-Verbindungen:

     Ordnen Sie die DSN einem bestimmten Datenbankhost und -Typ zu. Listen Sie für ODBC-Verbindungen Datenquellen mit dem entsprechenden Host- und Datenbanktyp auf. Wenn ODBC-Verbindungen ODBC.Query verwenden, geben Sie den Anwendernamen und das Passwort an. Wenn ODBC-Verbindungen den Datenbanknamen angeben, defaultDatabaseName einschließen:

     datasources:
     - name: "Name-for-datasource"
     host: <my-datasource-host>
     databaseType: <type-of-database>
     databaseUsername: <username> # optional
     databasePassword: <password> # optional
     defaultDatabaseName: <database name> # optional

     Die Liste der möglichen databaseTypes ist: postgres, redshift, bigquery, oracle, mysql, netezza, Snowflake, sqlanywhere, sqlServer, databricks, Denodo. Bei Typen wird die Groß-/Kleinschreibung nicht beachtet, es muss sich jedoch um ein einzelnes Wort ohne Leerzeichen handeln.

     Zum Beispiel:

     datasources:
     - name: "SQL Server DSN Production"
     databaseType: sqlserver
     host: 8bank-sqlserver.cpetgx.us-east-1.rds.amazonaws.com

3. Wahlweise: Fügen Sie bei Bedarf datenbankspezifische Konfigurationsoptionen hinzu.

   JDBC-Eigenschaftsoptionen:

   Tabelle : 6. JDBC-Eigenschaften

   Option	Beschreibung
   JdbcEigenschaften	Mehrere JDBC-Eigenschaften können mithilfe einer YAML-Liste angegeben werden. Das erwartete Format ist jdbcProperties: Key=value Beispiel: JdbcProperties: Encrypt=true Für mehrere Werte: jdbcProperties: - encrypt=true - readOnly=true

   Anmeldeinformationsoptionen für Snowflake-Datenbank:

   Tabelle : 7. Schneeflockenoptionen

   Option	Beschreibung
   DatabaseUsername: ${DB_USERNAME}	Erforderlich, wenn anwenderdefinierte SQL-Abfragen in Power BI-Datenbankquellen verwendet werden
   DatabasePassword: ${DB_PASSWORD}	Erforderlich, wenn SQL-Abfragen verwendet werden und wenn kein privater Schlüssel für die Authentifizierung bei Snowflake verwendet wird
   SnowflakePrivateKeyFile: PrivateKeyFile	Erforderlich, wenn SQL-Abfragen verwendet werden und wenn ein privater Schlüssel für die Authentifizierung bei Snowflake verwendet wird
   SnowflakePrivateKeyFilePassword: ${privateKeyFilePassword}	Erforderlich, wenn SQL-Abfragen verwendet werden und wenn ein privater Schlüssel für die Authentifizierung bei Snowflake verwendet wird
   SnowflakeRole: Rolle	Erforderlich, wenn SQL-Abfragen verwendet werden
   SnowflakeWarehouse: Lager	Wird verwendet, um Warehouses zu überschreiben, die in Power BI-Ausdrücken in der Datenbankverbindung verwendet werden

   Anmeldeinformationsoptionen für Databricks-Datenbank:

   Tabelle : 8. Optionen für Datenabschnitte

   Option	Beschreibung
   DatabricksHttpPath	Erforderlich, wenn die Quelldatenbank Databricks ist

   Optionen für autonome Oracle-Datenbank:

   Tabelle : 9. Optionen für autonome Oracle-Datenbank

   Option	Beschreibung
   OracleAutonomousDbConnectionString	Erforderlich, wenn die Quelle eine autonome Oracle-Datenbank ist. Die Verbindungszeichenfolge muss folgendes Format haben: jdbc:oracle:thin:<host>:<port>/<service_name>, jdbc:oracle:thin:@(address=(protocol=tcps)(port=<port>)(host:<host>)) (connect_data=(service_name=<service_name>)) (security=(ssl_server_dn_match=yes)), or jdbc:oracle:thin:@alias_name?TNS_ADMIN=/path/to/wallet

   BigQuery-Optionen:

   Tabelle : 10. BigQuery-Optionen

   Option	Beschreibung
   Projekt	Erforderlich, wenn die Quelle eine BigQuery-Tabelle ist
   BigQueryCredentialJsonString	Erforderlich für die Bereitstellung von BigQuery-Anmeldeinformationen

   Beispiel für BigQuery-Datenbank:

   datasources:
    - project: "project-name"
   databaseType: bigquery
   bigQueryCredentialJsonString: '{"key": "value","key": "value"}'

4. Speichern Sie die Datei „datasources.yml“.
5. Übergeben Sie die YAML-Datei beim Ausführen des Sammlers mithilfe des Parameters „--datasource-Mapping-file“ an den Sammler.

Erstellen Sie einen PowerBI-Metadatensammler

Erstellen Sie einen Sammler, um Metadaten aus PowerBI zu importieren.

Vorbereitungen

Bevor Sie beginnen, überprüfen Sie Folgendes:

• Für die Sammler ist ein MID-Server eingerichtet. Weitere Informationen finden Sie unter MID-Server für Metadatensammler.
• Alle erforderlichen Aufgaben sind abgeschlossen. Weitere Informationen finden Sie unter Bereiten Sie die Ausführung des PowerBI-Sammlers vor.
• Erforderliche Rolle: Connection-admin

Prozedur

1. Navigieren zu Alle > Workflow-Datafabric > Workflow-Datafabric-Startseitean.
2. Wählen Sie den Connect Hub aus Symbol in der linken Sidebar.
3. Auswählen Erstellen > Metadatensammleran.
4. Wählen Sie in der Liste System die Option aus PowerBI .
5. Füllen Sie das Formular aus.

   Tabelle : 11. Neues PowerBI Gov-Metadatensammlerformular

   Feld	Beschreibung
   Verbindungsname	Eindeutiger Bezeichner für die Verbindung. Dieses Feld kann nicht geändert werden, sobald die Verbindung hergestellt wurde.
   Kurzbeschreibung	Zweck und Details der Verbindung.

6. Konfigurieren Sie die Authentifizierungsoptionen.

   Tabelle : 12. Authentifizierungsoptionen

   Feld	Beschreibung
   Authentifizieren Sie sich mit Azure-Anwendername und Passwort	Anwendername und Passwort von Azure Active Directory. Legen Sie die Azure-Mandanten-ID fest, wenn Sie die Azure-Mandanten-ID angeben möchten, während Sie die Anwendername- und Passwortauthentifizierung verwenden.
   Authentifizieren Sie sich mit dem Azure Service-Prinzipal	Mandanten-ID der Azure Active Directory-Anwendung für die Power BI-App. Um die Mandanten-ID zu finden, wählen Sie das Fragezeichen in der Power BI-App aus, und wählen Sie dann „über Power BI“. Die Mandanten-ID befindet sich am Ende der Mandanten-URL.

7. Konfigurieren Sie die Client-ID und die geheimen Clientdetails.

   Tabelle : 13. Konfigurationsdetails

   Feld	Beschreibung
   Microsoft Entra-Client-ID	Anwendungsclient-ID für die PowerBI-App.
   Microsoft Entra-Client-Geheimnis	Anwendungsclientschlüssel für die PowerBI-App.

8. Konfigurieren Sie den Bereich und die Filteroptionen des Arbeitsbereichs.

   Tabelle : 14. Bereich- und Filteroptionen des Arbeitsbereichs

   Feld	Beschreibung
   Deaktivieren Sie die Herkunftssammlung	Option zum Überspringen der Erfassung von Metadaten zur Herkunft aus Power BI-Quellausdrücken.
   Kataloginhalte von „mein Arbeitsbereich“ des Anwenders	Option zum Katalogisieren der Inhalte von „mein Arbeitsbereich“ eines Anwenders in Power BI. Standard: Arbeitsbereich des Anwenders überspringen.
   Katalogisieren Sie alle Arbeitsbereiche und Apps im Mandanten	Option zum Katalogisieren aller Arbeitsbereiche und Apps in einem Mandanten und nicht nur der Arbeitsbereiche und Apps, auf die die Anmeldeinformationen expliziten Zugriff haben. Für die verwendeten Anmeldeinformationen sind Administratorrechte erforderlich.
   Power BI-Arbeitsbereiche einschließen	Zu erfassende Arbeitsbereiche. Geben Sie den genauen Namen des Arbeitsbereichs oder einen regulären Ausdruck ein, der abgeglichen werden soll. Hinweis: Wenn ein Arbeitsbereichsname Sonderzeichen enthält [. , + , * , ? , ^ , $ , ( , ) , [ , ] , { , } , | , \] jedes Sonderzeichen mit einem umgekehrten Schrägstrich (\) versehen. Geben Sie beispielsweise Arbeitsbereich \(dev\) für Arbeitsbereich (dev) ein.
   Schließen Sie Power BI-Arbeitsbereiche aus	Aktivieren Sie BI-Arbeitsbereiche und ihre Inhalte, um sie von der Katalogisierung auszuschließen. Geben Sie den genauen Namen des Arbeitsbereichs oder einen regulären Ausdruck ein, der abgeglichen werden soll. Wenn sowohl Arbeitsbereiche einschließen als auch Arbeitsbereiche ausschließen konfiguriert sind, hat das Einbeziehen von Arbeitsbereichen Vorrang. Hinweis: Wenn ein Arbeitsbereichsname Sonderzeichen enthält [. , + , * , ? , ^ , $ , ( , ) , [ , ] , { , } , | , \] jedes Sonderzeichen mit einem umgekehrten Schrägstrich (\) versehen. Geben Sie beispielsweise Arbeitsbereich \(dev\) für Arbeitsbereich (dev) ein.

9. Konfigurieren Sie die Verbindungs- und Zuverlässigkeitsoptionen.

   Tabelle : 15. Verbindungs- und Zuverlässigkeitsoptionen

   Feld	Beschreibung
   Maximale Leistung – BI-Ausdruckslänge	Maximale Anzahl von Zeichen in einem Power BI-Ausdruck, der auf Herkunft-Metadaten analysiert wird. Ausdrücke, die länger als dieser Wert sind, werden übersprungen. Standard: 32000
   Zuordnungsdatei Des Datenquellennamens	Datei, die ODBC-Quelldetails zuordnet, die in konfiguriert sind Datenquellen.yml Datei. Laden Sie die Datei hoch, wenn Sie ODBC-Quelldetails konfiguriert haben.
   Vorschaubilder für Katalogbericht	Option zum Anzeigen der Katalogvorschaubilder. Standardwert: false
   Deaktivieren Sie die maximale Wartezeit für Anforderungen	Option zum Deaktivieren des Wartens auf die Zurücksetzung der Drosselungsgrenzen durch die Power BI-API (Fehlercode 429). Wenn diese Option nicht ausgewählt ist, versucht der Sammler alle 5 Minuten bis zu einer Stunde lang erneut. Wenn diese Option ausgewählt ist, werden stattdessen die Einstellungen „Max. Wiederholungsverzögerung“ und „Wiederholungsverzögerung“ verwendet.
   Max. Wiederholungen	Gibt an, wie oft das System einen fehlgeschlagenen API-Aufruf wiederholt. Standard: 5
   Wiederholungsverzögerung	Anzahl der Sekunden, die zwischen Wiederholungsversuchen für einen fehlgeschlagenen API-Aufruf gewartet werden soll. Standard: 2 Sekunden

10. Wählen Sie Speichern.

Ergebnisse

Der Metadatensammler wird erstellt und wird auf der Seite „Connectors“ mit einem konfigurierten Status angezeigt. Sie ist jetzt bereit, eine Verbindung zum Quellsystem herzustellen und Metadaten zu sammeln.

Nächste Maßnahme

Nach dem Erstellen des Sammlers können Sie eine der folgenden Aufgaben ausführen:

• Führen Sie den Sammler manuell aus, um Metadaten sofort zu sammeln. Weitere Informationen finden Sie unter Führen Sie Metadatensammler manuell aus.
• Automatisieren Sie die Metadatensammlung, indem Sie regelmäßige Sammlerausführungen planen. Weitere Informationen finden Sie unter Metadaten-Sammlerausführungen planen.
• Überwachen Sie den Ausführungsstatus, und beheben Sie Probleme, indem Sie die Laufzeitprotokolle anzeigen. Weitere Informationen finden Sie unter Zeigen Sie Laufzeitprotokolle für Sammlerausführungen an.
• Erkennen und bewerten Sie die gesammelten Daten-Assets im Datenkatalog. Weitere Informationen finden Sie unter Steuert Datenkatalog.