Herstellen einer Verbindung mit Microsoft Fabric OneLake (Vorschau)

[Dieser Artikel ist eine Vorabdokumentation und kann geändert werden.]

Stellen Sie eine Verbindung mit verwalteten Delta-Tabellen in einem Microsoft Fabric OneLake-Lakehouse her, und importieren Sie die Daten in Dynamics 365 Customer Insights - Data. Der Fabric OneLake-Connector liest Delta-Tabellen direkt aus Ihrem Fabric-Arbeitsbereich, sodass Sie Daten nicht erst in Azure Data Lake Storage kopieren oder zwischenspeichern müssen.

Wichtige Gründe für die Verbindung mit Daten, die in Fabric OneLake gespeichert sind:

  • Delta-Tabellen direkt aus einem Fabric-Lakehouse ohne Zwischenspeicherebene erfassen.
  • Verringern Sie die Datenverschiebung, die Speicherkosten und die Pipelinewartung.
  • Verwenden Sie Fabric-Verknüpfungen, um Delta-Tabellen aus anderen Quellen oder Arbeitsbereichen in ein einzelnes Lakehouse zu bringen und sie dann über eine einzige Verbindung zu erfassen.

Important

  • Dies ist eine Vorschaufunktion.
  • Vorschaufunktionen sind nicht für den Produktionsgebrauch gedacht und verfügen möglicherweise über eingeschränkte Funktionalität. Diese Funktionen sind vor einer offiziellen Veröffentlichung verfügbar, damit Kunden frühzeitig zugreifen und Feedback geben können.

Voraussetzungen

Bevor Sie eine Fabric OneLake-Datenquelle erstellen:

Voraussetzungen für Workspaces

  • Ein Microsoft Fabric-Arbeitsbereich, der ein oder mehrere Lakehouses mit den Delta-Tabellen enthält, die Sie erfassen möchten. Der Fabric-Arbeitsbereich und die Customer Insights - Data-Umgebung müssen sich im selben Microsoft Entra-Mandanten befinden.
  • Der Administrator, der die Datenquelle erstellt oder aktualisiert, benötigt mindestens die Arbeitsbereichsrolle Viewer.

Voraussetzungen für Daten

  • Sie können verwaltete Delta-Tabellen in einem Fabric Lakehouse einlesen. Dateien (z. B. CSV oder Nicht-Delta-Parkett) und Fabric Data Warehouse Tabellen werden nicht unterstützt.
  • Jede Delta-Tabelle muss eine Primärschlüsselspalte mit eindeutigen, nicht NULL-Werten aufweisen. Zeichenfolgen-, Ganzzahl- und GUID-Datentypen werden als Primärschlüssel unterstützt.
  • Delta-Tabellen, die über Fabric-Verknüpfungen verfügbar gemacht werden werden unterstützt.
  • Customer Insights - Data unterstützt Databricks Reader Version 1 oder 2. Customer Insights - Data unterstützt das Lesen von Delta-Tabellen mit aktivierten Löschvektoren nicht. Löschvektoren erfordern die Delta Reader Version 3, die nicht unterstützt wird. Weitere Informationen: Unterstützte Databricks-Funktionen.

Einschränkungen bei der Vorschau

Die folgenden Einschränkungen gelten während der öffentlichen Vorschau:

  • One Fabric OneLake-Datenquelle pro Arbeitsbereich. Um Daten aus einem anderen Arbeitsbereich zu erfassen, erstellen Sie eine weitere Datenquelle oder verwenden Sie eine Fabric-Verknüpfung.
  • Editing einer vorhandenen Fabric OneLake-Datenquelle wird nicht unterstützt. Um die ausgewählten Tabellen zu ändern, entfernen Sie die Datenquelle, und erstellen Sie eine neue. Entfernen Sie zuerst alle nachgelagerten Abhängigkeiten . Die Bearbeitung vorhandener Verbindungen ist vor der allgemeinen Verfügbarkeit (GA) geplant.
  • Direktes Upgrade von einer vorhandenen Azure Data Lake Delta-Tabellen-Datenquelle zu einer Fabric OneLake-Datenquelle ist noch nicht verfügbar. Das direkte Upgrade ist vor ga geplant.

