Consultar datos de HubSpot en Snowflake

Después de conectar Snowflake a tu cuenta de HubSpot, puedes utilizar Data Share de Snowflake para consultar los datos de HubSpot desde tu cuenta de Snowflake.

Retraso de datos y región de su cuenta Snowflake

Tendrá acceso al esquema V2_LIVE, que se actualiza cada 15 minutos, y al esquema V2_DAILY, que se actualiza todos los días.

Por favor, ten en cuenta: que las siguientes vistas del esquema V2_LIVE sólo se actualizan diariamente: association_definitions, owners, pipelines y pipeline_stages.

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_DAILY: 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.
    • 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 tu propia tabla primero con un proceso ETL, y luego consultar esa tabla.
    
    
    

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 añadir manualmente tu base de datos y tipo de esquema a las consultas, añade el nombre de la base de datos seguido del esquema al principio del campo FROM campo Por ejemplo:

Resumen de datos

Las consultas se construyen utilizando SQL, y se pueden utilizar para recuperar datos de HubSpot tales 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 asociados actualmente.
• Eventos: datos de eventos tanto para eventos estándar de HubSpot, como aperturas de correos electrónicos, como para eventos de comportamiento personalizados.
• Listas: Listas de contactos y empresasde HubSpot.
• 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 CRM, incluido el historial de propiedades.

Más información sobre el Modelo de datos del CRM de HubSpot. 

Tenga en cuenta: A medida que vayamos evolucionando el intercambio de datos, iremos introduciendo cambios, algunos de ellos de última hora. Es muy recomendable suscribirse al registro de cambios para desarrolladores de HubSpot. Estos cambios se publicarán siempre en el registro de cambios antes de cualquier actualización.

Limitación y ordenación de los datos devueltos

Al elaborar consultas, puedes controlar cuántos datos 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:

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.

Tenga en cuenta quepara el resto de este documento, utilizamos el término objeto de base de datos cuando el contexto se aplica tanto a las tablas como a las vistas.

Para devolver una columna concreta, incluye esa columna en el campo SELECT de tu consulta. Por ejemplo, la siguiente consulta sólo devolverá los OBJECTID y UpdatedAt columnas:


SELECTobjectId, updatedAt
FROM objects_contacts



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 el tipo de un 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 cuándo 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 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 cuándo se crearon o actualizaron los datos 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: valor VARCHAR que identifica unívocamente una definición de asociación.

Transformación de tipos de datos

A veces, se devuelven datos de una consulta con columnas VARCHAR cuando sería deseable que fueran de otro tipo. En casos como éste, se recomienda convertir el tipo de datos VARCHAR a los tipos deseados utilizando las funciones de Snowflake. Por ejemplo, las propiedades de un registro de objeto se almacenan como tipos de datos VARCHAR en la mayoría de los objetos de la base de datos, pero a veces contienen valores numéricos y de fecha. Se pueden utilizar funciones como:
try_to_number, try_to_timestamp_ntz para convertir estos datos VARCHAR a sus tipos NUMBER y DATETIME respectivamente:


SELECT objectid, value AS amount_str, try_to_number(value) AS amount
FROM object_properties
WHERE objecttypeid='0-3' AND name='amount'
LIMIT 1



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. 

Los datos de los objetos de diferentes tipos están organizados y disponibles de dos maneras: 

• Individual: Cada tipo de objeto se almacena en su propia vista y contiene sólo registros del mismo tipo de objeto, por ejemplo, objects_contacts contiene sólo registros de contactos. Esto elimina la necesidad de especificar un objecttypeid durante la consulta. Estas vistas son más fáciles de consultar ya que no es necesario conocer los ObjectTypeIds. También devuelven los datos en un formato más utilizable, en el que cada fila corresponde a un objeto y a la versión actual de sus propiedades. Mientras no experimente consultas lentas, es aconsejable utilizar estas vistas para recuperar los datos de los objetos. Vea más en las vistas de Objects_X más abajo. 
• Combinado: Todos los registros de todos los tipos de objetos se combinan en un objeto de la base de datos. Por lo tanto, al realizar la consulta, es necesario especificar un filtro como "WHERE objectTypeId='0-1'. Por ejemplo, puede utilizar los siguientes objecttypeids al consultar:

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.

Estos objetos de la base de datos suelen ser adecuados si se desea un mejor rendimiento de las consultas que el que se puede obtener con las vistas objects_x. Ver más detalles en object_with_object_properties, object_properties, objects y object_properties_history más abajo.

objetos_x vistas

