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

Consulta de datos de HubSpot en Snowflake

Última actualización: noviembre 16, 2021

Requisitos

Después de conectar Snowflake a tu cuenta de HubSpot, puedes utilizar el Data Share 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 acuerdos 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

Configure su entorno Snowflake

Para consultar sus datos de HubSpot en Snowflake, tendrá que seleccionar el almacén, la base de datos y el esquema que desea consultar. Puede establecerlos a nivel de hoja de trabajo para incluirlos automáticamente en sus consultas, o puede añadirlos 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:
- Haga clic en el menú desplegable Almacén y seleccione su almacén.
- Haz clic en el menú desplegable Base de datos y selecciona tu base de datos de HubSpot.
- Haga clic en el menú desplegable Schema y seleccione el esquema que desea utilizar:
  - V2_LIVE: el esquema en vivo basado en Secure Views de los datos de HubSpot. Los datos de este esquema se actualizan hasta cada 15 minutos. Si estás consultando un gran conjunto de datos, las consultas pueden ser lentas. En este caso, se recomienda copiar los datos en su propia tabla primero con un proceso ETL, y luego consultar esa tabla.
  - 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 añadir tu base de datos o tipo de esquema a las consultas manualmente.

Para añadir manualmente la base de datos y el tipo de esquema a las consultas, añada 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 usando SQL, y se pueden usar 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 acuerdos 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, puede controlar la cantidad de datos que se devuelven, junto con el orden en que se devuelven, incluyendo LIMIT y ORDER BY en su 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ía construir su consulta de la siguiente manera:

SELECT objectTypeId, objectId, properties
FROM objeto_con_propiedades_del_objeto
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.

Puede utilizar los siguientes identificadores de objetos al realizar la consulta:

Nombre del objeto	ObjectTypeId
Contactos	0-1
Empresas	0-2
Negocios	0-3
Interacción	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.

objeto_con_propiedades_del_objeto

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 Variante del copo de nieve / JSON columna.

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).
PROPIEDADES	Variante	Los valores de la propiedad del registro.
UPDATEDAT	Marca de hora	La fecha y hora en que el registro fue actualizado por última vez en HubSpot. Más información sobre los tipos de datos de las columnas.
INGESTEDAT	Marca de hora	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 objeto_con_propiedades_del_objeto
WHERE objectTypeId = '0-1'

Devuelve:

OBJECTTYPEID	OBJECTID	PROPIEDADES
0-1	38960439	{"createdate": "1504656970152"...}
0-1	321740651	{ "fecha de creación": "1590183081949"...}
0-1	98392101	{ "fecha de creación": "1533566477279"...}
...	...	...

Ejemplo 2

Recupera el nombre y la fase de la operación de hasta tres operaciones.

Consulta:

SELECT
objectId,
properties:dealname::string AS dealname,
properties:dealstage::string AS dealstage,
properties:amount::number AS dealamount
FROM objeto_con_propiedades_del_objeto
WHERE objectTypeId = '0-3'
LIMIT 3;

Devuelve:

OBJECTID	DEALNAME	DEALSTAGE	DEALAMOUNT
38960439	Nombre de la operación 1	2021-10-12 13:49:35.219	2021-10-12 13:49:35.219
321740651	Nombre de la operación 1	2021-10-12 13:49:35.219	2021-10-12 13:49:35.219
98392101	Nombre de la operación 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 los registros existentes. Cuando se elimina un registro en HubSpot, se eliminará de esta vista.

Esta vista puede ser útil si su 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	Marca de hora	La fecha y la hora en que los datos fueron ingeridos por última vez por Snowflake. Más información sobre los tipos de datos de las columnas.

Ejemplo 1

Recuperar todos los registros de contactos.

Consulta:

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

Devuelve:

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

