Nota: Este contenido se tradujo a través de un software y es posible que no haya sido revisado.

Consultar datos de HubSpot en Snowflake

Última actualización: julio 25, 2022

Requisitos

Después de conectar Snowflake a tu cuenta de HubSpot, puedes utilizar el Uso compartido de datos de Snowflake para consultar los datos de HubSpot desde tu cuenta de Snowflake.

Las consultas se construyen utilizando SQL, y se pueden utilizar para recuperar datos de HubSpot como:

Objetos: objetos estándar y personalizados, como contactos, empresas, productos.
Registros: registros individuales, como un contacto individual o una empresa.
Asociaciones: todos los tipos de asociación disponibles y los registros actualmente asociados.
Propietarios: usuarios de tu cuenta de HubSpot, en relación con los registros de los que son propietarios.
Pipelines: pipelines de negocios y tickets, incluyendo las etapas del pipeline.
Propiedades: propiedades y sus valores en los registros de CRM, incluyendo el historial de propiedades.
Eventos: datos de eventos tanto para los eventos estándar de HubSpot, como las aperturas de correos electrónicos, como para los eventos de comportamiento personalizados.
Listas: listas de contactos y empresas de HubSpot (BETA).

Más información sobre El modelo de datos de CRM de HubSpot

Configura tu entorno Snowflake

Para consultar tus datos de HubSpot en Snowflake, tendrás que seleccionar el almacén, la base de datos y el esquema que quieres consultar. Puedes establecerlos a nivel de hoja de trabajo para incluirlos automáticamente en tus consultas, o puedes agregarlos manualmente.

Para seleccionar el almacén, la base de datos y el esquema a nivel de hoja de cálculo:

En la fila superior de la hoja de trabajo, haga clic en la barra de acciones de la hoja de trabajo
En la ventana emergente:
- Haz clic en el menú desplegable Almacén y selecciona tu almacén.
- Haz clic en el menú desplegable Base de datos y selecciona tu base de datos de HubSpot.
- Haz clic en el menú desplegable Esquema y selecciona el esquema que deseas utilizar:
  Ten en cuenta: actualmente, este esquema solo está disponible si la región de tu cuenta de Snowflake coincide con la región de la cuenta de Snowflake de HubSpot. Para las cuentas de HubSpot en el centro de datos de la UE, esto significa EU_CENTRAL_1_AWS. Para todas las otras cuentas de HubSpot, esto significa US_EAST_1_AWS.
  - V2_DAILY (BETA): el esquema diario para consultar datos basados en tablas. Los datos de este esquema se actualizan una vez al día. El uso de este esquema dará lugar a consultas más rápidas, y se recomienda para consultar directamente en Snowflake.

Con tu entorno configurado, puedes hacer consultas a tus datos de HubSpot sin necesidad de agregar tu base de datos o tipo de esquema a las consultas manualmente.

Para agregar manualmente la base de datos y el tipo de esquema a las consultas, agrega el nombre de la base de datos seguido del esquema al principio del campo FROM. Por ejemplo:

SELECT objectTypeId, objectId
FROM hubspot_share_name.V2_LIVE.object_with_object_properties
WHERE objectTypeId = '0-1'

Resumen de datos

Las consultas se construyen utilizando SQL, y se pueden utilizar para recuperar datos de HubSpot como:

Objetos: objetos estándar y personalizados, como contactos, empresas, productos.
Registros: registros individuales, como un contacto individual o una empresa.
Asociaciones: todos los tipos de asociación disponibles y los registros actualmente asociados.
Propietarios: usuarios de tu cuenta de HubSpot, en relación con los registros de los que son propietarios.
Pipelines: pipelines de negocios y tickets, incluyendo las etapas del pipeline.
Propiedades: propiedades y sus valores en los registros de CRM, incluyendo el historial de propiedades.
Eventos: datos de eventos tanto para los eventos estándar de HubSpot, como las aperturas de correos electrónicos, como para los eventos de comportamiento personalizados.
Listas: listas de contactos y empresas de HubSpot (BETA).

Más información sobre El modelo de datos de CRM de HubSpot

Limitación y ordenación de los datos devueltos

Al construir consultas, puedes controlar la cantidad de datos que se devuelven, junto con el orden en que se devuelven, incluyendo LIMIT y ORDER BY en tu consulta. Por ejemplo, para consultar todos los contactos con sus propiedades, pero devolver sólo tres resultados y ordenarlos por el ID del contacto, podrías construir tu consulta de la siguiente manera:

SELECT objectTypeId, objectId, properties
FROM object_with_object_properties
WHERE objectTypeId = '0-1'
ORDER BY objectId
LIMIT 10;

Consultas de objetos

A continuación, aprende a consultar datos de objetos y registros específicos de HubSpot, junto con los datos que se devuelven.

Puedes utilizar los siguientes ID de objetos al realizar la consulta:

Nombre del objeto	objectTypeId
Contactos	0-1
Empresas	0-2
Negocios	0-3
Interacciones	0-4
Tickets	0-5
Elementos de línea	0-8

A losobjetos personalizados se les asignará un ID en el momento de su creación, y se identificarán como 2-unique_ID. Por ejemplo, 2-12345. Más información sobre object_and_event_type_definitions.

object_with_object_properties

