Consultar dados do HubSpot em Snowflake_PT

Depois conectando o Snowflake à sua conta HubSpot , você pode usar o Data Share do Snowflake para consultar dados do HubSpot da sua conta do Snowflake.

Atraso de dados e região da sua conta Snowflake

Você terá acesso ao esquema V2_LIVE que é atualizado a cada 15 minutos e ao esquema V2_DAILY que é atualizado todos os dias.

Observe: as seguintes visualizações no esquema V2_LIVE são atualizadas apenas diariamente: Association_Definitions, Owners, Pipelines e Pipeline_Stages.

Configure seu ambiente no Snowflake

Para consultar os dados do seu HubSpot no Snowflake, é necessário selecionar o warehouse, o banco de dados e o esquema a partir do qual pretende consultar. Você pode defini-los no nível da planilha para incluí-los automaticamente em suas consultas, ou pode adicioná-los manualmente.

Para selecionar seu warehouse, banco de dados e esquema no nível da planilha:

• Na linha superior da planilha, clique na barra Ações da planilha.
  
  
• Na janela pop-up:
  • Clique no menu suspenso Warehouse e selecione seu warehouse.
  • Clique no menu suspenso Banco de dados e selecione seu banco de dados do HubSpot.
  • Clique no menu suspenso Esquema e selecione o esquema que você deseja usar:
    • V2_DAILY: o esquema diário para consultar dados com base em tabelas. Os dados neste esquema são atualizados uma vez por dia. O uso deste esquema resultará em consultas mais rápidas, e é recomendado para consultas diretamente no Snowflake.
    • V2_AO VIVO: o esquema ativo baseado em Visualizações seguras de dados do HubSpot. Os dados neste esquema são atualizados até cada 15 minutos. Se você estiver consultando um grande conjunto de dados, as consultas podem ser lentas. Neste caso, é recomendado copiar os dados para sua própria tabela primeiro com um processo ETL e depois consultar essa tabela.
    
    
    

Com o seu ambiente configurado, você pode fazer consultas aos dados do seu HubSpot sem precisar adicionar manualmente seu banco de dados ou tipo de esquema às consultas.

Para adicionar manualmente seu banco de dados e tipo de esquema às consultas, adicione o nome do banco de dados seguido pelo esquema no início do FROM campo. Por exemplo:

Visão geral dos dados

As consultas são construídas usando SQL e podem ser usadas para recuperar dados do HubSpot, como:

• Objetos : objetos padrão e personalizados, como contatos, empresas, produtos. 
• Registros: registros individuais, como um contato individual ou empresa. 
• Associações: todos disponíveis tipos de associação e registros atualmente associados.
• Eventos: dados de eventos para eventos padrão do HubSpot, como aberturas de e-mail, e eventos comportamentais personalizados.
• Listas: HubSpot listas de contatos e empresas.
• Proprietários: usuários na sua conta do HubSpot, em relação aos registros dos quais são definidos como proprietário.
• Pipelines: pipelines de negócios e tickets, incluindo as fases dos pipelines.
• Propriedades: propriedades e seus valores nos registros do CRM, incluindo histórico de propriedade.

Saiba mais sobre o modelo de dados de CRM da HubSpot. 

Observe: À medida que evoluímos no compartilhamento de dados, introduziremos mudanças, algumas delas significativas. É altamente recomendável assinar Registro de alterações do desenvolvedor da HubSpot. Esses mudanças será sempre postado no log de alterações antes de qualquer atualização.

Limitação e ordem de dados devolvidos

Ao construir consultas, você pode controlar a quantidade e a ordem dos dados retornados incluindo LIMIT e ORDER BY na sua consulta. Por exemplo, para consultar todos os contatos com as suas propriedades, mas apenas retornar três resultados e ordená-los por ID de contato, você poderia criar a consulta da seguinte forma:

Tipos de dados de coluna

