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.

Zapytanie o dane HubSpot w Snowflake

Data ostatniej aktualizacji: 31 grudnia 2025

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

Data Hub Enterprise

Po połączeniu Snowflake z kontem HubSpot możesz używać funkcji udostępniania danych Snowflake, aby wysyłać zapytania dotyczące danych HubSpot z konta Snowflake.

Opóźnienie danych i region konta Snowflake

Będziesz mieć dostęp do schematu V2_LIVE, który jest aktualizowany co 15 minut, oraz schematu V2_DAILY, który jest aktualizowany codziennie.

Uwaga: następujące widoki w schemacie V2_LIVE są aktualizowane tylko raz dziennie: association_definitions, owners, pipelines i pipeline_stages.

Skonfiguruj środowisko Snowflake

Aby wysyłać zapytania do danych HubSpot w Snowflake, musisz wybrać magazyn, bazę danych i schemat, z których chcesz wysyłać zapytania. Możesz ustawić je na poziomie arkusza roboczego, aby były automatycznie uwzględniane w zapytaniach, lub dodać je ręcznie.

Aby wybrać magazyn, bazę danych i schemat na poziomie arkusza roboczego:

W górnym rzędzie arkusza kliknij pasekakcji arkusza.
W wyskakującym okienku:
- Kliknij menu rozwijaneMagazyn, a następnie wybierz swójmagazyn.
- Kliknij menu rozwijaneBaza danych, a następnie wybierz bazę danych HubSpot.
- Kliknij menu rozwijaneSchemat, a następnie wybierz schemat, którego chcesz użyć:

Po skonfigurowaniu środowiska możesz wysyłać zapytania do danych HubSpot bez konieczności ręcznego dodawania bazy danych lub typu 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ą tworzone przy użyciu języka SQL i mogą służyć do pobierania danych HubSpot, takich jak:

Obiekty: obiekty standardowe i niestandardowe, takie jak kontakty, firmy, produkty.
Rekordy: pojedyncze rekordy, takie jak pojedynczy kontakt lub firma.
Powiązania: wszystkie dostępne typy powiązań i aktualnie powiązane rekordy.
Zdarzenia: dane dotyczące zarówno standardowych zdarzeń HubSpot, takich jak otwarcia wiadomości e-mail, jak i niestandardowych zdarzeń behawioralnych.
Segmenty: segmenty kontaktów i firm HubSpot.
Właściciele: użytkownicy na koncie HubSpot w odniesieniu do rekordów, których są właścicielami.
Pipeline:pipelinetransakcjii zgłoszeń, w tym etapy pipeline.
Właściwości: właściwości i ich wartości w rekordach CRM, w tym historia właściwości.

Dowiedz się więcej o modelu danych CRM HubSpot.

Uwaga: W miarę rozwoju funkcji udostępniania danych będziemy wprowadzać zmiany, z których niektóre będą miały charakter przełomowy. Zalecamy subskrypcję dziennika zmian dla programistów HubSpot. Zmiany te będą zawsze publikowane w dzienniku zmian przed wprowadzeniem aktualizacji.

Ograniczanie i porządkowanie zwracanych danych

Podczas tworzenia zapytań można kontrolować ilość zwracanych danych oraz kolejność ich zwracania, dodając do zapytaniaklauzule LIMIT i ORDER BY. Na przykład, aby wyszukać wszystkie kontakty wraz z ich właściwościami, ale zwrócić tylko trzy wyniki i uporządkować je według identyfikatora kontaktu, można skonstruować zapytanie w następujący sposób:

SELECT objectTypeId, updatedAt, ingestedAt
FROM objects_deals
ORDER BY objectId
LIMIT 10;

Typy danych kolumn

Podczas wysyłania zapytań do danych w Snowflake kolumny zwracane w wynikach zależą od danych, które są przedmiotem zapytania. Dostępne kolumny dla danej tabeli lub widoku w Snowflake można wyświetlić, wybierając widok na pasku bocznym po lewej stronie.

Uwaga:w dalszej części tego dokumentu używamy terminu „obiekt bazy danych”, gdy kontekst odnosi się zarówno do tabel, jak i widoków.

Aby zwrócić określoną kolumnę, należy uwzględnić 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 może zwrócić zapytanie. Inne definicje, które nie zostały uwzględnione poniżej, można znaleźć w poszczególnych definicjach widoków w powyższym artykule.

OBJECTTYPEID: wartość VARCHAR reprezentująca typ obiektu. Na przykład 0-1 reprezentuje obiekt kontaktów, 0-2 reprezentuje obiekt firm, a 2-1232 może reprezentować obiekt niestandardowy na Twoim koncie. W segmentach odnosi się to do typu segmentu (np. kontakt lub firma). Możesz wyszukiwać wszystkie identyfikatory obiektów i zdarzeń na swoim koncie, korzystając z widoku object_and_event_type_definitions.
OBJECTID: liczba BIGINT reprezentująca pojedynczy rekord danego typu obiektu na koncie HubSpot. Aby zidentyfikować rekord, należy użyć zarówno identyfikatora typu obiektu, jak i identyfikatora obiektu.
INGESTEDAT: znacznik czasu dodania wiersza danych 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 HubSpot znacznik czasu ingestii wiersza może zostać zaktualizowany, nawet jeśli żadna inna kolumna w wierszu nie uległa zmianie.
- Podczas tworzenia procesów ETL, które kopiują ostatnio zmienione dane, zaleca się opieranie zapytań na znaczniku czasu wprowadzenia. Ponadto, jeśli 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 utworzenia lub aktualizacji danych w HubSpot, reprezentowany przez wartość TIMESTAMP_NTZ . Te znaczniki czasu będą zgodne ze znacznikami czasu w HubSpot. Na przykład czas wyświetlany w HubSpot dla daty utworzenia rekordu będzie taki sam jak znacznik czasu w kolumnie CREATEDAT w Snowflake. Nie są one bezpośrednio związane ze znacznikiem czasu pozyskania i nie zaleca się opierania procesów ETL na tych właściwościach.
COMBINEDASSOCIATIONTYPE: wartość VARCHAR, która jednoznacznie identyfikuje definicję powiązania.

Przekształcanie typów danych

Czasami dane są zwracane z zapytania z kolumnami VARCHAR, podczas gdy pożądane byłoby, aby miały one inny typ. W takich przypadkach zaleca się konwersję typu danych VARCHAR na żądane typy za pomocą funkcji Snowflake. Na przykład właściwości rekordu obiektu są przechowywane jako typy 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żywane do konwersji tych danych VARCHAR odpowiednio do typów 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 dotyczące obiektów

Poniżej dowiesz się, jak wysyłać zapytania dotyczące danych z określonych obiektów i rekordów HubSpot, a także jakie dane są zwracane.

Dane obiektów różnych typów są uporządkowane i dostępne na dwa sposoby:

Indywidualne:Każdy typ obiektu jest przechowywany we własnym widoku i zawiera tylko rekordy tego samego typu obiektu, np. objects_contacts zawiera tylko rekordy kontaktów. Eliminuje to konieczność określania identyfikatora typu obiektu podczas wysyłania zapytania. Widoki te są łatwiejsze do przeszukiwania, ponieważ nie trzeba znać identyfikatorów ObjectTypeId. Zwracają one również dane w bardziej użytecznym formacie, gdzie każdy wiersz odpowiada obiektowi i aktualnej wersji jego właściwości. O ile nie występują spowolnienia podczas wysyłania zapytań, zaleca się korzystanie z tych widoków w celu pobierania danych obiektów. Więcej informacji można znaleźć w sekcji Widoki Objects_X poniżej.
Połączone: Wszystkie rekordy dla wszystkich typów obiektów są połączone w jeden obiekt bazy danych. Dlatego podczas wysyłania zapytania należy określić filtr, np. „WHERE objectTypeId=’0-1’”. Na przykład podczas wysyłania zapytania można użyć następujących identyfikatorów typu obiektu:

Nazwa obiektu	Identyfikator typu obiektu
Kontakty	0-1
Firmy	0-2
Pozycje	0-8

Obiekty niestandardowe otrzymują identyfikator w momencie utworzenia i są identyfikowane jako2-unique_ID. Na przykład2-12345. Dowiedz się więcej o definicjach obiektów i typów zdarzeń.

Te obiekty bazy danych są zazwyczaj odpowiednie, jeśli chcesz uzyskać lepszą wydajność zapytań niż ta, którą można uzyskać z widoków objects_x. Więcej szczegółów znajdziesz w sekcjach object_with_object_properties, object_properties, objects i object_properties_history poniżej.

Widoki objects_x

W tym obiekcie bazy danych każdy dostępny typ obiektu, w tym obiekty niestandardowe, ma swój własny widok, a każdy widok zawiera tylko rekordy dla obiektów tego konkretnego typu. Widoki te są nazwane zgodnie z formatem OBJECTS_<nazwa typu obiektu>, gdzie <nazwa typu obiektu> jest nazwą typu obiektu w liczbie mnogiej. (Należy pamiętać, że jeśli typ obiektu nie ma liczby mnogiej, wówczas <nazwa typu obiektu> będzie po prostu nazwą typu obiektu w liczbie pojedynczej połączoną z literą „S”).