En este objeto de la base de datos, cada tipo de objeto disponible, incluidos los objetos personalizados, tiene su propia vista específica, y cada vista contiene sólo los registros de los objetos de ese tipo de objeto específico. Estas vistas se nombran siguiendo el formato OBJECTS_<object type name> donde <object type name> es la etiqueta de la forma plural deltipo de objeto.(Tenga en cuenta que si el tipo de objeto no tiene forma plural, entonces <object type name> será simplemente la etiqueta de la forma singular del nombre del tipo de objeto concatenada con "S").

Las consultas a esta vista devuelven una fila para cada registro dentro de un objeto con cada propiedad del objeto disponible como una columna separada.

A continuación encontrará la lista completa de los tipos de objetos disponibles en HubSpot (es decir, no personalizados), una breve descripción de los datos que representan y sus correspondientes vistas:

Cada objeto de la base de datos devolverá las siguientes columnas:

Ejemplo 1

Recuperar el nombre, el apellido y la etapa del ciclo de vida de todos los contactos.

Consulta:


SELECT objectId, property_firstname AS firstname, property_lastname AS lastname,property_lifecyclestage AS lifecyclestage
FROM objects_contact



Devuelve:

Ejemplo 2

Recuperar el nombre de la operación y la etapa de hasta tres operaciones.

Consulta:


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals

LIMIT 3

Devuelve:

Ejemplo 3

Obtenga el nombre de la operación y la fase de las tres primeras operaciones por importe.

Consulta:

Dado que los datos de la cantidad del acuerdo están disponibles como un tipo de datos numérico, pueden ser utilizados para ordenar sin necesidad de hacer una conversión o casting.


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals
ORDER BY property_amount DESC
LIMIT 3




Devuelve:

object_with_object_properties

