TestversionKom åt dina HubSpot-data från PostgreSQL eller MySQL

Använd Data Out för PostgreSQL och MySQL för att exportera utvalda HubSpot CRM-data till tabeller i en databas som du äger. Vid varje synkronisering skrivs en fullständig ögonblicksbild av de valda uppgifterna och ersätter den tidigare ögonblicksbilden. Efter synkroniseringen kan du göra sökningar i tabellerna med SQL eller med dina favoritverktyg för BI och analys för att kombinera HubSpot-data med andra affärsdata.

Observera: om du är superadministratörmåste du anmäla ditt konto tillData Studio-betaversionen för att kunna använda den här funktionen.

Förstå begränsningar och överväganden

Innan du börjar arbeta med den här funktionen bör du se till att du fullt ut förstår vilka åtgärder som bör vidtas i förväg, samt funktionens begränsningar och de potentiella konsekvenserna av att använda den.

• Varje synkronisering ersätter måltabellerna med den senaste ögonblicksbilden. HubSpot sparar inte tidigare ögonblicksbilder.
• Varje objekt, händelsetyp eller kopplingspar kan inkluderas i en återkommande PostgreSQL-synkronisering och en återkommande MySQL-synkronisering per HubSpot-konto. Dessa synkroniseringar är oberoende av varandra och av andra Data Out-leverantörer.
• Känsliga data stöds ännu inte. Känsliga egenskaper kan uteslutas från export.
• Objektspecifika tabeller, såsom OBJECTS_CONTACTS, stöds ännu inte.
• Tabell- och kolumnnamn är skiftlägeskänsliga i PostgreSQL och kan vara skiftlägeskänsliga i MySQL. Granska frågesyntaxen innan du skriver frågor.

Förstå vilka data du kan exportera

Du kan synkronisera följande data från HubSpot till PostgreSQL eller MySQL:

• Objekt: standardobjekt och anpassade objekt, till exempel kontakter, företag, affärer, ärenden och produkter.
• Poster: enskilda poster för de valda objekten.
• Egenskaper: valda egenskapsvärden och egenskapshistorik för poster.
• Associationer: valda relationer mellan poster, inklusive definitionsregler för associationer.
• Händelser: utvalda standardhändelser från HubSpot och anpassade beteendehändelser, inklusive utvalda händelseegenskaper.

Data för olika objekt sammanförs i objekttabellerna. När du läser en objekttabell använder du OBJECTTYPEID för att filtrera fram ett specifikt objekt. Kontakter använder till exempel 0-1. Anpassade objekt tilldelas ett ID när de skapas och identifieras som 2-{unique_id}, till exempel 2-12345.

Förstå exportformatet

Under konfigurationen väljer du:

• Måldatabasen. Detta gäller endast PostgreSQL. För MySQL skapar HubSpot databasen.
• Datakällorna som ska synkroniseras: objekt, händelser, kopplingar eller en kombination av dessa källor.
• Synkroniseringsschemat.

HubSpot exporterar data som Parquet-filer och laddar dem direkt in i tabeller i din databas. PostgreSQL och MySQL använder inte en kundägd staging-bucket. HubSpot hanterar staging internt.

Hitta dina data i databasen

HubSpot skapar en tabell per datakälla i ett HubSpot-hanterat schema som är uppkallat efter din destination. Du hittar det exakta schemanamnet på konfigurationssidan för din synkronisering.

• PostgreSQL: <database>.hubspot_data_out_<destination-id>.<table-name>
• MySQL: hubspot_data_out_<destination-id>.<table-name>. I MySQL är schema och databas samma begrepp, och HubSpot skapar det. Det finns ingen separat databasnivå att välja.

Till exempel 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

Exempel 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

Varje synkronisering ersätter tabellen med den senaste ögonblicksbilden. HubSpot sparar inte tidigare ögonblicksbilder. Om en tabell misslyckas under en synkronisering förblir dess tidigare data kvar tills nästa lyckade synkronisering.

Tabell- och kolumnnamn

Tabell- och kolumnnamn hämtas från de exporterade uppgifterna. Identifierare i PostgreSQL får högst 63 tecken, och identifierare i MySQL får högst 64 tecken. HubSpot förkortar längre namn så att de passar.

Stor- och småbokstäver i identifierare

Stor- och småbokstäver i identifierare spelar roll. HubSpot skapar alla tabeller och kolumner med namn inom citattecken, där stor- och småbokstäver bevaras i versaler, vilket stämmer överens med tabellerna i den här artikeln.

• PostgreSQL: sätt namnen inom dubbla citattecken exakt som det visas. PostgreSQL omvandlar namn utan citattecken till gemener, så de kommer inte att matcha.
• MySQL: använd bakstreck och följ den versaler- och gemenerordning som visas. Om tabellnamn är skiftlägeskänsliga beror på din serverkonfiguration.

Exempel för PostgreSQL:

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

MySQL-exempel:

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

Kolumntyper

Kolumntyperna följer de exporterade uppgifterna och mappas till PostgreSQL- och MySQL-typer enligt följande:

Observera: kolumnen PROPERTIES i OBJECT_WITH_OBJECT_PROPERTIES exporteras som en sträng i JSON-format. Den lagras som TEXT i PostgreSQL eller LONGTEXT i MySQL, inte som en JSON-kolumntyp. För exempel på frågor, se vanliga frågor.

Granska objekttabeller

