TestversionKom åt dina HubSpot-data från Amazon Redshift

Använd Data Out för Amazon Redshift för att exportera utvalda HubSpot CRM-data till tabeller i en Amazon Redshift-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 affärsintelligens 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 mottagartabellerna med den senaste ögonblicksbilden. HubSpot sparar inte tidigare ögonblicksbilder i Redshift.
• HubSpot raderar inte de Parquet-filer som lagras tillfälligt i din S3-bucket. För att ta bort dem automatiskt ska du konfigurera en S3-livscykelpolicy för bucketen eller prefixet.
• Varje objekt, händelsetyp eller associationspar kan inkluderas i en återkommande Redshift Data Out-synkronisering per HubSpot-konto.
• 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.

Förstå vilka data du kan exportera

Du kan synkronisera följande data från HubSpot till Amazon Redshift:

• 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.
• Kopplingar: valda relationer mellan poster, inklusive kopplingsdefinitioner.
• Händelser: valda standardhändelser i HubSpot och anpassade beteendehändelser, inklusive valda händelseegenskaper.

Data för olika objekt kombineras 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:

• Redshift-databasen och klustret eller den serverlösa arbetsgruppen där HubSpot kommer att skapa tabeller.
• Den S3-bucket som HubSpot använder för att mellanlagra data innan den laddas in i Redshift.
• Datakällorna som ska synkroniseras: objekt, händelser, kopplingar eller en kombination av dessa källor.
• Synkroniseringsschemat.

HubSpot exporterar data som Parquet-filer, lagrar filerna i din S3-bucket och laddar dem in i Redshift-tabeller.

Observera: HubSpot raderar inte data från mellanlagringsbucket. Det rekommenderas att du ställer in en livscykelpolicy för bucketen så att den rensas automatiskt.

Hitta dina data i Redshift

HubSpot skapar en tabell per datakälla i ett HubSpot-hanterat schema som namnges efter din destination:

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

Du hittar schemanamnet på konfigurationssidan för din Redshift-synkronisering. 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

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

HubSpot placerar Parquet-filer i din S3-bucket under ett HubSpot-hanterat prefix och laddar sedan in dem i Redshift:

s3://<bucket>/<prefix>/hubspot-dataout/<portal-id>/<destination-id>/<run-id>/<table-name>/

Dessa mellanlagringsfiler finns kvar i din bucket tills du tar bort dem. För att ta bort dem automatiskt konfigurerar du en S3-livscykelpolicy för bucketen eller prefixet.

Observera: tabell- och kolumnnamn hämtas från de exporterade uppgifterna. De kan förkortas för att passa Redshifts gräns på 127 tecken för identifierare. Kolumntyperna följer de exporterade uppgifterna.

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 associationsdata exporterar HubSpot associationsposter och associationsdefinitioner.

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 Amazon Redshift-synkroniseringar i HubSpot. En synkronisering kan ha något av följande tillstånd:

När en synkronisering misslyckas:

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

Tabeller som lyckades i 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. Till exempel:

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:

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

Kan jag exportera en datatyp i flera Redshift-synkroniseringar?

Varje objekt, händelsetyp eller associationspar kan inkluderas i en återkommande Redshift Data Out-synkronisering per HubSpot-konto. Om kontakter till exempel redan har exporterats till en återkommande Redshift-destination kan du inte lägga till kontakter till en annan återkommande Redshift-synkronisering förrän du har arkiverat den första synkroniseringen.

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änsliga uppgifter?

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

Behåller HubSpot tidigare ögonblicksbilder?

Nej. Varje synkronisering ersätter måltabellen med den senaste ögonblicksbilden, så tidigare ögonblicksbilder sparas inte i Redshift. HubSpot raderar inte heller de tillfälliga Parquet-filerna som lagras i din S3-bucket. Konfigurera en S3-livscykelpolicy för att låta dem upphöra automatiskt.