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.
Reports

Zapytania do danych HubSpot w Snowflake

Data ostatniej aktualizacji: marca 4, 2022

Dotyczy:

Operations Hub Enterprise

Po połączeniu Snowflake z kontem HubSpot można korzystać z funkcji Udostępnianie danych Snowflake w celu odpytywania danych HubSpot z konta Snowflake.

Zapytania są konstruowane przy użyciu języka SQL i mogą być używane do pobierania danych HubSpot, takich jak:

  • Obiekty: obiekty standardowe i niestandardowe, takie jak kontakty, firmy, produkty.
  • Rekordy: indywidualnerekordy , takie jak indywidualny kontakt lub firma.
  • Stowarzyszenia: wszystkie dostępne typy as ocjacji i aktualnie powiązane rekordy.
  • Właściciele: użytkownicy na koncie HubSpot, w odniesieniu do rekordów, których są właścicielami.
  • Rurociągi:rurociągi transakcji i biletów, w tym etapy rurociągu.
  • Nieruchomości: właściwości i ich wartości w rekordach CRM, w tym historia właściwości.
  • 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 HubSpot (BETA).

Dowiedz się więcej o Model danych CRM w HubSpot.

Skonfiguruj środowisko Snowflake

Aby wykonać kwerendę danych HubSpot w Snowflake, należy wybrać magazyn, bazę danych i schemat, z którego ma być wykonana kwerenda. Można je ustawić na poziomie arkusza, aby automatycznie uwzględniać je w zapytaniach, lub dodać je ręcznie.

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

  • W górnym wierszu arkusza kliknij pasekakcji arkusza.

    snowflake-worksheet-settings0
  • W wyskakującym okienku:
    • Kliknij menu rozwijaneMagazyn, a następnie wybierz swójmagazyn.
    • Kliknij menu rozwijaneBaza danych, a następnie wybierz swoją bazę danych HubSpot.
    • Kliknij menu rozwijaneSchemat, a następnie wybierzschemat, którego chcesz użyć:
      • V2_LIVE: schemat bieżący oparty na bezpiecznych widokach danych HubSpot. Dane w tym schemacie są aktualizowane maksymalnie co 15 minut. W przypadku zapytań do dużego zbioru 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.
      • V2_DAILY (BETA): schemat dzienny do wykonywania zapytań do danych opartych na tabelach. Dane w tym schemacie są aktualizowane raz dziennie. Użycie tego schematu spowoduje szybsze wykonywanie zapytań i jest zalecane do wykonywania zapytań bezpośrednio w Snowflake.

      snowflake-worksheet-settings-window0

Po skonfigurowaniu środowiska można wykonywać zapytania do danych HubSpot bez konieczności ręcznego dodawania typu bazy danych lub schematu do zapytań.

Aby ręcznie dodać bazę danych i typ schematu do zapytań, należy dodać nazwę bazy danych, a następnie schemat na początku pola FROM. Na przykład:


SELECT objectTypeId, objectId
FROM hubspot_share_name.V2_LIVE.object_with_object_properties
WHERE objectTypeId = '0-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: obiekty standardowe i niestandardowe, takie jak kontakty, firmy, produkty.
  • Rekordy: indywidualnerekordy , takie jak indywidualny kontakt lub firma.
  • Stowarzyszenia: wszystkie dostępne typy as ocjacji i aktualnie powiązane rekordy.
  • Właściciele: użytkownicy na koncie HubSpot, w odniesieniu do rekordów, których są właścicielami.
  • Rurociągi:rurociągi transakcji i biletów, w tym etapy rurociągu.
  • Nieruchomości: właściwości i ich wartości w rekordach CRM, w tym historia właściwości.
  • 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 HubSpot (BETA).

Dowiedz się więcej o Model danych CRM w HubSpot.

Ograniczanie i porządkowanie zwracanych danych

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


SELECT objectTypeId, objectId, properties
FROM object_with_object_properties
WHERE objectTypeId = '0-1'
ORDER BY objectId
LIMIT 10;

Zapytania o obiekty

Poniżej dowiesz się, jak odpytywać dane z określonych obiektów i rekordów HubSpot oraz jakie dane są zwracane.

W zapytaniach można używać następujących identyfikatorów obiektów:

Nazwa obiektu ObjectTypeId
Kontakty 0-1
Firmy 0-2
Oferty 0-3
Zaręczyny 0-4
Bilety 0-5
Pozycje linii. 0-8

Obiekty niestandardowe otrzymują identyfikator w momencie tworzenia i są oznaczane jako2-unique_ID. Na przykład2-12345. Dowiedz się więcej o definicjach typu obiektu i zdarzenia.

obiekt_z_właściwościami_obiektu

Ten widok zawiera dane z rekordów HubSpot. Zapytania do tej tabeli zwracają jeden wiersz dla każdego rekordu w obrębie obiektu (np. wszystkie rekordy kontaktów w obiekcie kontakty). Wszystkie właściwości przechowywane są w kolumnie Właściwości, która jest kolumną Wariant płatka śniegu / JSON kolumna.

Ten widok może zwracać 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 majątkowe rekordu.
AKTUALIZACJA Znacznik czasu 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 płatek Snowflake.

Przykład 1

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

Zapytanie ofertowe:


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

Uzyskaj nazwę i etap maksymalnie trzech transakcji.

Zapytanie ofertowe:


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
2021-10-12 13:49:35.219
2021-10-12 13:49:35.219
321740651 Nazwa transakcji 1
2021-10-12 13:49:35.219
2021-10-12 13:49:35.219
98392101 Nazwa transakcji 1
2021-10-12 13:49:35.219
2021-10-12 13:49:35.219

obiekty

Widok ten jest podzbiorem danych w tabeli object_with_object_properties. Każdy zwrócony wiersz zwraca ID obiektu dla każdego rekordu. Widok ten zwraca tylko istniejące rekordy. Usunięcie rekordu w HubSpot spowoduje usunięcie go z tego widoku.

Widok ten może być przydatny, jeśli konto zawiera dużą ilość danych, co powoduje, że object_with_object_properties działa wolniej. Użycie tej tabeli wraz z tabelą object_properties pozwala na replikację danych w object_with_object_properties, przy zachowaniu kontroli nad tym, które właściwości są zwracane.

Ten widok może zwracać 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).
INGESTEDAT Znacznik czasu Data i godzina ostatniego pobrania danych przez płatek Snowflake. Dowiedz się więcej o typach danych kolumn.

Przykład 1

Wyświetlenie wszystkich rekordów kontaktów.

Zapytanie ofertowe:


SELECT objectTypeId, objectId
FROM obiekty
WHERE objectTypeId = '0-1'


Zwroty:

OBJECTTYPEID OBJECTID
0-1 36721864
0-1 103580363
0-1 56047670
... ...

właściwości_obiektu

Tabela ta jest podzbiorem tabeli object_with_object_properties. Każdy wiersz zawiera bieżącą 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 danej właściwości, wiersz zostanie wyświetlony z pustym ciągiem znaków lub nie zostanie wyświetlony w ogóle.

Tabela ta może być przydatna, jeśli konto zawiera dużą ilość danych, przez co object_with_object_properties działa wolniej. Użycie tej tabeli wraz z tabelą object_properties pozwala na replikację danych w object_with_object_properties, jednocześnie kontrolując, które właściwości są zwracane.

Ten widok może zwracać 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).
NAZWA Varchar Nazwa nieruchomości.
WARTOŚĆ Znacznik czasu Wartość nieruchomości.
AKTUALIZACJA Znacznik czasu 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 płatek Snowflake.

Przykład 1

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

Zapytanie ofertowe:


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 imię i nazwisko Brian
0-1 10401 miasto Dublin
0-1 10401 lastname Gallagher
0-1 23451 imię i nazwisko Fernando
0-1 23451 lastname Fierro
0-1 25751 imię i nazwisko Charles
... ... ... ...

Przykład 2

Pobierz imię, nazwisko i etap cyklu życia dla wszystkich kontaktów, a następnie połącz je w jeden wiersz dla każdego kontaktu. W tym przykładzie zastosowano składnię SQL PIVOT.