Aktivieren des externen Zugriffs auf OneLake-Daten

Ein Fabric Mandantenadministrator muss den externen Zugriff auf OneLake-Daten once für jeden Fabric Mandanten aktivieren. Mit dieser Einstellung wird dem Dienst Customer Insights - Data das Lesen von Delta-Tabellen aus Ihren Fabric-Lakehouses ermöglicht.

  1. Melden Sie sich beim verwaltungsportal Fabric als Fabric Administrator an.
  2. Wählen Sie Mandanteneinstellungen aus.
  3. Erweitern Sie unter OneLake-Einstellungen die Option Benutzer können mit Apps außerhalb von Fabric auf in OneLake gespeicherte Daten zugreifen.
  4. Legen Sie die Umschaltfläche auf "Aktiviert " fest, und wenden Sie die Einstellung auf die gesamte Organisation an (oder auf bestimmte Sicherheitsgruppen, wie von Ihrer Mandantenrichtlinie erforderlich).

Note

Änderungen an den Mandanteneinstellungen können bis zu 15 Minuten dauern, bis sie wirksam werden.

Fügen Sie den Dienstprinzipal von Customer Insights - Data dem Fabric-Arbeitsbereich hinzu

Fügen Sie den Customer Insights - Data-Dienstprinzipal (Dynamics 365 AI for Customer Insights) dem Fabric-Arbeitsbereich mit mindestens der Rolle Contributor hinzu, sodass er Delta-Tabellen zur Laufzeit lesen und für jede Tabelle eine kleine Menge an Metadaten schreiben kann. Stellen Sie als bewährte Methode den Dienstprinzipal in eine Sicherheitsgruppe ein.

Aktivieren Sie den Dienstprinzipal im Fabric-Mandanten.

  1. Melden Sie sich beim verwaltungsportal Fabric als Fabric Administrator an.
  2. Wählen Sie Mandanteneinstellungen aus. Scrollen Sie zu den Entwicklereinstellungen.
  3. Aktivieren Sie Dienstprinzipale können öffentliche Fabric-APIs aufrufen.

Fügen Sie den Dienstprinzipal oder die Sicherheitsgruppe zum Fabric-Arbeitsbereich hinzu

  1. Öffnen Sie Ihren Fabric-Arbeitsbereich.
  2. Wählen Sie Zugriff verwalten aus.
  3. Wählen Sie "Personen oder Gruppen hinzufügen" aus.
  4. Suchen Sie nach dem Dienstprinzipalnamen oder der Sicherheitsgruppe, die ihn enthält.
  5. Weisen Sie die Rolle Mitwirkender zu.

Verbindung mit Daten in Fabric OneLake herstellen

