BetaAcesse seus dados do HubSpot do PostgreSQL ou MySQL

Use a saída de dados para PostgreSQL e MySQL para exportar os dados selecionados do CRM da HubSpot para tabelas em um banco de dados de sua propriedade. Cada execução de sincronização grava um instantâneo completo dos dados selecionados e substitui o instantâneo anterior. Após a sincronização, você pode consultar as tabelas com SQL ou com suas ferramentas de BI e análise preferidas para combinar dados do HubSpot com outros dados comerciais.

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

Compreender limitações e considerações

Antes de começar a trabalhar com esse recurso, certifique-se de compreender totalmente quais etapas devem ser executadas com antecedência, bem como as limitações do recurso e as possíveis consequências de usá-lo.

• Cada sincronização substitui as tabelas de destino pelo instantâneo mais recente. O HubSpot não mantém instantâneos anteriores.
• Cada 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. Essas sincronizações são independentes umas das outras e de outros provedores de Data Out.
• Dados confidenciais ainda não são suportados. Propriedades confidenciais podem ser excluídas das exportações.
• Tabelas específicas de objetos, como OBJECTS_CONTACTS, ainda não são suportadas.
• Os nomes das tabelas e colunas diferenciam maiúsculas de minúsculas no PostgreSQL e podem diferenciar maiúsculas de minúsculas no MySQL. Revise a sintaxe da consulta antes de escrever consultas.

Noções básicas sobre os dados que você pode exportar

Você pode sincronizar os seguintes dados do HubSpot com o PostgreSQL ou MySQL:

• Objetos: objetos padrão e personalizados, como contatos, empresas, negócios, tickets e produtos.
• Registros: registros individuais para os objetos selecionados.
• Propriedades: valores de propriedade selecionados e histórico de propriedade em registros.
• Associações: relações selecionadas entre registros, incluindo definições de associações.
• Eventos: eventos padrão e eventos comportamentais personalizados selecionados do HubSpot, incluindo propriedades de evento selecionadas.

Os dados de diferentes objetos são combinados nas tabelas de objetos. Ao ler uma tabela de objetos, use OBJECTTYPEID para filtrar um objeto específico. Por exemplo, os contatos usam 0-1. Os objetos personalizados recebem um ID quando são criados e são identificados como 2-{unique_id}, como 2-12345.

Compreender o formato de exportação

Durante a configuração, você escolhe:

• O banco de dados de destino. Isso se aplica somente ao PostgreSQL. Para o MySQL, o HubSpot cria o banco de dados.
• As fontes de dados a serem sincronizadas: objetos, eventos, associações ou uma combinação dessas fontes.
• A programação de sincronização.

O HubSpot exporta os dados como arquivos Parquet e os carrega diretamente em tabelas em seu banco de dados. O PostgreSQL e o MySQL não usam um bucket de staging de propriedade do cliente. O HubSpot gerencia o staging internamente.

Encontre seus dados em seu banco de dados

O HubSpot cria uma tabela por fonte de dados em um esquema gerenciado pela HubSpot com o nome do seu destino. Você pode encontrar o nome exato do esquema na página de configuração da sua sincronização.

• PostgreSQL: <database>.hubspot_data_out_<destination-id>.<table-name>
• MySQL: hubspot_data_out_<destination-id>.<table-name>. No MySQL, esquema e banco de dados são o mesmo conceito, e a HubSpot cria isso. Não há um nível de banco de dados separado para escolher.

Por exemplo, no PostgreSQL:

• 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

Por exemplo, no MySQL:

• hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES
• hubspot_data_out_456.EVENTS_VISITED_PAGE
• hubspot_data_out_456.ASSOCIATIONS_CONTACTS_TO_COMPANIES

Cada sincronização substitui a tabela pelo instantâneo mais recente. O HubSpot não mantém instantâneos anteriores. Se uma tabela falhar durante uma sincronização, seus dados anteriores permanecerão no lugar até a próxima sincronização bem-sucedida.

Nomes de tabelas e colunas

Os nomes das tabelas e colunas vêm dos dados exportados. Os identificadores PostgreSQL são limitados a 63 caracteres e os identificadores MySQL são limitados a 64 caracteres. O HubSpot encurta nomes mais longos para caber.

Caso identificador

O caso do identificador é importante. O HubSpot cria todas as tabelas e colunas com nomes entre aspas e preservados em maiúsculas, correspondendo às tabelas deste artigo.

• PostgreSQL: quebra os nomes entre aspas duplas exatamente como mostrado. O PostgreSQL dobra os nomes sem aspas em minúsculas, para que eles não correspondam.
• MySQL: use acentos graves e corresponda ao caso mostrado. A diferenciação de maiúsculas e minúsculas do nome da tabela depende da configuração do servidor.

Exemplo do PostgreSQL:

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

Exemplo do MySQL:

SELECT * FROM `hubspot_data_out_456`.`OBJECT_WITH_OBJECT_PROPERTIES` WHERE `OBJECTTYPEID` = '0-1';

