Eksporter HubSpot-data til PostgreSQL eller MySQL

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

Sammendrag

Bruk Data Out til å eksportere utvalgte HubSpot CRM-data til en PostgreSQL- eller MySQL-database som du administrerer. Du kan synkronisere objekt-, tilknytnings- og hendelsesdata til tabeller i databasen din, og deretter foreta søk i dataene med SQL eller bruke dem med dine verktøy for forretningsinformasjon 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

• PostgreSQL- eller MySQL-databasen din må være tilgjengelig fra HubSpot-IP-områdene for regionen til kontoen din.
• Databaseserveren din må støtte SSL-tilkoblinger.
• Du må ha en databasebruker med de nødvendige tillatelsene:
  • PostgreSQL: CREATE -rettighet og skrivetilgang til målskjemaet.
  • MySQL: CREATE -rettighet til databasen og skriveadgang.
• Sørg for at databasebrukeren din kan opprette tabeller og skrive inn data.
• Hold HubSpot-kontoen og databasekonsollene åpne i separate faner.

Tillat HubSpot-IP-adresser

Legg til HubSpot-IP-området for din kontoregion på tillatelseslisten til databaseserveren din.

Forstå begrensninger og hensyn

• Hver synkronisering oppretter et fullstendig øyeblikksbilde av de valgte dataene.
• En vellykket synkronisering erstatter det forrige øyeblikksbildet i måltabellene.
• HubSpot lagrer ikke tidligere øyeblikksbilder.
• Hvis en tabell mislykkes under en synkronisering, forblir de forrige dataene tilgjengelige frem til neste vellykkede synkronisering.
• Hver objekttype, hendelsestype eller tilknytningspar kan inkluderes i én gjentakende PostgreSQL-synkronisering og én gjentakende MySQL-synkronisering per konto.
• Hver synkronisering erstatter destinasjonstabellen. Tillatelser eller innstillinger på tabellnivå som er lagt til i databaseleverandøren din, beholdes ikke mellom synkroniseringene.
• Hvis du kobler deg til på nytt med en annen databasebruker, må du gi denne brukeren tilgang til eksisterende HubSpot-administrerte skjemaer, databaser eller tabeller.

Koble HubSpot til PostgreSQL eller MySQL

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 gjennom for å finne databaseleverandøren.
4. Klikk på PostgreSQL eller MySQL.
5. Skriv inn opplysningene for databasetilkoblingen:
   • Vert
   • Port
   • SSL
   • Brukernavn
   • Passord
6. For PostgreSQL angir du navnet på databasen der HubSpot skal opprette skjemaet.
7. Klikk på «Koble til PostgreSQL » eller «Koble til MySQL».

HubSpot bruker den tilkoblede databasebrukeren til å opprette tabeller og laste inn data i databasen din.

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 under betatesten. 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 eller en database for hvert mål.

PostgreSQL

PostgreSQL-tabeller 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"

MySQL

MySQL-tabeller bruker følgende format:

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

For eksempel:

hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES
hubspot_data_out_456.EVENTS_VISITED_PAGE
hubspot_data_out_456.ASSOCIATIONS_CONTACTS_TO_COMPANIES

Du finner det nøyaktige skjemaet eller databasenavnet på synkroniseringskonfigurasjonssiden.

Tabell- og kolonnenavn

Tabell- og kolonnenavn er basert på de eksporterte dataene. PostgreSQL-identifikatorer kan inneholde opptil 63 tegn. MySQL-identifikatorer kan inneholde opptil 64 tegn. Lengre navn forkortes for å passe innenfor den gjeldende grensen.

HubSpot oppretter PostgreSQL-tabeller og -kolonner med navn i anførselstegn og med bevart store og små bokstaver. Når du sender spørsmål til PostgreSQL, må du bruke doble anførselstegn og følge store og små bokstaver slik de vises i tabell- og kolonnenavnet.

For MySQL må du bruke bakstrek og følge den store og små bokstavbruken som vises. Hvorvidt det skilles mellom store og små bokstaver i tabellnavn, kan variere avhengig av konfigurasjonen av MySQL-serveren din.

Kolonnetyper

PROPERTIES -kolonnen i tabellen OBJECT_WITH_OBJECT_PROPERTIES lagres som en streng i JSON-format. Den lagres som TEXT i PostgreSQL og LONGTEXT i MySQL, ikke som en innfødt JSON-kolonnetype.

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 samles 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 å vise 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 assosiasjonsposter og metadata for assosiasjonsdefinisjoner.

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 Dataadministrasjon > Dataintegrering. Hvis Mer ikke vises i kontoen din, navigerer du direkte til Dataadministrasjon > Dataintegrering.
2. Klikk på App-synkroniseringer til venstre.
3. Søk etter eller velg PostgreSQL- eller MySQL-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 tidligere 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.

Tabeller som ble synkronisert uten problemer under en tidligere kjøring, endres ikke når en senere kjøring mislykkes.

Ofte stilte spørsmål

Hvordan kan jeg søke i de eksporterte dataene?

Spør i tabellene i målskjemaet eller -databasen med SQL.

PostgreSQL

-- Read all contact records
SELECT *
FROM your_database.hubspot_data_out_456."OBJECT_WITH_OBJECT_PROPERTIES"
WHERE "OBJECTTYPEID" = '0-1';

-- Read a property from the PROPERTIES column
SELECT
  "OBJECTID",
  json_extract_path_text("PROPERTIES"::json, 'email') AS email
FROM your_database.hubspot_data_out_456."OBJECT_WITH_OBJECT_PROPERTIES"
WHERE "OBJECTTYPEID" = '0-1';

MySQL

-- Read all contact records
SELECT *
FROM `hubspot_data_out_456`.`OBJECT_WITH_OBJECT_PROPERTIES`
WHERE `OBJECTTYPEID` = '0-1';

-- Read a property from the PROPERTIES column
SELECT
  `OBJECTID`,
  JSON_EXTRACT(`PROPERTIES`, '$.email') AS email
FROM `hubspot_data_out_456`.`OBJECT_WITH_OBJECT_PROPERTIES`
WHERE `OBJECTTYPEID` = '0-1';

Kan jeg eksportere én datatype i flere synkroniseringer?

Hver objekttype, hendelsestype eller tilknytningspar kan inkluderes i én gjentakende PostgreSQL-synkronisering og én gjentakende MySQL-synkronisering per HubSpot-konto.

Hvis for eksempel kontakter allerede er eksportert til en gjentakende PostgreSQL-destinasjon, kan du ikke legge til kontakter i en annen gjentakende PostgreSQL-konfigurasjon før du har arkivert den første konfigurasjonen. Du kan fortsatt eksportere kontakter til en gjentakende MySQL-konfigurasjon 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.

Oppbevarer 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 eksporterer dataene som Parquet og administrerer mellomlagringen internt. Du trenger ikke å oppgi en kundeeid mellomlagringsbucket for PostgreSQL eller MySQL.

Hva skjer hvis jeg endrer databasebrukeren?

Hvis du kobler til på nytt med en annen databasebruker, må du gi den nye brukeren tilgang til eksisterende HubSpot-administrerte skjemaer, databaser eller tabeller.