BetaAcesse seus dados da HubSpot da Análise do Microsoft Azure Synapse

Use a Saída de Dados do Azure Synapse para exportar dados selecionados do CRM da HubSpot para tabelas em um pool de SQL dedicado do Azure Synapse que você possui. O HubSpot atualiza cada tabela de saída a partir de uma exportação completa dos dados selecionados. 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.

• O HubSpot atualiza as tabelas separadamente. Se você consultar várias tabelas enquanto uma sincronização estiver em execução, algumas tabelas podem ser atualizadas antes de outras.
• A Data Out não fornece retenção de instantâneo histórico. Após uma atualização bem-sucedida, a tabela de destino contém o instantâneo mais recente.
• Cada objeto, tipo de evento ou par de associação pode ser incluído em uma sincronização recorrente do Azure Synapse por conta da HubSpot. Esse limite é independente de outros provedores de Data Out.
• Tabelas específicas de objetos, como OBJECTS_CONTACTS, ainda não são suportadas.
• Se dois nomes de tabelas colidirem depois que o HubSpot os normalizar, a exportação afetada falhará. Para obter mais informações, examine as regras de nome de tabela e coluna.

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

Você pode sincronizar os seguintes dados do HubSpot com o Azure Synapse Análise:

• Objetos e registros: objetos padrão e personalizados selecionados e seus registros, como contatos, empresas, negócios, tickets e produtos.
• 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 ponto de extremidade e o banco de dados SQL dedicados do Azure Synapse de destino.
• As fontes de dados a serem sincronizadas: objetos, eventos, associações ou uma combinação dessas fontes.
• A programação de sincronização.

A HubSpot cria uma exportação temporária do Parquet no armazenamento gerenciado pela HubSpot e grava os resultados em tabelas em seu pool de SQL dedicado do Azure Synapse. Você não precisa fornecer ou gerenciar um bucket de preparação.

Localizar seus dados no Azure Synapse

O HubSpot cria tabelas de saída em um esquema gerenciado pela HubSpot para o seu destino. O HubSpot exporta dados de objetos para as três tabelas de objetos descritas neste artigo. O HubSpot também cria uma tabela por tipo de evento selecionado e, quando disponível, uma tabela específica de pares por par de associação selecionado.

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

Você pode encontrar o nome exato do esquema na página de configuração da sua sincronização. 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

Nomes de tabelas e colunas

O HubSpot normaliza os nomes de tabelas e colunas exportados para letras maiúsculas, números e sublinhados:

• Espaços e hifens se tornam sublinhados.
• Outros caracteres não alfanuméricos são removidos.
• Nomes com mais de 128 caracteres são encurtados.
• Os nomes das colunas que colidem recebem um sufixo.
• Nomes de tabelas em colisão falham na exportação afetada.

Use colchetes ao consultar identificadores, especialmente se você construir consultas dinamicamente. A diferenciação de maiúsculas e minúsculas do identificador depende do agrupamento do banco de dados do Synapse. Por exemplo:

SELECT *
FROM [your_database].[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 do Azure Synapse da seguinte maneira:

Observação: a coluna é exportada como uma string formatada PROPERTIES em OBJECT_WITH_OBJECT_PROPERTIES JSON. Ele é armazenado como NVARCHAR(MAX), 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 o beta, as frequências de sincronização disponíveis podem ser limitadas. 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 Azure Synapse no HubSpot. Uma sincronização pode ter um dos seguintes estados:

Quando uma sincronização falha:

• O HubSpot mostra um status Com falha com detalhes sobre quais tabelas foram bem-sucedidas ou falharam.
• Se uma tabela não puder ser atualizada, os dados anteriores bem-sucedidos geralmente permanecerão disponíveis.
• Para sincronizações recorrentes, a próxima sincronização agendada tenta automaticamente uma sincronização completa.
• Você pode gatilho manualmente uma ressincronização a qualquer momento no HubSpot.

FAQs

Como consultar os dados?

Consulte as tabelas em seu esquema de destino com SQL. Por exemplo, leia 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 string JSON:

SELECT
  [OBJECTID],
  JSON_VALUE([PROPERTIES], '$.email') AS [email]
FROM [your_database].[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 Azure Synapse por conta da HubSpot. Esse limite é independente de outros provedores de Data Out.

Por exemplo, se os contatos já tiverem sido exportados para um destino recorrente do Azure Synapse, você não poderá adicionar contatos a outra sincronização recorrente do Azure Synapse até arquivar a primeira sincronização. Você ainda pode exportar contatos para outro provedor de Data Out compatível 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.

O HubSpot mantém instantâneos anteriores?

Não. A Data Out não fornece retenção de instantâneo histórico. Após uma atualização bem-sucedida, a tabela de destino contém o instantâneo mais recente. Se uma tabela não puder ser atualizada, os dados anteriores bem-sucedidos geralmente permanecerão disponíveis.