Esta vista contiene datos de tus registros de HubSpot. Las consultas a esta tabla devuelven una fila por cada registro dentro de un objeto (por ejemplo, todos los registros de contactos en el objeto contactos). Todas las propiedades se almacenan en la columna Propiedades, que es una columna Snowflake Variant / JSON.

Esta vista puede devolver las siguientes columnas:

Nombre de la columna	Tipo	Descripción
`OBJECTTYPEID`	Varchar	El ID del tipo de objeto (por ejemplo, contactos es `0-1`).
`OBJECTID`	Número	El ID del registro (por ejemplo, un registro de contacto con un ID de `123752`).
`PROPERTIES`	Variant	Los valores de la propiedad del registro.
`Actualizado`	Timestamp	La fecha y hora en que el registro fue actualizado por última vez en HubSpot. Más información sobre tipos de datos de columnas.
`INGESTEDAT`	Timestamp	La fecha y la hora en que los datos fueron ingeridos por última vez por Snowflake.

Ejemplo 1

Recuperar todos los contactos y sus propiedades.

Consulta:

SELECT objectTypeId, objectId, properties
FROM object_with_object_properties
WHERE objectTypeId = '0-1'

Devuelve:

OBJECTTYPEID	OBJECTID	PROPERTIES
0-1	38960439	{"createdate": "1504656970152"...}
0-1	321740651	{ "createdate": "1590183081949"...}
0-1	98392101	{ "createdate": "1533566477279"...}
...	...	...

Ejemplo 2

Recupera el nombre y la etapa del negocio de hasta tres negocios.

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;

Devuelve:

OBJECTID	DEALNAME	DEALSTAGE	DEALAMOUNT
38960439	Nombre del negocio 1	2021-10-12 13:49:35.219	2021-10-12 13:49:35.219
321740651	Nombre del negocio 1	2021-10-12 13:49:35.219	2021-10-12 13:49:35.219
98392101	Nombre del negocio 1	2021-10-12 13:49:35.219	2021-10-12 13:49:35.219

objetos

Esta vista es un subconjunto de los datos de la tabla object_with_object_properties. Cada fila devuelve el ID del objeto para cada registro. Esta vista sólo devuelve registros existentes. Cuando se elimina un registro en HubSpot, se eliminará de esta vista.

Esta vista puede ser útil si tu cuenta tiene una gran cantidad de datos, lo que hace que object_with_object_properties funcione lentamente. El uso de esta tabla con la tabla object_properties permite replicar los datos de object_with_object_properties, manteniendo el control sobre qué propiedades se devuelven.

Esta vista puede devolver las siguientes columnas:

Nombre de la columna	Tipo	Descripción
`OBJECTTYPEID`	Varchar	El ID del tipo de objeto (por ejemplo, contactos es `0-1`).
`OBJECTID`	Número	El ID del registro (por ejemplo, un registro de contacto con un ID de `123752`).
`INGESTEDAT`	Timestamp	La fecha y la hora en que los datos fueron ingeridos por última vez por Snowflake. Más información sobre tipos de datos de columnas.

Ejemplo 1

Recuperar todos los registros de contactos.

Consulta:

SELECT objectTypeId, objectId
FROM objects
WHERE objectTypeId = '0-1'

Devuelve:

OBJECTTYPEID	OBJECTID
0-1	36721864
0-1	103580363
0-1	56047670
...	...

object_properties

Esta tabla es un subconjunto de la tabla object_with_object_properties. Cada fila contiene el valor actual de la propiedad establecida en un registro determinado. Por ejemplo, un contacto tendrá una fila para su propiedad Nombre y otra para su propiedad Apellido. Si un registro no tiene un valor para una propiedad, la fila aparecerá con una cadena vacía o no aparecerá en absoluto.

Esta tabla puede ser útil si tu cuenta tiene una gran cantidad de datos, lo que hace que object_with_object_properties funcione lentamente. El uso de esta tabla con la tabla object_properties permite replicar los datos de object_with_object_properties, controlando al mismo tiempo qué propiedades se devuelven.

Esta vista puede devolver las siguientes columnas:

Nombre de la columna	Tipo	Descripción
`OBJECTTYPEID`	Varchar	El ID del tipo de objeto (por ejemplo, contactos es `0-1`).
`OBJECTID`	Número	El ID del registro (por ejemplo, un registro de contacto con un ID de `123752`).
`NAME`	Varchar	El nombre de la propiedad.
`VALUE`	Timestamp	El valor de la propiedad.
`Actualizado`	Timestamp	La fecha y hora en que el registro fue actualizado por última vez en HubSpot. Más información sobre tipos de datos de columnas.
`INGESTEDAT`	Timestamp	La fecha y la hora en que los datos fueron ingeridos por última vez por Snowflake.

Ejemplo 1

Recupera las propiedades de nombre, apellido y ciudad de todos los contactos.

Consulta:

SELECT objectTypeId, objectId, name, value
FROM object_properties
WHERE objectTypeId = '0-1'
AND name IN ('firstname', 'lastname', 'city')
ORDER BY objectId;

Devuelve:

OBJECTTYPEID	OBJECTID	NAME	VALUE
0-1	10401	firstname	Brian
0-1	10401	city	Dublín
0-1	10401	lastname	Gallagher
0-1	23451	firstname	Fernando
0-1	23451	lastname	Fierro
0-1	25751	firstname	Charles
...	...	...	...

Ejemplo 2

