Zum Hauptinhalt
HubSpot Wissensdatenbank
Hinweis: Dieser Artikel wird aus Kulanz zur Verfügung gestellt. Er wurde automatisch mit einer Software übersetzt und unter Umständen nicht korrekturgelesen. Die englischsprachige Fassung gilt als offizielle Version und Sie können dort die aktuellsten Informationen finden. Hier können Sie darauf zugreifen.

Greifen Sie über PostgreSQL oder MySQL auf Ihre HubSpot-Daten zu

Zuletzt aktualisiert am: 26 Oktober 2026

Mit einem der folgenden Abonnements verfügbar (außer in den angegebenen Fällen):

Verwenden Sie Data Out for PostgreSQL und MySQL, um ausgewählte HubSpot CRM-System-Daten in Tabellen in Ihrer eigenen Datenbank zu exportieren. 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.

HubSpot-Guthaben erforderlich für bestimmte Funktionen Für die direkte Synchronisierung von Daten aus einer einzigen Warehouse-Quelle in Data Studio mit dem CRM-System von HubSpot werden kein HubSpot-Guthaben verbraucht. Wenn Sie die Daten vor der Synchronisierung in Data Studio vorbereiten (z. B. indem Sie berechnete Felder erstellen oder sie mit anderen Datenquellen verbinden), werden für diese Aktionen HubSpot-Guthabeneinheiten verbraucht.



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.
  • Jedes Objekt, jeder Event-Typ oder jedes Zuordnungpaar kann in einer wiederkehrenden PostgreSQL-Synchronisierung und einer wiederkehrenden MySQL-Synchronisierung pro HubSpot-Account berücksichtigt werden. Diese Synchronisierungen sind unabhängig voneinander und von anderen Data Out-Anbietern.
  • 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.
  • Bei Tabellen- und Spaltennamen wird in PostgreSQL zwischen Groß- und Kleinschreibung unterschieden, in MySQL kann zwischen Groß- und Kleinschreibung unterschieden werden. Überprüfen Sie die Abfragesyntax , bevor Sie Abfragen schreiben.

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

Sie können die folgenden Daten von HubSpot mit PostgreSQL oder MySQL 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 Zieldatenbank. Dies gilt nur für PostgreSQL. Bei MySQL erstellt HubSpot die Datenbank.
  • 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 und lädt sie direkt in Tabellen in Ihrer Datenbank. PostgreSQL und MySQL verwenden keinen Staging-Bucket im Besitz des Kunden. HubSpot verwaltet das Staging intern.

Finden Sie Ihre Daten in Ihrer Datenbank

HubSpot erstellt eine Tabelle pro Datenquelle in einem von HubSpot verwalteten Schema, das nach Ihrem Ziel benannt ist. Den genauen Namen des Schemas finden Sie auf der Konfigurationsseite Ihrer Synchronisierung.

  • PostgreSQL: <database>.hubspot_data_out_<destination-id>.<table-name>
  • MySQL: hubspot_data_out_<destination-id>.<table-name>. In MySQL sind Schema und Datenbank dasselbe Konzept, und HubSpot erstellt es. Es gibt keine separate Datenbankebene zur Auswahl.

Zum Beispiel in PostgreSQL:

  • 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

Zum Beispiel in MySQL:

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

Bei jeder Synchronisierung wird die Tabelle durch den neuesten Snapshot ersetzt. 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 an Ort und Stelle.

Tabellen- und Spaltennamen

Tabellen- und Spaltennamen stammen aus den exportierten Daten. PostgreSQL-Bezeichner sind auf 63 Zeichen und MySQL-Bezeichner auf 64 Zeichen begrenzt. HubSpot verkürzt längere Namen, um passend zu sein.

Fall der Kennung

Die Groß-/Kleinschreibung der ID ist wichtig. HubSpot erstellt alle Tabellen und Spalten mit Namen in Großbuchstaben in Anführungszeichen, die mit den Tabellen in diesem Artikel übereinstimmen.

  • PostgreSQL: Umschließen Sie Namen in doppelte Anführungszeichen genau wie gezeigt. PostgreSQL faltet Namen ohne Anführungszeichen in Kleinbuchstaben, damit sie nicht übereinstimmen.
  • MySQL: Verwenden Sie Backticks und passen Sie die angezeigte Groß-/Kleinschreibung an. Die Groß- und Kleinschreibung des Tabellennamens hängt von Ihrer Serverkonfiguration ab.

PostgreSQL-Beispiel:

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

MySQL-Beispiel:

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

