BetaAccede a tus datos de HubSpot desde Microsoft Azure Synapse Analytics

Utiliza «Data Out for Azure Synapse» para exportar los datos seleccionados del CRM de HubSpot a tablas de un grupo SQL dedicado de Azure Synapse del que seas propietario. HubSpot actualiza cada tabla de resultados a partir de una exportación completa de los datos seleccionados. 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.

• HubSpot actualiza las tablas por separado. Si realizas una consulta en varias tablas mientras se está ejecutando una sincronización, es posible que algunas tablas se actualicen antes que otras.
• Data Out no ofrece retención de instantáneas históricas. Una vez realizada correctamente la actualización, la tabla de destino contiene la instantánea más reciente.
• Cada objeto, tipo de evento o par de asociaciones puede incluirse en una sincronización recurrente de Azure Synapse por cada cuenta de HubSpot. Este límite es independiente de otros proveedores de Data Out.
• Las tablas específicas de objetos, como OBJECTS_CONTACTS, aún no son compatibles.
• Si dos nombres de tablas entran en conflicto después de que HubSpot los haya normalizado, la exportación afectada falla. Para obtener más información, consulta las normas sobre los nombres de tablas y columnas.

Conoce los datos que puedes exportar

Puedes sincronizar los siguientes datos desde HubSpot a Azure Synapse Analytics:

• Objetos y registros: objetos estándar y personalizados seleccionados, así como sus registros, como contactos, empresas, negocios, tickets y productos.
• 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:

• El punto de conexión SQL dedicado de Azure Synapse y la base de datos de destino.
• 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 crea una exportación temporal en formato Parquet en el almacenamiento gestionado por HubSpot y guarda los resultados en tablas de tu grupo SQL dedicado de Azure Synapse. No es necesario que proporciones ni gestiones un bucket de prueba.

Encuentra tus datos en Azure Synapse

HubSpot crea tablas de salida en un esquema gestionado por HubSpot para tu destino. HubSpot exporta los datos de los objetos a las tres tablas de objetos descritas en este artículo. HubSpot también crea una tabla por cada tipo de evento seleccionado y, cuando está disponible, una tabla específica por cada par de asociación seleccionado.

<database>.hubspot_data_out_<destination-id>.<table-name>

Puedes encontrar el nombre exacto del esquema en la página de configuración de tu sincronización. Por ejemplo:

• 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

Nombres de tablas y columnas

HubSpot normaliza los nombres de las tablas y columnas exportadas, convirtiéndolos en letras mayúsculas, números y guiones bajos:

• Los espacios y los guiones se convierten en guiones bajos.
• Se eliminan los demás caracteres no alfanuméricos.
• Los nombres que superen los 128 caracteres se acortan.
• Los nombres de columnas que entran en conflicto reciben un sufijo.
• Los nombres de las tablas que entran en conflicto provocan un error en la exportación afectada.

Utiliza corchetes cuando realices consultas con identificadores, sobre todo si construyes las consultas de forma dinámica. El hecho de que los identificadores distingan entre mayúsculas y minúsculas depende de la colación de tu base de datos Synapse. Por ejemplo:

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

Tipos de columnas

Los tipos de columna se corresponden con los datos exportados y se asignan a los tipos de Azure Synapse de la siguiente manera:

Nota: la PROPERTIES columna OBJECT_WITH_OBJECT_PROPERTIES se exporta como una cadena con formato JSON. Se almacena como NVARCHAR(MAX), 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, las frecuencias de sincronización disponibles pueden ser limitadas. 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 Azure Synapse en HubSpot. Una sincronización puede encontrarse en uno de los siguientes estados:

Cuando falla una sincronización:

• HubSpot muestra el estado «Fallido» , junto con detalles sobre qué tablas se han procesado correctamente y cuáles han fallado.
• Si no es posible actualizar una tabla, los datos anteriores que se habían guardado correctamente suelen seguir estando disponibles.
• En el caso de las sincronizaciones periódicas, la siguiente sincronización programada vuelve a intentar automáticamente una sincronización completa.
• Puedes desencadenar manualmente una resincronización en cualquier momento en HubSpot.

Preguntas frecuentes

¿Cómo puedo consultar los datos?

Consulta las tablas del esquema de destino mediante SQL. Por ejemplo, lee todos los registros de contactos:

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

Leer una propiedad concreta de la PROPERTIES cadena JSON:

SELECT
  [OBJECTID],
  JSON_VALUE([PROPERTIES], '$.email') AS [email]
FROM [your_database].[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 recurrente de Azure Synapse por cada cuenta de HubSpot. Este límite es independiente de otros proveedores de Data Out.

Por ejemplo, si los contactos ya se han exportado a un destino recurrente de Azure Synapse, no podrás añadir contactos a otra sincronización recurrente de Azure Synapse hasta que hayas archivado la primera sincronización. Aún así, puedes exportar contactos a otro proveedor de Data Out compatible 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.

¿Conserva HubSpot las instantáneas anteriores?

No. Data Out no ofrece retención de instantáneas históricas. Una vez realizada correctamente la actualización, la tabla de destino contiene la instantánea más reciente. Si no es posible actualizar una tabla, los datos anteriores que se habían guardado correctamente suelen seguir estando disponibles.