Hinweis: Dieser Artikel wird aus Kulanz zur Verfügung gestellt.

HubSpot-Daten in Snowflake abfragen

Zuletzt aktualisiert am: 24 September 2026

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

Data Hub Enterprise

Nachdem Sie Snowflake mit Ihrem HubSpot-Account verknüpft haben, können Sie mithilfe der Datenfreigabe von Snowflake HubSpot-Daten von Ihrem Snowflake-Konto aus abfragen.

Datenrückstand und die Region Ihres Snowflake Accounts

Sie haben Zugriff auf das Schema V2_LIVE, das alle 15 Minuten aktualisiert wird, und auf das Schema V2_DAILY, das jeden Tag aktualisiert wird.

Bitte beachten Sie: die folgenden Ansichten im V2_LIVE-Schema werden nur täglich aktualisiert: association_definitions, owners, pipelines und pipeline_stages.

Ihre Snowflake-Umgebung einrichten

Um Ihre HubSpot-Daten in Snowflake abzufragen, müssen Sie das Warehouse, die Datenbank und das Schema auswählen, von dem abbfragen möchten. Sie können für sie entweder auf Arbeitsblattebene festlegen, dass sie automatisch in Ihren Abfragen berücksichtigt werden, oder Sie können sie manuell hinzufügen.

So wählen Sie Ihr Warehouse, Ihre Datenbank und Ihr Schema auf der Arbeitsblattebene aus:

Klicken Sie in der oberen Zeile des Arbeitsblatts auf die Leiste mit den Arbeitsblattaktionen.
Im Popup-Fenster:
- Klicken Sie auf das Dropdown-Menü „Warehouse“ und wählen Sie Ihr Warehouse aus.
- Klicken Sie auf das Dropdown-Menü „Database“ (Datenbank) und wählen Sie dann Ihre HubSpot-Datenbank aus.
- Klicken Sie auf das Dropdown-Menü „Schema“ und wählen Sie dann das gewünschte Schema aus:

Wenn Ihre Umgebung konfiguriert ist, können Sie Abfragen an Ihre HubSpot-Daten ausführen, ohne dass Sie Ihren Datenbank- oder Ihren Schematyp manuell zu Abfragen hinzufügen müssen.

Um Ihre Datenbank und den Schematyp manuell zu Abfragen hinzuzufügen, fügen Sie den Datenbanknamen gefolgt vom Schema am Anfang des FROM feldes. Zum Beispiel:

SELECT objectTypeId, objectId, updatedAt

VON hubspot_share_name. V2_LIVE.Objekte

WHERE objectTypeId = '0-3'

GRENZE 1;

Datenüberblick

Abfragen werden mit SQL erstellt und können zum Abrufen von HubSpot-Daten wie z. B.:

Objekte: Standard- und benutzerdefinierte Objekte, wie Kontakte, Unternehmen, Produkte.
Datensätze: einzelne Datensätze, z. B. ein einzelner Kontakt oder ein Unternehmen.
Zuordnungen: alle verfügbaren Zuordnungen und die aktuell verknüpften Datensätze.
Ereignisse: Ereignisdaten sowohl für standardmäßige HubSpot-Ereignisse, wie z. B. das Öffnen von E-Mails, als auch für benutzerdefinierte verhaltensbezogene Ereignisse.
Segmente: HubSpot-Kontakt- und Unternehmenssegmente.
Zuständige Mitarbeiter: Benutzer in Ihrem HubSpot-Account, in Bezug auf die Datensätze, für die sie als zuständiger Mitarbeiter festgelegt sind.
Pipelines: Deal- und Ticket-Pipelines, einschließlich Pipeline-Phasen.
Eigenschaften: Eigenschaften und ihre Werte in CRM-System-Datensätzen, einschließlich des Eigenschaftsverlaufs.

Erfahren Sie mehr über das CRM-System von HubSpot.

Bitte beachten Sie: Im Zuge der Weiterentwicklung der Datenfreigabe werden wir Änderungen einführen, von denen einige grundlegend sind. Es wird dringend empfohlen, das Änderungsprotokoll für Entwickler von HubSpotzu abonnieren. Diese Änderungen werden immer vor jeder Aktualisierung im Änderungsprotokoll veröffentlicht.

Einschränkung und Anordnung der zurückgegebenen Daten

Bei der Erstellung von Abfragen können Sie steuern, wie viele Daten zurückgegeben werden und in welcher Reihenfolge sie zurückgegeben werden, indem Sie LIMIT und ORDER BY in Ihre Abfrage aufnehmen. Um beispielsweise alle Kontakte mit ihren Eigenschaften abzufragen, jedoch nur drei Ergebnisse zurückzugeben und diese nach Kontakt-ID anzuordnen, könnten Sie Ihre Abfrage wie folgt aufbauen:

SELECT objectTypeId, updatedAt, ingestedAt

FROM-Objekte

WHERE objectTypeId = '0-1'

ORDER BY objectId

LIMIT 10;

Spaltendatentypen

Beim Abfragen von Daten in Snowflake hängen die zurückgegebenen Spalten von den Daten ab, die Sie abfragen. Sie können die verfügbaren Spalten für eine bestimmte Tabelle oder Ansicht in Snowflake anzeigen, indem Sie die Ansicht in der linken Seitenleiste auswählen.

Bitte beachten Sie:im weiteren Verlauf dieses Dokuments verwenden wir den Begriff Datenbankobjekt, wenn sich der Kontext sowohl auf Tabellen als auch auf Views bezieht.

snowflake-sidebar-view-column-details0

Um eine bestimmte Spalte zurückzugeben, fügen Sie diese Spalte in das Feld SELECT feld Ihrer Abfrage ein. Die folgende Abfrage gibt zum Beispiel nur die OBJECTID Spalten und UpdatedAt zurück

SELECT objectTypeId, updatedAt, ingestedAt

FROM-Objekte

WHERE objectTypeId = '0-1'

ORDER BY objectId

LIMIT 10;

Nachstehend finden Sie allgemeine Definitionen für Spalten, die eine Abfrage zurückgeben könnte. Weitere Definitionen, die hier nicht aufgeführt sind, finden Sie in den Definitionen der einzelnen Ansichten im obigen Artikel.

OBJECTTYPEID: ein VARCHAR-Wert, der den Typ eines Objekts darstellt. Zum Beispiel steht 0–1 für das Kontakte-Objekt, 0–2 für das Unternehme-Objekt und 2–1232 für ein benutzerdefiniertes Objekt in Ihrem Account. Bei Segmenten bezieht sich dies auf die Art des Segments (z. B. Kontakt oder Unternehmen ). Sie können alle Objekt- und Event-IDs in Ihrem Account mithilfe der Ansicht object_and_event_type_definitions abfragen.
OBJECTID: eine BIGINT-Zahl, die einen einzelnen Datensatz eines bestimmten Objekttyps in Ihrem HubSpot Account darstellt. Um einen Datensatz zu identifizieren, müssen Sie sowohl die Objekttyp-ID als auch die Objekt-ID verwenden.
INGESTEDAT: der Zeitstempel, wann eine Datenzeile zu Snowflake hinzugefügt wurde, dargestellt durch einen TIMESTAMP_NTZ-Wert. Bezieht sich nicht auf den logischen Zeitstempel eines Erstellungs- oder Aktualisierungsvorgangs in HubSpot.
- Aufgrund der internen Verarbeitung von HubSpot kann der Zeitstempel einer Zeile aktualisiert werden, auch wenn sich keine anderen Spalten der Zeile geändert haben.
- Beim Erstellen von ETL-Prozessen , die kürzlich geänderte Daten kopieren, empfiehlt es sich, die Abfragen auf den Zeitstempel der Erfassung zu stützen. Wenn bei Ihrem Ablauf täglich Daten kopiert werden, empfiehlt es sich außerdem, die Daten der letzten zwei Tage zu kopieren, um Verzögerungen zu berücksichtigen.
CREATEDAT und UPDATEDAT: der logische Zeitstempel, wann die Daten in HubSpot erstellt oder aktualisiert wurden, dargestellt durch einen TIMESTAMP_NTZ-Wert . Diese Zeitstempel entsprechen den Zeitstempeln in HubSpot. Die in HubSpot angezeigte Zeit für das Erstellungsdatum eines Datensatzes ist beispielsweise dieselbe wie der Zeitstempel in der Spalte CREATEDAT in Snowflake. Diese sind nicht direkt mit dem Erfassungs-Zeitstempel verknüpft, und es wird nicht empfohlen, ETL-Prozesse auf diese Eigenschaften zu stützen.
COMBINEDASSOCIATIONTYPE: ein VARCHAR-Wert, der eine Assoziationsdefinition eindeutig identifiziert.