Este objeto de la base de datos contiene datos de sus registros de HubSpot. Las consultas a este objeto de la base de datos devuelven una fila por cada registro dentro de un tipo de objeto (por ejemplo, todos los registros de contactos en el tipo de 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:

Tenga en cuenta: El 25 de enero de 2022, la columna, timestamp en la tabla y vista object_with_object_properties, que representa la fecha y hora en que el registro del objeto se actualizó por última vez en HubSpot, se actualizará en. Esto es para alinearse con la forma en que los datos de fecha y hora se representan en el resto de la cuota de datos.

Como se trata de un cambio de última hora, la nueva columna, updatedat se ha añadido a la tabla y la vista. Durante los próximos 90 días, estas dos nuevas columnas coexistirán con timestamp, las columnas a las que pretenden sustituir. Esto le da la oportunidad de cambiar al uso de las nuevas columnas.

Después de 90 días, el 25 de enero de 2022, la columna timestamp será eliminada de la tabla y de la vista. Después de esta fecha, cualquier intento de consultar la tabla o vista object_with_object_properties utilizando columnas de fecha y hora fallará.

Ejemplo 1

Recuperar todos los contactos y sus propiedades.

Consulta:

Devuelve:

Ejemplo 2

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

Consulta:

Devuelve:

objetos

Este objeto de base de datos es un subconjunto de los datos del objeto de base de datos object_with_object_properties. Cada fila devuelve el ID del objeto para cada registro. Este objeto de la base de datos sólo devuelve los registros existentes. Cuando se elimina un registro en HubSpot, se eliminará de este objeto de la base de datos. Este objeto de la base de datos 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. 

Este objeto de base de datos puede ser útil si su cuenta tiene una gran cantidad de datos, lo que hace que las vistas object_with_object_properties y objects_x tengan un rendimiento lento. El uso de este objeto de base de datos con el objeto de base de datos object_properties permite replicar los datos de object_with_object_properties, manteniendo el control sobre qué propiedades se devuelven.

Este objeto de base de datos puede devolver las siguientes columnas:

Ejemplo 1

Recuperar todos los registros de contactos.

Consulta:

Devuelve:

object_properties

Este objeto de base de datos es un subconjunto del objeto de base de datos 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á.

Este objeto de base de datos puede devolver las siguientes columnas:

Ejemplo 1

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

Consulta:

Devuelve:

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

Consulta:

Devuelve:

object_properties_history

Este objeto de la base de datos contiene los valores históricos de las propiedades. 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.

Este objeto de base de datos puede devolver las siguientes columnas:

Ejemplo 1

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

Consulta:

 
Devuelve:

Ejemplo 2

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

Consulta:

Devuelve:

Consultas sobre asociación

Al igual que los datos de los objetos, los datos de las asociaciones se organizan de dos maneras:

• Individual: Cada tipo de asociación se almacena en su propia vista y contiene sólo registros de ese tipo. Por ejemplo, associations_contacts_to_deals contiene sólo registros de asociación entre objetos de contacto y de negocio. Esto elimina la necesidad de especificar un tipo de asociación durante la consulta. Estas vistas son bastante fáciles de consultar ya que no requieren estar familiarizado con el modelo de datos de CRM para poder utilizarlas. También devuelven una descripción enriquecida del registro de asociación entre dos objetos que puede utilizarse fácilmente en las uniones con las vistas objects_x. Mientras no se produzcan consultas lentas, es aconsejable utilizar estas vistas para recuperar los datos de la asociación. Vea más en las vistas de associations_x_to_y más abajo. 
• Combinado: Todos los registros de todos los tipos de asociación se combinan en un objeto de la base de datos. Por lo tanto, al realizar la consulta, es necesario especificar un filtro como "WHERE combinedassociationtypeid='0-32' ". Ver más en asociaciones y asociación_definiciones más abajo.

vistas de asociaciones_x_a_y

Cada tipo de asociación tiene su propia vista, etiquetada como associations_<association type name>, por ejemplo, associations_contacts_to_deals. Cada vista es un subconjunto de los datos del objeto de la base de datos de asociaciones y sólo contiene registros de un determinado combinedassociationtypeid.

Cada objeto de la base de datos devolverá las siguientes columnas:

Ejemplo 1

Recuperar todos los negocios asociados a un contacto concreto.

Consulta:

Devuelve:

Ejemplo 2

Recuperar todos los contactos basados en la zona horaria de Bogotá y sus ofertas.

Ejemplo 3

Recuperar todos los contactos y la suma total del importe de las operaciones cerradas para cada contacto.

Devuelve:

association_definitions

Este objeto de la base de datos 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 este objeto de base de datos con el objeto de base de datos 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 true.

Este objeto de base de datos puede devolver las siguientes columnas:

Ejemplo 1 

Recuperar los tipos de asociaciones disponibles en tu cuenta.

Consulta:

 
Devuelve:

Ejemplo 2

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

Consulta:

Devuelve:

asociaciones

Este objeto de la base de datos 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 este objeto de base de datos aunque los registros referenciados hayan sido eliminados. Puedes comprobar si existen registros uniéndose a la tabla de objetos.

Este objeto de base de datos puede ser útil si su cuenta tiene una gran cantidad de datos, lo que hace que las vistas associations_x_to_y tengan un rendimiento lento.

Este objeto de base de datos puede devolver las siguientes columnas:

Ejemplo 1

Recuperar todos los negocios y contactos asociados.

Consulta:

 
Devuelve: 

Ejemplo 2 

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

Consulta:

Devuelve:

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:

Devuelve:

Consultas del propietario

propietarios

Este objeto de la base de datos 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. 

Este objeto de base de datos puede devolver las siguientes columnas:

Ejemplo 1 

Recuperar todos los usuarios. El filtro WHERE archived = false elimina los usuarios eliminados de los datos devueltos.

Consulta:

 
Devuelve: 

Ejemplo 2

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

Consulta:

Devuelve: 

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.

Devuelve: 

Consultas del equipo

equipos

Los equipos en HubSpot te permiten organizar a tus usuarios en grupos para fines de organización y creación de informes. Puedes tener un equipo principal y equipos adicionales.

Este objeto de la base de datos contiene información sobre los equipos de tu cuenta de HubSpot. 

Este objeto de base de datos puede devolver las siguientes columnas:

Ejemplo 1

Recupera todos los equipos.

Consulta:

Devuelve:

owner_team

Este objeto de la base de datos contiene información sobre qué propietarios corresponden a qué equipos en tu cuenta de HubSpot. 

Este objeto de base de datos puede devolver las siguientes columnas:

Ejemplo 1

Recupera todos los propietarios de un equipo determinado.

Consulta:

SELECT teamId, ownerId, isTeamPrimary
FROM teams
WHERE teamId = 29584574

Devuelve

Consultas sobre pipelines

A continuación, aprende a consultar los datos de pipelines de negocios y tickets, como las 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, puede consultar las operaciones y sus canalizaciones uniendo los datos de objects_deals_view o de object_with_object_properties con los datos de las canalizaciones.

pipelines

Este objeto de la base de datos contiene información sobre los pipelines de tratos y tickets de su cuenta. Cada fila devuelta representa un solo pipeline.

Esta tabla puede devolver las siguientes columnas:

Ejemplo 1

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

Consulta:

 
Devuelve: 

Ejemplo 2

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

Consulta:

Devuelve: 

Ejemplo 3

Igual que en el ejemplo 2, recuperar las operaciones dentro de una línea de producción específica. Pero, en lugar de utilizar objetos_acuerdos en las uniones, utiliza objeto_con_propiedades_del_objeto.

Devuelve: 

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.

Este objeto de base de datos puede devolver las siguientes columnas:

Ejemplo 1 

Recuperar las etapas de un pipeline denominado Pipeline de ventas.

Consulta:

 
Devuelve: 

Ejemplo 2

Recuperar todos los negocios y sus respectivas etapas de pipeline.

Consulta:

Devuelve: 

Consultas sobre la propiedad

property_definitions

Este objeto de la base de datos contiene información sobre las propiedades de los objetos y las propiedades de los eventos de 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.

Este objeto de base de datos puede devolver las siguientes columnas:

Ejemplo 1

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

Consulta:

 
Devuelve:

Consultas sobre eventos

Los eventos incluyen eventos estándar de HubSpot y eventos de comportamiento personalizados. Cada acontecimiento tiene su propio objeto de base de datos, etiquetado como events_eventname.

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:

Ejemplo 1

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

Consulta:

Devuelve: 

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:

Devuelve: 

Consultas de tipo objeto y evento

object_and_event_type_definitions

Este objeto de la base de datos contiene definiciones para todos los objetos y eventos disponibles en su cuenta de HubSpot.

Este objeto de base de datos puede devolver las siguientes columnas:

Ejemplo 1

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

Consulta:

 
Devuelve: 

Listas de consultas

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

listas

Este objeto de la base de datos 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). 

