跳到內容
請注意::這篇文章的翻譯只是為了方便而提供。譯文透過翻譯軟體自動建立,可能沒有經過校對。因此,這篇文章的英文版本應該是包含最新資訊的管理版本。你可以在這裡存取這些內容。

查詢雪花中的HubSpot數據

上次更新時間: 二月 1, 2024

可与下列任何一种订阅一起使用,除非有说明:

Operations Hub Enterprise

將Snowflake連接到您的HubSpot帳戶後,您可以使用Snowflake的數據共享從您的Snowflake帳戶查詢HubSpot數據。

資料延遲和您的Snowflake帳戶區域

您將可以訪問每15分鐘更新一次的V2_LIVE模式,以及每天更新的V2_DAILY模式。

設定您的雪花環境

若要查詢雪花中的HubSpot資料,您需要選擇要查詢的倉庫、資料庫和架構。您可以將它們設定在工作表層級,以自動將它們包含在查詢中,也可以手動新增它們。

要在工作表層級選擇倉庫、資料庫和架構:

  • 在工作表頂行中,按一下工作表操作列。

    雪花-工作表-設置0
  • 在彈出窗口中:
    • 按一下倉庫下拉選單,然後選擇你的倉庫。
    • 按一下資料庫下拉菜單,然後選擇您的HubSpot資料庫。
    • 單擊架構下拉菜單,然後選擇要使用的架構:
        • V2_DAILY :根據表格查詢資料的每日模式。此架構中的數據每天更新一次。使用此架構將導致更快的查詢,並建議直接在Snowflake中查詢。
        • V2_LIVE :基於Secure Views of HubSpot數據的實時架構。此架構中的資料最多每15分鐘更新一次。如果你正在查詢大量資料,查詢速度可能會很慢。在這種情況下,建議首先使用ETL流程將資料複製到自己的表格中,然後查詢該表格。


      snowflake-worksheet-settings-window0

配置環境後,您可以對HubSpot資料進行查詢,而無需手動將資料庫或架構類型新增到查詢中。

若要手動將資料庫和架構類型新增至查詢,請在FROM欄位開頭新增資料庫名稱和架構。例如:


SELECT objectTypeId, property_createddate
FROM hubspot_share_name.V2_LIVE.objects_deals

LIMIT 1

數據概述

查詢是使用SQL構建的,可用於檢索HubSpot數據,例如:

  • 物件:標準和自訂物件,例如聯絡人、公司、產品。 
  • 記錄:個人記錄,例如個人聯繫人或公司。 
  • 關聯:所有可用的關聯類型和當前關聯的記錄。
  • 事件:標準HubSpot事件(例如電子郵件開啟)和自訂行為事件的事件數據。
  • 列表: HubSpot聯系人和公司列表
  • 所有者:你的HubSpot帳戶中的用戶,與他們被設為所有者的記錄相關。
  • 管道:交易和票管道,包括管道階段。
  • 性: CRM記錄中的屬性及其值,包括屬性歷史。

深入瞭解HubSpot的CRM資料模型。 

請注意:隨著資料分享的發展,我們會推出變更,其中一些會打破變更。強烈建議訂閱HubSpot的開發人員變更日誌。這些變更將在任何更新之前隨時發佈在變更日誌中。

限制和排序返回的數據

建構查詢時,您可以透過在查詢中包含LIMIT和來控制傳回的資料數量,以及傳回ORDER BY的順序。例如,若要查詢所有聯絡人及其屬性,但只傳回三個結果並按聯絡人ID排序,您可以按照以下方式建立查詢:


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

列數據類型

查詢雪花中的資料時,傳回的欄位取決於您要查詢的資料。您可以透過選擇左側邊欄中的檢視方式,在「雪花」中查看指定表格或檢視方式的可用欄位。

請注意:在本文檔的剩餘部分,當上下文適用於表格和檢視時,我們會使用「資料庫對象」一詞。

snowflake-sidebar-view-column-details0


若要傳回特定欄位,請在查詢SELECT欄位中包含該欄位。例如,以下查詢將只返回OBJECTIDUpdatedAt列:


SELECT
objectId, updatedAt
FROM objects_contacts

以下是查詢可能傳回的欄的一般定義。如需其他未包含的定義,請參閱上方文章中的個別檢視定義。

正在轉換資料類型

有時候,數據是從帶有VARCHAR欄位的查詢中返回的,當需要將它們作為不同的類型時。在這種情況下,建議使用雪花函數將VARCHAR數據類型轉換成所需類型。例如,物件記錄的屬性在大部分資料庫物件中儲存為VARCHAR數據類型,但有時包含數字和日期時間值。像
try_to_number try_to_timestamp_ntz這樣的函數可以用來將這些VARCHAR數據分別轉換為它們的NUMBERDATETIME類型:


SELECT objectid, value AS amount_str, try_to_number(value) AS amount

FROM object_properties
WHERE objecttypeid='0-3' AND name='amount'
LIMIT 1

對象查詢

下面瞭解如何查詢特定HubSpot對象和記錄中的資料,以及傳回的資料。 

不同類型的物件數據以兩種方式組織並可用: 

  • 個別:每種物件類型都儲存在自己的檢視中,只包含相同物件類型的記錄,例如OBJECTS_CONTACTS只包含聯絡記錄。這無需在查詢時指定objecttypeid。這些視圖更容易查詢,因為您不需要知道ObjectTypeIds。他們也以更可用的格式傳回數據,每行對應一個物件及其屬性的現有版本。只要您沒有遇到緩慢的查詢,建議您使用這些視圖來檢索物件資料。請參閱下面的Objects_X視圖,了解詳情。 
  • 合併:所有物件類型的所有記錄合併到一個資料庫物件中。因此,查詢時,您需要指定篩選器,如“WHERE objectTypeId = ’0-1’”。例如,查詢時可以使用以下objecttypeid :
對象名稱 ObjectTypeId
聯系人 0-1
公司 0-2
明細項目 0-8

自訂物件將在建立時分配一個ID ,並識別為2-Unique_ID。例如, 2-12345。進一步瞭解OBJECT_AND_EVENT_TYPE_DEFINION

如果您希望查詢性能高於可從object_x視圖中取得的查詢性能,這些資料庫對象通常是合適的。請參閱下面的「OBJECT_WITH_OBJECT_PROPERTYS」、「OBJECT_PROPERTYS」、「OBJ