Zapytanie ofertowe:


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 IMIĘ I NAZWISKO 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 widok zawiera historyczne wartości nieruchomości. Dla kontaktów zawiera 45 ostatnich wartości. Dla wszystkich innych obiektów zawiera 20 ostatnich wartości. Wyświetla wiersz dla każdej historycznej wartości właściwości. Aktualna wartość właściwości jest określana przez ostatni znacznik czasu UPDATEDAT w historii właściwości.

Ten widok może zwracać 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).
NAZWA Varchar Nazwa nieruchomości.
WARTOŚĆ Znacznik czasu Wartość nieruchomości.
AKTUALIZACJA Znacznik czasu Data i godzina ostatniej aktualizacji danych w HubSpot. Dowiedz się więcej o typach danych kolumn.
INGESTEDAT Znacznik czasu Data i godzina ostatniego pobrania danych przez płatek Snowflake.

Przykład 1

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

Zapytanie ofertowe:


SELECT objectId, name, value, timestamp
FROM object_properties_history
WHERE objectTypeId = '0-1'
AND objectId = 585
AND name = 'hs_predictivescoringtier'
ORDER BY timestamp DESC;


Zwroty:

OBJECTTYPEID OBJECTID IMIĘ I NAZWISKO 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
... ... ... ... ...

Przykład 2

Uzyskaj bieżącą nazwę wszystkich kontaktów, które kiedykolwiek miały etap cyklu życia Subskrybent.

Zapytanie ofertowe:


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 = 'subskrybent'
);


Zwroty:

OBJECTID IMIĘ I NAZWISKO LASTNAME
54325098 Hobbes Baron
96805401 Milo Złoto
6922028 Henry Riley
... ... ...

Zapytania dotyczące stowarzyszenia

Poniżej można dowiedzieć się, w jaki sposób zadawać pytania o skojarzenia, np. jakie są dostępne typy skojarzeń między obiektami oraz jakie rekordy są aktualnie skojarzone.

definicje_stowarzyszenia

Ten widok zawiera informacje o wszystkich dostępnych typach asocjacji pomiędzy obiektami HubSpot, po jednym wierszu dla każdego typu asocjacji. Możesz połączyć tę tabelę z tabelą asocjacji, aby uzyskać informacje o asocjacjach specyficznych dla danego rekordu.

Może istnieć wiele typów asocjacji pomiędzy tymi samymi obiektami. Główny typ asocjacji, czyli typ wyświetlany w HubSpot podczas kojarzenia rekordów, wykorzystuje asocjację, w której wartość ISMAINASSOCIATIONDEFINITION jest prawdziwa.

Ten widok może zwracać następujące kolumny:

Nazwa kolumny Typ Opis
COMBINEDASSOCIATIONTYPEID Varchar Unikalny identyfikator definicji stowarzyszenia.
KATEGORIA Varchar Źródło typu asocjacji. Jedno z: HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED
ID Numer Identyfikator definicji stowarzyszenia w ramach jego kategorii.
FROMOBJECTTYPEID Varchar Identyfikator obiektu, który jest źródłem definicji asocjacji.
TOOBJECTTYPEID Varchar Identyfikator obiektu, który jest miejscem docelowym definicji asocjacji.
NAZWA Varchar Nazwa definicji stowarzyszenia.
LABEL Varchar Etykieta definicji stowarzyszenia.
DEFINICJA GŁÓWNEGO STOWARZYSZENIA Boolean Czy definicja asocjacji jest typem głównym. Jeśli jest to prawda, definicja ta jest wyświetlana przez HubSpot na powiązanych rekordach.
INGESTEDAT Znacznik czasu Data i godzina ostatniego pobrania danych przez płatek Snowflake. Dowiedz się więcej o typach danych kolumn.

Przykład 1

Wyświetlanie typów skojarzeń dostępnych na koncie.

Zapytanie ofertowe:


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_UMOWY
0-5 0-3 0-2 DEAL_DO_FIRMY
... ... ... ...

Przykład 2

Wyświetlanie dostępnych typów powiązań między transakcjami a firmami.

Zapytanie ofertowe:


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 DEAL_DO_FIRMY
0-271 0-3 0-2 DEAL_TO_PRIMARY_COMPANY
0-341 0-3 0-2 DEAL_TO_COMAPNY_UNLABELED

stowarzyszenia

