BètaHubSpot-gegevens exporteren naar Microsoft Fabric

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

Gebruik Data Out om geselecteerde HubSpot CRM-gegevens te exporteren naar native tabellen in een Microsoft Fabric-warehouse waarvan u de eigenaar bent. U kunt object-, associatie- en gebeurtenisgegevens synchroniseren met tabellen in uw warehouse, waarna u die gegevens kunt opvragen met SQL of kunt gebruiken met uw business intelligence- en analysetools.

Bij elke synchronisatie wordt een volledige momentopname van de geselecteerde gegevens gemaakt. Wanneer een synchronisatie slaagt, vervangt deze de vorige momentopname in de doeltabellen.

Voordat je aan de slag gaat

Zorg dat je de vereisten begrijpt

Om gegevens naar Microsoft Fabric te exporteren, heb je het volgende nodig:

• Een Microsoft Fabric-werkruimte met een Fabric-warehouse
• Een Microsoft Entra ID-serviceprincipaal die aan de Fabric-werkruimte is toegevoegd met de rol ‘Contributor’
• De tenant-ID, client-ID en het clientgeheim van de serviceprincipal
• Je Fabric Warehouse SQL-verbindingsreeks (serveradres, zonder het poortnummer) en de naam van het warehouse

De Microsoft Entra ID-serviceprincipal moet toestemming hebben om objecten die eigendom zijn van HubSpot aan te maken en te beheren in het Fabric-warehouse van bestemming. Tijdens de validatie van de verbinding en tijdens synchronisaties maakt HubSpot schema’s en tabellen aan, voegt gegevens in, hernoemt stagingtabellen en verwijdert tijdelijke objecten. Verleen de serviceprincipal de rol ‘Contributor’ in de Fabric-werkruimte, zodat HubSpot het volgende kan doen:

• Schema’s aanmaken
• Tabellen aanmaken
• Rijen invoegen
• HubSpot-tabellen hernoemen of wijzigen
• HubSpot-tabellen en -schema's verwijderen

Je Fabric Warehouse SQL-eindpunt moet voor HubSpot bereikbaar zijn via TCP-poort 1433. HubSpot gebruikt TLS voor alle verbindingen en valideert het servercertificaat.

Als je Fabric-werkruimte de netwerktoegang beperkt, voeg dan de uitgaande IP-adressen van HubSpot voor de regio van je account toe aan de lijst met toegestane adressen.

Beperkingen en aandachtspunten

• Microsoft Fabric Data Out ondersteunt alleen Fabric Warehouses. Lakehouses worden niet ondersteund.
• Bij elke synchronisatie wordt een volledige momentopname van de geselecteerde gegevens gemaakt. Een succesvolle synchronisatie vervangt de vorige momentopname in de doeltabellen. HubSpot bewaart geen eerdere momentopnames. Als een tabel tijdens een synchronisatie mislukt, blijven de eerdere gegevens beschikbaar tot de volgende succesvolle synchronisatie.
• Elk objecttype, gebeurtenistype of associatiepaar kan worden opgenomen in één terugkerende Microsoft Fabric-synchronisatie per account.
• Elke synchronisatie vervangt de doeltabel. Toegangsrechten of instellingen op tabelniveau die in je Fabric Warehouse zijn toegevoegd, blijven niet behouden tussen synchronisaties.
• Om opnieuw verbinding te maken met een andere serviceprincipal, moet je die serviceprincipal aan de Fabric-werkruimte toevoegen met de rol ‘Contributor’, voordat de verbindingstest of synchronisatie kan slagen.

HubSpot verbinden met Microsoft Fabric

Het wordt aanbevolen om je HubSpot-account en Microsoft Fabric-consoles in aparte tabbladen te openen.

