BètaJe HubSpot-gegevens opvragen vanuit Microsoft Azure Synapse Analytics

Gebruik ‘Data Out for Azure Synapse’ om geselecteerde HubSpot CRM-gegevens te exporteren naar tabellen in een speciale SQL-pool van Azure Synapse waarvan u de eigenaar bent. HubSpot werkt elke uitvoertabel bij op basis van een volledige export van de geselecteerde gegevens. Na de synchronisatie kunt u de tabellen doorzoeken met SQL of met uw favoriete BI- en analysetools om HubSpot-gegevens te combineren met andere bedrijfsgegevens.

Let op: als je een superbeheerder bent, moet je je account aanmelden voorde bètaversie van Data Studio om deze functie te kunnen gebruiken.

Beperkingen en aandachtspunten

Zorg ervoor dat je, voordat je met deze functie aan de slag gaat, volledig begrijpt welke stappen je van tevoren moet nemen, evenals de beperkingen van de functie en de mogelijke gevolgen van het gebruik ervan.

• HubSpot werkt tabellen afzonderlijk bij. Als je tijdens een synchronisatie een query uitvoert over meerdere tabellen, kunnen sommige tabellen eerder worden bijgewerkt dan andere.
• Data Out biedt geen bewaartermijn voor historische momentopnames. Na een succesvolle verversing bevat de doeltabel de meest recente momentopname.
• Elk object, gebeurtenistype of koppelingspaar kan worden opgenomen in één terugkerende Azure Synapse-synchronisatie per HubSpot-account. Deze limiet staat los van andere Data Out-providers.
• Objectspecifieke tabellen, zoals OBJECTS_CONTACTS, worden nog niet ondersteund.
• Als twee tabelnamen met elkaar conflicteren nadat HubSpot ze heeft genormaliseerd, mislukt de betreffende export. Raadpleeg de regels voor tabel- en kolomnamen voor meer informatie.

Weet welke gegevens je kunt exporteren

Je kunt de volgende gegevens van HubSpot synchroniseren met Azure Synapse Analytics:

• Objecten en records: geselecteerde standaard- en aangepaste objecten en hun records, zoals contactpersonen, bedrijven, deals, tickets en producten.
• Eigenschappen: geselecteerde eigenschapswaarden en de eigenschapsgeschiedenis van records.
• Koppelingen: geselecteerde relaties tussen records, inclusief koppelingsdefinities.
• Gebeurtenissen: geselecteerde standaard HubSpot-gebeurtenissen en aangepaste gedragsgebeurtenissen, inclusief geselecteerde gebeurteniskenmerken.

Gegevens voor verschillende objecten worden gecombineerd in de objecttabellen. Wanneer je een objecttabel leest, gebruik je OBJECTTYPEID om op een specifiek object te filteren. Contacten gebruiken bijvoorbeeld 0-1. Aangepaste objecten krijgen bij het aanmaken een ID toegewezen en worden aangeduid als 2-{unique_id}, bijvoorbeeld 2-12345.

Zorg dat je het exportformaat begrijpt

Tijdens de installatie kiest u:

• Het bestemmings-SQL-eindpunt en de database van Azure Synapse.
• De te synchroniseren gegevensbronnen: objecten, gebeurtenissen, koppelingen of een combinatie van deze bronnen.
• Het synchronisatieschema.

HubSpot maakt een tijdelijke Parquet-export aan in de door HubSpot beheerde opslag en schrijft de resultaten naar tabellen in je toegewijde SQL-pool van Azure Synapse. Je hoeft geen staging-bucket aan te leveren of te beheren.

Je gegevens vinden in Azure Synapse

HubSpot maakt uitvoertabellen aan in een door HubSpot beheerd schema voor je bestemming. HubSpot exporteert objectgegevens naar de drie objecttabellen die in dit artikel worden beschreven. HubSpot maakt ook één tabel per geselecteerd gebeurtenistype en, indien beschikbaar, één paarspecifieke tabel per geselecteerd associatiepaar.

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

Je kunt de exacte schemanaam vinden op de configuratiepagina van je synchronisatie. Bijvoorbeeld:

• 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

Tabel- en kolomnamen

HubSpot normaliseert geëxporteerde tabel- en kolomnamen naar hoofdletters, cijfers en onderstrepingstekens:

• Spaties en koppeltekens worden omgezet in onderstrepingstekens.
• Andere niet-alfanumerieke tekens worden verwijderd.
• Namen die langer zijn dan 128 tekens worden ingekort.
• Bij conflicterende kolomnamen wordt een achtervoegsel toegevoegd.
• Bij conflicterende tabelnamen mislukt de betreffende export.

Gebruik vierkante haakjes wanneer je identifiers opvraagt, vooral als je query’s dynamisch samenstelt. Of er bij identifiers onderscheid wordt gemaakt tussen hoofdletters en kleine letters, hangt af van de collatie van je Synapse-database. Bijvoorbeeld:

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

Kolomtypen

Kolomtypen volgen de geëxporteerde gegevens en worden als volgt toegewezen aan Azure Synapse-typen:

Let op: de kolom PROPERTIES in OBJECT_WITH_OBJECT_PROPERTIES wordt geëxporteerd als een tekenreeks in JSON-formaat. Deze wordt opgeslagen als NVARCHAR(MAX), niet als een JSON-kolomtype. Zie de veelgestelde vragen voor voorbeelden van query's.

