Gmail für die Datenaufnahme in Azure Databricks konfigurieren

Important

Dieses Feature befindet sich in der Betaversion.

Erfahren Sie, wie Sie ein Google-Cloud-Servicekonto konfigurieren, damit Azure Databricks Daten aus Ihrem Gmail-Postfach erfassen kann.

Der Gmail-Konnektor authentifiziert sich mit einem Google-Dienstkonto, das mithilfe der domänenweiten Delegierung die Identität eines einzelnen Postfachs annimmt. Bei dieser Aufgabe erstellen Sie das Dienstkonto und einen JSON-Schlüssel, gewähren ihm Nur-Lesezugriff auf Gmail-Daten und identifizieren das zu imitierende Postfach. Sie verwenden die erhaltenen Authentifizierungsdaten, um eine Azure Databricks Unity Catalog-Verbindung zu Gmail herzustellen.

Voraussetzungen

  • Zugriff auf das Google-Cloud-Projekt, in dem Sie das Servicekonto erstellen möchten, mit der Berechtigung, Servicekonten und Schlüssel zu erstellen.
  • Google Workspace Superadministrator-Zugriff zur Gewährung einer domänenweiten Delegation.
  • Die E-Mail-Adresse des Gmail-Postfachs, das Sie importieren möchten.

Erstelle ein Servicekonto und einen JSON-Schlüssel

  1. In der Google Cloud Console gehen Sie zu IAM & Admin > Service Accounts.

  2. Klicken Sie auf Servicekonto erstellen.

  3. Geben Sie einen Namen und eine Beschreibung für das Servicekonto ein, klicken Sie dann auf Erstellen und fortfahren.

  4. Klicken Sie auf "Fertig". Du musst keine Projektrollen vergeben.

  5. Auf der Seite Service-Konten klicken Sie auf das von Ihnen erstellte Service-Konto.

  6. Klicken Sie auf der Registerkarte Schlüssel auf Schlüssel hinzufügen > Neuen Schlüssel erstellen.

  7. Wählen Sie JSON und klicken Sie dann auf Erstellen. Die JSON-Schlüsseldatei wird auf deinen Rechner heruntergeladen.

    Bewahre den JSON-Schlüssel sicher auf. Du fügst den Inhalt ein, wenn du die Unity-Katalog-Verbindung erstellst.

Aktivieren Sie die Gmail-API

  1. Wechseln Sie in der Google Cloud-Konsole zu APIs & Dienste > Bibliothek.
  2. Suchen Sie nach Gmail API, dann klicken Sie darauf.
  3. Klicken Sie auf Aktivieren.

Domainweite Delegation gewähren

Um im Namen eines Nutzers die Mailboxdaten zu lesen, muss das Servicekonto für die domänenweite Delegierung in Ihrem Google Workspace autorisiert sein.

  1. In der Google Cloud Console kopieren Sie die eindeutige ID (Client-ID) des Servicekontos vom Reiter Details .

  2. In der Google Admin Console gehen Sie zu Security > Access und Data Control > API Controls.

  3. Klicken Sie unter Domänenweite Delegierung auf Domänenweite Delegierung verwalten.

  4. Klicken Sie auf Neues hinzufügen.

  5. In Client-ID fügen Sie die eindeutige ID des Servicekontos ein.

  6. In OAuth-Scopes geben Sie folgenden schreibgeschützten Scope ein:

    https://www.googleapis.com/auth/gmail.readonly
    
  7. Klicken Sie auf Autorisieren.

Postfach identifizieren, dessen Identität übernommen werden soll

Das Dienstkonto übernimmt die Identität als ein einzelnes Postfach. Notieren Sie die E-Mail-Adresse des Postfachs, dass Sie erfassen möchten, z. B. user@example.com. Diese Adresse geben Sie als E-Mail-Adresse der Identitätsübernahme an, wenn Sie die Unity Catalog-Verbindung erstellen.

Um mehr als ein Postfach zu erfassen, erstellen Sie für jedes Postfach eine separate Verbindung und Pipeline.

Nächster Schritt

Eine Gmail-Verbindung erstellen