Om du väljer objektdata exporterar HubSpot följande tabeller.

OBJECT_PROPERTIES

Denna tabell innehåller en rad per egenskapsvärde. För att läsa ett specifikt objekt, filtrera efter OBJECTTYPEID.

OBJECT_WITH_OBJECT_PROPERTIES

Denna tabell innehåller en rad per post, där de valda egenskapsvärdena är grupperade i en enda kolumn PROPERTIES. För att läsa ett specifikt objekt, filtrera efter OBJECTTYPEID.

OBJECT_PROPERTIES_HISTORY

Denna tabell innehåller historiken över egenskapsändringar. Till skillnad från OBJECT_PROPERTIES, som endast innehåller det aktuella värdet, har denna tabell en rad för varje historiskt värde för en egenskap. För att se den fullständiga tidslinjen för en enskild post och egenskap, sortera efter UPDATEDAT.

Granska associationstabeller

Om du väljer associeringsdata exporterar HubSpot associeringsposter och associeringsdefinitioner.

ASSOCIATIONS

Denna tabell innehåller en rad per vald koppling mellan två poster.

ASSOCIATION_DEFINITIONS

Denna tabell innehåller en rad per vald kopplingsdefinition.

ASSOCIATIONS_<FROM_OBJECT>_TO_<TO_OBJECT>

För valda kopplingspar kan HubSpot även exportera parspecifika kopplingstabeller, till exempel ASSOCIATIONS_CONTACTS_TO_COMPANIES. Dessa tabeller innehåller kopplingsposter tillsammans med metadata för kopplingsdefinitioner.

Granska händelsetabeller

Om du väljer händelsedata exporterar HubSpot en tabell per händelsetyp. Tabellnamnen har formatet EVENTS_<EVENT_NAME>, till exempel EVENTS_VISITED_PAGE.

Varje händelsetabell innehåller standardkolumner för händelser och en kolumn för varje vald händelseegenskap.

Hantera synkroniseringsschemat

Du konfigurerar synkroniseringsschemat under installationen i HubSpot. Du kan också manuellt starta en ny synkronisering från HubSpot. Varje synkronisering ger en fullständig ögonblicksbild av de valda uppgifterna. För att kontrollera datamängden väljer du vilka objekt, händelser, kopplingar och egenskaper som ska inkluderas.

Observera: under betafasen kan endast ett begränsat antal synkroniseringsfrekvenser vara tillgängliga, till exempel en gång, var 6:e timme, var 12:e timme, dagligen, veckovis och månadsvis. Ytterligare frekvensalternativ kan läggas till i framtida versioner.

Övervaka synkroniseringar och hantera fel

Du kan övervaka PostgreSQL- och MySQL-synkroniseringar i HubSpot. En synkronisering kan ha ett av följande tillstånd:

När en synkronisering misslyckas:

• HubSpot visar statusen ”Misslyckades” med detaljer per tabell som visar vilka tabeller som lyckades eller misslyckades.
• En tabell uppdateras först efter att HubSpot har laddat alla dess data, så du ser aldrig en delvis laddad tabell.
• Om en tabell misslyckas kvarstår dess tidigare data tills nästa synkronisering lyckas.
• Vid nästa schemalagda synkronisering görs automatiskt ett nytt försök till fullständig synkronisering.
• Du kan när som helst manuellt starta en ny synkronisering i HubSpot.

Tabeller som lyckades vid en tidigare körning ändras inte när en senare körning misslyckas.

Vanliga frågor

Hur gör jag en sökning i data?

Fråga tabellerna i ditt målschema med SQL.

PostgreSQL

Läs alla kontaktposter:

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

Läs en specifik egenskap från JSON-kolumnen PROPERTIES. Konvertera först kolumnen till JSON, eftersom den lagras som text:

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 alla kontaktposter:

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

Läs en specifik egenskap från JSON-kolumnen PROPERTIES:

SELECT `OBJECTID`, JSON_EXTRACT(`PROPERTIES`, '$.email') AS email FROM `hubspot_data_out_456`.`OBJECT_WITH_OBJECT_PROPERTIES` WHERE `OBJECTTYPEID` = '0-1';

Kan jag exportera en datatyp i flera synkroniseringar?

Varje objekt, händelsetyp eller associationspar kan inkluderas i en återkommande PostgreSQL-synkronisering och en återkommande MySQL-synkronisering per HubSpot-konto. Dessa synkroniseringar är oberoende av varandra och av andra Data Out-leverantörer. Om kontakter till exempel redan har exporterats till en återkommande PostgreSQL-destination kan du inte lägga till kontakter till en annan återkommande PostgreSQL-synkronisering förrän du har arkiverat den första synkroniseringen. Du kan fortfarande exportera kontakter till en återkommande MySQL-synkronisering samtidigt.

Stöds objektspecifika tabeller?

Nej. Objektspecifika tabeller, såsom OBJECTS_CONTACTS, stöds inte ännu. Använd OBJECT_WITH_OBJECT_PROPERTIES och filtrera efter OBJECTTYPEID för att hämta poster för ett specifikt objekt.

Stöds känslig data?

Nej. Känsliga uppgifter stöds ännu inte för Data Out. Känsliga egenskaper kan uteslutas från export.

Spara HubSpot tidigare ögonblicksbilder?

Nej. Vid varje synkronisering ersätts måltabellen med den senaste ögonblicksbilden, så tidigare ögonblicksbilder sparas inte.