Conector de Gmail

Importante

Esta característica se encuentra en su versión beta. Los administradores del área de trabajo pueden controlar el acceso a esta característica desde la página Vistas previas . Consulte Administrar versiones preliminares de Azure Databricks.

El conector gestionado de Gmail en Lakeflow Connect ingiere mensajes, etiquetas, borradores y filtros desde un buzón de Gmail hacia Azure Databricks.

El conector lee desde un único buzón por conexión usando una cuenta de servicio de Google, y es de solo lectura. Nunca modifica el buzón de origen. Las messages tablas y message_labels se sincronizan de forma incremental usando la API de Historial de Gmail. Las demás tablas se vuelven a ingerir completamente en cada ejecución de canalización.

Disponibilidad de funcionalidades

La siguiente tabla enumera la disponibilidad del conector de Gmail.

Feature Disponibilidad
Creación de canalizaciones basadas en la interfaz de usuario Icono de verificación verde compatibles
Creación de canalizaciones basadas en API Icono de verificación verde compatibles
Agrupaciones de automatización declarativa Icono de verificación verde compatibles
Ingesta incremental Icono de verificación verde compatibles
Solo para las tablas messages y message_labels. Las otras tablas solo admiten actualización completa.
Gobernanza del catálogo de Unity Icono de verificación verde compatibles
Orquestación mediante flujos de trabajo de Databricks Icono de verificación verde compatibles
SCD de tipo 2 Icono X rojo No se admite
La configuración de SCD de tipo 2 para la tabla messages o message_labels hace que falle la validación de la canalización.

Métodos de autenticación

Método de autenticación Disponibilidad
Cuenta de servicio de Google (cuenta de servicio OAuth con delegación a nivel de dominio) Icono de verificación verde compatibles
OAuth U2M Icono X rojo No se admite
Autenticación básica (nombre de usuario y contraseña) Icono X rojo No se admite

El conector se autentica a Gmail con una cuenta de servicio de Google. Concede a la cuenta de servicio una delegación de dominio para el ámbito https://www.googleapis.com/auth/gmail.readonly y elige el buzón que la cuenta de servicio suplanta. Para los pasos de configuración, consulta Configurar Gmail para la ingestión de Azure Databricks.

Qué saber antes de empezar

Topic ¿Por qué es importante?
Rol de usuario de Azure Databricks El flujo de trabajo depende del rol de usuario de Azure Databricks:
  • Usuario único: un usuario administrador crea una conexión de Unity Catalog y una canalización de ingestión.
  • Multiusuario: un usuario administrador crea una conexión para que los usuarios que no son administradores creen canalizaciones con.
Método de autenticación El conector se autentica con una cuenta de servicio de Google que suplanta la identidad de un único buzón de correo.
Buzón único por conexión Cada conexión ingiere un buzón. Para incorporar más de un buzón, crea una conexión y una canalización independientes para cada buzón. El valor del buzón aparece como una columna mailbox en cada fila.
Interfaz Los pasos para crear una canalización dependen de la interfaz .
Frecuencia de ingesta La programación del pipeline depende de tus requisitos de latencia y costo.

Empieza a ingerir desde Gmail

La siguiente tabla ofrece una visión general del flujo de ingesta de Gmail de extremo a extremo, según el tipo de usuario:

Usuario Steps
Admin
Sin derechos de administrador Use cualquier interfaz compatible para crear una canalización a partir de una conexión existente. Consulta Importar datos de Gmail.

Recursos adicionales