I betaFå tilgang til HubSpot-dataene dine fra PostgreSQL eller MySQL

Bruk «Data Out» for PostgreSQL og MySQL til å eksportere utvalgte HubSpot CRM-data til tabeller i en database du eier. Hver synkronisering skriver et fullstendig øyeblikksbilde av de valgte dataene og erstatter det forrige øyeblikksbildet. 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 å bruke denne funksjonen, må du sørge for at du fullt ut forstår hvilke tiltak som må iverksettes på forhånd, samt funksjonens begrensninger og mulige konsekvenser av å bruke den.

• Hver synkronisering erstatter destinasjonstabellene med det siste øyeblikksbildet. HubSpot lagrer ikke tidligere øyeblikksbilder.
• Hvert objekt, hver hendelsestype eller hvert tilknytningspar kan inkluderes i én gjentakende PostgreSQL-synkronisering og én gjentakende MySQL-synkronisering per HubSpot-konto. Disse synkroniseringene er uavhengige av hverandre og av andre Data Out-leverandører.
• Sensitive data støttes ikke ennå. Sensitive egenskaper kan ekskluderes fra eksportene.
• Objektspesifikke tabeller, for eksempel OBJECTS_CONTACTS, støttes ikke ennå.
• Tabell- og kolonnenavn er store- og småbokstavssensitive i PostgreSQL og kan være store- og småbokstavssensitive i MySQL. Gjennomgå spørresyntaksen før du skriver spørsmål.

Forstå hvilke data du kan eksportere

Du kan synkronisere følgende data fra HubSpot til PostgreSQL eller MySQL:

• Objekter: standard- og tilpassede objekter, for eksempel kontakter, selskaper, avtaler, billetter og produkter.
• Post: individuelle poster for de valgte objektene.
• Egenskaper: valgte egenskapsverdier og egenskapshistorikk for poster.
• Assosiasjoner: valgte relasjoner mellom poster, inkludert definisjoner av assosiasjoner.
• Hendelser: utvalgte standardhendelser fra HubSpot 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åldatabasen. Dette gjelder kun PostgreSQL. For MySQL oppretter HubSpot databasen.
• Datakildene som skal synkroniseres: objekter, hendelser, tilknytninger eller en kombinasjon av disse kildene.
• Synkroniseringsplanen.

HubSpot eksporterer dataene som Parquet-filer og laster dem direkte inn i tabeller i databasen din. PostgreSQL og MySQL bruker ikke en kundeeid mellomlagringsbucket. HubSpot administrerer mellomlagringen internt.

Finn dataene dine i databasen

HubSpot oppretter én tabell per datakilde i et HubSpot-administrert skjema oppkalt etter destinasjonen din. Du finner det nøyaktige skjemaet på konfigurasjonssiden for synkroniseringen din.

• PostgreSQL: <database>.hubspot_data_out_<destination-id>.<table-name>
• MySQL: hubspot_data_out_<destination-id>.<table-name>. I MySQL er skjema og database det samme begrepet, og HubSpot oppretter det. Det er ikke noe eget databasenivå å velge.

For eksempel i PostgreSQL:

• 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

For eksempel i MySQL:

• hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES
• hubspot_data_out_456.EVENTS_VISITED_PAGE
• hubspot_data_out_456.ASSOCIATIONS_CONTACTS_TO_COMPANIES

Hver synkronisering erstatter tabellen med det nyeste øyeblikksbildet. HubSpot lagrer ikke tidligere øyeblikksbilder. Hvis en tabell mislykkes under en synkronisering, forblir de tidligere dataene på plass inntil neste vellykkede synkronisering.

Tabell- og kolonnenavn

Tabell- og kolonnenavn hentes fra de eksporterte dataene. PostgreSQL-identifikatorer er begrenset til 63 tegn, og MySQL-identifikatorer er begrenset til 64 tegn. HubSpot forkorter lengre navn for å få dem til å passe.