Widok ten zawiera informacje o skojarzeniach pomiędzy poszczególnymi rekordami. Każdy wiersz reprezentuje asocjację z jednego obiektu do drugiego. Wiersze mogą być obecne w tej tabeli, nawet jeśli rekordy, do których się odnoszą, zostały usunięte. Można sprawdzić, czy rekordy istnieją, łącząc się z tabelą Obiekty.

Ten widok może zwracać następujące kolumny:

Nazwa kolumny Typ Opis
COMBINEDASSOCIATIONTYPEID Varchar Unikalny identyfikator definicji stowarzyszenia.
FROMOBJECTID Numer Identyfikator obiektu źródłowego.
TOOBJECTID Numer Identyfikator obiektu docelowego.
INGESTEDAT Znacznik czasu Data i godzina ostatniego pobrania danych przez płatek Snowflake. Dowiedz się więcej o typach danych kolumn.

Przykład 1

Odzyskaj wszystkie powiązane transakcje i kontakty.

Zapytanie ofertowe:


SELECT combinedAssociationTypeId, fromObjectId, toObjectId
FROM stowarzyszenia
WHERE combinedAssociationTypeId = '0-5'


Zwroty:

POŁĄCZONY TYP STOWARZYSZENIA FROMOBJECTID TOOBJECTID
0-5 6626541373 233620335
0-5 6616436082 3866015468
0-5 6690805943 7132752747
... ... ...

Przykład 2

Pobierz wszystkie bilety powiązane z określonym kontaktem (identyfikator kontaktu: 3005).

Zapytanie ofertowe:


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 (identyfikator kontaktu: 4464). Zamiast kodować na sztywno combinedAssociationTypeId, ten przykład łączy się z association_definitions.

Zapytanie ofertowe:


SELECT combinedAssociationType, fromObjectId, toObjectId,
FROM stowarzyszenia
WHERE
combinedAssociationTypeId = (
SELECT combinedAssociationTypeId
FROM association_definitions
WHERE fromObjectTypeId = '0-1'
AND toObjectTypeId = '0-3'
AND isMainAssociationDefinition)
AND fromObjectId = 4464;


Zwroty:

POŁĄCZONY TYP STOWARZYSZENIA FROMOBJECTID TOOBJECTID
0-5 6626541373 233620335

Zapytania właściciela

właściciele

Ten widok 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 kontekstu. Oba identyfikatory mogą być używane do identyfikacji tego samego użytkownika.

Ten widok może zwracać następujące kolumny:

Nazwa kolumny Typ Opis
OWNERID Numer Identyfikator właściciela użytkownika.
IDENTYFIKATOR UŻYTKOWNIKA Numer Identyfikator użytkownika. Użytkownicy z wartością NULL w tej kolumnie zostali usunięci.
EMAIL Varchar Adres e-mail użytkownika.
IMIĘ I NAZWISKO Varchar Imię użytkownika.
LASTNAME Varchar Nazwisko użytkownika.
ISACTIVE Boolean Czy użytkownik został usunięty.
CREATEDAT Znacznik czasu Data i godzina utworzenia użytkownika w systemie HubSpot. Więcej informacji można znaleźć w części Typy danych kolumn.
AKTUALIZACJA Znacznik czasu Data i godzina ostatniej aktualizacji użytkownika w HubSpot. Więcej informacji można znaleźć w części Typy danych kolumn.

Przykład 1

Odzyskaj wszystkich użytkowników. Filtr WHERE isActive = true usuwa usuniętych użytkowników ze zwracanych danych.

Zapytanie ofertowe:


SELECT ownerId, userId, email, firstname, lastname
FROM właściciele
WHERE isActive = true


Zwroty:

OWNERID ACTIVEUSERID EMAIL IMIĘ I NAZWISKO LASTNAME
29584574 4621126 233620335 Hobbes Baron
30532717 4874784 3866015468 Pablo Walters
30580321 925511 7132752747 Milo Złoto
... ... ... ... ...

Przykład 2

Umożliwia wyszukanie określonego właściciela na podstawie jego identyfikatora.

Zapytanie ofertowe:


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


Zwroty:

OWNERID ACTIVEUSERID EMAIL IMIĘ I NAZWISKO LASTNAME
29584574 4621126 233620335 Hobbes Baron

Przykład 3