Ao consultar dados no Snowflake, as colunas que são devolvidas dependem dos dados que você está consultando. Você pode visualizar as colunas disponíveis para uma determinada tabela ou visualização no Snowflake selecionando a visualização na barra lateral esquerda.

Observe:no restante deste documento, usaremos o termo objeto de banco de dados quando o contexto se aplicar a tabelas e visualizações.

Para retornar uma coluna específica, inclua essa coluna no SELECT campo da sua consulta. Por exemplo, a consulta a seguir retornará apenas o OBJECTID e UpdatedAt colunas:


SELECTobjectId, updatedAt
FROM objects_contacts



Abaixo estão as definições gerais para as colunas que uma consulta pode retornar. Para outras definições não incluídas abaixo, consulte as definições da visualização individual no artigo acima.

• TIPO DE OBJETO: a VARCHAR valor que representa o tipo de um objeto. Por exemplo, 0-1 representa o objeto contatos, 0-2 representa o objeto empresas, e 2-1232 pode representar um objeto personalizado em sua conta. Em listas, isto se refere ao tipo de lista (por exemplo, contato ou empresa). Você pode consultar todos os IDs de objetos e eventos na sua conta usando a visualização object_and_event_type_definitions.
• OBJETIVO: a GRANDE número que representa um único registro de um determinado tipo de objeto em sua conta HubSpot. Para identificar um registro, é necessário usar tanto o ID do tipo de objeto quanto o ID do objeto.
• INGESTADO: o carimbo de data/hora de quando uma linha de dados foi adicionada ao Snowflake, representado por um TIMESTAMP_NTZ valor. Não está relacionado com a data/hora lógica de uma operação de criação ou atualização no HubSpot.
  • Devido ao processamento interno do HubSpot, a data/hora de consumo de uma linha pode ser atualizada, mesmo que nenhuma outra coluna da linha tenha sido alterada.
  • Ao construir processos ETL que copiam dados alterados recentemente, é recomendado basear suas consultas na data/hora de consumo. Além disso, se o seu fluxo copia dados diariamente, é recomendado copiar os dados dos dois dias anteriores para contabilizar os atrasos.
• CRIADOAT e ATUALIZADOAT: o carimbo de data/hora lógico de quando os dados foram criados ou atualizados no HubSpot, representado por um TIMESTAMP_NTZ valor. Estas datas/horas corresponderão às datas/horas no HubSpot. Por exemplo, a hora exibida no HubSpot para a data de criação de um registro será a mesma da data de criação do registro na coluna CREATEDAT no Snowflake. Eles não estão diretamente relacionados ao carimbo de data/hora de ingestão e não é recomendado basear-se Processos ETL nessas propriedades.
• TIPO DE ASSOCIAÇÃO COMBINADA: a VARCHAR valor que identifica exclusivamente uma definição de associação.

Transformando tipos de dados

Às vezes, os dados são retornados de uma consulta com VARCHAR colunas quando seria desejável tê-las como um tipo diferente. Em casos como este, é recomendado converter o tipo de dados VARCHAR nos tipos desejados usando funções Snowflake. Por exemplo, as propriedades de um registro de objeto são armazenadas como tipos de dados VARCHAR na maioria dos objetos de banco de dados, mas às vezes contêm valores numéricos e de data e hora. Funções como:
tente_para_número, try_to_timestamp_ntz pode ser usado para converter esses dados VARCHAR em seus NÚMERO e DATA HORA tipos respectivamente:


SELECT objectid, value AS amount_str, try_to_number(value) AS amount
FROM object_properties
WHERE objecttypeid='0-3' AND name='amount'
LIMIT 1



Consultas de objetos

Abaixo, aprenda como consultar dados de objetos e registros do HubSpot específicos, juntamente com os dados que são devolvidos. 

Dados de objetos de diferentes tipos são organizados e disponíveis de duas maneiras: 