Datentypen umwandeln

Manchmal werden Daten aus einer Abfrage mit VARCHAR-Spalten zurückgegeben, obwohl es wünschenswert wäre, sie als einen anderen Typ zu haben. In solchen Fällen empfiehlt es sich, den VARCHAR-Datentyp mit Hilfe von Snowflake-Funktionen in die gewünschten Typen zu konvertieren. So werden beispielsweise die Eigenschaften eines Objektdatensatzes in den meisten Datenbankobjekten als VARCHAR-Datentypen gespeichert, enthalten aber manchmal auch Zahlen- und Datumswerte. Funktionen wie:
try_to_number, try_to_timestamp_ntz können verwendet werden, um diese VARCHAR-Daten in die Typen NUMBER bzw. DATETIME zu konvertieren:

SELECT objectid, value AS amount_str, try_to_number(value) AS amount
FROM object_properties WHERE objecttypeid='0-3' AND name='amount' LIMIT 1

Objektabfragen

Im Folgenden erfahren Sie, wie Sie Daten von bestimmten HubSpot-Objekten und -Datensätzen abfragen können und welche Daten zurückgegeben werden.

Objektdaten sind in gemeinsam genutzten Datenbankobjekten verfügbar. Filtern nach objectTypeId , um einen bestimmten Objekttyp abzurufen. Verwenden Sie diese Option OBJECT_WITH_OBJECT_PROPERTIES , wenn Sie die aktuellen Eigenschaften für die einzelnen Datensätze benötigen. Eigenschaften werden im Ordner properties JSON-Kolumne. Verwenden Sie diese Option für OBJECTS Kerndatensatzattribute und OBJECT_PROPERTIES/oder OBJECT_PROPERTIES_HISTORY für Daten pro Eigenschaft.

Objektname	ObjectTypeId
Kontakte	0–1
Unternehmen	0–2
Artikel	0–8

Benutzerdefinierten Objekten wird zum Zeitpunkt der Erstellung eine ID zugewiesen und sie werden als 2-unique_ID identifiziert. Zum Beispiel: 2-12345. Erfahren Sie mehr über object_and_event_type_definitions.

Weitere Einzelheiten finden Sie unter object_with_object_properties, object_properties, objects und object_properties_history.

object_with_object_properties

Dieses Datenbankobjekt enthält Daten aus Ihren HubSpot-Datensätzen. Abfragen an dieses Datenbankobjekt geben eine Zeile für jeden Datensatz innerhalb eines Objekttyps zurück (z. B. alle Kontaktdatensätze im Objekttyp "Kontakte"). Alle Eigenschaften werden in der Spalte Eigenschaften gespeichert, die eine Snowflake-Variante / JSON-Spalte ist.

Diese Ansicht kann die folgenden Spalten zurückgeben:

Spaltenname	Typ	Beschreibung
`OBJECTTYPEID`	Varchar	Die ID des Objekttyps (z. B. Kontakte ist `0-1`).
`OBJECTID`	Zahl	Die ID des Datensatzes (z. B. ein Kontaktdatensatz mit einer ID von `123752`).
`PROPERTIES`	Variant	Die Eigenschaftswerte des Datensatzes.
`UPDATEDAT`	Zeitstempel	Der Zeitpunkt (Datum und Uhrzeit), zu dem der Datensatz zuletzt in HubSpot aktualisiert wurde. Erfahren Sie mehr über Spaltendatentypen.
`INGESTEDAT`	Zeitstempel	Der Zeitpunkt (Datum und Uhrzeit), zu dem die Daten zuletzt von Snowflake erfasst wurden.

Bitte beachten Sie: Am 25. Januar 2022 wird die Spalte Zeitstempel in der Tabelle und Ansicht object_with_object_properties, die das Datum und die Uhrzeit der letzten Aktualisierung des Objektdatensatzes in HubSpot darstellt, zu updatedat. Dies dient der Angleichung an die Darstellung von Datumsdaten im Rest der Datenfreigabe.

Da es sich hierbei um eine grundlegende Änderung handelt, wurde der Tabelle und der Ansicht die neue Spalte updatedat hinzugefügt. In den nächsten 90 Tagen werden diese beiden neuen Spalten neben der Spalte "Zeitstempel" existieren, die sie ersetzen sollen. Dies gibt Ihnen die Möglichkeit, auf die neuen Spalten umzustellen.

Nach 90 Tagen, am 25. Januar 2022, wird die Spalte Zeitstempel aus der Tabelle und der Ansicht entfernt. Nach diesem Datum schlägt jeder Versuch, die Tabelle object_with_object_properties oder den View mit Zeitstempelspalten abzufragen, fehl.

Beispiel 1

Abrufen aller Kontakte und ihrer Eigenschaften.

Abfrage:

SELECT objectTypeId, objectId, properties
FROM object_with_object_properties
WHERE objectTypeId = '0-1'

Gibt zurück:

OBJEKTTYP-ID	OBJEKT-ID	EIGENSCHAFTEN
0–1	38960439	{"createdate": "1504656970152"...}
0–1	321740651	{ "createdate": "1590183081949"...}
0–1	98392101	{ "createdate": "1533566477279"...}
...	...	...

Beispiel 2

Rufen Sie den Deal-Namen und die Phase von bis zu drei Deals ab.

Abfrage:

SELECT
objectId,
properties:dealname::string AS dealname,
properties:dealstage::string AS dealstage,
properties:amount::number AS dealamount
FROM object_with_object_properties
WHERE objectTypeId = '0-3'
LIMIT 3;

Gibt zurück:

OBJEKT-ID	DEALNAME	DEALSTAGE	DEALAMOUNT
38960439	Dealname 1	geschlossenverlorene	7488939
321740651	Dealname 1	geschlossengewonnen	9292029
98392101	Dealname 1	geschlossenverlorene	62626528

objects

Dieses Datenbankobjekt ist eine Teilmenge der Daten des Datenbankobjekts object_with_object_properties. Jede zurückgegebene Zeile gibt die Objekt-ID für die einzelnen Datensätze zurück. Dieses Datenbankobjekt gibt nur vorhandene Datensätze zurück. Wenn ein Datensatz in HubSpot gelöscht wird, wird er auch aus diesem Datenbankobjekt entfernt. Dieses Datenbankobjekt ist eine Untermenge der Daten in der Tabelle object_with_object_properties. Jede zurückgegebene Zeile gibt die Objekt-ID für die einzelnen Datensätze zurück. Diese Ansicht gibt nur vorhandene Datensätze zurück. Wird ein Datensatz in HubSpot gelöscht, wird er aus dieser Ansicht entfernt.

Dieses Datenbankobjekt enthält aktuelle Objektdaten ohne Eigenschaften. Verwenden Sie ihn, wenn Sie nur Kerndatensatzattribute benötigen, oder verbinden Sie ihn mit OBJECT_PROPERTIES, wenn Sie ausgewählte Eigenschaften benötigen. Die Verwendung dieses Datenbankobjekts mit dem Datenbankobjekt object_properties ermöglicht es, die Daten in object_with_object_properties zu replizieren und gleichzeitig die Kontrolle darüber zu behalten, welche Eigenschaften zurückgegeben werden.

Dieses Datenbankobjekt kann die folgenden Spalten zurückgeben:

Spaltenname	Typ	Beschreibung
`OBJECTTYPEID`	Varchar	Die ID des Objekttyps (z. B. Kontakte ist `0-1`).
`OBJECTID`	Zahl	Die ID des Datensatzes (z. B. ein Kontaktdatensatz mit einer ID von `123752`).
`INGESTEDAT`	Zeitstempel	Der Zeitpunkt (Datum und Uhrzeit), zu dem die Daten zuletzt von Snowflake erfasst wurden. Erfahren Sie mehr über Spaltendatentypen.

Beispiel 1

Abrufen aller Kontaktdatensätze.

Abfrage:

SELECT objectTypeId, objectId
FROM objects
WHERE objectTypeId = '0-1'

Gibt zurück:

OBJEKTTYP-ID	OBJEKT-ID
0–1	36721864
0–1	103580363
0–1	56047670
...	...

object_properties

Dieses Datenbankobjekt ist eine Untermenge des Datenbankobjekts object_with_object_properties. Jede Zeile enthält den aktuellen Eigenschaftswert, der für einen bestimmten Datensatz festgelegt wurde. Ein Kontakt hat zum Beispiel eine Zeile für die Eigenschaft „Vorname“ und eine Zeile für die Eigenschaft „Nachname“. Wenn ein Datensatz keinen Wert für eine Eigenschaft hat, erscheint die Zeile entweder mit einer leeren Zeichenfolge oder überhaupt nicht.

Dieses Datenbankobjekt kann die folgenden Spalten zurückgeben:

Spaltenname	Typ	Beschreibung
`OBJECTTYPEID`	Varchar	Die ID des Objekttyps (z. B. Kontakte ist `0-1`).
`OBJECTID`	Zahl	Die ID des Datensatzes (z. B. ein Kontaktdatensatz mit einer ID von `123752`).
`NAME`	Varchar	Der Name der Eigenschaft.
`VALUE`	Zeitstempel	Der Wert der Eigenschaft.
`UPDATEDAT`	Zeitstempel	Der Zeitpunkt (Datum und Uhrzeit), zu dem der Datensatz zuletzt in HubSpot aktualisiert wurde. Erfahren Sie mehr über Spaltendatentypen.
`INGESTEDAT`	Zeitstempel	Der Zeitpunkt (Datum und Uhrzeit), zu dem die Daten zuletzt von Snowflake erfasst wurden.

Beispiel 1

Abrufen der Eigenschaften Vorname, Nachname und Ort für alle Kontakte.

Abfrage:

SELECT objectTypeId, objectId, name, value
FROM object_properties
WHERE objectTypeId = '0-1'
AND name IN ('firstname', 'lastname', 'city')
ORDER BY objectId;

Gibt zurück:

OBJEKTTYP-ID	OBJEKT-ID	NAME	WERT
0–1	10401	firstname	Brian
0–1	10401	Ort	Dublin
0–1	10401	lastname	Gallagher
0–1	23451	firstname	Fernando
0–1	23451	lastname	Fierro
0–1	25751	firstname	Charles
...	...	...	...

Beispiel 2

Abrufen des Vornamens, des Nachnamens und der Lifecycle-Phase für alle Kontakte und Kombinieren dieser Eigenschaften in einer Zeile pro Kontakt. In diesem Beispiel wird die SQL-Syntax PIVOTverwendet.

Abfrage:

SELECT objectId, firstname, lastname, lifecyclestage
FROM
(
SELECT objectId, name, value
FROM object_properties
WHERE objectTypeId = '0-1'
AND name IN ('firstname', 'lastname', 'lifecyclestage')
)
PIVOT(MAX(value) FOR name IN ('firstname', 'lastname', 'lifecyclestage')) AS p(objectId, firstname, lastname, lifecyclestage);

Gibt zurück:

OBJEKTTYP-ID	OBJEKT-ID	VORNAME	NACHNAME	LIFECYCLESTAGE
0–1	54325098	Hobbes	Baron	Lead
0–1	96805401	Milla	Günter	Lead
0–1	6922028	Henry	Rilke	Lead
...	...	...	...	...

object_properties_history

Dieses Datenbankobjekt enthält historische Eigenschaftswerte. Bei Kontakten enthält sie die letzten 45 Werte. Für alle anderen Objekte enthält sie die letzten 20 Werte. Zeigt eine Zeile für jeden historischen Eigenschaftswert an. Der aktuelle Wert einer Eigenschaft wird durch den letzten UPDATEDAT-Zeitstempel im Verlauf der Eigenschaft bestimmt.

Dieses Datenbankobjekt kann die folgenden Spalten zurückgeben:

Spaltenname	Typ	Beschreibung
`OBJECTTYPEID`	Varchar	Die ID des Objekttyps (z. B. Kontakte ist `0-1`).
`OBJECTID`	Zahl	Die ID des Datensatzes (z. B. ein Kontaktdatensatz mit einer ID von `123752`).
`NAME`	Varchar	Der Name der Eigenschaft.
`VALUE`	Zeitstempel	Der Wert der Eigenschaft.
`UPDATEDAT`	Zeitstempel	Der Zeitpunkt (Datum und Uhrzeit), zu dem die Daten zuletzt in HubSpot aktualisiert wurden. Erfahren Sie mehr über Spaltendatentypen.
`INGESTEDAT`	Zeitstempel	Der Zeitpunkt (Datum und Uhrzeit), zu dem die Daten zuletzt von Snowflake erfasst wurden.

Beispiel 1

Abrufen des Verlaufs einer einzelnen Eigenschaft für einen einzelnen Kontakt.

Abfrage:

SELECT objectId, name, value, updatedAt
FROM object_properties_history
WHERE objectTypeId = '0-1'
AND objectId = 136493192
AND name = 'hs_predictivescoringtier'
ORDER BY UPDATEDAT DESC;

Gibt zurück:

OBJEKT-ID	NAME	WERT	AKTUALISIERT BEI
136493192	hs_predictivescoringtier	tier_1	2022-06-22 22:45:05.931
136493192	hs_predictivescoringtier	tier_2	2021-09-18 08:20:56.622
136493192	hs_predictivescoringtier	tier_3	2019-11-31 18:20:22.851
...	...	...	...

Beispiel 2

Abrufen des aktuellen Namens aller Kontakte, die jemals die Lebenszyklusphase „Abonnent“hatten.

Abfrage:

SELECT
objectId,
properties:firstname::string AS firstname,
properties:lastname::string AS lastname
FROM object_with_object_properties
WHERE object_with_object_properties.objectTypeId = '0-1'
AND objectId IN (
SELECT objectId
FROM object_properties_history
WHEREobject_properties_history.objectTypeId = '0-1'
AND object_properties_history.name = 'lifecyclestage'
AND object_properties_history.value = 'subscriber'
);

Gibt zurück:

OBJEKT-ID	VORNAME	NACHNAME
54325098	Hobbes	Baron
96805401	Milla	Günter
6922028	Henry	Rilke
...	...	...

Zuordnungsabfragen

Zuordnungsdaten sind verfügbar in ASSOCIATIONS. Filtern Sie nach combinedAssociationTypeId , um einen bestimmten Zuordnungstyp abzurufen. Verbinden ASSOCIATIONS mit ASSOCIATION_DEFINITIONS , um die zugehörigen Objekttypen und die Definition der Zuordnung zu identifizieren.

association_definitions

Dieses Datenbankobjekt enthält Informationen über alle verfügbaren Assoziationstypen zwischen HubSpot-Objekten, mit einer Zeile pro Assoziationstyp. Sie können dieses Datenbankobjekt mit dem Datenbankobjekt Assoziationen verknüpfen, um datensatzspezifische Assoziationsinformationen zu erhalten.

Es kann mehrere Arten von Zuordnungen zwischen denselben Objekten geben. Der Haupt-Zuordnungstyp, der in HubSpot angezeigt wird, wenn Datensätze zugeordnet werden, verwendet die Zuordnung, bei der ISMAINASSOCIATIONDEFINITION ist true.

Dieses Datenbankobjekt kann die folgenden Spalten zurückgeben:

Spaltenname	Typ	Beschreibung
`COMBINEDASSOCIATIONTYPEID`	Varchar	Die eindeutige ID der Zuordnungsdefinition.
`CATEGORY`	Varchar	Die Quelle des Zuordnungstyps. Eine von: `HUBSPOT_DEFINED`, `USER_DEFINED`, `INTEGRATOR_DEFINED`
`ID`	Zahl	Die Kennung der Zuordnungsdefinition innerhalb ihrer Kategorie.
`FROMOBJECTTYPEID`	Varchar	Die ID des Objekts, das die Quelle der Zuordnungsdefinition ist.
`TOOBJECTTYPEID`	Varchar	Die ID des Objekts, das das Ziel der Zuordnungsdefinition ist.
`NAME`	Varchar	Der Name der Zuordnungsdefinition.
`LABEL`	Varchar	Die Bezeichnung der Zuordnungsdefinition.
`ISMAINASSOCIATIONDEFINITION`	Boolesch	Ob die Zuordnungsdefinition der Haupttyp ist. Ist dies der Fall, ist die Definition die, die HubSpot in den zugehörigen Datensätzen anzeigt.
`INGESTEDAT`	Zeitstempel	Der Zeitpunkt (Datum und Uhrzeit), zu dem die Daten zuletzt von Snowflake erfasst wurden. Erfahren Sie mehr über Spaltendatentypen.

Beispiel 1

Abrufen der in Ihrem Account verfügbaren Zuordnungstypen.

Abfrage:

SELECT combinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
ORDER BY category, id

Gibt zurück:

COMBINEDASSOCIATIONTYPE	FROMOBJECTTYPEID	TOOBJECTTYPEID	NAME
0–1	0–1	0–2	CONTACT_TO_COMPANY
0–2	0–2	0–1	COMPANY_TO_CONTACT
0–3	0–3	0–1	DEAL_TO_CONTACT
0–4	0–1	0–3	CONTACT_TO_DEAL
0–5	0–3	0–2	DEAL_TO_COMPANY
...	...	...	...

Beispiel 2

Abrufen der verfügbaren Zuordnungstypen zwischen Deals und Unternehmen.

