Isenção de responsabilidade de tradução: esse conteúdo foi traduzido para sua conveniência com o uso de software e pode não ter sido revisado por uma pessoa.

Consultar dados do HubSpot em Snowflake_PT

Ultima atualização: 24 de setembro de 2026

Disponível com qualquer uma das seguintes assinaturas, salvo menção ao contrário:

Data Hub Enterprise

Após conectar o Snowflake à sua conta no HubSpot, você pode usar o compartilhamento de dados do Snowflake para consultar os dados do HubSpot a partir da sua conta no 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:

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, objectId, updatedAt

DE hubspot_share_name. V2_LIVE.objects

WHERE objectTypeId = '0-3'

LIMITE 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 os tipos de associação disponíveis e registros associados no momento.
Eventos: dados de eventos para eventos padrão do HubSpot, como aberturas de e-mail, e eventos comportamentais personalizados.
Segmentos: segmentos de contatos e de empresas da HubSpot.
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 de CRM, incluindo histórico de propriedade.

Saiba mais sobre 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. Essas alterações sempre serão publicadas 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

Objetos FROM

WHERE objectTypeId = '0-1'

ORDENAR POR objectId

LIMITE 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.

floco de neve-barra lateral-visualização-detalhes da coluna0

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

SELECT objectTypeId, updatedAt, ingestedAt

Objetos FROM

WHERE objectTypeId = '0-1'

ORDENAR POR objectId

LIMITE 10;

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 segmentos, refere-se ao tipo de segmento (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 criar processos ETL que copiam dados alterados recentemente, é recomendável basear suas consultas no carimbo de data/hora de inclusão. 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 é recomendável basear os 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.

Os dados do Objeto estão disponíveis em objetos de banco de dados compartilhados. Filtrar por objectTypeId para recuperar um tipo de objeto específico. Use OBJECT_WITH_OBJECT_PROPERTIES quando você precisar das propriedades atuais de cada registro. Os valores de properties Propriedade são armazenados na JColuna SON. Use OBJECTS para atributos de registros principais e OBJECT_PROPERTIES /ou OBJECT_PROPERTIES_HISTORY para dados por propriedade.

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.

Veja mais detalhes em object_with_object_properties, object_properties, objetos e object_properties_history abaixo.

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	IDDEOBJETO	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:

SELECT
objectId,
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:

IDDEOBJETO	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.

Este objeto de banco de dados contém dados de objeto atuais sem valores de propriedade. Use-o quando precisar apenas de atributos de registro principal ou junte-o a OBJECT_PROPERTIES quando precisar de propriedades selecionadas. 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	IDDEOBJETO
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	IDDEOBJETO	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	IDDEOBJETO	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:

IDDEOBJETO	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
WHEREobject_properties_history.objectTypeId = '0-1'
AND object_properties_history.name = 'lifecyclestage'
AND object_properties_history.value = 'subscriber'
);

Retorna:

IDDEOBJETO	FIRSTNAME	LASTNAME
54325098	Hobbes	Baron
96805401	Milo	Gold
6922028	Henry	Riley
...	...	...

Consultas de associação

Os dados da Associação estão disponíveis em ASSOCIATIONS. Filtre por combinedAssociationTypeId para recuperar um tipo de associação específico. Unir ASSOCIATIONS com ASSOCIATION_DEFINITIONS para identificar os tipos de objetos relacionados e a definição da associação.

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:

SELECTcombinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
WHERE fromObjectTypeId = '0-3' AND toObjectTypeId = '0-2' AND isMainAssociationDefinition = true
ORDER 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.

Este objeto de banco de dados contém registros de associação para todos os tipos de associação. Filtre combinedAssociationTypeId e associe com ASSOCIATION_DEFINITIONS quando precisar de metadados de associação.

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	E-MAIL	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	E-MAIL	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.

SELECIONE

contato.objectId AS contact_id,

contato.properties:firstname::string AS contact_firstname,

contato.properties:lastname::string AS contact_lastname,

contato.properties:hubspot_owner_id::number AS contact_hubspot_owner_id,