• Individual: Cada tipo de objeto é armazenado em sua própria visualização e contém apenas registros do mesmo tipo de objeto, por exemplo, object_contacts contém apenas registros de contato. Isso elimina a necessidade de especificar um objecttypeid durante a consulta. Essas visualizações são mais fáceis de consultar, pois você não precisa conhecer ObjectTypeIds. Eles também retornam dados em um formato mais utilizável, com cada linha correspondendo a um objeto e à versão atual de suas propriedades. Contanto que você não tenha consultas lentas, é aconselhável usar essas visualizações para recuperar dados de objetos. Veja mais nas visualizações Objects_X abaixo. 
• Combinado: Todos os registros de todos os tipos de objetos são combinados em um objeto de banco de dados. Assim, ao consultar, você precisa especificar um filtro como “WHERE objectTypeId='0-1'. Por exemplo, você pode usar os seguintes objecttypeids ao consultar:

Será atribuído um ID aos objetos personalizados no momento da criação, e será identificado como 2-unique_ID. Por exemplo, 2-12345. Saiba mais sobre object_and_event_type_definitions.

Esses objetos de banco de dados geralmente são adequados se você desejar um melhor desempenho de consulta do que o obtido nas visualizações objects_x. Veja mais detalhes em object_with_object_properties, object_properties, objetos e object_properties_history abaixo.

visualizações de objetos_x

Neste objeto de banco de dados, cada tipo de objeto disponível, incluindo objetos personalizados, tem sua própria visualização específica, com cada visualização contendo apenas registros para objetos desse tipo de objeto específico. Essas visualizações são nomeadas seguindo o formato OBJECTS_<object type name> onde <object type name> é o rótulo de forma plural do tipo de objeto.(Observe que se o tipo de objeto não tiver forma plural, então <object type name> será simplesmente o rótulo singular do nome do tipo de objeto concatenado com “S”).

As consultas a esta visualização retornam uma linha para cada registro em um objeto, com cada propriedade do objeto disponível como uma coluna separada.

Veja abaixo a lista abrangente de tipos de objetos HubSpot disponíveis (ou seja, não personalizados), uma breve descrição dos dados que eles representam e suas visualizações correspondentes:

Cada objeto de banco de dados retornará as seguintes colunas:

Exemplo 1

Recupere o nome, o sobrenome e o estágio do ciclo de vida de todos os contatos.

Consulta:


SELECT objectId, property_firstname AS firstname, property_lastname AS lastname,property_lifecyclestage AS lifecyclestage
FROM objects_contact



Retorna:

Exemplo 2

Recupere o nome do negócio e o estágio de até três negócios.

Consulta:


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals

LIMIT 3

Retorna:

Exemplo 3

Recupere o nome do negócio e o estágio dos três principais negócios por valor.

Consulta:

Como os dados do valor do negócio estão disponíveis como um tipo de dados numérico, eles podem ser usados para pedidos sem a necessidade de conversão ou conversão.


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals
ORDER BY property_amount DESC
LIMIT 3




Retorna:

object_with_object_properties

Este objeto de banco de dados contém dados dos seus registros do HubSpot. Consultas a esse objeto de banco de dados retornam uma linha para cada registro dentro de um tipo de objeto (por exemplo, todos os registros de contato no tipo de objeto contatos). Todas as propriedades são armazenadas no Propriedades coluna, que é uma Variante Floco de Neve / JSON coluna. 

Esta visualização pode retornar as seguintes colunas:

Observe: Em 25 de janeiro de 2022, a coluna, carimbo de data/hora em object_with_object_properties tabela e visualização, que representa a data e hora em que o registro do objeto foi atualizado pela última vez no HubSpot, serão atualizado em. Isso é para alinhar com a forma como os dados de data e hora são representados no restante do compartilhamento de dados.

Como esta é uma alteração significativa, a nova coluna, atualizado em foi adicionado à tabela e visualização. Nos próximos 90 dias, essas duas novas colunas coexistirão com o carimbo de data/hora, as colunas que procuram substituir. Isso lhe dá a oportunidade de passar a usar as novas colunas.

