Solucionar problemas de ingestão do Gmail

Esta página descreve problemas comuns com o conector de ingestão do Gmail no Databricks Lakeflow Connect e como resolvê-los.

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.

Para obter orientações gerais de solução de problemas aplicáveis a todos os pipelines de ingestão gerenciados, consulte Solucionar problemas de pipelines de ingestão gerenciados.

Erro de autenticação (401)

Uma resposta 401 significa que o conector não pôde autenticar-se no Gmail com a conta de serviço. Verifique o seguinte:

1. Confirme se você colou a key JSON da service account completa e não modificada ao criar a conexão do Unity Catalog. Uma chave truncada ou malformada causa falha na autenticação.
2. Confirme se a conta de serviço tem delegação em todo o domínio autorizada para o escopo https://www.googleapis.com/auth/gmail.readonly no Console de Administração do Google. Consulte Conceder delegação em todo o domínio.
3. Confirme se a caixa de correio que você está representando existe e está dentro do domínio do Google Workspace para o qual a conta de serviço está autorizada a delegar.
4. Se você girou ou excluiu a chave da service account, crie uma nova chave e atualize a conexão.

Erro de cota ou limite de taxa (429 ou 403)

O Gmail impõe cotas de API por usuário e por projeto. Quando o Gmail retorna uma resposta HTTP 403, o conector lê o cabeçalho Retry-After (com um backoff mínimo de 1 segundo) e tenta novamente a solicitação automaticamente, portanto, a limitação de taxa transitória geralmente é resolvida sem ação.

Se um pipeline continuar falhando com erros de cota:

• Reduza a frequência do cronograma do pipeline para diminuir o uso da API.
• Confirme se a API do Gmail está habilitada e se a cota do seu projeto do Google Cloud é suficiente no console do Google Cloud em APIs e Serviços > Cotas .

Expiração do historyId

As tabelas messages e message_labels usam um cursor historyId armazenado para sincronização incremental. Se o pipeline for executado com menos frequência do que o período de retenção do histórico do Gmail, o Gmail expira o cursor e a API de Histórico retorna um erro 404. Nesse caso, o conector retorna automaticamente para um refresh completo da tabela afetada, portanto, nenhuma ação é necessária. Para evitar refreshes completos, programe o pipeline para ser executado com frequência suficiente para que o cursor permaneça dentro da janela de retenção do Gmail.

Obter ajuda

Se um problema persistir após seguir estes passos de solução de problemas, envie um tíquete de suporte.