Exportar dados do HubSpot para PostgreSQL ou MySQL

Observe: se você for um Superadministrador, escolha sua conta no Data Studio beta para usar este recurso.

Resumo

Use Saída de dados para exportar os dados selecionados do CRM da HubSpot para um banco de dados PostgreSQL ou MySQL gerenciado por você. Você pode sincronizar dados de objeto, associação e eventos com tabelas em seu banco de dados e, em seguida, consultar os dados com SQL ou usá-los com suas ferramentas de business intelligence e análise.

Cada sincronização cria um instantâneo completo dos dados selecionados. Quando uma sincronização é bem-sucedida, ela substitui o snapshot anterior nas tabelas de destino.

Antes de começar

Noções básicas sobre os requisitos

• Seu banco de dados PostgreSQL ou MySQL deve estar acessível a partir dos intervalos de IP do HubSpot para a região da sua conta.
• Seu servidor de banco de dados deve suportar conexões SSL.
• Você deve ter um usuário de banco de dados com as permissões necessárias:
  • PostgreSQL: CREATE permissão e acesso de gravação ao esquema de destino.
  • MySQL: CREATE permissão no banco de dados e acesso de gravação.
• Certifique-se de que o usuário do banco de dados possa criar tabelas e gravar dados.
• Mantenha sua conta da HubSpot e consoles de banco de dados abertos em guias separadas.

Permitir endereços IP da HubSpot

Adicione o intervalo de IP do HubSpot para a região da sua conta na lista de permissões do servidor de banco de dados.

Compreender limitações e considerações

• Cada execução de sincronização cria um instantâneo completo dos dados selecionados.
• Uma sincronização bem-sucedida substitui o instantâneo anterior nas tabelas de destino.
• O HubSpot não retém instantâneos anteriores.
• Se uma tabela falhar durante uma sincronização, seus dados anteriores permanecerão disponíveis até a próxima sincronização bem-sucedida.
• Cada tipo de objeto, tipo de evento ou par de associação pode ser incluído em uma sincronização recorrente do PostgreSQL e uma sincronização recorrente do MySQL por conta.
• Cada sincronização substitui a tabela de destino. As concessões ou configurações em nível de tabela adicionadas ao seu provedor de banco de dados não são preservadas entre as sincronizações.
• Se você se reconectar usando um usuário de banco de dados diferente, deverá conceder a esse usuário acesso a esquemas, bancos de dados ou tabelas gerenciados pela HubSpot existentes.

Conectar o HubSpot ao PostgreSQL ou MySQL

1. Na sua conta HubSpot, clique em Mais e navegue até Gerenciamento de dados > Data Studio. Se Mais não aparecer na sua conta, navegue diretamente para Gerenciamento de dados > Data Studio.
2. No canto superior direito, clique em Conectar fonte de dados externa.
3. No painel Adicionar uma fonte de dados , pesquise ou navegue até o provedor de banco de dados.
4. Clique em PostgreSQL ou MySQL.
5. Insira os detalhes da conexão com o banco de dados:
   • Anfitrião
   • Porta
   • SSL
   • Nome de usuário
   • Palavra-passe
6. Para PostgreSQL, insira o nome do banco de dados em que o HubSpot deve criar o esquema.
7. Clique em Conectar ao PostgreSQL ou Conectar ao MySQL.

O HubSpot usa o usuário do banco de dados conectado para criar tabelas e carregar dados em seu banco de dados.

Configurar a sincronização

1. Selecione as fontes de dados para exportar:
   • Objetos
   • Associações
   • Eventos
2. Selecione os objetos, propriedades, associações ou eventos a incluir.
3. Escolha com que frequência executar a sincronização e quando iniciá-la.
4. Clique em Iniciar sincronização.

As frequências de sincronização disponíveis podem variar durante a versão beta. As opções podem incluir uma vez, a cada 6 horas, a cada 12 horas, diariamente, semanalmente ou mensalmente.

Acesse seus dados exportados

O HubSpot cria um esquema ou banco de dados gerenciado pela HubSpot para cada destino.

PostgreSQL

As tabelas PostgreSQL usam o seguinte formato:

<database>.hubspot_data_out_<destination-id>.<table-name>

Por exemplo:

your_database.hubspot_data_out_456."OBJECT_WITH_OBJECT_PROPERTIES"
your_database.hubspot_data_out_456."EVENTS_VISITED_PAGE"
your_database.hubspot_data_out_456."ASSOCIATIONS_CONTACTS_TO_COMPANIES"

MySQL

As tabelas MySQL usam o seguinte formato:

hubspot_data_out_<destination-id>.<table-name>

Por exemplo:

hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES
hubspot_data_out_456.EVENTS_VISITED_PAGE
hubspot_data_out_456.ASSOCIATIONS_CONTACTS_TO_COMPANIES

Você pode encontrar o nome exato do esquema ou banco de dados na página de configuração de sincronização.

Nomes de tabelas e colunas

Os nomes das tabelas e colunas são baseados nos dados exportados. Os identificadores do PostgreSQL podem conter até 63 caracteres. Os identificadores MySQL podem conter até 64 caracteres. Nomes mais longos são encurtados para se ajustarem ao limite aplicável.

O HubSpot cria tabelas e colunas do PostgreSQL com nomes entre aspas e preservados em maiúsculas e minúsculas. Ao consultar o PostgreSQL, use aspas duplas e corresponda às letras maiúsculas mostradas no nome da tabela e no nome da coluna.

Para MySQL, use acentos graves e corresponda à capitalização mostrada. A diferenciação de maiúsculas e minúsculas do nome da tabela pode variar dependendo da configuração do servidor MySQL.

Tipos de coluna

A PROPERTIES coluna na tabela é armazenada OBJECT_WITH_OBJECT_PROPERTIES como uma string formatada em JSON. Ele é armazenado como TEXT no PostgreSQL e LONGTEXT no MySQL, não como um tipo de coluna JSON nativo.

Tabelas de Objetos

Se você selecionar dados do objeto, o HubSpot exportará as tabelas a seguir.

OBJECT_PROPERTIES

Esta tabela contém uma linha para cada valor de objeto propriedade.

OBJECT_WITH_OBJECT_PROPERTIES

Esta tabela contém uma linha para cada objeto registro. Os valores de propriedade selecionados são agrupados na PROPERTIES coluna.

Os dados de Objeto para diferentes tipos de objetos são combinados nesta tabela. Filtrar por OBJECTTYPEID para ler registros de um tipo de objeto específico.

• Contatos: 0-1
• Objetos personalizados: 2-{unique_id}, como 2-12345

OBJECT_PROPERTIES_HISTORY

Esta tabela contém o histórico de alterações de propriedade. Inclui uma linha para cada valor histórico de uma propriedade.

Para exibir o histórico completo de um registro e propriedade específicos, ordene os resultados por UPDATEDAT.

Tabelas de Associação

Se você selecionar associação dados, o HubSpot exportará associação registros e associação definições.

ASSOCIATIONS

Esta tabela contém uma linha para cada associação selecionada entre dois registros.

ASSOCIATION_DEFINITIONS

Esta tabela contém uma linha para cada definição de associação selecionada.

Tabelas de associação específicas de pares

Para os pares de associação selecionados, o HubSpot também pode exportar tabelas com o seguinte formato:

ASSOCIATIONS_<FROM_OBJECT_TYPE>_TO_<TO_OBJECT_TYPE>

Por exemplo:

ASSOCIATIONS_CONTACTS_TO_COMPANIES

Estas tabelas contêm registros de associação e metadados de definição de associação.

Tabelas de eventos

Se você selecionar dados do evento, o HubSpot exportará uma tabela para cada tipo de evento. Os nomes das tabelas de eventos usam o seguinte formato:

EVENTS_<EVENT_NAME>

Por exemplo:

EVENTS_VISITED_PAGE

Cada tabela de eventos contém colunas de eventos padrão e uma coluna para cada propriedade de evento selecionada.

Monitore sua sincronização

1. Na sua conta HubSpot, clique em Mais e navegue até Gerenciamento de dados > Integração de dados. Se Mais não aparecer na sua conta, navegue diretamente para Gerenciamento de dados > Integração de dados.
2. À esquerda, clique em Sincronizações de aplicativos.
3. Pesquise ou selecione a sincronização do PostgreSQL ou do MySQL.

