Pular para o conteúdo principal
Última atualização em

Solucionar problemas do conector HubSpot

info

Beta

Este recurso está em versão Beta. Os administradores do espaço de trabalho podem controlar o acesso a este recurso na página de Pré-visualizações . Veja as prévias do Gerenciador Databricks.

Aprenda a solucionar problemas comuns com o conector de gerenciamento do HubSpot no LakeFlow Connect.

Erro de escopo durante a criação da conexão ou execução do pipeline.​

Mensagem de erro:

SCOPE Error

Causa:

Esse erro ocorre quando o aplicativo HubSpot não possui os escopos OAuth necessários.

par:

Confirme se o aplicativo conectado no HubSpot possui os escopos OAuth necessários:

  1. Visite a página de configuração do aplicativo HubSpot em https://app-na2.hubspot.com/legacy-apps/<hubspot-id>.
  2. Acesse as configurações de autenticação do seu aplicativo.
  3. Em Escopos > Escopos obrigatórios , confirme se todos os escopos obrigatórios estão selecionados. Para obter a lista completa dos escopos necessários, consulte Configurar OAuth para ingestão no HubSpot.
  4. Salve as alterações e crie uma nova conexão Unity Catalog no Databricks.

Para obter detalhes sobre a configuração do aplicativo, consulte Configurar OAuth para ingestão no HubSpot.

Para obter detalhes sobre a criação de conexões, consulte o HubSpot.

Execução lenta do oleoduto​

Sintoma:

O pipeline demora muito tempo ou parece estar travado.

Causa:

A HubSpot impõe limites de taxa de requisições à API, incluindo um limite de 10 segundos por requisição. Ao ingerir várias tabelas simultaneamente, você pode atingir esses limites de taxa, o que torna o processo de ingestão mais lento.

Além disso, algumas tabelas podem demorar muito para serem processadas devido à alta demanda por chamadas à API. Por exemplo, a tabela marketing_campaign_asset requer 24 chamadas de API separadas por campanha. Se você tiver 100 campanhas, precisará de aproximadamente 2.400 chamadas de API para essa única tabela, em comparação com cerca de 5 chamadas de API para tabelas mais simples. Espere tempos de sincronização longos para essas tabelas. Por exemplo, uma tabela com 5.000 campanhas pode levar aproximadamente de quatro a seis horas.

Para obter a lista completa de tabelas aplicáveis, consulte Tabelas que suportam apenas atualizações de lotes.

par:

Para garantir um desempenho de ingestão consistente:

  • Limite o número de tabelas que você ingere ao mesmo tempo.
  • Divida as tabelas em vários pipelines e programe-as em momentos diferentes.
  • Monitore o progresso do seu pipeline e ajuste sua estratégia de programação com base nos tempos de sincronização reais.