HubSpot-Daten in Snowflake abfragen
Zuletzt aktualisiert am: Mai 31, 2024
Mit einem der folgenden Abonnements verfügbar (außer in den angegebenen Fällen):
Operations Hub Enterprise |
Nachdem Sie Snowflake mit Ihrem HubSpot Account verbunden haben, können Sie die Datenfreigabe von Snowflake verwenden, um HubSpot-Daten von Ihrem Snowflake Account abzufragen.
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:
- V2_DAILY: das Tagesschema zur Abfrage von Daten auf der Grundlage von Tabellen. Die Daten in diesem Schema werden einmal pro Tag aktualisiert. Die Verwendung dieses Schemas führt zu schnelleren Abfragen und wird für direkte Abfragen in Snowflake empfohlen.
- V2_LIVE: das Live-Schema, das auf Secure Views von HubSpot-Daten basiert. Die Daten in diesem Schema werden bis zu alle 15 Minuten aktualisiert. Wenn Sie eine große Menge an Daten abfragen, können die Abfragen langsam sein. In diesem Fall empfiehlt es sich, die Daten zunächst über einen ETL-Prozess in eine eigene Tabelle zu kopieren und dann diese Tabelle abzufragen.
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, property_createddate
FROM hubspot_share_name.V2_LIVE.objects_deals
LIMIT 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.
- Assoziationen: alle verfügbaren Assoziationstypen und aktuell verknüpfte 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.
- Listen: HubSpot Kontakt- und Unternehmenslisten.
- 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-Datensätzen, einschließlich der Eigenschaftshistorie.
Erfahren Sie mehr über HubSpots CRM-Datenmodell.
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 einer Aktualisierung in das Änderungsprotokoll aufgenommen.
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 objects_deals
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.
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
und UpdatedAt
spalten zurück:
SELECTobjectId, updatedAt
FROM objects_contacts
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 Konto. Bei Listen bezieht sich dies auf den Typ der Liste (z. B. Kontakt oder Unternehmen). Sie können alle Objekt- und Event-IDs in Ihrem Konto 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 Ingestion-Zeitstempel verbunden, 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 amountFROM 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 verschiedener Typen sind auf zwei Arten organisiert und verfügbar:
- Individuell: Jeder Objekttyp wird in einer eigenen Ansicht gespeichert und enthält nur Datensätze desselben Objekttyps, z. B. enthält objects_contacts nur Kontaktdatensätze. Damit entfällt die Notwendigkeit, bei der Abfrage eine objecttypeid anzugeben. Diese Ansichten sind einfacher abzufragen, da Sie die ObjectTypeIds nicht kennen müssen. Sie geben auch Daten in einem besser nutzbaren Format zurück, wobei jede Zeile einem Objekt und der aktuellen Version seiner Eigenschaften entspricht. Solange Sie keine langsamen Abfragen erleben, ist es ratsam, diese Ansichten zum Abrufen von Objektdaten zu verwenden. Weitere Informationen finden Sie unter Objects_X-Ansichten unten.
- Kombiniert: Alle Datensätze für alle Objekttypen werden in einem Datenbankobjekt zusammengefasst. Daher müssen Sie bei der Abfrage einen Filter wie "WHERE objectTypeId='0-1'" angeben. Sie können zum Beispiel die folgenden Objekttypen bei der Abfrage verwenden:
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.
Diese Datenbankobjekte sind im Allgemeinen geeignet, wenn Sie eine bessere Abfrageleistung wünschen, als sie von objects_x views erreicht werden kann. Weitere Einzelheiten finden Sie unter object_with_object_properties, object_properties, objects und object_properties_history.
objects_x Ansichten
In diesem Datenbankobjekt hat jeder verfügbare Objekttyp, einschließlich benutzerdefinierter Objekte, seine eigene spezifische Ansicht, wobei jede Ansicht nur Datensätze für Objekte dieses spezifischen Objekttyps enthält. Diese Ansichten werden nach dem Format OBJECTS_<object type name> benannt, wobei <object type name> die Bezeichnung des Objekttyps in der Pluralformist. (Hinweis: Wenn der Objekttyp keine Pluralform hat, ist <object type name> einfach die Bezeichnung des Objekttyps in der Singularform, verbunden mit "S").
Abfragen an diese Ansicht geben eine Zeile für jeden Datensatz innerhalb eines Objekts zurück, wobei jede Eigenschaft des Objekts als separate Spalte verfügbar ist.
Im Folgenden finden Sie eine umfassende Liste der verfügbaren HubSpot-Objekttypen (d. h. nicht benutzerdefinierte Objekttypen), eine kurze Beschreibung der Daten, die sie darstellen, und die entsprechenden Ansichten:
HubSpot Objekttyp |
ObjectTypeId |
Beschreibung |
0–1 |
Informationen über Personen, die mit Ihrem Unternehmen interagieren |
|
0–2 |
Informationen über einzelne Unternehmen oder Organisationen |
|
0–3 |
Details zu Einnahmemöglichkeiten mit einem Kontakt oder einem Unternehmen. |
|
0–4 |
Speichert Daten aus CRM-Aktionen, einschließlich Notizen, Aufgaben, E-Mails, Besprechungen und Anrufen. |
|
0–5 |
Vertretung von Kundenanfragen nach Hilfe oder Unterstützung. |
|
0-14 |
Dient der Weitergabe von Preisinformationen an potenzielle Käufer. |
|
0-15 |
Details für einzelne Übermittlungen für ein HubSpot-Formular. |
|
0–8 |
Sie stellen eine Teilmenge der in einem Geschäft verkauften Produkte dar. Wenn ein Produkt einem Deal zugeordnet wird, wird es zu einem Artikel. |
|
0–11 |
Details zu eingehenden Nachrichten aus mehreren Kanälen. |
|
0–25 |
Details zu Ihren Landing Pages |
|
0-27 |
Speichert Informationen über To-Do-Listen |
|
0-28 |
Zum Sammeln von Lead-Informationen über Ihre Besucher und Kontakte |
|
0-29 |
Details zu E-Mails von der Marketingzentrale |
|
AD_ACCOUNT |
0-30 |
Speichert Informationen über Ihre Werbekonten bei Linkedin, Facebook und Google |
0-31 |
Details zu Ihren Werbekampagnen. Eine Anzeigenkampagne kann eine oder mehrere Anzeigen enthalten |
|
AD_GRUPPE |
0-32 |
Logische Gruppierung von Anzeigen innerhalb einer Anzeigenkampagne |
ANZEIGE |
0-33 |
Details zu einzelnen Anzeigen |
0-35 |
Informationen über verwandte Marketing-Assets und -Inhalte, so dass Sie die Effektivität Ihrer kollektiven Marketingbemühungen leicht messen können. |
|
SITE_PAGE |
0-38 |
Daten über einzelne Seiten auf Ihren Websites |
0-39 |
Daten zu Blogbeiträgen |
|
0-45 |
Informationen über Gruppierungen von Objektdatensätzen auf der Grundlage ihrer Eigenschaften oder Aktivitäten |
|
0-48 |
Anrufe, die von anderen CRM-Datensätzen getätigt wurden, z. B. von Kontakten |
|
RECHNUNG |
0-53 |
Verwalten und Synchronisieren von Rechnungen mit externen Buchhaltungssystemen |
0-57 |
Informationen über in Hubspot importierte Medieninhalte |
|
0-58 |
Eine Sequenz ist eine Reihe gezielter, zeitlich abgestimmter E-Mail-Vorlagen zur Pflege von Kontakten im Laufe der Zeit |
|
0-72 |
Geschäftsaufteilungen werden verwendet, um Geschäftsguthaben unter mehreren Benutzern aufzuteilen |
|
0-83 |
Mit Verkaufsdokumenten können Sie eine Bibliothek mit Inhalten für Ihr gesamtes Team erstellen, um Dokumente hochzuladen und mit Ihren Kontakten zu teilen. |
|
0-19 |
Speichert Informationen, die im Rahmen einer Feedback-Umfrage übermittelt wurden. |
|
0-69 |
Abonnements enthalten Details zu wiederkehrenden Zahlungen |
|
0-101 |
Enthält Daten über von Kunden eingezogene Gelder |
Jedes Datenbankobjekt gibt die folgenden Spalten zurück:
Name der Säule |
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 der ID 123752). |
UPDATEDAT |
Zeitstempel |
Das Datum und die Uhrzeit, zu der dieses Objekt in HubSpot zuletzt aktualisiert wurde. |
INGESTEDAT |
Zeitstempel |
Der Zeitpunkt (Datum und Uhrzeit), zu dem die Daten zuletzt von Snowflake erfasst wurden. |
PROPERTY_* |
Varchar |
Für jede Objekteigenschaft, die einen Datums- oder Zahlentyp hat (wie durch property_definitionsangegeben), gibt es zwei Spalten:
|
Beispiel 1
Abrufen des Vornamens, des Nachnamens und der Lebenszyklusphase für alle Kontakte.
Abfrage:
SELECT objectId, property_firstname AS firstname, property_lastname AS lastname,property_lifecyclestage AS lifecyclestageFROM objects_contact
Rückgabe:
OBJECTID |
FIRSTNAME |
LASTNAME |
LIFECYCLESTAGE |
54325098 |
Hobbes |
Baron |
Lead |
96805401 |
Milla |
Günter |
Lead |
6922028 |
Henry |
Rilke |
Lead |
Beispiel 2
Abruf des Geschäftsnamens und der Phase von bis zu drei Geschäften.
Abfrage:
SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmountFROM objects_deals
LIMIT 3
Gibt zurück:
OBJECTID |
EIGENTUM_VERKAUFSNAME |
EIGENTUM_DEALSTAGE |
EIGENTUM_VERKAUFSBETRAG |
38960439 |
Geschäftsname 1 |
geschlossengewonnen |
34199 |
321740651 |
Testgeschäft 123 |
14845019 |
8383663 |
98392101 |
Pop-Up Vordach |
geschlossengewonnen |
9309007 |
Beispiel 3
Abrufen des Geschäftsnamens und der Phase der drei wichtigsten Geschäfte nach Betrag.
Abfrage:
Da die Daten des Geschäftsbetrags als Zahlendatentyp verfügbar sind, können sie für die Bestellung verwendet werden, ohne dass eine Konvertierung oder ein Casting erforderlich ist.
SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmountFROM objects_deals
ORDER BY property_amount DESC
LIMIT 3
Gibt zurück:
OBJECTID |
EIGENTUM_VERKAUFSNAME |
EIGENTUM_DEALSTAGE |
EIGENTUM_VERKAUFSBETRAG |
98392101 |
Pop-Up Vordach |
geschlossengewonnen |
9309007 |
321740651 |
Testgeschäft 123 |
14845019 |
8383663 |
38960439 |
Geschäftsname 1 |
geschlossengewonnen |
34199 |
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:
OBJECTTYPEID | OBJECTID | PROPERTIES |
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:
SELECTobjectId,
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:
OBJECTID | DEALNAME | DEALSTAGE | DEALAMOUNT |
38960439 | Deal-Name 1 | geschlossenverlorene | 7488939 |
321740651 | Deal-Name 1 | geschlossengewonnen | 9292029 |
98392101 | Deal-Name 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 kann nützlich sein, wenn Ihr Konto eine große Menge an Daten enthält, was dazu führt, dass die Ansichten object_with_object_properties und objects_x langsam arbeiten. 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:
OBJECTTYPEID | OBJECTID |
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:
OBJECTTYPEID | OBJECTID | NAME | VALUE |
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:
OBJECTTYPEID | OBJECTID | FIRSTNAME | LASTNAME | 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:
OBJECTID | NAME | VALUE | UPDATEDAT |
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
WHERE
object_properties_history.objectTypeId = '0-1'
AND object_properties_history.name = 'lifecyclestage'
AND object_properties_history.value = 'subscriber'
);
Gibt zurück:
OBJECTID | FIRSTNAME | LASTNAME |
54325098 | Hobbes | Baron |
96805401 | Milla | Günter |
6922028 | Henry | Rilke |
... | ... | ... |
Zuordnungsabfragen
Wie die Daten von Objekten sind auch die Daten von Vereinigungen auf zwei Arten organisiert:
- Individuell: Jeder Assoziationstyp wird in seiner eigenen Ansicht gespeichert und enthält nur Datensätze dieses Typs. Associations_contacts_to_deals enthält zum Beispiel nur Assoziationsdatensätze zwischen Kontakt- und Geschäftsobjekten. Dadurch entfällt die Notwendigkeit, bei der Abfrage eine Assoziationstyp-ID anzugeben. Diese Ansichten sind recht einfach abzufragen, da sie keine Vertrautheit mit dem CRM-Datenmodell erfordern. Sie geben auch eine angereicherte Beschreibung des Assoziationsdatensatzes zwischen zwei Objekten zurück, die leicht in Joins mit objects_x-Ansichten verwendet werden kann. Solange die Abfragen nicht zu langsam sind, ist es ratsam, diese Ansichten zum Abrufen von Zuordnungsdaten zu verwenden. Weitere Informationen finden Sie unter Assoziationen_x_to_y Ansichten unten.
- Kombiniert: Alle Datensätze für alle Assoziationstypen werden in einem Datenbankobjekt zusammengefasst. Daher müssen Sie bei der Abfrage einen Filter wie "WHERE combinedassociationtypeid='0-32'" angeben. Weitere Informationen finden Sie unter Assoziationen und association_definitions weiter unten.
associations_x_to_y views
Jeder Assoziationstyp hat seine eigene Ansicht, die als associations_<association type name> bezeichnet wird, z. B. associations_contacts_to_deals. Jede Ansicht ist eine Teilmenge der Daten im Assoziationsdatenbankobjekt und enthält nur Datensätze einer bestimmten combinedassociationtypeid.
Jedes Datenbankobjekt gibt die folgenden Spalten zurück:
Name der Säule |
Typ |
Beschreibung |
COMBINEDASSOCIATIONTYPEID |
Varchar |
Die eindeutige ID der Zuordnungsdefinition. |
VERBANDSKATEGORIE |
Varchar |
Die Quelle des Zuordnungstyps. Eine von: HUBSPOT_DEFINIERT, BENUTZER_DEFINIERT, INTEGRATOR_DEFINIERT |
ASSOCIATIONTYPEID |
Varchar |
Ein eindeutiger Bezeichner einer Assoziationsdefinition innerhalb einer bestimmten Assoziationskategorie, d. h. keine zwei Definitionen in einer Assoziationskategorie haben die gleiche associationtypeid. |
FROMOBJECTTYPEID |
Varchar |
Die Objecttypeid, die die Quelle der Assoziationsdefinition ist. |
FROMOBJECTTYPE |
Varchar |
Der Name des Objekttyps, der die Quelle der Assoziationsdefinition ist. |
TOOBJECTTYPEID |
Varchar |
Die Objecttypeid, die das Ziel der Assoziationsdefinition ist. |
TOOBJECTTYPE |
Varchar |
Der Name des Objekttyps, der das Ziel der Assoziationsdefinition ist. |
NAME |
Varchar |
Der Name der Zuordnungsdefinition. |
LABEL |
Varchar |
Die Beschreibung der Assoziationsdefinition. |
ISMAINASSOCIATIONDEFINITION |
Boolesch |
Ob die Zuordnungsdefinition der Haupttyp ist. Wenn dies der Fall ist, ist die Definition diejenige, die HubSpot bei verknüpften Datensätzen anzeigt |
[FROMOBJECTTYPE_OBJECTID] z. B. für die Ansicht ASSOCIATIONS_CONTACTS_TO_DEALS ist dies CONTACT_OBJECTID |
Zahl |
Die Objekt-ID des Quellobjekts. |
[TOOBJECTTYPE_OBJECTID] z. B. für die Ansicht ASSOCIATIONS_CONTACTS_TO_DEALS ist dies DEAL_OBJECTID |
Zahl |
Die Objekt-ID des Zielobjekts. |
INGESTEDAT |
Zeitstempel |
Der Zeitpunkt (Datum und Uhrzeit), zu dem die Daten zuletzt von Snowflake erfasst wurden. |
Beispiel 1
Abrufen aller Deals, die mit einem bestimmten Kontakt verbunden sind.
Abfrage:
SELECT
contact_objectId, deal_objectId
FROM vereine_kontakte_zu_abschluessen
WHERE contactId = 6626541373
Rückgabe:
KONTAKT_OBJEKTID |
DEAL_OBJECTID |
6626541373 |
233620335 |
6626541373 |
90253678 |
Beispiel 2
Rufen Sie alle Kontakte in der Zeitzone Bogota und deren Angebote ab.
SELECT contacts.property_firstname contact_firstname,
contacts.property_lastname contact_lastname,
contacts.property_email contact_email,
deals.property_dealtype deal_type, deals.property_amount deal_amount
FROM objects_contacts contacts
JOIN associations_contacts_to_deals assoc on
assoc.contact_objectid=contacts.objectid
JOIN objects_deals deals on deals.objectid=assoc.deal_objectid
where contacts.property_hs_timezone='america_slash_bogota'
CONTACT_FIRSTNAME |
CONTACT_LASTNAME |
KONTAKT_EMAIL |
DEAL_TYPE |
DEAL_AMOUNT |
David |
Magalhães |
dmagalhaes@example.com |
newbusiness |
74848 |
Fernanda |
Rodrigues |
fmoreira@example.com |
newbusiness |
253530 |
Beispiel 3
Rufen Sie alle Kontakte und die Gesamtsumme der abgeschlossenen Geschäfte für jeden Kontakt ab.
SELECT SUM(deals.property_hs_closed_amount) AS
total_closed_amount, contacts.property_email contact_email
FROM objects_contacts contacts
JOIN associations_contacts_to_deals assoc on
assoc.contact_objectid=contacts.objectid
JOIN objects_deals deals on deals.objectid=assoc.deal_objectid
GROUP BY contact_email
ORDER BY total_closed_amount DESC
Gibt zurück:
GESAMTER_ABGESCHLOSSENER_BETRAG |
KONTAKT_EMAIL |
98474793 |
johndoe@riverview.com |
849488 |
sallymae@longford.com |
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 Konto 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:
SELECT
combinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
WHERE fromObjectTypeId = '0-3' AND toObjectTypeId = '0-2'
AND isMainAssociationDefinition = trueORDER 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 kann nützlich sein, wenn Ihr Konto eine große Menge an Daten enthält, was dazu führt, dass die Ansichten associations_x_to_y langsam arbeiten.
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 ASSOZIATIONSART | 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 ASSOZIATIONSART | 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 | USERID | FIRSTNAME | LASTNAME | |
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 | USERID | FIRSTNAME | LASTNAME | |
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.
SELECT
contact.objectId contactid,
contact.property_firstname contact_firstname,
contact.property_lastname contact_lastname,
contact.property_hubspot_owner_id contact_hubspot_owner_id,
owner.firstname owner_firstname,
owner.lastname owner_lastname,
owner.email owner_email
FROM objects_contacts contact
JOIN owners owner ON contact.property_hubspot_owner_id = owner.ownerId
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 die Daten der Deal- und Ticket-Pipelines 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 z. B. Geschäfte und ihre Pipelines abfragen, indem Sie die Daten von objects_deals_view oder object_with_object_properties mit den Pipelines-Daten verbinden.
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:
OBJECTTYPEID | PIPELINEID | LABEL |
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 einer bestimmten Pipeline. Verbindet object_with_object_properties und pipelines.
Abfrage:
SELECT
deals.objectId deal_id,
deals.property_dealname deal_name,
pipelines.label pipeline_name
FROM objects_deals deals
INNER JOIN pipelines
ON deals.objectTypeId = pipelines.objectTypeId
AND deals.property_pipeline = pipelines.pipelineid
WHERE 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 |
Beispiel 3
Wie in Beispiel 2 oben, Abruf von Geschäften innerhalb einer bestimmten Pipeline. Aber anstatt objects_deals in Joins zu verwenden, verwenden Sie 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:
PIPELINEID | STAGEID | LABEL |
941650 | 941651 | Kontaktiert |
941650 | 941652 | Termin vereinbart |
941650 | 941653 | Rechnung zugeschickt |
... | ... | ... |
Beispiel 2
Abrufen aller Deals und ihre jeweiligen Pipeline-Phasen.
Abfrage:
SELECTdeals.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 Typbenutzerdefiniertes verhaltensbezogenes 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 über die API für Eigenschaftenabrufen.
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 bei der Erstellung 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 | LABEL | DESCRIPTION |
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
.
Name | |
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> | Integrationsereignisse (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 wichtige Änderungen 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. |
|
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. |
|
Zahl | Eine Zahl, die angibt, wann das Event aufgetreten ist. Enthält die gleichen Daten wie die Spalte Bitte beachten Sie: Diese Spalte wird am 24. November 2022 veraltet sein und ersetzt durch |
OCCUREDAT |
Zeitstempel | Wann das Event aufgetreten ist. Bitte beachten Sie: Diese Spalte wird am 24. November 2022 veraltet sein und ersetzt durch |
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 occuredAt
LIMIT 50;
Gibt zurück:
EVENTTYPEID | OBJECTTYPEID | OBJECTID | 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:
OBJECTTYPEID | FULLYQUALIFIEDNAME |
0–1 | CONTACT |
0–8 | LINE_ITEM |
0–11 | CONVERSATION |
... | ... |
Abfragen auflisten
Im Folgenden erfahren Sie, wie Sie Ihre Listen abfragen können, z. B. die verfügbaren Kontakt- und Unternehmenslisten und die in diesen Listen enthaltenen Datensätze.
lists
Dieses Datenbankobjekt enthält Informationen über HubSpot-Kontakt- und Unternehmenslisten. Gibt eine Zeile pro Liste zurück, und die Spalten enthalten Listendetails wie den Listennamen, die Größe und den Objekttyp der enthaltenen Datensätze. Enthält keine Informationen zu den einzelnen Datensätzen innerhalb jeder Liste (siehe list_membership).
Dieses Datenbankobjekt kann die folgenden Spalten zurückgeben:
Spaltenname | Typ | Beschreibung |
OBJECTTYPEID |
Varchar | Der Typ der Datensätze in der Liste (z. B. Kontakt oder Unternehmen). |
LISTID |
Zahl | Die ID der Liste. Wird mit der Spalte LISTID in der Tabelle list-memberships verbunden. |
CLASSICLISTID |
Zahl | Eine für Kontaktlisten spezifische ID, die mit der ID in der URL der Liste in HubSpot übereinstimmt. |
NAME |
Varchar | Der Name der Liste. |
SIZE |
Zahl | Die Anzahl der Datensätze in der Liste. |
CREATEDBYUSERID |
Zahl | Die ID des Benutzers, der die Liste erstellt hat. |
CREATEDAT |
Zeitstempel | Wann die Liste in HubSpot erstellt wurde. |
UPDATEDBYUSERID |
Zahl | Die ID des Benutzers, der die Liste 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 Kontaktlisten.
Abfrage:
SELECT listId, name, size
FROM lists
WHERE objectTypeId = '0-1';
Gibt zurück:
LISTID | NAME | GRÖSSE |
118131 | Wöchentliche Kontaktaufnahme | 103 |
66156 | Blog-Abonnenten | 455 |
771852 | Top-Abonnenten 2021 | 37 |
... | ... | ... |
Beispiel 2
Abrufen einer bestimmten Kontaktliste mit dem Namen Top-Abonnenten 2021.
Abfrage:
SELECT listId, name, size
FROM lists
WHERE objectTypeId = '0-1'
ANDlistName = 'Top subscribers 2021';
Gibt zurück:
LISTID | NAME | GRÖSSE |
771852 | Top-Abonnenten 2021 | 37 |
list_membership
Dieses Datenbankobjekt enthält Informationen darüber, welche Datensätze Mitglieder welcher Listen sind, mit einer Zeile pro Datensatz in der Liste. Wenn Sie zum Beispiel eine Blog-Abonnentenliste mit 500 Kontakten haben, gibt das Datenbankobjekt 500 Zeilen zurück.
Enthält nur Listen-IDs und Objekt-IDs. Weitere Informationen finden Sie unter Join mit dem Datenbankobjekt lists.
Dieses Datenbankobjekt kann die folgenden Spalten zurückgeben:
Spaltenname | Typ | Beschreibung |
LISTID |
Varchar | Die ID der Liste. Wird mit der Spalte HS_LIST_ID in der Tabelle lists verbunden. |
OBJECTID |
Varchar | Die ID des Datensatzes in der Liste. |
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 in der Liste Top-Abonnenten 2021.
Abfrage:
SELECT objectId
FROM list_memberships
INNER JOIN lists
ON list_memberships.listId = lists.listId
WHERE lists.objectTypeId = '0-1'
AND lists.name = 'Top Subscribers 2021';
Gibt zurück:
OBJECTID |
54325098 |
96805401 |
6922028 |
... |
Beispiel 2
Abrufen der Vor- und Nachnamen von Kontakten aus der Liste der Top-Teilnehmer 2021.
Abfrage:
SELECT
contact.objectId AS objectid,
contact.property_firstname AS firstname,
contact.property_lastname AS lastname
FROM objects_contacts contact
INNER JOIN list_memberships ON contact.objectId = list_memberships.objectId
INNER JOIN lists ON list_memberships.listId = lists.listId
WHERE lists.objectTypeId = '0-1'
AND lists.name = 'Top Subscribers 2021'
Gibt zurück:
OBJECTID |
VORNAME |
NACHNAME |
54325098 |
Hobbes |
Baron |
96805401 |
Milla |
Günter |
6922028 |
Henry |
Rilke |
... |
... |
... |
Häufig gestellte Fragen
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 wollen. 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. Sie können einfach nach der Ansicht object_x suchen, die dem Typ entspricht.
Wie verknüpfe ich diesen Datentyp mit einem anderen, z. B. wie kann ich Formulare für eine Kampagne abrufen?
Wenn Sie zwei oder mehr verschiedene Datensätze miteinander verknüpfen müssen, sollten Sie sich die Assoziationen ansehen. Assoziationen stellen die Beziehungen zwischen Objekten in HubSpot CRM dar. Alle verschiedenen Assoziationen, die zwischen zwei Typen möglich sind, werden in association_definitions aufgeführt. Im obigen Beispiel müssen Sie ASSOCIATIONS_CAMPAIGNS_TO_FORMS abfragen, um alle Formulare zu kennen, mit denen eine Kampagne verknüpft ist:
SELECT campaigns.property_hs_name campaign_name,
forms.property_hs_form_id form_id
FROM objects_campaigns campaigns
JOIN associations_campaigns_to_forms assoc ON
assoc.campaign_objectid=campaigns.objectid
JOIN objects_forms forms ON forms.objectid=assoc.form_objectid
GROUP BY campaign_name
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 | UPDATEDAT |
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.