I betaEksporter HubSpot-data til Microsoft Fabric

Merk: Hvis du er superadministrator,må du melde kontoen din påData Studio-betaversjonen for å kunne bruke denne funksjonen.

Bruk Data Out til å eksportere utvalgte HubSpot CRM-data til innebygde tabeller i et Microsoft Fabric-lager som du eier. Du kan synkronisere objekt-, tilknytnings- og hendelsesdata til tabeller i lageret ditt, og deretter foreta spørringer på disse dataene med SQL eller bruke dem med dine verktøy for forretningsintelligens og analyse.

Hver synkronisering oppretter et fullstendig øyeblikksbilde av de valgte dataene. Når en synkronisering lykkes, erstatter den det forrige øyeblikksbildet i måltabellene.

Før du setter i gang

Forstå kravene

For å eksportere data til Microsoft Fabric trenger du:

• Et Microsoft Fabric-arbeidsområde med et Fabric-lager
• En Microsoft Entra ID-tjenesteenhet lagt til i Fabric-arbeidsområdet med rollen «Contributor»
• Tjenesteenhetens leietaker-ID, klient-ID og klienthemmelighet
• SQL-tilkoblingsstrengen til Fabric-lageret ditt (serveradresse, uten portnummer) og lagernavnet

Microsoft Entra ID-tjenesteenheten må ha tillatelse til å opprette og administrere HubSpot-eide objekter i mottaker-Fabric Warehouse. Under tilkoblingsvalidering og synkroniseringer oppretter HubSpot skjemaer og tabeller, legger inn data, omdøper mellomlagringstabeller og fjerner midlertidige objekter. Gi tjenesteenheten rollen «Contributor» i Fabric-arbeidsområdet for å tillate HubSpot å:

• Opprett skjemaer
• Opprett tabeller
• Sett inn rader
• Gi HubSpot-eide tabeller nytt navn eller endre dem
• Slett HubSpot-eide tabeller og skjemaer

SQL-endepunktet for Fabric Warehouse må være tilgjengelig for HubSpot på TCP-port 1433. HubSpot bruker TLS for alle tilkoblinger og validerer serversertifikatet.

Hvis Fabric-arbeidsområdet ditt begrenser nettverkstilgang, må du legge til HubSpots utgående IP-adresser for kontoregionen din på tillatelseslisten.

Forstå begrensninger og hensyn

• Microsoft Fabric Data Out støtter kun Fabric Warehouses. Lakehouses støttes ikke.
• Hver synkronisering oppretter et fullstendig øyeblikksbilde av de valgte dataene. En vellykket synkronisering erstatter det forrige øyeblikksbildet i måltabellene. HubSpot beholder ikke tidligere øyeblikksbilder. Hvis en tabell mislykkes under en synkronisering, forblir de tidligere dataene tilgjengelige frem til neste vellykkede synkronisering.
• Hver objekttype, hendelsestype eller tilknytningspar kan inkluderes i én gjentakende Microsoft Fabric-synkronisering per konto.
• Hver synkronisering erstatter destinasjonstabellen. Tillatelser eller innstillinger på tabellnivå som er lagt til i Fabric Warehouse, beholdes ikke mellom synkroniseringene.
• For å opprette tilkobling på nytt med en annen tjenesteenhet må du legge til denne tjenesteenheten i Fabric-arbeidsområdet med rollen «Contributor» før tilkoblingstesten eller synkroniseringen kan gjennomføres.

Koble HubSpot til Microsoft Fabric

Det anbefales å ha HubSpot-kontoen og Microsoft Fabric-konsollene åpne i separate faner.

