Consultar datos de HubSpot en Snowflake
Última actualización: julio 25, 2022
Requisitos
Operations Hub Enterprise |
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:
- V2_LIVE: el esquema en vivo basado en Vistas protegidas 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 tu propia tabla primero con un proceso ETL, y luego consultar esa tabla.
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:
SELECTobjectId,
properties:dealname::string AS dealname,
properties:dealstage::string AS dealstage,
properties:amount::number AS dealamount
FROM object_with_object_properties
WHERE objectTypeId = '0-3'
LIMIT 3;
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
WHERE
object_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:
SELECT
combinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
WHERE fromObjectTypeId = '0-3' AND toObjectTypeId = '0-2'
AND isMainAssociationDefinition = trueORDER 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 | 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 | 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:
SELECTdeals.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:
SELECTdeals.objectId deal_id,
deals.properties:dealname::varchar deal_name,
pipelines.label pipeline_name,
pipeline_stages.label pipeline_stage_name
FROM object_with_object_properties deals
INNER JOIN pipelines
ON deals.objectTypeId = pipelines.objectTypeId
AND deals.properties:pipeline::string = pipelines.pipelineid
INNER JOIN pipeline_stages
ON deals.objectTypeId = pipeline_stages.pipelineid
AND deals.properties:pipeline::string = pipeline_stages.pipelineid
AND deals.properties:dealstage::string = pipeline_stages.stageId
WHERE deals.objecttypeId = '0-3';
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. |
|
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. |
|
Número |
Un número que representa cuándo ocurrió el evento. Contiene los mismos datos que la Nota: esta columna será obsoleta el 24 de abril de 2022 y reemplazada por |
OCCUREDAT |
Timestamp |
Cuando ocurrió el evento. Nota: esta columna será obsoleta el 24 de abril de 2022 y reemplazada por |
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 occuredAt
LIMIT 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.
Thank you for your feedback, it means a lot to us.
Contenido relacionado
-
Crear informes con el generador de informes personalizados
Con el generador de informes personalizados de HubSpot, puedes analizar varias fuentes de datos en HubSpot....
Base de conocimientos -
Entender las fuentes de tráfico de HubSpot en la herramienta de analíticas de tráfico
Cuando usas la pestaña Fuentes en la herramienta de analíticas de tráfico, HubSpot clasifica métricas de...
Base de conocimientos -
Crear informes personalizados
Con informes personalizados, tienes más flexibilidad en el análisis de objetos y actividades en tu cuenta de...
Base de conocimientos