I betaFå adgang til dine HubSpot-data fra PostgreSQL eller MySQL

Brug »Data Out« til PostgreSQL og MySQL til at eksportere udvalgte HubSpot CRM-data til tabeller i en database, som du ejer. Hver synkronisering skriver et fuldstændigt øjebliksbillede af de valgte data og erstatter det forrige øjebliksbillede. Efter synkroniseringen kan du forespørge tabellerne med SQL eller med dine foretrukne BI- og analyseværktøjer for at kombinere HubSpot-data med andre forretningsdata.

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

Forstå begrænsninger og overvejelser

Inden du begynder at arbejde med denne funktion, skal du sikre dig, at du fuldt ud forstår, hvilke skridt der skal tages på forhånd, samt funktionens begrænsninger og de potentielle konsekvenser af at bruge den.

• Hver synkronisering erstatter destinationstabellerne med det seneste øjebliksbillede. HubSpot gemmer ikke tidligere øjebliksbilleder.
• Hvert objekt, hver begivenhedstype eller hvert associeringspar kan inkluderes i én tilbagevendende PostgreSQL-synkronisering og én tilbagevendende MySQL-synkronisering pr. HubSpot-konto. Disse synkroniseringer er uafhængige af hinanden og af andre Data Out-udbydere.
• Følsomme data understøttes endnu ikke. Følsomme egenskaber kan udelades fra eksporten.
• Objektspecifikke tabeller, såsom OBJECTS_CONTACTS, understøttes endnu ikke.
• Tabel- og kolonnenavne er store- og småbogstavsfølsomme i PostgreSQL og kan være store- og småbogstavsfølsomme i MySQL. Gennemgå forespørgselssyntaksen, før du skriver forespørgsler.

Forstå de data, du kan eksportere

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

• Objekter: standard- og brugerdefinerede objekter, såsom kontakter, virksomheder, aftaler, tickets og produkter.
• Poster: individuelle poster for de valgte objekter.
• Egenskaber: valgte egenskabsværdier og egenskabshistorik for poster.
• Forbindelser: udvalgte relationer mellem poster, herunder definitioner af forbindelser.
• Begivenheder: udvalgte standardbegivenheder fra HubSpot og brugerdefinerede adfærdsbegivenheder, herunder udvalgte begivenhedsegenskaber.

Data for forskellige objekter samles i objekttabellerne. Når du læser en objekttabel, skal du bruge OBJECTTYPEID til at filtrere efter et bestemt objekt. For eksempel bruger kontakter 0-1. Brugerdefinerede objekter tildeles et ID, når de oprettes, og identificeres som 2-{unique_id}, f.eks. 2-12345.

Forstå eksportformatet

Under opsætningen vælger du:

• Mål-databasen. Dette gælder kun for PostgreSQL. For MySQL opretter HubSpot databasen.
• De datakilder, der skal synkroniseres: objekter, begivenheder, tilknytninger eller en kombination af disse kilder.
• Synkroniseringsplanen.

HubSpot eksporterer dataene som Parquet-filer og indlæser dem direkte i tabeller i din database. PostgreSQL og MySQL bruger ikke en kundeejet staging-bucket. HubSpot administrerer staging internt.

Find dine data i din database

HubSpot opretter én tabel pr. datakilde i et HubSpot-administreret skema, der er opkaldt efter din destination. Du kan finde det nøjagtige skema-navn på konfigurationssiden for din synkronisering.

• PostgreSQL: <database>.hubspot_data_out_<destination-id>.<table-name>
• MySQL: hubspot_data_out_<destination-id>.<table-name>. I MySQL er skema og database det samme begreb, og HubSpot opretter det. Der er ikke noget separat databaseniveau at vælge.

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 seneste snapshot. HubSpot gemmer ikke tidligere snapshots. Hvis en tabel fejler under en synkronisering, forbliver de tidligere data på plads indtil den næste vellykkede synkronisering.

Tabel- og kolonnenavne

Tabel- og kolonnenavne stammer fra de eksporterede data. PostgreSQL-identifikatorer er begrænset til 63 tegn, og MySQL-identifikatorer er begrænset til 64 tegn. HubSpot forkorter længere navne, så de passer.

Stor- og småbogstaver i identifikatorer

Stor- og småbogstaver i identifikatorer er vigtige. HubSpot opretter alle tabeller og kolonner med navne i anførselstegn, hvor store og små bogstaver bevares, svarende til tabellerne i denne artikel.

• PostgreSQL: Sæt navnene i dobbelte anførselstegn nøjagtigt som vist. PostgreSQL konverterer navne uden anførselstegn til små bogstaver, så de vil ikke matche.
• MySQL: Brug backticks, og sørg for, at store og små bogstaver stemmer overens med det viste. Om der skelnes mellem store og små bogstaver i tabelnavne afhænger af din serverkonfiguration.

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 eksporterede data og kortlægges til PostgreSQL- og MySQL-typer som følger:

