I betaFå tilgang til HubSpot-dataene dine fra Microsoft Azure Synapse Analytics

Bruk «Data Out for Azure Synapse» til å eksportere utvalgte HubSpot CRM-data til tabeller i en dedikert SQL-pool i Azure Synapse som du eier. HubSpot oppdaterer hver utdatatabell basert på en fullstendig eksport av de valgte dataene. Etter synkroniseringen kan du foreta søk i tabellene med SQL eller med dine foretrukne BI- og analyseverktøy for å kombinere HubSpot-data med andre forretningsdata.

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

Forstå begrensninger og hensyn

Før du begynner å jobbe med denne funksjonen, må du sørge for at du fullt ut forstår hvilke trinn som må tas på forhånd, samt funksjonens begrensninger og potensielle konsekvenser av å bruke den.

• HubSpot oppdaterer tabeller separat. Hvis du foretar en søk på tvers av flere tabeller mens en synkronisering pågår, kan det hende at noen tabeller oppdateres før andre.
• Data Out tilbyr ikke lagring av historiske øyeblikksbilder. Etter en vellykket oppdatering inneholder måltabellen det siste øyeblikksbildet.
• Hvert objekt, hver hendelsestype eller hvert tilknytningspar kan inkluderes i én gjentakende Azure Synapse-synkronisering per HubSpot-konto. Denne begrensningen er uavhengig av andre Data Out-leverandører.
• Objektspesifikke tabeller, for eksempel OBJECTS_CONTACTS, støttes ikke ennå.
• Hvis to tabellnavn kolliderer etter at HubSpot har normalisert dem, mislykkes den berørte eksporten. For mer informasjon, se reglene for tabell- og kolonnenavn.

Forstå hvilke data du kan eksportere

Du kan synkronisere følgende data fra HubSpot til Azure Synapse Analytics:

• Objekter og poster: utvalgte standard- og tilpassede objekter og deres poster, for eksempel kontakter, selskaper, avtaler, billetter og produkter.
• Egenskaper: utvalgte egenskapsverdier og egenskapshistorikk for poster.
• Assosiasjoner: utvalgte relasjoner mellom poster, inkludert definisjoner av assosiasjoner.
• Hendelser: utvalgte standard HubSpot-hendelser og tilpassede atferdshendelser, inkludert utvalgte hendelsesegenskaper.

Data for ulike objekter er samlet i objekttabellene. Når du leser en objekttabell, bruker du OBJECTTYPEID til å filtrere etter et bestemt objekt. For eksempel bruker kontakter 0-1. Tilpassede objekter tildeles en ID når de opprettes og identifiseres som 2-{unique_id}, for eksempel 2-12345.

Forstå eksportformatet

Under oppsettet velger du:

• Målet: Det dedikerte SQL-endepunktet og databasen i Azure Synapse.
• Datakildene som skal synkroniseres: objekter, hendelser, tilknytninger eller en kombinasjon av disse kildene.
• Synkroniseringsplanen.

HubSpot oppretter en midlertidig Parquet-eksport i HubSpot-administrert lagring og skriver resultatene til tabeller i din dedikerte SQL-pool i Azure Synapse. Du trenger ikke å oppgi eller administrere en mellomlagringsbøtte.

Finn dataene dine i Azure Synapse

HubSpot oppretter utdatatabeller i et HubSpot-administrert skjema for destinasjonen din. HubSpot eksporterer objektdata til de tre objekttabellene som er beskrevet i denne artikkelen. HubSpot oppretter også én tabell per valgt hendelsestype og, når det er tilgjengelig, én parspesifikk tabell per valgt assosiasjonspar.

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

Du finner det nøyaktige skjemanavnet på konfigurasjonssiden for synkroniseringen din. 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

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.
• Tabellnavn som kolliderer fører til at den berørte eksporten mislykkes.

Bruk firkantparenteser når du søker etter identifikatorer, spesielt hvis du konstruerer spørringer dynamisk. Om identifikatorer er store- og småbokstavssensitive, avhenger av sorteringsreglene i Synapse-databasen din. For eksempel:

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

Kolonnetyper

Kolonnetyper følger de eksporterte dataene og tilordnes til Azure Synapse-typer som følger:

Merk: PROPERTIES kolonnen i OBJECT_WITH_OBJECT_PROPERTIES eksporteres som en JSON-formatert streng. Den lagres som NVARCHAR(MAX), ikke som en JSON-kolonnetype. Se FAQ-ene for eksempler på spørringer.