對象_x視圖

在此資料庫物件中,每種可用的物件類型(包括自訂物件)都有自己的特定檢視,每種檢視都僅包含該特定物件類型的物件的記錄。這些視圖以format OBJECTS_<object type name>where命名,<object type name>這是物件類型的複數形式標籤。(請注意,如果物件類型沒有複數形式,則<object type name>將簡單地是與“S”連接的物件類型名稱的單數形式標籤)。

對此檢視的查詢會為物件中的每個記錄傳回一行,其中物件的每個屬性均可作為獨立列使用。

請參閱以下可用的HubSpot (即非自訂)物件類型的完整清單、其所代表的資料的簡短說明及其相應的檢視圖:

 

HubSpot對象類型

ObjectTypeId

DESCRIPTION

聯系方式

0-1

與你的企業互動的個人資訊

公司

0-2

個別企業或組織的相關資訊

交易

0-3

聯絡人或公司的收入機會詳情。 

敬業

0-4

儲存來自CRM操作的資料,包括備註、任務、電子郵件、會議和通話。

工單

0-5

代表客戶尋求協助或支援。

引用

0-14

用於與潛在買家分享價格資訊。

表單提交(_S)

0-15

HubSpot表單的個別提交詳情。

LINE_ITEM

0-8

代表在交易中出售的產品子集。當產品附加到交易時,它會變成一個線項。

對話

0-11

來自多渠道的接收消息的詳細信息。

LANDING_PAGE

0-25

您的登陸頁面詳情

 任務

0-27

儲存有關待辦事項清單的資訊

表單

0-28

用於收集您的訪客和聯絡人的潛在客戶資料

MARKETING_EMAIL

0-29

市場推廣中心的電郵詳情

AD_ACCOUNT

0-30

在Linkedin、Facebook和Google上儲存有關您的廣告帳戶的資訊

AD_CAMPAIGN

0-31

廣告活動的詳細資訊。廣告活動可以包含一個或多個廣告

AD_GROUP

0-32

在廣告活動中對廣告進行合乎邏輯的分組

AD

0-33

個別廣告的詳細資訊

行銷活動

0-35

有關相關市場推廣資產和內容的資訊,因此您可以輕鬆衡量您的集體市場推廣工作的有效性。

SITE_PAGE

0-38

關於您網站上個別網頁的資料

BLOG_POST

0-39

關於博客文章的資料

對象 列表

0-45

有關根據其屬性或活動分組的物件記錄的資訊

呼叫

0-48

其他CRM記錄(例如聯絡人)的呼叫

發票

0-53

管理發票並與外部會計系統同步

MEDIA_BRIDGE

0-57

關於匯入Hubspot的媒體資產的資訊

序列

0-58

序列是一系列有針對性的定時電子郵件模板,以培育聯絡人

DEAL_SPLIT

0-72

交易拆分用於在多位用戶中共享交易信用

SALES_DOCUMENT

0-83

銷售文件建立內容庫,供整個團隊上傳並與聯絡人分享文件。

FEEDBACK_SUBMISSION

0-19

儲存已提交回饋調查的資訊。

訂閱

0-69

訂閱包含定期付款的詳細資料

商務付款

0-101

包含向客戶收取的款項資料



每個資料庫對象都會傳回以下欄:

列名

類型

DESCRIPTION

OBJECTTYPEID

Varchar

對象類型的ID (例如,聯絡人為0-1 )。

對象ID

數字

記錄的ID (例如, ID為123752的聯絡人記錄)。

UPDATEDAT

時間戳

此對象上次在HubSpot中更新的日期和時間。 

INGESTEDAT

時間戳

數據最後被Snowflake吞噬的日期和時間。 

房源_*

Varchar

包含物件屬性最新版本的個別欄。對於具有日期或數字類型的每個物件屬性(如PROPERTY_DEFINITIONS所指定) ,將會有兩欄: 

  1. 包含作爲字符串的屬性值的列。列名爲PROPERTY_UNPARSED_[NAME]。例如,交易對象屬性, DEAL_AMOUNT將具有列PROPERTY_UNPARSED_DEAL_AMOUNT
  2. 包含轉換為本機類型的值的列。列具有name property_[name]。例如, DEAL object property , deal_amount將具有column property_deal_amount。請注意,如果由於資料無效而未能轉換為本機類型,此列將包含Null。

示例1


檢索所有聯絡人的名字、姓氏和生命周期階段。

查詢:


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

FROM objects_contact

退貨:

對象ID

名字

姓氏

LIFECYCLESTAGE

54325098

霍布斯

男爵

引線

96805401

米洛

黃金

引線

6922028

亨利

Riley

引線

示例2

 

檢索最多三項交易的交易名稱和階段。

查詢:


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals

LIMIT 3

退貨:

對象ID

房源_DEALNAME

PROPERTY_DEALSTAGE

PROPERTY_DEALAMOUNT

38960439

交易名稱1

cLOSEDWON

34199

321740651

Test Deal 123

14845019

8383663

98392101

彈出窗篷

cLOSEDWON

9309007

 

示例3

 

按金額檢索前三大交易的交易名稱和階段。

查詢:

由於交易金額數據是以數字數據類型提供,因此它可用於訂購,而無需進行轉換或轉換。


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals
ORDER BY property_amount DESC
LIMIT 3


退貨:

對象ID

房源_DEALNAME

PROPERTY_DEALSTAGE

PROPERTY_DEALAMOUNT

98392101

彈出窗篷

cLOSEDWON

9309007

321740651

Test Deal 123

14845019

8383663

38960439

交易名稱1

cLOSEDWON

34199

object_with_object_properties

此資料庫對象包含來自HubSpot記錄的資料。對此資料庫物件的查詢會為物件類型中的每個記錄(例如,聯絡人物件類型中的所有聯絡人記錄)傳回一行。所有屬性都存儲在屬性列中,這是Snowflake Variant/JSON列。 

此檢視可傳回以下列:

列名 類型 DESCRIPTION
OBJECTTYPEID Varchar 物件類型的ID (例如,聯絡人0-1)。
OBJECTID 數字 記錄的ID (例如, ID為的聯絡人記錄123752)。
PROPERTIES Variant 記錄的屬性值。
UPDATEDAT 時間戳 上次在HubSpot中更新的日期和時間。進一步瞭解列資料類型
INGESTEDAT 時間戳 數據最後被Snowflake吞噬的日期和時間。 