Bemærk: Kolonnen PROPERTIES i OBJECT_WITH_OBJECT_PROPERTIES eksporteres som en streng i JSON-format. Den gemmes som TEXT i PostgreSQL eller LONGTEXT i MySQL, ikke som en JSON-kolonnetype. Se FAQ'en for eksempler på forespørgsler.

Gennemgå objekttabeller

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

OBJECT_PROPERTIES

Denne tabel indeholder én række pr. egenskabsværdi. For at læse et specifikt objekt skal du filtrere efter OBJECTTYPEID.

OBJECT_WITH_OBJECT_PROPERTIES

Denne tabel indeholder én række pr. post, hvor de valgte egenskabsværdier er samlet i en enkelt PROPERTIES. For at læse et bestemt objekt skal du filtrere efter OBJECTTYPEID.

OBJECT_PROPERTIES_HISTORY

Denne tabel indeholder historikken for ændringer af egenskaber. I modsætning til OBJECT_PROPERTIES, som kun indeholder den aktuelle værdi, har denne tabel én række for hver historisk værdi af en egenskab. For at se den fulde tidslinje for en enkelt post og egenskab skal du sortere efter UPDATEDAT.

Gennemse tilknytningstabeller

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

ASSOCIATIONS

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

ASSOCIATION_DEFINITIONS

Denne tabel indeholder én række pr. valgt tilknytningsdefinition.

ASSOCIATIONS_<FROM_OBJECT>_TO_<TO_OBJECT>

For valgte forbindelsespar kan HubSpot også eksportere parspecifikke forbindelsestabeller, såsom ASSOCIATIONS_CONTACTS_TO_COMPANIES. Disse tabeller indeholder forbindelsesposter sammen med metadata om forbindelsesdefinitioner.

Gennemse begivenhedstabeller

Hvis du vælger begivenhedsdata, eksporterer HubSpot én tabel pr. begivenhedstype. Tabelnavne følger formatet EVENTS_<EVENT_NAME>, f.eks. EVENTS_VISITED_PAGE.

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

Administrer synkroniseringsplanen

Du konfigurerer synkroniseringsplanen under opsætningen i HubSpot. Du kan også manuelt udløse en ny synkronisering fra HubSpot. Hver synkroniseringskørsel genererer et fuldstændigt øjebliksbillede af de valgte data. For at kontrollere datamængden skal du vælge, hvilke objekter, begivenheder, tilknytninger og egenskaber der skal medtages.

Bemærk: I betafasen er der muligvis kun et begrænset antal synkroniseringsfrekvenser tilgængelige, f.eks. én gang, hver 6. time, hver 12. time, dagligt, ugentligt og månedligt. Der kan tilføjes yderligere frekvensindstillinger i fremtidige udgivelser.

Overvåg synkroniseringer og håndter fejl

Du kan overvåge PostgreSQL- og MySQL-synkroniseringer i HubSpot. En synkronisering kan have en af følgende tilstande:

Når en synkronisering mislykkes:

• HubSpot viser statusen " Mislykket " med detaljer for hver tabel, 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, så du ser aldrig en delvist indlæst tabel.
• 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 en fuld synkronisering igen.
• Du kan til enhver tid manuelt udløse en ny synkronisering i HubSpot.

Tabeller, der blev synkroniseret korrekt i et tidligere kørsel, ændres ikke, når en senere kørsel mislykkes.

Ofte stillede spørgsmål

Hvordan forespørger jeg dataene?

Forespørg tabellerne i dit destinationsskema med SQL.

PostgreSQL

Læs alle kontaktposter:

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

Læs en bestemt egenskab fra JSON-kolonnen PROPERTIES. Konverter først kolonnen til JSON, da den er gemt 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

Læs alle kontaktposter:

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

Læs en bestemt egenskab 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 begivenhedstype eller hvert associeringspar kan inkluderes i én tilbagevendende PostgreSQL-synkronisering og én tilbagevendende MySQL-synkronisering pr. HubSpot-konto. Disse synkroniseringer er uafhængige af hinanden og af andre Data Out-udbydere. Hvis kontakter f.eks. allerede er eksporteret til en tilbagevendende PostgreSQL-destination, kan du ikke tilføje kontakter til en anden tilbagevendende PostgreSQL-synkronisering, før du arkiverer den første synkronisering. Du kan stadig eksportere kontakter til en tilbagevendende MySQL-synkronisering på samme tid.

Understøttes objektspecifikke tabeller?

Nej. Objektspecifikke tabeller, såsom OBJECTS_CONTACTS, understøttes endnu ikke. Brug OBJECT_WITH_OBJECT_PROPERTIES og filtrer efter OBJECTTYPEID for at hente poster for et specifikt objekt.

Understøttes følsomme data?

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

Gemmer HubSpot tidligere snapshots?

Nej. Hver synkronisering erstatter destinationstabellen med det seneste øjebliksbillede, så tidligere øjebliksbilleder gemmes ikke.