HubSpot-Daten nach Amazon Redshift exportieren

Zusammenfassung

Exportieren Sie HubSpot CRM-System-Objekte, -Zuordnungen und -Events nach Amazon Redshift mithilfe der Amazon Redshift-App im HubSpot Marketplace. Sie können die zu exportierenden Daten auswählen, einen Synchronisierungszeitplan konfigurieren und die Synchronisierung Aktivität von HubSpot überwachen.

In diesem Artikel erfahren Sie, wie Sie die App installieren und verknüpfen, eine Datenexportsynchronisierung konfigurieren und die Synchronisierung überwachen oder verwalten.

Bitte beachten: Als Super-Admin können Sie Ihren Account für die Beta-Version der verbesserten Amazon Redshift-Integration anmelden.

Bevor Sie loslegen

Dies sind die Voraussetzungen:

Stellen Sie sicher, dass Sie über Folgendes verfügen:

• Eine AWS Identity and Access Management (IAM)-Rolle, die mit Ihrem HubSpot-Account verknüpft und für den Zugriff auf Ihren AWS-Account konfiguriert ist.
• Ein von Amazon Redshift bereitgestellter Cluster oder eine serverlose Arbeitsgruppe, die HubSpot erreichen kann.
• Ein Amazon S3-Bucket zum Staging temporärer Parquet-Dateien. Der Bucket muss sich in derselben AWS-Region befinden wie Ihr Redshift-Cluster oder Ihre serverlose Arbeitsgruppe. 
• HubSpot kopiert temporäre Parquet-Dateien in den konfigurierten Amazon S3-Staging-Bucket und löscht sie nicht. Um ältere Dateien zu entfernen und die Speicherkosten zu verwalten, erstellen Sie eine S3-Lifecycle-Regel in Ihrem AWS-Konto.
• Ein Redshift-Administrator, der einen einmaligen SQL-Grant für die Zieldatenbank ausführen kann.
• Zugriff auf die HubSpot- und AWS-Konsolen. Es wird empfohlen, beide in separaten Tabs zu öffnen.

Einschränkungen und Wissenswertes

• Jede Synchronisierung erstellt eine vollständige Momentaufnahme der ausgewählten Daten.
• Jede Synchronisierung ersetzt die Zieltabelle. Alle in Redshift hinzugefügten Berechtigungen oder Einstellungen auf Tabellenebene werden zwischen den Synchronisierungen nicht beibehalten.
• Sie steuern den Betrag der exportierten Daten, indem Sie auswählen, welche Objekte, Zuordnungen und Events einbezogen werden sollen.
• Wenn eine Synchronisierung fehlschlägt, versucht die nächste geplante Synchronisierung automatisch die vollständige Synchronisierung erneut.

Installieren und verknüpfen Sie die Amazon Redshift-App

1. Öffnen Sie im HubSpot App Marketplace das Amazon Redshift App-Listing.
2. Wählen Sie die AWS-Rolle aus, die mit Ihrem HubSpot-Account verknüpft ist.
3. Klicken Sie auf Installieren.
4. Klicken Sie auf „Weiter“.
5. Erstellen Sie eine AWS-IAM-Rolle, die mit Ihrem HubSpot-Account verknüpft und für den Zugriff auf Ihren AWS-Account konfiguriert ist.
6. Geben Sie den Amazon-Ressourcennamen (ARN) der Rolle ein.
7. Klicken Sie auf Mit Amazon Redshift verbinden.

Konfigurieren Sie Ihre AWS-Rolle

HubSpot verwendet die verknüpfte AWS-Rolle, um temporäre Parquet-Dateien in Ihren S3-Staging-Bucket zu schreiben und die Dateien in Redshift zu laden.

1. Geben Sie im Feld S3-Bucket-URL die URL des S3-Buckets ein, den HubSpot zum Bereitstellen temporärer Parquet-Dateien verwenden wird.

Sie können ein Präfix in die URL einfügen, um den Zugriff auf einen bestimmten Pfad innerhalb des Buckets einzuschränken. Der Bucket muss sich in derselben AWS-Region befinden wie Ihr Redshift-Cluster oder Ihre serverlose Arbeitsgruppe.

Bitte beachten Sie: HubSpot kopiert Parquet-Dateien standardmäßig in den konfigurierten S3-Staging-Bucket und löscht sie nicht. Erstellen Sie eine S3-Lifecycle-Regel in AWS, um ältere Dateien automatisch zu entfernen.

2. Wählen Sie Ihren Redshift-Bereitstellungstyp aus dem Dropdown-Menü aus:
   • Redshift Serverlos
   • Bereitgestellter Cluster