Store og små bokstaver i identifikatorer

Stor og liten bokstav i identifikatorer er viktig. HubSpot oppretter alle tabeller og kolonner med navn i anførselstegn, der stor og liten bokstav beholdes, i store bokstaver, slik at de samsvarer med tabellene i denne artikkelen.

• PostgreSQL: Sett navnene i doble anførselstegn nøyaktig slik det er vist. PostgreSQL konverterer navn uten anførselstegn til små bokstaver, slik at de ikke vil stemme overens.
• MySQL: Bruk bakstrek og følg store og små bokstaver som vist. Om tabellnavn er store- og småbokstavssensitive, avhenger av serverkonfigurasjonen din.

PostgreSQL-eksempel:

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

MySQL-eksempel:

SELECT * FROM `hubspot_data_out_456`.`OBJECT_WITH_OBJECT_PROPERTIES` WHERE `OBJECTTYPEID` = '0-1';

Kolonnetyper

Kolonnetyper følger de eksporterte dataene og tilordnes til PostgreSQL- og MySQL-typer som følger:

Merk: Kolonnen PROPERTIES i OBJECT_WITH_OBJECT_PROPERTIES eksporteres som en streng i JSON-format. Den lagres som TEXT i PostgreSQL eller LONGTEXT i MySQL, 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 betaversjonen kan det være at bare et begrenset antall synkroniseringsfrekvenser er tilgjengelige, for eksempel én gang, hver 6. time, hver 12. time, daglig, ukentlig og månedlig. Flere frekvensalternativer kan bli lagt til i fremtidige utgivelser.

Overvåk synkroniseringer og håndter feil

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

Når en synkronisering mislykkes:

• HubSpot viser statusen «Mislykket» med detaljer for hver enkelt tabell som viser hvilke tabeller som lyktes eller mislyktes.
• En tabell oppdateres først etter at HubSpot er ferdig med å laste inn alle dataene, så du ser aldri en delvis lastet tabell.
• Hvis en tabell mislykkes, forblir de tidligere dataene på plass inntil neste vellykkede synkronisering.
• Den neste planlagte synkroniseringen prøver automatisk på nytt med en fullstendig synkronisering.
• Du kan når som helst utløse en ny synkronisering manuelt i HubSpot.

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

Ofte stilte spørsmål

Hvordan søker jeg i dataene?

Hent data fra tabellene i destinasjonsskjemaet ditt med SQL.

PostgreSQL

Les 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-kolonnen PROPERTIES. Konverter først kolonnen til JSON, siden den er lagret som tekst:

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

Les alle kontaktoppføringer:

SELECT * FROM `hubspot_data_out_456`.`OBJECT_WITH_OBJECT_PROPERTIES` WHERE `OBJECTTYPEID` = '0-1';

Les en bestemt egenskap fra JSON-kolonnen PROPERTIES:

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?

Hvert objekt, hver hendelsestype eller hvert assosiasjonspar kan inkluderes i én gjentakende PostgreSQL-synkronisering og én gjentakende MySQL-synkronisering per HubSpot-konto. Disse synkroniseringene er uavhengige av hverandre og av andre Data Out-leverandører. Hvis kontakter for eksempel allerede er eksportert til en gjentakende PostgreSQL-destinasjon, kan du ikke legge til kontakter i en annen gjentakende PostgreSQL-synkronisering før du arkiverer den første synkroniseringen. Du kan fortsatt eksportere kontakter til en gjentakende MySQL-synkronisering 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.

Støttes sensitive data?

Nei. Sensitive data støttes ikke for Data Out ennå. Sensitive egenskaper kan ekskluderes fra eksportene.

Beholder HubSpot tidligere øyeblikksbilder?

Nei. Hver synkronisering erstatter destinasjonstabellen med det siste øyeblikksbildet, så tidligere øyeblikksbilder lagres ikke.