Ir a contenido principal
Nota: Este contenido se tradujo a través de un software y es posible que no haya sido revisado. La versión en inglés se considera, por tanto, la versión oficial y es posible que haya sido actualizada. Para acceder a la versión en inglés, haz clic aquí.
Reports

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

    snowflake-worksheet-settings0
  • 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.

      snowflake-worksheet-settings-window0

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 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'
AND
listName = '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.

snowflake-sidebar-view-column-details0


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:


SELECT
fromObjectTypeId, 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?
This form is used for documentation feedback only. Learn how to get help with HubSpot.