I betaEksporter HubSpot-data til Microsoft Fabric

Bemærk: Hvis du er superadministrator,skal du tilmelde din konto tilData Studio-betaversionen for at kunne bruge denne funktion.

Brug Data Out til at eksportere udvalgte HubSpot CRM-data til native tabeller i et Microsoft Fabric Warehouse, som du ejer. Du kan synkronisere objekt-, tilknytnings- og begivenhedsdata til tabeller i dit warehouse og derefter forespørge på disse data med SQL eller bruge dem sammen med dine business intelligence- og analyseværktøjer.

Hver synkronisering opretter et fuldstændigt øjebliksbillede af de valgte data. Når en synkronisering lykkes, erstatter den det forrige øjebliksbillede i måltabellerne.

Før du går i gang

Forstå kravene

For at eksportere data til Microsoft Fabric skal du have følgende:

• Et Microsoft Fabric-arbejdsområde med et Fabric-lager
• En Microsoft Entra ID-tjenesteenhed tilføjet til Fabric-arbejdsområdet med rollen "Contributor"
• Serviceprincipalens tenant-ID, klient-ID og klienthemmelighed
• Din SQL-forbindelsesstreng til Fabric-lageret (serveradresse uden portnummer) og lagernavn

Microsoft Entra ID-tjenesteenheden skal have tilladelse til at oprette og administrere HubSpot-ejede objekter i det pågældende Fabric Warehouse. Under forbindelsesvalidering og synkroniseringer opretter HubSpot skemaer og tabeller, indsætter data, omdøber mellemliggende tabeller og fjerner midlertidige objekter. Tildel tjenesteenheden rollen "Contributor" i Fabric-arbejdsområdet, så HubSpot kan:

• Opret skemaer
• Opret tabeller
• Indsæt rækker
• Omdøb eller rediger HubSpot-ejede tabeller
• Slet HubSpot-ejede tabeller og skemaer

Dit Fabric Warehouse SQL-endpoint skal være tilgængeligt for HubSpot på TCP-port 1433. HubSpot bruger TLS til alle forbindelser og validerer servercertifikatet.

Hvis dit Fabric-arbejdsområde begrænser netværksadgangen, skal du tilføje HubSpots udgående IP-adresser for din kontoregion til tilladelseslisten.

Forstå begrænsninger og overvejelser

• Microsoft Fabric Data Out understøtter kun Fabric Warehouses. Lakehouses understøttes ikke.
• Hver synkronisering skaber et fuldt øjebliksbillede af de valgte data. En vellykket synkronisering erstatter det forrige øjebliksbillede i destinationstabellerne. HubSpot gemmer ikke tidligere øjebliksbilleder. Hvis en tabel fejler under en synkronisering, forbliver de tidligere data tilgængelige indtil den næste vellykkede synkronisering.
• Hver objekttype, begivenhedstype eller associeringspar kan inkluderes i én tilbagevendende Microsoft Fabric-synkronisering pr. konto.
• Hver synkronisering erstatter destinationstabellen. Tilladelser eller indstillinger på tabelniveau, der er tilføjet i dit Fabric Warehouse, bevares ikke mellem synkroniseringerne.
• For at genoprette forbindelsen til en anden serviceprincipal skal denne serviceprincipal tilføjes til Fabric-arbejdsområdet med rollen »Contributor«, før forbindelsestesten eller synkroniseringen kan gennemføres.

Forbind HubSpot til Microsoft Fabric

Det anbefales at have din HubSpot-konto og Microsoft Fabric-konsollerne åbne i separate faner.

1. Klik på Mere på din HubSpot-konto, og navigér derefter til Datastyring > Data Studio. Hvis Mere ikke vises på din konto, skal du navigere direkte til Datastyring > Data Studio.
2. Klik på Tilslut ekstern datakilde øverst til højre.
3. I panelet Tilføj en datakilde skal du søge efter eller navigere til Microsoft Fabric.
4. Klik på "Installer", og klik derefter på " Næste".
5. Indtast din serviceprincipals lejer-id, klient-id og klienthemmelighed.
6. Indtast følgende destinationsoplysninger:
   • SQL-forbindelsesstreng: serveradressen til dit Fabric Warehouse uden portnummeret.
   • Warehouse-navn: navnet på det Fabric Warehouse, der skal eksporteres til.
