Przejdź do treści
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.

    snowflake-worksheet-settings0
  • W wyskakującym oknie:
    • Kliknij menu rozwijane Magazyn, a następnie wybierz swój magazyn.
    • Kliknij menu rozwijane Baza danych, a następnie wybierz swoją bazę danych HubSpot.
    • Kliknij menu rozwijane Schemat, a następnie wybierz schemat, którego chcesz użyć:
        • V2_DAILY: schemat dzienny do odpytywania danych na podstawie tabel. Dane w tym schemacie są aktualizowane raz dziennie. Użycie tego schematu powoduje szybsze wykonywanie zapytań i jest zalecane do wykonywania zapytań bezpośrednio w Snowflake.
        • V2_LIVE: schemat na żywo oparty na bezpiecznych widokach danych HubSpot. Dane w tym schemacie są aktualizowane maksymalnie co 15 minut. W przypadku zapytań do dużego zestawu danych, zapytania mogą być wolne. W takim przypadku zaleca się najpierw skopiowanie danych do własnej tabeli za pomocą procesu ETL, a następnie wykonanie zapytania do tej tabeli.


      snowflake-worksheet-settings-window0

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:


SELECT
objectId, 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:

  1. 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
  2. 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
ass
oc.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 occuredAt

LIMIT 50;


Zwroty:

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

Przykład 2

Odzyskaj wszystkie zdarzenia kliknięcia wiadomości e-mail według kontaktów, które kliknęły. Zapytanie to pobiera dane kontaktowe poprzez połączenie z object_with_object_properties.

Zapytanie:


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


Zwroty:

CLICK_TIMESTAMP CLICK_URL KONTAKT_IMIĘ KONTAKT_NAZWA_LASKI
2019-01-04 22:35:41.264 https://help.website.com/articles/tutorial/how-to-use-email-tool?utm_source=hs_automation&utm_medium=email&utm_content=68042217 Hobbes Baron
2018-11-08 09:37:41.400 https://www.website.net/webinar-case-study?utm_source=hs_automation&utm_medium=email&utm_content=55200164 Milo Złoto
2018-11-08 09:37:41.426 https://www.website.net/contact?utm_source=hs_automation&utm_medium=email&utm_content=55200164 Harlow Villari
... ... ... ...

Zapytania typu obiekt_i_zdarzenie

object_and_event_type_definitions

Ten obiekt bazy danych zawiera definicje wszystkich obiektów i zdarzeń dostępnych na koncie HubSpot.

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

Nazwa kolumny Typ Opis
OBJECTTYPEID Varchar ID obiektu, który może zawierać rurociąg (np. oferty lub bilety).
FULLYQUALIFIEDNAME Varchar Nazwa obiektu lub zdarzenia.
INGESTEDAT Timestamp Data i godzina ostatniego pobrania danych przez Snowflake. Dowiedz się więcej o typach danych kolumn.

Przykład 1

Pobierz wszystkie obiekty i zdarzenia dostępne na koncie HubSpot.

Zapytanie:


SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;


Zwroty:

OBJECTTYPEID FULLYQUALIFIEDNAME
0-1 KONTAKT
0-8 LINIA_ITEM
0-11 KONWERSACJA
... ...

Wykazy zapytań

Poniżej dowiesz się, jak wykonać kwerendę swoich list, m.in. dostępnych list kontaktów i firm oraz rekordów zawartych w tych listach.

wymienia

Ten obiekt bazy danych zawiera informacje o listach kontaktów i firm HubSpot. Zwraca jeden wiersz na listę, a kolumny zawierają szczegóły listy, takie jak nazwa listy, rozmiar i typ obiektu rekordów, które zawiera. Nie zawiera informacji o poszczególnych rekordach w ramach każdej listy (patrz list_membership).

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

Nazwa kolumny Typ Opis
OBJECTTYPEID Varchar Typ rekordów na liście (np. kontakt lub firma).
LISTID Numer Identyfikator listy. Łączy się z kolumną LISTID w tabeli list-memberships.
CLASSICLISTID Numer Identyfikator specyficzny dla list kontaktów, który pasuje do identyfikatora w adresie URL listy w HubSpot.
NAME Varchar Nazwa listy.
SIZE Numer Liczba rekordów na liście.
CREATEDBYUSERID Numer ID użytkownika, który stworzył listę.
CREATEDAT Timestamp Kiedy lista została utworzona w HubSpot.
UPDATEDBYUSERID Numer ID użytkownika, który ostatnio aktualizował listę.
UPDATEDAT Timestamp Data i godzina, w której data została ostatnio zaktualizowana w HubSpot. Dowiedz się więcej o typach danych kolumn.
INGESTEDAT Timestamp Data i czas, kiedy dane zostały ostatnio pobrane przez Snowflake.

Przykład 1

Odzyskaj wszystkie listy kontaktów.

Zapytanie:


SELECT listId, name, size
FROM lists
WHERE objectTypeId = '0-1';


Zwroty:

LISTID NAZWA SIZE
118131 Cotygodniowy zasięg 103
66156 Subskrybenci bloga 455
771852 Najlepsi abonenci 2021 37
... ... ...

Przykład 2

Pobierz określoną listę kontaktów o nazwie Top subscribers 2021.

Zapytanie:


SELECT listId, name, size 
FROM lists
WHERE objectTypeId = '0-1'
AND
listName = '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?
Niniejszy formularz służy wyłącznie do przekazywania opinii dotyczących dokumentacji. Dowiedz się, jak uzyskać pomoc dotyczącą HubSpot.