Na página de detalhes da sincronização, você pode visualizar o status de sincronização, a hora da última sincronização, os erros, a atividade de sincronização e o histórico de sincronização. Você também pode pausar, arquivar ou executar manualmente a sincronização.

Status de sincronização

Resolver falhas de sincronização

Quando uma sincronização falha:

• A interface de usuário do HubSpot mostra um status de Falha e detalhes em nível de tabela indicando quais tabelas foram bem-sucedidas ou falhar.
• Uma tabela é atualizada somente depois que o HubSpot termina de carregar todos os seus dados.
• Se uma tabela falhar, seus dados anteriores permanecerão em vigor até a próxima sincronização bem-sucedida.
• A próxima sincronização agendada tenta automaticamente a sincronização completa novamente.
• Você pode executar manualmente uma sincronização a partir da página de detalhes da sincronização.

As tabelas que foram bem-sucedidas durante uma execução anterior não são modificadas quando uma execução posterior falha.

FAQs

Como consultar os dados exportados?

Consulte as tabelas no esquema ou banco de dados de destino com SQL.

PostgreSQL

-- Read all contact records
SELECT *
FROM your_database.hubspot_data_out_456."OBJECT_WITH_OBJECT_PROPERTIES"
WHERE "OBJECTTYPEID" = '0-1';

-- Read a property from the PROPERTIES column
SELECT
  "OBJECTID",
  json_extract_path_text("PROPERTIES"::json, 'email') AS email
FROM your_database.hubspot_data_out_456."OBJECT_WITH_OBJECT_PROPERTIES"
WHERE "OBJECTTYPEID" = '0-1';

MySQL

-- Read all contact records
SELECT *
FROM `hubspot_data_out_456`.`OBJECT_WITH_OBJECT_PROPERTIES`
WHERE `OBJECTTYPEID` = '0-1';

-- Read a property from the PROPERTIES column
SELECT
  `OBJECTID`,
  JSON_EXTRACT(`PROPERTIES`, '$.email') AS email
FROM `hubspot_data_out_456`.`OBJECT_WITH_OBJECT_PROPERTIES`
WHERE `OBJECTTYPEID` = '0-1';

Posso exportar um tipo de dados em várias sincronizações?

Cada tipo de objeto, tipo de evento ou par de associação pode ser incluído em uma sincronização recorrente do PostgreSQL e uma sincronização recorrente do MySQL por conta da HubSpot.

Por exemplo, se os contatos já foram exportados para um destino PostgreSQL recorrente, você não poderá adicioná-los a outra configuração PostgreSQL recorrente até arquivar a primeira configuração. Você ainda pode exportar contatos para uma configuração recorrente do MySQL ao mesmo tempo.

Há suporte para tabelas específicas de objetos?

Tabelas específicas de objetos, como OBJECTS_CONTACTS, não são suportadas no momento. Use OBJECT_WITH_OBJECT_PROPERTIES e filtre por OBJECTTYPEID para recuperar registros de um tipo de objeto específico.

Dados confidenciais são compatíveis?

Dados confidenciais não são compatíveis atualmente com Dados de saída. Propriedades confidenciais podem ser excluídas das exportações.

O HubSpot mantém instantâneos anteriores?

Não. Cada sincronização bem-sucedida substitui a tabela de destino pelo instantâneo mais recente. O HubSpot não retém instantâneos anteriores.

Se uma tabela falhar durante uma sincronização, seus dados anteriores permanecerão em vigor até que a tabela seja atualizada com sucesso.

A HubSpot usa um bucket de staging que eu gerencio?

Não. O HubSpot exporta os dados como Parquet e gerencia o staging internamente. Você não precisa fornecer um bucket de preparo de propriedade do cliente para PostgreSQL ou MySQL.

O que acontece se eu alterar o usuário do banco de dados?

Se você reconectar usando um usuário de banco de dados diferente, deverá conceder ao novo usuário acesso a esquemas, bancos de dados ou tabelas gerenciados pela HubSpot existentes.