Perguntas frequentes sobre o conector do Gmail
Beta
Este recurso está em Beta.
Esta página responde a perguntas frequentes sobre o conector do Gmail no Databricks Lakeflow Connect.
Perguntas frequentes sobre conectores gerenciados
As respostas nas Perguntas frequentes sobre conectores gerenciados aplicam-se a todos os conectores gerenciados no Lakeflow Connect. Continue lendo para ver as perguntas frequentes específicas do Gmail.
Perguntas frequentes específicas do conector
As respostas nesta seção são específicas para o conector do Gmail.
De qual caixa de correio o conector faz a leitura?
O conector faz a leitura de uma única caixa de correio por conexão. A service account personifica a caixa de correio que você especificar com delegação em todo o domínio e a opção de conector mailbox (default me). O conector marca o valor da caixa de correio como uma coluna mailbox em cada linha.
Quais tabelas são sincronizadas incrementalmente e quais são de refresh completo?
As tabelas messages e message_labels são sincronizadas incrementalmente usando a API Gmail History. As tabelas profile, labels, labels_details, drafts e filters são apenas de refresh completo e são reingeridas na íntegra a cada execução do pipeline.
Como os anexos são ingeridos?
Os anexos estão contidos na coluna payload da tabela messages, em payload.parts[].body.attachmentId. Não existe uma tabela de anexos separada.
Como ingerir mais de uma caixa de correio?
Cada conexão ingere uma única caixa de correio. Para ingerir múltiplas caixas de correio, crie uma conexão e um pipeline separados para cada caixa de correio. Você pode distinguir caixas de correio em suas tabelas de destino usando a coluna mailbox.
O que acontece se o historyId expirar?
O conector armazena um cursor historyId para buscar alterações incrementais. Se o Gmail expirar o cursor (a API de história retorna um 404 porque o cursor é mais antigo que a janela de retenção do Gmail), o conector automaticamente recorre a um refresh completo da tabela afetada. Para evitar isso, programe o pipeline para execução pelo menos uma vez a cada sete dias, o que mantém o cursor dentro da janela de retenção do Gmail.
O conector pode modificar minha caixa de correio?
Não. O conector é somente leitura. Ele exige o escopo https://www.googleapis.com/auth/gmail.readonly e comunica-se apenas com https://gmail.googleapis.com. Ele nunca modifica a caixa de correio de origem.