Zapytania o dane HubSpot w Snowflake
Data ostatniej aktualizacji: kwietnia 26, 2023
Dostępne z każdą z następujących podpisów, z wyjątkiem miejsc, w których zaznaczono:
|
Po połączeniu Snowflake z kontem HubSpot możesz skorzystać z funkcji Snowflake Data Share, aby odpytać dane HubSpot z konta Snowflake.
Opóźnienie danych a region konta Snowflake
Będziesz miał dostęp do schematu V2_LIVE, który jest aktualizowany co 15 minut oraz schematu V2_DAILY, który jest aktualizowany codziennie.
Skonfiguruj swoje środowisko Snowflake
Aby wykonać kwerendę danych HubSpot w Snowflake, należy wybrać magazyn, bazę danych i schemat, z którego chcemy wykonać kwerendę. Można je ustawić na poziomie arkusza, aby automatycznie uwzględnić je w zapytaniach, lub dodać je ręcznie.
Aby wybrać magazyn, bazę danych i schemat na poziomie arkusza:
- W górnym wierszu arkusza kliknij pasek działań arku sza.
- W wyskakującym oknie:
- Kliknij menu rozwijane Magazyn, a następnie wybierz swój magazyn.
- Kliknij menu rozwijane Baza danych, a następnie wybierz swoją bazę danych HubSpot.
- Kliknij menu rozwijane Schemat, a następnie wybierz schemat, którego chcesz użyć:
- V2_DAILY: schemat dzienny do odpytywania danych na podstawie tabel. Dane w tym schemacie są aktualizowane raz dziennie. Użycie tego schematu powoduje szybsze wykonywanie zapytań i jest zalecane do wykonywania zapytań bezpośrednio w Snowflake.
- V2_LIVE: schemat na żywo oparty na bezpiecznych widokach danych HubSpot. Dane w tym schemacie są aktualizowane maksymalnie co 15 minut. W przypadku zapytań do dużego zestawu danych, zapytania mogą być wolne. W takim przypadku zaleca się najpierw skopiowanie danych do własnej tabeli za pomocą procesu ETL, a następnie wykonanie zapytania do tej tabeli.
Mając skonfigurowane środowisko, możesz wykonywać zapytania do danych HubSpot bez konieczności ręcznego dodawania typu bazy danych lub schematu do zapytań.
Aby ręcznie dodać typ bazy danych i schematu do zapytań, dodaj nazwę bazy danych, a następnie schemat na początku pola FROM
. Na przykład:
SELECT objectTypeId, property_createddate
FROM hubspot_share_name.V2_LIVE.objects_deals
LIMIT 1
Przegląd danych
Zapytania są konstruowane przy użyciu języka SQL i mogą być używane do pobierania danych HubSpot, takich jak:
- Obiekty: standardowe i niestandardowe obiekty, takie jak kontakty, firmy, produkty.
- Rekordy: indywidualnerekordy , takie jak indywidualny kontakt lub firma.
- Asocjacje: wszystkie dostępne typy asocjacji i aktualnie powiązane rekordy.
- Zdarzenia: dane zdarzeń zarówno dla standardowych zdarzeń HubSpot, takich jak otwarcia wiadomości e-mail, jak i niestandardowych zdarzeń behawioralnych.
- Listy: Listy kontaktów i firm w HubSpot.
- Właściciele: użytkownicy na Twoim koncie HubSpot, w odniesieniu do rekordów, które są ustawione jako właściciel.
- Rurociągi: rurociągi transakcji i biletów, w tym etapy rurociągu.
- Właściwości: właściwości i ich wartości na rekordach CRM, w tym historia właściwości.
Dowiedz się więcej o modelu danych CRM firmy HubSpot.
Uwaga: W miarę rozwoju udostępniania danych będziemy wprowadzać zmiany, niektóre z nich łamiące zasady.Zaleca się subskrybowanie dziennika zmian deweloperów HubSpot. Zmiany te będą zawsze publikowane w dzienniku zmian przed każdą aktualizacją.
Ograniczanie i porządkowanie zwróconych danych
Podczas konstruowania zapytań możesz kontrolować ilość zwracanych danych oraz ich kolejność poprzez włączenie do zapytania LIMIT
oraz ORDER BY
. Na przykład, aby zapytać wszystkie kontakty wraz z ich właściwościami, ale zwrócić tylko trzy wyniki i uporządkować je według ID kontaktu, możesz skonstruować zapytanie w następujący sposób:
SELECT objectTypeId, updatedAt, ingestedAt
FROM objects_deals
ORDER BY objectId
LIMIT 10;
Typy danych kolumn
Podczas wyszukiwania danych w Snowflake kolumny, które są zwracane, zależą od danych, które są wyszukiwane. Dostępne kolumny dla danej tabeli lub widoku w Snowflake można wyświetlić, wybierając widok na lewym pasku bocznym.
Uwaga:w dalszej części tego dokumentu używamy terminu obiekt bazy danych, gdy kontekst dotyczy zarówno tabel jak i widoków.
Aby zwrócić konkretną kolumnę, należy umieścić ją w polu SELECT
zapytania. Na przykład, poniższe zapytanie zwróci tylko kolumny OBJECTID
i UpdatedAt
:
SELECTobjectId, updatedAt
FROM objects_contacts
Poniżej znajdują się ogólne definicje kolumn, które mogą zostać zwrócone przez zapytanie. Inne definicje, które nie zostały uwzględnione poniżej, znajdują się w definicjach poszczególnych widoków w artykule powyżej.
- OBJECTTYPEID: wartość VARCHAR określająca typ obiektu. Na przykład 0-1 reprezentuje obiekt kontakty, 0-2 obiekt firmy, a 2-1232 może reprezentować niestandardowy obiekt na Twoim koncie. W zestawieniach jest to typ listy (np. kontakt lub firma). Wszystkie identyfikatory obiektów i zdarzeń na koncie można przeglądać za pomocą widoku object_and_event_type_definitions.
- OBJECTID: liczba BIGINT, która reprezentuje pojedynczy rekord danego typu obiektu na koncie HubSpot. Aby zidentyfikować rekord, należy użyć zarówno ID typu obiektu, jak i ID obiektu.
- INGESTEDAT: znacznik czasu, kiedy wiersz danych został dodany do Snowflake, reprezentowany przez wartość TIMESTAMP_NTZ. Nie ma związku z logicznym znacznikiem czasu operacji tworzenia lub aktualizacji w HubSpot.
- Ze względu na wewnętrzne przetwarzanie w HubSpot, znacznik czasowy wejścia wiersza może być aktualizowany, nawet jeśli żadne inne kolumny w wierszu nie uległy zmianie.
- Podczas tworzenia procesów ETL, które kopiują ostatnio zmienione dane, zaleca się oparcie zapytań na znaczniku czasowym wejścia. Ponadto, jeśli twój przepływ kopiuje dane codziennie, zaleca się kopiowanie danych z poprzednich dwóch dni, aby uwzględnić opóźnienia.
- CREATEDAT i UPDATEDAT: logiczny znacznik czasu, kiedy dane zostały utworzone lub zaktualizowane w HubSpot, reprezentowany przez wartość TIMESTAMP_NTZ . Te znaczniki czasu będą odpowiadać znacznikom czasu w HubSpot. Na przykład czas wyświetlany w HubSpot dla daty utworzenia rekordu będzie taki sam jak znacznik czasowy w kolumnie CREATEDAT w Snowflake. Nie są one bezpośrednio związane z timestampem ingestionu i nie zaleca się opierania procesów ETL na tych właściwościach.
- COMBINEDASSOCIATIONTYPE: wartość VARCHAR, która jednoznacznie identyfikuje definicję stowarzyszenia.
Przekształcanie typów danych
Czasami dane są zwracane z zapytania z kolumnami VARCHAR, gdy pożądane byłoby, aby były one innego typu. W takich przypadkach zaleca się konwersję typu danych VARCHAR na pożądane typy za pomocą funkcji Snowflake. Na przykład właściwości rekordu obiektu są przechowywane jako typ danych VARCHAR w większości obiektów bazy danych, ale czasami zawierają wartości liczbowe i datetime. Funkcje takie jak:
try_to_number, try_to_timestamp_ntz mogą być użyte do konwersji tych danych VARCHAR na ich typy odpowiednio NUMBER i DATETIME:
SELECT objectid, value AS amount_str, try_to_number(value) AS amountFROM object_properties
WHERE objecttypeid='0-3' AND name='amount'
LIMIT 1
Zapytania do obiektów
Poniżej dowiedz się, jak odpytywać dane z konkretnych obiektów i rekordów HubSpot, wraz z danymi, które zostaną zwrócone.
Dane obiektowe różnych typów są zorganizowane i dostępne na dwa sposoby:
- Indywidualny: Każdy typ obiektu jest przechowywany we własnym widoku i zawiera tylko rekordy tego samego typu obiektu, np. obiekt_kontakty zawiera tylko rekordy kontaktów. Dzięki temu nie ma potrzeby podawania identyfikatora typu obiektu podczas zapytania. Widoki te są łatwiejsze do odpytywania, ponieważ nie trzeba znać ObjectTypeIds. Zwracają one również dane w bardziej użytecznym formacie, gdzie każdy wiersz odpowiada obiektowi i aktualnej wersji jego właściwości. Dopóki nie doświadczysz powolnych zapytań, warto używać tych widoków do pobierania danych o obiektach. Zobacz więcej w widoku Obiekty_X poniżej.
- Połączone: Wszystkie rekordy dla wszystkich typów obiektów są łączone w jeden obiekt bazy danych. W związku z tym podczas wykonywania zapytań należy określić filtr typu "WHERE objectTypeId='0-1'. Na przykład, możesz użyć następujących objecttypeids podczas zapytania:
Nazwa obiektu | ObjectTypeId |
Kontakty | 0-1 |
Firmy | 0-2 |
Pozycje w wierszu | 0-8 |
Obiekty niestandardowe otrzymają identyfikator w momencie tworzenia i będą identyfikowane jako 2-unique_ID. Na przykład 2-12345. Dowiedz się więcej o object_and_event_type_definitions.
Te obiekty bazy danych są generalnie odpowiednie, jeśli chcesz uzyskać lepszą wydajność zapytania niż to, co jest możliwe do uzyskania z obiektów_x widoki. Zobacz więcej szczegółów w object_with_object_properties, object_properties, objects i object_properties_history poniżej.
obiekty_x widoki
W tym obiekcie bazy danych każdy dostępny typ obiektu, w tym obiekty własne, posiada swój specyficzny widok, przy czym każdy widok zawiera tylko rekordy obiektów danego typu obiektu. Nazwy tych widoków mają format OBIEKTY_<nazwa typu obiektu>, gdzie <nazwa typu obiektu> jest oznaczeniem liczby mnogiej typu obiektu.(Uwaga: jeśli typ obiektu nie ma liczby mnogiej, to <nazwa typu obiektu> będzie po prostu oznaczeniem liczby pojedynczej nazwy typu obiektu z dodatkiem "S").
Zapytania do tego widoku zwracają jeden wiersz dla każdego rekordu w obiekcie z każdą właściwością obiektu dostępną jako osobna kolumna.
Zobacz poniżej pełną listę dostępnych typów obiektów HubSpot(czyli nie-custom), krótki opis danych, które reprezentują oraz odpowiadające im widoki:
HubSpot Typ obiektu | ObjectTypeId | Opis |
0-1 | Informacje o osobach wchodzących w interakcje z Twoją firmą | |
0-2 | Informacje o poszczególnych firmach lub organizacjach | |
0-3 | Szczegóły dotyczące możliwości uzyskania przychodu z kontaktu lub firmy. | |
0-4 | Przechowuje dane z działań CRM, w tym notatki, zadania, wiadomości e-mail, spotkania i rozmowy. | |
0-5 | Reprezentuj prośby klientów o pomoc lub wsparcie. | |
0-14 | Używane do dzielenia się informacjami o cenach z potencjalnymi nabywcami. | |
0-15 | Szczegóły dotyczące indywidualnych zgłoszeń do formularza HubSpot. | |
0-8 | Reprezentuje podzbiór produktów sprzedawanych w ramach transakcji. Kiedy produkt jest dołączony do transakcji, staje się pozycją liniową. | |
0-11 | Szczegóły wiadomości przychodzących z wielu kanałów. | |
0-25 | Szczegóły dotyczące Twoich stron docelowych | |
0-27 | Przechowuje informacje o listach rzeczy do zrobienia | |
0-28 | Używane do zbierania informacji o odwiedzających i kontaktach. | |
0-29 | Szczegóły dotyczące e-maili z hubu marketingowego | |
AD_ACCOUNT | 0-30 | Przechowuje informacje o Twoich kontach reklamowych w serwisach Linkedin, Facebook i Google |
0-31 | Szczegóły dotyczące Twoich kampanii reklamowych. Kampania reklamowa może zawierać jedną lub więcej reklam | |
AD_GROUP | 0-32 | Logiczne grupowanie reklam w ramach kampanii reklamowej |
AD | 0-33 | Szczegóły dotyczące poszczególnych ogłoszeń |
0-35 | Informacje o powiązanych aktywach marketingowych i treściach, dzięki czemu można łatwo zmierzyć skuteczność wspólnych działań marketingowych. | |
STRONA | 0-38 | Dane o poszczególnych stronach w Państwa witrynach |
0-39 | Dane o wpisach na blogu | |
LISTA OBIEKTÓW | 0-45 | Informacje o grupach rekordów obiektów na podstawie ich właściwości lub działań |
0-48 | Połączenia wykonane przez inne rekordy CRM np. kontakty | |
FAKTURA | 0-53 | Zarządzanie i synchronizacja faktur z zewnętrznymi systemami księgowymi |
0-57 | Informacje o zasobach medialnych importowanych do Hubspot | |
0-58 | Sekwencja to seria ukierunkowanych, określonych w czasie szablonów wiadomości e-mail, służących do pielęgnowania kontaktów w czasie. | |
0-72 | Podział transakcji służy do dzielenia kredytu transakcyjnego pomiędzy wielu użytkowników. | |
0-83 | Dokumenty sprzedaży budują bibliotekę treści dla całego Twojego zespołu, który może przesyłać i udostępniać dokumenty swoim kontaktom. | |
0-19 | Przechowuje informacje przesłane w ankiecie zwrotnej. | |
0-69 | Subskrypcje zawierają szczegóły dotyczące powtarzających się płatności | |
0-101 | Zawiera dane o środkach pozyskanych od klientów |
Każdy obiekt bazy danych zwróci następujące kolumny:
Nazwa kolumny | Typ | Opis |
OBJECTTYPEID | Varchar | ID typu obiektu (np. kontakty to 0-1). |
OBJECTID | Numer | ID rekordu (np. rekord kontaktu o ID 123752). |
AKTUALIZACJA | Timestamp | Data i godzina ostatniej aktualizacji tego obiektu w HubSpot. |
INGESTEDAT | Timestamp | Data i czas, kiedy dane zostały ostatnio pobrane przez Snowflake. |
WŁASNOŚĆ_* | Varchar | Poszczególne kolumny zawierające najnowsze wersje właściwości obiektu.Dla każdej właściwości obiektu, która ma typ date lub number (określony przez property_definitions), będą dwie kolumny:
|
Przykład 1
Uzyskaj imię, nazwisko i etap cyklu życia dla wszystkich kontaktów.
Zapytanie:
SELECT objectId, property_firstname AS firstname, property_lastname AS lastname,property_lifecyclestage AS lifecyclestageFROM objects_contact
Zwroty:
OBJECTID | NAZWISKO PIERWSZE | LASTNAME | ETAPY CYKLU ŻYCIA |
54325098 | Hobbes | Baron | ołów |
96805401 | Milo | Złoto | ołów |
6922028 | Henry | Riley | ołów |
Przykład 2
Uzyskaj nazwę transakcji i etap maksymalnie trzech transakcji.
Zapytanie:
SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmountFROM objects_deals
LIMIT 3
Zwroty:
OBJECTID | NAZWA_NIERUCHOMOŚCI | NIERUCHOMOŚĆ_DEALSTAGE | NIERUCHOMOŚĆ_DEALAMOUNT |
38960439 | Nazwa transakcji 1 | zamknięta | 34199 |
321740651 | Test Deal 123 | 14845019 | 8383663 |
98392101 | Zadaszenie typu Pop-Up | zamknięta | 9309007 |
Przykład 3
Pobierz nazwę transakcji i etap trzech najlepszych transakcji według kwoty.
Zapytanie:
Ponieważ dane dotyczące ilości transakcji są dostępne jako typ danych liczbowych, mogą być używane do zamawiania bez konieczności wykonywania konwersji lub rzutowania.
SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmountFROM objects_deals
ORDER BY property_amount DESC
LIMIT 3
Zwroty:
OBJECTID | NAZWA_NIERUCHOMOŚCI | NIERUCHOMOŚĆ_DEALSTAGE | NIERUCHOMOŚĆ_DEALAMOUNT |
98392101 | Zadaszenie typu Pop-Up | zamknięta | 9309007 |
321740651 | Test Deal 123 | 14845019 | 8383663 |
38960439 | Nazwa transakcji 1 | zamknięta | 34199 |
obiekt_z_właściwościami_obiektu
Ten obiekt bazy danych zawiera dane z Twoich rekordów HubSpot. Zapytania do tego obiektu bazy danych zwracają jeden wiersz dla każdego rekordu w ramach typu obiektu (np. wszystkie rekordy kontaktów w typie obiektu kontakty). Wszystkie właściwości są przechowywane w kolumnie Properties, która jest kolumną Snowflake Variant / JSON.
Widok ten może zwrócić następujące kolumny:
Nazwa kolumny | Typ | Opis |
OBJECTTYPEID | Varchar | ID typu obiektu (np. kontakty to 0-1 ). |
OBJECTID | Numer | ID rekordu (np. rekord kontaktu o ID 123752 ). |
PROPERTIES | Wariant | Wartości majątkowe płyty. |
UPDATEDAT | Timestamp | Data i godzina ostatniej aktualizacji rekordu w HubSpot. Dowiedz się więcej o typach danych kolumn. |
INGESTEDAT | Timestamp | Data i czas, kiedy dane Kiedy dane zostały ostatnio zaimportowane przez Snowflake. |
Uwaga: 25 stycznia 2022 r. kolumna timestamp w tabeli i widoku object_with_object_properties, która reprezentuje datę i godzinę ostatniej aktualizacji rekordu obiektu w HubSpot, będzie miałapostać updatedat. Ma to na celu dostosowanie do tego, jak dane datetime są reprezentowane w pozostałej części udziału danych.
Ponieważ jest to zmiana przełomowa, nowa kolumna, updatedat została dodana do tabeli i widoku. Przez następne 90 dni te dwie nowe kolumny będą współistnieć z timestamp, kolumnami, które starają się zastąpić. Daje to możliwość przestawienia się na używanie nowych kolumn.
Po 90 dniach, 25 stycznia 2022 roku, kolumna timestamp zostanie usunięta z tabeli i widoku. Po tej dacie wszelkie próby zapytania do tabeli object_with_object_properties lub widoku przy użyciu kolumn timestamp zakończą się niepowodzeniem.
Przykład 1
Odzyskaj wszystkie kontakty i ich właściwości.
Zapytanie:
SELECT objectTypeId, objectId, properties
FROM object_with_object_properties
WHERE objectTypeId = '0-1'
Zwroty:
OBJECTTYPEID | OBJECTID | WŁAŚCIWOŚCI |
0-1 | 38960439 | {"createdate": "1504656970152"...} |
0-1 | 321740651 | { "createdate": "1590183081949"...} |
0-1 | 98392101 | { "createdate": "1533566477279"...} |
... | ... | ... |
Przykład 2
Pobierz nazwę transakcji i etap dla maksymalnie trzech transakcji.
Zapytanie:
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;
Zwroty:
OBJECTID | DEALNAME | DEALSTAGE | DEALAMOUNT |
38960439 | Nazwa transakcji 1 | closedlost | 7488939 |
321740651 | Nazwa transakcji 1 | zamknięta | 9292029 |
98392101 | Nazwa transakcji 1 | closedlost | 62626528 |
obiekty
Ten obiekt bazy danych jest podzbiorem danych obiektu bazy danych object_with_object_properties. Każdy zwrócony wiersz zwraca ID obiektu dla każdego rekordu. Ten obiekt bazy danych zwraca tylko istniejące rekordy. Gdy rekord zostanie usunięty w HubSpot, zostanie usunięty z tego obiektu bazy danych. Ten obiekt bazy danych stanowi podzbiór danych w tabeli object_with_object_properties. Każdy zwrócony wiersz zwraca identyfikator obiektu dla każdego rekordu. Ten widok zwraca tylko istniejące rekordy. Gdy rekord zostanie usunięty w HubSpot, zostanie usunięty z tego widoku.
Ten obiekt bazy danych może być przydatny, jeśli twoje konto ma dużą ilość danych, co prowadzi do tego, że widoki object_with_object_properties i objects_x działają wolno. Użycie tego obiektu bazy danych z obiektem bazy danych object_properties umożliwia replikację danych w object_with_object_properties przy zachowaniu kontroli nad tym, które właściwości są zwracane.
Ten obiekt bazy danych może zwrócić następujące kolumny:
Nazwa kolumny | Typ | Opis |
OBJECTTYPEID | Varchar | ID typu obiektu (np. kontakty to 0-1 ). |
OBJECTID | Numer | ID rekordu (np. rekord kontaktu o ID 123752 ). |
INGESTEDAT | Timestamp | Data i godzina ostatniego pobrania danych przez Snowflake. Dowiedz się więcej o typach danych kolumn. |
Przykład 1
Odzyskaj wszystkie rekordy kontaktów.
Zapytanie:
SELECT objectTypeId, objectId
FROM objects
WHERE objectTypeId = '0-1'
Zwroty:
OBJECTTYPEID | OBJECTID |
0-1 | 36721864 |
0-1 | 103580363 |
0-1 | 56047670 |
... | ... |
właściwości obiektu
Ten obiekt bazy danych jest podzbiorem obiektu bazy danych object_with_object_properties. Każdy wiersz zawiera aktualną wartość właściwości ustawioną w danym rekordzie. Na przykład, kontakt będzie miał jeden wiersz dla właściwości Imię i jeden wiersz dla właściwości Nazwisko. Jeśli rekord nie ma wartości dla właściwości, wiersz pojawi się z pustym ciągiem lub nie pojawi się w ogóle.
Ten obiekt bazy danych może zwrócić następujące kolumny:
Nazwa kolumny | Typ | Opis |
OBJECTTYPEID | Varchar | ID typu obiektu (np. kontakty to 0-1 ). |
OBJECTID | Numer | ID rekordu (np. rekord kontaktu o ID 123752 ). |
NAME | Varchar | Nazwa nieruchomości. |
VALUE | Timestamp | Wartość nieruchomości. |
UPDATEDAT | Timestamp | Data i godzina ostatniej aktualizacji rekordu w HubSpot. Dowiedz się więcej o typach danych kolumn. |
INGESTEDAT | Timestamp | Data i czas, kiedy dane Kiedy dane zostały ostatnio zaimportowane przez Snowflake. |
Przykład 1
Pobierz imię, nazwisko i miasto dla wszystkich kontaktów.
Zapytanie:
SELECT objectTypeId, objectId, name, value
FROM object_properties
WHERE objectTypeId = '0-1'
AND name IN ('firstname', 'lastname', 'city')
ORDER BY objectId;
Zwroty:
OBJECTTYPEID | OBJECTID | NAZWA | WARTOŚĆ |
0-1 | 10401 | firstname | Brian |
0-1 | 10401 | miasto | Dublin |
0-1 | 10401 | nazwisko | Gallagher |
0-1 | 23451 | imię | Fernando |
0-1 | 23451 | nazwisko | Fierro |
0-1 | 25751 | imię | Charles |
... | ... | ... | ... |
Przykład 2
Pobierz imię, nazwisko i etap cyklu życia dla wszystkich kontaktów i połącz je w jeden wiersz dla każdego kontaktu. Przykład wykorzystuje składnię SQL PIVOT.
Zapytanie:
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);
Zwroty:
OBJECTTYPEID | OBJECTID | NAZWISKO PIERWSZE | LASTNAME | ETAPY CYKLU ŻYCIA |
0-1 | 54325098 | Hobbes | Baron | ołów |
0-1 | 96805401 | Milo | Złoto | ołów |
0-1 | 6922028 | Henry | Riley | ołów |
... | ... | ... | ... | ... |
historia_właściwości obiektu
Ten obiekt bazy danych zawiera historyczne wartości właściwości. Dla kontaktów zawiera najbardziej aktualne 45 wartości. Dla wszystkich innych obiektów zawiera ostatnie 20 wartości. Wyświetla wiersz dla każdej wartości historycznej właściwości. Aktualna wartość właściwości jest określona przez ostatni znacznik czasu UPDATEDAT w historii właściwości.
Ten obiekt bazy danych może zwrócić następujące kolumny:
Nazwa kolumny | Typ | Opis |
OBJECTTYPEID | Varchar | ID typu obiektu (np. kontakty to 0-1 ). |
OBJECTID | Numer | ID rekordu (np. rekord kontaktu o ID 123752 ). |
NAME | Varchar | Nazwa nieruchomości. |
VALUE | Timestamp | Wartość nieruchomości. |
UPDATEDAT | Timestamp | Data i godzina ostatniej aktualizacji danych w HubSpot. Dowiedz się więcej o typach danych kolumn. |
INGESTEDAT | Timestamp | Data i czas, kiedy dane zostały ostatnio pobrane przez Snowflake. |
Przykład 1
Pobierz historię pojedynczej właściwości dla pojedynczego kontaktu.
Zapytanie:
SELECT objectId, name, value, updatedAt
FROM object_properties_history
WHERE objectTypeId = '0-1'
AND objectId = 136493192
AND name = 'hs_predictivescoringtier'
ORDER BY UPDATEDAT DESC;
Zwroty:
OBJECTID | NAZWA | WARTOŚĆ | AKTUALIZACJA |
136493192 | hs_predictivescoringtier | poziom_1 | 2022-06-22 22:45:05.931 |
136493192 | hs_predictivescoringtier | szczebel_2 | 2021-09-18 08:20:56.622 |
136493192 | hs_predictivescoringtier | szczebel_3 | 2019-11-31 18:20:22.851 |
... | ... | ... | ... |
Przykład 2
Pobierz aktualną nazwę wszystkich kontaktów, które kiedykolwiek miały fazę cyklu życia Subskrybent.
Zapytanie:
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'
);
Zwroty:
OBJECTID | NAZWISKO PIERWSZE | LASTNAME |
54325098 | Hobbes | Baron |
96805401 | Milo | Złoto |
6922028 | Henry | Riley |
... | ... | ... |
Zapytania do stowarzyszenia
Podobnie jak dane o obiektach, dane o skojarzeniach są zorganizowane na dwa sposoby:
- Indywidualne: Każdy typ asocjacji jest przechowywany w swoim własnym widoku i zawiera tylko rekordy tego typu. Na przykład, associations_contacts_to_deals zawierają tylko rekordy asocjacji pomiędzy obiektami contact i deal. Eliminuje to potrzebę określania identyfikatora typu asocjacji podczas zapytań. Widoki te są dość łatwe do wykonania, ponieważ nie wymagają znajomości modelu danych CRM, aby z nich korzystać. Zwracają również wzbogacony opis asocjacji pomiędzy dwoma obiektami, który może być łatwo wykorzystany w połączeniach z widokami objects_x. Tak długo jak nie doświadczysz powolnych zapytań, warto używać tych widoków do pobierania danych asocjacyjnych. Zobacz więcej o widokach associations_x_to_y poniżej.
- Połączone: Wszystkie rekordy dla wszystkich typów asocjacji są łączone w jeden obiekt bazy danych. W związku z tym, podczas wykonywania zapytań, należy określić filtr typu "WHERE combinedassociationtypeid='0-32' ". Zobacz więcej w asocjacjach i association_definitions poniżej.
skojarzenia_x_do_y widoki
Każdy typ asocjacji posiada swój widok oznaczony jako asocjacje_<nazwa typu asocjacji> np. asocjacje_contacts_to_deals. Każdy widok jest podzbiorem danych w obiekcie bazy stowarzyszeń i zawiera tylko rekordy o określonym combinedassociationtypeid.
Każdy obiekt bazy danych zwróci następujące kolumny:
Nazwa kolumny | Typ | Opis |
COMBINEDASSOCIATIONTYPEID | Varchar | Unikalny identyfikator definicji stowarzyszenia. |
KATEGORIA STOWARZYSZENIA | Varchar | Źródło typu stowarzyszenia. Jedno z: HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED |
ASSOCIATIONTYPEID | Varchar | Unikalny identyfikator definicji asocjacji w ramach określonej kategorii asocjacji, tzn. żadne dwie definicje w kategorii asocjacji nie będą miały tego samego associationtypeid. |
FROMOBJECTTYPEID | Varchar | Typ obiektu, który jest źródłem definicji asocjacji. |
FROMOBJECTTYPE | Varchar | Nazwa typu obiektu, który jest źródłem definicji asocjacji. |
TOOBJECTTYPEID | Varchar | Typ obiektu, który jest miejscem docelowym definicji asocjacji. |
TOOBJECTTYPE | Varchar | Nazwa typu obiektu, który jest miejscem docelowym definicji asocjacji. |
NAZWA | Varchar | Nazwa definicji stowarzyszenia. |
LABEL | Varchar | Opis definicji stowarzyszenia. |
ISMAINASSOCIATION DEFINITION | Boolean | Czy definicja asocjacji jest typem głównym. Gdy prawda, definicja jest tą, którą HubSpot wyświetla na powiązanych rekordach |
[FROMOBJECTTYPE_OBJECTID] np. dla widoku STOWARZYSZENIA_KONTAKTY_TO_DEALS będzie to CONTACT_OBJECTID | Numer | Identyfikator obiektu źródłowego. |
[TOOBJECTTYPE_OBJECTID] np. dla widoku ASSOCIATIONS_CONTACTS_TO_DEALS będzie to DEAL_OBJECTID | Numer | ID obiektu docelowego. |
INGESTEDAT | Timestamp | Data i czas, kiedy dane zostały ostatnio pobrane przez Snowflake. |
Przykład 1
Pobierz wszystkie transakcje związane z określonym kontaktem.
Zapytanie:
SELECT
contact_objectId, deal_objectId
FROM stowarzyszenia_kontakty_do_deali
WHERE contactId = 6626541373
Zwroty:
CONTACT_OBJECTID | DEAL_OBJECTID |
6626541373 | 233620335 |
6626541373 | 90253678 |
Przykład 2
Pobierz wszystkie kontakty w strefie czasowej Bogoty i ich oferty.
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'
KONTAKT_IMIĘ | KONTAKT_NAZWA_LASKI | CONTACT_EMAIL | DEAL_TYPE | DEAL_AMOUNT |
David | Magalhães | dmagalhaes@example.com | nowybiznes | 74848 |
Fernanda | Rodrigues | fmoreira@example.com | nowybiznes | 253530 |
Przykład 3
Pobierz wszystkie kontakty i łączną sumę zamkniętych transakcji dla każdego kontaktu.
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
Zwroty:
CAŁKOWITA_ZAMKNIĘTA_KWOTA | CONTACT_EMAIL |
98474793 | johndoe@riverview.com |
849488 | sallymae@longford.com |
definicje_stowarzyszenia
Ten obiekt bazy danych zawiera informacje o wszystkich dostępnych typach asocjacji między obiektami HubSpot, z jednym wierszem na typ asocjacji. Można połączyć ten obiekt bazy danych z obiektem bazy danych asocjacji, aby uzyskać informacje o asocjacjach specyficznych dla danego rekordu.
Może istnieć wiele typów skojarzeń między tymi samymi obiektami. Główny typ asocjacji, który jest typem wyświetlanym w HubSpot, gdy rekordy są skojarzone, używa asocjacji, gdzie ISMAINASSOCIATIONDEFINITION
jest true
.
Ten obiekt bazy danych może zwrócić następujące kolumny:
Nazwa kolumny | Typ | Opis |
COMBINEDASSOCIATIONTYPEID | Varchar | Unikalny identyfikator definicji stowarzyszenia. |
CATEGORY | Varchar | Źródło typu stowarzyszenia. Jedno z: HUBSPOT_DEFINED , USER_DEFINED , INTEGRATOR_DEFINED |
ID | Numer | Identyfikator definicji stowarzyszenia w ramach jego kategorii. |
FROMOBJECTTYPEID | Varchar | ID obiektu, który jest źródłem definicji asocjacji. |
TOOBJECTTYPEID | Varchar | ID obiektu, który jest miejscem docelowym definicji asocjacji. |
NAME | Varchar | Nazwa definicji stowarzyszenia. |
LABEL | Varchar | Etykieta definicji stowarzyszenia. |
ISMAINASSOCIATIONDEFINITION | Boolean | Czy definicja asocjacji jest typem głównym. Gdy true, definicja jest tą, którą HubSpot wyświetla na powiązanych rekordach. |
INGESTEDAT | Timestamp | Data i godzina ostatniego pobrania danych przez Snowflake. Dowiedz się więcej o typach danych kolumn. |
Przykład 1
Pobierz rodzaje stowarzyszeń dostępnych na Twoim koncie.
Zapytanie:
SELECT combinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
ORDER BY category, id
Zwroty:
POŁĄCZONY TYP STOWARZYSZENIA | FROMOBJECTTYPEID | TOOBJECTTYPEID | NAZWA |
0-1 | 0-1 | 0-2 | KONTAKT_DO_FIRMY |
0-2 | 0-2 | 0-1 | FIRMA_DO_KONTAKTU |
0-3 | 0-3 | 0-1 | DEAL_DO_KONTAKTU |
0-4 | 0-1 | 0-3 | KONTAKT_DO_DEALU |
0-5 | 0-3 | 0-2 | UMOWA Z FIRMĄ |
... | ... | ... | ... |
Przykład 2
Pobierz dostępne typy asocjacji pomiędzy transakcjami a firmami.
Zapytanie:
SELECT
combinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
WHERE fromObjectTypeId = '0-3' AND toObjectTypeId = '0-2'
AND isMainAssociationDefinition = trueORDER BY category, id
Zwroty:
POŁĄCZONY TYP STOWARZYSZENIA | FROMOBJECTTYPEID | TOOBJECTTYPEID | NAZWA |
0-5 | 0-3 | 0-2 | UMOWA Z FIRMĄ |
0-271 | 0-3 | 0-2 | DEAL_TO_PRIMARY_COMPANY |
0-341 | 0-3 | 0-2 | DEAL_TO_COMAPNY_UNLABELED |
stowarzyszenia
Ten obiekt bazy danych zawiera informacje o skojarzeniach między określonymi rekordami. Każdy wiersz reprezentuje asocjację z jednego obiektu do innego obiektu. Wiersze mogą być obecne w tym obiekcie bazy danych, nawet jeśli rekordy, do których się odnoszą, zostały usunięte. Możesz sprawdzić czy rekordy istnieją poprzez połączenie z tabelą obiektów.
Ten obiekt bazy danych może być przydatny, jeśli twoje konto ma dużą ilość danych, co prowadzi do tego, że widoki associations_x_to_y działają powoli.
Ten obiekt bazy danych może zwrócić następujące kolumny:
Nazwa kolumny | Typ | Opis |
COMBINEDASSOCIATIONTYPEID | Varchar | Unikalny identyfikator definicji stowarzyszenia. |
FROMOBJECTID | Numer | ID obiektu źródłowego. |
TOOBJECTID | Numer | ID obiektu docelowego. |
INGESTEDAT | Timestamp | Data i godzina ostatniego pobrania danych przez Snowflake. Dowiedz się więcej o typach danych kolumn. |
Przykład 1
Odzyskaj wszystkie powiązane transakcje i kontakty.
Zapytanie:
SELECT combinedAssociationTypeId, fromObjectId, toObjectId
FROM associations
WHERE combinedAssociationTypeId = '0-5'
Zwroty:
COMBINEDASSOCIATIONTYPEID | FROMOBJECTID | TOOBJECTID |
0-5 | 6626541373 | 233620335 |
0-5 | 6616436082 | 3866015468 |
0-5 | 6690805943 | 7132752747 |
... | ... | ... |
Przykład 2
Pobierz wszystkie bilety związane z określonym kontaktem (ID kontaktu: 3005).
Zapytanie:
SELECT combinedAssociationTypeId, fromObjectId, toObjectId
FROM associations
WHERE associationCategory = 'HUBSPOT_DEFINED'
AND combinedAssociationTypeId = '0-15'
AND fromObjectId = 3005;
Zwroty:
POŁĄCZONY TYP STOWARZYSZENIA | FROMOBJECTID | TOOBJECTID |
0-5 | 6626541373 | 233620335 |
Przykład 3
Pobierz wszystkie transakcje powiązane z określonym kontaktem (ID kontaktu: 4464). Zamiast twardego kodowania combinedAssociationTypeId, ten przykład łączy się z association_definitions.
Zapytanie:
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;
Zwroty:
COMBINEDASSOCIATIONTYPEID | FROMOBJECTID | TOOBJECTID |
0-5 | 6626541373 | 233620335 |
Pytania do właściciela
właściciele
Ten obiekt bazy danych zawiera informacje o użytkownikach na koncie HubSpot. Użytkownicy mogą być ustawieni jako właściciele rekordów i będą zawierać zarówno identyfikator użytkownika, jak i identyfikator właściciela, w zależności od ich kontekstu. Oba identyfikatory mogą być używane do identyfikacji tego samego użytkownika.
Ten obiekt bazy danych może zwrócić następujące kolumny:
Nazwa kolumny | Typ | Opis |
OWNERID | Numer | Identyfikator właściciela użytkownika. |
USERID | Numer | Identyfikator użytkownika. Użytkownicy z NULL w tej kolumnie zostali usunięci. |
EMAIL | Varchar | Adres e-mail użytkownika. |
FIRSTNAME | Varchar | Imię użytkownika. |
LASTNAME | Varchar | Nazwisko użytkownika. |
ARCHIVED | Boolean | Czy użytkownik został usunięty. |
CREATEDAT | Timestamp | Data i godzina utworzenia użytkownika w HubSpot. Aby uzyskać więcej informacji, zobacz typy danych kolumn. |
UPDATEDAT | Timestamp | Data i godzina ostatniej aktualizacji użytkownika w HubSpot. Aby uzyskać więcej informacji, zobacz typy danych kolumn. |
INGESTEDAT | Timestamp | Data i czas, kiedy dane zostały ostatnio pobrane przez Snowflake. |
Przykład 1
Odzyskaj wszystkich użytkowników. Filtr WHERE archived = false
usuwa usuniętych użytkowników ze zwróconych danych.
Zapytanie:
SELECT ownerId, userId, email, firstname, lastname
FROM owners
WHERE archived = false
Zwroty:
OWNERID | USERID | NAZWISKO PIERWSZE | LASTNAME | |
29584574 | 4621126 | 233620335 | Hobbes | Baron |
30532717 | 4874784 | 3866015468 | Pablo | Walters |
30580321 | 925511 | 7132752747 | Milo | Złoto |
... | ... | ... | ... | ... |
Przykład 2
Wyszukaj konkretnego właściciela według jego ID.
Zapytanie:
SELECT ownerId, userId, email, firstname, lastname
FROM owners
WHERE ownerId = 29584574;
Zwroty:
OWNERID | USERID | NAZWISKO PIERWSZE | LASTNAME | |
29584574 | 4621126 | 233620335 | Hobbes | Baron |
Przykład 3
Odzyskaj wszystkie kontakty i ich właścicieli. To zapytanie łączy rekordy z właścicielami za pomocą object_with_object_properties i właściwości kontaktu 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
Zwroty:
CONTACTID | KONTAKT_IMIĘ | KONTAKT_NAZWA_LASKI | CONTACT_HUBSPOT_OWNER_ID | IMIĘ_WŁAŚCICIELA | OWNER_LASTNAME | E-MAIL WŁAŚCICIELA |
113834202 | Richard | Greenfield | 29584574 | Hobbes | Baron | hobbes.b@business.com |
53540801 | Ford | Karl | 30241125 | Milo | Złoto | milo.g@business.com |
... | ... | ... | ... | ... | ... | ... |
Zapytania dotyczące rurociągów
Poniżej dowiesz się, jak zapytać o dane dotyczące rurociągu transakcji i biletów, takie jak dostępne rurociągi na Twoim koncie i ich etapy.
Możesz połączyć te dane z danymi obiektowymi, aby uzyskać pełny obraz Twoich rurociągów. Na przykład, możesz zapytać o transakcje i ich rurociągi łącząc dane objects_deals_view lub object_with_object_properties z danymi pipelines.
rurociągi
Ten obiekt bazy danych zawiera informacje o rurociągach transakcji i biletów na Twoim koncie. Każdy zwrócony wiersz reprezentuje pojedynczy potok.
Tabela ta może zwrócić następujące kolumny:
Nazwa kolumny | Typ | Opis |
PIPELINEID | Varchar | Identyfikator rurociągu. |
OBJECTTYPEID | Varchar | ID obiektu, który może zawierać rurociąg (np. oferty lub bilety). |
LABEL | Varchar | Nazwa rurociągu w HubSpot. |
DISPLAYORDER | Numer | Kolejność, w jakiej rurociąg jest wyświetlany w HubSpot. |
ARCHIVED | Boolean | Czy rurociąg został usunięty. |
CREATEDAT | Timestamp | Kiedy rurociąg został utworzony. |
UPDATEDAT | Timestamp | Data i godzina ostatniej aktualizacji danych w HubSpot. Dowiedz się więcej o typach danych kolumn. |
INGESTEDAT | Timestamp | Data i czas, kiedy dane zostały ostatnio pobrane przez Snowflake. |
Przykład 1
Pobierz wszystkie dostępne rurociągi transakcji, uporządkowane według ich kolejności w HubSpot.
Zapytanie:
SELECT objectTypeId, pipelineId, label
FROM pipelines
WHERE objectTypeId = '0-3'
AND not archived
ORDER BY displayorder;
Zwroty:
OBJECTTYPEID | PIPELINEID | LABEL |
0-3 | 1bed503c-37f7-4f51-9d40-7598902673f4 | Sales Pipeline |
0-3 | 12659678 | Licencje Rurociąg |
0-3 | 75e28846-ad0d-4be2-a027-5e1da6590b98 | Nowa działalność |
... | ... | ... |
Przykład 2
Pobierz transakcje w ramach określonego rurociągu. Łączy obiekt_z_właściwościami_obiektu i rurociągi.
Zapytanie:
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';
Zwroty:
DEAL_ID | DEAL_NAME | PIPELINE_NAME |
605140072 | Globalna rejestracja Meowmix | Sales Pipeline |
605457408 | Friskies Rebrand | Sales Pipeline |
604362473 | Fresh Step App Build | Sales Pipeline |
Przykład 3
Tak samo jak w przykładzie 2 powyżej, pobierz transakcje w ramach określonego rurociągu. Ale zamiast używać objects_deals w złączeniach, użyj 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';
Zwroty:
DEAL_ID | DEAL_NAME | PIPELINE_NAME |
605140072 | Globalna rejestracja Meowmix | Sales Pipeline |
605457408 | Friskies Rebrand | Sales Pipeline |
604362473 | Fresh Step App Build | Sales Pipeline |
etapy rurociągu
Widok ten zawiera informacje o poszczególnych etapach w obrębie rurociągu. Etapy identyfikuje się poprzez połączenie ID typu obiektu, ID rurociągu oraz ID etapu. Podczas łączenia z rurociągami należy użyć identyfikatora typu obiektu i identyfikatora rurociągu.
Ten obiekt bazy danych może zwrócić następujące kolumny:
Nazwa kolumny | Typ | Opis |
PIPELINEID | Varchar | Identyfikator rurociągu. |
STAGEID | Varchar | Identyfikator sceny. |
LABEL | Varchar | Nazwa etapu w HubSpot. |
DISPLAYORDER | Numer | Kolejność, w jakiej rurociąg jest wyświetlany w HubSpot. |
METADATA | Wariant | Opis etapu w formacie JSON zawierający informację czy jest on otwarty czy zamknięty |
ARCHIVED | Boolean | Czy etap rurociągu został usunięty. |
CREATEDAT | Timestamp | Kiedy etap rurociągu został utworzony. |
Przykład 1
Pobieranie etapów rurociągu dla rurociągu transakcji o nazwie Sales pipeline.
Zapytanie:
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;
Zwroty:
PIPELINEID | STAGEID | LABEL |
941650 | 941651 | Kontaktował się z |
941650 | 941652 | Planowane spotkanie |
941650 | 941653 | Faktura wysłana |
... | ... | ... |
Przykład 2
Pobierz wszystkie transakcje i ich odpowiednie etapy.
Zapytanie:
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';
Zwroty:
DEAL_ID | DEAL_NAME | PIPELINE_NAME | NAZWA_STACJI RUROCIĄGU |
605140072 | Globalna rejestracja Meowmix | Sales Pipeline | Umowa wysłana |
605457408 | Friskies Rebrand | Sales Pipeline | Planowane spotkanie |
604362473 | Fresh Step App Build | Sales Pipeline | Umowa podpisana |
... | ... | ... | ... |
Zapytania dotyczące nieruchomości
własności_definicje
Ten obiekt bazy danych zawiera informacje o właściwościach obiektów i właściwościach zdarzeń na koncie HubSpot. Właściwości zdarzeń obejmują standardowe zdarzenia, takie jak otwarcia i kliknięcia wiadomości e-mail, oraz niestandardowe właściwości zdarzeń behawioralnych. Informacje te mogą być pomocne przy definiowaniu wartości znajdujących się w danych object_properties i events.
Możesz zidentyfikować konkretne właściwości poprzez połączenie ich identyfikatora typu obiektu i nazwy. Możesz pobrać podobne informacje za pomocą API właściwości.
Ten obiekt bazy danych może zwrócić następujące kolumny:
Nazwa kolumny | Typ | Opis |
OBJECTYPEID | Varchar | ID obiektu, którego dotyczy zdarzenie. |
NAME | Varchar | Wewnętrzna nazwa nieruchomości. |
LABEL | Varchar | Etykieta nieruchomości. |
DESCRIPTION | Varchar | Opis nieruchomości. |
TYPE | Varchar | Typ właściwości (np. string, number, datetime). |
FIELDTYPE | Varchar | Typ pola właściwości. Określa sposób wyświetlania właściwości w HubSpot i na formularzach (np. checkbox, select). |
DISPLAYORDER | Numer | Kolejność wyświetlania nieruchomości. |
GROUPNAME | Varchar | Nazwa grupy nieruchomości. |
OPTIONS | Wariant | Dla właściwości wyliczeniowych, tablica opcji właściwości, w tym atrybuty każdej opcji (np. kolejność wyświetlania, etykieta). |
CREATEDUSERID | Numer | ID użytkownika, który utworzył nieruchomość. |
REFERENCEDOBJECTTYPE | Varchar | Typ obiektu, do którego odnosi się właściwość. Właściwości typu Owner zwrócą wartość OWNER. |
CALCULATED | Boolean | Czy właściwość jest właściwością obliczaną. |
EXTERNALOPTIONS | Boolean | Czy opcje nieruchomości są zdefiniowane w systemie zewnętrznym. |
HASUNIQUEVALUE | Boolean | Czy wartości właściwości są unikalne. Może być ustawione tylko podczas tworzenia właściwości poprzez API. |
HIDDEN | Boolean | Czy właściwość jest ukryta w HubSpot. |
SHOWCURRENCYSYMBOL | Boolean | Czy wartość właściwości number jest formatowana jako waluta. |
FORMFIELD | Boolean | Czy ta właściwość może być używana w formularzach. |
READONLYDEFINITION | Boolean | Czy właściwość może być edytowana w HubSpot. |
READONLYVALUE | Boolean | Czy wartość właściwości może być edytowana w HubSpot. |
HUBSPOTDEFINED | Boolean | Czy właściwość została utworzona przez HubSpot, czy też przez użytkownika. |
ARCHIVED | Boolean | Czy właściwość została usunięta. |
CREATEDAT | Timestamp | Data i godzina utworzenia nieruchomości w HubSpot. |
UPDATEDAT | Timestamp | Data i godzina ostatniej aktualizacji danych w HubSpot. Dowiedz się więcej o typach danych kolumn. |
INGESTEDAT | Timestamp | Data i czas, kiedy dane zostały ostatnio pobrane przez Snowflake. |
Przykład 1
Pobierz nazwy i opisy dla wszystkich właściwości kontaktu.
Zapytanie:
SELECT name, label, description
FROM property_definitions
WHERE objectTypeId = '0-1'
Zwroty:
NAZWA | LABEL | OPIS |
entered_sql_stage | Wszedł do etapu SQL | Start count SQL stage days. |
first_conversion_event_name | Pierwsza konwersja | Pierwszy formularz złożony przez ten kontakt. |
adres | Adres ulicy | Adres osoby kontaktowej. |
Zapytania dotyczące zdarzeń
Zdarzenia obejmują standardowe zdarzenia HubSpot i niestandardowe zdarzenia behawioralne. Każde zdarzenie ma swój własny obiekt w bazie danych, oznaczony jako events_eventname
.
Nazwa | |
ZDARZENIA_AD_INTERAKCJA | Szczegóły reklamy i kontaktów, które weszły w interakcję z nią poprzez kliknięcie na reklamę lub przesłanie formularza po zaangażowaniu się w nią. |
EVENTS_AD_METRICS_IMPORTED_V0 | Szczegóły reklamy i jej metryki wydajności. |
ZDARZENIA_WEZWANIA_WYMIENIONE_SŁOWO_KLUCZOWE | Szczegóły dotyczące słów kluczowych wymienionych przez dowolnych uczestników rozmów. |
EVENTS_CLICKED_LINK_IN_EMAIL_V2 | Linki klikane w e-mailach marketingowych przez kontakty. |
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8 | Linki kliknięte w mailach Conversations Inbox przez kontakty. |
EVENTS_COOKIE_BANNER_CLICKED | Kontakty, które kliknęły na ciasteczka. |
EVENTS_COOKIE_BANNER_VIEWED | Kontakty, które przeglądały pliki cookie. |
ZDARZENIA_DOKUMENTU_WSPÓLNEGO_V2 | Dokumenty sprzedażowe udostępniane kontaktom za pomocą linku zewnętrznego. |
ZDARZENIA_DOKUMENTU_PRZEGLĄDANEGO_V2 | Dokumenty sprzedaży i kontakty, które przeglądali otwierając link zewnętrzny. |
ZDARZENIA_DOKUMENTU_ZAKOŃCZONEGO_V2 | Dokumenty sprzedaży i kontakty, które je zamknęły. |
EVENTS_HS_SCHEDULED_EMAIL_V2 | E-maile przekazane na serwery pocztowe HubSpot do wysłania. |
EVENTS_MTA_DELIVERED_EMAIL_V2 | Wiadomości e-mail pomyślnie dostarczone do odbiorców przez serwery pocztowe HubSpot. |
EVENTS_MTA_BOUNCED_EMAIL_V2 | Próby dostarczenia wiadomości e-mail, które zostały odrzucone przez serwer poczty elektronicznej odbiorcy. |
ZDARZENIA_OTWARTE_EMAIL_V2 | Otwarcia wiadomości e-mail według kontaktów. |
EVENTS_REPORTED_SPAM_EMAIL_V2 | Wiadomości e-mail oznaczone przez odbiorców jako spam. |
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2 | Zmiany w subskrypcji poczty elektronicznej przez odbiorców. |
EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8 | Conservations Inbox email opens by contacts. |
ZDARZENIA_MB_MEDIALNE_ODTWARZANE | Aktywność odtwarzania wideo według kontaktów. |
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE | Kontakt zarezerwował spotkanie poprzez sekwencję. |
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE | Kontakt zapisany z sekwencji. |
EVENTS_V2_CONTACT_FINISHED_SEQUENCE | Sekwencja zakończona. |
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL | Kontakt odpowiedział na email (lub email przychodzący, który odblokował sekwencję) wysłany przez sekwencję. |
EVENTS_V2_CONTACT_UNENROLLED_FROM_SEQUENCE | Kontakt nie zapisany z sekwencji. |
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE | Użytkownik ręcznie wyrejestrował kontakt. |
EVENTS_V2_CONTACT_UNSUBSUBSCRIBED_SEQUENCE_EMAIL | Kontakt wypisał się, odblokowując sekwencję. |
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED | E-mail z sekwencji został odrzucony. |
ZDARZENIA_V2_KONSEKWENCJA_ZAROBKOWA | Błąd sekwencji, który spowodował wypisanie z listy. |
EVENTS_V2_SEQUENCE_STEP_EXECUTED | Krok sekwencyjny wykonany. |
ZDARZENIA_ODWIEDZANE_STRONA | Odwiedziny stron internetowych według kontaktów. |
Możesz zidentyfikować zdarzenia poprzez połączenie ich identyfikatora typu zdarzenia i identyfikatora. Kolumny, które są zwracane, zależą od zdarzenia, z jedną kolumną dla każdej właściwości zdarzenia. Wszystkie zdarzenia zwracają następujące kolumny:
Uwaga: HubSpot dodał dwie nowe kolumny do wszystkich tabel i widoków zdarzeń:
occurredat
occurredatdateint
Kolumny te zastąpią kolumny occuredat
oraz occuredatdateint
24 listopada 2022 roku. W tym dniu stare kolumny nie będą już dostępne, a próby zapytania do obiektu bazy danych lub widoku zawierającego zdarzenia wykorzystujące te kolumny zakończą się niepowodzeniem. Dowiedz się więcej o zmianach w udziałach danych Snowflake.
Nazwa kolumny | Typ | Opis |
EVENTTYPEID | Varchar | ID typu zdarzenia, podobnie jak OBJECTTYPEID Możesz zapytać o wszystkie identyfikatory eventype na swoim koncie za pomocą widoku object_and_event_type_definitions. |
ID | Varchar | Jest to unikalne dla danego typu wydarzenia. Żadne dwa rekordy nie będą miały tego samego ID w ramach danego typu wydarzenia. |
OBJECTTYPEID | Varchar | Typ obiektu, który wykonał zdarzenie. Na przykład, kliknięcie linku do wiadomości e-mail spowoduje wyświetlenie w tej kolumnie adresu 0-1 , reprezentującego obiekt kontaktów. |
OBJECTID | Numer | Identyfikator rekordu, który zakończył zdarzenie. |
OCCURREDAT | Timestamp | Kiedy nastąpiło zdarzenie. |
| Numer | Liczba reprezentująca czas wystąpienia zdarzenia. Zawiera te same dane co kolumna OCCURREDAT , ale sformatowane jako liczba i używane jako część klucza klastrowego tabeli. W większości przypadków możesz użyć OCCURREDAT timestamp zamiast tej liczby. |
| Numer | Liczba reprezentująca czas wystąpienia zdarzenia. Zawiera te same dane co kolumna Uwaga: ta kolumna zostanie zdeprecjonowana 24 listopada 2022 roku i zastąpiona przez |
OCCUREDAT | Timestamp | Kiedy nastąpiło zdarzenie. Uwaga: ta kolumna zostanie zdeprecjonowana 24 listopada 2022 roku i zastąpiona przez |
INGESTEDAT | Timestamp | Data i godzina ostatniego pobrania danych przez Snowflake. Dowiedz się więcej o typach danych kolumn. |
PROPERTY_* | Varchar | Poszczególne kolumny zawierające właściwości zdarzenia. |
Przykład 1
Pobierz 50 ostatnich zdarzeń kliknięcia wiadomości e-mail.
Zapytanie:
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;
Zwroty:
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 |
... | ... | ... | ... | ... |
Przykład 2
Odzyskaj wszystkie zdarzenia kliknięcia wiadomości e-mail według kontaktów, które kliknęły. Zapytanie to pobiera dane kontaktowe poprzez połączenie z object_with_object_properties.
Zapytanie:
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;
Zwroty:
CLICK_TIMESTAMP | CLICK_URL | KONTAKT_IMIĘ | KONTAKT_NAZWA_LASKI |
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 | Milo | Złoto |
2018-11-08 09:37:41.426 | https://www.website.net/contact?utm_source=hs_automation&utm_medium=email&utm_content=55200164 | Harlow | Villari |
... | ... | ... | ... |
Zapytania typu obiekt_i_zdarzenie
object_and_event_type_definitions
Ten obiekt bazy danych zawiera definicje wszystkich obiektów i zdarzeń dostępnych na koncie HubSpot.
Ten obiekt bazy danych może zwrócić następujące kolumny:
Nazwa kolumny | Typ | Opis |
OBJECTTYPEID | Varchar | ID obiektu, który może zawierać rurociąg (np. oferty lub bilety). |
FULLYQUALIFIEDNAME | Varchar | Nazwa obiektu lub zdarzenia. |
INGESTEDAT | Timestamp | Data i godzina ostatniego pobrania danych przez Snowflake. Dowiedz się więcej o typach danych kolumn. |
Przykład 1
Pobierz wszystkie obiekty i zdarzenia dostępne na koncie HubSpot.
Zapytanie:
SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;
Zwroty:
OBJECTTYPEID | FULLYQUALIFIEDNAME |
0-1 | KONTAKT |
0-8 | LINIA_ITEM |
0-11 | KONWERSACJA |
... | ... |
Wykazy zapytań
Poniżej dowiesz się, jak wykonać kwerendę swoich list, m.in. dostępnych list kontaktów i firm oraz rekordów zawartych w tych listach.
wymienia
Ten obiekt bazy danych zawiera informacje o listach kontaktów i firm HubSpot. Zwraca jeden wiersz na listę, a kolumny zawierają szczegóły listy, takie jak nazwa listy, rozmiar i typ obiektu rekordów, które zawiera. Nie zawiera informacji o poszczególnych rekordach w ramach każdej listy (patrz list_membership).
Ten obiekt bazy danych może zwrócić następujące kolumny:
Nazwa kolumny | Typ | Opis |
OBJECTTYPEID | Varchar | Typ rekordów na liście (np. kontakt lub firma). |
LISTID | Numer | Identyfikator listy. Łączy się z kolumną LISTID w tabeli list-memberships. |
CLASSICLISTID | Numer | Identyfikator specyficzny dla list kontaktów, który pasuje do identyfikatora w adresie URL listy w HubSpot. |
NAME | Varchar | Nazwa listy. |
SIZE | Numer | Liczba rekordów na liście. |
CREATEDBYUSERID | Numer | ID użytkownika, który stworzył listę. |
CREATEDAT | Timestamp | Kiedy lista została utworzona w HubSpot. |
UPDATEDBYUSERID | Numer | ID użytkownika, który ostatnio aktualizował listę. |
UPDATEDAT | Timestamp | Data i godzina, w której data została ostatnio zaktualizowana w HubSpot. Dowiedz się więcej o typach danych kolumn. |
INGESTEDAT | Timestamp | Data i czas, kiedy dane zostały ostatnio pobrane przez Snowflake. |
Przykład 1
Odzyskaj wszystkie listy kontaktów.
Zapytanie:
SELECT listId, name, size
FROM lists
WHERE objectTypeId = '0-1';
Zwroty:
LISTID | NAZWA | SIZE |
118131 | Cotygodniowy zasięg | 103 |
66156 | Subskrybenci bloga | 455 |
771852 | Najlepsi abonenci 2021 | 37 |
... | ... | ... |
Przykład 2
Pobierz określoną listę kontaktów o nazwie Top subscribers 2021.
Zapytanie:
SELECT listId, name, size
FROM lists
WHERE objectTypeId = '0-1'
ANDlistName = 'Top subscribers 2021';
Zwroty:
LISTID | NAZWA | SIZE |
771852 | Najlepsi abonenci 2021 | 37 |
lista_członków
Ten obiekt bazy danych zawiera informacje o tym, które rekordy są członkami poszczególnych list, z jednym wierszem na rekord w liście. Na przykład, jeśli masz listę subskrybentów bloga z 500 kontaktami, obiekt bazy danych zwróci 500 wierszy.
Zawiera tylko identyfikatory list i identyfikatory obiektów. Aby uzyskać więcej informacji, dołącz obiekt bazy danych Listy.
Ten obiekt bazy danych może zwrócić następujące kolumny:
Nazwa kolumny | Typ | Opis |
LISTID | Varchar | ID listy. Łączy się z kolumną HS_LIST_ID w tabeli lists. |
OBJECTID | Varchar | Identyfikator rekordu na liście. |
UPDATEDAT | Timestamp | Data i godzina ostatniej aktualizacji danych w HubSpot. Dowiedz się więcej o typach danych kolumn. |
INGESTEDAT | Timestamp | Data i czas, kiedy dane zostały ostatnio pobrane przez Snowflake. |
Przykład 1
Pobierz identyfikatory wszystkich kontaktów z listy Top subscribers 2021.
Zapytanie:
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';
Zwroty:
OBJECTID |
54325098 |
96805401 |
6922028 |
... |
Przykład 2
Pobieranie imion i nazwisk szczegółów kontaktów z listy Top subscribers 2021.
Zapytanie:
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'
Zwroty:
OBJECTID | IMIĘ I NAZWISKO | OSTATNIE IMIĘ |
54325098 | Hobbes | Baron |
96805401 | Milo | Złoto |
6922028 | Henry | Riley |
... | ... | ... |
FAQs
Chcę wygenerować dane podobne do raportu z aplikacji Hubspot, jak to zrobić?
Ogólnie rzecz biorąc, chciałbyś spojrzeć na kolumny obecne w raporcie, z którym porównujesz. Jeśli wizualizacja raportu nie jest tabelaryczna, konwersja na tabelę pokaże kolumny, które zawiera raport. Kolumny te są zazwyczaj właściwościami typu obiektu lub typu zdarzenia. Następnym krokiem jest określenie właściwości typu obiektu, której odpowiada dana kolumna. Możesz to zrobić poprzez zapytanie property_definitions:
SELECT * FROM property_definitions
WHERE label = [column_name]
Nie zawsze może być dokładne dopasowanie, ponieważ niektóre nazwy właściwości są zwykle rozwiązywane na bardziej opisową nazwę w aplikacji. W takich przypadkach może pomóc wyszukiwanie rozmyte z użyciem operatora LIKE na kolumnie label (lub nawet description) w property_definitions.
Po określeniu, do którego typu obiektu należy kolumna, trywialnie jest określić, co należy zapytać. Możesz po prostu wyszukać widok object_x, który odpowiada danemu typowi.
Jak połączyć ten typ danych z innym, np. jak pobrać formularze dla kampanii?
Jeśli potrzebujesz połączyć ze sobą dwa lub więcej różnych rekordów, przyjrzyj się asocjacjom. Asocjacje reprezentują relacje między obiektami w HubSpot CRM. Wszystkie różne skojarzenia możliwe między dwoma typami są wymienione w association_definitions. W powyższym przykładzie, aby poznać wszystkie formularze, z którymi powiązana jest kampania, należy wykonać zapytanie ASSOCIATIONS_CAMPAIGNS_TO_FORMS:
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
Jak mogę poznać status integracji HubSpot-Snowflake?
Aby otrzymywać aktualizacje statusu w czasie rzeczywistym dotyczące przestojów i problemów dla integracji HubSpot-Snowflake, zapytaj o widok data_share_status:
SELECT * FROM hubspot.public.data_share_status
LIMIT 1
Wyniki zostaną wyświetlone jako:
STATUS | MESSAGE | AKTUALIZACJA |
OK | W TEJ CHWILI NIE MA ŻADNEGO ZNANEGO ZDARZENIA. | 2023-04-10 09:21:20.123 |
Widok ten dostarcza aktualizacji stanu integracji w odwrotnym porządku chronologicznym. Zintegrowanie wyników tego zapytania z pulpitem nawigacyjnym pomoże Ci śledzić wydajność integracji i wykryć wszelkie przestoje lub awarie.
Powiązana treść
-
Zrozumienie raportowania atrybucji
Podczas tworzenia raportu tworzenia kontaktu, tworzenia transakcji lub przypisywania przychodów należy...
Baza wiedzy -
Analizuj ruch w witrynie za pomocą narzędzia do analizy ruchu.
Użyj narzędzia do analizy ruchu HubSpot, aby wyświetlić dane dotyczące ruchu w witrynie. Obejmuje to...
Baza wiedzy -
Tworzenie raportów za pomocą kreatora raportów własnych
Dzięki niestandardowemu konstruktorowi raportów HubSpot możesz analizować wiele źródeł danych w całym...
Baza wiedzy