Uzyskaj 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 contact hubspot_owner_id.


SELECT
contact.objectId contact_id,
contact.properties:firstname::string contact_firstname,
contact.properties:lastname::string contact_lastname,
contact.properties:hubspot_owner_id::number contact_hubspot_owner_id,
owner.firstname owner_firstname,
owner.lastname owner_lastname,
owner.email owner_email
FROM object_with_object_properties kontakt
inner join owner owner on contact.properties:hubspot_owner_id::number = owner.ownerId
where objectTypeId = '0-1';


Zwroty:

CONTACTID CONTACT_FIRSTNAME CONTACT_LASTNAME CONTACT_HUBSPOT_OWNER_ID OWNER_FIRSTNAME WŁAŚCICIEL_OSTATNIE IMIĘ I NAZWISKO WŁAŚCICIEL_EMAIL
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 można dowiedzieć się, jak wyszukiwać dane dotyczące potoku transakcji i biletów, takie jak dostępne potoki na koncie użytkownika oraz ich etapy.

Dane te można łączyć z danymi obiektów, aby uzyskać pełny obraz rurociągów. Przykładowo, łącząc dane object_with_object_properties z danymi pipelines, można zadawać zapytania dotyczące transakcji i ich rurociągów.

rurociągi

Ten widok zawiera informacje o rurociągach transakcji i biletów na koncie użytkownika. Każdy zwrócony wiersz reprezentuje pojedynczy potok.

Tabela ta może zawierać następujące kolumny:

Nazwa kolumny Typ Opis
PIPELINEID Varchar Identyfikator rurociągu.
OBJECTTYPEID Varchar Identyfikator 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.
ARCHIWUM Boolean Czy rurociąg został usunięty.
CREATEDAT Znacznik czasu Kiedy rurociąg został utworzony.
AKTUALIZACJA Znacznik czasu Data i godzina ostatniej aktualizacji danych w HubSpot. Dowiedz się więcej o typach danych kolumn.
INGESTEDAT Znacznik czasu Data i godzina ostatniego pobrania danych przez płatek Snowflake.

Przykład 1

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

Zapytanie ofertowe:


SELECT objectTypeId, pipelineId, label
FROM rurociągi
WHERE objectTypeId = '0-3'
AND not archived
ORDER BY displayorder;


Zwroty:

OBJECTTYPEID PIPELINEID LABEL
0-3 1bed503c-37f7-4f51-9d40-7598902673f4 Linia sprzedaży
0-3 12659678 Licencje Rurociąg
0-3 75e28846-ad0d-4be2-a027-5e1da6590b98 Nowe przedsięwzięcia
... ... ...

Przykład 2

Wyszukuje transakcje w ramach określonego rurociągu. Łączy object_with_object_properties i rurociągi.

Zapytanie ofertowe:


SELECT

deals.objectId deal_id,
deals.properties:dealname::varchar deal_name,
pipelines.label pipeline_name
FROM object_with_object_properties deals
INNER JOIN rurociągi
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 NAZWA RUROCIĄGU (PIPELINE_NAME)
605140072 Globalna rejestracja Meowmix Linia sprzedaży
605457408 Zmiana marki Friskies Linia sprzedaży
604362473 Krok po kroku Tworzenie aplikacji Linia sprzedaży

etapy rurociągu

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

Tabela ta może zawierać następujące kolumny:

Nazwa kolumny Typ Opis
PIPELINEID Varchar Identyfikator rurociągu.
OBJECTTYPEID Varchar Identyfikator 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.
ARCHIWUM Boolean Czy rurociąg został usunięty.
AKTUALIZACJA Znacznik czasu Data i godzina ostatniej aktualizacji danych w HubSpot. Dowiedz się więcej o typach danych kolumn.
INGESTEDAT Znacznik czasu Data i godzina ostatniego pobrania danych przez płatek Snowflake.

Przykład 1

Uzyskaj etapy rurociągu dla rurociągu transakcji o nazwieSales pipeline.

Zapytanie ofertowe:


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 Kontakt:
941650 941652 Planowane spotkanie
941650 941653 Faktura wysłana
... ... ...

Przykład 2

Pobierz wszystkie transakcje i etapy ich przygotowania.