Arten von Spalten

Spaltentypen folgen den exportierten Daten und werden PostgreSQL- und MySQL-Typen wie folgt zugeordnet:

Exportierter Typ PostgreSQL MySQL
Schnur TEXT LONGTEXT
Zahl (32-Bit) INTEGER INT
Zahl (64 Bit) BIGINT BIGINT
Zeitstempel TIMESTAMP DATETIME(6)
Boolesch BOOLEAN TINYINT(1)
Dezimal NUMERIC DECIMAL

Bitte beachten: Die PROPERTIES Spalte in OBJECT_WITH_OBJECT_PROPERTIES wird als JSON-formatierte Zeichenfolge exportiert. Sie wird wie TEXT in PostgreSQL oder LONGTEXT in MySQL gespeichert, nicht als JSON-Spaltentyp. Beispiele für Abfragen finden Sie in den FAQs.

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.

Name der Spalte Typ Beschreibung
OBJECTTYPEID Schnur Die ID des Objekts. Kontakte verwenden 0-1zum Beispiel .
OBJECTID Zahl Die ID des Datensatzes.
NAME Schnur Der Name der Eigenschaft.
VALUE Schnur Der Wert der Eigenschaft.
UPDATEDAT Zeitstempel Das Datum und die Uhrzeit der letzten Aktualisierung des Eigenschaften-Werts in HubSpot.
INGESTEDAT Zeitstempel Das Datum und die Uhrzeit, zu der die Daten zuletzt in die Exportquelle aufgenommen wurden.

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.

Name der Spalte Typ Beschreibung
OBJECTTYPEID Schnur Die ID des Objekts. Kontakte verwenden 0-1zum Beispiel .
OBJECTID Zahl Die ID des Datensatzes.
PROPERTIES Text (JSON) Die ausgewählten Eigenschaften für den Datensatz als JSON-formatierte Zeichenfolge.
UPDATEDAT Zeitstempel Das Datum und die Uhrzeit der letzten Aktualisierung der ausgewählten Eigenschaften des Datensatzes in HubSpot.
INGESTEDAT Zeitstempel Das Datum und die Uhrzeit, zu der die Daten zuletzt in die Exportquelle aufgenommen wurden.

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.

Name der Spalte Typ Beschreibung
OBJECTTYPEID Schnur Die ID des Objekts.
OBJECTID Zahl Die ID des Datensatzes.
NAME Schnur Der Name der Eigenschaft.
VALUE Schnur Der Wert der Eigenschaft zu diesem Zeitpunkt.
UPDATEDAT Zeitstempel Das Datum und die Uhrzeit, zu der der Wert in HubSpot festgelegt wurde.
INGESTEDAT Zeitstempel Das Datum und die Uhrzeit, zu der die Daten zuletzt in die Exportquelle aufgenommen wurden.

Ü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.

Name der Spalte Typ Beschreibung
COMBINEDASSOCIATIONTYPEID Schnur Die eindeutige ID für die Zuordnung definition.
ASSOCIATIONCATEGORY Schnur Der Ursprung des Zuordnungstyps. Werte können , HUBSPOT_DEFINED USER_DEFINEDoder enthalten INTEGRATOR_DEFINED.
ASSOCIATIONTYPEID Zahl Die ID für die Zuordnung innerhalb ihrer Kategorie.
FROMOBJECTID Zahl Die ID des Quelldatensatzes.
TOOBJECTID Zahl Die ID des Zieldatensatzes.
INGESTEDAT Zeitstempel Das Datum und die Uhrzeit, zu der die Daten zuletzt in die Exportquelle aufgenommen wurden.

ASSOCIATION_DEFINITIONS

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

Name der Spalte Typ Beschreibung
COMBINEDASSOCIATIONTYPEID Schnur Die eindeutige ID für die Zuordnung definition.
CATEGORY Schnur Der Ursprung des Zuordnungstyps. Werte können , HUBSPOT_DEFINED USER_DEFINEDoder enthalten INTEGRATOR_DEFINED.
ID Zahl Die ID für die Zuordnung innerhalb ihrer Kategorie.
FROMOBJECTTYPEID Schnur Die ID des Quellobjekts.
TOOBJECTTYPEID Schnur Die ID des Zielobjekts.
NAME Schnur Der Name der Definition der Zuordnung.
LABEL Schnur Das Label der Zuordnung Definition
INGESTEDAT Zeitstempel Das Datum und die Uhrzeit, zu der die Daten zuletzt in die Exportquelle aufgenommen wurden.
ISMAINASSOCIATIONDEFINITION Boolesch Ob HubSpot diese Zuordnung als primäre Zuordnung in zugeordneten Datensätzen anzeigt.

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.