Abfrage:

SELECTcombinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
WHERE fromObjectTypeId = '0-3' AND toObjectTypeId = '0-2' AND isMainAssociationDefinition = true
ORDER BY category, id

Gibt zurück:

COMBINEDASSOCIATIONTYPE	FROMOBJECTTYPEID	TOOBJECTTYPEID	NAME
0–5	0–3	0–2	DEAL_TO_COMPANY
0-271	0–3	0–2	DEAL_TO_PRIMARY_COMPANY
0-341	0–3	0–2	DEAL_TO_COMAPNY_UNLABELED

associations

Dieses Datenbankobjekt enthält Informationen über die Verbindungen zwischen bestimmten Datensätzen. Jede Zeile stellt eine Zuordnung zwischen einem Objekt und einem anderen Objekt dar. Zeilen können in diesem Datenbankobjekt vorhanden sein, auch wenn die referenzierten Datensätze gelöscht wurden. Durch das Verbinden mit der Tabelle objects können Sie überprüfen, ob Datensätze vorhanden sind.

Dieses Datenbankobjekt enthält Zuordnungen für alle Zuordnungstypen. Filtern Sie nach combinedAssociationTypeId und verbinden Sie mit ASSOCIATION_DEFINITIONS , wenn Sie Zuordnungsmetadaten benötigen.

Dieses Datenbankobjekt kann die folgenden Spalten zurückgeben:

Spaltenname	Typ	Beschreibung
`COMBINEDASSOCIATIONTYPEID`	Varchar	Die eindeutige ID der Zuordnungsdefinition.
`FROMOBJECTID`	Zahl	Die ID des Quellobjekts.
`TOOBJECTID`	Zahl	Die ID des Zielobjekts.
`INGESTEDAT`	Zeitstempel	Der Zeitpunkt (Datum und Uhrzeit), zu dem die Daten zuletzt von Snowflake erfasst wurden. Erfahren Sie mehr über Spaltendatentypen.

Beispiel 1

Abrufen alle zugeordneten Deals und Kontakte.

Abfrage:

SELECT combinedAssociationTypeId, fromObjectId, toObjectId
FROM associations
WHERE combinedAssociationTypeId = '0-5'

Gibt zurück:

KOMBINIERTE ZUORDNUNGSTYP-ID	FROMOBJECTID	TOOBJECTID
0–5	6626541373	233620335
0–5	6616436082	3866015468
0–5	6690805943	7132752747
...	...	...

Beispiel 2

Abrufen aller Tickets, die einem bestimmten Kontakt zugeordnet sind (Kontakt-ID: 3005).

Abfrage:

SELECT combinedAssociationTypeId, fromObjectId, toObjectId
FROM associations
WHERE associationCategory = 'HUBSPOT_DEFINED'
AND combinedAssociationTypeId = '0-15'
AND fromObjectId = 3005;

Gibt zurück:

COMBINEDASSOCIATIONTYPE	FROMOBJECTID	TOOBJECTID
0–5	6626541373	233620335

Beispiel 3

Abrufen aller Deals, die einem bestimmten Kontakt (Kontakt-ID: 4464) zugeordnet sind. Anstatt combinedAssociationTypeId fest zu programmieren, wird in diesem Beispiel mit association_definitions verbunden.

Abfrage:

SELECT combinedAssociationTypeId, fromObjectId toObjectId,
FROM associations
WHERE
combinedAssociationTypeId = (
SELECT combinedAssociationTypeId
FROM association_definitions
WHERE fromObjectTypeId = '0-1'
AND toObjectTypeId = '0-3'
AND isMainAssociationDefinition)
AND fromObjectId = 4464;

Gibt zurück:

KOMBINIERTE ZUORDNUNGSTYP-ID	FROMOBJECTID	TOOBJECTID
0–5	6626541373	233620335

Rückfragen des Eigentümers

owners

Dieses Datenbankobjekt enthält Informationen über die Benutzer in Ihrem HubSpot-Account. Benutzer können als zuständige Mitarbeiter für einen Datensatz festgelegt werden und enthalten je nach Kontext sowohl eine Benutzer-ID als auch eine Mitarbeiter-ID. Beide IDs können zur Identifizierung desselben Benutzers verwendet werden.

Dieses Datenbankobjekt kann die folgenden Spalten zurückgeben:

Spaltenname	Typ	Beschreibung
`OWNERID`	Zahl	Die Mitarbeiter-ID des Benutzers.
`USERID`	Zahl	Die Benutzer-ID des Benutzers. Benutzer mit NULL in dieser Spalte wurden gelöscht.
`EMAIL`	Varchar	Die E-Mail-Adresse des Benutzers.
`FIRSTNAME`	Varchar	Der Vorname des Benutzers.
`LASTNAME`	Varchar	Der Nachname des Benutzers.
`ARCHIVED`	Boolesch	Ob der Benutzer gelöscht wurde.
`CREATEDAT`	Zeitstempel	Der Zeitpunkt (Datum und Uhrzeit), zu dem der Benutzer in HubSpot erstellt wurde. Weitere Informationen finden Sie unter Spaltendatentypen.
`UPDATEDAT`	Zeitstempel	Der Zeitpunkt (Datum und Uhrzeit), zu dem der Benutzer zuletzt in HubSpot aktualisiert wurde. Weitere Informationen finden Sie unter Spaltendatentypen.
`INGESTEDAT`	Zeitstempel	Der Zeitpunkt (Datum und Uhrzeit), zu dem die Daten zuletzt von Snowflake erfasst wurden.

Beispiel 1

Abrufen aller Benutzer. Der WHERE archived = false filter entfernt gelöschte Benutzer aus den zurückgegebenen Daten.

Abfrage:

SELECT ownerId, userId, email, firstname, lastname FROM owners WHERE archived = false

Gibt zurück:

OWNERID	BENUTZER-ID	E-MAIL	VORNAME	NACHNAME
29584574	4621126	233620335	Hobbes	Baron
30532717	4874784	3866015468	Paul	Walter
30580321	925511	7132752747	Milla	Günter
...	...	...	...	...

Beispiel 2

Abrufen eines bestimmten zuständigen Mitarbeiters anhand seiner Mitarbeiter-ID.

Abfrage:

SELECT ownerId, userId, email, firstname, lastname
FROM owners
WHERE ownerId = 29584574;

Gibt zurück:

OWNERID	BENUTZER-ID	E-MAIL	VORNAME	NACHNAME
29584574	4621126	233620335	Hobbes	Baron

Beispiel 3

Abrufen aller Kontakte und ihrer zuständigen Mitarbeiter. Diese Abfrage verbindet Datensätze mit zuständigen Mitarbeitern mit object_with_object_properties und der Kontakteigenschaft hubspot_owner_id.

AUSWÄHLEN

CONTACT.objectId AS contact_id,

contact.properties:firstname::string AS contact_firstname,

contact.properties:lastname::string AS contact_lastname,

contact.properties:hubspot_owner_id::number AS contact_hubspot_owner_id,

owner.firstname AS owner_firstname,

owner.lastname AS owner_lastname,

owner.email ALS owner_email

VON object_with_object_properties ALS KONTAKT

ZUSTÄNDIGEN MITARBEITERN ALS zuständigen Mitarbeiter beitreten

ON contact.properties:hubspot_owner_id::number = owner.ownerId

WOBEI contact.objectTypeId = '0-1';

Gibt zurück:

CONTACTID	CONTACT_FIRSTNAME	CONTACT_LASTNAME	CONTACT_HUBSPOT_OWNER_ID	OWNER_FIRSTNAME	OWNER_LASTNAME	OWNER_EMAIL
113834202	Richard	Greenfield	29584574	Hobbes	Baron	hobbes.b@business.com
53540801	Ford	Karl	30241125	Milla	Günter	milo.g@business.com
...	...	...	...	...	...	...

Teamabfragen

teams

Mit Teams können Sie in HubSpot Ihre Benutzer in Gruppen einteilen und so für mehr Struktur und übersichtlichere Berichte sorgen. Sie können ein Hauptteam und zusätzliche Teams haben.

Dieses Datenbankobjekt enthält Informationen zu den Teams in Ihrem HubSpot-Account.

Dieses Datenbankobjekt kann die folgenden Spalten zurückgeben:

Spaltenname	Typ	Beschreibung
TEAMID	Zahl	Die Team-ID.
TEAMNAME	Varchar	Der Name des Teams.
PARENTTEAMID	Zahl	Die Team-ID des übergeordneten Teams.
CHILDTEAMIDS	Array	Die Team-IDs der untergeordneten Teams.
PRIMARYOWNERMEMBERS	Varchar	Die Mitarbeiter-IDs der primären Teammitglieder.
SECONDARYOWNERMEMBERS	Boolesch	Die Mitarbeiter-IDs der sekundären Teammitglieder.
INGESTEDAT	Zeitstempel	Der Zeitpunkt (Datum und Uhrzeit), zu dem die Daten zuletzt von Snowflake erfasst wurden.

