TestversionExportera HubSpot-data till Microsoft Fabric

Observera: Om du är superadministratörmåste du anmäla ditt konto tillData Studio-betaversionen för att kunna använda den här funktionen.

Använd Data Out för att exportera valda HubSpot CRM-data till inbyggda tabeller i ett Microsoft Fabric Warehouse som du äger. Du kan synkronisera objekt-, associations- och händelsedata till tabeller i ditt warehouse och sedan göra sökningar i dessa data med SQL eller använda dem med dina verktyg för affärsintelligens och analys.

Varje synkronisering skapar en fullständig ögonblicksbild av den valda datan. När en synkronisering lyckas ersätter den den tidigare ögonblicksbilden i måltabellerna.

Innan du börjar

Förstå kraven

För att exportera data till Microsoft Fabric behöver du:

• Ett Microsoft Fabric-arbetsområde med ett Fabric-lager
• En Microsoft Entra ID-tjänstprincipal som lagts till i Fabric-arbetsytan med rollen Bidragare
• Tjänsteenhetens tenant-ID, klient-ID och klienthemlighet
• Din SQL-anslutningssträng för Fabric-datalagret (serveradress, utan portnummer) och datalagrets namn

Microsoft Entra ID-tjänsteenheten måste ha behörighet att skapa och hantera HubSpot-ägda objekt i mottagarens Fabric Warehouse. Under anslutningsvalidering och synkroniseringar skapar HubSpot scheman och tabeller, infogar data, byter namn på mellanlagringstabeller och tar bort tillfälliga objekt. Tilldela tjänsteenheten rollen Bidragare i Fabric-arbetsytan för att tillåta HubSpot att:

• Skapa scheman
• Skapa tabeller
• Infoga rader
• Byt namn på eller ändra tabeller som ägs av HubSpot
• Ta bort tabeller och scheman som ägs av HubSpot

Din SQL-ändpunkt för Fabric Warehouse måste vara tillgänglig för HubSpot på TCP-port 1433. HubSpot använder TLS för alla anslutningar och validerar servercertifikatet.

Om ditt Fabric-arbetsområde begränsar nätverksåtkomsten ska du lägga till HubSpots utgående IP-adresser för din kontoregion i tillåtelselistan.

Förstå begränsningar och överväganden

• Microsoft Fabric Data Out stöder endast Fabric Warehouses. Lakehouses stöds inte.
• Varje synkronisering skapar en fullständig ögonblicksbild av de valda uppgifterna. En lyckad synkronisering ersätter den tidigare ögonblicksbilden i måltabellerna. HubSpot behåller inte tidigare ögonblicksbilder. Om en tabell misslyckas under en synkronisering förblir dess tidigare data tillgängliga tills nästa lyckade synkronisering.
• Varje objekttyp, händelsetyp eller associationspar kan inkluderas i en återkommande Microsoft Fabric-synkronisering per konto.
• Varje synkronisering ersätter måltabellen. Behörigheter eller inställningar på tabellnivå som lagts till i ditt Fabric Warehouse bevaras inte mellan synkroniseringarna.
• För att återansluta till en annan tjänsteenhet måste du lägga till den tjänsteenheten i Fabric-arbetsytan med rollen ”Contributor” innan anslutningstestet eller synkroniseringen kan genomföras.

Anslut HubSpot till Microsoft Fabric

Det rekommenderas att du har dina HubSpot-konto- och Microsoft Fabric-konsoler öppna i separata flikar.

1. I ditt HubSpot-konto klickar du på Mer och navigerar sedan till Datahantering > Data Studio. Om Mer inte visas i ditt konto navigerar du direkt till Datahantering > Data Studio.
2. Klicka på Anslut extern datakälla längst upp till höger.
3. I panelen Lägg till en datakälla söker du efter eller bläddrar till Microsoft Fabric.
4. Klicka på Installera och sedan på Nästa.
5. Ange din tjänsteprincipals klient-ID, klient-ID och klienthemlighet.
6. Ange följande destinationsuppgifter:
   • SQL-anslutningssträng: serveradressen till ditt Fabric Warehouse, utan portnumret.
   • Lagernamn: namnet på det Fabric Warehouse som du vill exportera till.
7. Klicka på Testa anslutning. Om anslutningstestet lyckas klickar du på Nästa.

Observera: Kontrollera i din Fabric-arbetsyta att HubSpot-tjänsteenheten har rollen Bidragare innan du kör anslutningstestet. Inga SQL-skript krävs för att konfigurera åtkomsten.

Konfigurera synkroniseringen

1. Välj de datakällor som ska exporteras:
   • Objekt
   • Associationer
   • Händelser
2. Välj de objekt, egenskaper, kopplingar eller händelser som ska inkluderas.
3. Välj hur ofta synkroniseringen ska köras och när den ska startas.
4. Klicka på Starta synkronisering.

De tillgängliga synkroniseringsfrekvenserna kan variera under betatestperioden. Alternativen kan vara en gång, var 6:e timme, var 12:e timme, dagligen, veckovis eller månadsvis.

Kom åt dina exporterade data

HubSpot skapar ett HubSpot-hanterat schema för varje mål. Tabellerna har följande format:

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

Till exempel:

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

Du hittar det exakta schemanamnet på sidan för synkroniseringskonfiguration.

Tabell- och kolumnnamn

HubSpot normaliserar exporterade tabell- och kolumnnamn till versaler, siffror och understreck:

• Mellanslag och bindestreck ersätts med understreck.
• Övriga icke-alfanumeriska tecken tas bort.
• Namn som är längre än 128 tecken förkortas.
• Kolumnnamn som kolliderar får ett suffix.
• Om tabellnamn kolliderar misslyckas den berörda exporten.

