BetaZugriff auf Ihre HubSpot-Daten von Amazon Redshift aus

Verwenden Sie Data Out for Amazon Redshift, um ausgewählte HubSpot CRM-System-Daten in Tabellen in einer Amazon Redshift-Datenbank zu exportieren, die Sie besitzen. Bei jedem Synchronisierungslauf wird eine vollständige Momentaufnahme der ausgewählten Daten geschrieben und die vorherige Momentaufnahme ersetzt. Nach der Synchronisierung können Sie die Tabellen mit SQL oder Ihren bevorzugten BI- und Analytics-Tools abfragen, um HubSpot-Daten mit anderen Geschäftsdaten zu kombinieren.

Bitte beachten: Wenn Sie ein Super-Admin sind, melden Sie Ihren Account für die Beta-Version von Data Studio an, um diese Funktion zu nutzen.

Einschränkungen und Wissenswertes

Bevor Sie mit dieser Funktion beginnen, sollten Sie sich im Voraus darüber im Klaren sein, welche Schritte unternommen werden sollten und welche Einschränkungen die Funktion mit sich bringt und welche Konsequenzen sich daraus ergeben können.

• Bei jeder Synchronisierung werden die Zieltabellen durch den neuesten Snapshot ersetzt. HubSpot speichert keine früheren Snapshots in Redshift.
• HubSpot löscht keine Parquet-Dateien, die es in Ihrem S3-Bucket bereitstellt. Um sie automatisch zu entfernen, richten Sie eine S3-Lifecycle-Richtlinie für den Bucket oder das Präfix ein.
• Jedes Objekt, jeder Eventtyp oder jedes Zuordnungpaar kann in einer wiederkehrenden Redshift-Datenabsynchronisierung pro HubSpot-Account berücksichtigt werden.
• Vertrauliche Daten werden noch nicht unterstützt. Vertrauliche Eigenschaften werden möglicherweise von Exporten ausgeschlossen.
• Objektspezifische Tabellen wie OBJECTS_CONTACTS, werden noch nicht unterstützt.

Verständnis der Daten, die Sie exportieren können

Sie können die folgenden Daten von HubSpot mit Amazon Redshift synchronisieren:

• Objekte: Standard- und benutzerdefinierte Objekte wie Kontakte, Unternehmen, Deals, Tickets und Produkte.
• Datensätze: einzelne Datensätze für die ausgewählten Objekte.
• Eigenschaften: ausgewählte Eigenschaftswerte und Eigenschafts-Verlauf in Datensätzen.
• Zuordnungen: ausgewählte Beziehungen zwischen Datensätzen, einschließlich Zuordnungen Definitionen.
• Events: ausgewählte standardmäßige HubSpot-Events und benutzerdefinierte verhaltensorientierte Events, einschließlich ausgewählter Event-Eigenschaften.

In den Objekttabellen werden Daten für verschiedene Objekte zusammengefasst. Wenn Sie eine Objekttabelle lesen, verwenden Sie diese Option OBJECTTYPEID , um nach einem bestimmten Objekt zu filtern. Kontakte verwenden 0-1zum Beispiel . Benutzerdefinierten Objekten wird bei ihrer Erstellung eine ID zugewiesen und sie werden als 2-{unique_id}identifiziert, z. B 2-12345. . .

Grundlegendes zum Exportformat

Während der Einrichtung können Sie Folgendes auswählen:

• Die Redshift-Datenbank und der Cluster oder die serverlose Arbeitsgruppe, in der HubSpot Tabellen erstellt.
• Der S3-Bucket, den HubSpot zum Bereitstellen von Daten in der Staging-Umgebung verwendet, bevor sie in Redshift geladen werden.
• Die zu synchronisierenden Datenquellen: Objekte, Events, Zuordnungen oder eine Kombination dieser Quellen.
• Der Zeitplan für die Synchronisierung.

HubSpot exportiert die Daten als Parquet-Dateien, streicht die Dateien in Ihrem S3-Bucket und lädt sie in Redshift-Tabellen.

Bitte beachten Sie: HubSpot löscht keine Daten aus dem Staging-Bucket. Es wird empfohlen, eine Bucket-Lifecycle-Richtlinie festzulegen, um den Bucket automatisch zu bereinigen.