Após 90 dias, em 25 de janeiro de 2022, o carimbo de data/hora da coluna será removido da tabela e da visualização. Após esta data, qualquer tentativa de consulta ao object_with_object_properties tabela ou visualização usando colunas de carimbo de data/hora falhará.

Exemplo 1

Recuperar todos os contatos e suas propriedades.

Consulta:

Retorna:

Exemplo 2

Recuperar o nome do negócio e o estágio de até três negócios.

Consulta:

Retorna:

objects

Este objeto de banco de dados é um subconjunto dos dados no objeto de banco de dados object_with_object_properties. Cada linha retornada retorna o ID do objeto para cada registro. Este objeto de banco de dados retorna apenas registros existentes. Quando um registro é excluído no HubSpot, ele será removido deste objeto de banco de dados. Este objeto de banco de dados é um subconjunto dos dados na tabela object_with_object_properties. Cada linha retornada retorna o ID do objeto para cada registro. Esta visualização apenas devolve registros existentes. Quando um registro for excluído do HubSpot, ele será removido desta visualização. 

Esse objeto de banco de dados pode ser útil se sua conta tiver uma grande quantidade de dados, fazendo com que as visualizações object_with_object_properties e objects_x tenham um desempenho lento. Usar esse objeto de banco de dados com o objeto de banco de dados object_properties possibilita replicar os dados em object_with_object_properties, enquanto mantém o controle sobre quais propriedades são retornadas.

Este objeto de banco de dados pode retornar as seguintes colunas:

Exemplo 1

Recuperar todos os registros de contato.

Consulta:

Retorna:

object_properties

Este objeto de banco de dados é um subconjunto do object_with_object_properties objeto de banco de dados. Cada linha contém o valor da propriedade atual definido em um determinado registro. Por exemplo, um contato terá uma linha para a propriedade Nome e uma linha para a propriedade Sobrenome. Se um registro não tiver um valor para uma propriedade, a linha aparecerá com uma string vazia ou nem aparecerá.

Este objeto de banco de dados pode retornar as seguintes colunas:

Exemplo 1

Recuperar propriedades de nome, sobrenome e cidade para todos os contatos.

Consulta:

Retorna:

Exemplo 2

Recuperar nome, sobrenome e fase do ciclo de vida de todos os contatos, e combiná-los em uma linha por contato. Este exemplo usa o Sintaxe SQL PIVOT.

Consulta:

Retorna:

object_properties_history

Este objeto de banco de dados contém valores históricos de propriedades. Para contatos, contém os 45 valores mais recentes. Para todos os outros objetos, ele contém os 20 valores mais recentes. Exibe uma linha para cada valor histórico de propriedade. O valor atual de uma propriedade é determinada pela data/hora mais recente UPDATEDAT no histórico da propriedade.

Este objeto de banco de dados pode retornar as seguintes colunas:

Exemplo 1

Recuperar o histórico de uma única propriedade para um único contato.

Consulta:

 
Retorna:

Exemplo 2

Recuperar o nome atual de todos os contatos que já tiveram uma fase do ciclo de vida de Subscriber.

Consulta:

Retorna:

Consultas de associação

Assim como os dados de objetos, os dados de associações são organizados de duas maneiras:

• Individual: Cada tipo de associação é armazenado em sua própria visualização e contém apenas registros desse tipo. Por exemplo, associations_contacts_to_deals contém apenas registros de associação entre objetos de contato e de negócio. Isso elimina a necessidade de especificar um AssociationTypeID durante a consulta. Essas visualizações são bastante fáceis de consultar, pois não requerem familiaridade com o modelo de dados do CRM para serem utilizadas. Eles também retornam uma descrição enriquecida do registro de associação entre dois objetos que pode ser facilmente usado em junções com visualizações de objetos_x. Contanto que você não tenha consultas lentas, é aconselhável usar essas visualizações para recuperar dados de associação. Veja mais nas visualizações associations_x_to_y abaixo. 
• Combinado: Todos os registros de todos os tipos de associação são combinados em um objeto de banco de dados. Assim, ao consultar, você precisa especificar um filtro como “WHERE combinadoassociationtypeid='0-32' ”. Veja mais em associações e definições de associação abaixo.