Zapytania do tego widoku zwracają jeden wiersz dla każdego rekordu w obiekcie, a każda właściwość obiektu jest dostępna jako oddzielna kolumna.

Poniżej znajduje się pełna lista dostępnych typów obiektów HubSpot (tj. nie niestandardowych), krótki opis danych, które reprezentują, oraz odpowiadające im widoki:

Typ obiektu HubSpot	Identyfikator typu obiektu	Opis
KONTAKT	0-1	Informacje o osobach fizycznych współpracujących z Twoją firmą
FIRMA	0-2	Informacje o poszczególnych firmach lub organizacjach
TRANSAKCJA	0-3	Szczegółowe informacje na temat możliwości uzyskania przychodów od kontrahenta lub firmy
ZAANGAŻOWANIE	0-4	Przechowuje dane z działań CRM, w tym notatki, zadania, e-maile, spotkania i rozmowy telefoniczne.
TICKET	0-5	Reprezentuje prośby klientów o pomoc lub wsparcie
OFERTA	0-14	Służy do udostępniania informacji o cenach potencjalnym nabywcom
FORM_SUBMISSION	0-15	Szczegóły dotyczące poszczególnych zgłoszeń w formularzu HubSpot
LINE_ITEM	0-8	Reprezentują podzbiór produktów sprzedanych w ramach transakcji. Gdy produkt jest dołączony do transakcji, staje się pozycją.
CONVERSATION	0-11	Szczegóły wiadomości przychodzących z wielu kanałów.
STRONA DOCELOWA	0-25	Szczegóły dotyczące stron docelowych
ZADANIE	0-27	Przechowuje informacje o listach rzeczy do zrobienia
FORM	0-28	Służy do gromadzenia informacji o potencjalnych klientach odwiedzających Twoją stronę i kontaktach
MARKETING_EMAIL	0-29	Szczegółowe informacje o wiadomościach e-mail z centrum marketingowego
AD_ACCOUNT	0-30	Przechowuje informacje o Twoich kontach reklamowych na LinkedIn, Facebooku i Google.
AD_CAMPAIGN	0-31	Szczegółowe informacje o kampaniach 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 reklam
KAMPANIA	0-35	Informacje o powiązanych zasobach marketingowych i treściach, dzięki czemu można łatwo zmierzyć skuteczność zbiorczych działań marketingowych.
STRONA_STRONY	0-38	Dane dotyczące poszczególnych stron w witrynach internetowych
BLOG_POST	0-39	Dane dotyczące wpisów na blogu
OBJECT_SEGMENT	0-45	Informacje o grupach rekordów obiektów na podstawie ich właściwości lub działań
CALL	0-48	Wywołania wykonane przez inne rekordy CRM, np. kontakty
INVOICE	0-53	Zarządzaj fakturami i synchronizuj je z zewnętrznymi systemami księgowymi
MEDIA_BRIDGE	0-57	Informacje o zasobach multimedialnych zaimportowanych do Hubspot
SEKWENCJA	0-58	Sekwencja to seria ukierunkowanych, zaplanowanych w czasie szablonów wiadomości e-mail, które mają na celu pielęgnowanie kontaktów w czasie.
SZABLON	0-62	Zapisana treść wiadomości e-mail, którą można ponownie wykorzystać do wysyłania wiadomości e-mail.
DEAL_SPLIT	0-72	Podział transakcji służy do dzielenia się kredytem transakcyjnym między wielu użytkowników
SALES_DOCUMENT	0-83	Dokumenty sprzedaży tworzą bibliotekę treści dla całego zespołu, umożliwiającą przesyłanie i udostępnianie dokumentów kontaktom.
FEEDBACK_SUBMISSION	0-19	Przechowuje informacje przesłane w ankietach opinii.
SUBSCRIPTION	0-69	Subskrypcje zawierają szczegóły dotyczące płatności cyklicznych
PŁATNOŚCI HANDLOWE	0-101	Zawiera dane dotyczące środków pobranych od klientów

Każdy obiekt bazy danych zwróci następujące kolumny:

Nazwa kolumny	Typ	Opis
OBJECTTYPEID	Varchar	Identyfikator typu obiektu (np. kontakty to 0-1).
OBJECTID	Liczba	Identyfikator rekordu (np. rekord kontaktu o identyfikatorze 123752).
UPDATEDAT	Sygnatura czasowa	Data i godzina ostatniej aktualizacji tego obiektu w HubSpot.
INGESTEDAT	Sygnatura czasowa	Data i godzina ostatniego pobrania danych przez Snowflake.
PROPERTY_*	Varchar	Poszczególne kolumny zawierające najnowszą wersję właściwości obiektu. Dla każdej właściwości obiektu, która ma typ daty lub liczby (zgodnie z określeniem w property_definitions), będą dwie kolumny: Kolumna zawierająca wartość właściwości jako ciąg znaków. Nazwa kolumny będzie brzmiała 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. Należy pamiętać, że kolumna ta będzie zawierała wartość null, jeśli konwersja na typ natywny nie powiedzie się z powodu nieprawidłowych danych.

Przykład 1

Pobierz imię, nazwisko i etap cyklu życia wszystkich kontaktów.

Zapytanie:

SELECT objectId, property_firstname AS firstname, property_lastname AS lastname,property_lifecyclestage AS lifecyclestage
FROM objects_contact

Zwraca:

OBJECTID	FIRSTNAME	LASTNAME	LIFECYCLESTAGE
54325098	Hobbes	Baron	ołów
96805401	Milo	Gold	ołów
6922028	Henry	Riley	ołów

Przykład 2

Pobierz nazwę i etap maksymalnie trzech transakcji.

Zapytanie:

SELECT objectId, property_dealName, property_dealStage, property_amount AS dealAmount
FROM objects_deals LIMIT 3

Zwraca:

OBJECTID	NAZWA_TRANSAKCJI_NIERUCHOMOŚCI	PROPERTY_DEALSTAGE	PROPERTY_DEALAMOUNT
38960439	Nazwa transakcji 1	zamknięta wygrana	34199
321740651	Transakcja testowa 123	14845019	8383663
98392101	Namiot typu pop-up	closedwon	9309007

Przykład 3

Pobierz nazwę i etap trzech najlepszych transakcji pod względem kwoty.

Zapytanie:

Ponieważ dane dotyczące wartości transakcji są dostępne jako typ danych liczbowych, można je wykorzystać do sortowania bez konieczności konwersji lub rzutowania.

SELECT objectId, property_dealName, property_dealStage, property_amount AS dealAmount
FROM objects_deals ORDER BY property_amount DESC LIMIT 3

Zwraca:

OBJECTID	NAZWA_TRANSAKCJI_NIERUCHOMOŚCI	PROPERTY_DEALSTAGE	KWOTA TRANSAKCJI NIERUCHOMOŚCI
98392101	Pop-Up Canopy	zamknięta wygrana	9309007
321740651	Testowa oferta 123	14845019	8383663
38960439	Nazwa transakcji 1	closedwon	34199

obiekt_z_właściwościami_obiektu

Ten obiekt bazy danych zawiera dane z rekordów HubSpot. Zapytania do tego obiektu bazy danych zwracają jeden wiersz dla każdego rekordu w obrębie typu obiektu (np. wszystkie rekordy kontaktów w typie obiektu kontakty). Wszystkie właściwości są przechowywane w kolumnie Właściwości, która jest kolumną Snowflake Variant / JSON.

Ten widok może zwrócić następujące kolumny:

Nazwa kolumny	Typ	Opis
`OBJECTTYPEID`	Varchar	Identyfikator typu obiektu (np. kontakty to `0-1`).
`OBJECTID`	Numer	Identyfikator rekordu (np. rekord kontaktu o identyfikatorze `123752`).
`WŁAŚCIWOŚCI`	Wariant	Wartości właściwości rekordu.
`UPDATEDAT`	Sygnatura czasowa	Data i godzina ostatniej aktualizacji rekordu w HubSpot. Dowiedz się więcej o typach danych kolumn.
`INGESTEDAT`	Znacznik czasu	Data i godzina ostatniego pobrania danych 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, zostanie zaktualizowana. Ma to na celu dostosowanie sposobu przedstawiania danych daty i godziny w pozostałej części udostępnianych danych.

Ponieważ jest to istotna zmiana, do tabeli i widoku dodano nową kolumnę updatedat. Przez następne 90 dni te dwie nowe kolumny będą współistnieć z kolumnami timestamp, które mają zastąpić. Daje to możliwość przejścia na korzystanie z nowych kolumn.

Po upływie 90 dni, 25 stycznia 2022 r., kolumna timestamp zostanie usunięta z tabeli i widoku. Po tej dacie wszelkie próby wysłania zapytania do tabeli lub widoku object_with_object_properties przy użyciu kolumn timestamp zakończą się niepowodzeniem.

