HubSpot-gegevens exporteren naar Amazon Redshift

Samenvatting

Exporteer HubSpot CRM-objecten, koppelingen en gebeurtenissen naar Amazon Redshift met behulp van de Amazon Redshift-app in de HubSpot Marketplace. U kunt de te exporteren gegevens selecteren, een synchronisatieschema configureren en de synchronisatieactiviteit vanuit HubSpot volgen.

In dit artikel wordt beschreven hoe je de app installeert en koppelt, een synchronisatie voor gegevensexport configureert en de synchronisatie controleert of beheert.

Let op: als je een superbeheerder, kun je je account aanmelden voor de bètaversie van de verbeterde Amazon Redshift-integratie.

Voordat je aan de slag gaat

Zorg dat je aan de vereisten voldoet

Zorg ervoor dat je over het volgende beschikt:

• Een AWS Identity and Access Management (IAM)-rol die is gekoppeld aan je HubSpot-account en is geconfigureerd om toegang te krijgen tot je AWS-account.
• Een door Amazon Redshift ingericht cluster of een serverloze werkgroep die HubSpot kan bereiken.
• Een Amazon S3-bucket voor het tijdelijk opslaan van Parquet-bestanden. De bucket moet zich in dezelfde AWS-regio bevinden als je Redshift-cluster of serverloze werkgroep.
• HubSpot kopieert tijdelijke Parquet-bestanden naar de geconfigureerde Amazon S3-staging-bucket en verwijdert deze niet. Om oudere bestanden te verwijderen en opslagkosten te beheren, maakt u een S3-levenscyclusregel aan in uw AWS-account.
• Een Redshift-beheerder die een eenmalige SQL-toegangsvergunning kan uitvoeren op de doeldatabase.
• Toegang tot de HubSpot- en AWS-consoles. Het wordt aanbevolen om deze in aparte tabbladen te openen.

Begrijp de beperkingen en aandachtspunten

• Elke synchronisatie levert een volledige momentopname van de geselecteerde gegevens op.
• Elke synchronisatie vervangt de doeltabel. Eventuele machtigingen of instellingen op tabelniveau die in Redshift zijn toegevoegd, blijven niet behouden tussen synchronisaties.
• U bepaalt zelf de hoeveelheid geëxporteerde gegevens door te selecteren welke objecten, koppelingen en gebeurtenissen moeten worden opgenomen.
• Als een synchronisatie mislukt, wordt bij de volgende geplande synchronisatie automatisch opnieuw geprobeerd de volledige synchronisatie uit te voeren.

De Amazon Redshift-app installeren en koppelen

1. Open in de HubSpot App Marketplace de vermelding van de Amazon Redshift-app.
2. Selecteer de AWS-rol die aan je HubSpot-account is gekoppeld.
3. Klik op ‘Installeren’.
4. Klik op Volgende.
5. Maak een AWS IAM-rol aan die is gekoppeld aan je HubSpot-account en is geconfigureerd om toegang te krijgen tot je AWS-account.
6. Voer de Amazon Resource Name (ARN) van de rol in.
7. Klik op 'Verbinden met Amazon Redshift'.

Configureer je AWS-rol

HubSpot gebruikt de gekoppelde AWS-rol om tijdelijke Parquet-bestanden naar je S3-stagingbucket te schrijven en de bestanden in Redshift te laden.

1. Voer in het veld 'S3-bucket-URL' de URL in van de S3-bucket die HubSpot gaat gebruiken om tijdelijke Parquet-bestanden op te slaan.

U kunt een voorvoegsel in de URL opnemen om de toegang te beperken tot een specifiek pad binnen de bucket. De bucket moet zich in dezelfde AWS-regio bevinden als uw Redshift-cluster of serverloze werkgroep.

Let op: HubSpot kopieert Parquet-bestanden standaard naar de geconfigureerde S3-staging-bucket en verwijdert deze niet. Maak een S3-levenscyclusregel aan in AWS om oudere bestanden automatisch te verwijderen.

2. Selecteer je Redshift-implementatietype in het vervolgkeuzemenu:
   • Redshift Serverless
   • Provisioned cluster