Recupera el nombre, el apellido y la etapa del ciclo de vida de todos los contactos y combínalos en una fila por contacto. Este ejemplo utiliza la sintaxis PIVOT de SQL.

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);

Devuelve:

OBJECTTYPEID	OBJECTID	FIRSTNAME	LASTNAME	LIFECYCLESTAGE
0-1	54325098	Hobbes	Barón	lead
0-1	96805401	Milo	Gold	lead
0-1	6922028	Henry	Riley	lead
...	...	...	...	...

object_properties_history

Esta vista contiene los valores históricos de la propiedad. Para los contactos, contiene los 45 valores más recientes. Para todos los demás objetos, contiene los 20 valores más recientes. Muestra una fila para cada valor histórico de la propiedad. El valor actual de una propiedad está determinado por la marca de tiempo UPDATEDAT más reciente en el historial de la propiedad.

Esta vista puede devolver las siguientes columnas:

Nombre de la columna	Tipo	Descripción
`OBJECTTYPEID`	Varchar	El ID del tipo de objeto (por ejemplo, contactos es `0-1`).
`OBJECTID`	Número	El ID del registro (por ejemplo, un registro de contacto con un ID de `123752`).
`NAME`	Varchar	El nombre de la propiedad.
`VALUE`	Timestamp	El valor de la propiedad.
`Actualizado`	Timestamp	La fecha y hora en que los datos fueron actualizados por última vez en HubSpot. Más información sobre tipos de datos de columnas.
`INGESTEDAT`	Timestamp	La fecha y la hora en que los datos fueron ingeridos por última vez por Snowflake.

Ejemplo 1

Recuperar el historial de una sola propiedad para un solo contacto.

Consulta:

SELECT objectId, name, value, timestamp
FROM object_properties_history
WHERE objectTypeId = '0-1'
AND objectId = 585
AND name = 'hs_predictivescoringtier'
ORDER BY timestamp DESC;

Devuelve:

OBJECTTYPEID	OBJECTID	FIRSTNAME	LASTNAME	LIFECYCLESTAGE
0-1	54325098	Hobbes	Barón	lead
0-1	96805401	Milo	Gold	lead
0-1	6922028	Henry	Riley	lead
...	...	...	...	...

Ejemplo 2

Recupera el nombre actual de todos los contactos que han tenido alguna vez una etapa del ciclo de vida de Suscriptor.

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'
);

Devuelve:

OBJECTID	FIRSTNAME	LASTNAME
54325098	Hobbes	Barón
96805401	Milo	Gold
6922028	Henry	Riley
...	...	...

Consultas sobre asociación

A continuación, aprende a consultar las asociaciones, como los tipos de asociaciones disponibles entre los objetos y los registros que están actualmente asociados.

association_definitions

Esta vista contiene información sobre todos los tipos de asociación disponibles entre los objetos de HubSpot, con una fila por tipo de asociación. Puedes unir esta tabla con la tabla de asociaciones para obtener información de asociación específica de los registros.

Puede haber varios tipos de asociaciones entre los mismos objetos. El tipo de asociación principal, que es el que se muestra en HubSpot cuando se asocian los registros, utiliza la asociación donde ISMAINASSOCIATIONDEFINITION es verdadero.

Esta vista puede devolver las siguientes columnas:

Nombre de la columna	Tipo	Descripción
`COMBINEDASOCIACIONTYPEID`	Varchar	El identificador único de la definición de la asociación.
`CATEGORÍA`	Varchar	La fuente del tipo de asociación. Uno de: `HUBSPOT_DEFINED`, `USER_DEFINED`, `INTEGRATOR_DEFINED`
`ID`	Número	El identificador de la definición de la asociación dentro de su categoría.
`FROMOBJECTTYPEID`	Varchar	El ID del objeto que es la fuente de la definición de la asociación.
`TOOBJECTTYPEID`	Varchar	El ID del objeto que es el destino de la definición de la asociación.
`NAME`	Varchar	El nombre de la definición de la asociación.
`LABEL`	Varchar	La etiqueta de la definición de la asociación.
`ISMAINASOCIACIÓNDEFINICIÓN`	Booleano	Si la definición de la asociación es el tipo principal. Cuando es verdadero, la definición es la que HubSpot muestra en los registros asociados.
`INGESTEDAT`	Timestamp	La fecha y la hora en que los datos fueron ingeridos por última vez por Snowflake. Más información sobre tipos de datos de columnas.

Ejemplo 1

Recuperar los tipos de asociaciones disponibles en tu cuenta.

Consulta:

SELECT combinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
ORDER BY category, id

Devuelve:

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

Ejemplo 2

Recuperar los tipos de asociación disponibles entre negocios y empresas.

Consulta:

SELECTcombinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
WHERE fromObjectTypeId = '0-3' AND toObjectTypeId = '0-2' AND isMainAssociationDefinition = true
ORDER BY category, id

Devuelve:

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_COMAPNY_UNLABELED

asociaciones

Esta vista contiene información sobre las asociaciones entre registros específicos. Cada fila representa una asociación de un objeto a otro. Las filas pueden estar presentes en esta tabla aunque los registros referenciados hayan sido eliminados. Puedes comprobar si existen registros uniéndose a la tabla de objetos.

Esta vista puede devolver las siguientes columnas:

