TestversionKom åt dina HubSpot-data från Microsoft Azure Synapse Analytics

Använd Data Out för Azure Synapse för att exportera utvalda HubSpot CRM-data till tabeller i en dedikerad SQL-pool i Azure Synapse som du äger. HubSpot uppdaterar varje utdatatabell utifrån en fullständig export av de valda uppgifterna. 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 måste vidtas i förväg, samt funktionens begränsningar och de potentiella konsekvenserna av att använda den.

• HubSpot uppdaterar tabellerna separat. Om du gör en sökning över flera tabeller medan en synkronisering pågår kan vissa tabeller uppdateras före andra.
• Data Out erbjuder inte lagring av historiska ögonblicksbilder. Efter en lyckad uppdatering innehåller måltabellen den senaste ögonblicksbilden.
• Varje objekt, händelsetyp eller kopplingspar kan inkluderas i en återkommande Azure Synapse-synkronisering per HubSpot-konto. Denna gräns är oberoende av andra Data Out-leverantörer.
• Objektspecifika tabeller, såsom OBJECTS_CONTACTS, stöds ännu inte.
• Om två tabellnamn kolliderar efter att HubSpot har normaliserat dem misslyckas den berörda exporten. Läs reglerna för tabell- och kolumnnamn för mer information.

Förstå vilken data du kan exportera

Du kan synkronisera följande data från HubSpot till Azure Synapse Analytics:

• Objekt och poster: utvalda standard- och anpassade objekt samt deras poster, till exempel kontakter, företag, affärer, ärenden och produkter.
• Egenskaper: utvalda egenskapsvärden och egenskapshistorik för poster.
• Associationer: utvalda relationer mellan poster, inklusive associationsdefinitioner.
• Händelser: utvalda standardhändelser i HubSpot och anpassade beteendehändelser, inklusive utvalda 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:

• Den dedikerade SQL-ändpunkten och databasen i Azure Synapse som är destinationen.
• Datakällorna som ska synkroniseras: objekt, händelser, kopplingar eller en kombination av dessa källor.
• Synkroniseringsschemat.

HubSpot skapar en tillfällig Parquet-export i HubSpots hanterade lagring och skriver resultaten till tabeller i din dedikerade SQL-pool i Azure Synapse. Du behöver inte tillhandahålla eller hantera en staging-bucket.

Hitta dina data i Azure Synapse

HubSpot skapar utdatatabeller i ett HubSpot-hanterat schema för din destination. HubSpot exporterar objektdata till de tre objekttabellerna som beskrivs i den här artikeln. HubSpot skapar också en tabell per vald händelsetyp och, när det är möjligt, en parspecifik tabell per valt associationspar.

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

Du hittar det exakta schemanamnet på konfigurationssidan för din 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

Tabell- och kolumnnamn

HubSpot normaliserar exporterade tabell- och kolumnnamn till versaler, siffror och understreck:

• Mellanslag och bindestreck ersätts med understreck.
• Övriga tecken som inte är bokstäver eller siffror tas bort.
• Namn som är längre än 128 tecken förkortas.
• Kolumnnamn som kolliderar förses med ett suffix.
• Om tabellnamn kolliderar misslyckas den berörda exporten.

Använd hakparenteser när du gör sökningar på identifierare, särskilt om du konstruerar sökningar dynamiskt. Om identifierare är skiftlägeskänsliga beror på sorteringsordningen i din Synapse-databas. Till exempel:

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

Kolumntyper

Kolumntyper följer de exporterade uppgifterna och mappas till Azure Synapse-typer enligt följande:

Observera: kolumnen PROPERTIES i OBJECT_WITH_OBJECT_PROPERTIES exporteras som en sträng i JSON-format. Den lagras som NVARCHAR(MAX), 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 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 de tillgängliga synkroniseringsfrekvenserna vara begränsade. Ytterligare frekvensalternativ kan läggas till i framtida versioner.

Övervaka synkroniseringar och hantera fel

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

När en synkronisering misslyckas:

• HubSpot visar statusen Misslyckad med information om vilka tabeller som lyckades eller misslyckades.
• Om en tabell inte kan uppdateras förblir de tidigare korrekta uppgifterna vanligtvis tillgängliga.
• Vid återkommande synkroniseringar görs automatiskt ett nytt försök till fullständig synkronisering vid nästa schemalagda synkronisering.
• Du kan när som helst manuellt starta en ny synkronisering i HubSpot.

Vanliga frågor

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

Fråga tabellerna i ditt målschema med SQL. Läs till exempel 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-strängen PROPERTIES:

SELECT
  [OBJECTID],
  JSON_VALUE([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 synkroniseringar?

Varje objekt, händelsetyp eller associationspar kan inkluderas i en återkommande Azure Synapse-synkronisering per HubSpot-konto. Denna begränsning är oberoende av andra Data Out-leverantörer.

Om kontakter till exempel redan har exporterats till en återkommande Azure Synapse-destination kan du inte lägga till kontakter till en annan återkommande Azure Synapse-synkronisering förrän du har arkiverat den första synkroniseringen. Du kan fortfarande exportera kontakter till en annan Data Out-leverantör som stöds 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.

Bevarar HubSpot tidigare ögonblicksbilder?

Nej. Data Out erbjuder inte lagring av historiska ögonblicksbilder. Efter en lyckad uppdatering innehåller måltabellen den senaste ögonblicksbilden. Om en tabell inte kan uppdateras förblir de tidigare lyckade uppgifterna vanligtvis tillgängliga.