associations_x_to_y views

Cada tipo de associação tem sua própria visualização, rotulada como associações_<association type name> por exemplo, associações_contatos_para_negócios. Cada visualização é um subconjunto dos dados no objeto de banco de dados de associações e contém apenas registros de um tipo de associação combinado específico.

Cada objeto de banco de dados retornará as seguintes colunas:

Exemplo 1

Recuperar todos os negócios associados a um contato específico.

Consulta:

Retorna:

Exemplo 2

Recupere todos os contatos baseados no fuso horário de Bogotá e seus negócios.

Exemplo 3

Recupere todos os contatos e a soma total do valor do negócio fechado para cada contato.

Retorna:

association_definitions

Este objeto de banco de dados contém informações sobre todos os tipos de associação disponíveis entre objetos do HubSpot, com uma linha por tipo de associação. Você pode juntar este objeto de banco de dados com o associações objeto de banco de dados para obter informações de associação específicas do registro.

Pode haver vários tipos de associações entre os mesmos objetos. O tipo de associação principal, que é o tipo exibido no HubSpot quando os registros são associados, use a associação onde ISMAINASSOCIATIONDEFINITION é true.

Este objeto de banco de dados pode retornar as seguintes colunas:

Exemplo 1 

Recuperar os tipos de associações disponíveis na sua conta.

Consulta:

 
Retorna:

Exemplo 2

Recuperar os tipos de associação disponíveis entre negócios e empresas.

Consulta:

Retorna:

associações

Este objeto de banco de dados contém informações sobre as associações entre registros específicos. Cada linha representa uma associação de um objeto a outro objeto. Linhas podem estar presentes neste objeto de banco de dados mesmo que os registros referenciados tenham sido excluídos. É possível verificar se existem registros unindo com a tabela de objetos.

Esse objeto de banco de dados pode ser útil se sua conta tiver uma grande quantidade de dados, fazendo com que as visualizações de associações_x_to_y tenham um desempenho lento.

Este objeto de banco de dados pode retornar as seguintes colunas:

Exemplo 1

Recuperar todos os negócios e contatos associados.

Consulta:

 
Retorna: 

Exemplo 2 

Recuperar todos os tickets associados a um contato específico (ID de contato: 3005).

Consulta:

Retorna:

Exemplo 3 

Recuperar todos os negócios associados a um contato específico (ID do contato: 4464). Em vez de codificar combinedAssociationTypeId, este exemplo junta-se a association_definitions.

Consulta:

Retorna:

Consultas do proprietário

owners

Este objeto de banco de dados contém informações sobre os usuários da sua conta HubSpot. Os usuários podem ser definidos como proprietários de registros e terão um ID de usuário e um ID de proprietário, dependendo de seu contexto. Os dois IDs podem ser usados para identificar o mesmo usuário. 

Este objeto de banco de dados pode retornar as seguintes colunas:

Exemplo 1 

Recuperar todos os usuários. O WHERE archived = false filtro remove usuários excluídos dos dados retornados.

Consulta:

 
Retorna: 

Exemplo 2

Recuperar um proprietário específico através do seu ID de proprietário.

Consulta:

Retorna: 

Exemplo 3

Recuperar todos os contatos e seus proprietários. Esta consulta junta os registros dos proprietários com object_with_object_properties e hubspot_owner_idda propriedade de contato.

Retorna: 

Perguntas da equipe

equipes

As equipes no HubSpot permitem organizar os usuários em grupos para fins organizacionais e de relatórios. Você pode ter uma equipe principal e equipes extras.