請注意:在2022年1月25日,將更新object_with_object_properties表格和檢視中的列,時間戳,代表物件記錄上次在HubSpot中更新的日期和時間。這與剩餘數據分享中日期時間數據的顯示方式相符。由

於這是一個突破性變更,新列更新 已新增至表格和檢視中。在接下來的90天內,這兩個新欄位將與時間戳共存,即他們正在尋找替換的欄位。這讓您可以切換到使用新欄位。90天

後,系統將於2022年1月25日從表格和檢視中刪除列時間戳。在此日期之後,任何查詢object_with_object_properties表格或使用時間戳列檢視的嘗試都將失敗。

示例1

檢索所有聯系人及其屬性。

查詢:


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


退貨:

OBJECTTYPEID 對象ID 屬性
0-1 38960439 {"createdate": "1504656970152"...}
0-1 321740651 {"createdate": "1590183081949"...} 
0-1 98392101 {"createdate": "1533566477279"...}
... ... ...

示例 2

檢索最多三個交易的交易名稱和階段。

查詢:


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;


退貨:

對象ID DEALNAME DEALSTAGE DEALAMOUNT
38960439 交易名稱1 密封失物 7488939
321740651 交易名稱1 cLOSEDWON 9292029
98392101 交易名稱1 密封失物 62626528

對象

此資料庫對象是object_with_object_properties資料庫對象中的資料的子集。每條傳回的行都會傳回每個記錄的對象ID。此資料庫物件僅傳回現有記錄。當記錄在HubSpot中被刪除時,它將從此資料庫對象中移除。此資料庫對象是object_with_object_properties表中的資料的子集。每條傳回的行都會傳回每個記錄的對象ID。此檢視僅傳回現有記錄。當記錄在HubSpot中被刪除時,它將從此檢視中移除。 

如果您的帳戶擁有大量數據,讓OBJECT_WITH_OBJECT_PROPERTYS_OBJECT_X檢視速度緩慢,這個資料庫對象可能會非常有用。將此資料庫對象與object_properties資料庫對象一起使用,可以複製object_with_object_properties中的資料,同時保持對傳回哪些屬性的控制。

此資料庫對象可以傳回以下欄:

列名 類型 DESCRIPTION
OBJECTTYPEID Varchar 物件類型的ID (例如,聯絡人0-1)。
OBJECTID 數字 記錄的ID (例如, ID為的聯絡人記錄123752)。
INGESTEDAT 時間戳 數據最後被Snowflake吞噬的日期和時間。進一步瞭解列資料類型

示例1

檢索所有聯絡人記錄。

查詢:


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


退貨:

OBJECTTYPEID 對象ID
0-1 36721864
0-1 103580363
0-1 56047670
... ...

object_properties

此資料庫對象是object_with_object_properties資料庫對象的子集。每行都包含給定記錄上設定的當前屬性值。例如,聯系人的姓氏屬性有一行,姓氏屬性有一行。如果記錄沒有屬性的值,行會顯示為空字串,或根本不會出現。

此資料庫對象可以傳回以下欄:

列名 類型 DESCRIPTION
OBJECTTYPEID Varchar 物件類型的ID (例如,聯絡人0-1)。
OBJECTID 數字 記錄的ID (例如, ID為的聯絡人記錄123752)。
NAME Varchar 房源的名稱。
VALUE 時間戳 物業的價值。
UPDATEDAT 時間戳 上次在HubSpot中更新的日期和時間。進一步瞭解列資料類型
INGESTEDAT 時間戳 數據最後被Snowflake吞噬的日期和時間。 

示例1

檢索所有聯絡人的名字、姓氏和城市屬性。

查詢:


SELECT objectTypeId, objectId, name, value
FROM object_properties
WHERE objectTypeId = '0-1'
AND name IN ('firstname', 'lastname', 'city')
ORDER BY objectId;


退貨:

OBJECTTYPEID 對象ID 姓名 價值
0-1 10401 名字 Brian
0-1 10401 城市 都柏林
0-1 10401 姓氏 Gallagher
0-1 23451 名字 費爾南多
0-1 23451 姓氏 菲耶羅
0-1 25751 名字 查爾斯
... ... ... ...

示例2

檢索所有聯絡人的名字、姓氏和生命周期階段,並將其合併成每個聯絡人的一行。此示例使用SQL Pivot語法

查詢:


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);

 

退貨:

OBJECTTYPEID 對象ID 名字 姓氏 LIFECYCLESTAGE
0-1 54325098 霍布斯 男爵 引線
0-1 96805401 米洛 黃金 引線
0-1 6922028 亨利 Riley 引線
... ... ... ... ...

對象_特性_歷史

此資料庫對象包含歷史屬性值。對於聯系人,它包含最新的45值。對於所有其他對象,它包含最近的20個值。顯示每個歷史屬性值的行。房源的現有價值由房源歷史中最新的UPDATEDAT時間戳決定。

此資料庫對象可以傳回以下欄:

列名 類型 DESCRIPTION
OBJECTTYPEID Varchar 物件類型的ID (例如,聯絡人0-1)。
OBJECTID 數字 記錄的ID (例如, ID為的聯絡人記錄123752)。
NAME Varchar 房源的名稱。
VALUE 時間戳 物業的價值。
UPDATEDAT 時間戳 上次在HubSpot中更新數據的日期和時間。進一步瞭解列資料類型
INGESTEDAT 時間戳 數據最後被Snowflake吞噬的日期和時間。 

示例1

檢索單一聯絡人的單一屬性記錄。

查詢:


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

 
退貨:

對象ID 姓名 價值 UPDATEDAT

136493192

hs_predictivescoringtier

tier_1

2022-06-22 22: 45: 05.931

136493192

hs_predictivescoringtier

tier_2

2021-09-18 08: 20: 56.622

136493192

hs_predictivescoringtier

tier_3

2019-11-31 18: 20: 22.851

...

...

...

...

示例2

檢索所有曾經有訂閱者生命周期階段的聯絡人的現有名稱。

查詢:


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


退貨:

對象ID 名字 姓氏
54325098 霍布斯 男爵
96805401 米洛 黃金
6922028 亨利 Riley
... ... ...