Beispiel 1

Rufen Sie alle Teams ab.

Abfrage:

SELECT teamId,teamName, primaryOwnerMembers

FROM teams

Gibt zurück:

TEAMID	TEAMNAME	PRIMARYOWNERMEMBERS
29584574	Unterteam	[233620335, 1234553]
30532717	Super-Team	[3866015468, 126221873]
3058032	Ein Team	[7132752747]

owner_team

Dieses Datenbankobjekt enthält Informationen darüber, welche zuständigen Mitarbeiter mit welchen Teams in Ihrem HubSpot-Account korrespondieren.

Dieses Datenbankobjekt kann die folgenden Spalten zurückgeben:

Spaltenname	Typ	Beschreibung
TEAMID	Zahl	Die Team-ID.
OWNERID	Zahl	Die Mitarbeiter-ID des Benutzers.
ISTEAMPRIMARY	Boolesch	Ob dieses Team das primäre Team für diesen zuständigen Mitarbeiter ist.
INGESTEDAT	Zeitstempel	Das Datum und die Uhrzeit, zu der die Daten zuletzt von Snowflake erfasst wurden.

Beispiel 1

Rufen Sie alle zuständigen Mitarbeiter für ein bestimmtes Team ab.

Abfrage:

SELECT teamId, ownerId, isTeamPrimary
FROM teams
WHERE teamId = 29584574

Rückgabe

TEAMID	TEAMNAME	ISTEAMPRIMARY
29584574	233620335	TRUE
29584574	1234553	TRUE

Pipeline-Abfragen

Im Folgenden erfahren Sie, wie Sie Deal- und Ticketpipeline-Daten abfragen können, z. B. die verfügbaren Pipelines in Ihrem Account und deren Phasen.

Sie können diese Daten mit Objektdaten verbinden, um einen vollständigen Überblick über Ihre Pipelines zu erhalten. Sie können zum Beispiel Deals und ihre Pipelines abfragen, indem Sie mit pipelinesverbinden object_with_object_properties .

pipelines

Dieses Datenbankobjekt enthält Informationen über die Geschäfts- und Ticket-Pipelines in Ihrem Account. Jede zurückgegebene Zeile steht für eine einzelne Pipeline.

Diese Tabelle kann die folgenden Spalten zurückgeben:

Spaltenname	Typ	Beschreibung
`PIPELINEID`	Varchar	Die ID der Pipeline.
`OBJECTTYPEID`	Varchar	Die ID des Objekts, das die Pipeline enthalten kann (z. B. Deals oder Tickets).
`LABEL`	Varchar	Der Name der Pipeline in HubSpot.
`DISPLAYORDER`	Zahl	Die Reihenfolge, in der die Pipeline in HubSpot angezeigt wird.
`ARCHIVED`	Boolesch	Ob die Pipeline gelöscht wurde
`CREATEDAT`	Zeitstempel	Wann die Pipeline erstellt wurde.
`UPDATEDAT`	Zeitstempel	Der Zeitpunkt (Datum und Uhrzeit), zu dem die Daten zuletzt in HubSpot aktualisiert wurden. Erfahren Sie mehr über Spaltendatentypen.
`INGESTEDAT`	Zeitstempel	Der Zeitpunkt (Datum und Uhrzeit), zu dem die Daten zuletzt von Snowflake erfasst wurden.

Beispiel 1

Abrufen aller verfügbaren Deal-Pipelines, angeordnet nach ihrer Reihenfolge in HubSpot.

Abfrage:

SELECT objectTypeId, pipelineId, label
FROM pipelines
WHERE objectTypeId = '0-3'AND not archived
ORDER BY displayorder;

Gibt zurück:

OBJEKTTYP-ID	PIPELINE-ID	ETIKETT
0–3	1bed503c-37f7-4f51-9d40-7598902673f4	Sales-Pipeline
0–3	12659678	Lizenzen-Pipeline
0–3	75e28846-ad0d-4be2-a027-5e1da6590b98	Neuer Kunde
...	...	...

Beispiel 2

Abrufen von Deals innerhalb eines bestimmten Pipeline mithilfe von object_with_object_properties.

SELECT deals.objectId deal_id, deals.properties:dealname::varchar deal_name, pipelines.label pipeline_name FROM object_with_object_properties deals INNER JOIN pipelines ON deals.objectTypeId = pipelines.objectTypeId AND deals.properties:pipeline::string = pipelines.pipelineid WHERE deals.objecttypeId = '0-3' AND pipelines.objectTypeId = '0-3';

Gibt zurück:

DEAL_ID	DEAL_NAME	PIPELINE_NAME
605140072	Meowmix Global Signup	Sales-Pipeline
605457408	Friskies Rebranding	Sales-Pipeline
604362473	Fresh Step App Build	Sales-Pipeline

pipeline_stages

Diese Ansicht enthält Informationen zu den einzelnen Phasen innerhalb einer Pipeline. Identifizieren Sie Phasen durch Kombination von Objekttyp-ID, Pipeline-ID und Phasen-ID. Verwenden Sie beim Verbinden mit pipelines die Objekttyp-ID und die Pipeline-ID.

Dieses Datenbankobjekt kann die folgenden Spalten zurückgeben:

Spaltenname	Typ	Beschreibung
`PIPELINEID`	Varchar	Die ID der Pipeline.
`STAGEID`	Varchar	Die ID der Bühne.
`LABEL`	Varchar	Der Name der Stufe in HubSpot.
`DISPLAYORDER`	Zahl	Die Reihenfolge, in der die Pipeline in HubSpot angezeigt wird.
`METADATA`	Variant	Eine JSON-formatierte Beschreibung der Etappe einschließlich der Angabe, ob sie offen oder geschlossen ist
`ARCHIVED`	Boolesch	Ob die Pipelinestufe gelöscht wurde.
`CREATEDAT`	Zeitstempel	Wann die Pipelinestufe erstellt wurde.

Beispiel 1

Abrufen von Pipeline-Phasen für eine Deal-Pipeline mit dem Namen Sales-Pipeline.

Abfrage:

SELECT pipelineid, stageId, label
FROM pipeline_stages
WHERE not archived
AND pipelineid = (
SELECT pipelineid
FROM pipelines
WHERE objectTypeId = '0-3'
AND not archived
AND label = 'Sales Pipeline' LIMIT 1)
ORDER BY displayorder;

Gibt zurück:

PIPELINE-ID	STAGEID	ETIKETT
941650	941651	Kontaktiert
941650	941652	Termin vereinbart
941650	941653	Rechnung zugeschickt
...	...	...

Beispiel 2

Abrufen aller Deals und ihre jeweiligen Pipeline-Phasen.

Abfrage:

SELECT
deals.objectId deal_id,
deals.properties:dealname::varchar deal_name,
pipelines.label pipeline_name,
pipeline_stages.label pipeline_stage_name
FROM object_with_object_properties deals
INNER JOIN pipelines
ON deals.objectTypeId = pipelines.objectTypeId
AND deals.properties:pipeline::string = pipelines.pipelineid
INNER JOIN pipeline_stages
ON deals.objectTypeId = pipeline_stages.pipelineid
AND deals.properties:pipeline::string = pipeline_stages.pipelineid
AND deals.properties:dealstage::string = pipeline_stages.stageId
WHERE deals.objecttypeId = '0-3';

Gibt zurück:

DEAL_ID	DEAL_NAME	PIPELINE_NAME	PIPELINE_STAGE_NAME
605140072	Meowmix Global Signup	Sales-Pipeline	Vertrag gesendet
605457408	Friskies Rebranding	Sales-Pipeline	Termin vereinbart
604362473	Fresh Step App Build	Sales-Pipeline	Vertrag unterzeichnet
...	...	...	...

Fragen zum Eigentum

property_definitions

Dieses Datenbankobjekt enthält Informationen über Objekteigenschaften und Ereigniseigenschaften in Ihrem HubSpot Account. Zu den Event-Eigenschaften gehören Standard-Events wie das Öffnen und Anklicken von E-Mails sowie Eigenschaften vom Typ benutzerdefiniertes Event . Diese Informationen können bei der Definition von Werten hilfreich sein, die in object_properties- und events-Daten zu finden sind.

Sie können bestimmte Eigenschaften identifizieren, indem Sie ihre Objekttyp-ID und ihren Namen kombinieren. Sie können ähnliche Informationen mithilfe der Eigenschaften-API abrufen.