Przykład 1

Pobierz wszystkie kontakty i ich właściwości.

Zapytanie:

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

Zwraca:

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ę i etap maksymalnie trzech transakcji.

Zapytanie:

SELECT
objectId,
properties:dealname::string AS dealname,
properties:dealstage::string AS dealstage,
properties:amount::number AS dealamount
FROM obiekt_z_właściwościami_obiektu
WHERE identyfikator_typu_obiektu = '0-3'
LIMIT 3;

Zwraca:

OBJECTID	NAZWA_TRANSAKCJI	ETAP TRANSAKCJI	KWOTA TRANSAKCJI
38960439	Nazwa transakcji 1	zamknięta/przegrana	7488939
321740651	Nazwa transakcji 1	zamknięta wygrana	9292029
98392101	Nazwa transakcji 1	zamknięta przegrana	62626528

obiekty

Ten obiekt bazy danych jest podzbiorem danych zawartych w obiekcie bazy danych object_with_object_properties. Każdy zwrócony wiersz zwraca identyfikator obiektu dla każdego rekordu. Ten obiekt bazy danych zwraca tylko istniejące rekordy. Gdy rekord zostanie usunięty w HubSpot, zostanie on usunięty z tego obiektu bazy danych. Ten obiekt bazy danych jest podzbiorem danych zawartych 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 on usunięty z tego widoku.

Ten obiekt bazy danych może być przydatny, jeśli Twoje konto zawiera dużą ilość danych, co powoduje spowolnienie działania widoków object_with_object_properties i objects_x. Wykorzystanie tego obiektu bazy danych wraz z obiektem bazy danych object_properties umożliwia replikację danych w object_with_object_properties, przy jednoczesnym zachowaniu kontroli nad tym, które właściwości są zwracane.

Ten obiekt bazy danych może zwracać następujące kolumny:

Nazwa kolumny	Typ	Opis
`OBJECTTYPEID`	Varchar	Identyfikator typu obiektu (np. kontakty to `0-1`).
`OBJECTID`	Liczba	Identyfikator rekordu (np. rekord kontaktu o identyfikatorze `123752`).
`INGESTEDAT`	Sygnatura czasowa	Data i godzina ostatniego pobrania danych przez Snowflake. Dowiedz się więcej o typach danych kolumn.

Przykład 1

Pobierz wszystkie rekordy kontaktów.

Zapytanie:

WYBIERZ objectTypeId, objectId
Z obiektów
WHERE identyfikator_typu_obiektu = '0-1'

Zwraca:

OBJECTTYPEID	OBJECTID
0	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ą dla danego rekordu. Na przykład kontakt będzie miał jeden wiersz dla właściwości Imię i jeden wiersz dla właściwościNazwisko. Jeśli rekord nie ma wartości dla właściwości, wiersz pojawi się z pustym ciągiem znaków lub nie pojawi się wcale.

Ten obiekt bazy danych może zwrócić następujące kolumny:

Nazwa kolumny	Typ	Opis
`OBJECTTYPEID`	Varchar	Identyfikator typu obiektu (np. kontakty to `0-1`).
`OBJECTID`	Liczba	Identyfikator rekordu (np. rekord kontaktu o identyfikatorze `123752`).
`NAME`	Varchar	Nazwa właściwości.
`WARTOŚĆ`	Sygnatura czasowa	Wartość właściwości.
`UPDATEDAT`	Sygnatura czasowa	Data i godzina ostatniej aktualizacji rekordu w HubSpot. Dowiedz się więcej o typach danych kolumn.
`INGESTEDAT`	Znacznik czasu	Data i godzina ostatniego pobrania danych przez Snowflake.

Przykład 1

Pobierz właściwości imienia, nazwiska i miasta dla wszystkich kontaktów.

Zapytanie:

SELECT objectTypeId, objectId, nazwa, wartość
Z właściwości obiektu
WHERE typIdObiektu = '0-1'
AND nazwa IN ('imię', 'nazwisko', 'miasto')
ORDER BY objectId;

Zwraca:

OBJECTTYPEID	OBJECTID	NAME	WARTOŚĆ
0-1	10401	imię	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. W tym przykładzie użyto składni SQL PIVOT.

Zapytanie:

WYBIERZ objectId, imię, nazwisko, etap cyklu życia
FROM
(
SELECT objectId, nazwa, wartość
FROM właściwości_obiektu
WHERE objectTypeId = '0-1'
AND nazwa IN ('imię', 'nazwisko', 'etap cyklu życia')
)
PIVOT(MAX(wartość) DLA nazwa W ('imię', 'nazwisko', 'etap cyklu życia')) JAK p(identyfikator obiektu, imię, nazwisko, etap cyklu życia);

Zwraca:

OBJECTTYPEID	OBJECTID	IMIĘ	NAZWISKO	ETAP CYKLU ŻYCIA
0-1	54325098	Hobbes	Baron	ołów
0-1	96805401	Milo	Gold	przewaga
0-1	6922028	Henry	Riley	przewaga
...	...	...	...	...

historia_właściwości_obiektu

Ten obiekt bazy danych zawiera historyczne wartości właściwości. W przypadku kontaktów zawiera 45 najnowszych wartości. W przypadku wszystkich innych obiektów zawiera 20 najnowszych wartości. Wyświetla wiersz dla każdej historycznej wartości właściwości. Aktualna wartość właściwości jest określana na podstawie najnowszego znacznika czasu UPDATEDATw historii właściwości.

Ten obiekt bazy danych może zwracać następujące kolumny:

Nazwa kolumny	Typ	Opis
`OBJECTTYPEID`	Varchar	Identyfikator typu obiektu (np. kontakty to `0-1`).
`OBJECTID`	Liczba	Identyfikator rekordu (np. rekord kontaktu o identyfikatorze `123752`).
`NAME`	Varchar	Nazwa właściwości.
`WARTOŚĆ`	Sygnatura czasowa	Wartość właściwości.
`AKTUALIZACJA`	Znacznik czasu	Data i godzina ostatniej aktualizacji danych w HubSpot. Dowiedz się więcej o typach danych w kolumnach.
`INGESTEDAT`	Znacznik czasu	Data i godzina ostatniego pobrania danych przez Snowflake.

Przykład 1

Pobierz historię pojedynczej właściwości dla pojedynczego kontaktu.

Zapytanie:

SELECT objectId, name, value, updatedAt
FROM historia_właściwości_obiektu
WHERE objectTypeId = '0-1'
AND objectId = 136493192
AND nazwa = 'hs_predictivescoringtier'
ORDER BY UPDATEDAT DESC;

Zwraca:

OBJECTID	NAME	WARTOŚĆ	UPDATEDAT
136493192	hs_predictivescoringtier	tier_1	2022-06-22 22:45:05.931
136493192	hs_predictivescoringtier	tier_2	2021-09-18 08:20:56.622
136493192	hs_predictivescoringtier	tier_3	2019-11-31 18:20:22.851
...	...	...	...

Przykład 2

Pobierz aktualne imiona i nazwiska wszystkich kontaktów, które kiedykolwiek miały etap cyklu życia „Subskrybent”.

Zapytanie:

SELECT
objectId,
properties:firstname::string AS firstname,
properties:lastname::string AS lastname
FROM obiekt_z_właściwościami_obiektu
WHERE obiekt_z_właściwościami_obiektu.typ_obiektu_Id = '0-1'
AND objectId IN (
SELECT objectId
FROM historia_właściwości_obiektu
WHEREhistoria_właściwości_obiektu.typ_obiektu_id = '0-1'
AND object_properties_history.name = 'lifecyclestage'
I object_properties_history.value = 'subskrybent'
);

Zwraca:

OBJECTID	IMIĘ	NAZWISK
54325098	Hobbes	Baron
96805401	Milo	Gold
6922028	Henry	Riley
...	...	...

Zapytania asocjacyjne

Podobnie jak dane obiektów, dane powiązania są zorganizowane na dwa sposoby:

Indywidualne: Każdy typ powiązania jest przechowywany we własnym widoku i zawiera tylko rekordy tego typu. Na przykład associations_contacts_to_deals zawiera tylko rekordy powiązań między obiektami kontaktów i transakcji. Eliminuje to konieczność określania associationtypeid podczas wysyłania zapytania. Widoki te są dość łatwe do przeszukiwania, ponieważ nie wymagają znajomości modelu danych CRM, aby z nich korzystać. Zwracają one również rozszerzony opis rekordu powiązania między dwoma obiektami, który można łatwo wykorzystać w połączeniach z widokami objects_x. Jeśli nie występują spowolnienia podczas wysyłania zapytań, zaleca się korzystanie z tych widoków w celu pobrania danych powiązania. Więcej informacji można znaleźć w sekcji widoki associations_x_to_y poniżej.
Połączone: Wszystkie rekordy dla wszystkich typów powiązań są połączone w jeden obiekt bazy danych. Dlatego podczas wysyłania zapytania należy określić filtr, np. „WHERE combinedassociationtypeid=’0-32’ ”. Więcej informacji można znaleźć w sekcji „Powiązania” i „Definicje powiązań” poniżej.

