Configura Gmail per l'ingestione di Azure Databricks

Impara a configurare un account di servizio Google Cloud in modo che Azure Databricks possa acquisire dati dalla tua casella di posta Gmail.

Il connettore Gmail si autentica con un account di servizio Google che impersona una singola casella di posta tramite la delega a livello di dominio. In questo compito, crei l'account di servizio e una chiave JSON, gli concedi accesso in sola lettura ai dati di Gmail e identifichi la casella di posta da utilizzare tramite impersonificazione. Utilizzerai i dettagli di autenticazione ottenuti per creare una connessione Azure Databricks Unity Catalog a Gmail.

Prerequisiti

• Accesso al progetto Google Cloud dove vuoi creare l'account di servizio, con il permesso di creare account di servizio e chiavi.
• Accesso come super amministratore di Google Workspace per concedere la delega a livello di dominio.
• L'indirizzo email della casella di posta Gmail che vuoi acquisire.

Crea un account di servizio e una chiave JSON

1. Nella console Google Cloud, vai su IAM & Admin > Account di servizio.

2. Clicca Crea account di servizio.

3. Inserisci un nome e una descrizione per l'account del servizio, poi clicca su Crea e continua.

4. Fare clic su Fine. Non è necessario concedere ruoli a livello di progetto.

5. Nella pagina Account di Servizio , clicca sull'account di servizio che hai creato.

6. Nella scheda Chiavi, fai clic su Aggiungi chiave > Crea nuova chiave.

7. Seleziona JSON, poi clicca su Crea. Il file chiave JSON viene scaricato sulla tua macchina.

   Conserva la chiave JSON in modo sicuro. Incolla il suo contenuto quando crei la connessione con Unity Catalog.

Abilita l'API di Gmail

1. Nella console Google Cloud, vai a API e servizi > Libreria.
2. Cerca l'API di Gmail, poi fai clic.
3. Fare clic su Abilita.

Concedi delega a livello di dominio

Per leggere i dati della casella di posta per conto di un utente, l'account di servizio deve essere autorizzato per la delega a livello di dominio nel tuo Google Workspace.

1. Nella console Google Cloud, copia l'ID Univoco (ID client) dell'account di servizio dalla scheda Dettagli.

2. Nella Google Admin Console, vai su Sicurezza > Controllo dell'accesso e dei dati > Controlli API.

3. In Delega a livello di dominio, clicca su Gestisci delega a livello di dominio.

4. Fare clic su Aggiungi nuovo.

5. In Client ID, incolla l'ID unico dell'account di servizio.

6. Negli ambiti OAuth, inserisci il seguente ambito di sola lettura:

   https://www.googleapis.com/auth/gmail.readonly
   

7. Fare clic su Autorizza.

Identifica la cassetta postale da rappresentare

L'account di servizio impersona una singola casella di posta. Annota l'indirizzo email della casella di posta che vuoi acquisire, ad esempio user@example.com. Specifica questo indirizzo come e-mail per l'impersonificazione quando crei la connessione Unity Catalog.

Per ingerire più di una casella di posta, crea una connessione e una pipeline separate per ogni casella di posta.

Passo successivo

Crea una connessione Gmail