I betaFå tilgang til HubSpot-dataene dine fra Amazon Redshift

Bruk «Data Out for Amazon Redshift» til å eksportere utvalgte HubSpot CRM-data til tabeller i en Amazon Redshift-database som du eier. Hver synkronisering skriver et fullstendig øyeblikksbilde av de valgte dataene og erstatter det forrige øyeblikksbildet. Etter synkroniseringen kan du foreta søk i tabellene med SQL eller med dine foretrukne BI- og analyseverktøy for å kombinere HubSpot-data med andre forretningsdata.

Merk: Hvis du er superadministrator,må du melde kontoen din påData Studio-betaversjonen for å kunne bruke denne funksjonen.

Forstå begrensninger og hensyn

Før du begynner å jobbe med denne funksjonen, må du sørge for at du fullt ut forstår hvilke tiltak som må iverksettes på forhånd, samt funksjonens begrensninger og potensielle konsekvenser av å bruke den.

• Hver synkronisering erstatter destinasjonstabellene med det nyeste øyeblikksbildet. HubSpot lagrer ikke tidligere øyeblikksbilder i Redshift.
• HubSpot sletter ikke Parquet-filene som lagres midlertidig i S3-bøtta di. For å fjerne dem automatisk må du konfigurere en S3-livssykluspolicy for bøtta eller prefikset.
• Hvert objekt, hver hendelsestype eller hvert assosiasjonspar kan inkluderes i én gjentakende Redshift Data Out-synkronisering per HubSpot-konto.
• Sensitive data støttes ikke ennå. Sensitive egenskaper kan ekskluderes fra eksportene.
• Objektspesifikke tabeller, for eksempel OBJECTS_CONTACTS, støttes ikke ennå.

Forstå hvilke data du kan eksportere

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

• Objekter: standard- og tilpassede objekter, for eksempel kontakter, selskaper, avtaler, billetter og produkter.
• Post: individuelle poster for de valgte objektene.
• Egenskaper: valgte egenskapsverdier og egenskapshistorikk for poster.
• Assosiasjoner: valgte relasjoner mellom poster, inkludert assosiasjonsdefinisjoner.
• Hendelser: valgte standard HubSpot-hendelser og tilpassede atferdshendelser, inkludert valgte hendelsesegenskaper.

Data for ulike objekter er samlet i objekttabellene. Når du leser en objekttabell, bruker du OBJECTTYPEID til å filtrere etter et bestemt objekt. For eksempel bruker kontakter 0-1. Tilpassede objekter tildeles en ID når de opprettes og identifiseres som 2-{unique_id}, for eksempel 2-12345.

Forstå eksportformatet

Under oppsettet velger du:

• Redshift-databasen og klyngen eller den serverløse arbeidsgruppen der HubSpot skal opprette tabeller.
• S3-bøtta HubSpot bruker til å forberede data før de lastes inn i Redshift.
• Datakildene som skal synkroniseres: objekter, hendelser, tilknytninger eller en kombinasjon av disse kildene.
• Synkroniseringsplanen.

HubSpot eksporterer dataene som Parquet-filer, lagrer filene midlertidig i S3-bøtta di og laster dem inn i Redshift-tabeller.

Merk: HubSpot sletter ikke data fra mellomlagringsbucket. Det anbefales å angi en livssykluspolicy for bucket for å rydde opp i bucket automatisk.

Finn dataene dine i Redshift

HubSpot oppretter én tabell per datakilde i et HubSpot-administrert skjema som er oppkalt etter destinasjonen din:

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

Du finner skjemanavnet på konfigurasjonssiden for Redshift-synkroniseringen. 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 nyeste øyeblikksbildet. Hvis en tabell mislykkes under en synkronisering, forblir de tidligere dataene på plass inntil neste vellykkede synkronisering.

HubSpot lagrer Parquet-filer midlertidig i S3-bøtta di under et HubSpot-administrert prefiks, og laster dem deretter inn i Redshift:

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

Disse mellomlagringsfilene forblir i bøtta din inntil du fjerner dem. For å fjerne dem automatisk, må du konfigurere en S3-livssykluspolicy for bøtta eller prefikset.

Merk: Tabell- og kolonnenavn hentes fra de eksporterte dataene. De kan bli forkortet for å overholde Redshifts begrensning på 127 tegn for identifikatorer. Kolonnetyper følger de eksporterte dataene.

Gjennomgå objekttabeller

Hvis du velger objektdata, eksporterer HubSpot følgende tabeller.

OBJECT_PROPERTIES

Denne tabellen inneholder én rad per egenskapsverdi. For å lese et bestemt objekt, filtrer etter OBJECTTYPEID.

OBJECT_WITH_OBJECT_PROPERTIES

