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: listopada 8, 2021

Dotyczy:

Operacje Hub Enterprise

Po połączeniu Snowflake z kontem HubSpot możesz korzystać z funkcji Udostępnianie danych Snowflake, aby odpytywać dane 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 z nimi rekordy.
  • Właściciele: użytkownicy na Twoim 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.
  • Właściwoś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 móc zadawać pytania do danych HubSpot w Snowflake, należy wybrać magazyn, bazę danych i schemat, do którego mają być kierowane zapytania. 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 arku sza.

    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 naSchemat z menu rozwijanego, a następnie wybierz schemat, którego chcesz użyć:
      • 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 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

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, 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.
  • Asocjacje: wszystkie dostępne typy as ocjacji i aktualnie powiązane z nimi rekordy.
  • Właściciele: użytkownicy na Twoim 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.
  • Właściwoś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żesz kontrolować ilość zwracanych danych, jak również kolejność ich zwracania, poprzez włączenie do zapytania limitu oraz 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 ID 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, wraz z danymi, które zostaną zwrócone.

W zapytaniu można użyć 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 w wierszu 0-8

Obiekty niestandardowe będą miały przypisany identyfikator w momencie tworzenia i będą identyfikowane jako2-unique_ID. Na przykład2-12345. Dowiedz się więcej o definicjach object_and_event_type_definitions.

obiekt_z_właściwościami_obiektu

Ten widok zawiera dane z Twoich 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 contacts). Wszystkie właściwości przechowywane są w kolumnie Properties, która jest kolumną Wariant płatka śniegu / JSON kolumna.

Widok ten 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 Timestamp Data i godzina ostatniej aktualizacji rekordu 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 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

Uzyskaj nazwę i etap maksymalnie trzech transakcji.

Zapytanie:


SELECT

objectId,
properties:dealname::string AS dealname,
properties:dealstage::string AS dealstage,
properties:amount::number AS dealamount
FROM 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. Gdy rekord zostanie usunięty w HubSpot, zostanie usunięty z tego widoku.

Ten widok 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.

Widok ten 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 Timestamp Data i godzina ostatniego pobrania danych przez płatek Snowflake. Dowiedz się więcej o typach danych kolumn.

Przykład 1

Odzyskaj wszystkie rekordy kontaktów.

Zapytanie:


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 aktualną wartość właściwości ustawioną na danym rekordzie. Na przykład, kontakt będzie miał jeden wiersz dla swojej właściwości Imię i jeden wiersz dla swojej właściwościNazwisko. Jeśli rekord nie ma wartości dla właściwości, wiersz pojawi się z pustym łańcuchem lub nie pojawi się w ogóle.

Ta tabela może być przydatna, jeśli twoje konto ma dużą ilość danych, co powoduje, że object_with_object_properties działa wolniej. Użycie tej tabeli 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.

Widok ten 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ŚĆ Timestamp Wartość nieruchomości.
AKTUALIZACJA Timestamp Data i godzina ostatniej aktualizacji rekordu 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

Uzyskaj imię, nazwisko i miasto dla wszystkich kontaktów.

Zapytanie:


SELECT objectTypeId, objectId, nazwa, wartość
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, etap cyklu życia dla wszystkich kontaktów i połącz je w jeden wiersz dla każdego kontaktu. Ten przykład używa 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 PIERWSZE 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 określana jest przez ostatni znacznik czasu UPDATEDAT w historii właściwości.

Widok ten 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ŚĆ Timestamp Wartość nieruchomości.
AKTUALIZACJA Timestamp Data i godzina ostatniej aktualizacji danych w HubSpot. Dowiedz się więcej o typach danych kolumn.
INGESTEDAT Timestamp Data i czas ostatniego pobrania danych przez Snowflake.

Przykład 1

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

Zapytanie:


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 PIERWSZE 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 aktualną nazwę wszystkich kontaktów, które kiedykolwiek miały etap cyklu życia Abonent.

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


Zwroty:

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

Kwerendy stowarzyszeniowe

Poniżej dowiesz się, jak wykonać zapytanie o asocjacje, czyli jakie są dostępne typy asocjacji pomię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, który jest typem wyświetlanym w HubSpot, gdy rekordy są powiązane, używa asocjacji, w której ISMAINASSOCIATIONDEFINITION ma wartość true.