7. Klik på Test forbindelse. Hvis forbindelsestesten lykkes, skal du klikke på Næste.

Bemærk: I dit Fabric-arbejdsområdeskal du kontrollere, at HubSpot-tjenesteprincippet har rollen Bidragyder, inden du kører forbindelsestesten. Der kræves ingen SQL-scripts for at konfigurere adgangen.

Konfigurer synkroniseringen

1. Vælg de datakilder, der skal eksporteres:
   • Objekter
   • Forbindelser
   • Begivenheder
2. Vælg de objekter, egenskaber, tilknytninger eller begivenheder, der skal medtages.
3. Vælg, hvor ofte synkroniseringen skal køre, og hvornår den skal startes.
4. Klik på Start synkronisering.

De tilgængelige synkroniseringsfrekvenser kan variere under betafasen. Valgmulighederne kan omfatte én gang, hver 6. time, hver 12. time, dagligt, ugentligt eller månedligt.

Få adgang til dine eksporterede data

HubSpot opretter et HubSpot-administreret skema for hver destination. Tabellerne har følgende format:

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

For eksempel:

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 kan finde det nøjagtige skema-navn på siden med synkroniseringsindstillinger.

Tabel- og kolonnenavne

HubSpot normaliserer eksporterede tabel- og kolonnenavne til store bogstaver, tal og understregninger:

• Mellemrum og bindestreger bliver til understregninger.
• Andre ikke-alfanumeriske tegn fjernes.
• Navne, der er længere end 128 tegn, forkortes.
• Kolonnenavne, der kolliderer, får et suffiks.
• Kolonnenavne, der er i konflikt, medfører, at den pågældende eksport mislykkes.

Kolonnetyper

Kolonnen PROPERTIES i OBJECT_WITH_OBJECT_PROPERTIES gemmes som en JSON-formateret streng i VARCHAR(MAX), ikke som en indbygget JSON-kolonnetype. Se forespørgsels-eksemplerne i FAQ'en nedenfor.

Objekttabeller

Hvis du vælger objektdata, eksporterer HubSpot følgende tabeller.

OBJECT_PROPERTIES

Denne tabel indeholder én række for hver objekt-egenskabsværdi.

OBJECT_WITH_OBJECT_PROPERTIES

Denne tabel indeholder én række for hver objektpost. De valgte egenskabsværdier er grupperet i kolonnen PROPERTIES.

Objektdata for forskellige objekttyper samles i denne tabel. Filtrer efter OBJECTTYPEID for at se poster for en bestemt objekttype:

• Kontakter: 0-1
• Brugerdefinerede objekter: 2-{unique_id}, f.eks. 2-12345

OBJECT_PROPERTIES_HISTORY

Denne tabel indeholder historikken over ændringer i egenskaber. Den indeholder én række for hver historisk værdi af en egenskab.

For at se den fulde historik for en bestemt post og egenskab skal du sortere resultaterne efter UPDATEDAT.

Associeringstabeller

Hvis du vælger tilknytningsdata, eksporterer HubSpot tilknytningsposter og tilknytningsdefinitioner.

ASSOCIATIONS

Denne tabel indeholder én række for hver valgt tilknytning mellem to poster.

ASSOCIATION_DEFINITIONS

Denne tabel indeholder én række for hver valgt tilknytningsdefinition.

Par-specifikke tilknytningstabeller

For udvalgte forbindelsespar kan HubSpot også eksportere tabeller i følgende format:

ASSOCIATIONS_<FROM_OBJECT_TYPE>_TO_<TO_OBJECT_TYPE>

For eksempel: ASSOCIATIONS_CONTACTS_TO_COMPANIES

