BetaZugriff auf Ihre HubSpot-Daten über Microsoft Azure Synapse Analytics

Verwenden Sie Data Out for Azure Synapse, um ausgewählte HubSpot CRM-System-Daten in Tabellen in einem dedizierten Azure Synapse-SQL-Pool zu exportieren, den Sie besitzen. HubSpot aktualisiert jede Ausgabetabelle aus einem vollständigen Export der ausgewählten Daten. 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.

• HubSpot aktualisiert Tabellen separat. Wenn Sie während einer Synchronisierung mehrere Tabellen abfragen, werden möglicherweise einige Tabellen vor anderen aktualisiert.
• Data Out bietet keine historische Snapshot-Aufbewahrung. Nach einer erfolgreichen Aktualisierung enthält die Zieltabelle den neuesten Snapshot.
• Jedes Objekt, jeder Ereignistyp oder jedes Zuordnungpaar kann in einer wiederkehrenden Azure Synapse-Synchronisierung pro HubSpot-Account enthalten sein. Diese Beschränkung ist unabhängig von anderen Data Out-Anbietern.
• Objektspezifische Tabellen wie OBJECTS_CONTACTS, werden noch nicht unterstützt.
• Wenn zwei Tabellennamen kollidieren, nachdem HubSpot sie normalisiert hat, schlägt der betroffene Export fehl. Weitere Informationen finden Sie in den Tabellen- und Spaltennamensregeln.

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

Sie können die folgenden Daten von HubSpot mit Azure Synapse Analytics synchronisieren:

• Objekte und Datensätze: ausgewählte Standard- und benutzerdefinierte Objekte und deren Datensätze, z. B. Kontakte, Unternehmen, Deals, Tickets und Produkte.
• 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:

• Der dedizierte Azure Synapse-SQL-Endpunkt und die Datenbank.
• Die zu synchronisierenden Datenquellen: Objekte, Events, Zuordnungen oder eine Kombination dieser Quellen.
• Der Zeitplan für die Synchronisierung.

HubSpot erstellt einen temporären Parquet-Export im von HubSpot verwalteten Speicher und schreibt die Ergebnisse in Tabellen in Ihrem dedizierten Azure Synapse-SQL-Pool. Sie müssen keinen Staging-Bucket bereitstellen oder verwalten.

Suchen Ihrer Daten in Azure Synapse

HubSpot erstellt Ausgabetabellen in einem von HubSpot verwalteten Schema für Ihr Ziel. HubSpot exportiert Objektdaten in die drei in diesem Artikel beschriebenen Objekttabellen. HubSpot erstellt außerdem eine Tabelle pro ausgewähltem Event-Typ und, falls verfügbar, eine paarspezifische Tabelle pro ausgewähltem Zuordnungspaar.

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

Den genauen Namen des Schemas finden Sie auf der Konfigurationsseite Ihrer 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

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.

Verwenden Sie eckige Klammern, wenn Sie Bezeichner abfragen, insbesondere wenn Sie Abfragen dynamisch erstellen. Die Unterscheidung zwischen Groß- und Kleinschreibung des Bezeichners hängt von Ihrer Synapse-Datenbanksortierung ab. Zum Beispiel:

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

Arten von Spalten

Spaltentypen folgen den exportierten Daten und werden Azure Synapse-Typen wie folgt zugeordnet:

Bitte beachten: Die PROPERTIES Spalte in OBJECT_WITH_OBJECT_PROPERTIES wird als JSON-formatierte Zeichenfolge exportiert. Sie wird als NVARCHAR(MAX)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.

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 sind die verfügbaren Synchronisierungsfrequenzen möglicherweise begrenzt. In zukünftigen Versionen werden möglicherweise zusätzliche Häufigkeitsoptionen hinzugefügt.

Synchronisierungen überwachen und Fehler behandeln

Sie können Azure Synapse-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 dazu, welche Tabellen erfolgreich waren oder fehlgeschlagen sind.
• Wenn eine Tabelle nicht aktualisiert werden kann, bleiben die vorherigen erfolgreichen Daten in der Regel verfügbar.
• Bei wiederkehrenden Synchronisierungen wird bei der nächsten geplanten Synchronisierung automatisch erneut versucht, eine vollständige Synchronisierung durchzuführen.
• Sie können in HubSpot jederzeit manuell eine erneute Synchronisierung auslösen.

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';

Eine bestimmte Eigenschaft aus dem PROPERTIES JSON-String lesen:

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?

Jedes Objekt, jeder Ereignistyp oder jedes Zuordnungpaar kann in einer wiederkehrenden Azure Synapse-Synchronisierung pro HubSpot-Account enthalten sein. Diese Beschränkung ist unabhängig von anderen Data Out-Anbietern.

Wenn z. B. Kontakte bereits in ein wiederkehrendes Azure Synapse-Ziel exportiert wurden, können Sie erst dann Kontakte einer anderen wiederkehrenden Azure Synapse-Synchronisierung hinzufügen, wenn Sie die erste Synchronisierung archiviert haben. Sie können weiterhin gleichzeitig Kontakte zu einem anderen unterstützten Data Out-Anbieter 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.

Speichert HubSpot frühere Snapshots?

Nein. Data Out bietet keine historische Snapshot-Aufbewahrung. Nach einer erfolgreichen Aktualisierung enthält die Zieltabelle den neuesten Snapshot. Wenn eine Tabelle nicht aktualisiert werden kann, bleiben die vorherigen erfolgreichen Daten in der Regel verfügbar.