Widok ten 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 ID obiektu, który jest źródłem definicji asocjacji.
TOOBJECTTYPEID Varchar ID 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 tą, którą HubSpot wyświetla na powiązanych rekordach.
INGESTEDAT Timestamp 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 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_PRZEDSIĘBIORSTWA
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 TRANSAKCJA_DO_FIRMY
... ... ... ...

Przykład 2

Wywołaj dostępne typy asocjacji pomiędzy transakcjami i 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 TRANSAKCJA_DO_FIRMY
0-271 0-3 0-2 DEAL_DO_PODSTAWOWEJ_FIRMY
0-341 0-3 0-2 DEAL_DO_COMAPNY_UNLABELED

stowarzyszenia

Widok ten zawiera informacje o powiązaniach pomiędzy poszczególnymi rekordami. Każdy wiersz reprezentuje skojarzenie jednego obiektu z innym obiektem. 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ą poprzez połączenie z tabelą obiekty.

Widok ten 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 Timestamp 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:


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

Odzyskaj wszystkie bilety powią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 oferty powiązane z konkretnym kontaktem (ID kontaktu: 4464). Zamiast twardego kodowania combinedAssociationTypeId, ten przykład łączy się z association_definitions.

Zapytanie:


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

właściciele

Ten widok zawiera informacje o użytkownikach na Twoim 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.

Widok ten może zwracać następujące kolumny:

Nazwa kolumny Typ Opis
OWNERID Numer Identyfikator właściciela użytkownika.
USERID Numer Identyfikator użytkownika. Użytkownicy z NULL w tej kolumnie zostali usunięci.
EMAIL Varchar Adres e-mail użytkownika.
PIERWSZE IMIĘ I NAZWISKO Varchar Imię użytkownika.
LASTNAME Varchar Nazwisko użytkownika.
ISACTIVE Boolean Czy użytkownik został usunięty.
CREATEDAT Timestamp Data i godzina utworzenia użytkownika w systemie HubSpot. Aby uzyskać więcej informacji, zobacz Typy danych kolumn.
AKTUALIZACJA Timestamp Data i godzina ostatniej aktualizacji użytkownika w HubSpot. Aby uzyskać więcej informacji, zobacz 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:


SELECT ownerId, userId, email, firstname, lastname
FROM owners
WHERE isActive = true


Zwroty:

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

Przykład 2

Wyszukuje określonego właściciela na podstawie jego identyfikatora.

Zapytanie:


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


Zwroty:

OWNERID ACTIVEUSERID EMAIL PIERWSZE IMIĘ I NAZWISKO 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ą 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 właściciele owner on contact.properties:hubspot_owner_id::number = owner.ownerId
where objectTypeId = '0-1';


Zwroty:

CONTACTID CONTACT_FIRSTNAME KONTAKT_NAZWISKO CONTACT_HUBSPOT_OWNER_ID OWNER_FIRSTNAME NAZWISKO_WŁAŚCICIELA 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 dowiesz się, jak wyszukiwać dane dotyczące potoku transakcji i biletów, takie jak dostępne potoki na Twoim koncie oraz ich etapy.

Dane te można łączyć z danymi obiektowymi, aby uzyskać pełny obraz rurociągów. Na przykład, można zapytać o transakcje i ich rurociągi, łącząc dane object_with_object_properties z danymi rurociągów.

rurociągi

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

Tabela ta może zwracać 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 Timestamp Kiedy rurociąg został utworzony.
AKTUALIZACJA Timestamp Data i godzina ostatniej aktualizacji danych w HubSpot. Dowiedz się więcej o typach danych kolumn.
INGESTEDAT Timestamp Data i czas ostatniego pobrania danych 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 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 Nowy biznes
... ... ...

Przykład 2

Odzyskaj 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.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
605140072 Globalna rejestracja Meowmix Linia sprzedaży
605457408 Rebranding Friskies Linia sprzedaży
604362473 Budowa aplikacji Fresh Step Linia sprzedaży

rurociąg_etapy