Dieses Datenbankobjekt kann die folgenden Spalten zurückgeben:

Spaltenname	Typ	Beschreibung
`OBJECTYPEID`	Varchar	Die ID des Objekts, auf das sich das Event bezieht.
`NAME`	Varchar	Der interne Name der Eigenschaft.
`LABEL`	Varchar	Das Label der Eigenschaft.
`DESCRIPTION`	Varchar	Die Beschreibung der Eigenschaft.
`TYPE`	Varchar	Der Typ der Eigenschaft (z. B. Zeichenfolge, Zahl, Datetime).
`FIELDTYPE`	Varchar	Der Feldtyp der Eigenschaft. Legt fest, wie die Eigenschaft in HubSpot und in Formularen angezeigt wird (z. B. Kontrollkästchen, Auswahl).
`DISPLAYORDER`	Zahl	Die Anzeigereihenfolge der Eigenschaft.
`GROUPNAME`	Varchar	Der Gruppenname der Eigenschaft.
`OPTIONS`	Variant	Bei Aufzählungseigenschaften ist dies eine Reihe der Optionen der Eigenschaft, einschließlich der Attribute der einzelnen Optionen (z. B. Anzeigereihenfolge, Label).
`CREATEDUSERID`	Zahl	Die ID des Benutzers, der die Eigenschaft erstellt hat.
`REFERENCEDOBJECTTYPE`	Varchar	Der Typ des Objekts, auf das die Eigenschaft verweist. Mitarbeitereigenschaften geben den Wert OWNER zurück.
`CALCULATED`	Boolesch	Ob die Eigenschaft eine berechnete Eigenschaft ist.
`EXTERNALOPTIONS`	Boolesch	Ob die Optionen der Eigenschaft in einem externen System definiert sind.
`HASUNIQUEVALUE`	Boolesch	Ob die Werte der Eigenschaft eindeutig sind. Kann nur beim Erstellen einer Eigenschaft über die API festgelegt werden.
`HIDDEN`	Boolesch	Ob die Eigenschaft in HubSpot ausgeblendet ist.
`SHOWCURRENCYSYMBOL`	Boolesch	Ob der Wert einer Zahleneigenschaft als Währung formatiert ist.
`FORMFIELD`	Boolesch	Ob diese Eigenschaft in Formularen verwendet werden kann.
`READONLYDEFINITION`	Boolesch	Ob die Eigenschaft in HubSpot bearbeitet werden kann.
`READONLYVALUE`	Boolesch	Ob der Wert der Eigenschaft in HubSpot bearbeitet werden kann.
`HUBSPOTDEFINED`	Boolesch	Ob die Eigenschaft von HubSpot oder von einem Benutzer erstellt wurde.
`ARCHIVED`	Boolesch	Ob die Eigenschaft gelöscht wurde.
`CREATEDAT`	Zeitstempel	Der Zeitpunkt (Datum und Uhrzeit), zu dem die Eigenschaft in HubSpot erstellt wurde.
`UPDATEDAT`	Zeitstempel	Der Zeitpunkt (Datum und Uhrzeit), zu dem die Daten zuletzt in HubSpot aktualisiert wurden. Erfahren Sie mehr über Spaltendatentypen.
`INGESTEDAT`	Zeitstempel	Der Zeitpunkt (Datum und Uhrzeit), zu dem die Daten zuletzt von Snowflake erfasst wurden.

Beispiel 1

Abrufen der Namen und Beschreibungen für alle Kontakteigenschaften.

Abfrage:

SELECT name, label, description
FROM property_definitions
WHERE objectTypeId = '0-1'

Gibt zurück:

NAME	ETIKETT	BESCHREIBUNG
entered_sql_stage	SQL-Phase, in die Eintritt erfolgt ist	Beginn der Zählung der Tage der SQL-Phase.
first_conversion_event_name	Erste Konversion	Das erste Formular, das dieser Kontakt eingesendet hat.
Adresse	Straße	Die Adresse der Kontaktperson.

Event-Abfragen

Events umfassen standardmäßige HubSpot-Events und benutzerdefinierte verhaltensorientierte Events. Jedes Ereignis hat sein eigenes Datenbankobjekt mit der Bezeichnung events_eventname.

Vor- und Nachname
EREIGNISSE_ANZEIGE_INTERAKTION	Details zu einer Anzeige und den Kontakten, die mit der Anzeige interagiert haben, indem sie auf die Anzeige geklickt oder ein Formular ausgefüllt haben, nachdem sie mit der Anzeige in Kontakt gekommen sind.
EVENTS_AD_METRICS_IMPORTED_V0	Details zu einer Anzeige und deren Leistungskennzahlen.
EREIGNIS_AUFRUF_ERWÄHNT_SCHLÜSSELWORT	Einzelheiten zu den von den Gesprächsteilnehmern genannten Schlüsselwörtern.
EREIGNISSE_GEKLICKT_LINK_IN_EMAIL_V2	Von Kontakten angeklickte Links in Marketing-E-Mails.
EREIGNISSE_GEKLICKTER_LINK_IM_VERFOLGTEN_POSTEINGANG_EMAIL_V8	Von Kontakten angeklickte Links in Posteingangs-E-Mails von Konversationen.
EVENTS_COOKIE_BANNER_GEKLICKT	Kontakte, die auf Cookies geklickt haben.
EVENTS_COOKIE_BANNER_VIEWED	Kontakte, die Cookies angesehen haben.
EREIGNISSE_DOKUMENTE_GEMEINSAM_V2	Verkaufsdokumente, die mit Kontakten über einen externen Link geteilt werden.
EREIGNISSE_DOKUMENTE_ANGESEHEN_V2	Verkaufsdokumente und Kontakte, die sie durch Öffnen des externen Links aufgerufen haben.
EREIGNISSE_DOKUMENTE_ERLEDIGT_V2	Verkaufsdokumente und Kontakte, die sie abgeschlossen haben.
EREIGNISSE_HS_GEPLANTE_EMAIL_V2	E-Mails, die zum Versand an die HubSpot-E-Mail-Server übermittelt werden.
EREIGNISSE_MTA_ABGELIEFERTE_EMAIL_V2	E-Mails, die von den HubSpot-E-Mail-Servern erfolgreich an die Empfänger zugestellt wurden.
EREIGNISSE_MTA_GEPRELLT_EMAIL_V2	E-Mail-Zustellversuche, die vom E-Mail-Server des Empfängers abgelehnt wurden.
EREIGNISSE_GEÖFFNETE_EMAIL_V2	E-Mail-Öffnungen durch Kontakte.
EREIGNISSE_GEMELDETER_SPAM_EMAIL_V2	E-Mails, die von Empfängern als Spam markiert wurden.
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2	Änderungen an E-Mail-Abonnements durch die Empfänger.
EREIGNISSE_GEÖFFNETE_VERFOLGTE_POSTEINGANG_EMAIL_V8	Öffnungen von E-Mails im Posteingang nach Kontakten.
EREIGNISSE_MB_MEDIA_ABGESPIELT	Aktivität der Videowiedergabe nach Kontakten.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE	Kontakt buchte ein Treffen über Sequence.
EREIGNISSE_V2_KONTAKT_EINGESCHRIEBEN_IN_REIHENFOLGE	Kontakt eingeschrieben von Sequenz.
EREIGNISSE_V2_KONTAKT_BEENDET_SEQUENZ	Sequenz beendet.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL	Der Kontakt hat auf eine E-Mail geantwortet (oder eine eingehende E-Mail, die eine Sequenz ausgelöst hat), die über die Sequenz gesendet wurde.
EVENTS_V2_CONTACT_UNROLLED_FROM_SEQUENCE	Kontakt wird aus der Sequenz entfernt.
EVENTS_V2_CONTACT_UNROLLED_MANUALLY_FROM_SEQUENCE	Der Benutzer hat die Registrierung des Kontakts manuell aufgehoben.
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL	Der Kontakt hat sich abgemeldet und die Sequenz abbestellt.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED	Sequenz-E-Mail gebounct.
EVENTS_V2_SEQUENCE_ERRORED	Fehlerhafte Sequenz führt zur Abmeldung.
EVENTS_V2_SEQUENCE_STEP_EXECUTED	Sequenzschritt ausgeführt.
EREIGNISSE_BESUCHT_SEITE	Website-Besuche nach Kontakten.
VERANSTALTUNGEN_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER>	Integrationsevents (Chronik V3 API )

Sie können Events identifizieren, indem Sie ihre Event-Typ-ID und ID kombinieren. Die Spalten, die zurückgegeben werden, hängen vom Event ab, mit einer Spalte für jede Event-Eigenschaft. Alle Events geben die folgenden Spalten zurück:

