TestversionExportera HubSpot-data till Amazon Redshift

Sammanfattning

Exportera HubSpot CRM-objekt, kopplingar och händelser till Amazon Redshift med hjälp av Amazon Redshift-appen i HubSpot Marketplace. Du kan välja vilka data som ska exporteras, konfigurera ett synkroniseringsschema och övervaka synkroniseringsaktiviteten från HubSpot.

Den här artikeln beskriver hur du installerar och ansluter appen, konfigurerar en synkronisering för dataexport samt övervakar och hanterar synkroniseringen.

Observera: om du är superadministratörkan du anmäla ditt konto till betaversionen av den förbättrade Amazon Redshift-integrationen.

Innan du börjar

Förstå kraven

Se till att du har följande:

• En AWS Identity and Access Management (IAM)-roll som är kopplad till ditt HubSpot-konto och konfigurerad för åtkomst till ditt AWS-konto.
• Ett Amazon Redshift-kluster eller en serverlös arbetsgrupp som HubSpot kan nå.
• En Amazon S3-bucket för att lagra tillfälliga Parquet-filer. Bucketen måste finnas i samma AWS-region som ditt Redshift-kluster eller din serverlösa arbetsgrupp.
• HubSpot kopierar tillfälliga Parquet-filer till den konfigurerade Amazon S3-bucket för lagring och raderar dem inte. För att ta bort äldre filer och hantera lagringskostnaderna ska du skapa en S3-livscykelregel i ditt AWS-konto.
• En Redshift-administratör som kan köra en engångs-SQL-behörighetstilldelning på måldatabasen.
• Åtkomst till HubSpot- och AWS-konsolerna. Det rekommenderas att öppna dem i separata flikar.

Förstå begränsningar och överväganden

• Varje synkronisering skapar en fullständig ögonblicksbild av de valda uppgifterna.
• Varje synkronisering ersätter måltabellen. Eventuella behörigheter eller inställningar på tabellnivå som lagts till i Redshift bevaras inte mellan synkroniseringarna.
• Du styr mängden data som exporteras genom att välja vilka objekt, kopplingar och händelser som ska inkluderas.
• Om en synkronisering misslyckas försöker nästa schemalagda synkronisering automatiskt att utföra en fullständig synkronisering igen.

Installera och anslut Amazon Redshift-appen

1. Öppna Amazon Redshift-appens sida i HubSpot App Marketplace.
2. Välj den AWS-roll som är kopplad till ditt HubSpot-konto.
3. Klicka på Installera.
4. Klicka på Nästa.
5. Skapa en AWS IAM-roll som är kopplad till ditt HubSpot-konto och konfigurerad för åtkomst till ditt AWS-konto.
6. Ange rollens Amazon Resource Name (ARN).
7. Klicka på Anslut till Amazon Redshift.

Konfigurera din AWS-roll

HubSpot använder den anslutna AWS-rollen för att skriva tillfälliga Parquet-filer till din S3-staging-bucket och ladda in filerna i Redshift.

1. I fältet S3-bucket-URL anger du URL:en till den S3-bucket som HubSpot ska använda för att lagra tillfälliga Parquet-filer.

Du kan inkludera ett prefix i URL:en för att begränsa åtkomsten till en specifik sökväg inom bucketen. Bucketen måste finnas i samma AWS-region som ditt Redshift-kluster eller din serverlösa arbetsgrupp.

Observera: HubSpot kopierar Parquet-filer till den konfigurerade S3-stagingbucket enligt standardinställningen och raderar dem inte. Skapa en S3-livscykelregel i AWS för att automatiskt ta bort äldre filer.

2. Välj din Redshift-distributionstyp från rullgardinsmenyn:
   • Redshift Serverless
   • Provisionerad kluster
3. Uppdatera den anslutna AWS-rollen med behörighetspolicyn för din distributionstyp:
   • Redshift Serverless: ange din arbetsgrupps ARN. HubSpot genererar en policy som innehåller ARN:et. Kopiera policyn och koppla den till den anslutna AWS-rollen.
   • Provisionerat kluster: kopiera policymallen. Ersätt YOUR_REGION, YOUR_ACCOUNT_ID, YOUR_CLUSTER_ID och YOUR_DATABASE med värden från ditt AWS-konto och koppla sedan policyn till den anslutna AWS-rollen.
4. I AWS IAM öppnar du den roll som är kopplad till HubSpot.
5. Koppla den genererade behörighetspolicyn till rollen, eller skapa en inbyggd policy med policyinnehållet.

6. I samma AWS IAM-roll uppdaterar du förtroendepolicyn med den deklaration som genererats av HubSpot.

HubSpot genererar ett annat uttalande för tillitspolicyn baserat på den Redshift-distributionstyp du valt.

Koppla AWS-rollen till Redshift

I Amazon Redshift kopplar du samma AWS-roll som du uppdaterade i föregående avsnitt till din Redshift-konfiguration.

• Redshift Serverless: öppna konfigurationssidan för det namnområde som du använder med HubSpot. På fliken Säkerhet och kryptering klickar du på Hantera IAM-roller och väljer sedan Koppla IAM-roller.
• Provisionerad kluster: öppna ditt kluster, klicka på Åtgärder och välj Hantera IAM-roller > Koppla IAM-roller.

Bevilja Redshift-behörigheter

1. I HubSpot väljer du måldatabasen.
2. Be en Redshift-administratör att köra SQL-skriptet i den valda databasen.

HubSpot använder denna behörighet för att skapa ett schema för målet under synkroniseringen.

3. Klicka på Testa anslutning.
4. Om anslutningstestet lyckas klickar du på Nästa.

Konfigurera synkroniseringen av dataexporten

1. Välj de datakällor som ska exporteras.
2. Välj de objekt-, kopplings- och händelsetabeller som ska inkluderas.
3. Konfigurera synkroniseringsfrekvensen och starttiden.
4. Klicka på Starta synkronisering.

Vid varje synkronisering exporteras en fullständig ögonblicksbild av de valda uppgifterna till Amazon Redshift.

Övervaka och hantera synkroniseringen

På sidan med synkroniseringsinformation kan du granska följande uppgifter:

• Synkroniseringsstatus.
• Tidpunkt för senaste synkroniseringen.
• Fel.
• Synkroniseringsaktivitet.
• Synkroniseringshistorik.

Så här öppnar du sidan med synkroniseringsdetaljer:

1. I ditt HubSpot-konto navigerar du till Datahantering > Dataintegration.
2. På fliken Appsynkroniseringar söker du efter Amazon Redshift-appsynkroniseringar.
3. Klicka på den Amazon Redshift-synkronisering som du vill granska.

Från sidan med synkroniseringsinformation kan du också utföra följande åtgärder:

• Klicka på Pausa för att pausa synkroniseringen.
• Klicka på Arkivera för att arkivera synkroniseringen.
• Klicka på Synkronisera nu för att manuellt starta en synkronisering.

Synkroniseringsstatus

Åtgärda synkroniseringsfel

När en synkronisering misslyckas:

• Synkroniseringen visas med statusen Misslyckad i HubSpot.
• I detaljerna per tabell visas vilka tabeller som lyckades eller misslyckades.
• Nästa schemalagda synkronisering försöker automatiskt genomföra en fullständig synkronisering igen.
• Du kan klicka på Synkronisera nu för att manuellt starta en ny synkronisering.