Conector do Gmail

Importante

Este recurso está em versão Beta. Os administradores do espaço de trabalho podem controlar o acesso a esse recurso na página Visualizações . Ver Gerir as pré-visualizações de Azure Databricks.

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

O conector lê a partir de uma única caixa de correio por ligação usando uma conta de serviço Google, e é apenas de leitura. Nunca modifica a caixa de correio de origem. As tabelas messages e message_labels são sincronizadas de forma incremental através da API Gmail History. As outras tabelas são reingestas na totalidade em cada execução do pipeline.

Disponibilidade de funcionalidades

A tabela seguinte lista a disponibilidade das funcionalidades do conector do Gmail.

Feature Availability
Criação de pipelines com base na interface de utilizador Ícone de verificação verde Apoiado
Criação de pipeline baseada em API Ícone de verificação verde Apoiado
Pacotes de Automação Declarativa Ícone de verificação verde Apoiado
Ingestão incremental Ícone de verificação verde Apoiado
Apenas para as tabelas messages e message_labels. As outras tabelas suportam apenas atualização completa.
Governança do Catálogo Unity Ícone de verificação verde Apoiado
Orquestração usando fluxos de trabalho Databricks Ícone de verificação verde Apoiado
SCD tipo 2 Ícone vermelho X Não suportado
A configuração do SCD Tipo 2 para a tabela messages ou message_labels faz falhar a validação do pipeline.

Métodos de autenticação

Método de autenticação Availability
Conta de serviço Google (Conta de serviço OAuth com delegação em todo o domínio) Ícone de verificação verde Apoiado
OAuth U2M Ícone vermelho X Não suportado
Autenticação básica (nome de utilizador/palavra-passe) Ícone vermelho X Não suportado

O conector autentica-se no Gmail com uma conta de serviço Google. Concede à conta de serviço delegação ao nível do domínio para o âmbito https://www.googleapis.com/auth/gmail.readonly e escolhe a caixa de correio que a conta de serviço representa. Para os passos de configuração, consulte Configurar o Gmail para a ingestão do Azure Databricks.

O que deve saber antes de começar

Topic Por que é importante
Persona de utilizador do Azure Databricks O fluxo de trabalho depende da sua persona de utilizador Azure Databricks:
  • Utilizador único: Um utilizador administrador cria uma ligação ao Unity Catalog e um pipeline de ingestão.
  • Multiutilizador: Um utilizador administrador cria uma ligação para que utilizadores não administradores possam criar pipelines.
Método de autenticação O conector autentica-se através de uma conta de serviço da Google que representa uma única caixa de correio.
Caixa de correio única por ligação Cada conexão importa uma caixa de correio. Para processar mais de uma caixa de correio, crie uma ligação separada e um pipeline separado para cada caixa de correio. O valor da caixa de correio é carimbado como uma mailbox coluna em cada linha.
Interface Os passos para criar um pipeline dependem da interface.
Frequência de ingestão O cronograma do pipeline depende da sua latência e dos seus requisitos de custo.

Comece a ingerir a partir do Gmail

A tabela seguinte apresenta uma visão geral do fluxo de ingestão do Gmail de ponta a ponta, com base no tipo de utilizador:

User Steps
Administrador
Não administrador Use qualquer interface suportada para criar um pipeline a partir de uma ligação existente. Consulte Ingestir dados do Gmail.

Recursos adicionais

  • Last updated on