Este objeto de banco de dados contém informações sobre as equipes na sua conta da HubSpot. 

Este objeto de banco de dados pode retornar as seguintes colunas:

Exemplo 1

Recuperar todas as equipes.

Consulta:

Retorna:

owner_team

Este objeto de banco de dados contém informações sobre quais proprietários correspondem a quais equipes na sua conta da HubSpot. 

Este objeto de banco de dados pode retornar as seguintes colunas:

Exemplo 1

Recuperar todos os proprietários de uma determinada equipe.

Consulta:

SELECT teamId, ownerId, isTeamPrimary
FROM teams
WHERE teamId = 29584574

Devoluções

Consultas de pipelines

Abaixo, saiba como consultar os dados do pipeline de negócios e tickets, como os pipelines disponíveis na conta e as fases deles.

Você pode juntar estes dados com os dados do objeto para uma visão completa dos seus pipelines. Por exemplo, você pode consultar negócios e seus pipelines juntando-se ao object_deals_view ou ao object_with_object_properties dados com oleodutos dados.

pipelines

Este objeto de banco de dados contém informações sobre os pipelines de negócios e tickets em sua conta. Cada linha devolvida representa um único pipeline.

Esta tabela pode retornar as seguintes colunas:

Exemplo 1

Recuperar todos os pipelines disponíveis, ordenados pela sua ordem no HubSpot.

Consulta:

 
Retorna: 

Exemplo 2

Recuperar negócios dentro de um pipeline específico. Une object_with_object_properties e pipelines.

Consulta:

Retorna: 

Exemplo 3

Assim como no Exemplo 2 acima, recupere negócios dentro de um pipeline específico. Mas, em vez de usar objects_deals em joins, use object_with_object_properties.

Retorna: 

pipeline_stages

Esta visualização contém informações sobre etapas individuais dentro de um pipeline. Identificar etapas através da combinação do ID do tipo de objeto, ID do pipeline e ID da etapa. Ao unir com pipelines, usar o ID do tipo de objeto e ID d pipeline.

Este objeto de banco de dados pode retornar as seguintes colunas:

Exemplo 1 

Recuperar as etapas de um pipeline para um pipeline de negócios chamado Pipeline de vendas.

Consulta:

 
Retorna: 

Exemplo 2

Recuperar todos os negócios e suas respectivas fases de pipeline.

Consulta:

Retorna: 

Consultas de propriedade

property_definitions

Este objeto de banco de dados contém informações sobre propriedades do objeto e propriedades de eventos em sua conta HubSpot. As propriedades de eventos incluem eventos padrão, como abertura e cliques de e-mail, e propriedades de eventos comportamentais personalizados. Essas informações podem ser úteis para definir valores encontrados nos dados de object_properties de events.

É possível identificar propriedades específicas combinando seu nome e ID do tipo de objeto. Você pode recuperar informações semelhantes usando as propriedades de API.

Este objeto de banco de dados pode retornar as seguintes colunas:

Exemplo 1

Recuperar os nomes e as descrições de todas as propriedades do contato.

Consulta:

 
Retorna:

Consultas do evento

Os eventos incluem eventos padrão e eventos comportamentais personalizados do HubSpot. Cada evento tem seu próprio objeto de banco de dados, rotulado como events_eventname.

Você pode identificar eventos combinando o ID e o ID do tipo de evento. As colunas que são devolvidas dependem do evento, com uma coluna para cada propriedade do evento. Todos os eventos retornarão as seguintes colunas:

Exemplo 1

Recuperar os 50 mais recentes eventos de clique por e-mail.

Consulta:

Retorna: 

Exemplo 2

Recuperar todos os eventos de clique por e-mail pelos contatos que clicaram. Esta consulta obtém dados de contato unindo-se com object_with_object_properties.

Consulta:

Retorna: 

Object_and_event_type_queries

