BetaHubSpot-Daten nach PostgreSQL oder MySQL exportieren

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.

Zusammenfassung

Verwenden Sie Data Out, um ausgewählte HubSpot CRM-System-Daten in eine von Ihnen verwaltete PostgreSQL- oder MySQL-Datenbank zu exportieren. Sie können Objekt-, Zuordnungs- und Eventdaten mit Tabellen in Ihrer Datenbank synchronisieren und die Daten dann mit SQL abfragen oder sie mit Ihren Business-Intelligence- und Analytics-Tools verwenden.

Bei jeder Synchronisierung wird ein vollständiger Snapshot der ausgewählten Daten erstellt. Wenn eine Synchronisierung erfolgreich ist, wird der vorherige Snapshot in den Zieltabellen ersetzt.

Bevor Sie loslegen

Dies sind die Voraussetzungen:

• Ihre PostgreSQL- oder MySQL-Datenbank muss über die HubSpot-IP-Adressbereiche für Ihre Account-Region erreichbar sein.
• Ihr Datenbankserver muss SSL-Verbindungen unterstützen.
• Sie benötigen einen Datenbankbenutzer mit den erforderlichen Berechtigungen:
  • PostgreSQL: CREATE Berechtigung und Schreibzugriff auf das Zielschema.
  • MySQL: CREATE Berechtigungen für die Datenbank und Schreibzugriff.
• Stellen Sie sicher, dass Ihr Datenbankbenutzer Tabellen erstellen und Daten schreiben kann.
• Lassen Sie Ihren HubSpot-Account und Ihre Datenbankkonsolen in getrennten Registerkarten geöffnet.

HubSpot-IP-Adressen zulassen

Fügen Sie den HubSpot-IP-Bereich für Ihre Account-Region zur Zulassungsliste Ihres Datenbankservers hinzu.

Einschränkungen und Wissenswertes

• Bei jedem Synchronisierungslauf wird ein vollständiger Snapshot der ausgewählten Daten erstellt.
• Eine erfolgreiche Synchronisierung ersetzt den vorherigen Snapshot in den Zieltabellen.
• HubSpot speichert keine früheren Snapshots.
• Wenn eine Tabelle während einer Synchronisierung fehlschlägt, bleiben ihre vorherigen Daten bis zur nächsten erfolgreichen Synchronisierung verfügbar.
• Jeder Objekttyp, Event-Typ oder jedes Zuordnungpaar kann in einer wiederkehrenden PostgreSQL-Synchronisierung und einer wiederkehrenden MySQL-Synchronisierung pro Account berücksichtigt werden.
• Jede Synchronisierung ersetzt die Zieltabelle. Zuschüsse auf Tabellenebene oder Einstellungen, die Ihrem Datenbankanbieter hinzugefügt wurden, werden zwischen den Synchronisierungen nicht beibehalten.
• Wenn Sie die Verknüpfung mit einem anderen Datenbankbenutzer wiederherstellen, müssen Sie diesem Benutzer Zugriff auf vorhandene, von HubSpot verwaltete Schemas, Datenbanken oder Tabellen gewähren.

HubSpot mit PostgreSQL oder MySQL verbinden

1. Klicken Sie in Ihrem HubSpot-Account auf Mehr und gehen Sie dann zu Datenmanagement > Data Studio. Wenn Mehr nicht in Ihrem Account angezeigt wird, gehen Sie direkt zu Datenmanagement > Data Studio.
2. Klicken Sie oben rechts auf Externe Datenquelle verknüpfen.
3. Suchen Sie im Bereich Datenquelle hinzufügen nach dem Datenbankanbieter, oder suchen Sie nach ihm.
4. Klicken Sie auf PostgreSQL oder MySQL.
5. Geben Sie die Details der Datenbankverbindung ein:
   • Gastgeber
   • Hafen
   • SSL
   • Benutzername
   • Passwort
6. Geben Sie für PostgreSQL den Namen der Datenbank ein, in der HubSpot das Schema erstellen soll.
7. Klicken Sie auf Mit PostgreSQL verknüpfen oder Mit MySQL verbinden.

HubSpot verwendet den verknüpften Datenbankbenutzer, um Tabellen zu erstellen und Daten in Ihre Datenbank zu laden.

Die Synchronisierung konfigurieren

1. Wählen Sie die Datenquellen aus, die exportiert werden sollen:
   • Objekte
   • Zuordnungen
   • Events
2. Wählen Sie die Objekte, Eigenschaften, Zuordnungen oder Events aus, die berücksichtigt werden sollen.
3. Wählen Sie aus, wie oft die Synchronisierung durchgeführt und wann sie gestartet werden soll.
4. Klicken Sie auf Synchronisierung starten.