Nombre de la columna	Tipo	Descripción
`COMBINEDASOCIACIONTYPEID`	Varchar	El identificador único de la definición de la asociación.
`FROMOBJECTID`	Número	El ID del objeto fuente.
`TOOBJECTID`	Número	El ID del objeto de destino.
`INGESTEDAT`	Timestamp	La fecha y la hora en que los datos fueron ingeridos por última vez por Snowflake. Más información sobre tipos de datos de columnas.

Ejemplo 1

Recuperar todos los negocios y contactos asociados.

Consulta:

SELECT combinedAssociationTypeId, fromObjectId, toObjectId
FROM associations
WHERE combinedAssociationTypeId = '0-5'

Devuelve:

COMBINEDASSOCIATIONTYPE	FROMOBJECTID	TOOBJECTID
0-5	6626541373	233620335
0-5	6616436082	3866015468
0-5	6690805943	7132752747
...	...	...

Ejemplo 2

Recuperar todos los tickets asociados a un contacto específico (ID de contacto: 3005).

Consulta:

SELECT combinedAssociationTypeId, fromObjectId, toObjectId
FROM associations
WHERE associationCategory = 'HUBSPOT_DEFINED'
AND combinedAssociationTypeId = '0-15'
AND fromObjectId = 3005;

Devuelve:

COMBINEDASSOCIATIONTYPE	FROMOBJECTID	TOOBJECTID
0-5	6626541373	233620335

Ejemplo 3

Recuperar todos los negocios asociados a un contacto específico (ID de contacto: 4464). En lugar de codificar combinedAssociationTypeId, este ejemplo se une con association_definitions.

Consulta:

SELECT combinedAssociationType, fromObjectId, toObjectId,
FROM associations
WHERE
combinedAssociationTypeId = (
SELECT combinedAssociationTypeId
FROM association_definitions
WHERE fromObjectTypeId = '0-1'
AND toObjectTypeId = '0-3'
AND isMainAssociationDefinition)
AND fromObjectId = 4464;

Devuelve:

COMBINEDASSOCIATIONTYPE	FROMOBJECTID	TOOBJECTID
0-5	6626541373	233620335

Consultas del propietario

propietarios

Esta vista contiene información sobre los usuarios de tu cuenta de HubSpot. Los usuarios pueden establecerse como propietarios de registros, y contendrán tanto un ID de usuario como un ID de propietario, dependiendo de su contexto. Ambas identificaciones pueden ser utilizadas para identificar al mismo usuario.

Esta vista puede devolver las siguientes columnas:

Nombre de la columna	Tipo	Descripción
`OWNERID`	Número	El ID del propietario del usuario.
`ID DE USUARIO`	Número	La identificación del usuario. Los usuarios con NULL en esta columna han sido eliminados.
`EMAIL`	Varchar	La dirección de correo electrónico del usuario.
`FIRSTNAME`	Varchar	El nombre del usuario.
`LASTNAME`	Varchar	El apellido del usuario.
`ISACTIVE`	Booleano	Si el usuario ha sido eliminado.
`CREATEDAT`	Timestamp	La fecha y hora en que el usuario fue creado en HubSpot. Consulta los tipos de datos de columnas para obtener más información.
`Actualizado`	Timestamp	La fecha y hora en que el usuario fue actualizado por última vez en HubSpot. Consulta los tipos de datos de columnas para obtener más información.

Ejemplo 1

Recuperar todos los usuarios. El filtro WHERE isActive = true elimina los usuarios eliminados de los datos devueltos.

Consulta:

SELECT ownerId, userId, email, firstname, lastname FROM owners WHERE isActive = true

Devuelve:

OWNERID	ACTIVEUSERID	EMAIL	FIRSTNAME	LASTNAME
29584574	4621126	233620335	Hobbes	Barón
30532717	4874784	3866015468	Pablo	Walters
30580321	925511	7132752747	Milo	Gold
...	...	...	...	...

Ejemplo 2

Recuperar un propietario específico por su ID de propietario.

Consulta:

SELECT ownerId, userId, email, firstname, lastname
FROM owners
WHERE ownerId = 29584574;

Devuelve:

OWNERID	ACTIVEUSERID	EMAIL	FIRSTNAME	LASTNAME
29584574	4621126	233620335	Hobbes	Barón

Ejemplo 3

Recuperar todos los contactos y sus propietarios. Esta consulta une los registros a los propietarios con object_with_object_properties y la propiedad de contacto hubspot_owner_id.

SELECT
contact.objectId contact_id,
contact.properties:firstname::string contact_firstname,
contact.properties:lastname::string contact_lastname,
contact.properties:hubspot_owner_id::number contact_hubspot_owner_id,
owner.firstname owner_firstname,
owner.lastname owner_lastname,
owner.email owner_email
FROM object_with_object_properties contact
inner join owners owner on contact.properties:hubspot_owner_id::number = owner.ownerId
where objectTypeId = '0-1';

Devuelve:

CONTACTID	CONTACT_FIRSTNAME	CONTACT_LASTNAME	CONTACT_HUBSPOT_OWNER_ID	OWNER_FIRSTNAME	OWNER_LASTNAME	OWNER_EMAIL
113834202	Richard	Greenfield	29584574	Hobbes	Barón	hobbes.b@business.com
53540801	Ford	Karl	30241125	Milo	Gold	milo.g@business.com
...	...	...	...	...	...	...

Consultas sobre pipeline

