Configure o OAuth para ingestão no HubSpot.

Aprenda como configurar o HubSpot para importar dados do HubSpot Marketing Hub para o Databricks. O conector de gerenciamento do HubSpot no LakeFlow Connect usa autenticação OAuth 2.0 de usuário para máquina (U2M). Utilize os detalhes de autenticação que você obtém nos passos desta página para criar uma conexão Unity Catalog no Databricks.

nota

O HubSpot descontinuou a UI de criação de aplicativo público legado. Crie seu aplicativo usando a plataforma baseada em projeto da HubSpot e a CLI da HubSpot, conforme descrito nesta página. Consulte o registro de alterações do HubSpot para obter detalhes.

Instalar e autenticar a CLI do HubSpot

1. Instale o Node.js versão 20 ou acima.

2. Instale a CLI do HubSpot:

   Bash

   npm install -g @hubspot/cli

3. Autentique a CLI com sua account HubSpot:

   Bash

   hs account auth

   Siga os prompts para gerar uma key de acesso pessoal e salve-a na sua configuração local da CLI.

Criar um aplicativo e recuperar detalhes de autenticação

1. Crie um aplicativo na plataforma baseada em projeto da HubSpot:

   Bash

   hs project create --project-base app --auth oauth --distribution private

2. No arquivo app-hsmeta.json gerado, defina auth.redirectUrls como a URL de redirecionamento do seu workspace (formato: https://<your_workspace_domain>/login/oauth/lakehousefederation.html). Por exemplo: https://e2.our-staging-workspace.cloud.databricks.com/login/oauth/lakehousefederation.html

3. No mesmo arquivo, defina auth.requiredScopes apenas para os seguintes escopos. Omitir qualquer um destes ou adicionar escopos adicionais causará falhas mais tarde no processo de configuração.

   • oauth
   • communication_preferences.read
   • content
   • crm.objects.marketing_events.read
   • crm.objects.marketing_events.write
   • forms
   • forms-uploaded-files
   • marketing.campaigns.read

4. Implantar o aplicativo na sua conta HubSpot:

   Bash

   hs project upload

5. Recupere os detalhes de autenticação do aplicativo:

   Bash

   hs project open

   Em Componentes do Projeto , selecione seu aplicativo e clique na tab . Observe a ID do Cliente e o Segredo do Cliente . Use-os para criar uma conexão do Unity Catalog no Databricks.

6. Instale o aplicativo na sua account HubSpot:

   1. Acesse **Desenvolvimento > Projetos**.
   2. Selecione seu projeto e, em seguida, seu aplicativo.
   3. Na tab Distribuição , clique em Instalar agora e autorize o aplicativo.

Migrar um aplicativo legado

Se já houver um aplicativo público legado configurado para ingestão do HubSpot, migre-o para a plataforma baseada em projetos em vez de criar um novo aplicativo. A migração preserva o ID de Cliente, o segredo do Cliente e as instalações existentes do aplicativo, portanto, não é necessário atualizar a conexão do Unity Catalog.

1. Atualize a CLI do HubSpot para a versão 7.6.0 ou posterior:

   Bash

   npm install -g @hubspot/cli@latest

2. Execute o comando de migração e siga as instruções para selecionar seu aplicativo e confirmar os componentes a serem migrados:

   Bash

   hs app migrate

Para obter detalhes, consulte o guia de migração da HubSpot.

Próximos passos

Use o Explorador de Catálogos para criar uma conexão para que qualquer usuário com USE CONNECTION ou ALL PRIVILEGES possa criar pipelines. Consulte Criar uma conexão HubSpot.