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

Solucionar problemas do conector HubSpot

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. Execute hs project open para abrir seu aplicativo no HubSpot.
  2. Em Componentes do Projeto, selecione seu aplicativo e clique na tab Auth.
  3. Confirme se todos os escopos necessários estão selecionados. Para a lista completa de escopos necessários, consulte Configurar o OAuth para ingestão do HubSpot.
  4. Se você alterar qualquer escopo, reimplante o aplicativo com hs project upload e, em seguida, crie uma nova conexão do 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 da conexão, consulte Criar uma conexã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 (por exemplo, 100 requisições a cada 10 segundos para aplicativos gratuitos). Ao ingerir várias tabelas simultaneamente, você pode atingir esses limites de taxa, o que torna o processo de ingestão mais lento. O conector tenta novamente, automaticamente, as solicitações que atingem o limite de taxa.

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.
Nesta página