Conector do 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.

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

O conector lê de uma única caixa de correio por conexão usando uma conta de serviço do Google, e é somente leitura. Ele nunca modifica a caixa de correio de origem. As tabelas messages e message_labels são sincronizadas incrementalmente usando a API de histórico do Gmail. As outras tabelas são reingeridas na íntegra a cada execução do pipeline.

Disponibilidade de recursos

O Gmail é independente de cloud. A seguinte disponibilidade de recurso se aplica na AWS e no GCP.

Recurso	Disponibilidade
Criação de pipeline baseada na interface do usuário	Apoiado
Autoria de pipeline baseada em API	Apoiado
Pacotes de Automação Declarativa	Apoiado
Ingestão incremental	Apoiado Apenas para as tabelas messages e message_labels. As outras tabelas são apenas para refresh completo.
Governança do Unity Catalog	Apoiado
Orquestração usando o Databricks Workflows	Apoiado
SCD tipo 2	Não suportado Configurar o SCD Tipo 2 para a tabela messages ou message_labels faz com que a validação do pipeline falhe.

Recurso	Disponibilidade
Criação de pipeline baseada na interface do usuário	Apoiado
Autoria de pipeline baseada em API	Apoiado
Pacotes de Automação Declarativa	Apoiado
Ingestão incremental	Apoiado Apenas para as tabelas messages e message_labels. As outras tabelas são apenas para refresh completo.
Governança do Unity Catalog	Apoiado
Orquestração usando o Databricks Workflows	Apoiado
SCD tipo 2	Não suportado Configurar o SCD Tipo 2 para a tabela messages ou message_labels faz com que a validação do pipeline falhe.

Métodos de autenticação

Método de autenticação	Disponibilidade
Conta de serviço do Google (conta de serviço OAuth com delegação em todo o domínio)	Apoiado
OAuth U2M	Não suportado
Autenticação básica (nome de usuário/senha)	Não suportado

Método de autenticação	Disponibilidade
Conta de serviço do Google (conta de serviço OAuth com delegação em todo o domínio)	Apoiado
OAuth U2M	Não suportado
Autenticação básica (nome de usuário/senha)	Não suportado

O conector autentica-se no Gmail com uma conta de serviço Google. Você concede à conta de serviço 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 os passos de configuração, consulte Configurar Gmail para ingestão do Databricks.

O que saber antes de começar

tópico	Por que isso é importante
Persona do usuário do Databricks	O fluxo de trabalho depende do seu perfil de usuário do 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 que usuários não administradores criem pipelines.
Método de autenticação	O conector autentica-se com uma conta de serviço do Google que representa uma única caixa de correio.
Uma única caixa de correio por conexão.	Cada conexão ingere uma caixa de correio. Para ingerir mais de uma caixa de correio, crie uma conexão e um pipeline separados por caixa de correio. O valor da caixa de correio é marcado como uma coluna mailbox em cada linha.
Interface	Os passos para criar um pipeline dependem da interface.
Frequência de ingestão	O agendamento do pipeline depende dos seus requisitos de latência e custo.

tópico	Por que isso é importante
Persona do usuário do Databricks	O fluxo de trabalho depende do seu perfil de usuário do 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 que usuários não administradores criem pipelines.
Método de autenticação	O conector autentica-se com uma conta de serviço do Google que representa uma única caixa de correio.
Uma única caixa de correio por conexão.	Cada conexão ingere uma caixa de correio. Para ingerir mais de uma caixa de correio, crie uma conexão e um pipeline separados por caixa de correio. O valor da caixa de correio é marcado como uma coluna mailbox em cada linha.
Interface	Os passos para criar um pipeline dependem da interface.
Frequência de ingestão	O agendamento do pipeline depende dos seus requisitos de latência e custo.

Começar a ingerir do Gmail

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

Usuário	os passos
Administrador	Configure uma account de serviço do Google Cloud para habilitar a autenticação a partir do Databricks. Consulte Configure o Gmail para ingestão no Databricks. Ou: Use o Catalog Explorer para criar uma conexão com o Gmail para que não administradores possam criar pipelines. Consulte Criar uma conexão com o Gmail. Use a interface do usuário de ingestão de dados para criar uma conexão e um pipeline ao mesmo tempo. Consulte Ingerir dados do Gmail.
Não administrador	Use qualquer interface compatível para criar um pipeline a partir de uma conexão existente. Consulte Ingerir dados do Gmail.

Usuário	os passos
Administrador	Configure uma account de serviço do Google Cloud para habilitar a autenticação a partir do Databricks. Consulte Configure o Gmail para ingestão no Databricks. Ou: Use o Catalog Explorer para criar uma conexão com o Gmail para que não administradores possam criar pipelines. Consulte Criar uma conexão com o Gmail. Use a interface do usuário de ingestão de dados para criar uma conexão e um pipeline ao mesmo tempo. Consulte Ingerir dados do Gmail.
Não administrador	Use qualquer interface compatível para criar um pipeline a partir de uma conexão existente. Consulte Ingerir dados do Gmail.

Outros recursos

• FAQs do conector Gmail
• Limitações do conector do Gmail
• Referência do conector do Gmail
• Solucionar problemas de ingestão do Gmail