widoki associations_x_to_y

Każdy typ powiązania ma swój własny widok, oznaczony jako associations_<nazwa typu powiązania>, np. associations_contacts_to_deals. Każdy widok jest podzbiorem danych w obiekcie bazy danych powiązań i zawiera tylko rekordy o określonym combinedassociationtypeid.

Każdy obiekt bazy danych zwraca następujące kolumny:

Nazwa kolumny	Typ	Opis
COMBINEDASSOCIATIONTYPEID	Varchar	Unikalny identyfikator definicji powiązania.
KATEGORIA_POWIĄZANIA	Varchar	Źródło typu powiązania. Jedno z następujących: HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED
ASSOCIATIONTYPEID	Varchar	Unikalny identyfikator definicji powiązania w ramach określonej kategorii powiązania, tzn. żadne dwie definicje w kategorii powiązania nie będą miały tego samego associationtypeid.
FROMOBJECTTYPEID	Varchar	Identyfikator typu obiektu, który jest źródłem definicji powiązania.
FROMOBJECTTYPE	Varchar	Nazwa typu obiektu, który jest źródłem definicji powiązania.
TOOBJECTTYPEID	Varchar	Identyfikator typu obiektu będącego miejscem docelowym definicji powiązania.
TOOBJECTTYPE	Varchar	Nazwa typu obiektu, który jest miejscem docelowym definicji powiązania.
NAME	Varchar	Nazwa definicji powiązania.
LABEL	Varchar	Opis definicji powiązania.
ISMAINASSOCIATIONDEFINITION	Boolean	Czy definicja powiązania jest typem głównym. Jeśli wartość jest prawdziwa, definicja jest tą, którą HubSpot wyświetla w powiązanych rekordach.
[FROMOBJECTTYPE_OBJECTID] np. dla widoku ASSOCIATIONS_CONTACTS_TO_DEALS będzie to CONTACT_OBJECTID	Liczba	Identyfikator obiektu źródłowego.
[TOOBJECTTYPE_OBJECTID] np. dla widoku ASSOCIATIONS_CONTACTS_TO_DEALS będzie to DEAL_OBJECTID	Numer	Identyfikator obiektu docelowego.
INGESTEDAT	Sygnatura czasowa	Data i godzina ostatniego pobrania danych przez Snowflake.

Przykład 1

Pobierz wszystkie transakcje powiązane z określonym kontaktem.

Zapytanie:

SELECT
contact_objectId, deal_objectId

FROM associations_contacts_to_deals

WHERE contactId = 6626541373

Zwraca:

CONTACT_OBJECTID	DEAL_OBJECTID
6626541373	233620335
6626541373	90253678

Przykład 2

Pobierz wszystkie kontakty z strefy czasowej Bogota i ich transakcje.

SELECT contacts.property_firstname contact_firstname,

kontakty.nazwisko_nieruchomości kontakt_nazwisko,
kontakty.adres_e-mail_nieruchomości adres_e-mail_kontaktu,
deals.property_dealtype deal_type, deals.property_amount deal_amount
FROM obiekty_kontakty kontakty
JOIN powiązania_kontakty_do_transakcji assoc on
assoc.contact_objectid=kontakty.objectid
JOIN obiekty_transakcje transakcje na transakcje.identyfikator_obiektu=asocjacje.identyfikator_obiektu_transakcji
gdzie kontakty.property_hs_timezone='america_slash_bogota'

KONTAKT_IMIĘ	KONTAKT_NAZWISKO	KONTAKT_EMAIL	TYP_TRANSAKCJI	KWOTA_TRANSAKCJI
David	Magalhães	dmagalhaes@example.com	newbusiness	74848
Fernanda	Rodrigues	fmoreira@example.com	newbusiness	253530

Przykład 3

Pobierz wszystkie kontakty i łączną sumę wartości zawartych transakcji dla każdego kontaktu.

SELECT SUM(transakcje.nieruchomość_hs_zamknięta_kwota) AS
total_closed_amount, contacts.property_email contact_email
FROM obiekty_kontakty kontakty
JOIN powiązania_kontakty_do_transakcji assoc na
assoc.contact_objectid=kontakty.objectid
JOIN obiekty_transakcje transakcje na transakcje.identyfikator_obiektu=asocjacje.identyfikator_obiektu_transakcji
GROUP BY adres_e-mail_kontaktu
ORDER BY total_closed_amount DESC

Zwraca:

TOTAL_CLOSED_AMOUNT	CONTACT_EMAIL
98474793	johndoe@riverview.com
849488	sallymae@longford.com

association_definitions

Ten obiekt bazy danych zawiera informacje o wszystkich dostępnych typach powiązań między obiektami HubSpot, z jednym wierszem na każdy typ powiązania. Możesz połączyć ten obiekt bazy danych z obiektem bazy danych powiązań, aby uzyskać informacje o powiązaniach dotyczących konkretnych rekordów.

Między tymi samymi obiektami może istnieć wiele typów powiązań. Główny typ powiązania, który jest wyświetlany w HubSpot podczas powiązania rekordów, wykorzystuje powiązanie, w którym ISMAINASSOCIATIONDEFINITION ma wartość true.

Ten obiekt bazy danych może zwracać następujące kolumny:

Nazwa kolumny	Typ	Opis
`COMBINEDASSOCIATIONTYPEID`	Varchar	Unikalny identyfikator definicji powiązania.
`CATEGORY`	Varchar	Źródło typu powiązania. Jedno z następujących: `HUBSPOT_DEFINED`, `USER_DEFINED`, `INTEGRATOR_DEFINED`
`ID`	Liczba	Identyfikator definicji powiązania w ramach swojej kategorii.
`FROMOBJECTTYPEID`	Varchar	Identyfikator obiektu, który jest źródłem definicji powiązania.
`TOOBJECTTYPEID`	Varchar	Identyfikator obiektu będącego miejscem docelowym definicji powiązania.
`NAME`	Varchar	Nazwa definicji powiązania.
`LABEL`	Varchar	Etykieta definicji powiązania.
`ISMAINASSOCIATIONDEFINITION`	Boolean	Czy definicja powiązania jest typem głównym. Jeśli wartość jest prawdziwa, definicja jest tą, którą HubSpot wyświetla w powiązanych rekordach.
`INGESTEDAT`	Sygnatura czasowa	Data i godzina ostatniego pobrania danych przez Snowflake. Dowiedz się więcej o typach danych kolumn.

Przykład 1

Pobierz typy powiązań dostępne na Twoim koncie.

Zapytanie:

WYBIERZ połączonyTypStowarzyszeniaId, zTypObiektuId, doTypObiektuId, nazwa
FROM definicje_powiązań
SORTUJ według kategorii, id

Zwraca:

COMBINEDASSOCIATIONTYPE	FROMOBJECTTYPEID	TOOBJECTTYPEID	NAME
0-1	0-1	0-2	KONTAKT_Z_FIRMĄ
0-2	0-2	0-1	FIRMA_DO_KONTAKTU
0-3	0-3	0-1	DEAL_TO_CONTACT
0-4	0-1	0-3	KONTAKT_DO_UMOWY
0-5	0-3	0-2	DEAL_TO_COMPANY
...	...	...	...

Przykład 2

Pobierz dostępne typy powiązań między transakcjami a firmami.

Zapytanie:

SELECTpołączonyTypPowiązaniaId, zTypObiektuId, doTypObiektuId, nazwa
FROM definicje_powiązań
WHERE fromObjectTypeId = '0-3' AND toObjectTypeId = '0-2' AND isMainAssociationDefinition = true
ORDER BY kategoria, id

Zwraca:

POŁĄCZONY_TYP_STOWARZYSZENIA	Z TYPU OBIEKTU ID	DO TYPU OBIEKTU ID	NAZWA
0-5	0-3	0-2	DEAL_TO_COMPANY
0-271	0-3	0-2	DEAL_TO_PRIMARY_COMPANY
0-341	0-3	0-2	DEAL_TO_COMAPNY_UNLABELED

powiązania

Ten obiekt bazy danych zawiera informacje o powiązaniach między konkretnymi rekordami. Każdy wiersz reprezentuje powiązanie między jednym obiektem a innym obiektem. Wiersze mogą być obecne w tym obiekcie bazy danych, nawet jeśli rekordy, do których się odnoszą, zostały usunięte. Można sprawdzić, czy rekordy istnieją, łącząc się z tabelą obiektów.

Ten obiekt bazy danych może być przydatny, jeśli konto zawiera dużą ilość danych, co powoduje spowolnienie działania widoków associations_x_to_y.

Ten obiekt bazy danych może zwracać następujące kolumny:

Nazwa kolumny	Typ	Opis
`COMBINEDASSOCIATIONTYPEID`	Varchar	Unikalny identyfikator definicji powiązania.
`FROMOBJECTID`	Liczba	Identyfikator obiektu źródłowego.
`TOOBJECTID`	Liczba	Identyfikator obiektu docelowego.
`INGESTEDAT`	Sygnatura czasowa	Data i godzina ostatniego pobrania danych przez Snowflake. Dowiedz się więcej o typach danych kolumn.

Przykład 1

Pobierz wszystkie powiązane transakcje i kontakty.

Zapytanie:

SELECT połączonyTypPowiązaniaId, zObiektId, doObiektId
Z asocjacji
WHERE połączonyTypPowiązaniaId = '0-5'

Zwraca:

COMBINEDASSOCIATIONTYPEID	FROMOBJECTID	TOOBJECTID
0	6626541373	233620335
0-5	6616436082	3866015468
0-5	6690805943	7132752747
...	...	...

Przykład 2

Pobierz wszystkie zgłoszenia powiązane z konkretnym kontaktem (identyfikator kontaktu: 3005).

Zapytanie:

SELECT połączonyTypPowiązaniaId, zObiektId, doObiektId
Z powiązania
WHERE kategoria_powiązania = 'HUBSPOT_DEFINED'
AND combinedAssociationTypeId = '0-15'
AND fromObjectId = 3005;

Zwraca:

TYP POŁĄCZONEGO STOWARZYSZENIA	FROMOBJECTID	DO ID OBIEKTU
0-5	6626541373	233620335

Przykład 3

Pobierz wszystkie transakcje powiązane z konkretnym kontaktem (ID kontaktu: 4464). Zamiast sztywnego kodowania combinedAssociationTypeId, w tym przykładzie użyto połączenia z association_definitions.

Zapytanie:

SELECT combinedAssociationTypeId, fromObjectId toObjectId,
Z powiązania
WHERE
połączonyTypPowiązaniaId = (
SELECT combinedAssociationTypeId
FROM definicje_asocjacji
WHERE fromObjectTypeId = '0-1'
AND toObjectTypeId = '0-3'
AND isMainAssociationDefinition)
AND fromObjectId = 4464;

Zwraca:

COMBINEDASSOCIATIONTYPEID	FROMOBJECTID	TOOBJECTID
0-5	6626541373	233620335

Zapytania właściciela

właściciele

Ten obiekt bazy danych zawiera informacje o użytkownikach konta 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 kontekstu. Oba identyfikatory mogą być używane do identyfikacji tego samego użytkownika.

Ten obiekt bazy danych może zwracać następujące kolumny:

Nazwa kolumny	Typ	Opis
`OWNERID`	Numer	Identyfikator właściciela użytkownika.
`USERID`	Numer	Identyfikator użytkownika. Użytkownicy z wartością NULL w tej kolumnie zostali usunięci.
`EMAIL`	Varchar	Adres e-mail użytkownika.
`IMIĘ`	Varchar	Imię użytkownika.
`LASTNAME`	Varchar	Nazwisko użytkownika.
`ARCHIVED`	Boolean	Czy użytkownik został usunięty.
`CREATEDAT`	Sygnatura czasowa	Data i godzina utworzenia użytkownika w HubSpot. Więcej informacji można znaleźć w sekcji dotyczącej typów danych kolumn.
`UPDATEDAT`	Znacznik czasu	Data i godzina ostatniej aktualizacji użytkownika w HubSpot. Więcej informacji można znaleźć w sekcji dotyczącej typów danych w kolumnach.
`INGESTEDAT`	Sygnatura czasowa	Data i godzina ostatniego pobrania danych przez Snowflake.

Przykład 1

Pobierz wszystkich użytkowników. Filtr WHERE archived = false usuwa usuniętych użytkowników z zwróconych danych.

Zapytanie:

WYBIERZ ownerId, userId, email, imię, nazwisko FROM właściciele WHERE archived = false

Zwraca:

OWNERID	USERID	EMAIL	IMIĘ	NAZWISKO
29584574	4621126	233620335	Hobbes	Baron
30532717	4874784	3866015468	Pablo	Walters
30580321	925511	7132752747	Milo	Gold
...	...	...	...	...

Przykład 2

Pobierz konkretnego właściciela według jego identyfikatora właściciela.

Zapytanie:

SELECT ownerId, userId, email, firstname, lastname
FROM właściciele
WHERE ownerId = 29584574;

Zwraca:

OWNERID	USERID	EMAIL	IMIĘ	NAZWISKO
29584574	4621126	233620335	Hobbes	Baron

Przykład 3

Pobierz wszystkie kontakty i ich właścicieli. To zapytanie łączy rekordy z właścicielami za pomocą właściwości object_with_object_properties i właściwości kontaktu hubspot_owner_id.

SELECT contact.objectId contactid, kontakt.nazwisko_pierwsze_imię kontakt_pierwsze_imię, kontakt.nazwisko_narzędzia kontakt_nazwisko, kontakt.właściciel_hubspot_id kontakt_właściciel_hubspot_id, właściciel.imię właściciel_imię, nazwisko właściciela owner_lastname, właściciel.email właściciel_email FROM obiekty_kontakty kontakt

JOIN właściciele właściciel ON kontakt.właściciel_hubspot_id = właściciel.id_właściciela

Zwraca:

CONTACTID	CONTACT_FIRSTNAME	CONTACT_LASTNAME	CONTACT_HUBSPOT_OWNER_ID	IMIĘ_WŁAŚCICIELA	NAZWISKO_WŁAŚCICIELA	OWNER_EMAIL
113834202	Richard	Greenfield	29584574	Hobbes	Baron	hobbes.b@business.com
53540801	Ford	Karl	30241125	Milo	Gold	milo.g@business.com
...	...	...	...	...	...	...

Zapytania zespołowe

zespoły

Zespoły w HubSpot pozwalają organizować użytkowników w grupy do celów organizacyjnych i raportowania. Możesz mieć zespół główny i dodatkowe zespoły.

Ten obiekt bazy danych zawiera informacje o zespołach na koncie HubSpot.

Ten obiekt bazy danych może zwracać następujące kolumny:

Nazwa kolumny	Typ	Opis
TEAMID	Numer	Identyfikator zespołu.
TEAMNAME	Varchar	Nazwa zespołu.
PARENTTEAMID	Numer	Identyfikator drużyny nadrzędnej.
CHILDTEAMIDS	Tablica	Identyfikatory drużyn podrzędnych.
PRIMARYOWNERMEMBERS	Varchar	Identyfikatory właścicieli głównych członków zespołu.
SECONDARYOWNERMEMBERS	Boolean	Identyfikatory właścicieli członków drugorzędnych zespołu.
INGESTEDAT	Sygnatura czasowa	Data i godzina ostatniego pobrania danych przez Snowflake.

Przykład 1

Pobierz wszystkie zespoły.

Zapytanie:

WYBIERZ identyfikator zespołu, nazwę zespołu, głównych członków właściciela

Z zespołów

Zwraca:

TEAMID	TEAMNAME	GŁÓWNI WŁAŚCICIELE
29584574	Podzespoł	[233620335, 1234553]
30532717	Super zespół	[3866015468, 126221873]
3058032	Drużyna A	[7132752747]

owner_team

Ten obiekt bazy danych zawiera informacje o tym, którzy właściciele odpowiadają za poszczególne zespoły na koncie HubSpot.

Ten obiekt bazy danych może zwrócić następujące kolumny:

Nazwa kolumny	Typ	Opis
TEAMID	Numer	Identyfikator zespołu.
OWNERID	Numer	Identyfikator właściciela użytkownika.
ISTEAMPRIMARY	Boolean	Czy ta drużyna jest główną drużyną dla tego właściciela.
INGESTEDAT	Sygnatura czasowa	Data i godzina ostatniego pobrania danych przez Snowflake.

Przykład 1

Pobierz wszystkich właścicieli dla danego zespołu.

Zapytanie:

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

Zwraca

TEAMID	TEAMNAME	ISTEAMPRIMARY
29584574	233620335	TRUE
29584574	1234553	PRAWDA

Zapytania potokowe

Poniżej dowiesz się, jak wysyłać zapytania dotyczące dane dotyczące potoku transakcji i zgłoszeń, takich jak dostępne potoki na koncie i ich etapy.

Możesz połączyć te dane z danymi obiektów, aby uzyskać pełny obraz swoich potoków. Na przykład możesz wysyłać zapytania dotyczące transakcji i ich potoków, łącząc dane objects_deals_view lub object_with_object_properties z danymi potoków.

pipeline

Ten obiekt bazy danych zawiera informacje o procesach transakcji i zgłoszeń na koncie. Każdy zwrócony wiersz reprezentuje pojedynczy proces.

Ta tabela może zwracać następujące kolumny:

Nazwa kolumny	Typ	Opis
`PIPELINEID`	Varchar	Identyfikator potoku.
`OBJECTTYPEID`	Varchar	Identyfikator obiektu, który może zawierać potok (np. transakcje lub zgłoszenia).
`LABEL`	Varchar	Nazwa potoku w HubSpot.
`KOLEJNOŚĆ WYŚWIETLANIA`	Liczba	Kolejność, w jakiej potok jest wyświetlany w HubSpot.
`ARCHIVED`	Wartość logiczna	Czy potok został usunięty.
`DATAUTWORZENIA`	Sygnatura czasowa	Kiedy potok został utworzony.
`UPDATEDAT`	Znacznik czasu	Data i godzina ostatniej aktualizacji danych w HubSpot. Dowiedz się więcej o typach danych w kolumnach.
`INGESTEDAT`	Znacznik czasu	Data i godzina ostatniego pobrania danych przez Snowflake.

Przykład 1

Pobierz wszystkie dostępne procesy transakcji, uporządkowane według kolejności w HubSpot.

Zapytanie:

WYBIERZ objectTypeId, pipelineId, label
Z potoków
WHERE objectTypeId = '0-3'AND not archived
ORDER BY displayorder;

Zwraca:

OBJECTTYPEID	PIPELINEID	LABEL
0-3	1bed503c-37f7-4f51-9d40-7598902673f4	Pipeline sprzedaży
0-3	12659678	Licencje Pipeline
0-3	75e28846-ad0d-4be2-a027-5e1da6590b98	Nowa działalność
...	...	...

Przykład 2

Pobierz transakcje w ramach określonego procesu sprzedaży. Łączy obiekty object_with_object_properties i pipelines.

Zapytanie:

SELECT

transakcje.identyfikator_obiektu identyfikator_transakcji, deals.property_dealname deal_name, pipelines.label pipeline_name FROM obiekty_transakcje transakcje INNER JOIN rurociągi ON deals.objectTypeId = pipelines.objectTypeId AND deals.property_pipeline = pipelines.pipelineid WHERE rurociągi.typ_obiektu_Id = '0-3';

Zwraca:

DEAL_ID	NAZWA_TRANSAKCJI	NAZWA_RUROCIĄGU
605140072	Rejestracja w Meowmix Global	Pipeline sprzedaży
605457408	Zmiana marki Friskies	Kanał sprzedaży
604362473	Tworzenie aplikacji Fresh Step	Kanał sprzedaży

Przykład 3

Tak samo jak w przykładzie 2 powyżej, pobierz transakcje w ramach określonego procesu sprzedaży. Jednak zamiast używać obiektów objects_deals w połączeniach, użyj obiektu object_with_object_properties.

SELECT deals.objectId deal_id, deals.properties:dealname::varchar deal_name, pipelines.label pipeline_name FROM obiekt_z_właściwościami_obiektu transakcje INNER JOIN rurociągi ON deals.objectTypeId = pipelines.objectTypeId AND deals.properties:pipeline::string = pipelines.pipelineid WHERE deals.objecttypeId = '0-3' AND rurociągi.typ_obiektu_Id = '0-3';

Zwraca:

DEAL_ID	DEAL_NAME	PIPELINE_NAME
605140072	Rejestracja w Meowmix Global	Pipeline sprzedaży
605457408	Zmiana marki Friskies	Kanał sprzedaży
604362473	Tworzenie aplikacji Fresh Step	Kanał sprzedaży

pipeline_stages

Ten widok zawiera informacje o poszczególnych etapach w ramach procesu. Etapy można zidentyfikować, łącząc identyfikator typu obiektu, identyfikator procesu i identyfikator etapu. Podczas łączenia z procesami należy używać identyfikatora typu obiektu i identyfikatora procesu.

Ten obiekt bazy danych może zwracać następujące kolumny:

Nazwa kolumny	Typ	Opis
`PIPELINEID`	Varchar	Identyfikator potoku.
`STAGEID`	Varchar	Identyfikator etapu.
`LABEL`	Varchar	Nazwa etapu w HubSpot.
`DISPLAYORDER`	Numer	Kolejność, w jakiej potok jest wyświetlany w HubSpot.
`METADATA`	Wariant	Opis etapu w formacie JSON, zawierający informację, czy jest on otwarty, czy zamknięty.
`ARCHIWIZOWANE`	Boolean	Czy etap potoku został usunięty.
`CREATEDAT`	Sygnatura czasowa	Kiedy etap potoku został utworzony.

Przykład 1

Pobierz etapy potoku dla potoku transakcji o nazwiePotok sprzedaży.

Zapytanie:

SELECT pipelineid, stageId, label
FROM etapy_pipeline
WHERE nie zarchiwizowano
AND pipelineid = (
SELECT pipelineid
FROM rurociągi
WHERE objectTypeId = '0-3'
I nie zarchiwizowano
AND label = 'Sales Pipeline' LIMIT 1)
ORDER BY displayorder;

Zwraca:

PIPELINEID	STAGEID	LABEL
941650	941651	Kontakt
941650	941652	Umówiono spotkanie
941650	941653	Wysłano fakturę
...	...	...

Przykład 2

Pobierz wszystkie transakcje i odpowiadające im etapy procesu sprzedaży.

Zapytanie:

SELECT
deals.objectId deal_id,
deals.properties:dealname::varchar deal_name,
pipelines.label pipeline_name,
pipeline_stages.label pipeline_stage_name
FROM obiekt_z_właściwościami_obiektu transakcje
INNER JOIN rurociągi
ON deals.objectTypeId = pipelines.objectTypeId
AND deals.properties:pipeline::string = pipelines.pipelineid
INNER JOIN etapy_pipeline
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';

Zwraca:

DEAL_ID	DEAL_NAME	NAZWA_PIPELINE	NAZWA_ETAPU_PIPELINE
605140072	Rejestracja w Meowmix Global	Pipeline sprzedaży	Wysłano umowę
605457408	Zmiana marki Friskies	Kanał sprzedaży	Spotkanie zaplanowane
604362473	Tworzenie aplikacji Fresh Step	Kanał sprzedaży	Podpisana umowa
...	...	...	...

Zapytania dotyczące właściwości

property_definitions

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, łącząc ich identyfikator typu obiektu i nazwę. Podobne informacje można uzyskać za pomocą interfejsu API właściwości.

Ten obiekt bazy danych może zwracać następujące kolumny:

Nazwa kolumny	Typ	Opis
`OBJECTYPEID`	Varchar	Identyfikator obiektu, którego dotyczy zdarzenie.
`NAME`	Varchar	Wewnętrzna nazwa właściwości.
`LABEL`	Varchar	Etykieta właściwości.
`DESCRIPTION`	Varchar	Opis właściwości.
`TYP`	Varchar	Typ właściwości (np. ciąg znaków, liczba, data i godzina).
`FIELDTYPE`	Varchar	Typ pola właściwości. Określa sposób wyświetlania właściwości w HubSpot i formularzach (np. pole wyboru, lista rozwijana).
`DISPLAYORDER`	Liczba	Kolejność wyświetlania właściwości.
`GROUPNAME`	Varchar	Nazwa grupy właściwości.
`OPTIONS`	Wariant	W przypadku właściwości wyliczeniowych tablica opcji właściwości, zawierająca atrybuty każdej opcji (np. kolejność wyświetlania, etykieta).
`CREATEDUSERID`	Liczba	Identyfikator użytkownika, który utworzył właściwość.
`REFERENCEDOBJECTTYPE`	Varchar	Typ obiektu, do którego odnosi się właściwość. Właściwości właściciela zwrócą wartość OWNER.
`CALCULATED`	Boolean	Czy właściwość jest właściwością obliczoną.
`EXTERNALOPTIONS`	Boolean	Czy opcje właściwości są zdefiniowane w systemie zewnętrznym.
`HASUNIQUEVALUE`	Boolean	Czy wartości właściwości są unikalne. Można ustawić tylko podczas tworzenia właściwości za pośrednictwem interfejsu API.
`HIDDEN`	Boolean	Czy właściwość jest ukryta w HubSpot.
`SHOWCURRENCYSYMBOL`	Boolean	Czy wartość właściwości liczbowej jest sformatowana 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żna edytować w HubSpot.
`HUBSPOTDEFINED`	Boolean	Czy właściwość została utworzona przez HubSpot, czy przez użytkownika.
`ARCHIVED`	Boolean	Czy właściwość została usunięta.
`CREATEDAT`	Sygnatura czasowa	Data i godzina utworzenia nieruchomości w HubSpot.
`UPDATEDAT`	Znacznik czasu	Data i godzina ostatniej aktualizacji danych w HubSpot. Dowiedz się więcej o typach danych w kolumnach.
`INGESTEDAT`	Sygnatura czasowa	Data i godzina ostatniego pobrania danych przez Snowflake.

Przykład 1

Pobierz nazwy i opisy wszystkich właściwości kontaktów.

Zapytanie:

WYBIERZ nazwę, etykietę, opis
FROM definicje_właściwości
WHERE objectTypeId = '0-1'