A continuación, aprende a consultar los datos del pipeline de negocios y tickets, como los pipelines disponibles en tu cuenta y sus etapas.

Puedes unir estos datos con los datos de los objetos para obtener una visión completa de tus pipelines. Por ejemplo, puedes consultar los negocios y sus pipelines uniendo los datos de object_with_object_properties con los datos de pipelines.

pipelines

Esta vista contiene información sobre los pipelines de negocios y tickets de tu cuenta. Cada fila devuelta representa un solo pipeline.

Esta tabla puede devolver las siguientes columnas:

Nombre de la columna	Tipo	Descripción
`PIPELINEID`	Varchar	El ID del pipelines.
`OBJECTTYPEID`	Varchar	El ID del objeto que puede contener el pipeline (por ejemplo, negocios o tickets).
`LABEL`	Varchar	El nombre del pipeline en HubSpot.
`DISPLAYORDER`	Número	El orden en el que se muestra el pipeline en HubSpot.
`ARCHIVADO`	Booleano	Si se eliminó el pipeline
`CREATEDAT`	Timestamp	Cuando se creó el pipeline.
`Actualizado`	Timestamp	La fecha y hora en que los datos fueron actualizados por última vez en HubSpot. Más información sobre tipos de datos de columnas.
`INGESTEDAT`	Timestamp	La fecha y la hora en que los datos fueron ingeridos por última vez por Snowflake.

Ejemplo 1

Recuperar todos los pipelines de negocios disponibles, ordenados por su orden en HubSpot.

Consulta:

SELECT objectTypeId, pipelineId, label
FROM pipelines
WHERE objectTypeId = '0-3'AND not archived
ORDER BY displayorder;

Devuelve:

OBJECTTYPEID	PIPELINEID	LABEL
0-3	1bed503c-37f7-4f51-9d40-7598902673f4	Pipeline de ventas
0-3	12659678	Pipeline de licencias
0-3	75e28846-ad0d-4be2-a027-5e1da6590b98	Nueva empresa
...	...	...

Ejemplo 2

Recuperar los negocios dentro de un pipeline específico. Une object_with_object_properties y pipelines.

Consulta:

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';

Devuelve:

DEAL_ID	DEAL_NAME	PIPELINE_NAME
605140072	Registro global de Meowmix	Pipeline de ventas
605457408	Friskies Rebrand	Pipeline de ventas
604362473	Creación de la aplicación Fresh Step	Pipeline de ventas

pipeline_stages

Esta vista contiene información sobre las etapas individuales de un pipeline. Identifica las etapas combinando el ID del tipo de objeto, el ID de pipeline y el ID de la etapa. Al unirse con pipelines, utiliza el ID del tipo de objeto y el ID de pipeline.

Esta tabla puede devolver las siguientes columnas:

Nombre de la columna	Tipo	Descripción
`PIPELINEID`	Varchar	El ID del pipelines.
`OBJECTTYPEID`	Varchar	El ID del objeto que puede contener el pipeline (por ejemplo, negocios o tickets).
`LABEL`	Varchar	El nombre del pipeline en HubSpot.
`DISPLAYORDER`	Número	El orden en el que se muestra el pipeline en HubSpot.
`ARCHIVADO`	Booleano	Si se eliminó el pipeline
`Actualizado`	Timestamp	La fecha y hora en que los datos fueron actualizados por última vez en HubSpot. Más información sobre tipos de datos de columnas.
`INGESTEDAT`	Timestamp	La fecha y la hora en que los datos fueron ingeridos por última vez por Snowflake.

Ejemplo 1

Recuperar las etapas de un pipeline denominado Pipeline de ventas.

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;

Devuelve:

PIPELINEID	STAGEID	LABEL
941650	941651	Contactado
941650	941652	Cita programada
941650	941653	Factura enviada
...	...	...

Ejemplo 2

Recuperar todos los negocios y sus respectivas etapas 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';

Devuelve:

DEAL_ID	DEAL_NAME	PIPELINE_NAME	PIPELINE_STAGE_NAME
605140072	Registro global de Meowmix	Pipeline de ventas	Contrato enviado
605457408	Friskies Rebrand	Pipeline de ventas	Cita programada
604362473	Creación de la aplicación Fresh Step	Pipeline de ventas	Contrato firmado
...	...	...	...

Consultas de propiedades

property_definitions

Esta vista contiene información sobre propiedades de objetos y propiedades de eventos en tu cuenta de HubSpot. Las propiedades de los eventos incluyen eventos estándar, como aperturas y clics de correos electrónicos, y propiedades de eventos de comportamiento personalizados. Esta información puede ser útil para definir los valores que se encuentran en los datos de object_properties y events.

Puedes identificar propiedades específicas combinando tu ID de tipo de objeto y tu nombre. Puedes recuperar información similar utilizando la API de propiedades.

Esta vista puede devolver las siguientes columnas:

Nombre de la columna	Tipo	Descripción
`OBJECTYPEID`	Varchar	El ID del objeto al que se refiere el evento.
`NAME`	Varchar	El nombre interno de la propiedad
`LABEL`	Varchar	La etiqueta de la propiedad.
`DESCRIPTION`	Varchar	La descripción de la propiedad.
`TIPO`	Varchar	El tipo de la propiedad (por ejemplo, cadena, número, fecha).
`FIELDTYPE`	Varchar	El tipo de campo de la propiedad. Define cómo se muestra la propiedad en HubSpot y en los formularios (por ejemplo, casilla de comprobación, selección).
`DISPLAYORDER`	Número	El orden de presentación de la propiedad.
`NOMBRE DEL GRUPO`	Varchar	El nombre del grupo de la propiedad.
`OPCIONES`	Variant	Para las propiedades de enumeración, una matriz de las opciones de la propiedad, incluyendo los atributos de cada opción (por ejemplo, orden de presentación, etiqueta).
`CREATEDUSERID`	Número	El ID del usuario que creó la propiedad.
`REFERENCEDOBJECTTIPO`	Varchar	El tipo de objeto al que hace referencia la propiedad. Las propiedades del propietario devolverán un valor de PROPIETARIO.
`CALCULADO`	Booleano	Si la propiedad es una propiedad calculada.
`EXTERNALOPTIONS`	Booleano	Si las opciones de la propiedad están definidas en un sistema externo.
`HASUNIQUEVALUE`	Booleano	Si los valores de la propiedad son únicos. Sólo se puede establecer cuando se crea una propiedad a través de la API.
`OCULTO`	Booleano	Si la propiedad está oculta en HubSpot.
`SHOWCURRENCYSYMBOL`	Booleano	Si el valor de una propiedad numérica se formatea como moneda.
`FORMFIELD`	Booleano	Si esta propiedad se puede utilizar en los formularios.
`READONLYDEFINITION`	Booleano	Si la propiedad se puede editar en HubSpot.
`READONLYVALUE`	Booleano	Si el valor de la propiedad se puede editar en HubSpot.
`HUBSPOTDEFINED`	Booleano	Si la propiedad fue creada por HubSpot, frente a la creada por un usuario.
`ARCHIVADO`	Booleano	Si la propiedad ha sido eliminada.
`CREATEDAT`	Timestamp	La fecha y hora en que la propiedad fue creada en HubSpot.
`Actualizado`	Timestamp	La fecha y hora en que los datos fueron actualizados por última vez en HubSpot. Más información sobre tipos de datos de columnas.
`INGESTEDAT`	Timestamp	La fecha y la hora en que los datos fueron ingeridos por última vez por Snowflake.

Ejemplo 1

Recuperar los nombres y descripciones de todas las propiedades de contactos.

Consulta:

SELECT name, label, description
FROM property_definitions
WHERE objectTypeId = '0-1'

Devuelve:

NAME	LABEL	DESCRIPTION
entered_sql_stage	Entró en la etapa SQL	Iniciar recuento de días de la etapa SQL.
first_conversion_event_name	Primera conversión	El primer formulario que este contacto envió
dirección	Dirección	La dirección del contacto.

Consultas sobre eventos

Los eventos incluyen eventos estándar de HubSpot y eventos de comportamiento personalizados. Cada evento tiene su propia vista, etiquetada como events_eventname.

Los eventos disponibles incluyen:

Eventos de clic en el anuncio(events_ad_clicked)
Aperturas y clics en el correo electrónico(events_opened_email_V2, events_click_link_in_email_v2, etc.)
Analíticas web(events_visited_page)

Puedes identificar los eventos combinando su ID de tipo de evento y su ID. Las columnas que se devuelven dependen del evento, con una columna para cada propiedad del evento. Todos los eventos devolverán las siguientes columnas:

Nota: HubSpot ha añadido dos nuevas columnas a todas las tablas y vistas de eventos:

ha ocurrido en
ha ocurrido en el punto de fecha

Estas columnas reemplazarán las columnas occurredat y occurredatdateint el 24 de abril de 2022. En esa fecha, las columnas antiguas ya no estarán disponibles, y fallarán los intentos de consultar una tabla o vista que contenga eventos que usen esas columnas. Más información sobre cómo hacer cambios para compartir datos de Snowflake.

Nombre de la columna	Tipo	Descripción
`EVENTTYPEID`	Varchar	El ID del pipelines.
`ID`	Varchar	El ID del objeto que puede contener el pipeline (por ejemplo, negocios o tickets).
`OBJECTTYPEID`	Varchar	El tipo de objeto que completó el evento. Por ejemplo, un clic en un enlace de correo electrónico mostraría `0-1` en esta columna, representando el objeto de contactos.
`OBJECTID`	Número	El ID del registro que completó el evento.
`OCCURREDAT`	Timestamp	Cuando ocurrió el evento.
`OCCURREDATDAINT`	Número	Un número que representa cuándo ocurrió el evento. Contiene los mismos datos que la `columna` OCCURREDAT, pero formateados como un número y utilizados como parte de la clave de clúster de la tabla. En la mayoría de los casos, puedes usar la marca `de` tiempo OCCURREDAT en lugar de este número.
`OCCUREDATDAINT`	Número	Un número que representa cuándo ocurrió el evento. Contiene los mismos datos que la `columna` OCCURREDAT, pero formateados como un número y utilizados como parte de la clave de clúster de la tabla. En la mayoría de los casos, puedes usar la marca `de` tiempo OCCURREDAT en lugar de este número. Nota: esta columna será obsoleta el 24 de abril de 2022 y reemplazada por `OCCURREDATDATEINT`.
`OCCUREDAT`	Timestamp	Cuando ocurrió el evento. Nota: esta columna será obsoleta el 24 de abril de 2022 y reemplazada por `OCCURREDAT`.
`INGESTEDAT`	Timestamp	La fecha y la hora en que los datos fueron ingeridos por última vez por Snowflake. Más información sobre tipos de datos de columnas.
`PROPIEDAD_*`	Varchar	Columnas individuales que contienen las propiedades del evento.

