Consultar dados do HubSpot em Snowflake_PT
Ultima atualização: Maio 31, 2024
Disponível com qualquer uma das seguintes assinaturas, salvo menção ao contrário:
Operations Hub Enterprise |
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:
SELECT objectTypeId, property_createddate
FROM hubspot_share_name.V2_LIVE.objects_deals
LIMIT 1
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:
SELECT objectTypeId, updatedAt, ingestedAt
FROM objects_deals
ORDER BY objectId
LIMIT 10;
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 amountFROM 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:
Nome do objeto | ObjectTypeId |
Contatos | 0-1 |
Empresas | 0-2 |
Itens de linha | 0-8 |
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:
Tipo de objeto HubSpot |
ObjectTypeId |
Descrição |
0-1 |
Informações sobre indivíduos que interagem com sua empresa |
|
0-2 |
Informações sobre empresas ou organizações individuais |
|
0-3 |
Detalhes sobre oportunidades de receita com um contato ou empresa. |
|
0-4 |
Armazena dados de ações de CRM, incluindo notas, tarefas, e-mails, reuniões e chamadas. |
|
0-5 |
Representa as solicitações dos clientes por ajuda ou suporte. |
|
0-14 |
Usado para compartilhar informações de preços com potenciais compradores. |
|
0-15 |
Detalhes para envios individuais para um formulário HubSpot. |
|
0-8 |
Representa um subconjunto de produtos vendidos em uma transação. Quando um produto é anexado a um negócio, ele se torna um item de linha. |
|
0-11 |
Detalhes de mensagens recebidas de vários canais. |
|
0-25 |
Detalhes de suas páginas de destino |
|
0-27 |
Armazena informações sobre listas de tarefas |
|
0-28 |
Usado para coletar informações de leads sobre seus visitantes e contatos |
|
0-29 |
Detalhes sobre e-mails do centro de marketing |
|
AD_ACCOUNT |
0-30 |
Armazena informações sobre suas contas de anúncios no Linkedin, Facebook e Google |
0-31 |
Detalhes sobre suas campanhas publicitárias. Uma campanha publicitária pode conter um ou mais anúncios |
|
AD_GROUP |
0-32 |
Agrupamento lógico de anúncios em uma campanha publicitária |
DE ANÚNCIOS |
0-33 |
Detalhes sobre anúncios individuais |
0-35 |
Informações sobre ativos e conteúdos de marketing relacionados, para que você possa medir facilmente a eficácia de seus esforços coletivos de marketing. |
|
SITE_PAGE |
0-38 |
Dados sobre páginas individuais em seus sites |
0-39 |
Dados sobre postagens de blog |
|
OBJETO LISTA |
0-45 |
Informações sobre agrupamentos de registros de objetos com base em suas propriedades ou atividades |
0-48 |
Chamadas feitas por outros registros de CRM, por exemplo, contatos |
|
FATURA |
0-53 |
Gerencie e sincronize faturas com sistemas de contabilidade externos |
0-57 |
Informações sobre ativos de mídia importados para o Hubspot |
|
0-58 |
Uma sequência é uma série de modelos de e-mail direcionados e cronometrados para nutrir contatos ao longo do tempo |
|
0-72 |
As divisões de negócios são usadas para compartilhar o crédito do negócio entre vários usuários |
|
0-83 |
Os documentos de vendas criam uma biblioteca de conteúdo para toda a sua equipe carregar e compartilhar documentos com seus contatos. |
|
0-19 |
Armazena informações enviadas para uma pesquisa de feedback. |
|
0-69 |
As assinaturas contêm detalhes de pagamentos recorrentes |
|
0-101 |
Contém dados sobre fundos coletados de clientes |
Cada objeto de banco de dados retornará as seguintes colunas:
Nome da coluna |
Tipo |
Descrição |
OBJECTTYPEID |
Varchar |
O ID do tipo de objeto (por exemplo, contatos é 0-1). |
OBJECTID |
Número |
O ID do registro (por exemplo, um registro de contato com ID 123752). |
UPDATEDAT |
Data/hora |
A data e hora em que este objeto foi atualizado pela última vez no HubSpot. |
INGESTEDAT |
Data/hora |
A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. |
PROPERTY_* |
Varchar |
Colunas individuais contendo a versão mais recente das propriedades do objeto. Para cada propriedade do objeto que possui um tipo de data ou número (conforme especificado por definições_de propriedade), haverá duas 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 lifecyclestageFROM objects_contact
Retorna:
OBJECTID |
FIRSTNAME |
LASTNAME |
ESTÁGIO DO CICLO DE VIDA |
54325098 |
Hobbes |
Baron |
lead |
96805401 |
Milo |
Gold |
lead |
6922028 |
Henry |
Riley |
lead |
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 dealAmountFROM objects_deals
LIMIT 3
Retorna:
OBJETID |
PROPERTY_DEALNAME |
PROPERTY_DEALSTAGE |
PROPERTY_DEALAMOUNT |
38960439 |
Nome do negócio 1 |
fechado e ganho |
34199 |
321740651 |
Acordo de teste 123 |
14845019 |
8383663 |
98392101 |
Dossel pop-up |
fechado e ganho |
9309007 |
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 dealAmountFROM objects_deals
ORDER BY property_amount DESC
LIMIT 3
Retorna:
OBJETID |
PROPERTY_DEALNAME |
PROPERTY_DEALSTAGE |
PROPERTY_DEALAMOUNT |
98392101 |
Dossel pop-up |
fechado e ganho |
9309007 |
321740651 |
Acordo de teste 123 |
14845019 |
8383663 |
38960439 |
Nome do negócio 1 |
fechado e ganho |
34199 |
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:
Nome da coluna | Tipo | Descrição |
OBJECTTYPEID |
Varchar | O ID do tipo de objeto (por exemplo, contatos é 0-1 ). |
OBJECTID |
Número | O ID do registro (por exemplo, um registro de contato com um ID de 123752 ). |
PROPERTIES |
Variante | Os valores de propriedade dos registros. |
UPDATEDAT |
Data/hora | A data e hora em que o registro foi atualizado pela última vez no HubSpot. Saiba mais sobre os tipos de dados das colunas. |
INGESTEDAT |
Data/hora | A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. |
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:
SELECT objectTypeId, objectId, properties
FROM object_with_object_properties
WHERE objectTypeId = '0-1'
Retorna:
OBJECTTYPEID | OBJECTID | PROPERTIES |
0-1 | 38960439 | {"criadadata": "1504656970152"...} |
0-1 | 321740651 | { "criadadata": "1590183081949"...} |
0-1 | 98392101 | { "criadadata": "1533566477279"...} |
... | ... | ... |
Exemplo 2
Recuperar o nome do negócio e o estágio de até três negócios.
Consulta:
SELECTobjectId,
properties:dealname::string AS dealname,
properties:dealstage::string AS dealstage,
properties:amount::number AS dealamount
FROM object_with_object_properties
WHERE objectTypeId = '0-3'
LIMIT 3;
Retorna:
OBJECTID | DEALNAME | DEALSTAGE | DEALAMOUNT |
38960439 | Nome do negócio 1 | fechadoperdido | 7488939 |
321740651 | Nome do negócio 1 | fechado e ganho | 9292029 |
98392101 | Nome do negócio 1 | fechadoperdido | 62626528 |
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:
Nome da coluna | Tipo | Descrição |
OBJECTTYPEID |
Varchar | O ID do tipo de objeto (por exemplo, contatos é 0-1 ). |
OBJECTID |
Número | O ID do registro (por exemplo, um registro de contato com um ID de 123752 ). |
INGESTEDAT |
Data/hora | A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. Saiba mais sobre os tipos de dados das colunas. |
Exemplo 1
Recuperar todos os registros de contato.
Consulta:
SELECT objectTypeId, objectId
FROM objects
WHERE objectTypeId = '0-1'
Retorna:
OBJECTTYPEID | OBJECTID |
0-1 | 36721864 |
0-1 | 103580363 |
0-1 | 56047670 |
... | ... |
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:
Nome da coluna | Tipo | Descrição |
OBJECTTYPEID |
Varchar | O ID do tipo de objeto (por exemplo, contatos é 0-1 ). |
OBJECTID |
Número | O ID do registro (por exemplo, um registro de contato com um ID de 123752 ). |
NAME |
Varchar | O nome da propriedade. |
VALUE |
Data/hora | O valor da propriedade. |
UPDATEDAT |
Data/hora | A data e hora em que o registro foi atualizado pela última vez no HubSpot. Saiba mais sobre os tipos de dados das colunas. |
INGESTEDAT |
Data/hora | A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. |
Exemplo 1
Recuperar propriedades de nome, sobrenome e cidade para todos os contatos.
Consulta:
SELECT objectTypeId, objectId, name, value
FROM object_properties
WHERE objectTypeId = '0-1'
AND name IN ('firstname', 'lastname', 'city')
ORDER BY objectId;
Retorna:
OBJECTTYPEID | OBJECTID | NAME | VALUE |
0-1 | 10401 | firstname | Brian |
0-1 | 10401 | city | Dublin |
0-1 | 10401 | lastname | Gallagher |
0-1 | 23451 | firstname | Fernando |
0-1 | 23451 | lastname | Fierro |
0-1 | 25751 | firstname | Charles |
... | ... | ... | ... |
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:
SELECT objectId, firstname, lastname, lifecyclestage
FROM
(
SELECT objectId, name, value
FROM object_properties
WHERE objectTypeId = '0-1'
AND name IN ('firstname', 'lastname', 'lifecyclestage')
)
PIVOT(MAX(value) FOR name IN ('firstname', 'lastname', 'lifecyclestage')) AS p(objectId, firstname, lastname, lifecyclestage);
Retorna:
OBJECTTYPEID | OBJECTID | FIRSTNAME | LASTNAME | LIFECYCLESTAGE |
0-1 | 54325098 | Hobbes | Baron | lead |
0-1 | 96805401 | Milo | Gold | lead |
0-1 | 6922028 | Henry | Riley | lead |
... | ... | ... | ... | ... |
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:
Nome da coluna | Tipo | Descrição |
OBJECTTYPEID |
Varchar | O ID do tipo de objeto (por exemplo, contatos é 0-1 ). |
OBJECTID |
Número | O ID do registro (por exemplo, um registro de contato com um ID de 123752 ). |
NAME |
Varchar | O nome da propriedade. |
VALUE |
Data/hora | O valor da propriedade. |
UPDATEDAT |
Data/hora | A data e hora em que os dados foram atualizados pela última vez no HubSpot. Saiba mais sobre os tipos de dados das colunas. |
INGESTEDAT |
Data/hora | A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. |
Exemplo 1
Recuperar o histórico de uma única propriedade para um único contato.
Consulta:
SELECT objectId, name, value, updatedAt
FROM object_properties_history
WHERE objectTypeId = '0-1'
AND objectId = 136493192
AND name = 'hs_predictivescoringtier'
ORDER BY UPDATEDAT DESC;
Retorna:
OBJECTID | NAME | VALUE | ATUALIZADO |
136493192 |
hs_predictivescoringtier |
camada_1 |
22/06/2022 22:45:05.931 |
136493192 |
hs_predictivescoringtier |
nível_2 |
2021-09-18 08:20:56.622 |
136493192 |
hs_predictivescoringtier |
Nível 3 |
31/11/2019 18:20:22.851 |
... |
... |
... |
... |
Exemplo 2
Recuperar o nome atual de todos os contatos que já tiveram uma fase do ciclo de vida de Subscriber.
Consulta:
SELECT
objectId,
properties:firstname::string AS firstname,
properties:lastname::string AS lastname
FROM object_with_object_properties
WHERE object_with_object_properties.objectTypeId = '0-1'
AND objectId IN (
SELECT objectId
FROM object_properties_history
WHERE
object_properties_history.objectTypeId = '0-1'
AND object_properties_history.name = 'lifecyclestage'
AND object_properties_history.value = 'subscriber'
);
Retorna:
OBJECTID | FIRSTNAME | LASTNAME |
54325098 | Hobbes | Baron |
96805401 | Milo | Gold |
6922028 | Henry | Riley |
... | ... | ... |
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:
Nome da coluna |
Tipo |
Descrição |
COMBINEDASSOCIATIONTYPEID |
Varchar |
O identificador único da definição da associação. |
CATEGORIA DE ASSOCIAÇÃO |
Varchar |
A fonte do tipo de associação. Um de: HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED |
ASSOCIAÇÃOTYPEID |
Varchar |
Um identificador exclusivo de uma definição de associação dentro de uma categoria de associação específica, ou seja, não há duas definições em uma categoria de associação que tenham o mesmo tipo de associação. |
FROMOBJECTTYPEID |
Varchar |
O objecttypeid que é a origem da definição de associação. |
FROMOBJECTTYPE |
Varchar |
O nome do objecttype que é a origem da definição de associação. |
TOOBJECTTYPEID |
Varchar |
O objecttypeid que é o destino da definição de associação. |
TOOBJECTTYPE |
Varchar |
O nome do objecttype que é o destino da definição de associação. |
NAME |
Varchar |
O nome da definição da associação. |
LABEL |
Varchar |
A descrição da definição da associação. |
ISMAINASSOCIATIONDEFINITION |
Booleano |
Se a definição da associação é o tipo principal. Quando verdadeira, a definição é aquela que o HubSpot exibe nos registros associados |
[FROMOBJECTTYPE_OBJECTID] por exemplo, para a visualização ASSOCIATIONS_CONTACTS_TO_DEALS, será CONTACT_OBJECTID |
Número |
O ID do objeto do objeto de origem. |
[TOOBJECTTYPE_OBJECTID] por exemplo, para a visualização ASSOCIATIONS_CONTACTS_TO_DEALS, será DEAL_OBJECTID |
Número |
O ID do objeto do objeto de destino. |
INGESTEDAT |
Data/hora |
A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. |
Exemplo 1
Recuperar todos os negócios associados a um contato específico.
Consulta:
SELECT
contact_objectId, deal_objectId
DE associações_contatos_para_negócios
ONDE contactId = 6626541373
Retorna:
CONTACT_OBJECTID |
DEAL_OBJECTID |
6626541373 |
233620335 |
6626541373 |
90253678 |
Exemplo 2
Recupere todos os contatos baseados no fuso horário de Bogotá e seus negócios.
SELECIONE contatos.property_firstname contato_firstname,
contatos.sobrenome_propriedade contato_sobrenome,
contatos.property_email contato_email,
ofertas.property_dealtype tipo_de_negócio, ofertas.property_amount valor_de_negócio
DE objetos_contatos contatos
JUNTE-SE à associação associações_contatos_to_deals
assoc.contact_objectid=contatos.objectid
JUNTE-SE a object_deals ofertas em Deals.objectid=assoc.deal_objectid
onde contatos.property_hs_timezone='america_slash_bogota'
CONTACT_FIRSTNAME |
CONTACT_LASTNAME |
EMAIL DE CONTATO |
DEAL_TYPE |
DEAL_AMOUNT |
Davi |
Magalhães |
dmagalhaes@exemplo.com |
novo negócio |
74848 |
Fernanda |
Rodrigues |
fmoreira@exemplo.com |
novo negócio |
253530 |
Exemplo 3
Recupere todos os contatos e a soma total do valor do negócio fechado para cada contato.
SELECIONE SOMA(deals.property_hs_closed_amount) COMO
total_closed_amount, contatos.property_email contact_email
DE objetos_contatos contatos
JUNTE-SE à associação associações_contatos_to_deals
assoc.contact_objectid=contatos.objectid
JUNTE-SE a object_deals ofertas em Deals.objectid=assoc.deal_objectid
GRUPO POR contato_email
ORDER BY total_closed_amount DESC
Retorna:
TOTAL_CLOSED_AMOUNT |
EMAIL DE CONTATO |
98474793 |
johndoe@riverview.com |
849488 |
sallymae@longford.com |
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:
Nome da coluna | Tipo | Descrição |
COMBINEDASSOCIATIONTYPEID |
Varchar | O identificador único da definição da associação. |
CATEGORY |
Varchar | A fonte do tipo de associação. Um de: HUBSPOT_DEFINED , USER_DEFINED , INTEGRATOR_DEFINED |
ID |
Número | O identificador da definição da associação dentro da sua categoria. |
FROMOBJECTTYPEID |
Varchar | O ID do objeto que é a fonte da definição da associação. |
TOOBJECTTYPEID |
Varchar | O ID do objeto que é o destino da definição da associação. |
NAME |
Varchar | O nome da definição da associação. |
LABEL |
Varchar | O rótulo da definição da associação. |
ISMAINASSOCIATIONDEFINITION |
Booleano | Se a definição da associação é o tipo principal. Quando verdadeira, a definição é aquela que o HubSpot exibe nos registros associados. |
INGESTEDAT |
Data/hora | A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. Saiba mais sobre os tipos de dados das colunas. |
Exemplo 1
Recuperar os tipos de associações disponíveis na sua conta.
Consulta:
SELECT combinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
ORDER BY category, id
Retorna:
COMBINEDASSOCIATIONTYPE | FROMOBJECTTYPEID | TOOBJECTTYPEID | NAME |
0-1 | 0-1 | 0-2 | CONTACT_TO_COMPANY |
0-2 | 0-2 | 0-1 | COMPANY_TO_CONTACT |
0-3 | 0-3 | 0-1 | DEAL_TO_CONTACT |
0-4 | 0-1 | 0-3 | CONTACT_TO_DEAL |
0-5 | 0-3 | 0-2 | DEAL_TO_COMPANY |
... | ... | ... | ... |
Exemplo 2
Recuperar os tipos de associação disponíveis entre negócios e empresas.
Consulta:
SELECT
combinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
WHERE fromObjectTypeId = '0-3' AND toObjectTypeId = '0-2'
AND isMainAssociationDefinition = trueORDER BY category, id
Retorna:
COMBINEDASSOCIATIONTYPE | FROMOBJECTTYPEID | TOOBJECTTYPEID | NAME |
0-5 | 0-3 | 0-2 | DEAL_TO_COMPANY |
0-271 | 0-3 | 0-2 | DEAL_TO_PRIMARY_COMPANY |
0-341 | 0-3 | 0-2 | DEAL_TO_COMPANY_UNLABELED |
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:
Nome da coluna | Tipo | Descrição |
COMBINEDASSOCIATIONTYPEID |
Varchar | O identificador único da definição da associação. |
FROMOBJECTID |
Número | O ID do objeto fonte. |
TOOBJECTID |
Número | O ID do objeto de destino. |
INGESTEDAT |
Data/hora | A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. Saiba mais sobre os tipos de dados das colunas. |
Exemplo 1
Recuperar todos os negócios e contatos associados.
Consulta:
SELECT combinedAssociationTypeId, fromObjectId, toObjectId
FROM associations
WHERE combinedAssociationTypeId = '0-5'
Retorna:
COMBINEDASSOCIATIONTYPEID | FROMOBJECTID | TOOBJECTID |
0-5 | 6626541373 | 233620335 |
0-5 | 6616436082 | 3866015468 |
0-5 | 6690805943 | 7132752747 |
... | ... | ... |
Exemplo 2
Recuperar todos os tickets associados a um contato específico (ID de contato: 3005).
Consulta:
SELECT combinedAssociationTypeId, fromObjectId, toObjectId
FROM associations
WHERE associationCategory = 'HUBSPOT_DEFINED'
AND combinedAssociationTypeId = '0-15'
AND fromObjectId = 3005;
Retorna:
COMBINEDASSOCIATIONTYPE | FROMOBJECTID | TOOBJECTID |
0-5 | 6626541373 | 233620335 |
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:
SELECT combinedAssociationTypeId, fromObjectId toObjectId,
FROM associations
WHERE
combinedAssociationTypeId = (
SELECT combinedAssociationTypeId
FROM association_definitions
WHERE fromObjectTypeId = '0-1'
AND toObjectTypeId = '0-3'
AND isMainAssociationDefinition)
AND fromObjectId = 4464;
Retorna:
COMBINEDASSOCIATIONTYPEID | FROMOBJECTID | TOOBJECTID |
0-5 | 6626541373 | 233620335 |
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:
Nome da coluna | Tipo | Descrição |
OWNERID |
Número | O ID de proprietário do usuário. |
USERID |
Número | O ID de usuário do usuário. Os usuários com NULL nesta coluna foram excluídos. |
EMAIL |
Varchar | O endereço de e-mail do usuário. |
FIRSTNAME |
Varchar | O nome do usuário. |
LASTNAME |
Varchar | O sobrenome do usuário. |
ARCHIVED |
Booleano | Se o usuário foi excluído. |
CREATEDAT |
Data/hora | A data e hora em que o usuário foi criado no HubSpot. Consulte os tipos de dados da coluna para obter mais informações. |
UPDATEDAT |
Data/hora | A data e hora em que o usuário foi atualizado pela última vez no HubSpot. Consulte os tipos de dados da coluna para obter mais informações. |
INGESTEDAT |
Data/hora | A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. |
Exemplo 1
Recuperar todos os usuários. O WHERE archived = false
filtro remove usuários excluídos dos dados retornados.
Consulta:
SELECT ownerId, userId, email, firstname, lastname
FROM owners
WHERE archived = false
Retorna:
OWNERID | ID DO USUÁRIO | FIRSTNAME | LASTNAME | |
29584574 | 4621126 | 233620335 | Hobbes | Baron |
30532717 | 4874784 | 3866015468 | Pablo | Walters |
30580321 | 925511 | 7132752747 | Milo | Gold |
... | ... | ... | ... | ... |
Exemplo 2
Recuperar um proprietário específico através do seu ID de proprietário.
Consulta:
SELECT ownerId, userId, email, firstname, lastname
FROM owners
WHERE ownerId = 29584574;
Retorna:
OWNERID | ID DO USUÁRIO | FIRSTNAME | LASTNAME | |
29584574 | 4621126 | 233620335 | Hobbes | Baron |
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.
SELECT
contact.objectId contactid,
contact.property_firstname contact_firstname,
contact.property_lastname contact_lastname,
contact.property_hubspot_owner_id contact_hubspot_owner_id,
owner.firstname owner_firstname,
owner.lastname owner_lastname,
owner.email owner_email
FROM objects_contacts contact
JOIN owners owner ON contact.property_hubspot_owner_id = owner.ownerId
Retorna:
CONTACTID | CONTACT_FIRSTNAME | CONTACT_LASTNAME | CONTACT_HUBSPOT_OWNER_ID | OWNER_FIRSTNAME | OWNER_LASTNAME | OWNER_EMAIL |
113834202 | Ricardo | Greenfield | 29584574 | Hobbes | Baron | hobbes.b@business.com |
53540801 | Ford | Karl | 30241125 | Milo | Gold | milo.g@business.com |
... | ... | ... | ... | ... | ... | ... |
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:
Nome da coluna | Tipo | Descrição |
TEAMID | Número | O ID da equipe. |
TEAMNAME | Varchar | O nome da equipe. |
PARENTTEAMID | Número | A identificação da equipe principal. |
CHILDTEAMIDS | Matriz | Os IDs das equipes secundárias. |
PRIMARYOWNERMEMBERS | Varchar | Os IDs de proprietário dos membros principais da equipe. |
SECONDARYOWNERMEMBERS | Booleano | Os IDs de proprietário dos membros secundários da equipe. |
INGESTEDAT | Data/hora | A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. |
Exemplo 1
Recuperar todas as equipes.
Consulta:
SELECT teamId,teamName, primaryOwnerMembers
DE equipes
Retorna:
TEAMID | TEAMNAME | PRIMARYOWNERMEMBERS |
29584574 | Subequipe | [233620335, 1234553] |
30532717 | Super equipe | [3866015468, 126221873] |
3058032 | Uma equipe | [7132752747] |
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:
Nome da coluna | Tipo | Descrição |
TEAMID | Número | O ID da equipe. |
OWNERID | Número | O ID de proprietário do usuário. |
ISTEAMPRIMARY | Booleano | Se esta é a equipe principal para este proprietário. |
INGESTEDAT | Data/hora | A data e a hora em que os dados foram assimilados pela última vez pelo Snowflake. |
Exemplo 1
Recuperar todos os proprietários de uma determinada equipe.
Consulta:
SELECT teamId, ownerId, isTeamPrimary
FROM teams
WHERE teamId = 29584574
Devoluções
TEAMID | TEAMNAME | ISTEAMPRIMARY |
29584574 | 233620335 | verdadeiro |
29584574 | 1234553 | verdadeiro |
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:
Nome da coluna | Tipo | Descrição |
PIPELINEID |
Varchar | O ID do pipeline. |
OBJECTTYPEID |
Varchar | O ID do objeto que o pipeline pode conter (por exemplo, negócios ou tickets). |
LABEL |
Varchar | O nome do pipeline no HubSpot. |
DISPLAYORDER |
Número | A ordem em que o pipeline é exibido no HubSpot. |
ARCHIVED |
Booleano | Se o pipeline foi excluído. |
CREATEDAT |
Data/hora | Quando o pipeline foi criado. |
UPDATEDAT |
Data/hora | A data e hora em que os dados foram atualizados pela última vez no HubSpot. Saiba mais sobre os tipos de dados das colunas. |
INGESTEDAT |
Data/hora | A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. |
Exemplo 1
Recuperar todos os pipelines disponíveis, ordenados pela sua ordem no HubSpot.
Consulta:
SELECT objectTypeId, pipelineId, label
FROM pipelines
WHERE objectTypeId = '0-3'
AND not archived
ORDER BY displayorder;
Retorna:
OBJECTTYPEID | PIPELINEID | LABEL |
0-3 | 1bed503c-37f7-4f51-9d40-7598902673f4 | Pipeline de vendas |
0-3 | 12659678 | Pipeline de licenças |
0-3 | 75e28846-ad0d-4be2-a027-5e1da6590b98 | Nova empresa |
... | ... | ... |
Exemplo 2
Recuperar negócios dentro de um pipeline específico. Une object_with_object_properties e pipelines.
Consulta:
SELECT
deals.objectId deal_id,
deals.property_dealname deal_name,
pipelines.label pipeline_name
FROM objects_deals deals
INNER JOIN pipelines
ON deals.objectTypeId = pipelines.objectTypeId
AND deals.property_pipeline = pipelines.pipelineid
WHERE pipelines.objectTypeId = '0-3';
Retorna:
DEAL_ID | DEAL_NAME | PIPELINE_NAME |
605140072 | Inscrição global Meowmix | Pipeline de vendas |
605457408 | Renomeação da Friskies | Pipeline de vendas |
604362473 | Versão do aplicativo Fresh Step | Pipeline de vendas |
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.
SELECT
deals.objectId deal_id,
deals.properties:dealname::varchar deal_name,
pipelines.label pipeline_name
FROM object_with_object_properties deals
INNER JOIN pipelines
ON deals.objectTypeId = pipelines.objectTypeId
AND deals.properties:pipeline::string = pipelines.pipelineid
WHERE deals.objecttypeId = '0-3'
AND pipelines.objectTypeId = '0-3';
Retorna:
DEAL_ID |
DEAL_NAME |
PIPELINE_NAME |
605140072 |
Inscrição global Meowmix |
Pipeline de vendas |
605457408 |
Renomeação da Friskies |
Pipeline de vendas |
604362473 |
Versão do aplicativo Fresh Step |
Pipeline de vendas |
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:
Nome da coluna | Tipo | Descrição |
PIPELINEID |
Varchar | O ID do pipeline. |
STAGEID |
Varchar | O ID do estágio. |
LABEL |
Varchar | O nome do estágio no HubSpot. |
DISPLAYORDER |
Número | A ordem em que o pipeline é exibido no HubSpot. |
METADATA |
Variante | Uma descrição formatada em JSON do estágio, incluindo se ele está aberto ou fechado |
ARCHIVED |
Booleano | Se o estágio do pipeline foi excluído. |
CREATEDAT |
Data/hora | Quando o estágio de pipeline foi criado. |
Exemplo 1
Recuperar as etapas de um pipeline para um pipeline de negócios chamado Pipeline de vendas.
Consulta:
SELECT pipelineid, stageId, label
FROM pipeline_stages
WHERE not archived
AND pipelineid = (
SELECT pipelineid
FROM pipelines
WHERE objectTypeId = '0-3'
AND not archived
AND label = 'Sales Pipeline' LIMIT 1)
ORDER BY displayorder;
Retorna:
PIPELINEID | STAGEID | LABEL |
941650 | 941651 | Contatado |
941650 | 941652 | Compromisso agendado |
941650 | 941653 | Fatura enviada |
... | ... | ... |
Exemplo 2
Recuperar todos os negócios e suas respectivas fases de pipeline.
Consulta:
SELECTdeals.objectId deal_id,
deals.properties:dealname::varchar deal_name,
pipelines.label pipeline_name,
pipeline_stages.label pipeline_stage_name
FROM object_with_object_properties deals
INNER JOIN pipelines
ON deals.objectTypeId = pipelines.objectTypeId
AND deals.properties:pipeline::string = pipelines.pipelineid
INNER JOIN pipeline_stages
ON deals.objectTypeId = pipeline_stages.pipelineid
AND deals.properties:pipeline::string = pipeline_stages.pipelineid
AND deals.properties:dealstage::string = pipeline_stages.stageId
WHERE deals.objecttypeId = '0-3';
Retorna:
DEAL_ID | DEAL_NAME | PIPELINE_NAME | PIPELINE_STAGE_NAME |
605140072 | Inscrição global Meowmix | Pipeline de vendas | Contrato enviado |
605457408 | Renomeação da Friskies | Pipeline de vendas | Compromisso agendado |
604362473 | Versão do aplicativo Fresh Step | Pipeline de vendas | Contrato assinado |
... | ... | ... | ... |
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:
Nome da coluna | Tipo | Descrição |
OBJECTYPEID |
Varchar | O ID do objeto com o qual o evento se relaciona. |
NAME |
Varchar | O nome interno da propriedade. |
LABEL |
Varchar | O rótulo da propriedade. |
DESCRIPTION |
Varchar | A descrição da propriedade. |
TYPE |
Varchar | O tipo da propriedade (por exemplo, string, número, data e hora). |
FIELDTYPE |
Varchar | O tipo de campo da propriedade. Define como a propriedade é exibida no HubSpot e em formulários (por exemplo, caixa de seleção, seleção). |
DISPLAYORDER |
Número | A ordem de exibição da propriedade. |
GROUPNAME |
Varchar | O nome do grupo da propriedade. |
OPTIONS |
Variante | Para propriedades de enumeração, um conjunto de opções da propriedade, incluindo os atributos de cada opção (por exemplo, ordem de exibição, rótulo). |
CREATEDUSERID |
Número | O ID do usuário que criou a propriedade. |
REFERENCEDOBJECTTYPE |
Varchar | O tipo de objeto a qual a propriedade referencia. As propriedades do proprietário devolverão um valor de OWNER. |
CALCULATED |
Booleano | Se a propriedade é um propriedade calculada. |
EXTERNALOPTIONS |
Booleano | Se as opções da propriedade estão definidas em um sistema externo. |
HASUNIQUEVALUE |
Booleano | Se os valores da propriedade são únicos. Só pode ser definido ao criar uma propriedade através da API. |
HIDDEN |
Booleano | Se a propriedade está oculta no HubSpot. |
SHOWCURRENCYSYMBOL |
Booleano | Se o número de valor de uma propriedade é formatado como moeda. |
FORMFIELD |
Booleano | Se esta propriedade pode ser usada em formulários. |
READONLYDEFINITION |
Booleano | Se a propriedade pode ser editada no HubSpot. |
READONLYVALUE |
Booleano | Se o valor da propriedade pode ser editado no HubSpot. |
HUBSPOTDEFINED |
Booleano | Se a propriedade foi criada pela HubSpot, versus criada por um usuário. |
ARCHIVED |
Booleano | Se a propriedade foi excluída. |
CREATEDAT |
Data/hora | A data e hora em que a propriedade foi criada no HubSpot. |
UPDATEDAT |
Data/hora | A data e hora em que os dados foram atualizados pela última vez no HubSpot. Saiba mais sobre os tipos de dados das colunas. |
INGESTEDAT |
Data/hora | A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. |
Exemplo 1
Recuperar os nomes e as descrições de todas as propriedades do contato.
Consulta:
SELECT name, label, description
FROM property_definitions
WHERE objectTypeId = '0-1'
Retorna:
NAME | LABEL | DESCRIPTION |
enter_sql_stage | Entrada na fase SQL | Iniciar contagem de dias de fase SQL. |
first_conversion_event_name
|
Primeira conversão | O primeiro formulário que esse contato enviou. |
endereço | Endereço | O endereço do contato. |
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
.
Nome | |
EVENTS_AD_INTERACTION | Detalhes de um anúncio e contatos que interagiram com ele clicando no anúncio ou enviando um formulário após interagir com ele. |
EVENTS_AD_METRICS_IMPORTED_V0 |
Detalhes de um anúncio e suas métricas de desempenho. |
EVENTS_CALL_MENTIONED_KEYWORD | Detalhes das palavras-chave mencionadas por quaisquer participantes nas chamadas. |
EVENTS_CLICKED_LINK_IN_EMAIL_V2 |
Links clicados em e-mails de marketing por contatos. |
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8 | Links clicados em e-mails da Caixa de entrada de conversas por contatos. |
EVENTS_COOKIE_BANNER_CLICKED | Contatos que clicaram em cookies. |
EVENTS_COOKIE_BANNER_VIEWED | Contatos que visualizaram cookies. |
EVENTS_DOCUMENT_SHARED_V2 | Documentos de vendas compartilhados com contatos através de um link externo. |
EVENTS_DOCUMENT_VIEWED_V2 | Documentos de vendas e contatos que foram visualizados por eles abrindo o link externo. |
EVENTS_DOCUMENT_COMPLETED_V2 | Documentos de vendas e contatos que os fecharam. |
EVENTS_HS_SCHEDULED_EMAIL_V2 | Emails enviados aos servidores de email da HubSpot para serem enviados. |
EVENTS_MTA_DELIVERED_EMAIL_V2 | Emails entregues com sucesso aos destinatários pelos servidores de email HubSpot. |
EVENTS_MTA_BOUNCED_EMAIL_V2 | Tentativas de entrega de email rejeitadas pelo servidor de email do destinatário. |
EVENTS_OPENED_EMAIL_V2 | O e-mail é aberto por contatos. |
EVENTS_REPORTED_SPAM_EMAIL_V2 | Emails marcados como spam pelos destinatários. |
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2 | Alterações nas assinaturas de e-mail por destinatários. |
EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8 | O e-mail da caixa de entrada do Conservations é aberto pelos contatos. |
EVENTS_MB_MEDIA_PLAYED | Atividade de reprodução de vídeo por contatos. |
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE | O contato reservou uma reunião por meio de sequência. |
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE | Contato inscrito na sequência. |
EVENTS_V2_CONTACT_FINISHED_SEQUENCE | Sequência finalizada. |
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL | O contato respondeu ao e-mail (ou e-mail recebido cuja sequência cancelada) enviado por meio da sequência. |
EVENTS_V2_CONTACT_UNENROLLED_FROM_SEQUENCE | Contato cancelado da sequência. |
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE | O usuário cancelou manualmente a inscrição do contato. |
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL | Contato cancelado, cancelando a inscrição da sequência. |
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED | E-mail de sequência devolvido. |
EVENTS_V2_SEQUENCE_ERRORED | Sequência com erro causando cancelamento de inscrição. |
EVENTS_V2_SEQUENCE_STEP_EXECUTED | Etapa de sequência executada. |
EVENTS_VISITED_PAGE | Visitas à página do site por contatos. |
EVENTOS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER> | Eventos de integração (API da linha do tempo V3) |
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:
Observe: A HubSpot adicionou duas novas colunas a todas as tabelas e visualizações de eventos:
occurredat
occurredatdateint
Essas colunas substituirão o occuredat
e occuredatdateint
colunas em 24 de novembro de 2022. Nessa data, as colunas antigas não estarão mais disponíveis e as tentativas de consultar um objeto de banco de dados ou uma visualização contendo eventos usando essas colunas falharão. Aprender mais sobre alterações importantes para compartilhamentos de dados do Snowflake.
Nome da coluna | Tipo | Descrição |
EVENTTYPEID |
Varchar | O ID do tipo de evento, semelhante a OBJECTTYPEID Você pode consultar todos os IDs de tipo de evento em sua conta usando o object_and_event_type_definitions visualizar. |
ID |
Varchar | Isso é exclusivo por tipo de evento. Dois registros não terão o mesmo ID em um determinado tipo de evento. |
OBJECTTYPEID |
Varchar | O tipo de objeto que completou o evento. Por exemplo, um clique em um link de e-mail exibiria 0-1 nesta coluna, representando o objeto de contatos. |
OBJECTID |
Número | O ID do registro que completou o evento. |
OCCURREDAT |
Data/hora | Quando o evento ocorreu. |
|
Número | Um número que representa quando o evento ocorreu. Contém os mesmos dados que o OCCURREDAT coluna, mas formatada como um número e usada como parte da chave de cluster da tabela. Na maioria dos casos, você pode usar o OCCURREDAT carimbo de data / hora em vez deste número. |
|
Número | Um número que representa quando o evento ocorreu. Contém os mesmos dados que o Observe: esta coluna será obsoleta em 24 de novembro de 2022 e substituída por |
OCCUREDAT |
Data/hora | Quando o evento ocorreu. Observe: esta coluna será obsoleta em 24 de novembro de 2022 e substituída por |
INGESTEDAT |
Data/hora | A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. Saiba mais sobre os tipos de dados das colunas. |
PROPERTY_* |
Varchar | Colunas individuais que contêm as propriedades do evento. |
Exemplo 1
Recuperar os 50 mais recentes eventos de clique por e-mail.
Consulta:
SELECT eventTypeId, objectTypeId, objectId, occuredAt, property_hs_click_raw_url AS hs_click_raw_url
FROM events_clicked_link_in_email_V2
ORDER BY occuredAt
LIMIT 50;
Retorna:
EVENTTYPEID | OBJECTTYPEID | OBJECTID | OCCUREDAT | HS_CLICK_RAW_URL |
4-666288 | 0-1 | 45318579 | 2016-08-04 21:06:43.245 | http://website.com?utm_campaign=Launch&utm_source=hs_email&utm_medium=email&utm_content=32520579 |
4-666288 | 0-1 | 80701 | 2016-08-29 13:31:28.622 | https://cta-image-cms2.hubspot.com/ctas/v2/public/cs/ci/?pg=f0f6585a-08fc-4273-8422-49cfaddcf8d8&pid=1976760&ecid=ACsprvtkRbakerw4BiWlaDL7xFAqau1aW9m1_PAqSfQiWarY69X7Ds 42zHGYTCfhHJLrXUP86Nxu |
4-666288 | 0-1 | 26146013 | 2017-11-30 14:27:11.528 | https://hubs.ly/H097a37a?utm_source=hs_email&utm_medium=email&utm_content=58251290 |
... | ... | ... | ... | ... |
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:
SELECT
click.occuredat click_timestamp,
click.property_hs_click_raw_url click_url,
contact.properties:firstname::varchar contact_firstname,
contact.properties:lastname::varchar contact_lastname
FROM events_clicked_link_in_email_V2 click
LEFT JOIN object_with_object_properties contact
ON click.objectTypeId = contact.objectTypeId
AND click.objectId = contact.objectId
LIMIT 3;
Retorna:
CLICK_TIMESTAMP | CLICK_URL | CONTACT_FIRSTNAME | CONTACT_LASTNAME |
2019-01-04 22:35:41.264 | https://help.website.com/articles/tutorial/how-to-use-email-tool?utm_source=hs_automation&utm_medium=email&utm_content=68042217 | Hobbes | Baron |
2018-11-08 09:37:41.400 | https://www.website.net/webinar-case-study?utm_source=hs_automation&utm_medium=email&utm_content=55200164 | Milo | Gold |
2018-11-08 09:37:41.426 | https://www.website.net/contact?utm_source=hs_automation&utm_medium=email&utm_content=55200164 | Carlow | Villari |
... | ... | ... | ... |
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:
Nome da coluna | Tipo | Descrição |
OBJECTTYPEID |
Varchar | O ID do objeto que o pipeline pode conter (por exemplo, negócios ou tickets). |
FULLYQUALIFIEDNAME |
Varchar | O nome do objeto ou evento. |
INGESTEDAT |
Data/hora | A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. Saiba mais sobre os tipos de dados das colunas. |
Exemplo 1
Recuperar todos os objetos e eventos disponíveis na sua conta do HubSpot.
Consulta:
SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;
Retorna:
OBJECTTYPEID | FULLYQUALIFIEDNAME |
0-1 | CONTACT |
0-8 | LINE_ITEM |
0-11 | CONVERSATION |
... | ... |
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:
Nome da coluna | Tipo | Descrição |
OBJECTTYPEID |
Varchar | O tipo de registros na lista (por exemplo, contato ou empresa). |
LISTID |
Número | O ID da lista. Une-se à coluna LISTID na tabela list-memberships. |
CLASSICLISTID |
Número | Um ID específico para listas de contatos que corresponda ao ID no URL da lista no HubSpot. |
NAME |
Varchar | O nome da lista. |
SIZE |
Número | O número de registros na lista. |
CREATEDBYUSERID |
Número | O ID do usuário que criou a lista. |
CREATEDAT |
Data/hora | Quando a lista foi criada no HubSpot. |
UPDATEDBYUSERID |
Número | O ID do usuário que mais recentemente atualizou a lista. |
UPDATEDAT |
Data/hora | A data e a hora em que a data foi atualizada pela última vez no HubSpot. Saiba mais sobre os tipos de dados das colunas. |
INGESTEDAT |
Data/hora | A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. |
Exemplo 1
Recuperar todas as listas de contatos.
Consulta:
SELECT listId, name, size
FROM lists
WHERE objectTypeId = '0-1';
Retorna:
LISTID | NAME | TAMANHO |
118131 | Contato semanal | 103 |
66156 | Inscritos do blog | 455 |
771852 | Principais inscritos de 2021 | 37 |
... | ... | ... |
Exemplo 2
Recuperar uma lista de contatos específica chamada Principais inscritos de 2021.
Consulta:
SELECT listId, name, size
FROM lists
WHERE objectTypeId = '0-1'
ANDlistName = 'Top subscribers 2021';
Retorna:
LISTID | NAME | TAMANHO |
771852 | Principais inscritos de 2021 | 37 |
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:
Nome da coluna | Tipo | Descrição |
LISTID |
Varchar | O ID da lista. Una a coluna HS_LIST_ID na tabela lists. |
OBJECTID |
Varchar | O ID do registro na lista. |
UPDATEDAT |
Data/hora | A data e hora em que os dados foram atualizados pela última vez no HubSpot. Saiba mais sobre os tipos de dados das colunas. |
INGESTEDAT |
Data/hora | A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. |
Exemplo 1
Recuperar os IDs de todos os contatos da lista Principais inscritos de 2021.
Consulta:
SELECT objectId
FROM list_memberships
INNER JOIN lists
ON list_memberships.listId = lists.listId
WHERE lists.objectTypeId = '0-1'
AND lists.name = 'Top Subscribers 2021';
Retorna:
OBJECTID |
54325098 |
96805401 |
6922028 |
... |
Exemplo 2
Recuperar o nome e o sobrenome dos detalhes dos contatos no Principais assinantes 2021 lista.
Consulta:
SELECT
contact.objectId AS objectid,
contact.property_firstname AS firstname,
contact.property_lastname AS lastname
FROM objects_contacts contact
INNER JOIN list_memberships ON contact.objectId = list_memberships.objectId
INNER JOIN lists ON list_memberships.listId = lists.listId
WHERE lists.objectTypeId = '0-1'
AND lists.name = 'Top Subscribers 2021'
Retorna:
OBJECTID |
FIRST NAME |
LAST NAME |
54325098 |
Hobbes |
Baron |
96805401 |
Milo |
Gold |
6922028 |
Henry |
Riley |
... |
... |
... |
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:
SELECT * FROM property_definitions
WHERE label = [column_name]
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:
SELECT campaigns.property_hs_name campaign_name,
forms.property_hs_form_id form_id
FROM objects_campaigns campaigns
JOIN associations_campaigns_to_forms assoc ON
assoc.campaign_objectid=campaigns.objectid
JOIN objects_forms forms ON forms.objectid=assoc.form_objectid
GROUP BY campaign_name
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:
STATUS | MENSAGEM | ATUALIZADO |
OK | NENHUM INCIDENTE CONHECIDO NO MOMENTO | 10/04/2023 09:21:20.123 |
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.