Bitte beachten: HubSpot hat zwei neue Spalten zu allen Ereignistabellen und -ansichten hinzugefügt:

occurredat
occurredatdateint

Diese Spalten ersetzen die Spalten occuredat und occuredatdateint spalten am 24. November 2022ersetzen. Ab diesem Datum sind die alten Spalten nicht mehr verfügbar, und Versuche, ein Datenbankobjekt oder eine Ansicht, die Ereignisse mit diesen Spalten enthält, abzufragen, schlagen fehl. Erfahren Sie mehr über Breaking Changes für Snowflake-Datenfreigaben.

Spaltenname	Typ	Beschreibung
`EVENTTYPEID`	Varchar	Die ID des Ereignistyps, ähnlich wie OBJECTTYPEID Sie können alle Ereignistyp-IDs in Ihrem Konto mit der Ansicht object_and_event_type_definitions abfragen.
`ID`	Varchar	Dies ist für jeden Veranstaltungstyp einzigartig. Innerhalb eines bestimmten Ereignistyps haben keine zwei Datensätze die gleiche ID.
`OBJECTTYPEID`	Varchar	Der Typ des Objekts, das das Event abgeschlossen hat. Ein Klick auf einen E-Mail-Link würde zum Beispiel `0-1` in dieser Spalte angezeigt, die das Kontaktobjekt darstellt.
`OBJECTID`	Zahl	Die ID des Datensatzes, der das Event abgeschlossen hat.
`OCCURREDAT`	Zeitstempel	Wann das Event aufgetreten ist.
`OCCURREDATDATEINT`	Zahl	Eine Zahl, die angibt, wann das Event aufgetreten ist. Enthält die gleichen Daten wie die Spalte `OCCURREDAT` spalte, jedoch als Zahl formatiert und als Teil des Clusterschlüssels der Tabelle verwendet. In den meisten Fällen können Sie den `OCCURREDAT` zeitstempel anstelle dieser Zahl verwenden.
`OCCUREDATDATEINT`	Zahl	Eine Zahl, die angibt, wann das Event aufgetreten ist. Enthält die gleichen Daten wie die Spalte `OCCURREDAT` spalte, jedoch als Zahl formatiert und als Teil des Clusterschlüssels der Tabelle verwendet. In den meisten Fällen können Sie den `OCCURREDAT` zeitstempel anstelle dieser Zahl verwenden. Bitte beachten: Diese Spalte wird am 24. November 2022 veraltet sein und durch ersetzt `OCCURREDATDATEINT`.
`OCCUREDAT`	Zeitstempel	Wann das Event aufgetreten ist. Bitte beachten Sie: Diese Spalte wird am 24. November 2022 veraltet sein und ersetzt durch `OCCURREDAT`.
`INGESTEDAT`	Zeitstempel	Der Zeitpunkt (Datum und Uhrzeit), zu dem die Daten zuletzt von Snowflake erfasst wurden. Erfahren Sie mehr über Spaltendatentypen.
`PROPERTY_*`	Varchar	Einzelne Spalten, die die Event-Eigenschaften enthalten.

Beispiel 1

Abrufen der 50 letzten E-Mail-Klick-Events.

Abfrage:

SELECT eventTypeId, objectTypeId, objectId, occuredAt, property_hs_click_raw_url AS hs_click_raw_url
FROM events_clicked_link_in_email_V2 ORDER BY occuredAtLIMIT 50;

Gibt zurück:

EVENT-TYP-ID	OBJEKTTYP-ID	OBJEKT-ID	OCCUREDAT	HS_CLICK_RAW_URL
4-666288	0–1	45318579	2016-08-04 21:06:43.245	http://website.com?utm_campaign=Launch&utm_source=hs_email&utm_medium=email&utm_content=32520579
4-666288	0–1	80701	2016-08-29 13:31:28.622	https://cta-image-cms2.hubspot.com/ctas/v2/public/cs/ci/?pg=f0f6585a-08fc-4273-8422-49cfaddcf8d8&pid=1976760&ecid=ACsprvtkRbakerw4BiWlaDL7xFAqau1aW9m1_PAqSfQiWarY69X7Ds42zHGYTCfhHJLrXUP86Nxu
4-666288	0–1	26146013	2017-11-30 14:27:11.528	https://hubs.ly/H097a37a?utm_source=hs_email&utm_medium=email&utm_content=58251290
...	...	...	...	...

Beispiel 2

Abrufen aller E-Mail-Klick-Events nach den Kontakten, die geklickt haben. Mit diese Abfragen werden durch das Verbinden mit object_with_object_properties Kontaktdaten abgerufen.

Abfrage:

SELECT click.occuredat click_timestamp, click.property_hs_click_raw_url click_url, contact.properties:firstname::varchar contact_firstname, contact.properties:lastname::varchar contact_lastname FROM events_clicked_link_in_email_V2 click LEFT JOIN object_with_object_properties contact ON click.objectTypeId = contact.objectTypeId AND click.objectId = contact.objectId LIMIT 3;

Gibt zurück:

CLICK_TIMESTAMP	CLICK_URL	CONTACT_FIRSTNAME	CONTACT_LASTNAME
2019-01-04 22:35:41.264	https://help.website.com/articles/tutorial/how-to-use-email-tool?utm_source=hs_automation&utm_medium=email&utm_content=68042217	Hobbes	Baron
2018-11-08 09:37:41.400	https://www.website.net/webinar-case-study?utm_source=hs_automation&utm_medium=email&utm_content=55200164	Milla	Günter
2018-11-08 09:37:41.426	https://www.website.net/contact?utm_source=hs_automation&utm_medium=email&utm_content=55200164	Harlow	Villari
...	...	...	...

Objekt_und_Ereignis_Typ_Abfragen

object_and_event_type_definitions

Dieses Datenbankobjekt enthält Definitionen für alle in Ihrem HubSpot-Konto verfügbaren Objekte und Ereignisse.

Dieses Datenbankobjekt kann die folgenden Spalten zurückgeben:

Spaltenname	Typ	Beschreibung
`OBJECTTYPEID`	Varchar	Die ID des Objekts, das die Pipeline enthalten kann (z. B. Deals oder Tickets).
`FULLYQUALIFIEDNAME`	Varchar	Der Name des Objekts oder Events.
`INGESTEDAT`	Zeitstempel	Der Zeitpunkt (Datum und Uhrzeit), zu dem die Daten zuletzt von Snowflake erfasst wurden. Erfahren Sie mehr über Spaltendatentypen.

Beispiel 1

Abrufen aller in Ihrem HubSpot-Account verfügbaren Objekte und Events.

Abfrage:

SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;

Gibt zurück:

OBJEKTTYP-ID	FULLYQUALIFIEDNAME
0–1	CONTACT
0–8	LINE_ITEM
0–11	CONVERSATION
...	...

Segment-Abfragen

Im Folgenden erfahren Sie, wie Sie Ihre Segmente abfragen können, z. B. die verfügbaren Kontakt- und Unternehmenssegmente und die in diesen Segmenten enthaltenen Datensätze.

Segmente

Dieses Datenbankobjekt enthält Informationen über Kontakt- und Unternehmenssegmente in HubSpot. Gibt eine Zeile pro Segment zurück, und die Spalten enthalten Segmentdetails wie Segmentname, -größe und den Objekttyp der enthaltenen Datensätze. Enthält keine Informationen zu den einzelnen Datensätzen innerhalb der einzelnen Segmente (siehe segment_membership).

Dieses Datenbankobjekt kann die folgenden Spalten zurückgeben:

Spaltenname	Typ	Beschreibung
`OBJECTTYPEID`	Varchar	Der Typ der Datensätze im Segment (z. B. Kontakt oder Unternehmen ).
`SEGMENTID`	Zahl	Die ID des Segments. Wird mit der Spalte SEGMENT-ID in der Tabelle segment-memberships verbunden.
`CLASSICSEGMENTID`	Zahl	Eine für Kontaktsegmente spezifische ID, die mit der ID in der URL des Segments in HubSpot übereinstimmt.
`NAME`	Varchar	Der Name des Segments.
`SIZE`	Zahl	Die Anzahl der Datensätze im Segment.
`CREATEDBYUSERID`	Zahl	Die ID des Benutzers, der das Segment erstellt hat.
`CREATEDAT`	Zeitstempel	Wann das Segment in HubSpot erstellt wurde.
`UPDATEDBYUSERID`	Zahl	Die ID des Benutzers, der das Segment zuletzt aktualisiert hat.
`UPDATEDAT`	Zeitstempel	Der Zeitpunkt (Datum und Uhrzeit), zu dem das Datum zuletzt in HubSpot aktualisiert wurde. Erfahren Sie mehr über Spaltendatentypen.
`INGESTEDAT`	Zeitstempel	Der Zeitpunkt (Datum und Uhrzeit), zu dem die Daten zuletzt von Snowflake erfasst wurden.

