Eksporter HubSpot-data til Amazon Redshift

Oversigt

Eksporter HubSpot CRM-objekter, tilknytninger og begivenheder til Amazon Redshift ved hjælp af Amazon Redshift-appen i HubSpot Marketplace. Du kan vælge de data, der skal eksporteres, konfigurere en synkroniseringsplan og overvåge synkroniseringsaktiviteten fra HubSpot.

Denne artikel beskriver, hvordan du installerer og forbinder appen, konfigurerer en dataeksportsynkronisering samt overvåger og administrerer synkroniseringen.

Bemærk: Hvis du er superadministrator, kan du tilmelde din konto til betaversionen af den forbedrede Amazon Redshift-integration.

Før du går i gang

Forstå kravene

Sørg for, at du har følgende:

• En AWS Identity and Access Management (IAM)-rolle, der er tilknyttet din HubSpot-konto og konfigureret til at få adgang til din AWS-konto.
• En Amazon Redshift-provisioneret klynge eller serverløs arbejdsgruppe, som HubSpot kan nå.
• En Amazon S3-bucket til midlertidig opbevaring af Parquet-filer. Bucketen skal være i samme AWS-region som din Redshift-klynge eller serverløse arbejdsgruppe.
• HubSpot kopierer midlertidige Parquet-filer til den konfigurerede Amazon S3-staging-bucket og sletter dem ikke. For at fjerne ældre filer og styre lageromkostningerne skal du oprette en S3-livscyklusregel i din AWS-konto.
• En Redshift-administrator, der kan udføre en engangs-SQL-tildeling på destinationsdatabasen.
• Adgang til HubSpot- og AWS-konsollerne. Det anbefales at åbne dem i separate faner.

Forstå begrænsninger og overvejelser

• Hver synkronisering genererer et fuldt øjebliksbillede af de valgte data.
• Hver synkronisering erstatter måltabellen. Eventuelle tilladelser eller indstillinger på tabelniveau, der tilføjes i Redshift, bevares ikke mellem synkroniseringerne.
• Du styrer mængden af eksporterede data ved at vælge, hvilke objekter, tilknytninger og begivenheder der skal medtages.
• Hvis en synkronisering mislykkes, forsøger den næste planlagte synkronisering automatisk at udføre den fulde synkronisering igen.

Installer og tilslut Amazon Redshift-appen

1. Åbn Amazon Redshift-appens side i HubSpot App Marketplace.
2. Vælg den AWS-rolle, der er forbundet med din HubSpot-konto.
3. Klik på Installer.
4. Klik på Næste.
5. Opret en AWS IAM-rolle, der er tilknyttet din HubSpot-konto og konfigureret til at få adgang til din AWS-konto.
6. Indtast rollens Amazon Resource Name (ARN).
7. Klik på " Tilslut til Amazon Redshift".

Konfigurer din AWS-rolle

HubSpot bruger den tilknyttede AWS-rolle til at skrive midlertidige Parquet-filer til din S3-staging-bucket og indlæse filerne i Redshift.

1. I feltet " S3-bucket-URL " skal du indtaste URL'en til den S3-bucket, som HubSpot vil bruge til at lagre midlertidige Parquet-filer.

Du kan inkludere et præfiks i URL'en for at begrænse adgangen til en bestemt sti inden for bucket'en. Bucket'en skal være i samme AWS-region som din Redshift-klynge eller serverløse arbejdsgruppe.

Bemærk: HubSpot kopierer som standard Parquet-filer til den konfigurerede S3-staging-bucket og sletter dem ikke. Opret en S3-livscyklusregel i AWS for automatisk at fjerne ældre filer.

2. Vælg din Redshift-implementeringstype fra rullemenuen:
   • Redshift Serverless
   • Provisioneret klynge
3. Opdater den tilknyttede AWS-rolle med tilladelsespolitikken for din implementeringstype:
   • Redshift Serverless: Indtast din arbejdsgruppes ARN. HubSpot genererer en politik, der indeholder ARN'en. Kopier politikken, og knyt den til den tilknyttede AWS-rolle.
   • Provisioneret klynge: Kopier politikskabelonen. Erstat YOUR_REGION, YOUR_ACCOUNT_ID, YOUR_CLUSTER_ID og YOUR_DATABASE med værdier fra din AWS-konto, og vedhæft derefter politikken til den tilknyttede AWS-rolle.
4. I AWS IAM skal du åbne den rolle, der er tilknyttet HubSpot.
5. Knyt den genererede tilladelsespolitik til rollen, eller opret en indbygget politik med politikindholdet.

6. I den samme AWS IAM-rolle skal du opdatere tillidspolitikken med den erklæring, der er genereret af HubSpot.

HubSpot genererer en anden tillidspolitik-erklæring baseret på den Redshift-implementeringstype, du har valgt.

Knyt AWS-rollen til Redshift

I Amazon Redshift skal du knytte den samme AWS-rolle, som du opdaterede i det foregående afsnit, til din Redshift-opsætning.

• Redshift Serverless: Åbn konfigurationssiden for det navneområde, du bruger sammen med HubSpot. Klik på fanen Sikkerhed og kryptering, klik på Administrer IAM-roller, og vælg derefter Tilknyt IAM-roller.
• Provisioned cluster: Åbn din cluster, klik på Handlinger, og vælg Administrer IAM-roller > Tilknyt IAM-roller.

Tildel Redshift-tilladelser

1. I HubSpot skal du vælge destinationsdatabasen.
2. Bed en Redshift-administrator om at køre SQL-scriptet i den valgte database.

HubSpot bruger denne tilladelse til at oprette et skema for destinationsdatabasen under synkroniseringen.

3. Klik på Test forbindelse.
4. Hvis forbindelsestesten lykkes, skal du klikke på " Næste".

Konfigurer synkroniseringen af dataeksporten

1. Vælg de datakilder, der skal eksporteres.
2. Vælg de objekter, tilknytninger og hændelsestabeller, der skal medtages.
3. Konfigurer synkroniseringsfrekvensen og starttidspunktet.
4. Klik på Start synkronisering.

Hver synkronisering eksporterer et fuldstændigt øjebliksbillede af de valgte data til Amazon Redshift.

Overvåg og administrer synkroniseringen

Fra siden med synkroniseringsoplysninger kan du se følgende oplysninger:

• Synkroniseringsstatus.
• Tidspunkt for sidste synkronisering.
• Fejl.
• Synkroniseringsaktivitet.
• Synkroniseringshistorik.

Sådan åbner du siden med synkroniseringsoplysninger:

1. Gå til Datahåndtering > Dataintegration i din HubSpot-konto.
2. På fanen App-synkroniseringer skal du søge efter Amazon Redshift-app-synkroniseringer.
3. Klik på den Amazon Redshift-synkronisering, du vil gennemgå.

Fra siden med synkroniseringsoplysninger kan du også udføre følgende handlinger:

• Klik på Pause for at sætte synkroniseringen på pause.
• Klik på Arkiver for at arkivere synkroniseringen.
• Klik på Synkroniser nu for manuelt at starte en synkronisering.

Synkroniseringsstatusser

Løsning af synkroniseringsfejl

Når en synkronisering mislykkes:

• Visning af status " Mislykket " i HubSpot.
• Detaljerne for de enkelte tabeller viser, hvilke tabeller der lykkedes eller mislykkedes.
• Den næste planlagte synkronisering forsøger automatisk at udføre den fulde synkronisering igen.
• Du kan klikke på Synkroniser nu for manuelt at starte en ny synkronisering.