propiedades_del_objeto

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 su 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).
NOMBRE	Varchar	El nombre de la propiedad.
VALOR	Marca de hora	El valor de la propiedad.
UPDATEDAT	Marca de hora	La fecha y hora en que el registro fue actualizado por última vez en HubSpot. Más información sobre los tipos de datos de las columnas.
INGESTEDAT	Marca de hora	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 propiedades_del_objeto
WHERE objectTypeId = '0-1'
AND name IN ('firstname', 'lastname', 'city')
ORDER BY objectId;

Devuelve:

OBJECTTYPEID	OBJECTID	NOMBRE	VALOR
0-1	10401	firstname	Brian
0-1	10401	ciudad	Dublín
0-1	10401	apellido	Gallagher
0-1	23451	firstname	Fernando
0-1	23451	apellido	Fierro
0-1	25751	firstname	Charles
...	...	...	...

Ejemplo 2

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

Consulta:

SELECT objectId, firstname, lastname, lifecyclestage
DE
(
SELECT objectId, name, value
FROM propiedades_del_objeto
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	NOMBRE	APELLIDOS	CICLO DE VIDA
0-1	54325098	Hobbes	Barón	lead
0-1	96805401	Milo	Solutions Partner nivel Gold	lead
0-1	6922028	Marcos	Riley	lead
...	...	...	...	...

historia de las propiedades del objeto

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).
NOMBRE	Varchar	El nombre de la propiedad.
VALOR	Marca de hora	El valor de la propiedad.
UPDATEDAT	Marca de hora	La fecha y hora en que los datos fueron actualizados por última vez en HubSpot. Más información sobre los tipos de datos de las columnas.
INGESTEDAT	Marca de hora	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	NOMBRE	APELLIDOS	CICLO DE VIDA
0-1	54325098	Hobbes	Barón	lead
0-1	96805401	Milo	Solutions Partner nivel Gold	lead
0-1	6922028	Marcos	Riley	lead
...	...	...	...	...

Ejemplo 2

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

Consulta:

SELECCIONE
objectId,
properties:firstname::string AS firstname,
properties:lastname::string AS lastname
FROM objeto_con_propiedades_del_objeto
WHERE objeto_con_propiedades_del_objeto.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	NOMBRE	APELLIDOS
54325098	Hobbes	Barón
96805401	Milo	Solutions Partner nivel Gold
6922028	Marcos	Riley
...	...	...

Consultas sobre la asociación

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