1. Klik in je HubSpot-account op Meer en navigeer vervolgens naar Gegevensbeheer > Data Studio. Als Meer niet in je account verschijnt, navigeer dan direct naar Gegevensbeheer > Data Studio.
2. Klik rechtsboven op Externe gegevensbron verbinden.
3. Zoek in het paneel 'Een gegevensbron toevoegen ' naar Microsoft Fabric of blader ernaar.
4. Klik op 'Installeren' en vervolgens op 'Volgende'.
5. Voer de tenant-ID, client-ID en het clientgeheim van uw serviceprincipaal in.
6. Voer de volgende bestemmingsgegevens in:
   • SQL-verbindingsreeks: het serveradres van uw Fabric Warehouse, zonder het poortnummer.
   • Naam vanhet warehouse: de naam van het Fabric-warehouse waarnaar u wilt exporteren.
7. Klik op Verbinding testen. Als de verbindingstest is geslaagd, klikt u op Volgende.

Let op: controleer in uw Fabric-werkruimte of de HubSpot-serviceprincipal de rol ‘Contributor’ heeft voordat u de verbindingstest uitvoert. Er zijn geen SQL-scripts nodig om de toegang te configureren.

De synchronisatie configureren

1. Selecteer de gegevensbronnen die u wilt exporteren:
   • Objecten
   • Koppelingen
   • Gebeurtenissen
2. Selecteer de objecten, eigenschappen, koppelingen of gebeurtenissen die u wilt opnemen.
3. Kies hoe vaak de synchronisatie moet worden uitgevoerd en wanneer deze moet starten.
4. Klik op 'Synchronisatie starten'.

De beschikbare synchronisatiefrequenties kunnen tijdens de bètaperiode variëren. Mogelijke opties zijn: eenmalig, om de 6 uur, om de 12 uur, dagelijks, wekelijks of maandelijks.

Toegang tot je geëxporteerde gegevens

HubSpot maakt voor elke bestemming een door HubSpot beheerd schema aan. Tabellen hebben de volgende indeling:

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

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

U kunt de exacte schemanaam vinden op de configuratiepagina voor synchronisatie.

Tabel- en kolomnamen

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

• Spaties en koppeltekens worden onderstrepingstekens.
• Andere niet-alfanumerieke tekens worden verwijderd.
• Namen die langer zijn dan 128 tekens worden ingekort.
• Kolomnamen die met elkaar conflicteren, krijgen een achtervoegsel.
• Bij conflicterende tabelnamen mislukt de betreffende export.

Kolomtypen

De kolom PROPERTIES in OBJECT_WITH_OBJECT_PROPERTIES wordt opgeslagen als een JSON-geformatteerde tekenreeks in VARCHAR(MAX), niet als een native JSON-kolomtype. Zie de queryvoorbeelden in de veelgestelde vragen hieronder.

Objecttabellen

Als je objectgegevens selecteert, exporteert HubSpot de volgende tabellen.

OBJECT_PROPERTIES

Deze tabel bevat één rij voor elke waarde van een objecteigenschap.

OBJECT_WITH_OBJECT_PROPERTIES

Deze tabel bevat één rij voor elk objectrecord. Geselecteerde eigenschapswaarden worden gegroepeerd in de kolom PROPERTIES.

Objectgegevens voor verschillende objecttypen worden in deze tabel samengevoegd. Filter op OBJECTTYPEID om records voor een specifiek objecttype te bekijken:

• Contacten: 0-1
• Aangepaste objecten: 2-{unique_id}, bijvoorbeeld 2-12345

OBJECT_PROPERTIES_HISTORY

Deze tabel bevat de wijzigingsgeschiedenis van eigenschappen. Er is één rij voor elke historische waarde van een eigenschap.

Om de volledige geschiedenis voor een specifiek record en een specifieke eigenschap te bekijken, sorteert u de resultaten op UPDATEDAT.

Koppelingstabellen

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

ASSOCIATIONS

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

ASSOCIATION_DEFINITIONS

Deze tabel bevat één rij voor elke geselecteerde associatiedefinitie.

Koppelingsspecifieke tabellen

Voor geselecteerde koppelingsparen kan HubSpot ook tabellen exporteren met de volgende indeling:

