Exportar dados do HubSpot para o Amazon Redshift

Resumo

Exporte objetos, associações e eventos do CRM da HubSpot para o Amazon Redshift usando o aplicativo Amazon Redshift no HubSpot Marketplace. Você pode escolher os dados a exportar, configurar uma programação de sincronização e monitorar a atividade de sincronização do HubSpot.

Este artigo aborda como instalar e conectar o aplicativo, configurar uma sincronização de exportação de dados e monitorar ou gerenciar a sincronização.

Observação: se você for um superadministrador, poderá incluir sua conta na versão beta da integração aprimorada do Amazon Redshift.

Antes de começar

Noções básicas sobre os requisitos

Certifique-se de ter o seguinte:

• Uma função do AWS Identity and Access Management (IAM) conectada à sua conta da HubSpot e configurada para acessar sua conta da AWS.
• Um cluster provisionado do Amazon Redshift ou um grupo de trabalho sem servidor que o HubSpot pode acessar.
• Um bucket do Amazon S3 para preparar arquivos Parquet temporários. O bucket deve estar na mesma região da AWS que o cluster do Redshift ou o grupo de trabalho sem servidor. 
• O HubSpot copia arquivos Parquet temporários para o bucket de staging configurado do Amazon S3 e não os exclui. Para remover arquivos mais antigos e gerenciar os custos de armazenamento, crie uma regra de ciclo de vida do S3 na sua conta da AWS.
• Um administrador do Redshift que pode executar uma concessão única de SQL no banco de dados de destino.
• Acesso aos consoles do HubSpot e do AWS. É recomendado abri-los em guias separadas.

Compreender limitações e considerações

• Cada sincronização produz um instantâneo completo dos dados selecionados.
• Cada sincronização substitui a tabela de destino. Todas as concessões ou configurações em nível de tabela adicionadas no Redshift não são preservadas entre as sincronizações.
• Você controla a valor dos dados exportados selecionando quais objetos, associações e eventos incluir.
• Se uma sincronização falhar, a próxima sincronização agendada tentará automaticamente a sincronização completa novamente.

Instalar e conectar o aplicativo Amazon Redshift

1. No HubSpot App Marketplace, abra a listagem de aplicativos Amazon Redshift.
2. Selecione a função do AWS conectada à sua conta da HubSpot.
3. Clique emInstalar.
4. Clique em Próximo.
5. Crie uma função do AWS IAM conectada à sua conta da HubSpot e configurada para acessar sua conta da AWS.
6. Insira o nome de recurso da Amazon (ARN) da função.
7. Clique em Conectar-se ao Amazon Redshift.

Configure sua função na AWS

O HubSpot usa a função do AWS conectada para gravar arquivos Parquet temporários no bucket de preparação do S3 e carregar os arquivos no Redshift.

1. No campo URL do bucket do S3 , insira o URL do bucket do S3 que o HubSpot usará para preparar arquivos Parquet temporários.

Você pode incluir um prefixo na URL para limitar o acesso a um caminho específico dentro do bucket. O bucket deve estar na mesma região da AWS que o cluster do Redshift ou o grupo de trabalho sem servidor.

Observação: O HubSpot copia os arquivos Parquet para o bucket de preparação do S3 configurado por design e não os exclui. Crie uma regra de ciclo de vida do S3 na AWS para remover automaticamente arquivos mais antigos.

2. Selecione o tipo de implantação do Redshift no menu suspenso:
   • Redshift sem servidor
   • Cluster provisionado
3. Atualize a função da AWS conectada com a política de permissões para o tipo de implantação:
   • Redshift Serverless: insira o ARN do grupo de trabalho. A HubSpot gerará uma política contendo o ARN. Copie a política e anexe-a à função da AWS conectada.
   • Cluster provisionado: copie o modelo de política. Substitua YOUR_REGION, YOUR_ACCOUNT_ID, YOUR_CLUSTER_IDe YOUR_DATABASE por valores da sua conta da AWS e anexe a política à função da AWS conectada.
4. No AWS IAM, abra a função conectada ao HubSpot.
5. Anexe a política de permissões gerada à função ou crie uma política embutida com o conteúdo da política.

6. Na mesma função do AWS IAM, atualize a política de confiança com a instrução gerada pelo HubSpot.

A HubSpot gera uma declaração de política de confiança diferente com base no tipo de implantação do Redshift que você selecionou.

Associar a função da AWS ao Redshift

No Amazon Redshift, associe a mesma função da AWS que você atualizou na seção anterior à sua configuração do Redshift.

• Redshift Sem servidor: abra a página de configuração do namespace para o namespace que você usa com o HubSpot. Na guia Segurança e criptografia , clique em Gerenciar funções do IAM e selecione Associar funções do IAM.
• Cluster provisionado: abra o cluster, clique em Ações e selecione Gerenciar funções > do IAM Associe funções do IAM.

Conceder permissões do Redshift

1. No HubSpot, selecione o banco de dados de destino.
2. Peça a um administrador do Redshift para executar o script SQL no banco de dados selecionado.

O HubSpot usa essa permissão para criar um esquema para o destino durante a sincronização.

3. Clique em Testar conexão.
4. Se o teste de conexão for bem-sucedido, clique em Avançar.

Configurar a sincronização de exportação de dados

1. Selecione as fontes de dados a exportar.
2. Selecione os objetos, associações e tabelas de eventos a serem incluídos.
3. Configure a frequência de sincronização e a hora de início.
4. Clique em Iniciar sincronização.

Cada execução de sincronização exporta um snapshot completo dos dados selecionados para o Amazon Redshift.

Monitorar e gerenciar a sincronização

Na página de detalhes da sincronização, você pode revisar as seguintes informações:

• Status de sincronização.
• Hora da última sincronização.
• Erros.
• Atividade de sincronização.
• Histórico de sincronização.

Para abrir a página de detalhes da sincronização:

1. Na sua conta da HubSpot, acesse Integração de dados de gerenciamento > .
2. Na guia Sincronizações de aplicativos , pesquise Sincronizações de aplicativos do Amazon Redshift.
3. Clique na sincronização do Amazon Redshift que você deseja revisar.

Na página de detalhes da sincronização, você também pode realizar as seguintes ações:

• Clique em Pausar para pausar a sincronização.
• Clique em Arquivar para arquivar a sincronização.
• Clique em Sincronizar agora para iniciar manualmente uma sincronização.

Status de sincronização

Resolver falhas de sincronização

Quando uma sincronização falha:

• A sincronização exibe um status de Falha no HubSpot.
• Os detalhes por tabela mostram quais tabelas foram bem-sucedidas ou falharam.
• A próxima sincronização agendada tenta automaticamente a sincronização completa novamente.
• Você pode clicar em Sincronizar agora para iniciar manualmente outra sincronização.