I betaFå adgang til dine HubSpot-data fra Amazon Redshift

Brug »Data Out for Amazon Redshift« til at eksportere udvalgte HubSpot CRM-data til tabeller i en Amazon Redshift-database, som du ejer. Hver synkronisering skriver et fuldstændigt øjebliksbillede af de udvalgte 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 snapshot. HubSpot opbevarer ikke tidligere snapshots i Redshift.
• HubSpot sletter ikke de Parquet-filer, der placeres i din S3-bucket. For at fjerne dem automatisk skal du oprette en S3-livscykluspolitik for bucketen eller præfikset.
• Hvert objekt, hver begivenhedstype eller hvert associeringspar kan inkluderes i én tilbagevendende Redshift Data Out-synkronisering pr. HubSpot-konto.
• Følsomme data understøttes endnu ikke. Følsomme egenskaber kan udelades fra eksport.
• Objektspecifikke tabeller, såsom OBJECTS_CONTACTS, understøttes endnu ikke.

Forstå de data, du kan eksportere

Du kan synkronisere følgende data fra HubSpot til Amazon Redshift:

• 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 i 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:

• Redshift-databasen og den klynge eller serverløse arbejdsgruppe, hvor HubSpot vil oprette tabeller.
• Den S3-bucket, som HubSpot bruger til at forberede data, inden de indlæses i Redshift.
• De datakilder, der skal synkroniseres: objekter, begivenheder, tilknytninger eller en kombination af disse kilder.
• Synkroniseringsplanen.

HubSpot eksporterer dataene som Parquet-filer, placerer filerne i din S3-bucket og indlæser dem i Redshift-tabeller.

Bemærk: HubSpot sletter ikke data fra mellemopbevaringsbucket. Det anbefales at indstille en livscykluspolitik for bucket, så den automatisk ryddes.

Find dine data i Redshift

HubSpot opretter én tabel pr. datakilde i et HubSpot-administreret skema, der er opkaldt efter din destination:

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

Du kan finde skemaets navn på konfigurationssiden for din Redshift-synkronisering. For eksempel:

• 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

Hver synkronisering erstatter tabellen med det seneste snapshot. Hvis en tabel fejler under en synkronisering, forbliver de tidligere data på plads indtil den næste vellykkede synkronisering.

HubSpot placerer Parquet-filer i din S3-bucket under et HubSpot-administreret præfiks og indlæser dem derefter i Redshift:

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

Disse midlertidige filer forbliver i din bucket, indtil du sletter dem. For at slette dem automatisk skal du konfigurere en S3-livscykluspolitik for bucketen eller præfikset.

Bemærk: Tabel- og kolonnenavne stammer fra de eksporterede data. De kan blive forkortet for at overholde Redshifts begrænsning på 127 tegn for identifikatorer. Kolonnetyperne følger de eksporterede data.

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 Amazon Redshift-synkroniseringer i HubSpot. En synkronisering kan have en af følgende tilstande:

Når en synkronisering mislykkes:

• HubSpot viser status »Mislykket« med detaljer for hver enkelt tabel, der angiver, hvilke tabeller der er blevet indlæst korrekt, og hvilke der er 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. For eksempel:

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:

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 jeg eksportere én datatype i flere Redshift-synkroniseringer?

Hvert objekt, hver begivenhedstype eller hvert associeringspar kan inkluderes i én tilbagevendende Redshift Data Out-synkronisering pr. HubSpot-konto. Hvis kontakter f.eks. allerede er eksporteret til én tilbagevendende Redshift-destination, kan du ikke tilføje kontakter til en anden tilbagevendende Redshift-synkronisering, før du arkiverer den første synkronisering.

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 bestemt objekt.

Understøttes følsomme data?

Nej. Følsomme data understøttes endnu ikke ved Data Out til Redshift. Følsomme egenskaber kan udelades fra eksporten.

Gemmer HubSpot tidligere snapshots?

Nej. Hver synkronisering erstatter destinationstabellen med det seneste snapshot, så tidligere snapshots gemmes ikke i Redshift. HubSpot sletter heller ikke de midlertidige Parquet-filer, som det placerer i din S3-bucket. Konfigurer en S3-livscykluspolitik, så de udløber automatisk.