ASSOCIATIONS_<FROM_OBJECT_TYPE>_TO_<TO_OBJECT_TYPE>

Bijvoorbeeld: ASSOCIATIONS_CONTACTS_TO_COMPANIES

Deze tabellen bevatten koppelingsrecords en metadata van koppelingsdefinities.

Gebeurtenistabellen

Als je gebeurtenisgegevens selecteert, exporteert HubSpot één tabel voor elk type gebeurtenis. De namen van gebeurtenistabellen hebben de volgende indeling:

EVENTS_<EVENT_NAME>

Bijvoorbeeld: EVENTS_VISITED_PAGE

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

Je synchronisatie controleren

1. Klik in je HubSpot-account op Meer en navigeer vervolgens naar Gegevensbeheer > Data Studio. Als Meer niet in je account verschijnt, navigeer dan direct naar Gegevensbeheer > Data Studio.
2. Klik links op App-synchronisaties.
3. Zoek de Microsoft Fabric -synchronisatie of selecteer deze.

Op de pagina met synchronisatiegegevens kunt u de synchronisatiestatus, het tijdstip van de laatste synchronisatie, fouten, synchronisatieactiviteit en de synchronisatiegeschiedenis bekijken. U kunt de synchronisatie ook pauzeren, archiveren of handmatig uitvoeren.

Synchronisatiestatus

Synchronisatiefouten oplossen

Wanneer een synchronisatie mislukt:

• De HubSpot-gebruikersinterface toont de status 'Mislukt' en details op tabelniveau die aangeven welke tabellen zijn geslaagd of mislukt.
• Een tabel wordt pas bijgewerkt nadat HubSpot alle gegevens ervan heeft geladen. Als een tabel mislukt, blijven de vorige gegevens behouden tot de volgende succesvolle synchronisatie.
• Bij de volgende geplande synchronisatie wordt automatisch opnieuw geprobeerd de volledige synchronisatie uit te voeren.
• Je kunt handmatig een synchronisatie uitvoeren vanaf de pagina met synchronisatiegegevens.

Veelgestelde vragen

Hoe kan ik de geëxporteerde gegevens opvragen?

Vraag de tabellen in het doelschema op met SQL.

-- Read all contact records
SELECT *
FROM [your_database].[hubspot_data_out_456].[OBJECT_WITH_OBJECT_PROPERTIES]
WHERE [OBJECTTYPEID] = '0-1'; -- Read a specific property from the PROPERTIES JSON string
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 objecttype, gebeurtenistype of associatiepaar kan in één terugkerende Microsoft Fabric-synchronisatie per HubSpot-account worden opgenomen. Dit staat los van andere Data Out-providers.

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

Worden objectspecifieke tabellen ondersteund?

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

Wordt 'Sensitive Data' ondersteund?

Gevoelige gegevens worden momenteel niet ondersteund voor Data Out. Gevoelige eigenschappen kunnen worden uitgesloten van exporten.

Bewaar HubSpot eerdere momentopnames?

Nee. Bij elke succesvolle synchronisatie wordt de doeltabel vervangen door de nieuwste momentopname. HubSpot bewaart geen eerdere momentopnames. Als een tabel tijdens een synchronisatie mislukt, blijven de eerdere gegevens behouden totdat die tabel met succes is bijgewerkt.

Gebruikt HubSpot een door mij beheerde staging-bucket?

Nee. HubSpot maakt een tijdelijke Parquet-export aan in de door HubSpot beheerde opslag en schrijft de resultaten naar je Fabric Warehouse. Je hoeft geen staging-bucket aan te leveren of te beheren.

Wat gebeurt er als ik opnieuw verbinding maak met een andere serviceprincipal?

Als je opnieuw verbinding maakt met een andere serviceprincipal, moet je die serviceprincipal aan de Fabric-werkruimte toevoegen met de rol ‘Contributor’ voordat de verbindingstest of synchronisatie kan slagen.