Disse tabeller indeholder associeringsposter og metadata om associeringsdefinitioner.

Begivenhedstabeller

Hvis du vælger begivenhedsdata, eksporterer HubSpot én tabel for hver begivenhedstype. Navnene på begivenhedstabellerne følger dette format:

EVENTS_<EVENT_NAME>

For eksempel: EVENTS_VISITED_PAGE

Hver begivenhedstabel indeholder standardbegivenhedskolonner og én kolonne for hver valgt begivenhedsegenskab.

Overvåg din synkronisering

1. Klik på Mere på din HubSpot-konto, og navigér derefter til Datastyring > Data Studio. Hvis Mere ikke vises på din konto, skal du navigere direkte til Datastyring > Data Studio.
2. Klik på App-synkroniseringer til venstre.
3. Søg efter eller vælg Microsoft Fabric-synkroniseringen.

Fra siden med synkroniseringsoplysninger kan du se synkroniseringsstatus, tidspunkt for sidste synkronisering, fejl, synkroniseringsaktivitet og synkroniseringshistorik. Du kan også sætte synkroniseringen på pause, arkivere den eller køre den manuelt.

Synkroniseringsstatusser

Løs synkroniseringsfejl

Når en synkronisering mislykkes:

• HubSpot-brugergrænsefladen viser statusen " Mislykket " samt detaljer på tabelniveau, der angiver, hvilke tabeller der lykkedes eller mislykkedes.
• En tabel opdateres først, når HubSpot er færdig med at indlæse alle dens data. Hvis en tabel mislykkes, forbliver de tidligere data på plads indtil den næste vellykkede synkronisering.
• Den næste planlagte synkronisering forsøger automatisk at udføre den fulde synkronisering igen.
• Du kan køre en synkronisering manuelt fra siden med synkroniseringsdetaljer.

Ofte stillede spørgsmål

Hvordan forespørger jeg de eksporterede data?

Forespørg tabellerne i destinationsskemaet 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 jeg eksportere én datatype i flere synkroniseringer?

Hver objekttype, hændelsestype eller associeringspar kan inkluderes i én tilbagevendende Microsoft Fabric-synkronisering pr. HubSpot-konto. Dette er uafhængigt af andre Data Out-udbydere.

Hvis kontakter f.eks. allerede er eksporteret til en tilbagevendende Fabric-destination, kan du ikke tilføje kontakter til en anden tilbagevendende Fabric-konfiguration, før du arkiverer den første konfiguration. Du kan stadig eksportere kontakter til en anden understøttet Data Out-udbyder på samme tid.

Understøttes objektspecifikke tabeller?

Objektspecifikke tabeller, såsom OBJECTS_CONTACTS, understøttes ikke i øjeblikket. Brug OBJECT_WITH_OBJECT_PROPERTIES og filtrer efter OBJECTTYPEID for at hente poster for en bestemt objekttype.

Understøttes følsomme data?

Følsomme data understøttes ikke i øjeblikket til Data Out. Følsomme egenskaber kan udelades fra eksport.

Gemmer HubSpot tidligere øjebliksbilleder?

Nej. Hver vellykket synkronisering erstatter destinationstabellen med det seneste øjebliksbillede. HubSpot gemmer ikke tidligere øjebliksbilleder. Hvis en tabel fejler under en synkronisering, forbliver de tidligere data på plads, indtil tabellen er blevet opdateret korrekt.

Bruger HubSpot en staging-bucket, som jeg administrerer?

Nej. HubSpot opretter en midlertidig Parquet-eksport i HubSpots administrerede lager og skriver resultaterne til dit Fabric Warehouse. Du behøver ikke at stille en mellemliggende bucket til rådighed eller administrere den.

Hvad sker der, hvis jeg opretter forbindelse igen med en anden serviceprincipal?

Hvis du opretter forbindelse igen med en anden serviceprincipal, skal du tilføje denne serviceprincipal til Fabric-arbejdsområdet med rollen Bidragyder, før forbindelsestesten eller synkroniseringen kan gennemføres.