BetaAccede a tus datos de HubSpot desde PostgreSQL o MySQL

Utiliza «Data Out» para PostgreSQL y MySQL para exportar los datos seleccionados del CRM de HubSpot a tablas de una base de datos de tu propiedad. Cada proceso de sincronización genera una instantánea completa de los datos seleccionados y sustituye a la instantánea anterior. Una vez realizada la sincronización, puedes consultar las tablas mediante SQL o con tus herramientas de BI y análisis preferidas para combinar los datos de HubSpot con otros datos empresariales.

Nota: si es Superadministrador, opte por que su cuenta entre en la versión beta de Data Studio para poder utilizar esta función.

Comprender las limitaciones y consideraciones

Antes de comenzar a trabajar con esta característica, asegúrate de que comprendes perfectamente qué pasos hay que dar con antelación, así como las limitaciones de la función y las posibles consecuencias de utilizarla.

• Cada sincronización sustituye las tablas de destino por la instantánea más reciente. HubSpot no conserva instantáneas anteriores.
• Cada objeto, tipo de evento o par de asociaciones puede incluirse en una sincronización periódica con PostgreSQL y en una sincronización periódica con MySQL por cada cuenta de HubSpot. Estas sincronizaciones son independientes entre sí y de otros proveedores de Data Out.
• Los datos sensibles aún no son compatibles. Las propiedades sensibles pueden quedar excluidas de las exportaciones.
• Las tablas específicas de objetos, como OBJECTS_CONTACTS, aún no son compatibles.
• En PostgreSQL, los nombres de las tablas y las columnas distinguen entre mayúsculas y minúsculas, y es posible que en MySQL también sea así. Revisa la sintaxis de las consultas antes de escribirlas.

Conoce los datos que puedes exportar

Puedes sincronizar los siguientes datos desde HubSpot a PostgreSQL o MySQL:

• Objetos: objetos estándar y personalizados, como contactos, empresas, negocios, tickets y productos.
• Registros: registros individuales de los objetos seleccionados.
• Propiedades: valores de las propiedades seleccionadas e historial de las propiedades de los registros.
• Asociaciones: relaciones seleccionadas entre registros, incluidas las definiciones de las asociaciones.
• Eventos: eventos estándar seleccionados de HubSpot y eventos de comportamiento personalizados, incluidas determinadas propiedades de los eventos.

Los datos de los distintos objetos se agrupan en las tablas de objetos. Cuando leas una tabla de objetos, utiliza OBJECTTYPEID para filtrar y seleccionar un objeto concreto. Por ejemplo, los contactos utilizan 0-1. A los objetos personalizados se les asigna un ID al crearlos y se identifican como 2-{unique_id}, como 2-12345.

Comprender el formato de exportación

Durante la configuración, debes elegir:

• La base de datos de destinos. Esto solo se aplica a PostgreSQL. En el caso de MySQL, HubSpot crea la base de datos.
• Las fuentes de datos que se van a sincronizar: objetos, eventos, asociaciones o una combinación de estas fuentes.
• El calendario de sincronización.

HubSpot exporta los datos como archivos Parquet y los carga directamente en las tablas de tu base de datos. PostgreSQL y MySQL no utilizan un depósito de pruebas propiedad del cliente. HubSpot gestiona los entornos de prueba de forma interna.

Busca tus datos en tu base de datos

HubSpot crea una tabla por cada fuente de datos en un esquema gestionado por HubSpot cuyo nombre se corresponde con el de tu destino. Puedes encontrar el nombre exacto del esquema en la página de configuración de tu sincronización.

• PostgreSQL: <database>.hubspot_data_out_<destination-id>.<table-name>
• MySQL: hubspot_data_out_<destination-id>.<table-name>. En MySQL, el esquema y la base de datos son el mismo concepto, y HubSpot lo crea. No hay ningún nivel de base de datos independiente que se pueda seleccionar.

Por ejemplo, en PostgreSQL:

• your_database.hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES
• your_database.hubspot_data_out_456.EVENTS_VISITED_PAGE
• your_database.hubspot_data_out_456.ASSOCIATIONS_CONTACTS_TO_COMPANIES

Por ejemplo, en MySQL:

• hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES
• hubspot_data_out_456.EVENTS_VISITED_PAGE
• hubspot_data_out_456.ASSOCIATIONS_CONTACTS_TO_COMPANIES

Cada sincronización sustituye la tabla por la última instantánea. HubSpot no conserva instantáneas anteriores. Si una tabla falla durante una sincronización, sus datos anteriores permanecen intactos hasta la siguiente sincronización que se realice con éxito.

Nombres de tablas y columnas

Los nombres de las tablas y las columnas proceden de los datos exportados. Los identificadores de PostgreSQL tienen un límite de 63 caracteres, mientras que los de MySQL tienen un límite de 64 caracteres. HubSpot acorta los nombres más largos para que quepan.

Mayúsculas y minúsculas en los identificadores

La mayúscula o minúscula del identificador es importante. HubSpot crea todas las tablas y columnas con nombres entre comillas, conservando las mayúsculas y minúsculas, tal y como aparecen en las tablas de este artículo.

• PostgreSQL: escribe los nombres entre comillas dobles exactamente como se muestra. PostgreSQL convierte los nombres sin comillas a minúsculas, por lo que no coincidirán.
• MySQL: utiliza comillas invertidas y respeta las mayúsculas y minúsculas tal y como se muestra. El hecho de que los nombres de las tablas distingan entre mayúsculas y minúsculas depende de la configuración de tu servidor.

Ejemplo de PostgreSQL:

SELECT * FROM your_database.hubspot_data_out_456."OBJECT_WITH_OBJECT_PROPERTIES" WHERE "OBJECTTYPEID" = '0-1';

Ejemplo de MySQL:

SELECT * FROM `hubspot_data_out_456`.`OBJECT_WITH_OBJECT_PROPERTIES` WHERE `OBJECTTYPEID` = '0-1';

Tipos de columnas

Los tipos de columna se ajustan a los datos exportados y se corresponden con los tipos de PostgreSQL y MySQL de la siguiente manera:

Nota: la PROPERTIES columna OBJECT_WITH_OBJECT_PROPERTIES se exporta como una cadena con formato JSON. Se almacena como TEXT en PostgreSQL o LONGTEXT en MySQL, no como un tipo de columna JSON. Para ver ejemplos de consultas, consulta las preguntas frecuentes.

Revisar las tablas de objetos

Si seleccionas los datos de los objetos, HubSpot exporta las siguientes tablas.

PROPIEDADES DEL OBJETO

Esta tabla contiene una fila por cada valor de propiedad. Para leer un objeto concreto, filtra por OBJECTTYPEID.

OBJETO_CON_PROPIEDADES_DE_OBJETO

Esta tabla contiene una fila por registro, con los valores de las propiedades seleccionadas agrupados en una única PROPERTIES columna. Para leer un objeto concreto, filtra por OBJECTTYPEID.

OBJECT_PROPERTIES_HISTORY

Esta tabla contiene el historial de cambios de las propiedades. A diferencia de OBJECT_PROPERTIES, que solo contiene el valor actual, esta tabla tiene una fila para cada valor histórico de una propiedad. Para ver la cronología completa de un registro y una propiedad concretos, ordena por UPDATEDAT.

Revisar las tablas de asociación

Si seleccionas los datos de asociación, HubSpot exporta los registros de asociación y las definiciones de asociación.

ASOCIACIONES

Esta tabla contiene una fila por cada asociación seleccionada entre dos registros.

DEFINICIONES DE ASOCIACIONES

Esta tabla contiene una fila por cada definición de asociación seleccionada.

ASOCIACIONES_<FROM_OBJECT>_A_<TO_OBJECT>

Para determinados pares de asociaciones, HubSpot también puede exportar tablas de asociación específicas para cada par, como ASSOCIATIONS_CONTACTS_TO_COMPANIES. Estas tablas incluyen registros de asociación junto con los metadatos de definición de las asociaciones.

Revisar las tablas de eventos

Si seleccionas datos de eventos, HubSpot exporta una tabla por cada tipo de evento. Los nombres de las tablas siguen el formato EVENTS_<EVENT_NAME>, como EVENTS_VISITED_PAGE.

Cada tabla de eventos contiene las columnas estándar de eventos y una columna para cada propiedad de evento seleccionada.