1. I HubSpot-kontoen din klikker du på Mer, og så navigerer du til Databehandling > Data Studio. Hvis Mer ikke vises i kontoen din, navigerer du direkte til Dataadministrasjon > Data Studio.
2. Klikk på «Koble til ekstern datakilde» øverst til høyre.
3. I panelet «Legg til en datakilde » kan du søke etter eller bla til Microsoft Fabric.
4. Klikk på «Installer», og klikk deretter på «Neste».
5. Skriv inn tjenesteenhetens leietaker-ID, klient-ID og klienthemmelighet.
6. Angi følgende destinasjonsdetaljer:
   • SQL-tilkoblingsstreng: serveradressen til Fabric Warehouse, uten portnummeret.
   • Lagernavn: navnet på Fabric Warehouse som du skal eksportere til.
7. Klikk på Test tilkobling. Hvis tilkoblingstesten er vellykket, klikker du på Neste.

Merk: I Fabric-arbeidsområdetmå du bekrefte at HubSpot-tjenesteenheten har rollen «Contributor» før du kjører tilkoblingstesten. Det kreves ingen SQL-skript for å konfigurere tilgang.

Konfigurer synkroniseringen

1. Velg datakildene du vil eksportere:
   • Objekter
   • Assosiasjoner
   • Hendelser
2. Velg objekter, egenskaper, tilknytninger eller hendelser som skal inkluderes.
3. Velg hvor ofte synkroniseringen skal kjøres og når den skal startes.
4. Klikk på Start synkronisering.

De tilgjengelige synkroniseringsfrekvensene kan variere i løpet av betaperioden. Alternativene kan omfatte én gang, hver 6. time, hver 12. time, daglig, ukentlig eller månedlig.

Få tilgang til de eksporterte dataene

HubSpot oppretter et HubSpot-administrert skjema for hvert mål. Tabellene bruker 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 finner det eksakte skjemanavnet på siden for synkroniseringskonfigurasjon.

Tabell- og kolonnenavn

HubSpot normaliserer eksporterte tabell- og kolonnenavn til store bokstaver, tall og understreker:

• Mellomrom og bindestreker blir til understreker.
• Andre tegn som ikke er alfanumeriske, fjernes.
• Navn som er lengre enn 128 tegn, forkortes.
• Kolonnenavn som kolliderer, får et suffiks.
• Kolonnenavn som kolliderer fører til at den berørte eksporten mislykkes.

Kolonnetyper

PROPERTIES -kolonnen i OBJECT_WITH_OBJECT_PROPERTIES lagres som en JSON-formatert streng i VARCHAR(MAX), ikke som en innfødt JSON-kolonnetype. Se spørsmålseksemplene i FAQ-ene nedenfor.

Objekttabeller

Hvis du velger objektdata, eksporterer HubSpot følgende tabeller.

OBJECT_PROPERTIES

Denne tabellen inneholder én rad for hver objekt-egenskapsverdi.

OBJECT_WITH_OBJECT_PROPERTIES

Denne tabellen inneholder én rad for hver objektpost. Valgte egenskapsverdier er gruppert i kolonnen PROPERTIES.

Objektdata for ulike objekttyper er samlet i denne tabellen. Filtrer etter OBJECTTYPEID for å se poster for en bestemt objekttype:

• Kontakter: 0–1
• Egendefinerte objekter: 2-{unique_id}, for eksempel 2-12345

OBJECT_PROPERTIES_HISTORY

Denne tabellen inneholder historikken over endringer i egenskaper. Den inneholder én rad for hver historisk verdi av en egenskap.

For å se hele historikken for en bestemt post og egenskap, sorter resultatene etter UPDATEDAT.

Assosiasjonstabeller

Hvis du velger assosiasjonsdata, eksporterer HubSpot assosiasjonsposter og assosiasjonsdefinisjoner.

ASSOCIATIONS

Denne tabellen inneholder én rad for hver valgt tilknytning mellom to poster.

ASSOCIATION_DEFINITIONS

Denne tabellen inneholder én rad for hver valgt tilknytningsdefinisjon.

Par-spesifikke tilknytningstabeller

For valgte tilknytningspar kan HubSpot også eksportere tabeller med følgende format:

ASSOCIATIONS_<FROM_OBJECT_TYPE>_TO_<TO_OBJECT_TYPE>