object_and_event_type_definitions

Este objeto de banco de dados contém definições para todos os objetos e eventos disponíveis em sua conta HubSpot.

Este objeto de banco de dados pode retornar as seguintes colunas:

Exemplo 1

Recuperar todos os objetos e eventos disponíveis na sua conta do HubSpot.

Consulta:

 
Retorna: 

Lista consultas

Abaixo, saiba como consultar suas listas, como as listas de contatos e empresas disponíveis e os registros incluídos nessas listas.

listas

Este objeto de banco de dados contém informações sobre listas de contatos e empresas da HubSpot. Retorna uma linha por lista, e as colunas incluem detalhes, como nome da lista, tamanho e tipo de objeto dos registros nela contidos. Não contém informações sobre os registros individuais dentro de cada lista (ver list_membership). 

Este objeto de banco de dados pode retornar as seguintes colunas:

Exemplo 1

Recuperar todas as listas de contatos.

Consulta:

 
Retorna: 

Exemplo 2

Recuperar uma lista de contatos específica chamada Principais inscritos de 2021. 

Consulta:

Retorna: 

list_membership

Este objeto de banco de dados contém informações sobre quais registros são membros de quais listas, com uma linha por registro na lista. Por exemplo, se você tiver uma lista de assinantes de Blog com 500 contatos, o objeto banco de dados retornará 500 linhas. 

Contém apenas IDs de lista e IDs de objeto. Para mais informações, junte-se ao listas objeto de banco de dados.

Este objeto de banco de dados pode retornar as seguintes colunas:

Exemplo 1

Recuperar os IDs de todos os contatos da lista Principais inscritos de 2021.

Consulta:

 
Retorna: 

Exemplo 2

Recuperar o nome e o sobrenome dos detalhes dos contatos no Principais assinantes 2021 lista.

Consulta:

Retorna: 

Perguntas frequentes

Quero gerar dados semelhantes a um relatório do aplicativo Hubspot, como faço isso?

Geralmente, você gostaria de observar as colunas presentes no relatório com as quais está comparando. Se a visualização do relatório não for tabular, convertê-la em tabela mostrará as colunas que o relatório contém. Essas colunas geralmente são propriedades de um tipo de objeto ou tipo de evento. A próxima etapa é descobrir a propriedade do tipo de objeto à qual uma coluna corresponde. Você pode fazer isso consultando property_definitions:

Pode nem sempre haver uma correspondência exata porque alguns nomes de propriedades geralmente são resolvidos para um nome mais descritivo no aplicativo. Em casos como este, fazer uma pesquisa difusa usando o operador LIKE na coluna rótulo (ou mesmo na descrição) em property_definitions pode ajudar.

Depois de determinar a qual tipo de objeto a coluna pertence, é trivial determinar o que consultar. Você pode simplesmente procurar a visualização object_x que corresponde ao tipo.

Como posso vincular este tipo de dados a outro, por exemplo, como recuperar formulários para uma campanha?

Se você precisar vincular dois ou mais registros diferentes entre si, dê uma olhada nas associações. As associações representam os relacionamentos entre objetos no HubSpot CRM. Todas as diferentes associações possíveis entre dois tipos estão listadas em Association_Definitions. No exemplo acima, para saber todos os formulários aos quais uma campanha está vinculada, é necessário consultar ASSOCIATIONS_CAMPAIGNS_TO_FORMS:

Como posso saber o status da integração HubSpot-Snowflake?

Para receber atualizações de status em tempo real sobre interrupções e problemas na integração HubSpot-Snowflake, consulte a visualização data_share_status:

SELECT * FROM hubspot.public.data_share_status
LIMIT 1

Os resultados serão exibidos como:

Esta visualização fornece atualizações sobre o status da integração em ordem cronológica inversa. Integrar os resultados desta consulta em um painel ajudará você a monitorar o desempenho da integração e detectar qualquer tempo de inatividade ou interrupções.