BetaAcesse seus dados do HubSpot do Amazon Redshift

Use o Data Out for Amazon Redshift para exportar dados selecionados do CRM da HubSpot para tabelas em um banco de dados do Amazon Redshift 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 snapshots anteriores no Redshift.
• O HubSpot não exclui os arquivos Parquet que prepara no bucket do S3. Para removê-los automaticamente, configure uma política de ciclo de vida do S3 no bucket ou prefixo.
• Cada objeto, tipo de evento ou par de associação pode ser incluído em uma sincronização recorrente do Redshift Data Out por conta da HubSpot.
• 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.

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

Você pode sincronizar os seguintes dados do HubSpot com o Amazon Redshift:

• 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 do Redshift e o cluster ou grupo de trabalho sem servidor em que o HubSpot criará tabelas.
• O bucket do S3 que o HubSpot usa para preparar os dados antes de carregá-los no Redshift.
• 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, prepara os arquivos no bucket do S3 e os carrega em tabelas do Redshift.

Observação: O HubSpot não exclui dados do intervalo de preparação. É recomendável definir uma política de ciclo de vida do bucket para limpar automaticamente o bucket.

Encontre seus dados no Redshift

O HubSpot cria uma tabela por fonte de dados em um esquema gerenciado pela HubSpot com o nome do seu destino:

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

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

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

A HubSpot prepara os arquivos Parquet em seu bucket do S3 sob um prefixo gerenciado pela HubSpot e os carrega no Redshift:

s3://<bucket>/<prefix>/hubspot-dataout/<portal-id>/<destination-id>/<run-id>/<table-name>/

Esses arquivos de staging permanecem no bucket até que você os remova. Para removê-los automaticamente, configure uma política de ciclo de vida do S3 no bucket ou prefixo.

Observação: os nomes das tabelas e colunas vêm dos dados exportados. Eles podem ser encurtados para atender ao limite de 127 identificadores do Redshift. Os tipos de coluna seguem os dados exportados.

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 Amazon Redshift 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. Por exemplo:

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:

SELECT OBJECTID, JSON_EXTRACT_PATH_TEXT(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 do Redshift?

Cada objeto, tipo de evento ou par de associação pode ser incluído em uma sincronização recorrente do Redshift Data Out por conta da HubSpot. Por exemplo, se os contatos já foram exportados para um destino recorrente do Redshift, você não poderá adicionar contatos a outra sincronização recorrente do Redshift até arquivar a primeira sincronização.

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 Data Out to Redshift. 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 snapshot mais recente, de modo que os snapshots anteriores não sejam mantidos no Redshift. O HubSpot também não exclui os arquivos Parquet temporários que coloca em stage no bucket do S3. Configure uma política de ciclo de vida do S3 para expirá-los automaticamente.