Este objeto de base de datos puede devolver las siguientes columnas:

Ejemplo 1

Recuperar todas las listas de contactos.

Consulta:

 
Devuelve: 

Ejemplo 2

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

Consulta:

Devuelve: 

list_membership

Este objeto de la base de datos contiene información sobre qué registros son miembros de qué listas, con una fila por cada registro de la lista. Por ejemplo, si tiene una lista de suscriptores de un blog con 500 contactos, el objeto de base de datos devolverá 500 filas. 

Sólo contiene los ID de listas y los ID de objetos. Para más información, únase al objeto de base de datos de las listas.

Este objeto de base de datos puede devolver las siguientes columnas:

Ejemplo 1

Recuperar los ID de todos los contactos de la lista Principales suscriptores 2021.

Consulta:

 
Devuelve: 

Ejemplo 2

Recuperar los nombres y apellidos de los detalles de los contactos de la lista de los principales abonados 2021.

Consulta:

Devuelve: 

Preguntas frecuentes

Quiero generar datos similares a un informe de la aplicación de Hubspot, ¿cómo lo hago?

Por lo general, es conveniente observar las columnas presentes en el informe con el que se está comparando. Si la visualización del informe no es tabular, al convertirlo en una tabla se mostrarán las columnas que contiene el informe. Estas columnas suelen ser propiedades de un tipo de objeto o de un tipo de evento. El siguiente paso es averiguar la propiedad de tipo de objeto a la que corresponde una columna. Puede hacerlo consultando property_definitions:

Puede que no siempre haya una coincidencia exacta porque algunos nombres de propiedades suelen resolverse con un nombre más descriptivo en la aplicación. En casos como este, hacer una búsqueda difusa usando el operador LIKE en la columna label(o incluso la descripción) en property_definitions puede ayudar.

Después de determinar a qué tipo de objeto pertenece la columna, es trivial determinar qué consultar. Basta con buscar la vista object_x que corresponde al tipo.

¿Cómo puedo vincular este tipo de datos a otro, por ejemplo, cómo recuperar formularios para una campaña?

Si necesitas vincular dos o más registros diferentes entre sí, echa un vistazo a las asociaciones. Las asociaciones representan las relaciones entre objetos en el CRM de HubSpot. Todas las asociaciones posibles entre dos tipos se enumeran en association_definitions. En el ejemplo anterior, para conocer todos los formularios a los que está vinculada una campaña, es necesario consultar ASSOCIATIONS_CAMPAIGNS_TO_FORMS:

¿Cómo puedo conocer el estado de la integración HubSpot-Snowflake?

Para recibir actualizaciones de estado en tiempo real sobre interrupciones y problemas de la integración HubSpot-Snowflake, consulta la vista data_share_status:

SELECT * FROM hubspot.public.data_share_status
LIMIT 1

Los resultados se mostrarán como:

Esta vista proporciona actualizaciones sobre el estado de la integración en orden cronológico inverso. Integrar los resultados de esta consulta en un panel de control te ayudará a seguir el rendimiento de la integración y a detectar cualquier tiempo de inactividad o interrupción.