Ejemplo 1

Recuperar los 50 eventos de clic más recientes del correo electrónico.

Consulta:

SELECT eventTypeId, objectTypeId, objectId, occuredAt, hs_click_raw_url
FROM events_clicked_link_in_email_V2 ORDER BY occuredAtLIMIT 50;

Devuelve:

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

Ejemplo 2

Recuperar todos los eventos de clic de correo electrónico por los contactos que hicieron clic. Esta consulta obtiene los datos de contacto uniéndolos con object_with_object_properties.

Consulta:

SELECT click.timestamp 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;

Devuelve:

CLICK_TIMESTAMP	CLICK_URL	CONTACT_FIRSTNAME	CONTACT_LASTNAME
2019-01-04 22:35:41.264	https://help.website.com/es/articles/tutorial/how-to-use-email-tool?utm_source=hs_automation&utm_medium=email&utm_content=68042217	Hobbes	Barón
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	Harlow	Villari
...	...	...	...

object_and_event_type_definitions

Esta vista contiene las definiciones de todos los objetos y eventos disponibles en tu cuenta de HubSpot.

Esta vista puede devolver las siguientes columnas:

Nombre de la columna	Tipo	Descripción
`OBJECTTYPEID`	Varchar	El ID del objeto que puede contener el pipeline (por ejemplo, negocios o tickets).
`FULLYQUALIFIEDNAME`	Varchar	El nombre del objeto o evento.
`INGESTEDAT`	Timestamp	La fecha y la hora en que los datos fueron ingeridos por última vez por Snowflake. Más información sobre tipos de datos de columnas.

Ejemplo 1

Recuperar todos los objetos y eventos disponibles en tu cuenta de HubSpot.

Consulta:

SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;

Devuelve:

OBJECTTYPEID	FULLYQUALIFIEDNAME
0-1	CONTACT
0-2	COMPANY
0-3	DEAL
0-4	ENGAGEMENT
0-5	TICKET
0-8	LINE_ITEM
0-11	CONVERSATION
...	...

Consulta de listas (BETA)

A continuación, aprende a consultar tus listas, como las listas de contactos y empresas disponibles y los registros incluidos en esas listas.

listas

Esta vista contiene información sobre las listas de contactos y empresas de HubSpot. Devuelve una fila por lista, y las columnas incluyen detalles de la lista como el nombre de la lista, el tamaño y el tipo de objeto de los registros que contiene. No contiene información sobre los registros individuales dentro de cada lista (consulta list_membership).

Esta vista puede devolver las siguientes columnas:

Nombre de la columna	Tipo	Descripción
`OBJECTTYPEID`	Varchar	El tipo de registros de la lista (por ejemplo, contacto o empresa).
`LISTID`	Número	El ID de la lista. Se une a la columna LISTID de la tabla de miembros de la lista.
`CLASSICLISTID`	Número	Un ID específico de las listas de contactos que coincide con el ID de la URL de la lista en HubSpot.
`LISTNAME`	Varchar	El nombre de la lista.
`LISTSIZE`	Número	El número de registros de la lista.
`CREATEDBYUSERID`	Número	El ID del usuario que creó la lista.
`CREATEDAT`	Timestamp	Cuando la lista fue creada en HubSpot.
`ActualizadoporuserID`	Número	El ID del usuario que ha actualizado la lista más recientemente.
`Actualizado`	Timestamp	La fecha y hora en que la fecha fue actualizada por última vez en HubSpot. Más información sobre tipos de datos de columnas.
`INGESTEDAT`	Timestamp	La fecha y la hora en que los datos fueron ingeridos por última vez por Snowflake.

Ejemplo 1

Recuperar todas las listas de contactos.

Consulta:

SELECT listId, listName, listSize
FROM lists
WHERE objectTypeId = '0-1';

Devuelve:

LISTID	LISTNAME	LISTSIZE
118131	Alcance semanal	103
66156	Suscriptores de blog	455
771852	Principales suscriptores 2021	37
...	...	...

Ejemplo 2

Recuperar una lista de contactos específica llamada Principales suscriptores 2021.

Consulta:

SELECT listId, listName, listSize
FROM lists
WHERE objectTypeId = '0-1' ANDlistName = 'Top subscribers 2021';

Devuelve:

LISTID	LISTNAME	LISTSIZE
771852	Principales suscriptores 2021	37

list_membership

Esta vista contiene información sobre qué registros son miembros de qué listas, con una fila por registro en la lista. Por ejemplo, si tienes una lista de suscriptores de un blog con 500 contactos, la tabla devolverá 500 filas.

Sólo contiene los ID de listas y los ID de objetos. Para más información, únete a la tabla de listas.

Esta vista puede devolver las siguientes columnas:

Nombre de la columna	Tipo	Descripción
`LISTID`	Varchar	El ID de la lista. Se une a la columna HS_LIST_ID de la tabla de listas.
`OBJECTID`	Varchar	El ID del registro en la lista.
`Actualizado`	Timestamp	La fecha y hora en que los datos fueron actualizados por última vez en HubSpot. Más información sobre tipos de datos de columnas.
`INGESTEDAT`	Timestamp	La fecha y la hora en que los datos fueron ingeridos por última vez por Snowflake.