Objecttabellen bekijken

Als je objectgegevens selecteert, exporteert HubSpot de volgende tabellen.

OBJECT_PROPERTIES

Deze tabel bevat één rij per eigenschapswaarde. Om een specifiek object te lezen, filter je op OBJECTTYPEID.

OBJECT_WITH_OBJECT_PROPERTIES

Deze tabel bevat één rij per record, waarbij de geselecteerde eigenschapswaarden zijn gegroepeerd in één kolom PROPERTIES. Om een specifiek object te bekijken, filter je op OBJECTTYPEID.

OBJECT_PROPERTIES_HISTORY

Deze tabel bevat de wijzigingsgeschiedenis van eigenschappen. In tegenstelling tot OBJECT_PROPERTIES, die alleen de huidige waarde bevat, heeft deze tabel één rij voor elke historische waarde van een eigenschap. Om de volledige tijdlijn voor één record en eigenschap te bekijken, sorteer je op UPDATEDAT.

Koppelings tabellen bekijken

Als je associatiegegevens selecteert, exporteert HubSpot zowel associatierecords als associatiedefinities.

ASSOCIATIONS

Deze tabel bevat één rij per geselecteerde koppeling tussen twee records.

ASSOCIATION_DEFINITIONS

Deze tabel bevat één rij per geselecteerde koppelingsdefinitie.

ASSOCIATIONS_<FROM_OBJECT>_TO_<TO_OBJECT>

Voor geselecteerde koppelingsparen kan HubSpot ook paarspecifieke koppelingstabellen exporteren, zoals ASSOCIATIONS_CONTACTS_TO_COMPANIES. Deze tabellen bevatten koppelingsrecords samen met metadata van de koppelingsdefinitie.

Gebeurtenistabellen bekijken

Als je gebeurtenisgegevens selecteert, exporteert HubSpot één tabel per gebeurtenistype. Tabelnamen hebben de indeling EVENTS_<EVENT_NAME>, zoals EVENTS_VISITED_PAGE.

Elke gebeurtenistabel bevat standaardgebeurteniskolommen en één kolom voor elke geselecteerde gebeurteniseigenschap.

Het synchronisatieschema beheren

Je configureert het synchronisatieschema tijdens de installatie in HubSpot. Je kunt ook handmatig een nieuwe synchronisatie starten vanuit HubSpot. Elke synchronisatie levert een volledige momentopname van de geselecteerde gegevens op. Om het gegevensvolume te beperken, kies je welke objecten, gebeurtenissen, koppelingen en eigenschappen je wilt opnemen.

Let op: tijdens de bètaperiode kunnen de beschikbare synchronisatiefrequenties beperkt zijn. In toekomstige releases kunnen er extra frequentieopties worden toegevoegd.

Synchronisaties monitoren en fouten afhandelen

Je kunt Azure Synapse-synchronisaties in HubSpot controleren. Een synchronisatie kan een van de volgende statussen hebben:

Wanneer een synchronisatie mislukt:

• HubSpot geeft de status 'Mislukt' weer, met details over welke tabellen wel of niet zijn geëxporteerd.
• Als een tabel niet kan worden bijgewerkt, blijven de vorige succesvolle gegevens doorgaans beschikbaar.
• Bij terugkerende synchronisaties wordt bij de volgende geplande synchronisatie automatisch opnieuw geprobeerd een volledige synchronisatie uit te voeren.
• Je kunt op elk moment handmatig een nieuwe synchronisatie starten in HubSpot.

Veelgestelde vragen

Hoe kan ik de gegevens opvragen?

Voer met SQL query's uit op de tabellen in je doelschema. Lees bijvoorbeeld alle contactrecords:

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

Lees een specifieke eigenschap uit de JSON-string PROPERTIES:

SELECT
  [OBJECTID],
  JSON_VALUE([PROPERTIES], '$.email') AS [email]
FROM [your_database].[hubspot_data_out_456].[OBJECT_WITH_OBJECT_PROPERTIES]
WHERE [OBJECTTYPEID] = '0-1';

Kan ik één gegevenstype in meerdere synchronisaties exporteren?

Elk object, gebeurtenistype of associatiepaar kan in één terugkerende Azure Synapse-synchronisatie per HubSpot-account worden opgenomen. Deze limiet staat los van andere Data Out-providers.

Als contacten bijvoorbeeld al zijn geëxporteerd naar een terugkerende Azure Synapse-bestemming, kun je geen contacten toevoegen aan een andere terugkerende Azure Synapse-synchronisatie totdat je de eerste synchronisatie hebt gearchiveerd. Je kunt contacten wel tegelijkertijd exporteren naar een andere ondersteunde Data Out-provider.

Worden objectspecifieke tabellen ondersteund?

Nee. Objectspecifieke tabellen, zoals OBJECTS_CONTACTS, worden nog niet ondersteund. Gebruik OBJECT_WITH_OBJECT_PROPERTIES en filter op OBJECTTYPEID om records voor een specifiek object op te halen.

Bewaar HubSpot eerdere momentopnames?

Nee. Data Out biedt geen bewaartermijn voor historische momentopnames. Na een succesvolle verversing bevat de doeltabel de meest recente momentopname. Als een tabel niet kan worden bijgewerkt, blijven de vorige succesvolle gegevens doorgaans beschikbaar.