Exportera HubSpot-data till PostgreSQL eller MySQL

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.

Sammanfattning

Använd Data Out för att exportera utvalda HubSpot CRM-data till en PostgreSQL- eller MySQL-databas som du hanterar. Du kan synkronisera objekt-, kopplings- och händelsedata till tabeller i din databas och sedan söka i data med SQL eller använda dem med dina verktyg för affärsintelligens och analys.

Varje synkronisering skapar en fullständig ögonblicksbild av den valda datan. När en synkronisering lyckas ersätter den den tidigare ögonblicksbilden i måltabellerna.

Innan du börjar

Förstå kraven

• Din PostgreSQL- eller MySQL-databas måste vara tillgänglig från HubSpots IP-intervall för din kontoregion.
• Din databasserver måste stödja SSL-anslutningar.
• Du måste ha en databasanvändare med nödvändiga behörigheter:
  • PostgreSQL: CREATE -behörighet och skrivåtkomst till målschemat.
  • MySQL: CREATE -behörighet för databasen och skrivbehörighet.
• Se till att din databasanvändare kan skapa tabeller och skriva data.
• Håll ditt HubSpot-konto och databaskonsolerna öppna i separata flikar.

Tillåt HubSpots IP-adresser

Lägg till HubSpots IP-intervall för din kontoregion i databasserverns tillåtna lista.

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

• Varje synkronisering skapar en fullständig ögonblicksbild av de valda uppgifterna.
• En lyckad synkronisering ersätter den tidigare ögonblicksbilden i måltabellerna.
• HubSpot sparar inte tidigare ögonblicksbilder.
• Om en tabell misslyckas under en synkronisering förblir dess tidigare data tillgängliga tills nästa lyckade synkronisering.
• Varje objekttyp, händelsetyp eller kopplingspar kan inkluderas i en återkommande PostgreSQL-synkronisering och en återkommande MySQL-synkronisering per konto.
• Varje synkronisering ersätter måltabellen. Behörigheter eller inställningar på tabellnivå som lagts till hos din databasleverantör bevaras inte mellan synkroniseringarna.
• Om du ansluter på nytt med en annan databasanvändare måste du bevilja den användaren åtkomst till befintliga HubSpot-hanterade scheman, databaser eller tabeller.

Anslut HubSpot till PostgreSQL eller MySQL

1. I ditt HubSpot-konto klickar du på Mer och navigerar sedan till Datahantering > Data Studio. Om Mer inte visas i ditt konto navigerar du direkt till Datahantering > Data Studio.
2. Klicka på Anslut extern datakälla längst upp till höger.
3. I panelen Lägg till en datakälla söker du efter eller bläddrar till databasleverantören.
4. Klicka på PostgreSQL eller MySQL.
5. Ange uppgifterna för databasanslutningen:
   • Värd
   • Port
   • SSL
   • Användarnamn
   • Lösenord
6. För PostgreSQL anger du namnet på den databas där HubSpot ska skapa schemat.
7. Klicka på Anslut till PostgreSQL eller Anslut till MySQL.

HubSpot använder den anslutna databasanvändaren för att skapa tabeller och ladda data till din databas.

Konfigurera synkroniseringen

1. Välj de datakällor som ska exporteras:
   • Objekt
   • Associationer
   • Händelser
2. Välj de objekt, egenskaper, kopplingar eller händelser som ska inkluderas.
3. Välj hur ofta synkroniseringen ska köras och när den ska startas.
4. Klicka på Starta synkronisering.

De tillgängliga synkroniseringsfrekvenserna kan variera under betatestperioden. Alternativen kan vara en gång, var 6:e timme, var 12:e timme, dagligen, veckovis eller månadsvis.

Kom åt dina exporterade data

HubSpot skapar ett HubSpot-hanterat schema eller en databas för varje mål.

PostgreSQL

PostgreSQL-tabeller använder följande format:

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

Till exempel:

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 använder följande format:

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

Exempel:

hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES
hubspot_data_out_456.EVENTS_VISITED_PAGE
hubspot_data_out_456.ASSOCIATIONS_CONTACTS_TO_COMPANIES

Du hittar det exakta schemat eller databasnamnet på sidan för synkroniseringskonfiguration.

Tabell- och kolumnnamn

Tabell- och kolumnnamn baseras på de exporterade uppgifterna. PostgreSQL-identifierare kan innehålla upp till 63 tecken. MySQL-identifierare kan innehålla upp till 64 tecken. Längre namn förkortas för att passa den gällande gränsen.

HubSpot skapar PostgreSQL-tabeller och -kolumner med namn inom citattecken och med bevarad versal- och gemenskillnad. När du gör sökningar i PostgreSQL ska du använda dubbla citattecken och följa den versal- och gemenskillnad som visas i tabell- och kolumnnamnen.

För MySQL ska du använda bakstreck och följa den stora och små bokstäver som visas. Skillnaden mellan stora och små bokstäver i tabellnamn kan variera beroende på din MySQL-serverkonfiguration.

Kolumntyper