關聯查詢

與物件資料一樣,關聯資料有兩種組織方式:

  • 個人:每種關聯類型都儲存在自己的檢視中,只包含該類型的記錄。例如, ASSOCIATIONS_CONTACTS_TO_DEALS只包含聯系人和交易對象之間的聯系記錄。這無需在查詢時指定associationtypeid。這些檢視很容易查詢,因為使用它們不需要熟悉CRM資料模型。他們還會傳回兩個物件之間關聯記錄的豐富描述,這些記錄可以輕鬆用於帶有object_x視圖的連結中。只要您沒有遇到緩慢的查詢,建議您使用這些視圖來檢索關聯資料。在下方查看更多協會_x_to_y視圖。 
  • 合併:所有關聯類型的所有記錄合成一個資料庫對象。因此,在查詢時,您需要指定一個篩選器,如“WHERE combinedassociationtypeid = ’0-32’”。請參閱下方關聯與協會_定義中的更多內容。

associations_x_to_y次瀏覽

每種聯盟類型都有自己的檢視,標籤為association_<association type name>e.g. association_contact_to_deal。每個檢視都是關聯資料庫對象中的資料的子集,僅包含特定連合關聯類型的記錄。

每個資料庫對象都會傳回以下欄:

列名

類型

DESCRIPTION

COMBINEDASSOCIATIONTYPEID

Varchar

關聯定義的唯一識別碼。

ASSOCIATIONCATEGORY

Varchar

關聯類型的來源。其中之一: HUBSPOT_DEFINED、USER_DEFIED、INTEGRATOR_DEFIED

ASSOCIATIONTYPEID

Varchar

特定關聯類別中的關聯定義的獨特識別碼,即關聯類別中沒有兩個定義將具有相同的關聯類型。 

FROMOBJECTTYPEID

Varchar

是關聯定義的來源的objecttypeid。

FROMOBJECTTYPE

Varchar

作爲關聯定義來源的對象類型的名稱。

TOOBJECTTYPEID

Varchar

作爲關聯定義的目標的objecttypeid。

TOOBJECTTYPE

Varchar

作爲關聯定義的目標的對象類型的名稱。

姓名

Varchar

關聯定義的名稱。

標籤

Varchar

關聯定義的描述。

ISMAINASSOCIATIONDEFINITION

布爾值

關聯定義是否為主要類型。如果為true ,定義是HubSpot在關聯記錄上顯示的定義

[FROMOBJECTTYPE_OBJECTID]例如,對於ASSOCIATIONS_CONTACTS_TO_DEALS查看,這將是CONTACT_OBJECTID

數字

源對象的對象ID。

[TOOBJECTTYPE_OBJECTID]例如,對於ASSOCIATIONS_CONTACTS_TO_DEALS查看,這將是DEAL_OBJECTID

數字

目標對象的對象ID。

INGESTEDAT

時間戳

數據最後被Snowflake吞噬的日期和時間。

示例1

 

檢索與特定聯絡人相關的所有交易。

查詢:


SELECT
contact_objectId, deal_objectId

從ASSOCIATIONS_CONTACTS_TO_DEAL

其中contactId = 6626541373

 

退貨:

CONTACT_OBJECTID

DEAL_OBJECTID

6626541373

233620335

6626541373

90253678

示例2

 

檢索波哥大時區的所有聯絡人及其交易。


選擇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
JOIN associations_contacts_to_deals assoc on
assoc.contact_objectid = contacts.objectid
JOIN objects_deals on deals.objectid = assoc.deal_objectid
where contacts.property_hs_timezone = 'america_slash_bogota'

 

聯系人名字

聯系人姓氏

聯系郵箱(_E)

DEAL_TYPE

DEAL_AMOUNT

大衛

Magalhães

dmagalhaes@example.com

newbusiness

74848

費爾南達

羅德裏格斯

fmoreira@example.com

newbusiness

253530

示例3

 

檢索每個聯絡人的所有聯絡人和交易結束金額總和。


SELECT SUM (Deals.property_hs_closed_amount) AS
TOTAL_CLOSED_AMOUNT, contacts.property_email CONTACT_EMAIL
FROM
OBJECTS_CONTACT CONTACT CONTACTS CONTACTS COLLECTIONS_
TO_DEALS
ASSOCIATIONS.contact_objectid = contacts.objectid CONTACT OBJECTIONS_DEALS
CONTACT_EMAIL ORD
BY TOTAL_CLOSED_AMOUNT DESC

 

退貨:

TOTAL_CLOSED_AMOUNT

聯系郵箱(_E)

98474793

johndoe@riverview.com

849488

sallymae@longford.com

association_definition

此資料庫對象包含有關HubSpot對象之間所有可用關聯類型的資訊,每個關聯類型有一行。您可以使用關聯資料庫對象加入此資料庫對象,以獲取特定於記錄的關聯資訊。

同一對象之間可能有多種類型的關聯。主關聯類型是HubSpot在關聯記錄時顯示的類型,使用關聯ISMAINASSOCIATIONDEFINITION位置true

此資料庫對象可以傳回以下欄:

列名 類型 DESCRIPTION
COMBINEDASSOCIATIONTYPEID Varchar 關聯定義的唯一識別碼。
CATEGORY Varchar 關聯類型的來源。其中之一:HUBSPOT_DEFINED,USER_DEFINED, INTEGRATOR_DEFINED
ID 數字 其類別中的關聯定義的識別碼。
FROMOBJECTTYPEID Varchar 作爲關聯定義來源的對象的ID。
TOOBJECTTYPEID Varchar 作爲關聯定義的目標的對象的ID。
NAME Varchar 關聯定義的名稱。
LABEL Varchar 關聯定義的標籤。
ISMAINASSOCIATIONDEFINITION 布爾值 關聯定義是否為主要類型。如果為true ,定義是HubSpot在相關記錄上顯示的定義。
INGESTEDAT 時間戳 數據最後被Snowflake吞噬的日期和時間。進一步瞭解列資料類型

示例1 

檢索帳戶中可用的關聯類型。

查詢:


SELECT combinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
ORDER BY category, id

 
退貨:

COMBINEDASSOCIATIONTYPE FROMOBJECTTYPEID TOOBJECTTYPEID 姓名
0-1 0-1 0-2 CONTACT_TO_COMPANY
0-2 0-2 0-1 公司聯系人
0-3 0-3 0-1 DEAL_TO_CONTACT
0-4 0-1 0-3 CONTACT_TO_DEAD
0-5 0-3 0-2 DEAL_TO_COMPANY
... ... ... ...

示例2

檢索交易和公司之間的可用關聯類型。

查詢:


SELECTcombinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
WHERE fromObjectTypeId = '0-3' AND toObjectTypeId = '0-2'
AND isMainAssociationDefinition = true

ORDER BY category, id


退貨:

COMBINEDASSOCIATIONTYPE FROMOBJECTTYPEID TOOBJECTTYPEID 姓名
0-5 0-3 0-2 DEAL_TO_COMPANY
0-271 0-3 0-2 DEAL_TO_PRIMARY_COMPANY
0-341 0-3 0-2 交易_TO_COMAPNY_未標籤

聯想;聯想

此資料庫對象包含有關特定記錄之間關聯的資訊。每行表示從一個物件到另一個物件的關聯。儘管引用的記錄已被刪除,但此資料庫對象中仍可能存在行。您可以透過與物件表結合來檢查記錄是否存在。

如果您的帳戶擁有大量數據,讓關聯_x_to_y視圖表表現緩慢,這個資料庫對象可能會非常有用。

此資料庫對象可以傳回以下欄:

列名 類型 DESCRIPTION
COMBINEDASSOCIATIONTYPEID Varchar 關聯定義的唯一識別碼。
FROMOBJECTID 數字 源對象的ID。
TOOBJECTID 數字 目標對象的ID。
INGESTEDAT 時間戳 數據最後被Snowflake吞噬的日期和時間。進一步瞭解列資料類型

示例1

檢索所有關聯的交易和聯系人。

查詢:


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

 
退貨: 

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

示例2 

檢索與特定聯絡人關聯的所有工單(聯絡人ID : 3005 )。

查詢:


SELECT combinedAssociationTypeId, fromObjectId, toObjectId
FROM associations
WHERE associationCategory = 'HUBSPOT_DEFINED'
AND combinedAssociationTypeId = '0-15'
AND fromObjectId = 3005;


退貨:

COMBINEDASSOCIATIONTYPE FROMOBJECTID TOOBJECTID
0-5 6626541373 233620335

示例3 

檢索與特定聯絡人相關的所有交易(聯絡人ID : 4464 )。此示例使用 association_definition聯接,而不是硬編碼combAssociationTypeId

查詢:


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;


退貨:

COMBINEDASSOCIATIONTYPEID FROMOBJECTID TOOBJECTID
0-5 6626541373 233620335

所有者查詢

所有者

此資料庫對象包含有關您HubSpot帳戶中用戶的資訊。用戶可以設定為記錄擁有者,並且會根據其上下文包含用戶ID和擁有者ID。兩個ID可用於識別同一用戶。 

此資料庫對象可以傳回以下欄:

列名 類型 DESCRIPTION
OWNERID 數字 用戶的所有者ID。
USERID 數字 用戶的用戶ID。已刪除此欄中為Null的用戶。
EMAIL Varchar 用戶的郵箱地址。
FIRSTNAME Varchar 用戶的名字。
LASTNAME Varchar 用戶的姓氏。
ARCHIVED 布爾值 用戶是否已被刪除。
CREATEDAT 時間戳 用戶在HubSpot中建立的日期和時間。有關詳情,請參閱列資料類型。
UPDATEDAT 時間戳 用戶上次在HubSpot中更新的日期和時間。有關詳情,請參閱列資料類型。
INGESTEDAT 時間戳 數據最後被Snowflake吞噬的日期和時間。

示例1 

檢索所有用戶。WHERE archived = false 過濾器從返回的數據中刪除已刪除的用戶。

查詢:


SELECT ownerId, userId, email, firstname, lastname
FROM owners
WHERE archived = false

 
退貨: 

OWNERID 用戶ID 郵箱地址 名字 姓氏
29584574 4621126 233620335 霍布斯 男爵
30532717 4874784 3866015468 Pablo 沃爾特斯
30580321 925511 7132752747 米洛 黃金
... ... ... ... ...

示例2

透過所有者ID檢索特定所有者。

查詢:


SELECT ownerId, userId, email, firstname, lastname
FROM owners
WHERE ownerId = 29584574;


退貨: 

OWNERID 用戶ID 郵箱地址 名字 姓氏
29584574 4621126 233620335 霍布斯 男爵

示例3

檢索所有聯系人及其所有者。此查詢將紀錄連結到擁有object_with_object_properties和contact屬性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


退貨: 

CONTACTID 聯系人名字 聯系人姓氏 聯系人_HUBSPOT_OWNER_ID OWNER_FIRSTNAME OWNER_LASTNAME OWNER_EMAIL
113834202 理查德 格林菲爾德 29584574 霍布斯 男爵 hobbes.b@business.com
53540801 福特 卡爾 30241125 米洛 黃金 milo.g@business.com
... ... ... ... ... ... ...

團隊查詢

團隊

HubSpot中的團隊可讓您將用戶組織成羣組,以進行組織和報告。你可以擁有一個主團隊和其他團隊。

此資料庫物件包含您HubSpot帳戶中團隊的相關資訊。 

此資料庫對象可以傳回以下欄:

列名 類型 DESCRIPTION
TEAMID 數字 團隊ID。
TEAMNAME Varchar 團隊名稱。
PARENTTEAMID 數字 上層團隊的團隊ID。
CHILDTEAMIDS 陣列 子團隊的團隊ID。
PRIMARYOWNERMEMBERS Varchar 團隊主要成員的所有者ID。
SECONDARYOWNERMEMBERS 布爾值 團隊次要成員的所有者ID。
INGESTEDAT 時間戳 數據最後被Snowflake吞噬的日期和時間。 

示例1

擷取所有團隊。

查詢:

SELECT teamId,teamName, primaryOwnerMembers

來自團隊

退貨:

TEAMID TEAMNAME PRIMARYOWNERMEMBERS
29584574 子團隊 [233620335, 1234553]
30532717 超級團隊 [3866015468, 126221873]
3058032 團隊 [7132752747]

owner_team

此資料庫物件包含有關哪些擁有者對應於您HubSpot帳戶中的哪些團隊的資訊。 