For eksempel: ASSOCIATIONS_CONTACTS_TO_COMPANIES

Disse tabellene inneholder tilknytningsposter og metadata for tilknytningsdefinisjoner.

Hendelsestabeller

Hvis du velger hendelsesdata, eksporterer HubSpot én tabell for hver hendelsestype. Navnene på hendelsestabellene har følgende format:

EVENTS_<EVENT_NAME>

For eksempel: EVENTS_VISITED_PAGE

Hver hendelsestabell inneholder standardhendelseskolonner og én kolonne for hver valgt hendelsesegenskap.

Overvåk synkroniseringen

1. I HubSpot-kontoen din klikker du på Mer, og så navigerer du til Databehandling > Data Studio. Hvis Mer ikke vises i kontoen din, navigerer du direkte til Dataadministrasjon > Data Studio.
2. Klikk på App Syncs til venstre.
3. Søk etter eller velg Microsoft Fabric-synkroniseringen.

Fra siden med synkroniseringsdetaljer kan du se synkroniseringsstatus, tidspunkt for siste synkronisering, feil, synkroniseringsaktivitet og synkroniseringshistorikk. Du kan også pause, arkivere eller kjøre synkroniseringen manuelt.

Synkroniseringsstatus

Løs synkroniseringsfeil

Når en synkronisering mislykkes:

• HubSpot-brukergrensesnittet viser statusen «Mislykket» og detaljer på tabellnivå som angir hvilke tabeller som lyktes eller mislyktes.
• En tabell oppdateres først etter at HubSpot har lastet inn alle dataene. Hvis en tabell mislykkes, forblir de forrige dataene på plass inntil neste vellykkede synkronisering.
• Den neste planlagte synkroniseringen forsøker automatisk å utføre full synkronisering på nytt.
• Du kan kjøre en synkronisering manuelt fra siden med synkroniseringsdetaljer.

Ofte stilte spørsmål

Hvordan søker jeg i de eksporterte dataene?

Spør i tabellene i målskjemaet 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, hendelsestype eller assosiasjonspar kan inkluderes i én gjentakende Microsoft Fabric-synkronisering per HubSpot-konto. Dette er uavhengig av andre Data Out-leverandører.

Hvis for eksempel kontakter allerede er eksportert til en gjentakende Fabric-destinasjon, kan du ikke legge til kontakter i en annen gjentakende Fabric-konfigurasjon før du har arkivert den første konfigurasjonen. Du kan fortsatt eksportere kontakter til en annen støttet Data Out-leverandør samtidig.

Støttes objektspesifikke tabeller?

Objektspesifikke tabeller, for eksempel OBJECTS_CONTACTS, støttes foreløpig ikke. Bruk OBJECT_WITH_OBJECT_PROPERTIES og filtrer etter OBJECTTYPEID for å hente poster for en bestemt objekttype.

Støttes sensitive data?

Sensitive Data støttes foreløpig ikke for Data Out. Sensitive egenskaper kan ekskluderes fra eksportene.

Beholder HubSpot tidligere øyeblikksbilder?

Nei. Hver vellykket synkronisering erstatter destinasjonstabellen med det siste øyeblikksbildet. HubSpot lagrer ikke tidligere øyeblikksbilder. Hvis en tabell mislykkes under en synkronisering, forblir de tidligere dataene på plass inntil tabellen er oppdatert.

Bruker HubSpot en mellomlagringsbucket som jeg administrerer?

Nei. HubSpot oppretter en midlertidig Parquet-eksport i HubSpot-administrert lagring og skriver resultatene til Fabric Warehouse. Du trenger ikke å oppgi eller administrere en mellomlagringsbucket.

Hva skjer hvis jeg kobler til på nytt med en annen tjenesteenhet?

Hvis du kobler til på nytt med en annen tjenesteenhet, må du legge til den tjenesteenheten i Fabric-arbeidsområdet med rollen «Contributor» før tilkoblingstesten eller synkroniseringen kan gjennomføres.