BetaHubSpot-Daten nach Microsoft Fabric 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.

Verwenden Sie Data Out, um ausgewählte HubSpot CRM-System-Daten in native Tabellen in einem Microsoft Fabric Warehouse zu exportieren, das Sie besitzen. Sie können Objekt-, Zuordnungs- und Ereignisdaten mit Tabellen in Ihrem Warehouse synchronisieren und diese Daten dann mit SQL abfragen oder 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:

Um Daten nach Microsoft Fabric zu exportieren, benötigen Sie:

• Ein Microsoft Fabric-Arbeitsbereich mit einem Fabric Warehouse
• Ein Microsoft Entra ID-Dienstprinzipal, der dem Fabric-Arbeitsbereich mit der Rolle Mitwirkender hinzugefügt wurde
• Die Mandanten-ID, die Client-ID und das Client-Geheimnis des Dienstprinzipals
• Ihre Fabric Warehouse-SQL-Verbindungszeichenfolge (Serveradresse ohne Portnummer) und der Name des Warehouses

Der Microsoft Entra ID-Dienstprinzipal muss über die Berechtigung zum Erstellen und Verwalten von HubSpot-eigenen Objekten im Fabric Warehouse des Ziels verfügen. Während der Verbindungsvalidierung und -synchronisierung erstellt HubSpot Schemata und Tabellen, fügt Daten ein, benennt Staging-Tabellen um und entfernt temporäre Objekte. Erteilen Sie dem Dienstprinzipal die Rolle Mitwirkender im Fabric-Arbeitsbereich, damit HubSpot Folgendes tun kann:

• Erstellen von Schemata
• Tabellen erstellen
• Zeilen einfügen
• Tabellen im Besitz von HubSpot umbenennen oder ändern
• Von HubSpot eigene Tabellen und Schemata löschen

Ihr Fabric Warehouse-SQL-Endpunkt muss von HubSpot über TCP-Port 1433 erreichbar sein. HubSpot verwendet TLS für alle Verbindungen und validiert das Serverzertifikat.

Wenn Ihr Fabric-Arbeitsbereich den Netzwerkzugriff einschränkt, fügen Sie die Ausgangs-IP-Adressen von HubSpot für Ihre Kontoregion der Zulassungsliste hinzu.

Einschränkungen und Wissenswertes

• Microsoft Fabric Data Out unterstützt nur Fabric Warehouses. Lakehouses werden nicht unterstützt.
• 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, Ereignistyp oder jedes Zuordnungpaar kann in eine wiederkehrende Microsoft Fabric-Synchronisierung pro Konto einbezogen werden.
• Jede Synchronisierung ersetzt die Zieltabelle. Zuschüsse oder Einstellungen auf Tabellenebene, die in Ihrem Fabric Warehouse hinzugefügt wurden, werden zwischen den Synchronisierungen nicht beibehalten.
• Für die erneute Verbindung mit einem anderen Dienstprinzipal muss dieser Dienstprinzipal dem Fabric-Arbeitsbereich mit der Rolle Mitwirkender hinzugefügt werden, bevor der Verbindungstest oder die Synchronisierung erfolgreich sein kann.

HubSpot mit Microsoft Fabric verbinden

Es wird empfohlen, Ihren HubSpot-Account und die Microsoft Fabric-Konsole in separaten Registerkarten zu öffnen.

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 Microsoft Fabric, oder navigieren Sie zu Microsoft Fabric.
4. Klicken Sie auf Installieren und dann auf Weiter.
5. Geben Sie die Mandanten-ID, die Client-ID und das Client-Geheimnis Ihres Dienstprinzipals ein.
6. Geben Sie die folgenden Zieldetails ein:
   • SQL-Verbindungszeichenfolge: die Serveradresse für Ihr Fabric Warehouse, ohne die Portnummer.
   • Lagername: der Name des Stofflagers, in das exportiert werden soll.
7. Klicken Sie auf Verbindung testen. Wenn der Verbindungstest erfolgreich ist, klicken Sie auf Weiter.

Bitte beachten: Vergewissern Sie sich in Ihrem Fabric-Arbeitsbereich, dass der HubSpot-Dienstprinzipal die Rolle Mitwirkender hat, bevor Sie den Verbindungstest ausführen. Es sind keine SQL-Skripts erforderlich, um den Zugriff zu konfigurieren.

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. Tabellen haben 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

Den genauen Namen des Schemas finden Sie auf der Seite zur Konfiguration der Synchronisierung.

Tabellen- und Spaltennamen

HubSpot normalisiert exportierte Tabellen- und Spaltennamen in Großbuchstaben, Zahlen und Unterstriche:

• Leerzeichen und Bindestriche werden zu Unterstrichen.
• Andere nicht-alphanumerische Zeichen werden entfernt.
• Namen, die länger als 128 Zeichen sind, werden gekürzt.
• Kollidierende Spaltennamen erhalten ein Suffix.
• Kollidierende Tabellennamen schlagen beim betroffenen Export fehl.

Arten von Spalten

Die PROPERTIES Spalte in OBJECT_WITH_OBJECT_PROPERTIES wird als JSON-formatierte Zeichenfolge in VARCHAR(MAX)gespeichert, nicht als nativer JSON-Spaltentyp. Siehe die Abfragebeispiele in den FAQs unten.

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 nach OBJECTTYPEID , um Datensätze für einen bestimmten Objekttyp zu lesen:

• Kontakte: 0-1
• Benutzerdefinierte Objekte: 2-{unique_id}, z. B. 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.

VERBÄNDE

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 > Data Studio. Wenn Mehr nicht in Ihrem Account angezeigt wird, gehen Sie direkt zu Datenmanagement > Data Studio.
2. Klicken Sie links auf App-Synchronisierungen.
3. Suchen Sie nach der Microsoft Fabric-Synchronisierung , oder wählen Sie sie 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.

FAQs

Wie kann ich die exportierten Daten abfragen?

Fragen Sie die Tabellen im Zielschema mit SQL ab.

-- Read all contact records
SELECT *
FROM [your_database].[hubspot_data_out_456].[OBJECT_WITH_OBJECT_PROPERTIES]
WHERE [OBJECTTYPEID] = '0-1'; -- Read a specific property from the PROPERTIES JSON string
SELECT
  [OBJECTID],
  JSON_VALUE([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 Synchronisierungen exportieren?

Jeder Objekttyp, Event-Typ oder jedes Zuordnungpaar kann in einer wiederkehrenden Microsoft Fabric-Synchronisierung pro HubSpot-Account berücksichtigt werden. Dies ist unabhängig von anderen Data Out-Anbietern.

Wenn z. B. Kontakte bereits in ein wiederkehrendes Fabric-Ziel exportiert wurden, können Sie keine Kontakte zu einer anderen wiederkehrenden Fabric-Konfiguration hinzufügen, bis Sie die erste Konfiguration archiviert haben. Sie können weiterhin gleichzeitig Kontakte zu einem anderen unterstützten Data Out-Anbieter 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 erstellt einen temporären Parquet-Export im von HubSpot verwalteten Speicher und schreibt die Ergebnisse in Ihr Fabric Warehouse. Sie müssen keinen Staging-Bucket bereitstellen oder verwalten.

Was passiert, wenn ich mich erneut mit einem anderen Dienstleiter verwende?

Wenn Sie eine Verbindung mit einem anderen Dienstprinzipal herstellen, müssen Sie diesen Dienstprinzipal dem Fabric-Arbeitsbereich mit der Rolle Mitwirkender hinzufügen, bevor der Verbindungstest oder die Synchronisierung erfolgreich sein kann.