Die verfügbaren Synchronisierungshäufigkeiten können während der Beta-Phase variieren. Zu den Optionen gehören einmalig, alle 6 Stunden, alle 12 Stunden, täglich, wöchentlich oder monatlich.

Zugriff auf Ihre exportierten Daten

HubSpot erstellt für jedes Ziel ein von HubSpot verwaltetes Schema oder eine Datenbank.

PostgreSQL

PostgreSQL-Tabellen verwenden das folgende Format:

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

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"

MySQL

MySQL-Tabellen haben das folgende Format:

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

Zum Beispiel:

hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES
hubspot_data_out_456.EVENTS_VISITED_PAGE
hubspot_data_out_456.ASSOCIATIONS_CONTACTS_TO_COMPANIES

Das genaue Schema oder den Datenbanknamen finden Sie auf der Seite für die Synchronisierungskonfiguration.

Tabellen- und Spaltennamen

Tabellen- und Spaltennamen basieren auf den exportierten Daten. PostgreSQL-Bezeichner können bis zu 63 Zeichen enthalten. MySQL-Identifikatoren können bis zu 64 Zeichen enthalten. Längere Namen werden gekürzt, um dem geltenden Limit zu entsprechen.

HubSpot erstellt PostgreSQL-Tabellen und -Spalten mit Namen in Anführungszeichen, bei denen die Groß-/Kleinschreibung beibehalten wird. Verwenden Sie beim Abfragen von PostgreSQL doppelte Anführungszeichen und entsprechen Sie der Großschreibung im Tabellennamen und Spaltennamen.

Verwenden Sie für MySQL Backticks und entsprechen Sie der angezeigten Großschreibung. Die Groß- und Kleinschreibung für Tabellennamen kann je nach Konfiguration Ihres MySQL-Servers variieren.

Arten von Spalten

Die PROPERTIES Spalte in der OBJECT_WITH_OBJECT_PROPERTIES Tabelle wird als JSON-formatierte Zeichenfolge gespeichert. Sie wird wie TEXT in PostgreSQL und LONGTEXT MySQL gespeichert, nicht als nativer JSON-Spaltentyp.

Objekttabellen

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

OBJECT_PROPERTIES

Diese Tabelle enthält eine Zeile für jeden Wert der Objekt-Eigenschaft.

OBJECT_WITH_OBJECT_PROPERTIES

Diese Tabelle enthält eine Zeile für jeden Datensatz. Ausgewählte Eigenschaften werden in der PROPERTIES Spalte gruppiert.

In dieser Tabelle sind die Objektdaten für verschiedene Objekttypen zusammengefasst. Filtern Sie nach OBJECTTYPEID , um Datensätze für einen bestimmten Objekttyp zu lesen.

• Kontakte: 0-1
• Benutzerdefinierte Objekte: 2-{unique_id}, wie 2-12345

OBJECT_PROPERTIES_HISTORY

Diese Tabelle enthält den Änderungsverlauf der Eigenschaften. Sie enthält eine Zeile für jeden Verlaufswert einer Eigenschaft.

Um den vollständigen Verlauf für einen bestimmten Datensatz und eine bestimmte Eigenschaft anzuzeigen, ordnen Sie die Ergebnisse nach UPDATEDAT.

Zuordnung Tabellen

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

ASSOCIATIONS

Diese Tabelle enthält eine Zeile für jede ausgewählte Zuordnung zwischen zwei Datensätzen.

ASSOCIATION_DEFINITIONS

Diese Tabelle enthält eine Zeile für jede ausgewählte Zuordnung.

Paarspezifische Zuordnungstabellen

Für ausgewählte Zuordnungspaare kann HubSpot auch Tabellen im folgenden Format exportieren:

ASSOCIATIONS_<FROM_OBJECT_TYPE>_TO_<TO_OBJECT_TYPE>

Zum Beispiel:

ASSOCIATIONS_CONTACTS_TO_COMPANIES

Diese Tabellen enthalten Zuordnungsdatensätze und Metadaten für Zuordnungendefinitionen.

Event-Tabellen

Wenn Sie Event-Daten auswählen, exportiert HubSpot eine Tabelle für jeden Event-Typ. Event-Tabellennamen haben das folgende Format:

EVENTS_<EVENT_NAME>

Zum Beispiel:

EVENTS_VISITED_PAGE

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

Überwachen Sie Ihre Synchronisierung

1. Klicken Sie in Ihrem HubSpot-Account auf Mehr und gehen Sie dann zu Datenmanagement > Datenintegration. Wenn Mehr nicht in Ihrem Account angezeigt wird, gehen Sie direkt zu Datenmanagement > Datenintegration.
2. Klicken Sie links auf App-Synchronisierungen.
3. Suchen Sie nach der PostgreSQL- oder MySQL-Synchronisierung oder wählen Sie diese aus.