Widok ten zawiera informacje o poszczególnych etapach w obrębie rurociągu. Identyfikacja etapów odbywa się poprzez połączenie ID typu obiektu, ID rurociągu oraz ID etapu. Podczas łączenia z rurociągami należy użyć ID typu obiektu i ID rurociągu.

Tabela ta może zwracać 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 Timestamp Data i godzina ostatniej aktualizacji danych w HubSpot. Dowiedz się więcej o typach danych kolumn.
INGESTEDAT Timestamp Data i czas ostatniego pobrania danych przez Snowflake.

Przykład 1

Uzyskaj etapy rurociągu dla rurociągu transakcji o nazwieSales 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 etapy ich przygotowania.

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 rurociągi
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 NAZWA_STAŻU RUROCIĄGU
605140072 Globalna rejestracja Meowmix Linia sprzedaży Umowa wysłana
605457408 Rebranding Friskies Linia sprzedaży Planowane spotkanie
604362473 Budowa aplikacji Fresh Step Linia sprzedaży Podpisana umowa
... ... ... ...

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 definiowaniu wartości w danych object_properties i events.

Możesz zidentyfikować konkretne właściwości poprzez połączenie ich ID typu obiektu i nazwy. Podobne informacje można uzyskać za pomocą API właściwości.

Widok ten może zwracać następujące kolumny:

Nazwa kolumny Typ Opis
OBJECTYPEID Varchar ID obiektu, do którego odnosi się zdarzenie.
NAZWA Varchar Wewnętrzna nazwa nieruchomości.
LABEL Varchar Etykieta nieruchomości.
OPIS Varchar Opis nieruchomości.
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. checkbox, select).
DISPLAYORDER Numer Kolejność wyświetlania nieruchomości.
GROUPNAME Varchar Nazwa grupy właściwości.
OPCJE Wariant Dla właściwości wyliczeniowych, tablica opcji właściwości, łącznie z atrybutami każdej opcji (np. kolejność wyświetlania, etykieta).
CREATEDUSERID Numer Identyfikator użytkownika, który utworzył właściwość.
REFERENCEDOBJECTTYPE Varchar Typ obiektu, do którego odnosi się właściwość. Właściwości 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ć ustawione tylko podczas tworzenia właściwości przez API.
UKRYTE Boolean Czy właściwość jest ukryta w HubSpot.
SHOWCURRENCYSYMBOL Boolean Czy wartość właściwości number jest sformatowana jako waluta.
FORMFIELD Boolean Czy ta właściwość może być używana w formularzach.
READONLYDEFINITION Boolean Czy właściwość może być edytowana w HubSpot.
READONLYVALUE Boolean Czy wartość właściwości może być edytowana w HubSpot.
HUBSPOTDEFINICJA Boolean Czy właściwość została utworzona przez HubSpot, czy też przez użytkownika.
ARCHIWUM Boolean Czy właściwość została usunięta.
CREATEDAT Timestamp Data i godzina utworzenia właściwości w HubSpot.
AKTUALIZACJA Timestamp Data i godzina ostatniej aktualizacji danych w HubSpot. Dowiedz się więcej o typach danych kolumn.
INGESTEDAT Timestamp Data i czas ostatniego pobrania danych przez Snowflake.

Przykład 1

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

Zapytanie:


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


Zwroty:

NAZWA LABEL OPIS
entered_sql_stage Wszedł do etapu SQL Start liczenia dni etapu SQL.
nazwa_pierwszego_zdarzenia_konwersji
Pierwsza konwersja Pierwszy formularz przesłany przez ten kontakt.
adres Adres ulicy Adres osoby kontaktowej.

Zapytania dotyczące zdarzeń

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

Dostępne wydarzenia to:

  • Zdarzenia kliknięcia reklamy(events_ad_clicked)
  • Otwarcia i kliknięcia emaili(events_opened_email_V2, events_clicked_link_in_email_v2, etc.)
  • Analityka internetowa(events_visited_page)

