Eksporter HubSpot-data til Amazon Redshift

Sammendrag

Eksporter HubSpot CRM-objekter, tilknytninger og hendelser til Amazon Redshift ved hjelp av Amazon Redshift-appen i HubSpot Marketplace. Du kan velge hvilke data som skal eksporteres, konfigurere en synkroniseringsplan og overvåke synkroniseringsaktiviteten fra HubSpot.

Denne artikkelen beskriver hvordan du installerer og kobler til appen, konfigurerer en synkronisering for dataeksport og overvåker eller administrerer synkroniseringen.

Merk: Hvis du er en superadministrator, kan du melde kontoen din på betaversjonen av den forbedrede Amazon Redshift-integrasjonen.

Før du begynner

Forstå kravene

Sørg for at du har følgende:

• En AWS Identity and Access Management (IAM)-rolle som er koblet til HubSpot-kontoen din og konfigurert for å få tilgang til AWS-kontoen din.
• En Amazon Redshift-provisjonert klynge eller en serverløs arbeidsgruppe som HubSpot kan nå.
• En Amazon S3-bucket for midlertidig lagring av Parquet-filer. Bucketen må være i samme AWS-region som Redshift-klyngen eller den serverløse arbeidsgruppen din.
• HubSpot kopierer midlertidige Parquet-filer til den konfigurerte Amazon S3-bucket for midlertidig lagring og sletter dem ikke. For å fjerne eldre filer og administrere lagringskostnader, opprett en S3-livssyklusregel i din AWS-konto.
• En Redshift-administrator som kan utføre en engangs-SQL-tildeling på måldatabasen.
• Tilgang til HubSpot- og AWS-konsollene. Det anbefales å åpne dem i separate faner.

Forstå begrensninger og hensyn

• Hver synkronisering produserer et fullstendig øyeblikksbilde av de valgte dataene.
• Hver synkronisering erstatter måltabellen. Eventuelle tillatelser eller innstillinger på tabellnivå som er lagt til i Redshift, beholdes ikke mellom synkroniseringene.
• Du styrer mengden data som eksporteres ved å velge hvilke objekter, tilknytninger og hendelser som skal inkluderes.
• Hvis en synkronisering mislykkes, forsøker den neste planlagte synkroniseringen automatisk å utføre full synkronisering på nytt.

Installer og koble til Amazon Redshift-appen

1. I HubSpot App Marketplace åpner du oppføringen for Amazon Redshift-appen.
2. Velg AWS-rollen som er koblet til HubSpot-kontoen din.
3. Klikk på Installer.
4. Klikk på «Neste».
5. Opprett en AWS IAM-rolle som er koblet til HubSpot-kontoen din og konfigurert for å få tilgang til AWS-kontoen din.
6. Skriv inn Amazon Resource Name (ARN) for rollen.
7. Klikk på «Koble til Amazon Redshift».

Konfigurer AWS-rollen din

HubSpot bruker den tilknyttede AWS-rollen til å skrive midlertidige Parquet-filer til S3-staging-bucket og laste filene inn i Redshift.

1. I feltet «S3-bucket-URL» angir du URL-en til S3-bucket som HubSpot skal bruke til å lagre midlertidige Parquet-filer.

Du kan inkludere et prefiks i URL-en for å begrense tilgangen til en bestemt bane i bøtten. Bøtten må være i samme AWS-region som Redshift-klyngen eller den serverløse arbeidsgruppen din.

Merk: HubSpot kopierer Parquet-filer til den konfigurerte S3-staging-bucket som standard og sletter dem ikke. Opprett en S3-livssyklusregel i AWS for å fjerne eldre filer automatisk.

2. Velg din Redshift-distribusjonstype fra rullegardinmenyen:
   • Redshift Serverless
   • Provisjonert klynge
3. Oppdater den tilknyttede AWS-rollen med tillatelsespolitikken for din distribusjonstype:
   • Redshift Serverless: skriv inn ARN-en til arbeidsgruppen din. HubSpot genererer en policy som inneholder ARN-en. Kopier policyen og knytt den til den tilknyttede AWS-rollen.
   • Provisjonert klynge: kopier policymalen. Erstatt YOUR_REGION, YOUR_ACCOUNT_ID, YOUR_CLUSTER_ID og YOUR_DATABASE med verdier fra din AWS-konto, og knytt deretter policyen til den tilknyttede AWS-rollen.
4. I AWS IAM åpner du rollen som er tilknyttet HubSpot.
5. Knytt den genererte tillatelsespolitikken til rollen, eller opprett en innebygd policy med policyinnholdet.

6. I den samme AWS IAM-rollen oppdaterer du tillitspolicyen med uttalelsen som er generert av HubSpot.

HubSpot genererer en annen tillitspolicyerklæring basert på den Redshift-distribusjonstypen du valgte.

Knytt AWS-rollen til Redshift

I Amazon Redshift knytter du den samme AWS-rollen som du oppdaterte i forrige avsnitt, til Redshift-oppsettet ditt.

• Redshift Serverless: Åpne konfigurasjonssiden for navneområdet du bruker med HubSpot. På fanen Sikkerhet og kryptering klikker du på Administrer IAM-roller, og velger deretter Knytt IAM-roller.
• Provisjonert klynge: Åpne klyngen din, klikk på Handlinger, og velg Administrer IAM-roller > Tilknytt IAM-roller.

Gi Redshift-tillatelser

1. I HubSpot velger du måldatabasen.
2. Be en Redshift-administrator om å kjøre SQL-skriptet i den valgte databasen.

HubSpot bruker denne tillatelsen til å opprette et skjema for målet under synkroniseringen.

3. Klikk på Test tilkobling.
4. Hvis tilkoblingstesten lykkes, klikker du på «Neste».

Konfigurer synkroniseringen av dataeksporten

1. Velg datakildene som skal eksporteres.
2. Velg objekter, tilknytninger og hendelsestabeller som skal inkluderes.
3. Konfigurer synkroniseringsfrekvensen og starttidspunktet.
4. Klikk på Start synkronisering.

Hver synkronisering eksporterer et fullstendig øyeblikksbilde av de valgte dataene til Amazon Redshift.

Overvåk og administrer synkroniseringen

Fra siden med synkroniseringsdetaljer kan du se følgende informasjon:

• Synkroniseringsstatus.
• Siste synkroniseringstidspunkt.
• Feil.
• Synkroniseringsaktivitet.
• Synkroniseringshistorikk.

Slik åpner du siden med synkroniseringsdetaljer:

1. I HubSpot-kontoen din går du til Datahåndtering > Dataintegrasjon.
2. På fanen App-synkroniseringer søker du etter Amazon Redshift-app-synkroniseringer.
3. Klikk på Amazon Redshift-synkroniseringen du vil se nærmere på.

Fra siden med synkroniseringsdetaljer kan du også utføre følgende handlinger:

• Klikk på «Pause» for å sette synkroniseringen på pause.
• Klikk på Arkiver for å arkivere synkroniseringen.
• Klikk på «Synkroniser nå » for å starte en synkronisering manuelt.

Synkroniseringsstatus

Løse synkroniseringsfeil

Når en synkronisering mislykkes:

• Synkroniseringen vises med statusen «Mislykket» i HubSpot.
• Detaljene per tabell viser hvilke tabeller som lyktes eller mislyktes.
• Den neste planlagte synkroniseringen forsøker automatisk å utføre full synkronisering på nytt.
• Du kan klikke på «Synkroniser nå » for å starte en ny synkronisering manuelt.