Finden Sie Ihre Daten in Redshift

HubSpot erstellt eine Tabelle pro Datenquelle in einem von HubSpot verwalteten Schema, das nach Ihrem Ziel benannt ist:

<database>.hubspot_data_out_<destination-id>.<table-name>

Sie finden den Schemanamen auf der Konfigurationsseite Ihrer Redshift-Synchronisierung. Zum Beispiel:

• your_database.hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES
• your_database.hubspot_data_out_456.EVENTS_VISITED_PAGE
• your_database.hubspot_data_out_456.ASSOCIATIONS_CONTACTS_TO_COMPANIES

Bei jeder Synchronisierung wird die Tabelle durch den neuesten Snapshot ersetzt. Wenn eine Tabelle während einer Synchronisierung fehlschlägt, bleiben ihre vorherigen Daten bis zur nächsten erfolgreichen Synchronisierung an Ort und Stelle.

HubSpot streicht Parquet-Dateien in Ihrem S3-Bucket unter einem von HubSpot verwalteten Präfix und lädt sie dann in Redshift:

s3://<bucket>/<prefix>/hubspot-dataout/<portal-id>/<destination-id>/<run-id>/<table-name>/

Diese Staging-Dateien bleiben in Ihrem Bucket, bis Sie sie entfernen. Um sie automatisch zu entfernen, konfigurieren Sie eine S3-Lifecycle-Richtlinie für den Bucket oder das Präfix.

Bitte beachten: Tabellen- und Spaltennamen stammen aus den exportierten Daten. Sie können gekürzt werden, um Redshifts Limit von 127 Zeichen zu erfüllen. Spaltentypen folgen den exportierten Daten.

Objekttabellen überprüfen

Wenn Sie Objektdaten auswählen, exportiert HubSpot die folgenden Tabellen.

OBJECT_PROPERTIES

Diese Tabelle enthält eine Zeile pro Eigenschaftswert. Um ein bestimmtes Objekt zu lesen, filtern Sie nach OBJECTTYPEID.

OBJECT_WITH_OBJECT_PROPERTIES

Diese Tabelle enthält eine Zeile pro Datensatz, in der die ausgewählten Eigenschaften in einer einzigen PROPERTIES Spalte gruppiert sind. Um ein bestimmtes Objekt zu lesen, filtern Sie nach OBJECTTYPEID.

OBJECT_PROPERTIES_HISTORY

Diese Tabelle enthält den Änderungsverlauf der Eigenschaften. Im Gegensatz zu OBJECT_PROPERTIES, das nur den aktuellen Wert enthält, enthält diese Tabelle eine Zeile für jeden Verlaufswert einer Eigenschaft. Um die vollständige Chronik für einen einzelnen Datensatz und eine einzelne Eigenschaft anzuzeigen, ordnen Sie nach UPDATEDAT.

Überprüfen von Zuordnungstabellen

Wenn Sie Zuordnung auswählen, exportiert HubSpot Zuordnungen Datensätze und Zuordnungen Definitionen.

VERBÄNDE

Diese Tabelle enthält eine Zeile pro ausgewählter Zuordnung zwischen zwei Datensätzen.

ASSOCIATION_DEFINITIONS

Diese Tabelle enthält eine Zeile pro ausgewählter Zuordnung.

ASSOCIATIONS_<FROM_OBJECT>_TO_<TO_OBJECT>

Für ausgewählte Zuordnungspaare kann HubSpot auch paarspezifische Zuordnungstabellen exportieren, z. B ASSOCIATIONS_CONTACTS_TO_COMPANIES. . Diese Tabellen enthalten Zuordnungsdatensätze zusammen mit Metadaten für Zuordnungen.

Überprüfen von Event-Tabellen

Wenn Sie Event-Daten auswählen, exportiert HubSpot eine Tabelle pro Event-Typ. Tabellennamen haben das Format EVENTS_<EVENT_NAME>, z. B EVENTS_VISITED_PAGE. . .

Jede Event-Tabelle enthält Standard-Event-Spalten und eine Spalte für jede ausgewählte Event-Eigenschaft.

Verwalten Sie den Synchronisierungszeitplan