Denne tabellen inneholder én rad per post, der de valgte egenskapsverdiene er gruppert i én enkelt PROPERTIES. For å lese et bestemt objekt, filtrer etter OBJECTTYPEID.

OBJECT_PROPERTIES_HISTORY

Denne tabellen inneholder historikken over endringer i egenskaper. I motsetning til OBJECT_PROPERTIES, som kun inneholder den gjeldende verdien, har denne tabellen én rad for hver historisk verdi av en egenskap. For å se den fullstendige tidslinjen for en enkelt post og egenskap, sorter etter UPDATEDAT.

Gjennomgå tilknytningstabeller

Hvis du velger tilknytningsdata, eksporterer HubSpot tilknytningsposter og tilknytningsdefinisjoner.

ASSOCIATIONS

Denne tabellen inneholder én rad per valgt tilknytning mellom to poster.

ASSOCIATION_DEFINITIONS

Denne tabellen inneholder én rad per valgt tilknytningsdefinisjon.

ASSOCIATIONS_<FRA_OBJEKT>_TIL_<TIL_OBJEKT>

For valgte tilknytningspar kan HubSpot også eksportere parspesifikke tilknytningstabeller, for eksempel ASSOCIATIONS_CONTACTS_TO_COMPANIES. Disse tabellene inneholder tilknytningsposter sammen med metadata for tilknytningsdefinisjoner.

Gjennomgå hendelsestabeller

Hvis du velger hendelsesdata, eksporterer HubSpot én tabell per hendelsestype. Tabellnavnene har formatet EVENTS_<EVENT_NAME>, for eksempel EVENTS_VISITED_PAGE.

Hver hendelsestabell inneholder standard hendelseskolonner og én kolonne for hver valgt hendelsesegenskap.

Administrer synkroniseringsplanen

Du konfigurerer synkroniseringsplanen under oppsettet i HubSpot. Du kan også utløse en ny synkronisering manuelt fra HubSpot. Hver synkroniseringskjøring gir et fullstendig øyeblikksbilde av de valgte dataene. For å kontrollere datamengden velger du hvilke objekter, hendelser, tilknytninger og egenskaper som skal inkluderes.

Merk: I betaversjonen kan det være at bare et begrenset antall synkroniseringsfrekvenser er tilgjengelige, for eksempel én gang, hver 6. time, hver 12. time, daglig, ukentlig og månedlig. Flere frekvensalternativer kan bli lagt til i fremtidige utgivelser.

Overvåk synkroniseringer og håndter feil

Du kan overvåke Amazon Redshift-synkroniseringer i HubSpot. En synkronisering kan ha en av følgende tilstander:

Når en synkronisering mislykkes:

• HubSpot viser statusen «Mislykket», med detaljer for hver enkelt tabell som angir hvilke tabeller som ble lastet inn og hvilke som mislyktes.
• En tabell oppdateres først etter at HubSpot har lastet inn alle dataene, så du vil aldri se en delvis lastet tabell.
• Hvis en tabell mislykkes, forblir de tidligere dataene på plass inntil neste vellykkede synkronisering.
• Den neste planlagte synkroniseringen prøver automatisk å utføre en fullstendig synkronisering på nytt.
• Du kan når som helst utløse en ny synkronisering manuelt i HubSpot.

Tabeller som ble synkronisert i en tidligere kjøring, endres ikke når en senere kjøring mislykkes.

Ofte stilte spørsmål

Hvordan søker jeg i dataene?

Spør tabellene i destinasjonsskjemaet ditt med SQL. For eksempel:

Les alle kontaktoppføringer:

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

Les en bestemt egenskap 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 hendelsestype eller hvert assosiasjonspar kan inkluderes i én gjentakende Redshift Data Out-synkronisering per HubSpot-konto. Hvis kontakter for eksempel allerede er eksportert til én gjentakende Redshift-destinasjon, kan du ikke legge til kontakter i en annen gjentakende Redshift-synkronisering før du har arkivert den første synkroniseringen.

Støttes objektspesifikke tabeller?

Nei. Objektspesifikke tabeller, for eksempel OBJECTS_CONTACTS, støttes ikke ennå. Bruk OBJECT_WITH_OBJECT_PROPERTIES og filtrer etter OBJECTTYPEID for å hente poster for et bestemt objekt.

Støttes sensitive data?

Nei. Sensitive data støttes ikke for Data Out til Redshift ennå. Sensitive egenskaper kan ekskluderes fra eksportene.

Beholder HubSpot tidligere øyeblikksbilder?

Nei. Hver synkronisering erstatter destinasjonstabellen med det nyeste øyeblikksbildet, så tidligere øyeblikksbilder lagres ikke i Redshift. HubSpot sletter heller ikke de midlertidige Parquet-filene som lagres i S3-bøtta di. Konfigurer en S3-livssykluspolicy for å la dem utløpe automatisk.