此資料庫對象可以傳回以下欄:

列名 類型 DESCRIPTION
TEAMID 數字 團隊ID。
OWNERID 數字 用戶的所有者ID。 
ISTEAMPRIMARY 布爾值 此團隊是否為此所有者的主要團隊。
INGESTEDAT 時間戳 Snowflake上次攝取資料的日期和時間。 

示例1

擷取指定團隊的所有擁有者。

查詢:

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

退貨

TEAMID TEAMNAME ISTEAMPRIMARY
29584574 233620335 正確
29584574 1234553 正確 

管道查詢

在下方,瞭解如何查詢交易和聯絡單管道資料,例如帳戶中的可用管道及其階段。

您可以使用對象數據加入此數據,以全面查看管道。例如,您可以使用管道數據連結object_deals_view或object_with_object_properties數據,以查詢交易及其道。

管道

此資料庫對象包含有關您帳戶中的交易和工單管道的資訊。返回的每一行表示單一的管道。

此表可以返回以下列:

列名 類型 DESCRIPTION
PIPELINEID Varchar 管道的ID。
OBJECTTYPEID Varchar 管道可以包含的對象的ID (例如,交易或工單)。
LABEL Varchar HubSpot中的管道名稱。
DISPLAYORDER 數字 管道在HubSpot中顯示的順序。
ARCHIVED 布爾值 管道是否已刪除。
CREATEDAT 時間戳 管道建立時。
UPDATEDAT 時間戳 上次在HubSpot中更新數據的日期和時間。進一步瞭解列資料類型
INGESTEDAT 時間戳 數據最後被Snowflake吞噬的日期和時間。 

示例1

在HubSpot中尋找所有按其訂單排序的可用交易管道。

查詢:


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

 
退貨: 

OBJECTTYPEID PIPELINEID 標籤
0-3 1bed503c-37f7-4f51-9d40-7598902673f4 銷售管道
0-3 12659678 許可證管道
0-3 75e28846-ad0d-4be2-a027-5e1da6590b98 新建商家
... ... ...

示例2

在特定管道中檢索交易。聯接object_with_object_properties和管

查詢:


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';


退貨: 

DEAL_ID DEAL_NAME 管道名稱
605140072 Meowmix全局注冊 銷售管道
605457408 Friskies Rebrand 銷售管道
604362473 新建步驟應用程式構建 銷售管道

 

示例3

 

與上面的示例2相同,在特定管道內檢索交易。但是,不要在聯接中使用OBJECTS_DEALS ,而是使用OBJECT_WITH_OBJECT_PROPERT


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';

 

退貨: 

DEAL_ID

DEAL_NAME

管道名稱

605140072

Meowmix全局注冊

銷售管道

605457408

Friskies Rebrand

銷售管道

604362473

新建步驟應用程式構建

銷售管道

pIPLINE_STAGES

此檢視包含管道內個別階段的資訊。透過組合物件類型ID、管道ID和階段ID來識別階段。使用管道時,使用對象類型ID和管道ID。

此資料庫對象可以傳回以下欄:

列名 類型 DESCRIPTION
PIPELINEID Varchar 管道的ID。
STAGEID Varchar 舞臺的ID。
LABEL Varchar 舞臺的名字在HubSpot。
DISPLAYORDER 數字 管道在HubSpot中顯示的順序。
METADATA Variant JSON格式的階段描述,包括是否開啟或關閉
ARCHIVED 布爾值 管道階段是否已刪除。
CREATEDAT 時間戳 管道階段建立時。

示例1 

檢索名為銷售管道的交易管道的管道階段。

查詢:


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;

 
退貨: 

PIPELINEID STAGEID 標籤
941650 941651 已聯絡
941650 941652 Appt已安排
941650 941653 發票已發送
... ... ...

示例2

檢索所有交易及其各自的管道階段。

查詢:


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';


退貨: 

DEAL_ID DEAL_NAME 管道名稱 管道_舞臺_名稱
605140072 Meowmix全局注冊 銷售管道 合同已發送
605457408 Friskies Rebrand 銷售管道 Appt已安排
604362473 新建步驟應用程式構建 銷售管道 已簽訂的合同
... ... ... ...

旅居查詢

特性定義

此資料庫物件包含有關您HubSpot帳戶中的物件屬性和事件屬性的資訊。事件屬性包括標準事件(如電子郵件開啟和點擊)和自訂行為事件屬性。此資訊可能對於在object_properties事件資料中找到的值有幫助。

您可以透過組合對象類型ID和名稱來識別特定屬性。您可以使用屬性API檢索類似資訊

此資料庫對象可以傳回以下欄:

列名 類型 DESCRIPTION
OBJECTYPEID Varchar 事件所關係的對象的ID。
NAME Varchar 房源的內部名稱。
LABEL Varchar 房源標籤。
DESCRIPTION Varchar 房源描述。
TYPE Varchar 屬性的類型(例如字符串、數字、日期時間)。
FIELDTYPE Varchar 房源的字段類型。定義屬性在HubSpot和表單上的顯示方式(例如,核取方塊,選擇)。
DISPLAYORDER 數字 房源的顯示順序。
GROUPNAME Varchar 物業羣組名稱。
OPTIONS Variant 對於列數屬性,屬性選項的陣列,包括每個選項的屬性(例如,顯示順序、標籤)。
CREATEDUSERID 數字 創建屬性的用戶的ID。
REFERENCEDOBJECTTYPE Varchar 屬性引用的對象的類型。所有者屬性將傳回所有者的值。
CALCULATED 布爾值 屬性是否為計算屬性
EXTERNALOPTIONS 布爾值 房源的選項是否在外部系統中定義。
HASUNIQUEVALUE 布爾值 房源的值是否唯一。只有在透過API建立屬性時才能設定
HIDDEN 布爾值 房源是否隱藏在HubSpot中。
SHOWCURRENCYSYMBOL 布爾值 數字屬性值是否格式化為貨幣。
FORMFIELD 布爾值 此屬性是否可以在窗體中使用。
READONLYDEFINITION 布爾值 是否可以在HubSpot中編輯此屬性。
READONLYVALUE 布爾值 是否可以在HubSpot中編輯屬性的值。
HUBSPOTDEFINED 布爾值 此屬性是否由HubSpot創建,而不是由用戶創建。
ARCHIVED 布爾值 是否已刪除該屬性。
CREATEDAT 時間戳 在HubSpot中建立房源的日期和時間。
UPDATEDAT 時間戳 上次在HubSpot中更新數據的日期和時間。進一步瞭解列資料類型
INGESTEDAT 時間戳 數據最後被Snowflake吞噬的日期和時間。 

