Uwaga: Tłumaczenie tego artykułu jest podane wyłącznie dla wygody. Tłumaczenie jest tworzone automatycznie za pomocą oprogramowania tłumaczącego i mogło nie zostać sprawdzone. W związku z tym, angielska wersja tego artykułu powinna być uważana za wersję obowiązującą, zawierającą najnowsze informacje. Możesz uzyskać do niej dostęp tutaj.

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:

Operations Hub Enterprise

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ć:

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.

snowflake-sidebar-view-column-details0

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 amount
FROM 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
KONTAKT	0-1	Informacje o osobach wchodzących w interakcje z Twoją firmą
FIRMA	0-2	Informacje o poszczególnych firmach lub organizacjach
DEAL	0-3	Szczegóły dotyczące możliwości uzyskania przychodu z kontaktu lub firmy.
ZAANGAŻOWANIE	0-4	Przechowuje dane z działań CRM, w tym notatki, zadania, wiadomości e-mail, spotkania i rozmowy.
BILET	0-5	Reprezentuj prośby klientów o pomoc lub wsparcie.
QUOTE	0-14	Używane do dzielenia się informacjami o cenach z potencjalnymi nabywcami.
FORMULARZ_ZŁOŻENIA	0-15	Szczegóły dotyczące indywidualnych zgłoszeń do formularza HubSpot.
LINIA_ITEM	0-8	Reprezentuje podzbiór produktów sprzedawanych w ramach transakcji. Kiedy produkt jest dołączony do transakcji, staje się pozycją liniową.
KONWERSACJA	0-11	Szczegóły wiadomości przychodzących z wielu kanałów.
LANDING_PAGE	0-25	Szczegóły dotyczące Twoich stron docelowych
ZADANIE	0-27	Przechowuje informacje o listach rzeczy do zrobienia
FORMULARZ	0-28	Używane do zbierania informacji o odwiedzających i kontaktach.
MARKETING_EMAIL	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
AD_CAMPAIGN	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ń
KAMPANIA	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
BLOG_POST	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ń
CALL	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
MEDIA_BRIDGE	0-57	Informacje o zasobach medialnych importowanych do Hubspot
SEQUENCE	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.
DEAL_SPLIT	0-72	Podział transakcji służy do dzielenia kredytu transakcyjnego pomiędzy wielu użytkowników.
DOKUMENT SPRZEDAŻY	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.
OPINIA_SUBMISJA	0-19	Przechowuje informacje przesłane w ankiecie zwrotnej.
SUBSKRYBUJ	0-69	Subskrypcje zawierają szczegóły dotyczące powtarzających się płatności
PŁATNOŚĆ HANDLOWA	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: Kolumna zawierająca wartość właściwości jako string. Nazwą kolumny będzie property_unparsed_[nazwa] . Na przykład, właściwość obiektu DEAL, deal_amount będzie miała kolumnę property_unparsed_deal_amount Kolumna zawierająca wartość przekonwertowaną na typ natywny. Kolumna będzie miała nazwę property_[nazwa].Na przykład właściwość obiektu DEAL, deal_amount będzie miała kolumnę property_deal_amount. Zauważ, że ta kolumna będzie zawierać null, jeśli konwersja do typu natywnego nie powiedzie się z powodu nieprawidłowych danych.

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 lifecyclestage
FROM 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 dealAmount
FROM 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 dealAmount
FROM 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:

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

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
WHEREobject_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:

SELECTcombinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
WHERE fromObjectTypeId = '0-3' AND toObjectTypeId = '0-2' AND isMainAssociationDefinition = true
ORDER 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	EMAIL	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	EMAIL	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:

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

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.
`OCCURREDATDATEINT`	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.
`OCCUREDATDATEINT`	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. Uwaga: ta kolumna zostanie zdeprecjonowana 24 listopada 2022 roku i zastąpiona przez `OCCURREDATDATEINT`.
`OCCUREDAT`	Timestamp	Kiedy nastąpiło zdarzenie. Uwaga: ta kolumna zostanie zdeprecjonowana 24 listopada 2022 roku i zastąpiona przez `OCCURREDAT`.
`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 occuredAtLIMIT 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.

Czy ten artykuł okazał się pomocny? Tak Nie

Niniejszy formularz służy wyłącznie do przekazywania opinii dotyczących dokumentacji. Dowiedz się, jak uzyskać pomoc dotyczącą HubSpot.

Zapytania o dane HubSpot w Snowflake

Dostępne z każdą z następujących podpisów, z wyjątkiem miejsc, w których zaznaczono:

Opóźnienie danych a region konta Snowflake

Skonfiguruj swoje środowisko Snowflake

Przegląd danych

Ograniczanie i porządkowanie zwróconych danych

Typy danych kolumn

Przekształcanie typów danych

Zapytania do obiektów

obiekty_x widoki

Przykład 1

Przykład 2

Przykład 3

obiekt_z_właściwościami_obiektu

Przykład 1

Przykład 2

obiekty

Przykład 1

właściwości obiektu

Przykład 1

Przykład 2

historia_właściwości obiektu

Przykład 1

Przykład 2

Zapytania do stowarzyszenia

skojarzenia_x_do_y widoki

Przykład 1

Przykład 2

Przykład 3

definicje_stowarzyszenia

Przykład 1

Przykład 2

stowarzyszenia

Przykład 1

Przykład 2

Przykład 3

Pytania do właściciela

właściciele

Przykład 1

Przykład 2

Przykład 3

Zapytania dotyczące rurociągów

rurociągi

Przykład 1

Przykład 2

Przykład 3

etapy rurociągu

Przykład 1

Przykład 2

Zapytania dotyczące nieruchomości

własności_definicje

Przykład 1

Zapytania dotyczące zdarzeń

Przykład 1

Przykład 2

Zapytania typu obiekt_i_zdarzenie

object_and_event_type_definitions

Przykład 1

Wykazy zapytań

wymienia

Przykład 1

Przykład 2

lista_członków

Przykład 1

Przykład 2

FAQs

Chcę wygenerować dane podobne do raportu z aplikacji Hubspot, jak to zrobić?

Jak połączyć ten typ danych z innym, np. jak pobrać formularze dla kampanii?

Jak mogę poznać status integracji HubSpot-Snowflake?

Powiązana treść

Zrozumienie raportowania atrybucji

Analizuj ruch w witrynie za pomocą narzędzia do analizy ruchu.

Tworzenie raportów za pomocą kreatora raportów własnych