Beispiel 1

Abrufen aller Kontaktsegmente.

Abfrage:

SELECT segmentId, name, size
FROM segments
WHERE objectTypeId = '0-1';

Gibt zurück:

SEGMENTSID	NAME	GRÖSSE
118131	Wöchentliche Kontaktaufnahme	103
66156	Blog-Abonnenten	455
771852	Top-Abonnenten 2021	37
...	...	...

Beispiel 2

Abrufen eines bestimmten Kontaktsegments mit dem Namen Top-Abonnenten 2021.

Abfrage:

SELECT segmentId, name, size
FROM segments
WHERE objectTypeId = '0-1' ANDsegmentName = 'Top subscribers 2021';

Gibt zurück:

SEGMENT-ID	NAME	GRÖSSE
771852	Top-Abonnenten 2021	37

segment_membership

Dieses Datenbankobjekt enthält Informationen darüber, welche Datensätze Mitglieder welcher Segmente sind, mit einer Zeile pro Datensatz im Segment. Wenn Sie zum Beispiel ein Blog-Abonnentensegment mit 500 Kontakten haben, gibt das Datenbankobjekt 500 Zeilen zurück.

Enthält nur Segment-IDs und Objekt-IDs. Weitere Informationen erhalten Sie durch Verbinden mit dem Segmente-Datenbankobjekt.

Dieses Datenbankobjekt kann die folgenden Spalten zurückgeben:

Spaltenname	Typ	Beschreibung
`SEGMENTID`	Varchar	Die ID des Segments. Wird mit der Spalte HS_SEGMENT_ID in der Segmenttabelle verbunden.
`OBJECTID`	Varchar	Die ID des Datensatzes im Segment.
`UPDATEDAT`	Zeitstempel	Der Zeitpunkt (Datum und Uhrzeit), zu dem die Daten zuletzt in HubSpot aktualisiert wurden. Erfahren Sie mehr über Spaltendatentypen.
`INGESTEDAT`	Zeitstempel	Der Zeitpunkt (Datum und Uhrzeit), zu dem die Daten zuletzt von Snowflake erfasst wurden.

Beispiel 1

Abrufen der IDs aller Kontakte im Segment Top-Abonnenten 2021 .

Abfrage:

SELECT objectId
FROM segment_memberships
INNER JOIN segments
ON segment_memberships.segmentId = segments.segmentId
WHERE segments.objectTypeId = '0-1'
AND segments.name = 'Top Subscribers 2021';

Gibt zurück:

OBJEKT-ID

54325098

96805401

6922028

...

Beispiel 2

Abrufen der Vor- und Nachnamen von Kontakten im Segment Top-Abonnenten 2021 .

Abfrage:

AUSWÄHLEN

CONTACT.objectId AS object_id,

contact.properties:firstname::string AS firstname,

contact.properties:lastname::string AS lastname

VON object_with_object_properties ALS KONTAKT

INNER JOIN segment_memberships ALS MITGLIEDSCHAFT

ON contact.objectId = membership.objectId

INNER JOIN-Segmente

ON membership.segmentId = segments.segmentId

WOBEI contact.objectTypeId = '0-1'

AND segments.objectTypeId = '0-1'

UND segments.name = 'Top-Abonnenten 2021';

Gibt zurück:

OBJEKT-ID	VORNAME	NACHNAME
54325098	Hobbes	Baron
96805401	Milla	Günter
6922028	Henry	Rilke
...	...	...

FAQs

Ich möchte Daten ähnlich einem Bericht aus der Hubspot-App generieren. Wie gehe ich dabei vor?

Im Allgemeinen sollten Sie sich die Spalten in dem Bericht ansehen, mit dem Sie vergleichen. Wenn die Berichtsvisualisierung nicht tabellarisch ist, werden bei der Konvertierung in eine Tabelle die im Bericht enthaltenen Spalten angezeigt. Diese Spalten sind in der Regel Eigenschaften eines Objekttyps oder eines Ereignistyps. Der nächste Schritt besteht darin, herauszufinden, welchem Objekttyp eine Spalte entspricht. Sie können dies tun, indem Sie property_definitions abfragen:

SELECT * FROM property_definitions

WHERE label = [column_name]

Möglicherweise gibt es nicht immer eine exakte Übereinstimmung, da einige Eigenschaftsnamen in der Regel in einen beschreibenderen Namen in der App aufgelöst werden. In solchen Fällen kann eine unscharfe Suche mit dem LIKE-Operator in der Spalte label (oder sogar in der Spalte description) in property_definitions helfen.

Nachdem festgestellt wurde, zu welchem Objekttyp die Spalte gehört, ist es trivial zu bestimmen, was abgefragt werden soll. Abfrage object_with_object_properties und Filterung nach objectTypeId für diesen Typ. Lesen Sie die erforderlichen Eigenschaften aus der Eigenschaften-JSON-Spalte.

Wie verknüpfe ich diesen Datentyp mit einem anderen, z. B. wie kann ich Formulare für eine Kampagne abrufen?

Um die mit den einzelnen Kampagnen verknüpften Formulare abzurufen, treten Sie OBJECT_WITH_OBJECT_PROPERTIES, ASSOCIATIONSund ASSOCIATION_DEFINITIONSbei.

EINDEUTIG AUSWÄHLEN

Kampagnen.properties:hs_name::string AS campaign_name,

forms.properties:hs_form_id::string AS form_id

VON object_with_object_properties ALS Kampagnen

ZUORDNUNGEN ALS Zuordnung beitreten

ON Zuordnung.fromObjectId = Kampagnen.objectId

JOIN association_definitions AS Definition

ON definition.combinedAssociationTypeId =

Zuordnung.combinedAssociationTypeId

object_with_object_properties AS Formulare BEITRETEN

ON forms.objectId = Zuordnung.zuObjectId

WHERE Kampagnen.objectTypeId = '0-35'

AND forms.objectTypeId = '0-28'

AND definition.fromObjectTypeId = '0-35'

UND definition.toObjectTypeId = '0-28';

Wie kann ich den Status der HubSpot-Snowflake-Integration feststellen?

Um Echtzeit-Status-Updates über Ausfälle und Probleme für die HubSpot-Snowflake-Integration zu erhalten, fragen Sie die Ansicht data_share_status ab:

SELECT * FROM hubspot.public.data_share_status LIMIT 1

Die Ergebnisse werden wie folgt angezeigt:

STATUS	NACHRICHT	AKTUALISIERT BEI
OK	ZUR ZEIT KEIN VORFALL BEKANNT	2023-04-10 09:21:20.123

Diese Ansicht bietet Aktualisierungen des Integrationsstatus in umgekehrter chronologischer Reihenfolge. Wenn Sie die Ergebnisse dieser Abfrage in ein Dashboard integrieren, können Sie die Leistung der Integration verfolgen und eventuelle Ausfallzeiten oder Störungen erkennen.

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.

HubSpot-Daten in Snowflake abfragen

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

Datenrückstand und die Region Ihres Snowflake Accounts

Ihre Snowflake-Umgebung einrichten

Datenüberblick

Einschränkung und Anordnung der zurückgegebenen Daten

Spaltendatentypen

Datentypen umwandeln

Objektabfragen

object_with_object_properties

Beispiel 1

Beispiel 2

objects

Beispiel 1

object_properties

Beispiel 1

Beispiel 2

object_properties_history

Beispiel 1

Beispiel 2

Zuordnungsabfragen

association_definitions

Beispiel 1

Beispiel 2

associations

Beispiel 1

Beispiel 2

Beispiel 3

Rückfragen des Eigentümers

owners

Beispiel 1

Beispiel 2

Beispiel 3

Teamabfragen

teams

Beispiel 1

owner_team

Beispiel 1

Pipeline-Abfragen

pipelines

Beispiel 1

Beispiel 2

pipeline_stages

Beispiel 1

Beispiel 2

Fragen zum Eigentum

property_definitions

Beispiel 1

Event-Abfragen

Beispiel 1

Beispiel 2

Objekt_und_Ereignis_Typ_Abfragen

object_and_event_type_definitions

Beispiel 1

Segment-Abfragen

Segmente

Beispiel 1

Beispiel 2

segment_membership

Beispiel 1

Beispiel 2

FAQs

Ich möchte Daten ähnlich einem Bericht aus der Hubspot-App generieren. Wie gehe ich dabei vor?

Wie verknüpfe ich diesen Datentyp mit einem anderen, z. B. wie kann ich Formulare für eine Kampagne abrufen?

Wie kann ich den Status der HubSpot-Snowflake-Integration feststellen?

Verwandte Artikel