Tipos de coluna

Os tipos de coluna seguem os dados exportados e são mapeados para os tipos PostgreSQL e MySQL da seguinte maneira:

Observação: a coluna é exportada como uma string formatada PROPERTIES em OBJECT_WITH_OBJECT_PROPERTIES JSON. É armazenado como TEXT no PostgreSQL ou LONGTEXT no MySQL, não como um tipo de coluna JSON. Para obter exemplos de consulta, consulte as perguntas frequentes.

Revisar tabelas de objetos

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

OBJECT_PROPERTIES

Esta tabela contém uma linha por valor de propriedade. Para ler um objeto específico, filtre por OBJECTTYPEID.

OBJECT_WITH_OBJECT_PROPERTIES

Esta tabela contém uma linha por registro, com os valores de propriedade selecionados agrupados em uma única PROPERTIES coluna. Para ler um objeto específico, filtre por OBJECTTYPEID.

OBJECT_PROPERTIES_HISTORY

Esta tabela contém o histórico de alterações de propriedade. Ao contrário OBJECT_PROPERTIESde , que contém apenas o valor atual, esta tabela tem uma linha para cada valor histórico de uma propriedade. Para ver a linha do tempo completa de um único registro e propriedade, faça o pedido por UPDATEDAT.

Revisar tabelas de associação

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

ASSOCIAÇÕES

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

ASSOCIATION_DEFINITIONS

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

ASSOCIATIONS_<FROM_OBJECT>_TO_<TO_OBJECT>

Para pares de associação selecionados, a HubSpot também pode exportar tabelas de associação específicas de pares, como ASSOCIATIONS_CONTACTS_TO_COMPANIES. Essas tabelas incluem registros de associação juntamente com metadados de definição de associação.

Revisar tabelas de eventos

Se você selecionar dados do evento, o HubSpot exportará uma tabela por tipo de evento. Os nomes das tabelas usam o formato EVENTS_<EVENT_NAME>, como EVENTS_VISITED_PAGE.

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

Gerenciar o agendamento de sincronização

Você configura o agendamento de sincronização durante a configuração no HubSpot. Você também pode disparar manualmente um gatilho de uma ressincronização do HubSpot. Cada execução de sincronização produz um instantâneo completo dos dados selecionados. Para controlar o volume de dados, escolha quais objetos, eventos, associações e propriedades incluir.

Observação: durante a versão beta, apenas um conjunto limitado de frequências de sincronização pode estar disponível, como uma vez, a cada 6 horas, a cada 12 horas, diariamente, semanalmente e mensalmente. Opções de frequência adicionais podem ser adicionadas em versões futuras.

Monitorar sincronizações e tratar erros

Você pode monitorar as sincronizações do PostgreSQL e do MySQL no HubSpot. Uma sincronização pode ter um dos seguintes estados:

Quando uma sincronização falha:

• O HubSpot mostra um status Falhou com detalhes por tabela mostrando quais tabelas foram bem-sucedidas ou falharam.
• Uma tabela é atualizada somente depois que o HubSpot termina de carregar todos os seus dados, de modo que você nunca vê uma tabela parcialmente carregada.
• Se uma tabela falhar, seus dados anteriores permanecerão no lugar até a próxima sincronização bem-sucedida.
• A próxima sincronização agendada tenta automaticamente uma sincronização completa.
• Você pode gatilho manualmente uma ressincronização a qualquer momento no HubSpot.

As tabelas que tiveram êxito em uma execução anterior não são modificadas quando uma execução posterior falha.

FAQs

Como consultar os dados?

Consulte as tabelas em seu esquema de destino com SQL.

PostgreSQL

Ler todos os registros de contato:

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

Leia uma propriedade específica da PROPERTIES coluna JSON. Converta a coluna para JSON primeiro, pois ela é armazenada como texto:

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

Ler todos os registros de contato:

SELECT * FROM `hubspot_data_out_456`.`OBJECT_WITH_OBJECT_PROPERTIES` WHERE `OBJECTTYPEID` = '0-1';

Leia uma propriedade específica da PROPERTIES coluna JSON:

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 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. Essas sincronizações são independentes umas das outras e de outros provedores de Data Out. Por exemplo, se os contatos já foram exportados para um destino PostgreSQL recorrente, você não poderá adicionar contatos a outra sincronização PostgreSQL recorrente até arquivar a primeira. Você ainda pode exportar contatos para uma sincronização recorrente do MySQL ao mesmo tempo.

Há suporte para tabelas específicas de objetos?

Não. Tabelas específicas de objetos, como OBJECTS_CONTACTS, ainda não são suportadas. Use OBJECT_WITH_OBJECT_PROPERTIES e filtre para OBJECTTYPEID obter registros para um objeto específico.

Há suporte a dados confidenciais?

Não. Dados confidenciais ainda não são compatíveis 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 substitui a tabela de destino pelo instantâneo mais recente, de modo que os instantâneos anteriores não sejam mantidos.