Conector do Gmail

Importante

Esse recurso está em Beta. Os administradores do workspace podem controlar o acesso a esse recurso na página Visualizações . Consulte Gerenciar visualizações do Azure Databricks.

O conector gerenciado do Gmail no Lakeflow Connect importa mensagens, etiquetas, rascunhos e filtros de uma caixa de correio do Gmail para o Azure Databricks.

O conector lê os dados de uma única caixa de correio em cada conexão usando uma conta de serviço do Google e tem acesso somente leitura. Ele nunca modifica a caixa de correio fonte. As tabelas messages e message_labels são sincronizadas de forma incremental usando a API de histórico do Gmail. As outras tabelas são ingeridas novamente de forma integral em cada execução de pipeline.

Disponibilidade de funcionalidades

A tabela a seguir lista a disponibilidade de recursos para o conector do Gmail.

Característica Disponibilidade
Criação de pipelines com base em interface gráfica Ícone de verificação verde Suportado
Criação de pipeline baseada em API Ícone de verificação verde Suportado
Pacotes de Automação Declarativa Ícone de verificação verde Suportado
Ingestão incremental Ícone de verificação verde Suportado
Apenas para as tabelas messages e message_labels. As outras tabelas aceitam apenas a atualização completa.
Governança do Catálogo do Unity Ícone de verificação verde Suportado
Orquestração usando fluxos de trabalho do Databricks Ícone de verificação verde Suportado
SCD do tipo 2 Ícone do X Vermelho Sem suporte
Configurar o SCD Tipo 2 para a tabela messages ou message_labels causa falha na validação do pipeline.

Métodos de autenticação

Método de autenticação Disponibilidade
Conta de serviço Google (conta de serviço OAuth com delegação em todo o domínio) Ícone de verificação verde Suportado
OAuth U2M Ícone do X Vermelho Sem suporte
Autenticação básica (nome de usuário/senha) Ícone do X Vermelho Sem suporte

O conector se autentica no Gmail com uma conta de serviço do Google. Você concede à conta de serviço a delegação em todo o domínio para o escopo https://www.googleapis.com/auth/gmail.readonly e escolhe a caixa de correio que a conta de serviço representa. Para as etapas de configuração, veja Configurar Gmail para ingestão do Azure Databricks.

O que saber antes de começar

Tópico Por que isso importa
Persona de usuário do Azure Databricks O fluxo de trabalho depende da persona do usuário do Azure Databricks:
  • Usuário único: um usuário administrador cria uma conexão do Unity Catalog e um pipeline de ingestão.
  • Multiusuário: um usuário administrador cria uma conexão para usuários não administradores criarem pipelines.
Método de autenticação O conector se autentica usando uma conta de serviço do Google que representa uma única caixa de correio.
Caixa de correio única por conexão Cada conexão importa uma caixa de correio. Para importar mais de uma caixa de correio, crie uma conexão e um pipeline separados para cada caixa de correio. O valor da caixa de correio é carimbado como uma coluna mailbox em cada linha.
Interface As etapas para criar um pipeline dependem da interface.
Frequência de ingestão O agendamento do pipeline depende de seus requisitos de latência e custo.

Comece a ingerir pelo Gmail

A tabela a seguir apresenta uma visão geral do fluxo de ingestão do Gmail de ponta a ponta, com base no tipo de usuário:

Usuário Steps
Admin
Não administrador Use qualquer interface com suporte para criar um pipeline a partir de uma conexão existente. Veja Ingestir dados do Gmail.

Recursos adicionais

  • Last updated on