Auf der Seite mit den Synchronisierungsdetails können Sie den Synchronisierungsstatus, den Zeitpunkt der letzten Synchronisierung, Fehler, die SynchronisierungsAktivität und den Synchronisierungsverlauf anzeigen. Sie können die Synchronisierung auch pausieren, archivieren oder manuell ausführen.

Status der Synchronisierung

Synchronisierungsfehler beheben

Wenn eine Synchronisierung fehlschlägt:

• Die HubSpot-Benutzeroberfläche zeigt den Status Fehlgeschlagen und Details auf Tabellenebene an, die angeben, welche Tabellen erfolgreich waren oder fehlgeschlagen sind.
• Eine Tabelle wird erst aktualisiert, nachdem HubSpot das Laden aller Daten abgeschlossen hat.
• Wenn eine Tabelle fehlschlägt, bleiben ihre vorherigen Daten bis zur nächsten erfolgreichen Synchronisierung erhalten.
• Die nächste geplante Synchronisierung versucht automatisch erneut, die vollständige Synchronisierung durchzuführen.
• Sie können eine Synchronisierung manuell über die Seite mit den Synchronisierungsdetails durchführen.

Tabellen, die während einer früheren Ausführung erfolgreich waren, werden nicht geändert, wenn eine spätere Ausführung fehlschlägt.

FAQs

Wie kann ich die exportierten Daten abfragen?

Fragen Sie die Tabellen im Zielschema oder in der Zieldatenbank mit SQL ab.

PostgreSQL

-- Read all contact records
SELECT *
FROM your_database.hubspot_data_out_456."OBJECT_WITH_OBJECT_PROPERTIES"
WHERE "OBJECTTYPEID" = '0-1';

-- Read a property from the PROPERTIES column
SELECT
  "OBJECTID",
  json_extract_path_text("PROPERTIES"::json, 'email') AS email
FROM your_database.hubspot_data_out_456."OBJECT_WITH_OBJECT_PROPERTIES"
WHERE "OBJECTTYPEID" = '0-1';

MySQL

-- Read all contact records
SELECT *
FROM `hubspot_data_out_456`.`OBJECT_WITH_OBJECT_PROPERTIES`
WHERE `OBJECTTYPEID` = '0-1';

-- Read a property from the PROPERTIES column
SELECT
  `OBJECTID`,
  JSON_EXTRACT(`PROPERTIES`, '$.email') AS email
FROM `hubspot_data_out_456`.`OBJECT_WITH_OBJECT_PROPERTIES`
WHERE `OBJECTTYPEID` = '0-1';

Kann ich einen Datentyp in mehreren Synchronisierungen exportieren?

Jeder Objekttyp, Event-Typ oder jedes Zuordnungpaar kann in einer wiederkehrenden PostgreSQL-Synchronisierung und einer wiederkehrenden MySQL-Synchronisierung pro HubSpot-Account berücksichtigt werden.

Wenn z. B. Kontakte bereits in ein wiederkehrendes PostgreSQL-Ziel exportiert wurden, können Sie erst dann Kontakte zu einer anderen wiederkehrenden PostgreSQL-Konfiguration hinzufügen, wenn Sie die erste Konfiguration archivieren. Sie können weiterhin gleichzeitig Kontakte in eine wiederkehrende MySQL-Konfiguration exportieren.

Werden objektspezifische Tabellen unterstützt?

Objektspezifische Tabellen wie OBJECTS_CONTACTS, werden derzeit nicht unterstützt. Verwenden OBJECT_WITH_OBJECT_PROPERTIES und filtern nach OBJECTTYPEID , um Datensätze für einen bestimmten Objekttyp abzurufen.

Werden vertrauliche Daten unterstützt?

Vertrauliche Daten werden derzeit nicht für Data Out unterstützt. Vertrauliche Eigenschaften werden möglicherweise von Exporten ausgeschlossen.

Speichert HubSpot frühere Snapshots?

Nein. Bei jeder erfolgreichen Synchronisierung wird die Zieltabelle durch den neuesten Snapshot ersetzt. HubSpot speichert keine früheren Snapshots.

Wenn eine Tabelle während einer Synchronisierung fehlschlägt, bleiben ihre vorherigen Daten an Ort und Stelle, bis diese Tabelle erfolgreich aktualisiert wird.

Verwendet HubSpot einen Staging-Bucket, den ich verwalte?

Nein. HubSpot exportiert die Daten als Parquet und verwaltet die Staging-Umgebung intern. Sie müssen keinen kundeneigenen Staging-Bucket für PostgreSQL oder MySQL bereitstellen.

Was passiert, wenn ich den Datenbankbenutzer ändere?

Wenn Sie die Verknüpfung mit einem anderen Datenbankbenutzer wiederherstellen, müssen Sie dem neuen Benutzer Zugriff auf vorhandene, von HubSpot verwaltete Schemas, Datenbanken oder Tabellen gewähren.