definiciones_de_asociación

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. Puede 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
COMBINEDASSOCIATIONTYPEID	Varchar	El identificador único de la definición de la asociación.
CATEGORÍA	Varchar	La fuente del tipo de asociación. Uno de los siguientes: `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.
NOMBRE	Varchar	El nombre de la definición de la asociación.
ETIQUETA	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	Marca de hora	La fecha y la hora en que los datos fueron ingeridos por última vez por Snowflake. Más información sobre los tipos de datos de las columnas.

Ejemplo 1

Recupere los tipos de asociaciones disponibles en su cuenta.

Consulta:

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

Devuelve:

TIPO DE ASOCIACIÓN COMBINADA	FROMOBJECTTYPEID	TOOBJECTTYPEID	NOMBRE
0-1	0-1	0-2	CONTACTO_A_EMPRESA
0-2	0-2	0-1	EMPRESA_A_CONTACTO
0-3	0-3	0-1	DEAL_TO_CONTACT
0-4	0-1	0-3	CONTACTO_A_OFERTA
0-5	0-3	0-2	DEAL_TO_COMPANY
...	...	...	...

Ejemplo 2

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

Consulta:

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

Devuelve:

TIPO DE ASOCIACIÓN COMBINADA	FROMOBJECTTYPEID	TOOBJECTTYPEID	NOMBRE
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. Puede 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
COMBINEDASSOCIATIONTYPEID	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	Marca de hora	La fecha y la hora en que los datos fueron ingeridos por última vez por Snowflake. Más información sobre los tipos de datos de las columnas.

Ejemplo 1

Recuperar todas las ofertas y contactos asociados.

Consulta:

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

Devuelve

TIPO DE ASOCIACIÓN COMBINADA	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 asociaciones
WHERE associationCategory = 'HUBSPOT_DEFINED'
AND combinedAssociationTypeId = '0-15'
AND fromObjectId = 3005;

Devuelve:

TIPO DE ASOCIACIÓN COMBINADA	FROMOBJECTID	TOOBJECTID
0-5	6626541373	233620335

Ejemplo 3

Recuperar todas las ofertas asociadas a un contacto específico (ID de contacto: 4464). En lugar de codificar el combinedAssociationTypeId, este ejemplo se une con association_definitions.

Consulta:

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

Devuelve:

TIPO DE ASOCIACIÓN COMBINADA	FROMOBJECTID	TOOBJECTID
0-5	6626541373	233620335

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.
USERID	Número	La identificación del usuario. Los usuarios con NULL en esta columna han sido eliminados.
CORREO ELECTRÓNICO	Varchar	La dirección de correo electrónico del usuario.
NOMBRE	Varchar	El nombre del usuario.
APELLIDOS	Varchar	Apellido del usuario.
ISACTIVE	Booleano	Si el usuario ha sido eliminado.
CREATEDAT	Marca de hora	La fecha y hora en que el usuario fue creado en HubSpot. Consulte los tipos de datos de las columnas para obtener más información.
UPDATEDAT	Marca de hora	La fecha y hora en que el usuario fue actualizado por última vez en HubSpot. Consulte los tipos de datos de las 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	CORREO ELECTRÓNICO	NOMBRE	APELLIDOS
29584574	4621126	233620335	Hobbes	Barón
30532717	4874784	3866015468	Pablo	Walters
30580321	925511	7132752747	Milo	Solutions Partner nivel Gold
...	...	...	...	...

Ejemplo 2

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

Consulta:

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

Devoluciones

OWNERID	ACTIVEUSERID	CORREO ELECTRÓNICO	NOMBRE	APELLIDOS
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.

SELECCIONE
contact.objectId contact_id,
contact.properties:firstname::string contact_firstname,
contact.properties:lastname::string contact_lastname,
contact.properties:hubspot_owner_id::número contact_hubspot_owner_id,
owner.firstname owner_firstname,
owner.lastname owner_lastname,
owner.email owner_email
FROM objeto_con_propiedades_del_objeto contacto
inner join owner on contact.properties:hubspot_owner_id::number = owner.ownerId
donde objectTypeId = '0-1';

Devoluciones

CONTACTID	NOMBRE_DE_CONTACTO	NOMBRE_DE_CONTACTO	CONTACT_HUBSPOT_OWNER_ID	NOMBRE_DEL_PROPIETARIO	OWNER_LASTNAME	CORREO ELECTRÓNICO DEL PROPIETARIO
113834202	Richard	Greenfield	29584574	Hobbes	Barón	hobbes.b@business.com
53540801	Ford	Karl	30241125	Milo	Solutions Partner nivel Gold	milo.g@business.com
...	...	...	...	...	...	...

Consultas sobre las tuberías

A continuación, aprenda a consultar los datos del pipeline de tratos y tickets, como los pipelines disponibles en su cuenta y sus etapas.

Puede unir estos datos con los datos de los objetos para obtener una visión completa de sus conductos. Por ejemplo, puede consultar las operaciones y sus canalizaciones uniendo los datos de object_with_object_properties con los datos de las canalizaciones.

los pipelines

Esta vista contiene información sobre los pipelines de tratos y tickets de su cuenta. Cada fila devuelta representa una sola tubería.

Esta tabla puede devolver las siguientes columnas:

Nombre de la columna	Tipo	Descripción
PIPELINEID	Varchar	La identificación del oleoducto.
OBJECTTYPEID	Varchar	El ID del objeto que puede contener la canalización (por ejemplo, ofertas o tickets).
ETIQUETA	Varchar	El nombre del pipeline en HubSpot.
DISPLAYORDER	Número	El orden en el que se muestra el pipeline en HubSpot.
ARCHIVADO	Booleano	Si la tubería ha sido eliminada.
CREATEDAT	Marca de hora	Cuando se creó la tubería.
UPDATEDAT	Marca de hora	La fecha y hora en que los datos fueron actualizados por última vez en HubSpot. Más información sobre los tipos de datos de las columnas.
INGESTEDAT	Marca de hora	La fecha y la hora en que los datos fueron ingeridos por última vez por Snowflake.

Ejemplo 1

Recupere todos los pipelines de acuerdos disponibles, ordenados por su orden en HubSpot.

Consulta:

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

Devuelve

OBJECTTYPEID	PIPELINEID	ETIQUETA
0-3	1bed503c-37f7-4f51-9d40-7598902673f4	Pipeline de ventas
0-3	12659678	Licencias de la tubería
0-3	75e28846-ad0d-4be2-a027-5e1da6590b98	Nueva empresa
...	...	...

Ejemplo 2

Recupera las operaciones dentro de una línea de producción específica. Une objeto_con_propiedades_del_objeto y tuberías.

Consulta:

SELECT
deals.objectId deal_id,
deals.properties:dealname::varchar deal_name,
pipelines.label pipeline_name
FROM objeto_con_propiedades_del_objeto 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';

Devoluciones

DEAL_ID	NOMBRE_DE_LA_OFICINA	NOMBRE_DE_LA_TUBERÍA
605140072	Registro global de Meowmix	Pipeline de ventas
605457408	Friskies Rebrand	Pipeline de ventas
604362473	Fresh Step App Build	Pipeline de ventas

etapas de la tubería

Esta vista contiene información sobre las etapas individuales de una canalización. Identifica las etapas combinando el ID del tipo de objeto, el ID de la tubería y el ID de la etapa. Al unirse con las tuberías, utilice el ID del tipo de objeto y el ID de la tubería.

Esta tabla puede devolver las siguientes columnas:

Nombre de la columna	Tipo	Descripción
PIPELINEID	Varchar	La identificación del oleoducto.
OBJECTTYPEID	Varchar	El ID del objeto que puede contener la canalización (por ejemplo, ofertas o tickets).
ETIQUETA	Varchar	El nombre del pipeline en HubSpot.
DISPLAYORDER	Número	El orden en el que se muestra el pipeline en HubSpot.
ARCHIVADO	Booleano	Si la tubería ha sido eliminada.
UPDATEDAT	Marca de hora	La fecha y hora en que los datos fueron actualizados por última vez en HubSpot. Más información sobre los tipos de datos de las columnas.
INGESTEDAT	Marca de hora	La fecha y la hora en que los datos fueron ingeridos por última vez por Snowflake.

Ejemplo 1

Recuperar las etapas de un pipeline de ventas.

Consulta:

SELECT pipelineid, stageId, label
FROM pipeline_stages
WHERE no archivado
AND pipelineid = (
SELECT pipelineid
FROM pipelines
WHERE objectTypeId = '0-3'
AND no archivado
AND label = 'Sales Pipeline' LIMIT 1)
ORDER BY displayorder;

Devuelve

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

Ejemplo 2

Recuperar todas las operaciones y sus respectivas fases de tramitación.

Consulta:

SELECT
deals.objectId deal_id,
deals.properties:dealname::varchar deal_name,
pipelines.label nombre_de_pipeline,
pipeline_stages.label pipeline_stage_name
FROM objeto_con_propiedades_del_objeto 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';

Devoluciones

DEAL_ID	NOMBRE_DE_LA_OFICINA	NOMBRE_DE_LA_TUBERÍA	NOMBRE_DE_LA_ETAPA_DE_LA_TUBERÍA
605140072	Registro global de Meowmix	Pipeline de ventas	Contrato enviado
605457408	Friskies Rebrand	Pipeline de ventas	Cita programada
604362473	Fresh Step App Build	Pipeline de ventas	Se firma el contrato.
...	...	...	...

definiciones_de_propiedad

Esta vista contiene información sobre las propiedades de los objetos y las propiedades de los eventos en su 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 eventos.

Puede identificar propiedades específicas combinando su ID de tipo de objeto y su nombre. Puede 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.
NOMBRE	Varchar	El nombre interno de la propiedad.
ETIQUETA	Varchar	La etiqueta de la propiedad.
DESCRIPCIÓN	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 verificación, selección).
DISPLAYORDER	Número	El orden de visualización de la propiedad.
GROUPNAME	Varchar	El nombre del grupo de la propiedad.
OPCIONES	Variante	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 visualización, etiqueta).
CREATEDUSERID	Número	El ID del usuario que creó la propiedad.
TIPO DE OBJETO REFERENCIADO	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.
OPCIONES EXTERNAS	Booleano	Si las opciones de la propiedad están definidas en un sistema externo.
TIENE UN VALOR ÚNICO	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.
ESCONDIDO	Booleano	Si la propiedad está oculta en HubSpot.
SÍMBOLO DE LA EXPOSICIÓN	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.
HUBSPOTDEFINIDO	Booleano	Si la propiedad fue creada por HubSpot, frente a la creada por un usuario.
ARCHIVADO	Booleano	Si la propiedad ha sido eliminada.
CREATEDAT	Marca de hora	La fecha y hora en que la propiedad fue creada en HubSpot.
UPDATEDAT	Marca de hora	La fecha y hora en que los datos fueron actualizados por última vez en HubSpot. Más información sobre los tipos de datos de las columnas.
INGESTEDAT	Marca de hora	La fecha y la hora en que los datos fueron ingeridos por última vez por Snowflake.

Ejemplo 1

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

Consulta:

SELECT nombre, etiqueta, descripción
FROM definiciones_de_propiedad
WHERE objectTypeId = '0-1'

Devuelve:

NOMBRE	ETIQUETA	DESCRIPCIÓN
entered_sql_stage	Entró en la etapa SQL	Inicio del recuento de días de la etapa SQL.
first_conversion_event_name	Primera conversión	El primer formulario que presentó este contacto.
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.)
Análisis de la web(events_visited_page)

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

Nombre de la columna	Tipo	Descripción
EVENTTYPEID	Varchar	La identificación del oleoducto.
ID	Varchar	El ID del objeto que puede contener la canalización (por ejemplo, ofertas 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.
OCURRIDO EN LA FECHA DE	Número	Un número que representa cuándo ocurrió el evento. Contiene los mismos datos que la columna OCCUREDAT, pero formateados como un número y utilizados como parte de la clave de grupo de la tabla. En la mayoría de los casos, puede utilizar la marca de tiempo OCCUREDAT en lugar de este número.
OCCUREDAT	Marca de hora	Cuando ocurrió el evento.
INGESTEDAT	Marca de hora	La fecha y la hora en que los datos fueron ingeridos por última vez por Snowflake. Más información sobre los tipos de datos de las columnas.
PROPIEDAD_*	Varchar	Columnas individuales que contienen las propiedades del evento.

Ejemplo 1

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

Devoluciones

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_PAqSfQiWarY69X7Ds42zHGYTCfhJLrXUP86Nxu
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 los contactos mediante la unión 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;

Devoluciones

CLICK_TIMESTAMP	CLICK_URL	NOMBRE_DE_CONTACTO	NOMBRE_DE_CONTACTO
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	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	Solutions Partner nivel 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
...	...	...	...

definiciones de tipo de objeto y evento

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 la canalización (por ejemplo, ofertas o tickets).
NOMBRE COMPLETO	Varchar	El nombre del objeto o evento.
INGESTEDAT	Marca de hora	La fecha y la hora en que los datos fueron ingeridos por última vez por Snowflake. Más información sobre los tipos de datos de las columnas.

Ejemplo 1

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

Consulta:

SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;

Devuelve

OBJECTTYPEID	NOMBRE COMPLETO
0-1	CONTACTO
0-2	EMPRESA
0-3	NEGOCIO
0-4	INTERACCIONES
0-5	TICKET
0-8	LINE_ITEM
0-11	CONVERSACIÓN
...	...

Listas de consultas (BETA)

A continuación, aprenda a consultar sus 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 (véase 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.
CREADOPORELUSUARIO	Número	El ID del usuario que creó la lista.
CREATEDAT	Marca de hora	Cuando la lista fue creada en HubSpot.
UPDATEDBYUSERID	Número	El ID del usuario que ha actualizado la lista más recientemente.
UPDATEDAT	Marca de hora	La fecha y hora en que la fecha fue actualizada por última vez en HubSpot. Más información sobre los tipos de datos de las columnas.
INGESTEDAT	Marca de hora	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 listas
WHERE objectTypeId = '0-1';

Devuelve

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

Ejemplo 2

Recuperar una lista de contactos específica llamada Top subscribers 2021.

Consulta:

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

Devoluciones

LISTID	LISTNAME	LISTSIZE
771852	Principales abonados 2021	37

lista_de_miembros

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

Sólo contiene IDs de listas e IDs de objetos. Para más información, únase 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.
UPDATEDAT	Marca de hora	La fecha y hora en que los datos fueron actualizados por última vez en HubSpot. Más información sobre los tipos de datos de las columnas.
INGESTEDAT	Marca de hora	La fecha y la hora en que los datos fueron ingeridos por última vez por Snowflake.

Ejemplo 1

Recuperar los identificadores de todos los contactos de la lista de los principales abonados 2021.

Consulta:

SELECT objectId
FROM list_memberships
INNER JOIN listas
ON list_memberships.listId = lists.listId
WHERE lists.objectTypeId = '0-1'
AND lists.name = 'Top Subscribers 2021';

Devuelve

OBJECTID

54325098

96805401

6922028

...

Ejemplo 2

Recuperar los nombres y apellidos de los detalles de los contactos de los abonados principales 2021

Consulta:

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

Devoluciones

OBJECTID	NOMBRE	APELLIDO
54325098	Hobbes	Barón
96805401	Milo	Solutions Partner nivel Gold
6922028	Marcos	Riley
...	...	...

Tipos de datos de columna

Cuando se consultan datos en Snowflake, las columnas que se devuelven dependen de los datos que se están consultando. Puede 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, incluya esa columna en el campo SELECT de su 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, consulte las definiciones de vistas individuales en el artículo anterior.

OBJECTTYPEID: un valor VARCHAR que representa el 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 su cuenta. En las listas, se refiere al tipo de lista (por ejemplo, contacto o empresa). Puede consultar todos los ID de objetos y eventos de su 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 añadió 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 ingestión. Además, si su 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 ingestión, 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.

Consulta de datos de HubSpot en Snowflake

Requisitos

Configure su entorno Snowflake

Resumen de datos

Limitación y ordenación de los datos devueltos

Consultas de objetos

objeto_con_propiedades_del_objeto

Ejemplo 1

Ejemplo 2

objetos

Ejemplo 1

propiedades_del_objeto

Ejemplo 1

Ejemplo 2

historia de las propiedades del objeto

Ejemplo 1

Ejemplo 2

Consultas sobre la asociación

definiciones_de_asociación

Ejemplo 1

Ejemplo 2

asociaciones

Ejemplo 1

Ejemplo 2

Ejemplo 3

propietarios

Ejemplo 1

Ejemplo 2

Ejemplo 3

Consultas sobre las tuberías

los pipelines

Ejemplo 1

Ejemplo 2

etapas de la tubería

Ejemplo 1

Ejemplo 2

definiciones_de_propiedad

Ejemplo 1

Consultas sobre eventos

Ejemplo 1

Ejemplo 2

definiciones de tipo de objeto y evento

Ejemplo 1

Listas de consultas (BETA)

listas

Ejemplo 1

Ejemplo 2

lista_de_miembros

Ejemplo 1

Ejemplo 2

Tipos de datos de columna

Contenido relacionado

Crear informes personalizados

Crear informes con el generador de informes personalizados

Crear URL de seguimiento