proprietário.firstname AS owner_firstname,

proprietário.lastname AS owner_lastname,

proprietário.email COMO owner_email

DE object_with_object_properties COMO contato

JUNTE-SE aos proprietários COMO PROPRIETÁRIO

ON contato.properties:hubspot_owner_id::number = proprietário.ownerId

WHERE contato.objectTypeId = '0-1';

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 negócio e do pipeline de tickets, como os pipelines disponíveis na sua conta e as respectivas fases.

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 object_with_object_properties com pipelines.

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

Recupere negócios dentro de uma pipeline específica usando 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:

SELECT
deals.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:

ID_negócio	NOME_negócio	NOME_DA_pipeline	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 personalizados de comportamento . 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 da 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. Saiba mais sobre as mudanças de quebra dos compartilhamentos de dados 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.
`OCCURREDATDATEINT`	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.
`OCCUREDATDATEINT`	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. Observe que esta coluna será preterida em 24 de novembro de 2022 e substituída por `OCCURREDATDATEINT`.
`OCCUREDAT`	Data/hora	Quando o evento ocorreu. Observação: esta coluna será descontinuada em 24 de novembro de 2022 e substituída por `OCCURREDAT`.
`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 occuredAtLIMIT 50;

Retorna:

EVENTTYPEID	OBJECTTYPEID	IDDEOBJETO	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
...	...

Consultas de segmentos

Abaixo, aprenda a consultar seus segmentos, como os segmentos de contato e empresa disponíveis e os registros incluídos nesses segmentos.

segmentos

Este objeto de banco de dados contém informações sobre segmentos de contato e empresa HubSpot. Retorna uma linha por segmento e as colunas incluem detalhes do segmento, como nome, tamanho e tipo de objeto dos registros que ele contém. Não contém informações sobre os registros individuais em cada segmento (consulte segment_participação ).

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

Nome da coluna	Tipo	Descrição
`OBJECTTYPEID`	Varchar	O tipo de registros no segmento (por exemplo, contato ou empresa).
`SEGMENTID`	Número	A ID do segmento. Une à coluna SEGMENTID na tabela de participações de segmentos .
`CLASSICSEGMENTID`	Número	Uma ID específica para segmentos de contato que corresponde à ID na URL do segmento no HubSpot.
`NAME`	Varchar	O nome do segmento.
`SIZE`	Número	O número de registros no segmento.
`CREATEDBYUSERID`	Número	A ID do usuário que criou o segmento.
`CREATEDAT`	Data/hora	Quando o segmento foi criado no HubSpot.
`UPDATEDBYUSERID`	Número	A ID do usuário que atualizou o segmento mais recentemente.
`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 todos os segmentos de contato.

Consulta:

SELECT segmentId, name, size
FROM segments
WHERE objectTypeId = '0-1';

Retorna:

SIDDESEGMENTOS	NAME	TAMANHO
118131	Contato semanal	103
66156	Inscritos do blog	455
771852	Principais inscritos de 2021	37
...	...	...

Exemplo 2

Recupere um segmento de contato específico denominado Principais assinantes 2021.

Consulta:

SELECT segmentId, name, size
FROM segments
WHERE objectTypeId = '0-1' ANDsegmentName = 'Top subscribers 2021';

Retorna:

IDDESEGMENTO	NAME	TAMANHO
771852	Principais inscritos de 2021	37

participação_segmento

Este objeto de banco de dados contém informações sobre quais registros são membros de quais segmentos, com uma linha por registro no segmento. Por exemplo, se você tiver um segmento de assinantes do blog com 500 contatos, o objeto de banco de dados retornará 500 linhas.

Contém somente IDs de segmento e IDs de objeto. Para obter mais informações, associe-se ao objeto de banco de dados de segmentos.

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