Ejemplo 1

Recuperar los ID de todos los contactos de la lista Principales suscriptores 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';

Devuelve:

OBJECTID

54325098

96805401

6922028

...

Ejemplo 2

Recupera los nombres y apellidos de los detalles de los contactos en la lista de Principales suscriptores 2021.

Consulta:

SELECT
contact.objectId AS objectid,
contact.properties:firstname::string AS firstname,
contact.properties:lastname::string AS lastname
FROM object_with_object_properties contact
INNER JOIN list_memberships ON contact.objectId = list_memberships.objectId
INNER JOIN lists ON list_memberships.listId = lists.listId
WHERE
contact.objectTypeId = '0-1'
AND lists.objectTypeId = '0-1'
AND lists.listName = 'Top Subscribers 2021'

Devuelve:

OBJECTID	FIRST NAME	LAST NAME
54325098	Hobbes	Barón
96805401	Milo	Gold
6922028	Henry	Riley
...	...	...

Tipos de datos de columnas

Cuando se consultan datos en Snowflake, las columnas que se devuelven dependen de los datos que se están consultando. Puedes ver las columnas disponibles para una tabla o vista determinada en Snowflake seleccionando la vista en la barra lateral izquierda.

Para devolver una columna específica, incluye esa columna en el campo SELECT de tu consulta. Por ejemplo, la siguiente consulta devolverá sólo las columnas FROMOBJECTID y TOOBJECTID:

SELECTfromObjectTypeId, toObjectTypeId
FROM association_definitions

A continuación se presentan las definiciones generales de las columnas que puede devolver una consulta. Para otras definiciones no incluidas a continuación, consulta las definiciones de vistas individuales en el artículo anterior.

OBJECTTYPEID: un valor VARCHAR que representa un tipo de objeto. Por ejemplo, 0-1 representa el objeto contactos, 0-2 representa el objeto empresas, y 2-1232 podría representar un objeto personalizado en tu cuenta. En las listas, se refiere al tipo de lista (por ejemplo, contacto o empresa). Puedes consultar todos los ID de objetos y eventos de tu cuenta utilizando la vista object_and_event_type_definitions.
OBJECTID: un número BIGINT que representa un único registro de un determinado tipo de objeto en tu cuenta de HubSpot. Para identificar un registro, es necesario utilizar tanto el ID del tipo de objeto como el ID del objeto.
INGESTEDAT: la marca de tiempo de cuando se agregó una fila de datos a Snowflake, representada por un valor TIMESTAMP_NTZ. No está relacionado con la marca de tiempo lógica de una operación de creación o actualización en HubSpot.
- Debido al procesamiento interno de HubSpot, la marca de tiempo de ingesta de una fila puede actualizarse incluso si ninguna otra columna de la fila ha cambiado.
- Cuando se construyen procesos ETL que copian datos modificados recientemente, se recomienda basar las consultas en la marca de tiempo de ingesta. Además, si tu flujo copia los datos diariamente, se recomienda copiar los datos de los dos días anteriores para tener en cuenta los retrasos.
CREATEDAT y UPDATEDAT: la marca de tiempo lógica de cuando los datos fueron creados o actualizados en HubSpot, representada por un valor TIMESTAMP_NTZ . Estas marcas de tiempo coincidirán con las marcas de tiempo en HubSpot. Por ejemplo, la hora mostrada en HubSpot para la fecha de creación de un registro será la misma que la marca de tiempo en la columna CREATEDAT en Snowflake. Estas no están directamente relacionadas con la marca de tiempo de ingesta, y no se recomienda basar los procesos ETL en estas propiedades.
COMBINEDASSOCIATIONTYPE: un valor VARCHAR que identifica de forma exclusiva una definición de asociación.

Was this article helpful? Yes No

This form is used for documentation feedback only. Learn how to get help with HubSpot.

Consultar datos de HubSpot en Snowflake

Requisitos

Configura tu entorno Snowflake

Resumen de datos

Limitación y ordenación de los datos devueltos

Consultas de objetos

object_with_object_properties

Ejemplo 1

Ejemplo 2

objetos

Ejemplo 1

object_properties

Ejemplo 1

Ejemplo 2

object_properties_history

Ejemplo 1

Ejemplo 2

Consultas sobre asociación

association_definitions

Ejemplo 1

Ejemplo 2

asociaciones

Ejemplo 1

Ejemplo 2

Ejemplo 3

Consultas del propietario

propietarios

Ejemplo 1

Ejemplo 2

Ejemplo 3

Consultas sobre pipeline

pipelines

Ejemplo 1

Ejemplo 2

pipeline_stages

Ejemplo 1

Ejemplo 2

Consultas de propiedades

property_definitions

Ejemplo 1

Consultas sobre eventos

Ejemplo 1

Ejemplo 2

object_and_event_type_definitions

Ejemplo 1

Consulta de listas (BETA)

listas

Ejemplo 1

Ejemplo 2

list_membership

Ejemplo 1

Ejemplo 2

Tipos de datos de columnas

Contenido relacionado

Crear informes con el generador de informes personalizados

Entender las fuentes de tráfico de HubSpot en la herramienta de analíticas de tráfico

Crear informes personalizados