Kolumnen PROPERTIES i tabellen OBJECT_WITH_OBJECT_PROPERTIES lagras som en sträng i JSON-format. Den lagras som TEXT i PostgreSQL och LONGTEXT i MySQL, inte som en inbyggd JSON-kolumntyp.

Objekttabeller

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

OBJECT_PROPERTIES

Denna tabell innehåller en rad för varje objektets egenskapsvärde.

OBJECT_WITH_OBJECT_PROPERTIES

Denna tabell innehåller en rad för varje objektrekord. Valda egenskapsvärden grupperas i kolumnen PROPERTIES.

Objektdata för olika objekttyper slås samman i denna tabell. Filtrera efter OBJECTTYPEID för att läsa poster för en specifik objekttyp.

• Kontakter: 0-1
• Anpassade objekt: 2-{unique_id}, till exempel 2-12345

OBJECT_PROPERTIES_HISTORY

Denna tabell innehåller historiken över egenskapsändringar. Den innehåller en rad för varje historiskt värde för en egenskap.

För att visa hela historiken för en specifik post och egenskap, sortera resultaten efter UPDATEDAT.

Associeringstabeller

Om du väljer associationsdata exporterar HubSpot associationsposter och associationsdefinitioner.

ASSOCIATIONS

Denna tabell innehåller en rad för varje vald koppling mellan två poster.

ASSOCIATION_DEFINITIONS

Denna tabell innehåller en rad för varje vald kopplingsdefinition.

Par-specifika kopplingstabeller

För valda kopplingspar kan HubSpot även exportera tabeller med följande format:

ASSOCIATIONS_<FROM_OBJECT_TYPE>_TO_<TO_OBJECT_TYPE>

Till exempel:

ASSOCIATIONS_CONTACTS_TO_COMPANIES

Dessa tabeller innehåller associeringsposter och metadata för associeringsdefinitioner.

Händelsetabeller

Om du väljer händelsedata exporterar HubSpot en tabell för varje händelsetyp. Namnen på händelsetabellerna har följande format:

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.

Övervaka din synkronisering

1. I ditt HubSpot-konto klickar du på Mer och navigerar sedan till Datahantering > Dataintegration. Om Mer inte visas i ditt konto navigerar du direkt till Datahantering > Data Integration.
2. Klicka på App-synkroniseringar till vänster.
3. Sök efter eller välj PostgreSQL- eller MySQL-synkroniseringen.

Från sidan med synkroniseringsdetaljer kan du se synkroniseringsstatus, tidpunkt för senaste synkronisering, fel, synkroniseringsaktivitet och synkroniseringshistorik. Du kan också pausa, arkivera eller manuellt köra synkroniseringen.

Synkroniseringsstatus

Åtgärda synkroniseringsfel

När en synkronisering misslyckas:

• HubSpot-gränssnittet visar statusen Misslyckades samt detaljer på tabellnivå som anger vilka tabeller som lyckades eller misslyckades.
• En tabell uppdateras först efter att HubSpot har laddat alla dess data.
• Om en tabell misslyckas kvarstår dess tidigare data tills nästa synkronisering lyckas.
• Vid nästa schemalagda synkronisering försöker systemet automatiskt utföra en fullständig synkronisering igen.
• Du kan köra en synkronisering manuellt från sidan med synkroniseringsdetaljer.

Tabeller som synkroniserades utan problem 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 de exporterade uppgifterna?

Fråga tabellerna i målschemat 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 jag exportera en datatyp i flera synkroniseringar?

Varje objekttyp, händelsetyp eller associationspar kan inkluderas i en återkommande PostgreSQL-synkronisering och en återkommande MySQL-synkronisering per HubSpot-konto.

Om kontakter till exempel redan har exporterats till en återkommande PostgreSQL-destination kan du inte lägga till kontakter till en annan återkommande PostgreSQL-konfiguration förrän du har arkiverat den första konfigurationen. Du kan fortfarande exportera kontakter till en återkommande MySQL-konfiguration samtidigt.

Stöds objektspecifika tabeller?

Objektspecifika tabeller, såsom OBJECTS_CONTACTS, stöds för närvarande inte. Använd OBJECT_WITH_OBJECT_PROPERTIES och filtrera efter OBJECTTYPEID för att hämta poster för en specifik objekttyp.

Stöds känslig data?

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

Spara HubSpot tidigare ögonblicksbilder?

Nej. Varje lyckad synkronisering ersätter måltabellen med den senaste ögonblicksbilden. HubSpot behåller inte tidigare ögonblicksbilder.

Om en tabell misslyckas under en synkronisering kvarstår dess tidigare data tills tabellen har uppdaterats framgångsrikt.

Använder HubSpot en staging-bucket som jag hanterar?

Nej. HubSpot exporterar data i Parquet-format och hanterar mellanlagringen internt. Du behöver inte tillhandahålla en kundägd mellanlagringsbucket för PostgreSQL eller MySQL.

Vad händer om jag byter databasanvändare?

Om du ansluter på nytt med en annan databasanvändare måste du bevilja den nya användaren åtkomst till befintliga scheman, databaser eller tabeller som hanteras av HubSpot.