Nome da coluna	Tipo	Descrição
`SEGMENTID`	Varchar	A ID do segmento. Une à coluna HS_SEGMENT_ID na tabela de segmentos .
`OBJECTID`	Varchar	A ID do registro no segmento.
`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

Recupere as IDs de todos os contatos no segmento Principais assinantes de 2021 .

Consulta:

SELECT objectId
FROM segment_memberships
INNER JOIN segments
ON segment_memberships.segmentId = segments.segmentId
WHERE segments.objectTypeId = '0-1'
AND segments.name = 'Top Subscribers 2021';

Retorna:

IDDEOBJETO

54325098

96805401

6922028

...

Exemplo 2

Recupere o nome e o sobrenome dos detalhes dos contatos no segmento Top subscribers 2021 .

Consulta:

SELECIONE

contato.objectId AS object_id,

contato.properties:nome::string AS nome,

contato.propriedades:sobrenome::string AS sobrenome

DE object_with_object_properties COMO contato

INGRESSE NO segment_memberships INTERNO COMO participação

ON contato.objectId = participação.objectId

Segmentos INNER JOIN

ON participação.segmentId = segments.segmentId

WHERE contato.objectTypeId = '0-1'

E segments.objectTypeId = '0-1'

E segments.name = 'Principais inscritos de 2021';

Retorna:

IDDEOBJETO	FIRST NAME	LAST NAME
54325098	Hobbes	Baron
96805401	Milo	Gold
6922028	Henry	Riley
...	...	...

FAQs

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

Em geral, você deve examinar as colunas presentes no relatório com o qual 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. Consulte object_with_object_properties e filtre pelo para esse objectTypeId tipo. Leia os valores de propriedade necessários na coluna JSON de propriedades.

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

Para recuperar formulários associados a cada campanha, junte-se a OBJECT_WITH_OBJECT_PROPERTIES, ASSOCIATIONSe ASSOCIATION_DEFINITIONS.

SELECIONE DISTINTO

campaigns.properties:hs_name::string AS campaign_name,

forms.properties:hs_form_id::string AS form_id

DE CAMPANHAS DE object_with_object_properties AS

JOIN associações COMO associação

ON associação.fromObjectId = campaigns.objectId

ASSOCIE-SE À DEFINIÇÃO DE association_definitions AS

ON definition.combinedAssociationTypeId =

associação.combinedAssociationTypeId

ASSOCIE-SE object_with_object_properties FORMULÁRIOS

ON forms.objectId = associação.toObjectId

WHERE campaigns.objectTypeId = '0-35'

E forms.objectTypeId = '0-28'

E definição.fromObjectTypeId = '0-35'

E definição.toObjectTypeId = '0-28';

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.

Esse artigo foi útil?

Este formulário deve ser usado apenas para fazer comentários sobre esses artigos. Saiba como obter ajuda para usar a HubSpot.

Consultar dados do HubSpot em Snowflake_PT

Disponível com qualquer uma das seguintes assinaturas, salvo menção ao contrário:

Atraso de dados e região da sua conta Snowflake

Configure seu ambiente no Snowflake

Visão geral dos dados

Limitação e ordem de dados devolvidos

Tipos de dados de coluna

Transformando tipos de dados

Consultas de objetos

object_with_object_properties

Exemplo 1

Exemplo 2

objects

Exemplo 1

object_properties

Exemplo 1

Exemplo 2

object_properties_history

Exemplo 1

Exemplo 2

Consultas de associação

association_definitions

Exemplo 1

Exemplo 2

associações

Exemplo 1

Exemplo 2

Exemplo 3

Consultas do proprietário

owners

Exemplo 1

Exemplo 2

Exemplo 3

Perguntas da equipe

equipes

Exemplo 1

owner_team

Exemplo 1

Consultas de pipelines

pipelines

Exemplo 1

Exemplo 2

pipeline_stages

Exemplo 1

Exemplo 2

Consultas de propriedade

property_definitions

Exemplo 1

Consultas do evento

Exemplo 1

Exemplo 2

Object_and_event_type_queries

object_and_event_type_definitions

Exemplo 1

Consultas de segmentos

segmentos

Exemplo 1

Exemplo 2

participação_segmento

Exemplo 1

Exemplo 2

FAQs

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

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

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

Conteúdo relacionado