3. Aktualisieren Sie die verknüpfte AWS-Rolle mit der Berechtigungsrichtlinie für Ihren Bereitstellungstyp:
   • Redshift Serverless: Geben Sie den ARN Ihrer Arbeitsgruppe ein. HubSpot generiert eine Richtlinie, die den ARN enthält. Kopieren Sie die Richtlinie und hängen Sie sie an die verknüpfte AWS-Rolle an.
   • Bereitgestellter Cluster: Kopieren Sie die Richtlinien-Vorlage. Ersetzen Sie YOUR_REGION, YOUR_ACCOUNT_ID, YOUR_CLUSTER_IDund YOUR_DATABASE durch Werte aus Ihrem AWS-Konto und hängen Sie die Richtlinie dann an die verknüpfte AWS-Rolle an.
4. Öffnen Sie in AWS IAM die mit HubSpot verknüpfte Rolle.
5. Ordnen Sie die generierte Berechtigungsrichtlinie der Rolle zu, oder erstellen Sie eine Inlinerichtlinie mit dem Richtlinieninhalt.

6. Aktualisieren Sie in derselben AWS IAM-Rolle die Vertrauensrichtlinie mit der von HubSpot generierten Anweisung.

HubSpot generiert eine andere Vertrauensrichtlinienerklärung basierend auf dem von Ihnen ausgewählten Redshift-Bereitstellungstyp.

Ordnen Sie die AWS-Rolle Redshift zu

Ordnen Sie in Amazon Redshift die gleiche AWS-Rolle zu, die Sie im vorherigen Abschnitt aktualisiert haben, mit Ihrem Redshift-Setup.

• Redshift Serverless: Öffnen Sie die Namespace-Konfigurationsseite für den Namespace, den Sie mit HubSpot verwenden. Klicken Sie auf der Registerkarte Sicherheit und Verschlüsselung auf IAM-Rollen verwalten und wählen Sie dann IAM-Rollen zuordnen aus.
• Bereitgestellter Cluster: Öffnen Sie Ihren Cluster, klicken Sie auf Aktionen und wählen Sie IAM-Rollen > verwalten IAM-Rollen zuweisen aus.

Redshift-Berechtigungen erteilen

1. Wählen Sie in HubSpot die Zieldatenbank aus.
2. Bitten Sie einen Redshift-Administrator, das SQL-Skript in der ausgewählten Datenbank auszuführen.

HubSpot verwendet diese Berechtigung, um während der Synchronisierung ein Schema für das Ziel zu erstellen.

3. Klicken Sie auf Verbindung testen.
4. Wenn der Verbindungstest erfolgreich ist, klicken Sie auf Weiter.

Synchronisierung des Datenexports konfigurieren

1. Wählen Sie die Datenquellen aus, die exportiert werden sollen.
2. Wählen Sie die einzubeziehenden Objekte, Zuordnungen und Eventtabellen aus.
3. Konfigurieren Sie die Synchronisierungshäufigkeit und -startzeit.
4. Klicken Sie auf Synchronisierung starten.

Bei jedem Synchronisierungslauf wird ein vollständiger Snapshot der ausgewählten Daten nach Amazon Redshift exportiert.

Überwachen und verwalten Sie die Synchronisierung

Auf der Seite mit den Synchronisierungsdetails können Sie die folgenden Informationen überprüfen:

• Synchronisierungsstatus.
• Zeitpunkt der letzten Synchronisierung.
• Fehler.
• Aktivitäten synchronisieren.
• Synchronisierungsverlauf.

So öffnen Sie die Seite mit den Synchronisierungsdetails:

1. Gehen Sie in Ihrem HubSpot-Account zu Datenmanagement-Datenintegration > .
2. Suchen Sie auf der Registerkarte App Syncs (App-Synchronisierungen ) nach Amazon Redshift-App-Synchronisierungen.
3. Klicken Sie auf die Amazon Redshift-Synchronisierung, die Sie überprüfen möchten.

Auf der Seite mit den Synchronisierungsdetails können Sie außerdem die folgenden Aktionen durchführen:

• Klicken Sie auf Pause , um die Synchronisierung anzuhalten.
• Klicken Sie auf Archivieren , um die Synchronisierung zu archivieren.
• Klicken Sie auf Jetzt synchronisieren , um eine Synchronisierung manuell zu starten.

Status der Synchronisierung

Synchronisierungsfehler beheben

Wenn eine Synchronisierung fehlschlägt:

• Die Synchronisierung zeigt in HubSpot den Status Fehlgeschlagen an.
• Details pro Tabelle zeigen, welche Tabellen erfolgreich waren oder welche fehlgeschlagen sind.
• Die nächste geplante Synchronisierung versucht automatisch erneut, die vollständige Synchronisierung durchzuführen.
• Sie können auf Jetzt synchronisieren klicken, um manuell eine weitere Synchronisierung zu starten.