Kolumntyper

Kolumnen PROPERTIES i OBJECT_WITH_OBJECT_PROPERTIES lagras som en JSON-formaterad sträng i VARCHAR(MAX), inte som en inbyggd JSON-kolumntyp. Se frågeexemplen i vanliga frågor nedan.

Objekttabeller

Om du väljer objektdata exporterar HubSpot följande tabeller.

OBJECT_PROPERTIES

Denna tabell innehåller en rad för varje objektets egenskapsvärde.

OBJECT_WITH_OBJECT_PROPERTIES

Denna tabell innehåller en rad för varje objektrekord. Valda egenskapsvärden grupperas i kolumnen PROPERTIES.

Objektdata för olika objekttyper sammanförs i denna tabell. Filtrera efter OBJECTTYPEID för att läsa poster för en specifik objekttyp:

• Kontakter: 0–1
• Anpassade objekt: 2-{unique_id}, till exempel 2-12345

OBJECT_PROPERTIES_HISTORY

Denna tabell innehåller historiken över egenskapsändringar. Den innehåller en rad för varje historiskt värde för en egenskap.

För att visa den fullständiga historiken för en specifik post och egenskap, sortera resultaten efter UPDATEDAT.

Associeringstabeller

Om du väljer associationsdata exporterar HubSpot associationsposter och associationsdefinitioner.

ASSOCIATIONS

Denna tabell innehåller en rad för varje vald koppling mellan två poster.

ASSOCIATION_DEFINITIONS

Denna tabell innehåller en rad för varje vald kopplingsdefinition.

Par-specifika kopplingstabeller

För valda kopplingspar kan HubSpot även exportera tabeller med följande format:

ASSOCIATIONS_<FROM_OBJECT_TYPE>_TO_<TO_OBJECT_TYPE>

Till exempel: ASSOCIATIONS_CONTACTS_TO_COMPANIES

Dessa tabeller innehåller kopplingsposter och metadata för kopplingsdefinitioner.

Händelsetabeller

Om du väljer händelsedata exporterar HubSpot en tabell för varje händelsetyp. Namnen på händelsetabellerna har följande format:

EVENTS_<EVENT_NAME>

Till exempel: EVENTS_VISITED_PAGE

Varje händelsetabell innehåller standardkolumner för händelser och en kolumn för varje vald händelseegenskap.

Övervaka din synkronisering

1. I ditt HubSpot-konto klickar du på Mer och navigerar sedan till Datahantering > Data Studio. Om Mer inte visas i ditt konto navigerar du direkt till Datahantering > Data Studio.
2. Klicka på App Syncs till vänster.
3. Sök efter eller välj Microsoft Fabric-synkroniseringen.

Från sidan med synkroniseringsdetaljer kan du se synkroniseringsstatus, tidpunkt för senaste synkronisering, fel, synkroniseringsaktivitet och synkroniseringshistorik. Du kan också pausa, arkivera eller manuellt köra synkroniseringen.

Synkroniseringsstatus

Åtgärda synkroniseringsfel

När en synkronisering misslyckas:

• HubSpot-gränssnittet visar statusen Misslyckades och detaljer på tabellnivå som anger vilka tabeller som lyckades eller misslyckades.
• En tabell uppdateras först när HubSpot har laddat alla dess data. Om en tabell misslyckas kvarstår dess tidigare data tills nästa synkronisering lyckas.
• Vid nästa schemalagda synkronisering försöker systemet automatiskt utföra en fullständig synkronisering igen.
• Du kan köra en synkronisering manuellt från sidan med synkroniseringsdetaljer.

Vanliga frågor

Hur gör jag en sökning i de exporterade uppgifterna?

Fråga tabellerna i målschemat med 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 jag exportera en datatyp i flera synkroniseringar?

Varje objekttyp, händelsetyp eller associationspar kan inkluderas i en återkommande Microsoft Fabric-synkronisering per HubSpot-konto. Detta är oberoende av andra Data Out-leverantörer.

Om kontakter till exempel redan har exporterats till en återkommande Fabric-destination kan du inte lägga till kontakter till en annan återkommande Fabric-konfiguration förrän du har arkiverat den första konfigurationen. Du kan fortfarande exportera kontakter till en annan Data Out-leverantör som stöds samtidigt.

Stöds objektspecifika tabeller?

Objektspecifika tabeller, såsom OBJECTS_CONTACTS, stöds för närvarande inte. Använd OBJECT_WITH_OBJECT_PROPERTIES och filtrera efter OBJECTTYPEID för att hämta poster för en specifik objekttyp.

Stöds känsliga uppgifter?

Känsliga uppgifter stöds för närvarande inte för Data Out. Känsliga egenskaper kan uteslutas från export.

Spara HubSpot tidigare ögonblicksbilder?

Nej. Varje lyckad synkronisering ersätter måltabellen med den senaste ögonblicksbilden. HubSpot behåller inte tidigare ögonblicksbilder. Om en tabell misslyckas under en synkronisering kvarstår dess tidigare data tills tabellen har uppdaterats framgångsrikt.

Använder HubSpot en mellanlagringsbucket som jag hanterar?

Nej. HubSpot skapar en tillfällig Parquet-export i HubSpots lagringsutrymme och skriver resultaten till ditt Fabric Warehouse. Du behöver inte tillhandahålla eller hantera en mellanlagringsbucket.

Vad händer om jag ansluter igen med en annan tjänsteprincipal?

Om du återansluter med en annan tjänsteprincipal måste du lägga till den tjänsteprincipalen i Fabric-arbetsytan med rollen Bidragare innan anslutningstestet eller synkroniseringen kan genomföras.