Datenquellennamen und Tabellennamen müssen mit einem Buchstaben beginnen und dürfen nur Buchstaben, Zahlen und Sonderzeichen enthalten. Sie können eine Datenquelle auch nach dem Speichern nicht umbenennen. Wenn Sie die Fabric OneLake-Datenquelle erstellen, verwenden Sie die Identität des Customer Insights - Data Administrators, der sie konfiguriert.

  1. Wechseln Sie in Customer Insights - Data zu Data>Datenquellen.

  2. Wählen Sie Datenquelle hinzufügen aus.

  3. Wählen Sie Microsoft Fabric OneLake (Vorschau) aus.

  4. Geben Sie die folgenden Informationen ein:

    • Datenquellenname – Ein eindeutiger Name für die Datenquelle. Nachgeschaltete Prozesse verweisen auf diesen Namen und können ihn später nicht ändern.
    • Description(optional) – Eine kurze Beschreibung der daten, die die Quelle enthält.
    • Workspace – Der Fabric-Arbeitsbereich, der das Lakehouse mit den Delta-Tabellen enthält, die Sie importieren möchten.

    Screenshot des Bereichs „Datenquelle hinzufügen“ mit ausgewähltem Fabric OneLake (Vorschau).

    Note

    Jede Fabric OneLake-Datenquelle ist mit genau einem Arbeitsbereich verbunden. Wenn Sie Tabellen aus einem anderen Arbeitsbereich importieren möchten, erstellen Sie entweder eine weitere Datenquelle für diesen Arbeitsbereich oder verwenden Sie eine Fabric-Verknüpfung, um auf die Tabellen im verbundenen Arbeitsbereich zu verweisen.

  5. Wählen Sie Weiteraus. Customer Insights - Data listet jede Delta-Tabelle auf, die es in den Lakehouses im ausgewählten Arbeitsbereich findet. Tabellennamen verwenden das Muster <lakehouse>_Lakehouse_<schema>_<table>.

  6. Wählen Sie für jede Tabelle, die Sie importieren möchten, Einbeziehen aus.

    Screenshot der Seite „Fabric Delta-Tabellen hinzufügen“, auf der Tabellen aus Lakehouses aufgeführt sind, wobei zwei Tabellen ausgewählt sind.

    Tip

    Wenn eine Tabelle nicht angezeigt wird, vergewissern Sie sich, dass es sich um eine verwaltete Delta-Tabelle in einem Fabric Lakehouse handelt und dass sie im Arbeitsbereich vorhanden ist. Tabellen, die in einem Fabric Data Warehouse gespeichert sind, werden nicht aufgelistet.

  7. Für jede ausgewählte Tabelle, in der kein Primärschlüssel erkannt wird, wird "Erforderlich" unter "Primärschlüssel" angezeigt. Für jede dieser Tabellen:

    1. Wählen Sie Erforderlich. Der Bereich "Tabelle bearbeiten " wird geöffnet.
    2. Wählen Sie den Primärschlüssel. Der Primärschlüssel muss eindeutig sein und darf keine NULL- oder fehlenden Werte enthalten.
    3. Wählen Sie Schließen, um den Bereich zu speichern und zu schließen.

  8. Um die Datenprofilerstellung für eine Tabelle zu aktivieren, wählen Sie die Zahl unter "Spalten " für diese Tabelle aus. Die Seite "Attribute verwalten" wird geöffnet.

    Screenshot der Seite

    1. Überprüfen Sie das Format "Name " und " Daten" für jede Spalte.
    2. Wählen Sie "Datenprofilerstellung" für die gesamte Tabelle oder für einzelne Spalten aus. Standardmäßig ist die Datenprofilerstellung deaktiviert.
    3. Wählen Sie "Fertig" aus.

  9. Wählen Sie "Weiter" aus, überprüfen Sie die Zusammenfassung, und wählen Sie dann " Speichern" aus.

Die Seite "Datenquellen " wird geöffnet und zeigt die neue Datenquelle im Aktualisierungsstatus an.

Das Laden von Daten kann einige Zeit in Anspruch nehmen. Nach einer erfolgreichen Aktualisierung können Sie die aufgenommenen Daten auf der Seite "Tabellen " überprüfen. In Customer Insights - Data erfasste Daten werden am geografischen Standort der Customer Insights - Data-Umgebung übertragen und verarbeitet. Weitere Informationen finden Sie im Microsoft Trust Center.

Tip

Es gibt Status für Aufgaben und Prozesse. Die meisten Prozesse hängen von anderen Upstream-Prozessen ab, wie z. B. Datenquellen- und Datenprofilerstellungs-Aktualisierungen.