Name der Spalte Typ Beschreibung
COMBINEDASSOCIATIONTYPEID Schnur Die eindeutige ID für die Zuordnung definition.
ASSOCIATIONCATEGORY Schnur Der Ursprung des Zuordnungstyps. Werte können , HUBSPOT_DEFINED USER_DEFINEDoder enthalten INTEGRATOR_DEFINED.
ASSOCIATIONTYPEID Zahl Die ID für die Zuordnung innerhalb ihrer Kategorie.
[FROMOBJECT]_OBJECTID Zahl Die ID des Quelldatensatzes. Zum Beispiel CONTACT_OBJECTID.
[TOOBJECT]_OBJECTID Zahl Die ID des Zieldatensatzes. Zum Beispiel COMPANY_OBJECTID.
INGESTEDAT Zeitstempel Das Datum und die Uhrzeit, zu der die Daten zuletzt in die Exportquelle aufgenommen wurden.
TOOBJECTTYPEID Schnur Die ID des Zielobjekts.
FROMOBJECTTYPEID Schnur Die ID des Quellobjekts.
NAME Schnur Der Name der Definition der Zuordnung.
LABEL Schnur Das Label der Zuordnung Definition
ISMAINASSOCIATIONDEFINITION Boolesch Ob HubSpot diese Zuordnung als primäre Zuordnung in zugeordneten Datensätzen anzeigt.

Ü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.

Name der Spalte Typ Beschreibung
EVENTTYPEID Schnur Die Event-Typ-ID.
ID Schnur Die eindeutige Event-ID.
OBJECTTYPEID Schnur Die ID des Objekts, das dem Event zugeordnet ist.
OBJECTID Zahl Die ID des Datensatzes, der dem Event zugeordnet ist.
INGESTEDAT Zeitstempel Das Datum und die Uhrzeit, zu der das Event in die Exportquelle aufgenommen wurde.
OCCURREDATDATEINT Zahl Das Event-Datum als Ganzzahl im YYYYMMDD Format.
OCCURREDAT Zeitstempel Das Datum und die Uhrzeit, zu der das Event aufgetreten ist.
PROPERTY_<PROPERTY_NAME> Schnur Eine ausgewählte Event-Eigenschaft. Beispielsweise wird eine Eigenschaft mit dem Namen page_title als PROPERTY_PAGE_TITLEexportiert.

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 PostgreSQL- und MySQL-Synchronisierungen in HubSpot überwachen. Eine Synchronisierung kann einen der folgenden Zustände haben:

Status Bedeutung
Synchronisierung Derzeit läuft ein Synchronisierungslauf.
Synchronisiert Die letzte Synchronisierung wurde erfolgreich abgeschlossen.
Fehlgeschlagen Bei der letzten Synchronisierungsausführung ist ein Fehler aufgetreten.
Archivierte Die Synchronisierungskonfiguration wurde archiviert oder entfernt.

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.

PostgreSQL

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. Wandeln Sie die Spalte zuerst in JSON um, da sie als Text gespeichert ist:

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

Alle Kontaktdatensätze lesen:

SELECT * FROM `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(`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?

Jedes Objekt, jeder Event-Typ oder jedes Zuordnungpaar kann in einer wiederkehrenden PostgreSQL-Synchronisierung und einer wiederkehrenden MySQL-Synchronisierung pro HubSpot-Account berücksichtigt werden. Diese Synchronisierungen sind unabhängig voneinander und von anderen Data Out-Anbietern. Wenn z. B. Kontakte bereits in ein wiederkehrendes PostgreSQL-Ziel exportiert wurden, können Sie erst dann Kontakte zu einer anderen wiederkehrenden PostgreSQL-Synchronisierung hinzufügen, wenn Sie die erste Synchronisierung archiviert haben. Sie können weiterhin gleichzeitig Kontakte in eine wiederkehrende MySQL-Synchronisierung exportieren.

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 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 frühere Snapshots nicht beibehalten werden.
War dieser Artikel hilfreich?
Dieses Formular wird nur verwendet, um Feedback zur Dokumentation zu sammeln. Erfahren Sie, wie Sie Hilfe bei Fragen zu HubSpot erhalten können.

Verwandte Artikel

Inhalt /de/data-management/access-your-hubspot-data-from-postgresql-or-mysql Menü

Verwandte Artikel

New to HubSpot? Use these guides to get started.