Zapytanie ofertowe:


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 NAZWA RUROCIĄGU (PIPELINE_NAME) NAZWA_STAŻU RUROCIĄGU
605140072 Globalna rejestracja Meowmix Linia sprzedaży Umowa wysłana
605457408 Zmiana marki Friskies Linia sprzedaży Planowane spotkanie
604362473 Krok po kroku Tworzenie aplikacji Linia sprzedaży Podpisanie umowy
... ... ... ...

Zapytania dotyczące nieruchomości

definicje_własności

Ten widok 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 określaniu wartości w danych object_properties i events.

Określone właściwości można zidentyfikować, łącząc ich identyfikator typu obiektu i nazwę. Podobne informacje można uzyskać za pomocą interfejsu API właściwości.

Ten widok może zwracać następujące kolumny:

Nazwa kolumny Typ Opis
OBJECTYPEID Varchar Identyfikator obiektu, do którego odnosi się zdarzenie.
NAZWA Varchar Wewnętrzna nazwa właściwości.
LABEL Varchar Etykieta obiektu.
OPIS Varchar Opis obiektu.
TYP 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. pole wyboru, select).
DISPLAYORDER Numer Kolejność wyświetlania obiektu.
GROUPNAME Varchar Nazwa grupy właściwości.
OPCJE Wariant W przypadku właściwości wyliczeniowych - tablica opcji właściwości wraz z atrybutami każdej opcji (np. kolejność wyświetlania, etykieta).
CREATEDUSERID Numer Identyfikator użytkownika, który utworzył obiekt.
REFERENCEDOBJECTTYPE Varchar Typ obiektu, do którego odwołuje się właściwość. Właściwości typu Owner zwrócą wartość OWNER.
OBLICZONA Boolean Czy właściwość jest właściwością obliczaną.
OPCJE ZEWNĘTRZNE 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że być ustawiona tylko podczas tworzenia właściwości za pomocą interfejsu API.
UKRYTE Boolean Czy właściwość jest ukryta w HubSpot.
SHOWCURRENCYSYMBOL Boolean Określenie, 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.
HUBSPOTDEFINICJA Boolean Czy właściwość została utworzona przez HubSpot, czy też przez użytkownika.
ARCHIWUM Boolean Informacja, czy właściwość została usunięta.
CREATEDAT Znacznik czasu Data i godzina utworzenia właściwości w HubSpot.
AKTUALIZACJA Znacznik czasu Data i godzina ostatniej aktualizacji danych w HubSpot. Dowiedz się więcej o typach danych kolumn.
INGESTEDAT Znacznik czasu Data i godzina ostatniego pobrania danych przez płatek Snowflake.

Przykład 1

Uzyskaj nazwy i opisy wszystkich właściwości kontaktu.

Zapytanie ofertowe:


SELECT nazwa, etykieta, opis
FROM property_definitions
WHERE objectTypeId = '0-1'


Zwroty:

NAZWA LABEL OPIS
entered_sql_stage Rozpoczęto etap SQL Rozpoczęcie liczenia dni etapu SQL.
nazwa_pierwszego_zdarzenia_konwersji
Pierwsze nawrócenie Pierwszy formularz przesłany przez ten kontakt.
adres Adres ulicy Adres osoby kontaktowej.

Zapytania o zdarzenia

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

Dostępne wydarzenia obejmują:

  • Zdarzenia związane z kliknięciem reklamy(events_ad_clicked)
  • Otwarcia i kliknięcia wiadomości e-mail(events_opened_email_V2, events_clicked_link_in_email_v2 itd.)
  • Analityka internetowa(events_visited_page)

Zdarzenia można zidentyfikować, łą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 będą zwracać następujące kolumny:

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

  • wystąpiły na stronie
  • nastąpiło w dniu na stronie

Kolumny te zastąpią kolumny occuredat i occuredatdateint 24 kwietnia 2022 roku. W tym dniu stare kolumny nie będą już dostępne, a próby zapytania do tabeli lub widoku zawierającego zdarzenia z użyciem tych kolumn zakończą się niepowodzeniem. Dowiedz się więcej o zmianach w udziałach danych Snowflake.