Zwraca:

NAME	LABEL	OPIS
entered_sql_stage	Wprowadzony etap SQL	Rozpocznij liczenie dni etapu SQL.
nazwa_pierwszego_zdarzenia_konwersji	Pierwsza konwersja	Pierwszy formularz przesłany przez tę osobę kontaktową.
adres	Adres	Adres kontaktu.

Zapytania dotyczące zdarzeń

Zdarzenia obejmują standardowe zdarzenia HubSpot oraz niestandardowe zdarzenia behawioralne. Każde zdarzenie ma swój własny obiekt bazy danych, oznaczony jako events_eventname.

Nazwa
EVENTS_AD_INTERACTION	Szczegóły dotyczące reklamy i kontaktów, które weszły z nią w interakcję poprzez kliknięcie reklamy lub przesłanie formularza po wejściu w interakcję z nią.
EVENTS_AD_METRICS_IMPORTED_V0	Szczegóły dotyczące reklamy i wskaźników jej skuteczności.
EVENTS_CALL_MENTIONED_KEYWORD	Szczegóły dotyczące słów kluczowych wymienionych przez uczestników rozmów.
EVENTS_CLICKED_LINK_IN_EMAIL_V2	Linki kliknięte w marketingowych wiadomościach e-mail przez kontakty.
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8	Linki kliknięte w wiadomościach e-mail w skrzynce odbiorczej rozmów przez kontakty.
EVENTS_COOKIE_BANNER_CLICKED	Kontakty, które kliknęły pliki cookie.
EVENTS_COOKIE_BANNER_VIEWED	Kontakty, które wyświetliły pliki cookie.
EVENTS_DOCUMENT_SHARED_V2	Dokumenty sprzedaży udostępnione kontaktom za pośrednictwem linku zewnętrznego.
EVENTS_DOCUMENT_VIEWED_V2	Dokumenty sprzedaży i kontakty, które je przeglądały, otwierając link zewnętrzny.
EVENTS_DOCUMENT_COMPLETED_V2	Dokumenty sprzedaży i kontakty, które zostały zamknięte.
EVENTS_HS_SCHEDULED_EMAIL_V2	E-maile przesłane do serwerów pocztowych HubSpot w celu wysłania.
EVENTS_MTA_DELIVERED_EMAIL_V2	E-maile 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.
EVENTS_OPENED_EMAIL_V2	Otwarcia wiadomości e-mail przez kontakty.
EVENTS_REPORTED_SPAM_EMAIL_V2	Wiadomości e-mail oznaczone jako spam przez odbiorców.
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2	Zmiany w subskrypcjach e-mailowych przez odbiorców.
EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8	Otwarcia wiadomości e-mail w skrzynce odbiorczej przez kontakty.
EVENTS_MB_MEDIA_PLAYED	Odtwarzanie plików wideo przez kontakty.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE	Kontakt zarezerwował spotkanie poprzez sekwencję.
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE	Kontakt zapisał się z sekwencji.
EVENTS_V2_KONTAKT_ZAKOŃCZYŁ_SEKWENCJĘ	Sekwencja zakończona.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL	Kontakt odpowiedział na wiadomość e-mail (lub wiadomość e-mail przychodzącą, która wyrejestrowała sekwencję) wysłaną za pośrednictwem sekwencji.
EVENTS_V2_CONTACT_UNENROLLED_FROM_SEQUENCE	Kontakt wyrejestrował się z sekwencji.
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE	Użytkownik ręcznie wyrejestrował kontakt.
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL	Kontakt zrezygnował z subskrypcji, wypisując się z sekwencji.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED	Wiadomość e-mail z sekwencji została odrzucona.
EVENTS_V2_SEQUENCE_ERRORED	Wystąpił błąd sekwencji powodujący wyrejestrowanie.
EVENTS_V2_SEQUENCE_STEP_EXECUTED	Wykonano krok sekwencji.
EVENTS_VISITED_PAGE	Odwiedziny stron internetowych przez kontakty.
EVENTS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER>	Zdarzenia integracyjne (Timeline V3 API)

Zdarzenia można identyfikować, łącząc ich identyfikator typu zdarzenia i identyfikator. Kolumny, które są zwracane, zależą od zdarzenia, przy czym dla każdej właściwości zdarzenia jest jedna kolumna. Wszystkie zdarzenia zwracają następujące kolumny:

Uwaga: HubSpot dodał dwie nowe kolumny do wszystkich tabel i widoków zdarzeń:

wystąpiło
wystąpiło w dniu

Kolumny te zastąpią kolumny occuredat i occuredatdateint 24 listopada 2022 r. W tym dniu stare kolumny przestaną być dostępne, a próby wysłania zapytania do obiektu bazy danych lub widoku zawierającego zdarzenia przy użyciu tych kolumn zakończą się niepowodzeniem. Dowiedz się więcej o istotnych zmianach dotyczących udostępniania danych Snowflake.

Nazwa kolumny	Typ	Opis
`TYP_WYDARZENIA`	Varchar	Identyfikator typu zdarzenia, podobny do OBJECTTYPEID Możesz wyszukać wszystkie identyfikatory typów zdarzeń na swoim koncie, korzystając z widoku object_and_event_type_definitions.
`ID`	Varchar	Jest to identyfikator unikalny dla każdego typu zdarzenia. Żadne dwa rekordy nie będą miały tego samego identyfikatora w ramach danego typu zdarzenia.
`OBJECTTYPEID`	Varchar	Typ obiektu, który zakończył zdarzenie. Na przykład kliknięcie linku w wiadomości e-mail spowoduje wyświetlenie w tej kolumnie`wartości 0-1`, reprezentującej obiekt kontaktów.
`OBJECTID`	Liczba	Identyfikator rekordu, który zakończył zdarzenie.
`OCCURREDAT`	Sygnatura czasowa	Kiedy miało miejsce zdarzenie.
`OCCURREDATDATEINT`	Numer	Numer reprezentujący moment wystąpienia zdarzenia. Zawiera te same dane co kolumna `OCCURREDAT`, ale jest sformatowany jako liczba i używany jako część klucza klastra tabeli. W większości przypadków zamiast tego numeru można użyć znacznika czasu `OCCURREDAT`.
`OCCUREDATDATEINT`	Numer	Liczba reprezentująca moment wystąpienia zdarzenia. Zawiera te same dane co kolumna `OCCURREDAT`, ale jest sformatowana jako liczba i używana jako część klucza klastra tabeli. W większości przypadków zamiast tej liczby można użyć znacznika czasu `OCCURREDAT`. Uwaga: ta kolumna zostanie wycofana 24 listopada 2022 r. i zastąpiona kolumną `OCCURREDATDATEINT`.
`OCCUREDAT`	Sygnatura czasowa	Kiedy miało miejsce zdarzenie. Uwaga: ta kolumna zostanie wycofana 24 listopada 2022 r. i zastąpiona kolumną `OCCURREDAT`.
`INGESTEDAT`	Znacznik czasu	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 najnowszych 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;

Zwraca:

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

Pobierz wszystkie zdarzenia kliknięcia wiadomości e-mail przez kontakty, które kliknęły. To zapytanie 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, kontakt.właściwości:nazwisko::varchar kontakt_nazwisko FROM events_clicked_link_in_email_V2 click LEFT JOIN obiekt_z_właściwościami_obiektu kontakt ON click.objectTypeId = contact.objectTypeId AND kliknięcie.objectId = kontakt.objectId LIMIT 3;

Zwraca:

CLICK_TIMESTAMP	CLICK_URL	KONTAKT_IMIĘ	NAZWISKO_KONTAKTOWE
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	Gold
08.11.2018 r., godz. 09:37:41	https://www.website.net/contact?utm_source=hs_automation&utm_medium=email&utm_content=55200164	Harlow	Villari
...	...	...	...

Object_and_event_type_queries

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 zwracać następujące kolumny:

Nazwa kolumny	Typ	Opis
`OBJECTTYPEID`	Varchar	Identyfikator obiektu, który może zawierać potok (np. transakcje lub zgłoszenia).
`FULLYQUALIFIEDNAME`	Varchar	Nazwa obiektu lub zdarzenia.
`INGESTEDAT`	Sygnatura czasowa	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 definicje_obiektów_i_typów_zdarzeń;

Zwraca:

OBJECTTYPEID	FULLYQUALIFIEDNAME
0-1	CONTACT
0-8	POZYCJA_POZYCJA
0-11	ROZMOWA
...	...

Zapytania segmentowe

Poniżej dowiesz się, jak wyszukiwać segmenty, takie jak dostępne segmenty kontaktów i firm oraz rekordy zawarte w tych segmentach.

segmenty

Ten obiekt bazy danych zawiera informacje o segmentach kontaktów i firm HubSpot. Zwraca jeden wiersz na segment, a kolumny zawierają szczegóły segmentu, takie jak nazwa segmentu, rozmiar i typ obiektu rekordów, które zawiera. Nie zawiera informacji o poszczególnych rekordach w każdym segmencie (zobacz segment_membership).