3. Werk de gekoppelde AWS-rol bij met het machtigingsbeleid voor uw implementatietype:
   • Redshift Serverless: voer de ARN van je werkgroep in. HubSpot genereert een beleid met de ARN. Kopieer het beleid en koppel het aan de gekoppelde AWS-rol.
   • Provisioned cluster: kopieer de beleidssjabloon. Vervang YOUR_REGION, YOUR_ACCOUNT_ID, YOUR_CLUSTER_ID en YOUR_DATABASE door waarden uit je AWS-account en koppel het beleid vervolgens aan de gekoppelde AWS-rol.
4. Open in AWS IAM de rol die is gekoppeld aan HubSpot.
5. Koppel het gegenereerde machtigingsbeleid aan de rol, of maak een inline-beleid aan met de inhoud van het beleid.

6. Werk in dezelfde AWS IAM-rol het vertrouwensbeleid bij met de door HubSpot gegenereerde verklaring.

HubSpot genereert een andere verklaring voor het vertrouwensbeleid op basis van het door u geselecteerde Redshift-implementatietype.

Koppel de AWS-rol aan Redshift

Koppel in Amazon Redshift dezelfde AWS-rol die je in het vorige gedeelte hebt bijgewerkt aan je Redshift-configuratie.

• Redshift Serverless: open de configuratiepagina van de naamruimte die je met HubSpot gebruikt. Klik op het tabblad Beveiliging en versleuteling op IAM-rollen beheren en selecteer vervolgens IAM-rollen koppelen.
• Provisioned cluster: open je cluster, klik op ‘Acties’ en selecteer ‘IAM-rollen beheren ’ > ‘IAM-rollen koppelen’.

Redshift-machtigingen toekennen

1. Selecteer in HubSpot de doeldatabase.
2. Vraag een Redshift-beheerder om het SQL-script in de geselecteerde database uit te voeren.

HubSpot gebruikt deze machtiging om tijdens de synchronisatie een schema voor de bestemming aan te maken.

3. Klik op 'Verbinding testen'.
4. Als de verbindingstest is geslaagd, klik je op 'Volgende'.

De synchronisatie van de gegevensexport configureren

1. Selecteer de gegevensbronnen die je wilt exporteren.
2. Selecteer de objecten, koppelingen en gebeurtenistabellen die u wilt opnemen.
3. Stel de synchronisatiefrequentie en de starttijd in.
4. Klik op 'Synchronisatie starten'.

Bij elke synchronisatie wordt een volledige momentopname van de geselecteerde gegevens geëxporteerd naar Amazon Redshift.

De synchronisatie controleren en beheren

Op de pagina met synchronisatiegegevens kunt u de volgende informatie bekijken:

• Synchronisatiestatus.
• Tijdstip van de laatste synchronisatie.
• Fouten.
• Synchronisatieactiviteit.
• Synchronisatiegeschiedenis.

Om de pagina met synchronisatiegegevens te openen:

1. Ga in je HubSpot-account naar Gegevensbeheer > Gegevensintegratie.
2. Zoek op het tabblad App-synchronisaties naar Amazon Redshift-app-synchronisaties.
3. Klik op de Amazon Redshift-synchronisatie die je wilt bekijken.

Vanaf de pagina met synchronisatiegegevens kun je ook de volgende acties uitvoeren:

• Klik op 'Pauzeren ' om de synchronisatie te pauzeren.
• Klik op 'Archiveren' om de synchronisatie te archiveren.
• Klik op 'Nu synchroniseren ' om handmatig een synchronisatie te starten.

Synchronisatiestatus

Synchronisatiefouten oplossen

Wanneer een synchronisatie mislukt:

• De synchronisatie krijgt de status 'Mislukt' in HubSpot.
• In de details per tabel wordt weergegeven welke tabellen zijn geslaagd of mislukt.
• Bij de volgende geplande synchronisatie wordt automatisch opnieuw geprobeerd de volledige synchronisatie uit te voeren.
• Je kunt op 'Nu synchroniseren' klikken om handmatig een nieuwe synchronisatie te starten.