Nazwa kolumny Typ Opis
EVENTTYPEID Varchar Identyfikator rurociągu.
ID Varchar Identyfikator obiektu, który może zawierać rurociąg (np. oferty lub bilety).
OBJECTTYPEID Varchar Typ obiektu, który zrealizował zdarzenie. Na przykład kliknięcie łącza do wiadomości e-mail spowoduje wyświetlenie w tej kolumnie wartości0-1, reprezentującej obiekt kontakty.
OBJECTID Numer Identyfikator rekordu, który zakończył zdarzenie.
OCCURREDAT Znacznik czasu Kiedy nastąpiło zdarzenie.

NASTĄPIŁO W DNIU NA STRONIE

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 zamiast tej liczby można użyć znacznika czasu OCCURREDAT.

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 zamiast tej liczby można użyć znacznika czasu OCCURREDAT.

Uwaga: ta kolumna zostanie wycofana z użycia 24 kwietnia 2022 r. i zastąpiona przez OCCURREDATDATEINT.

OCCUREDAT Znacznik czasu

Kiedy nastąpiło zdarzenie.

Uwaga: kolumna ta zostanie wycofana z użycia 24 kwietnia 2022 r. i zastąpiona kolumną OCCURREDAT.

INGESTEDAT Znacznik czasu Data i godzina ostatniego pobrania danych przez płatek Snowflake. Dowiedz się więcej o typach danych kolumn.
WŁASNOŚĆ_* 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 ofertowe:


SELECT eventTypeId, objectTypeId, objectId, occuredAt, 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

Uzyskaj 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 ofertowe:


SELECT
click.timestamp 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 CONTACT_FIRSTNAME CONTACT_LASTNAME
2019-01-04 22:35:41.264 https://help.website.com/articles/tutorial/how-to-use-email-tool?utm_source=hs_automation&utm_medium=email&utm_content=68042217 Hobbes Baron
2018-11-08 09:37:41.400 https://www.website.net/webinar-case-study?utm_source=hs_automation&utm_medium=email&utm_content=55200164 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
... ... ... ...

definicje_typu_obiektu_i_zdarzenia

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

Ten widok może zwracać następujące kolumny:

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

Przykład 1

Pobieranie wszystkich obiektów i zdarzeń dostępnych na koncie HubSpot.

Zapytanie ofertowe:


SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;


Zwroty:

OBJECTTYPEID FULLYQUALIFIEDNAME
0-1 KONTAKT
0-2 FIRMA
0-3 DEAL
0-4 ZAANGAŻOWANIE
0-5 BILET
0-8 LINE_ITEM
0-11 KONWERSACJA
... ...

Zapytania do list (BETA)

Poniżej dowiesz się, jak przeprowadzać kwerendy na listach, takich jak dostępne listy kontaktów i firm oraz rekordy zawarte na tych listach.

wymienia

Ten widok zawiera informacje o listach kontaktów i firm HubSpot. Zwraca jeden wiersz dla każdej listy, 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 (zobacz list_membership).

Ten widok może zwracać 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 odpowiada identyfikatorowi w adresie URL listy w HubSpot.
LISTNAME Varchar Nazwa listy.
LISTSIZE Numer Liczba rekordów na liście.
CREATEDBYUSERID Numer Identyfikator użytkownika, który utworzył listę.
CREATEDAT Znacznik czasu Kiedy lista została utworzona w HubSpot.
UPDATEDBYUSERID Numer Identyfikator użytkownika, który ostatnio aktualizował listę.
AKTUALIZACJA Znacznik czasu Data i godzina ostatniej aktualizacji daty w HubSpot. Dowiedz się więcej o typach danych kolumn.
INGESTEDAT Znacznik czasu Data i godzina ostatniego pobrania danych przez płatek Snowflake.

Przykład 1

Wyświetlanie wszystkich list kontaktów.

Zapytanie ofertowe:


SELECT listId, listName, listSize
FROM lists
WHERE objectTypeId = '0-1';


Zwroty:

LISTID LISTNAME LISTSIZE
118131 Cotygodniowe działania zewnętrzne 103
66156 Subskrybenci bloga 455
771852 Najwięksi abonenci 2021 37
... ... ...

Przykład 2

Uzyskaj określoną listę kontaktów o nazwie Najlepsi abonenci 2021.

Zapytanie ofertowe:


SELECT listId, listName, listSize
FROM lists
WHERE objectTypeId = '0-1'
AND
listName = 'Najlepsi subskrybenci 2021';


Zwroty:

LISTID LISTNAME LISTSIZE
771852 Najwięksi abonenci 2021 37

list_membership

Ten widok zawiera informacje o tym, które rekordy są członkami poszczególnych list, przy czym na każdy rekord listy przypada jeden wiersz. Na przykład jeśli masz listę subskrybentów bloga z 500 kontaktami, tabela zwróci 500 wierszy.

Zawiera tylko identyfikatory list oraz identyfikatory obiektów. Aby uzyskać więcej informacji, połącz się z tabelą Listy.

Ten widok może zwracać następujące kolumny:

Nazwa kolumny Typ Opis
LISTID Varchar Identyfikator listy. Łączy się z kolumną HS_LIST_ID w tabeli lists.
OBJECTID Varchar Identyfikator rekordu na liście.
AKTUALIZACJA Znacznik czasu Data i godzina ostatniej aktualizacji danych w HubSpot. Dowiedz się więcej o typach danych kolumn.
INGESTEDAT Znacznik czasu Data i godzina ostatniego pobrania danych przez płatek Snowflake.

Przykład 1

Uzyskaj identyfikatory wszystkich kontaktów z listyTop subskrybenci 2021.

Zapytanie ofertowe:


SELECT objectId
FROM list_memberships
INNER JOIN lists
ON list_memberships.listId = lists.listId
WHERE lists.objectTypeId = '0-1'
AND lists.name = 'Najlepsi subskrybenci 2021';


Zwroty:

OBJECTID
54325098
96805401
6922028
...

Przykład 2

Pobieranie imion i nazwisk szczegółów kontaktów z listy Top subscribers 2021.

Zapytanie ofertowe:


SELECT
contact.objectId AS objectid,
contact.properties:firstname::string AS firstname,
contact.properties:lastname::string AS lastname
FROM object_with_object_properties contact
INNER JOIN list_memberships ON contact.objectId = list_memberships.objectId
INNER JOIN lists ON list_memberships.listId = lists.listId
WHERE
contact.objectTypeId = '0-1'
AND lists.objectTypeId = '0-1' AND lists.objectTypeId = '0-1'
AND lists.listName = 'Najlepsi subskrybenci 2021'


Zwroty:

OBJECTID IMIĘ I NAZWISKO OSTATNIE IMIĘ
54325098 Hobbes Baron
96805401 Milo Złoto
6922028 Henry Riley
... ... ...

Typy danych kolumn

Podczas wykonywania zapytań do danych w Snowflake kolumny, które są zwracane, zależą od danych, do których kierujesz zapytanie. Kolumny dostępne dla danej tabeli lub widoku w Snowflake można wyświetlić, wybierając widokna lewym pasku bocznym.

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 FROMOBJECTID i TOOBJECTID:


SELECT
fromObjectTypeId, toObjectTypeId
FROM association_definitions

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, można znaleźć 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ć obiekt niestandardowy na koncie użytkownika. W przypadku list jest to typ listy (np. kontakt lub firma). Wszystkie identyfikatory obiektów i zdarzeń na koncie można odszukać 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 identyfikatora typu obiektu, jak i identyfikatora obiektu.
  • INGESTEDAT: znacznik czasowy, 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 HubSpot, znacznik czasu przyjęcia wiersza może zostać zaktualizowany, 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 przyjęcia. Ponadto, jeśli przepływ danych kopiuje dane codziennie, zaleca się kopiowanie danych z dwóch poprzednich 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ą odpowiadać znacznikom czasu w HubSpot. Na przykład czas wyświetlany w HubSpot dla daty utworzenia rekordu będzie taki sam, jak czas wyświetlany w kolumnie CREATEDAT w Snowflake. Nie są one bezpośrednio związane ze znacznikiem czasu przyjęcia danych i nie zaleca się opierania procesów ETL na tych właściwościach.
  • COMBINEDASSOCIATIONTYPE: wartość VARCHAR, która jednoznacznie identyfikuje definicję asocjacji.
Was this article helpful? *
This form is used for documentation feedback only. Learn how to get help with HubSpot.