Wählen Sie den Status aus, um den Bereich Fortschrittsdetails zu öffnen und den Fortschritt der Aufgaben anzuzeigen. Um den Auftrag abzubrechen, wählen Sie Auftrag abbrechen am unteren Rand des Bereichs.

Bei jeder Aufgabe können sie Details anzeigen wählen, um mehr Fortschrittsinformationen zu erhalten, wie Verarbeitungszeit, letztes Verarbeitungsdatum und alle zutreffenden Fehler und Warnungen im Zusammenhang mit der Aufgabe oder dem Prozess. Wählen Sie Systemstatus anzeigen am unteren Rand des Bereichs aus, um andere Prozesse im System anzuzeigen.

Unterstützte Funktionen

Der Fabric OneLake-Connector unterstützt Folgendes:

  • Erfassung verwalteter Delta-Tabellen aus Fabric-Lakehouses.
  • Delta-Tabellen, die über Fabric Shortcuts verfügbar gemacht werden (einschließlich Verknüpfungen zu OneLake, Azure Data Lake Storage Gen2, Amazon S3 und Google Cloud Storage).
  • Inkrementelle Aktualisierung mithilfe der Delta-Versionsverwaltung.

Nicht unterstützte Funktionen

Die folgenden Funktionen werden während der Vorschau nicht unterstützt:

  • Fabric Data Warehouse-Tabellen.
  • Dateien oder Tabellen, die sich nicht im Delta-Format befinden (z. B. CSV oder Nicht-Delta-Parkett).
  • Verbindungen zu Seehäusern über mehrere Fabric Arbeitsbereiche aus einer einzigen Datenquelle. Verwenden Sie stattdessen Verknüpfungen oder erstellen Sie andere Datenquellen.

Schemaänderungen verwalten

Wenn Sie eine Spalte aus dem Schema einer Delta-Tabelle hinzufügen oder entfernen, führt Customer Insights - Data eine vollständige Aktualisierung der Daten aus. Vollständige Aktualisierungen dauern länger als inkrementelle Aktualisierungen.

Wenn sich das Quellschema nach dem Erstellen der Datenquelle ändert, wird ein Schemakonfliktfehler angezeigt, und Sie werden aufgefordert, die Datenquelle zu aktualisieren. Da die Bearbeitung während der Vorschau nicht unterstützt wird, entfernen Sie die Datenquelle, und erstellen Sie sie neu, um das neue Schema aufzunehmen. Eine direkte Schemaaktualisierung ist für GA geplant.

Delta-Zeitreise und Datenaktualisierungen

Customer Insights - Data verwendet den Delta-Versionsverlauf beim Aufnehmen von Daten. Customer Insights - Data benötigt alle Protokollversionen seit der letzten Aktualisierung. So vermeiden Sie Fehlschläge bei der vollständigen Aktualisierung, die durch fehlende Delta-Versionen verursacht werden:

  • Führen Sie einen Versionsverlauf des Delta-Protokolls, der länger ist als Ihr längstes Aktualisierungsintervall. Wenn eine Entwicklungsinstanz z. B. nur alle zwei Wochen Daten aktualisiert, behalten Sie mindestens drei Wochen Versionsverlauf bei.
  • Legen Sie in Ihrem Fabric Lakehouse sowohl delta.logRetentionDuration als auch delta.deletedFileRetentionDuration auf einen geeigneten Wert fest.
  • Vermeiden Sie aggressive VACUUM-Vorgänge bei Tabellen, die von Customer Insights - Data erfasst werden.

Wenn Delta-Versionen fehlen (z. B. nach einer VACUUM oder nach der Neuerstellung der Tabelle), erstellen Sie die Datenquelle neu, um eine vollständige Aktualisierung auszulösen.

Häufiges Problem

Seite „Fabric-Delta-Tabellen hinzufügen“ scheint hängen zu bleiben, es werden keine Tabellen angezeigt.

Eine oder beide der folgenden Situationen können dieses Problem verursachen:

  • Last updated on