Ten obiekt bazy danych może zwracać następujące kolumny:

Nazwa kolumny	Typ	Opis
`OBJECTTYPEID`	Varchar	Typ rekordów w segmencie (np. kontakt lub firma).
`SEGMENTID`	Liczba	Identyfikator segmentu. Łączy się z kolumnąSEGMENTID w tabeli segmentów członkostwa.
`CLASSICSEGMENTID`	Liczba	Identyfikator specyficzny dla segmentów kontaktów, który odpowiada identyfikatorowi w adresie URL segmentu w HubSpot.
`NAME`	Varchar	Nazwa segmentu.
`ROZMIAR`	Liczba	Liczba rekordów w segmencie.
`CREATEDBYUSERID`	Liczba	Identyfikator użytkownika, który utworzył segment.
`CREATEDAT`	Sygnatura czasowa	Data utworzenia segmentu w HubSpot.
`UPDATEDBYUSERID`	Numer	Identyfikator użytkownika, który ostatnio zaktualizował segment.
`DATA AKTUALIZACJI`	Znacznik czasu	Data i godzina ostatniej aktualizacji w HubSpot. Dowiedz się więcej o typach danych w kolumnach.
`INGESTEDAT`	Sygnatura czasowa	Data i godzina ostatniego pobrania danych przez Snowflake.

Przykład 1

Pobierz wszystkie segmenty kontaktów.

Zapytanie:

WYBIERZ segmentId, nazwa, rozmiar
FROM segmenty
WHERE objectTypeId = '0-1';

Zwraca:

SEGMENTSID	NAME	SIZE
118131	Cotygodniowy zasięg	103
66156	Subskrybenci bloga	455
771852	Najlepsi subskrybenci 2021	37
...	...	...

Przykład 2

Pobierz określony segment kontaktów o nazwie Najlepsi subskrybenci 2021.

Zapytanie:

WYBIERZ segmentId, nazwa, rozmiar
Z segmentów
WHERE objectTypeId = '0-1' ANDsegmentName = 'Najlepsi subskrybenci 2021';

Zwraca:

SEGMENTID	NAZWA	ROZMIAR
771852	Najlepsi subskrybenci 2021	37

segment_membership

Ten obiekt bazy danych zawiera informacje o tym, które rekordy należą do poszczególnych segmentów, z jednym wierszem na każdy rekord w segmencie. Na przykład, jeśli masz segment subskrybentów bloga z 500 kontaktami, obiekt bazy danych zwróci 500 wierszy.

Zawiera tylko identyfikatory segmentów i identyfikatory obiektów. Aby uzyskać więcej informacji, połącz się z obiektem bazy danych segmentów.

Ten obiekt bazy danych może zwrócić następujące kolumny:

Nazwa kolumny	Typ	Opis
`SEGMENTID`	Varchar	Identyfikator segmentu. Łączy się z kolumną HS_SEGMENT_ID w tabeli segmentów.
`OBJECTID`	Varchar	Identyfikator rekordu w segmencie.
`UPDATEDAT`	Znacznik czasu	Data i godzina ostatniej aktualizacji danych w HubSpot. Dowiedz się więcej o typach danych kolumn.
`INGESTEDAT`	Sygnatura czasowa	Data i godzina ostatniego pobrania danych przez Snowflake.

Przykład 1

Pobierz identyfikatory wszystkich kontaktów w segmencieNajlepsi subskrybenci 2021.

Zapytanie:

WYBIERZ objectId
FROM segment_memberships
INNER JOIN segmenty
ON segment_memberships.segmentId = segments.segmentId
WHERE segments.objectTypeId = '0-1'
AND segmenty.nazwa = 'Najlepsi subskrybenci 2021';

Zwraca:

OBJECTID

54325098

96805401

6922028

...

Przykład 2

Pobierz imiona i nazwiska kontaktów z segmentu Najlepsi subskrybenci 2021.

Zapytanie:

SELECT

contact.objectId AS objectid, kontakt.właściwość_imię AS imię, contact.property_lastname AS lastname FROM obiekty_kontakty kontakt INNER JOIN segment_memberships ON contact.objectId = segment_memberships.objectId INNER JOIN segmenty ON segmenty_członkostwa.segmentId = segmenty.segmentId WHERE segmenty.typ_obiektuId = '0-1' AND segmenty.nazwa = 'Najlepsi subskrybenci 2021'

Zwraca:

OBJECTID	IMIĘ	NAZWISKO
54325098	Hobbes	Baron
96805401	Milo	Gold
6922028	Henry	Riley
...	...	...

Często zadawane pytania

Chcę wygenerować dane podobne do raportu z aplikacji Hubspot. Jak to zrobić?

Zasadniczo należy przyjrzeć się kolumnom obecnym w raporcie, z którym porównujesz. Jeśli wizualizacja raportu nie ma postaci tabeli, przekształcenie go w tabelę spowoduje wyświetlenie kolumn zawartych w raporcie. Kolumny te są zazwyczaj właściwościami typu obiektu lub typu zdarzenia. Następnym krokiem jest ustalenie, do jakiej właściwości typu obiektu odpowiada dana kolumna. Można to zrobić, wysyłając zapytanie do property_definitions:

SELECT * Z definicje_właściwości

WHERE label = [nazwa_kolumny]

Nie zawsze może być dokładne dopasowanie, ponieważ niektóre nazwy właściwości są zazwyczaj zamieniane na bardziej opisowe nazwy w aplikacji. W takich przypadkach pomocne może być wyszukiwanie przybliżone przy użyciu operatora LIKE w kolumnie label (lub nawet description) w property_definitions.

Po ustaleniu, do jakiego typu obiektu należy kolumna, określenie, co należy wyszukać, jest banalnie proste. Wystarczy po prostu wyszukać widok object_x odpowiadający danemu typowi.

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

Jeśli chcesz połączyć ze sobą dwa lub więcej różnych rekordów, zapoznaj się z powiązaniami. Powiązania reprezentują relacje między obiektami w HubSpot CRM. Wszystkie możliwe powiązania między dwoma typami są wymienione w association_definitions. W powyższym przykładzie, aby poznać wszystkie formularze powiązane z kampanią, należy wysłać zapytanie ASSOCIATIONS_CAMPAIGNS_TO_FORMS:

SELECT campaigns.property_hs_name campaign_name, formularze.property_hs_form_id form_id FROM obiekty_kampanii kampanie JOIN powiązania_kampanii_z_formularzami assoc ON assoc.campaign_objectid=kampanie.objectid JOIN obiekty_formularze formularze ON formularze.identyfikator_obiektu=asocjacje.identyfikator_formularza GROUP BY nazwa_kampanii

Jak sprawdzić status integracji HubSpot-Snowflake?

Aby otrzymywać aktualizacje statusu w czasie rzeczywistym dotyczące awarii i problemów związanych z integracją HubSpot-Snowflake, należy wysłać zapytanie do widoku data_share_status:

SELECT * FROM hubspot.public.data_share_status LIMIT 1

Wyniki zostaną wyświetlone w następujący sposób:

STATUS	WIADOMOŚĆ	DATA AKTUALIZACJI
OK	W CHWILI OBECNEJ NIE MA ŻADNYCH ZGŁOSZONYCH INCYDENTÓW	2023-04-10 09:21:20.123

Widok ten zawiera aktualizacje statusu integracji w odwrotnej kolejności chronologicznej. Zintegrowanie wyników tego zapytania z pulpitem nawigacyjnym pomoże Ci śledzić wydajność integracji i wykrywać wszelkie przestoje lub awarie.

Czy ten artykuł okazał się pomocny?

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

Zapytanie 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 i region konta Snowflake

Skonfiguruj środowisko Snowflake

Przegląd danych

Ograniczanie i porządkowanie zwracanych danych

Typy danych kolumn

Przekształcanie typów danych

Zapytania dotyczące obiektów

Widoki objects_x

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 asocjacyjne

widoki associations_x_to_y

Przykład 1

Przykład 2

Przykład 3

association_definitions

Przykład 1

Przykład 2

powiązania

Przykład 1

Przykład 2

Przykład 3

Zapytania właściciela

właściciele

Przykład 1

Przykład 2

Przykład 3

Zapytania zespołowe

zespoły

Przykład 1

owner_team

Przykład 1

Zapytania potokowe

pipeline

Przykład 1

Przykład 2

Przykład 3

pipeline_stages

Przykład 1

Przykład 2

Zapytania dotyczące właściwości

property_definitions

Przykład 1

Zapytania dotyczące zdarzeń

Przykład 1

Przykład 2

Object_and_event_type_queries

object_and_event_type_definitions

Przykład 1

Zapytania segmentowe

segmenty

Przykład 1

Przykład 2

segment_membership

Przykład 1

Przykład 2

Często zadawane pytania

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 sprawdzić status integracji HubSpot-Snowflake?

Powiązana treść