Sie konfigurieren den Synchronisierungszeitplan während der Einrichtung in HubSpot. Sie können eine erneute Synchronisierung von HubSpot auch manuell auslösen. Bei jedem Synchronisierungsdurchlauf wird eine vollständige Momentaufnahme der ausgewählten Daten erstellt. Um das Datenvolumen zu steuern, wählen Sie aus, welche Objekte, Events, Zuordnungen und Eigenschaften einbezogen werden sollen.

Bitte beachten: Während der Beta-Phase ist möglicherweise nur eine begrenzte Anzahl von Synchronisierungshäufigkeiten verfügbar, z. B. einmal, alle 6 Stunden, alle 12 Stunden, täglich, wöchentlich und monatlich. In zukünftigen Versionen werden möglicherweise zusätzliche Häufigkeitsoptionen hinzugefügt.

Synchronisierungen überwachen und Fehler behandeln

Sie können Amazon Redshift-Synchronisierungen in HubSpot überwachen. Eine Synchronisierung kann einen der folgenden Zustände haben:

Wenn eine Synchronisierung fehlschlägt:

• HubSpot zeigt den Status "Fehlgeschlagen " mit Details pro Tabelle an, die zeigen, welche Tabellen erfolgreich waren oder welche fehlgeschlagen sind.
• Eine Tabelle wird erst aktualisiert, nachdem HubSpot das Laden aller Daten abgeschlossen hat, sodass Sie nie eine teilweise geladene Tabelle sehen.
• Wenn eine Tabelle fehlschlägt, bleiben ihre vorherigen Daten bis zur nächsten erfolgreichen Synchronisierung an Ort und Stelle.
• Die nächste geplante Synchronisierung versucht automatisch erneut, eine vollständige Synchronisierung durchzuführen.
• Sie können in HubSpot jederzeit manuell eine erneute Synchronisierung auslösen.

Tabellen, die in einer vorherigen Ausführung erfolgreich waren, werden nicht geändert, wenn eine spätere Ausführung fehlschlägt.

FAQs

Wie kann ich die Daten abrufen?

Fragen Sie die Tabellen in Ihrem Zielschema mit SQL ab. Zum Beispiel:

Alle Kontaktdatensätze lesen:

SELECT * FROM your_database.hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES WHERE OBJECTTYPEID = '0-1';

Lesen Sie eine bestimmte Eigenschaft aus der PROPERTIES JSON-Spalte:

SELECT OBJECTID, JSON_EXTRACT_PATH_TEXT(PROPERTIES, 'email') AS email FROM your_database.hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES WHERE OBJECTTYPEID = '0-1';

Kann ich einen Datentyp in mehreren Redshift-Synchronisierungen exportieren?

Jedes Objekt, jeder Eventtyp oder jedes Zuordnungpaar kann in einer wiederkehrenden Redshift-Datenabsynchronisierung pro HubSpot-Account berücksichtigt werden. Wenn beispielsweise Kontakte bereits an ein wiederkehrendes Redshift-Ziel exportiert wurden, können Sie keine Kontakte zu einer anderen wiederkehrenden Redshift-Synchronisierung hinzufügen, bis Sie die erste Synchronisierung archiviert haben.

Werden objektspezifische Tabellen unterstützt?

Nein. Objektspezifische Tabellen wie OBJECTS_CONTACTS, werden noch nicht unterstützt. Verwenden OBJECT_WITH_OBJECT_PROPERTIES und filtern nach OBJECTTYPEID , um Datensätze für ein bestimmtes Objekt abzurufen.

Werden vertrauliche Daten unterstützt?

Nein. Vertrauliche Daten werden für Data Out to Redshift noch nicht unterstützt. Vertrauliche Eigenschaften werden möglicherweise von Exporten ausgeschlossen.

Speichert HubSpot frühere Snapshots?

Nein. Bei jeder Synchronisierung wird die Zieltabelle durch den neuesten Snapshot ersetzt, sodass vorherige Snapshots nicht in Redshift gespeichert werden. HubSpot löscht auch nicht die temporären Parquet-Dateien, die es in Ihrem S3-Bucket bereitstellt. Konfigurieren Sie eine S3-Lifecycle-Richtlinie, sodass sie automatisch abläuft.