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

Consulta de datos de HubSpot en Snowflake

Última actualización: noviembre 16, 2021

Requisitos

Operations Hub Enterprise

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

    hoja de trabajo-copo-de-nieve-configuración0
  • 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.

      ventana de configuración de la hoja de trabajo del copo de nieve0

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 occuredAt

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

snowflake-sidebar-view-column-details0


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:


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