Gestionar el calendario de sincronización

La programación de la sincronización se configura durante la configuración en HubSpot. También puedes utilizar un desencadenante manual para iniciar una resincronización desde HubSpot. Cada sincronización genera una instantánea completa de los datos seleccionados. Para controlar el volumen de datos, selecciona qué objetos, eventos, asociaciones y propiedades deseas incluir.

Ten en cuenta que, durante la fase beta, es posible que solo haya disponible un conjunto limitado de frecuencias de sincronización, como una vez, cada 6 horas, cada 12 horas, diariamente, semanalmente y mensualmente. Es posible que se añadan opciones de frecuencia adicionales en futuras versiones.

Supervisar las sincronizaciones y gestionar los errores

Puedes supervisar las sincronizaciones de PostgreSQL y MySQL en HubSpot. Una sincronización puede encontrarse en uno de los siguientes estados:

Cuando falla una sincronización:

• HubSpot muestra el estado «Fallido» , con detalles por tabla que indican cuáles han tenido éxito y cuáles han fallado.
• Una tabla solo se actualiza una vez que HubSpot ha terminado de cargar todos sus datos, por lo que nunca verás una tabla cargada parcialmente.
• Si se produce un error en una tabla, sus datos anteriores permanecen en su sitio hasta la siguiente sincronización correcta.
• La próxima sincronización programada volverá a intentar automáticamente una sincronización completa.
• Puedes desencadenar manualmente una resincronización en cualquier momento en HubSpot.

Las tablas que se han ejecutado correctamente en una ejecución anterior no se modifican cuando falla una ejecución posterior.

Preguntas frecuentes

¿Cómo puedo consultar los datos?

Consulta las tablas del esquema de destino mediante SQL.

PostgreSQL

Leer todos los registros de contacto:

SELECT * FROM your_database.hubspot_data_out_456."OBJECT_WITH_OBJECT_PROPERTIES" WHERE "OBJECTTYPEID" = '0-1';

Lee una propiedad concreta de la PROPERTIES columna JSON. Convierte primero la columna a JSON, ya que está almacenada como texto:

SELECT "OBJECTID", json_extract_path_text("PROPERTIES"::json, 'email') AS email FROM your_database.hubspot_data_out_456."OBJECT_WITH_OBJECT_PROPERTIES" WHERE "OBJECTTYPEID" = '0-1';

MySQL

Leer todos los registros de contacto:

SELECT * FROM `hubspot_data_out_456`.`OBJECT_WITH_OBJECT_PROPERTIES` WHERE `OBJECTTYPEID` = '0-1';

Leer una propiedad concreta de la PROPERTIES columna JSON:

SELECT `OBJECTID`, JSON_EXTRACT(`PROPERTIES`, '$.email') AS email FROM `hubspot_data_out_456`.`OBJECT_WITH_OBJECT_PROPERTIES` WHERE `OBJECTTYPEID` = '0-1';

¿Puedo exportar un tipo de datos en varias sincronizaciones?

Cada objeto, tipo de evento o par de asociaciones puede incluirse en una sincronización periódica con PostgreSQL y en una sincronización periódica con MySQL por cada cuenta de HubSpot. Estas sincronizaciones son independientes entre sí y de otros proveedores de Data Out. Por ejemplo, si los contactos ya se han exportado a un destino PostgreSQL recurrente, no podrás añadir contactos a otra sincronización recurrente con PostgreSQL hasta que hayas archivado la primera sincronización. Aún así, puedes exportar los contactos a una sincronización periódica con MySQL al mismo tiempo.

¿Se admiten las tablas específicas de objetos?

No. Las tablas específicas de objetos, como OBJECTS_CONTACTS, aún no son compatibles. Utiliza OBJECT_WITH_OBJECT_PROPERTIES y filtra por OBJECTTYPEID para obtener registros de un objeto concreto.

¿Se admiten datos sensibles?

No. Por el momento, la función «Data Out» no admite datos sensibles. Las propiedades sensibles pueden quedar excluidas de las exportaciones.

¿Conserva HubSpot las instantáneas anteriores?

No. Cada sincronización sustituye la tabla de destino por la instantánea más reciente, por lo que no se conservan las instantáneas anteriores.