Gjennomgå objekttabeller

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

OBJECT_PROPERTIES

Denne tabellen inneholder én rad per egenskapsverdi. For å lese et bestemt objekt, filtrer etter OBJECTTYPEID.

OBJECT_WITH_OBJECT_PROPERTIES

Denne tabellen inneholder én rad per post, der de valgte egenskapsverdiene er gruppert i én enkelt PROPERTIES. For å lese et bestemt objekt, filtrer etter OBJECTTYPEID.

OBJECT_PROPERTIES_HISTORY

Denne tabellen inneholder historikken over endringer i egenskaper. I motsetning til OBJECT_PROPERTIES, som kun inneholder den gjeldende verdien, har denne tabellen én rad for hver historisk verdi av en egenskap. For å se den fullstendige tidslinjen for en enkelt post og egenskap, sorter etter UPDATEDAT.

Gjennomgå tilknytningstabeller

Hvis du velger tilknytningsdata, eksporterer HubSpot tilknytningsposter og tilknytningsdefinisjoner.

ASSOCIATIONS

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

ASSOCIATION_DEFINITIONS

Denne tabellen inneholder én rad per valgt tilknytningsdefinisjon.

ASSOCIATIONS_<FRA_OBJEKT>_TIL_<TIL_OBJEKT>

For valgte tilknytningspar kan HubSpot også eksportere parspesifikke tilknytningstabeller, for eksempel ASSOCIATIONS_CONTACTS_TO_COMPANIES. Disse tabellene inneholder tilknytningsposter sammen med metadata for tilknytningsdefinisjoner.

Gjennomgå hendelsestabeller

Hvis du velger hendelsesdata, eksporterer HubSpot én tabell per hendelsestype. Tabellnavnene har formatet EVENTS_<EVENT_NAME>, for eksempel EVENTS_VISITED_PAGE.

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

Administrer synkroniseringsplanen

Du konfigurerer synkroniseringsplanen under oppsettet i HubSpot. Du kan også utløse en ny synkronisering manuelt fra HubSpot. Hver synkroniseringskjøring gir et fullstendig øyeblikksbilde av de valgte dataene. For å kontrollere datamengden velger du hvilke objekter, hendelser, tilknytninger og egenskaper som skal inkluderes.

Merk: I løpet av betaperioden kan tilgjengelige synkroniseringsfrekvenser være begrenset. Flere frekvensalternativer kan bli lagt til i fremtidige utgivelser.

Overvåk synkroniseringer og håndter feil

Du kan overvåke Azure Synapse-synkroniseringer i HubSpot. En synkronisering kan ha en av følgende tilstander:

Når en synkronisering mislykkes:

• HubSpot viser statusen «Mislykket» med detaljer om hvilke tabeller som ble fullført eller mislyktes.
• Hvis en tabell ikke kan oppdateres, forblir de forrige vellykkede dataene vanligvis tilgjengelige.
• For gjentatte synkroniseringer vil den neste planlagte synkroniseringen automatisk prøve på nytt med en fullstendig synkronisering.
• Du kan når som helst utløse en ny synkronisering manuelt i HubSpot.

Ofte stilte spørsmål

Hvordan søker jeg i dataene?

Spørr tabellene i destinasjonsskjemaet ditt med SQL. Les for eksempel alle kontaktoppføringer:

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

Les en bestemt egenskap fra JSON-strengen 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 jeg eksportere én datatype i flere synkroniseringer?

Hvert objekt, hver hendelsestype eller hvert assosiasjonspar kan inkluderes i én gjentakende Azure Synapse-synkronisering per HubSpot-konto. Denne begrensningen er uavhengig av andre Data Out-leverandører.

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

Støttes objektspesifikke tabeller?

Nei. Objektspesifikke tabeller, for eksempel OBJECTS_CONTACTS, støttes ikke ennå. Bruk OBJECT_WITH_OBJECT_PROPERTIES og filtrer etter OBJECTTYPEID for å hente poster for et bestemt objekt.

Oppbevarer HubSpot tidligere øyeblikksbilder?

Nei. Data Out tilbyr ikke lagring av historiske øyeblikksbilder. Etter en vellykket oppdatering inneholder destinasjonstabellen det siste øyeblikksbildet. Hvis en tabell ikke kan oppdateres, forblir de tidligere vellykkede dataene vanligvis tilgjengelige.