Gmail-Konnektor

Important

Dieses Feature befindet sich in der Betaversion. Arbeitsbereichsadministratoren können den Zugriff auf dieses Feature über die Vorschauseite steuern. Siehe Manage Azure Databricks Previews.

Der verwaltete Gmail-Connector in Lakeflow Connect importiert Nachrichten, Labels, Entwürfe und Filterungen aus einem Gmail-Postfach in Azure Databricks.

Der Konnektor liest über ein Google-Dienstkonto aus einem einzigen Postfach pro Verbindung, wobei dieser Lesezugriff schreibgeschützt ist. Es verändert nie das Quellpostfach. Die Tabellen messages und message_labels werden mithilfe der Gmail History API inkrementell synchronisiert. Die anderen Tabellen werden bei jedem Pipeline-Durchlauf vollständig erneut eingelesen.

Verfügbarkeit von Funktionen

Die folgende Tabelle listet die Verfügbarkeit von Funktionen für den Gmail-Connector auf.

Funktion Verfügbarkeit
Benutzeroberflächenbasierte Pipelineerstellung Grünes Häkchensymbol Unterstützt
API-basierte Pipeline-Erstellung Grünes Häkchensymbol Unterstützt
Deklarative Automatisierungspakete Grünes Häkchensymbol Unterstützt
Inkrementelle Erfassung Grünes Häkchensymbol Unterstützt
Nur für die Tabellen messages und message_labels. Die anderen Tabellen lassen nur eine vollständige Aktualisierung zu.
Unity Catalog Governance Grünes Häkchensymbol Unterstützt
Orchestrierung mit Databricks-Workflows Grünes Häkchensymbol Unterstützt
SCD Typ 2 Rotes X-Symbol Nicht unterstützt
Das Konfigurieren von SCD Typ 2 für die Tabelle messages oder message_labels führt dazu, dass die Pipeline-Validierung fehlschlägt.

Authentifizierungsmethoden

Authentifizierungsmethode Verfügbarkeit
Google-Dienstkonto (OAuth-Dienstkonto mit domänenweiter Delegation) Grünes Häkchensymbol Unterstützt
OAuth U2M Rotes X-Symbol Nicht unterstützt
Standardauthentifizierung (Benutzername/Kennwort) Rotes X-Symbol Nicht unterstützt

Der Connector authentifiziert sich bei Gmail mit einem Google-Dienstkonto. Sie gewähren dem Servicekonto eine domänenweite Delegation für den https://www.googleapis.com/auth/gmail.readonly Umfang und wählen das Postfach, das das Servicekonto imitiert. Für Setup-Schritte siehe Gmail konfigurieren für Azure Databricks Ingestion.

Was Sie wissen müssen, bevor Sie beginnen

Thema Warum dies wichtig ist
Azure Databricks-Benutzerpersona Der Workflow hängt von Ihrer Azure Databricks-Benutzerpersona ab:
  • Einzelbenutzer: Ein Administrator-Benutzer erstellt eine Unity-Katalogverbindung und eine Datenaufnahme-Pipeline.
  • Mehrere Benutzer: Ein Administratorbenutzer erstellt eine Verbindung für Nicht-Administratorbenutzer zum Erstellen von Pipelines mit.
Authentifizierungsmethode Der Connector authentifiziert sich mit einem Google-Service-Konto, das sich als ein einzelnes Postfach ausgibt.
Einzelne Briefkasten pro Verbindung Jede Verbindung erfasst ein Postfach. Um mehr als ein Postfach einzubinden, erstellen Sie bitte pro Postfach eine separate Verbindung und Pipeline. Der Postfachwert wird in jeder Zeile als mailbox-Spalte gekennzeichnet.
Interface Die Schritte zum Erstellen einer Pipeline hängen von der Schnittstelle ab.
Aufnahmehäufigkeit Der Pipelinezeitplan hängt von Ihren Latenz- und Kostenanforderungen ab.

Starten der Einbindung aus Gmail

Die folgende Tabelle bietet einen Überblick über den End-to-End-Eingabefluss von Gmail, basierend auf Benutzertyp:

Benutzer Steps
Administrator
Nicht-Administrator Verwenden Sie jede unterstützte Schnittstelle, um eine Pipeline aus einer vorhandenen Verbindung zu erstellen. Siehe Daten aus Gmail importieren.

Weitere Ressourcen

  • Last updated on