Możesz zidentyfikować zdarzenia poprzez połączenie ich identyfikatora typu zdarzenia i ID. Kolumny, które są zwracane zależą od zdarzenia, z jedną kolumną dla każdej właściwości zdarzenia. Wszystkie zdarzenia zwrócą następujące kolumny:

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 w link email spowoduje wyświetlenie0-1 w tej kolumnie, reprezentującej obiekt kontakty.
OBJECTID Numer Identyfikator rekordu, który zakończył zdarzenie.
OCCUREDATDATEINT Numer Liczba reprezentująca czas wystąpienia zdarzenia. Zawiera te same dane, co kolumna OCCUREDAT, ale sformatowane jako liczba i używane jako część klucza klastra tabeli. W większości przypadków możesz użyć znacznika czasu OCCUREDAT zamiast tej liczby.
OCCUREDAT Timestamp Kiedy nastąpiło zdarzenie.
INGESTEDAT Timestamp 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:


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

Odzyskaj wszystkie zdarzenia kliknięcia w email według kontaktów, które kliknęły. Zapytanie to pobiera dane o kontaktach poprzez połączenie z object_with_object_properties.

Zapytanie:


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

Widok ten 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 Timestamp Data i godzina ostatniego pobrania danych przez płatek Snowflake. Dowiedz się więcej o typach danych kolumn.

Przykład 1

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

Zapytanie:


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 LINIA_ITEM
0-11 KONWERSACJA
... ...

Listy zapytań (BETA)

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

wymienia

Widok ten 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).

Widok ten 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 ID 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 Timestamp Kiedy lista została utworzona w HubSpot.
UPDATEDBYUSERID Numer Identyfikator użytkownika, który ostatnio aktualizował listę.
AKTUALIZACJA Timestamp Data i godzina ostatniej aktualizacji daty w HubSpot. Dowiedz się więcej o typach danych kolumn.
INGESTEDAT Timestamp Data i czas ostatniego pobrania danych przez Snowflake.

Przykład 1

Odzyskaj wszystkie listy kontaktów.

Zapytanie:


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


Zwroty:

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

Przykład 2

Odzyskaj określoną listę kontaktów o nazwie Top subskrybenci 2021.

Zapytanie:


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


Zwroty:

LISTID LISTNAME LISTSIZE
771852 Najlepsi abonenci 2021 37

lista_członkostwa

Widok ten zawiera informacje o tym, które rekordy są członkami poszczególnych list, z jednym wierszem na rekord na liście. Na przykład, jeśli masz listę subskrybentów bloga z 500 kontaktami, tabela zwróci 500 wierszy.

Zawiera tylko ID listy i ID obiektu. Aby uzyskać więcej informacji, połącz się z tabelą listy.

Widok ten 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 Timestamp Data i godzina ostatniej aktualizacji danych w HubSpot. Dowiedz się więcej o typach danych kolumn.
INGESTEDAT Timestamp Data i czas ostatniego pobrania danych przez Snowflake.

Przykład 1

Pobiera identyfikatory wszystkich kontaktów z listyTop subskrybenci 2021.

Zapytanie:


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 abonentów 2021

Zapytanie:


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.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 wyszukiwania danych w Snowflake kolumny, które są zwracane, zależą od danych, które są wyszukiwane. Możesz wyświetlić dostępne kolumny dla danej tabeli lub widoku w Snowflake, 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 są zawarte poniżej, znajdują się w definicjach poszczególnych widoków w artykule powyżej.

  • OBJECTTYPEID: wartość VARCHAR określająca typ obiektu. Np. 0-1 reprezentuje obiekt kontakty, 0-2 obiekt firmy, a 2-1232 może reprezentować obiekt niestandardowy na Twoim koncie. W zestawieniach jest to typ listy (np. kontakt lub firma). Wszystkie identyfikatory obiektów i zdarzeń w 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 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, zalecane jest oparcie zapytań na znaczniku czasowym ingestion. Dodatkowo, jeśli przepływ kopiuje dane codziennie, zaleca się kopiowanie danych z poprzednich dwóch dni, aby uwzględnić opóźnienia.
  • CREATEDAT i UPDATEDAT: logiczny znacznik czasu utworzenia lub aktualizacji danych w HubSpot, reprezentowany przez wartość TIMESTAMP_NTZ . Te znaczniki czasu będą odpowiadały 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 ze znacznikiem czasowym ingestion i nie jest zalecane opieranie procesów ETL na tych właściwościach.
  • COMBINEDASSOCIATIONTYPE: wartość VARCHAR, która w sposób jednoznaczny identyfikuje definicję asocjacji.