示例1

檢索所有聯絡人屬性的名稱和描述。

查詢:


SELECT name, label, description
FROM property_definitions
WHERE objectTypeId = '0-1'

 
退貨:

姓名 標籤 DESCRIPTION
enter_sql_stage 已進入SQL階段 開始計數SQL階段天數。
first_conversion_event_name
首次轉換 此聯系人提交的第一份表單。
地址;地址 街道地址 聯系人的地址。

事件查詢

事件包括標準的HubSpot事件和自訂的行為事件。每個事件都有自己的資料庫物件,標記為events_eventname

姓名  
EVENTS_AD_INTERACTION 點擊廣告或與廣告互動後提交表單,即可獲得廣告的詳細資料以及與廣告互動的聯絡人。
事件_AD_度量_導入_V0

廣告及其效果指標的詳細資料。
EVENTS_CALL_MENTIONED_KEYWORD 任何參與者在呼叫中提到的關鍵字的詳細資訊。
EVENTS_CLICKED_LINK_IN_EMAIL_V2

聯絡人點擊市場推廣電子郵件中的連結。
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8 聯絡人點擊對話收件匣電子郵件中的連結。
EVENTS_COOKIE_BANNER_CLICKED 點擊Cookie的聯絡人。
事件_Cookie_橫幅_已查看 查看Cookie的聯系人。
EVENTS_DOCUMENT_SHARED_V2 銷售文件透過外部連結與聯絡人分享。
EVENTS_DOCUMENT_VIEWED_V2 開啟外部連結查看的銷售文件和聯絡人。
EVENTS_DOCUMENT_COMPLETED_V2 已關閉的銷售文件和聯絡人。
EVENTS_HS_SCHEDULED_EMAIL_V2 提交到HubSpot電子郵件伺服器的電子郵件將被發送。
EVENTS_MTA_delivery_EMAIL_V2 由HubSpot電子郵件伺服器成功傳送電子郵件給收件人。
活動_MTA_已退回_電子郵件_V2 電子郵件傳送嘗試被收件人的電子郵件伺服器拒絕。
EVENTS_open_EMAIL_V2 通過聯絡人開啟電子郵件。
EVENTS_REPORTED_SPAM_EMAIL_V2 收件人標記為垃圾郵件的電子郵件。
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2 收件人對電子郵件訂閱的變更。
EVENTS_open_TRACKED_INBOX_EMAIL_V8 通過聯絡人開啟收件匣電子郵件。
事件_MB_媒體_已播放 聯絡人顯示的視頻回放活動。
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE 聯絡人已透過序列預訂會議。
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE 從序列注冊的聯系人。
事件_V2_聯系_完成_序列 序列已完成。
EVENTS_V2_CONTACT_Replied_SEQUENCE_EMAIL 聯絡人回覆了透過序列發送的電子郵件(或未註冊序列的傳入電子郵件)。
EVENTS_V2_CONTACT_UNENROLLED_FROM_SEQUENCE 聯系人已從序列中取消注冊。
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE 用戶手動取消注冊聯系人。
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL 聯系人取消訂閱,正在取消註冊序列。
事件_V2_序列_電子郵件_已退回 序列郵件已退回。
事件_V2_序列_錯誤 序列出錯,導致取消註冊。
事件_V2_序列_步驟_已執行 序列步驟已執行。
EVENTS_VISITED_PAGE 聯絡人瀏覽網站頁面。
EVENTS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER> 集成事件( Timeline V3 API

您可以透過組合活動類型ID和ID來識別活動。傳回的欄位取決於活動,每個活動屬性有一個欄位。所有事件都會返回以下列:

請注意: HubSpot已在所有活動表格和視圖中新增兩列:

  • occurredat
  • occurredatdateint

這些欄位將於2022年11月24日取代occuredatoccuredatdateint欄位。在該日期,舊欄將無法再使用,嘗試查詢使用這些欄位查詢包含事件的資料庫對象或檢視將失敗。了解更多關於破解雪花數據分享變更的資訊



列名 類型 DESCRIPTION
EVENTTYPEID Varchar 事件類型的ID ,類似於OBJECTTYPEID
您可以使用OBJECT_AND_EVENT_TYPE_DEFINIONS檢視查帳戶中的所有事件類型ID。
ID Varchar 這是每種活動類型獨一無二的。在指定的事件類型中,沒有兩個記錄具有相同的ID。
OBJECTTYPEID Varchar 完成事件的對象的類型。例如,電子郵件連結點擊將顯示在此列0-1中,代表聯絡人物件。
OBJECTID 數字 完成事件的記錄的ID。
OCCURREDAT 時間戳 事件發生時。

OCCURREDATDATEINT

 

數字 表示事件發生時間的數字。包含與OCCURREDAT 列相同的數據,但格式化爲數字並用作表的集羣鍵的一部分。在大多數情況下,您可以使用OCCURREDAT時間戳記而不是此數字。

OCCUREDATDATEINT

數字

表示事件發生時間的數字。包含與OCCURREDAT 列相同的數據,但格式化爲數字並用作表的集羣鍵的一部分。在大多數情況下,您可以使用OCCURREDAT時間戳記而不是此數字。

請注意:此欄將於2022年11月24日停用,並替換為 OCCURREDATDATEINT

OCCUREDAT 時間戳

事件發生時。

請注意:此欄將於2022年11月24日停用,並替換為 OCCURREDAT

INGESTEDAT 時間戳 數據最後被Snowflake吞噬的日期和時間。進一步瞭解列資料類型
PROPERTY_* Varchar 包含事件屬性的單列。

示例1

檢索最新的50個電子郵件點擊事件。

查詢:


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;


退貨: 

EVENTTYPEID OBJECTTYPEID 對象ID 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
... ... ... ... ...

示例2

檢索按一下聯絡人的所有電子郵件點擊事件。此查詢透過與object_with_object_properties結合來獲取聯絡資料

查詢:


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;


退貨: 

點擊_TIMESTAMP 點擊網址(_U) 聯系人名字 聯系人姓氏
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 霍布斯 男爵
2018-11-08 09: 37: 41.400 https://www.website.net/webinar-case-study?utm_source=hs_automation&utm_medium=email&utm_content=55200164 米洛 黃金
2018-11-08 09: 37: 41.426 https://www.website.net/contact?utm_source=hs_automation&utm_medium=email&utm_content=55200164 哈洛 Villari
... ... ... ...

Object_and_event_type_queries

object_and_event_type_definition

此資料庫物件包含HubSpot帳戶中可用的所有物件和事件的定義。

此資料庫對象可以傳回以下欄:

列名 類型 DESCRIPTION
OBJECTTYPEID Varchar 管道可以包含的對象的ID (例如,交易或工單)。
FULLYQUALIFIEDNAME Varchar 對象或事件的名稱。
INGESTEDAT 時間戳 數據最後被Snowflake吞噬的日期和時間。進一步瞭解列資料類型

示例1

檢索HubSpot帳戶中可用的所有物件和事件。

查詢:


SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;

 
退貨: 

OBJECTTYPEID FULLYQUALIFIEDNAME
0-1 聯系方式
0-8 LINE_ITEM
0-11 對話
... ...

列出查詢

在下方,瞭解如何查詢清單,例如可用的聯絡人和公司清單以及這些清單中包含的記錄。

列表

此資料庫對象包含有關HubSpot聯絡人和公司清單的資訊。傳回每個清單一行,列包含清單細節,如清單名稱、大小及其所含記錄的對象類型。不包含每個清單中個別記錄的資訊(請參閱LIST_MEMBILITION )。 

此資料庫對象可以傳回以下欄:

列名 類型 DESCRIPTION
OBJECTTYPEID Varchar 清單中的記錄類型(例如,聯絡人或公司)。
LISTID 數字 列表的ID。加入列表會員表中的LISTID列。
CLASSICLISTID 數字 特定於聯系人列表的ID ,與HubSpot中列表URL中的ID匹配。
NAME Varchar 列表的名稱。
SIZE 數字 列表中的條目數。
CREATEDBYUSERID 數字 建立清單的用戶的ID。
CREATEDAT 時間戳 在HubSpot中建立清單時。
UPDATEDBYUSERID 數字 最近更新列表的用戶的ID。
UPDATEDAT 時間戳 上次在HubSpot中更新日期的日期和時間。進一步瞭解列資料類型。 
INGESTEDAT 時間戳 數據最後被Snowflake吞噬的日期和時間。

示例1

檢索所有聯系人列表。

查詢:


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

 
退貨: 

LISTID 姓名 尺寸
118131 每周外聯 103
66156 博客訂閱者 455
771852 2021年排名前茅的訂閱者 37
... ... ...

示例2

檢索名爲Top subscribers 2021的特定聯系人列表。 

查詢:


SELECT listId, name, size 
FROM lists
WHERE objectTypeId = '0-1'
AND
listName = 'Top subscribers 2021';


退貨: 

LISTID 姓名 尺寸
771852 2021年排名前茅的訂閱者 37

list_membership

此資料庫對象包含有關哪些記錄是哪些清單成員的資訊,每項記錄在清單中有一行。例如,如果您有包含500個聯絡人的網誌訂閱者清單,則資料庫對象將傳回500行。 

僅包含列表ID和對象ID。如需更多資訊,請加入清單資料庫對象。

此資料庫對象可以傳回以下欄:

列名 類型 DESCRIPTION
LISTID Varchar 列表的ID。加入列表表中的HS_LIST_ID列。
OBJECTID Varchar 列表中條目的ID。
UPDATEDAT 時間戳 上次在HubSpot中更新數據的日期和時間。進一步瞭解列資料類型
INGESTEDAT 時間戳 數據最後被Snowflake吞噬的日期和時間。 

示例1

檢索「頂尖訂閱者2021」清單中所有聯絡人的ID。

查詢:


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';

 
退貨: 

對象ID
54325098
96805401
6922028
...

示例2

在2021年頂級訂閱者清單中檢索聯絡人詳細資料的名字和姓氏。

查詢:


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'


退貨: 

對象ID

名字

姓氏

54325098

霍布斯

男爵

96805401

米洛

黃金

6922028

亨利

Riley

...

...

...

常見問題

我想產生類似於Hubspot應用程式報告的資料,我該怎麼做?


一般而言,您需要查看與之相比較的報告中的欄位。如果報告可視化不是表格,轉換成表格時將會顯示報告所包含的欄位。這些欄通常是對象類型或事件類型的屬性。下一步是找出列對應的對象類型屬性。您可以查詢PROPERTY_DEFINIONS :


SELECT * FROM property_definitions

WHERE label = [column_name]

 

由於某些旅居名稱通常會在應用程式上解析為更具描述性的名稱,因此可能不總是完全匹配。在這種情況下,使用PROPERTY_DEFINITIONS中的標籤(甚至說明)欄中的類似數字來進行模糊搜尋可能會有所幫助。

在確定欄位屬於哪種物件類型後,決定要查詢甚麼是微不足道的。您可以輕鬆搜尋對應類型的object_x視圖。

如何將此資料類型連結到另一個資料類型,例如如何檢索活動的表單?


如果您需要將兩個或多個不同的記錄連結到對方,請查看關聯。關聯代表HubSpot CRM中物件之間的關係。兩種類型之間可能的所有不同關聯都列於association_definition中。在上面的示例中,要了解所有與廣告活動相關的表格,您需要查詢ASSOCIATIONS_CAMPATS_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

如何知道HubSpot-Snowflake整合的狀態?

若要接收有關HubSpot-Snowflake整合的中斷和問題的實時狀態更新,請查詢DATA_SHARE_STATUS視圖:

SELECT * FROM hubspot.public.data_share_status
LIMIT 1

結果將顯示為:

狀態 消息 UPDATEDAT
確定 目前尚無已知事件 2023-04-10 09:21:20.123

此視圖按逆向時間順序提供有關整合狀態的更新。將此查詢的結果整合到控制面板中,將有助於您跟蹤整合的性能,並檢測任何停機或中斷。 

這篇文章有幫助嗎?
此表單僅供記載意見回饋。了解如何取得 HubSpot 的協助