Criar uma conexão com o Gmail

info

Beta

Esse recurso está em Beta. Os administradores do workspace podem controlar o acesso a esse recurso na página Pré-visualizações . Consulte Gerenciar prévias do Databricks.

Crie uma conexão Gmail no Catalog Explorer para armazenar credenciais de autenticação para a ingestão do Lakeflow Connect. Qualquer usuário com o privilégio USE CONNECTION na conexão pode então criar pipelines de ingestão do Gmail sem precisar de acesso direto às credenciais.

Alternativamente, usuários administradores podem criar uma conexão e um pipeline ao mesmo tempo na interface de usuário de ingestão de dados. Consulte Ingerir dados do Gmail.

Para requisitos de privilégio, consulte Conectar a fontes de ingestão gerenciadas.

Pré-requisitos

Conclua a configuração da origem. Use a key JSON da conta de serviço e o endereço de caixa de correio que você obteve para criar a conexão.

Criar uma conexão

1. No workspace do Databricks, clique em Catalog > External locations > Connections > Create connection .

2. Na página Noções básicas de conexão do assistente Configurar conexão , especifique um Nome da conexão exclusivo.

3. No menu suspenso Connection type , selecione Gmail .

4. (Opcional) Adicione um comentário.

5. Clique em Avançar .

6. Na página Autenticação , digite o seguinte:

   • JSON da account de serviço : Cole o conteúdo completo da key JSON da account de serviço que você criou na configuração de origem. Este valor é armazenado como um segredo.
   • E-mail da caixa de correio : O endereço de e-mail da caixa de correio a ser ingerida, por exemplo user@example.com. Este é o valor impersonate_email. A account de serviço usa delegação em todo o domínio para representar esse usuário, portanto, todas as chamadas da API do Gmail leem a caixa de correio desse usuário. Defina isso para a caixa de correio que você deseja importar. Embora o campo não seja obrigatório, uma conta de serviço do Google não possui caixa de correio própria; portanto, se você o deixar vazio, a conexão será autenticada como a própria conta de serviço e não terá uma caixa de correio de usuário para ler. Para ingerir o e-mail de uma pessoa, você deve especificar o endereço dela aqui. Para saber mais sobre como a caixa de correio é selecionada, consulte Seleção de caixa de correio. Para saber como autorizar a account de serviço para delegação em todo o domínio, consulte Configurar o Gmail para ingestão no Databricks.
   • Escopo OAuth : insira https://www.googleapis.com/auth/gmail.readonly. O conector requer este escopo de somente leitura para acessar a caixa de correio.

7. Clique em Criar conexão .

Passos seguintes

Ingerir dados do Gmail