查詢雪花中的HubSpot數據
上次更新時間: 一月 23, 2023
將Snowflake連接到您的HubSpot帳戶後,您可以使用Snowflake的資料分享查詢您Snowflake帳戶中的HubSpot資料。
數據延遲和您的雪花帳戶區域
你的帳戶的雪花區域決定你的HubSpot資料更新的頻率。如果你的雪花帳戶區域與HubSpot的雪花帳戶區域相符(對於歐盟資料中心的HubSpot帳戶,這意味著EU_CENTRAL_1_AWS ,對於所有其他HubSpot帳戶,這意味著US_EAST_1_AWS ) ,你的資料將每15分鐘更新一次。
您將可以瀏覽每15分鐘更新一次的V2_LIVE架構,以及每天更新的V2_DAY架構。否則,如果你的HubSpot帳戶區域和雪花區域不匹配,你只能瀏覽每天更新的V2_DAY架構。
設定您的雪花環境
若要查詢雪花中的HubSpot資料,您需要選擇要查詢的倉庫、資料庫和架構。您可以將它們設定在工作表層級,以自動將它們包含在查詢中,也可以手動新增它們。
要在工作表層級選擇倉庫、資料庫和架構:
- 在工作表頂行中,按一下工作表操作列。
- 在彈出窗口中:
- 按一下倉庫下拉選單,然後選擇你的倉庫。
- 按一下資料庫下拉菜單,然後選擇您的HubSpot資料庫。
- 單擊架構下拉菜單,然後選擇要使用的架構:
- V2_DAILY :根據表格查詢資料的每日模式。此架構中的數據每天更新一次。使用此架構將導致查詢速度更快,建議直接在Snowflake中查詢。
- V2_LIVE :基於HubSpot數據的安全查看的LIVE架構。此架構中的資料最多每15分鐘更新一次。如果你正在查詢大量資料,查詢速度可能會很慢。在這種情況下,建議首先使用ETL流程將資料複製到自己的表格中,然後查詢該表格。此架構目前僅在你的雪花帳戶區域與HubSpot的雪花帳戶區域相符時才可用。
配置環境後,您可以對HubSpot資料進行查詢,而無需手動將資料庫或架構類型新增到查詢中。
若要將資料庫和架構類型手動新增到查詢,請新增資料庫名稱,然後在FROM
欄位開頭的架構。例如:
選擇objectTypeId, property_createddate
FROM hubspot_share_name.V2_LIVE.objects_deals
限制1
數據概述
查詢是使用SQL構建的,可用於檢索HubSpot資料,例如:
- 對象:標準和自訂對象,例如聯絡人、公司、產品。
- 記錄:個人記錄,例如個人聯絡人或公司。
- 關聯:所有可用關聯類型和目前關聯的記錄。
- 事件:標準HubSpot事件(如電子郵件開啟)和自訂行為事件的事件數據。
- 列表: HubSpot聯系人和公司列表。
- 所有者:你的HubSpot帳戶中的用戶,與他們被設為所有者的記錄相關。
- 管道:交易和票管道,包括管道階段。
- 屬性: 屬性及其在CRM記錄中的值,包括屬性歷史。
進一步瞭解HubSpot的CRM數據模型。
請注意:隨著資料分享的發展,我們會推出變更,其中一些會打破變更。強烈建議訂閱HubSpot的開發人員變更日誌。這些變更將在任何更新之前隨時發佈在變更日誌中。
限制和排序返回的數據
在構建查詢時,您可以在查詢中包含限制
和排序方式,以控制傳回多少資料,以及傳回資料的順序。例如,若要查詢所有聯絡人及其屬性,但只傳回三個結果並按聯絡人ID排序,您可以按照以下方式建立查詢:
從OBJECTS_DEALS
ORDER BY OBJECTID
LIMIT 10中
選擇objectTypeId、updatedAt、intgestedAt ;
列數據類型
查詢雪花中的資料時,傳回的欄位取決於您要查詢的資料。您可以透過選擇左側邊欄中的檢視方式,在「雪花」中查看指定表格或檢視方式的可用欄位。
請注意:在本文檔的剩餘部分,當上下文適用於表格和檢視時,我們會使用「資料庫對象」一詞。

若要返回特定欄位,請將該欄位包含在查詢的「選擇」
欄位中。例如,以下查詢只會傳回OBJECTID
和UpdatedAt
列:
從
OBJECTS_CONTACTS中
選擇objectId , updatedAt
以下是查詢可能傳回的欄的一般定義。如需其他未包含的定義,請參閱上方文章中的個別檢視定義。
- OBJECTTYPEID : 表示對象類型的Varchar值。例如, 0-1表示聯系人對象, 0-2表示公司對象, 2-1232可能表示您帳戶中的自訂對象。在列表中,這指的是列表類型(例如,聯絡人或公司)。您可以使用OBJECT_AND_EVENT_TYPE_DEFINIONS檢視功能查詢帳戶中的所有對象和活動ID。
- OBJECTID :表示HubSpot帳戶中指定類型的物件的單一記錄的大型數字。若要識別記錄,您需要使用物件類型ID和物件ID。
- INGESTEDAT :將一行資料新增至雪花的時間戳,以TIMESTAMP_NTZ值表示。與HubSpot中創建或更新操作的輯理時間戳無關。
- 由於HubSpot的內部處理,即使行上的其他列沒有更改,行吞噬時間戳也可能會被更新。
- 當建立複製最近變更的資料的ETL流程時,建議您將查詢建立在吞噬時間戳的基礎上。此外,如果您的流程每天複製資料,建議您複製前兩天的資料,以處理延遲情況。
- CREATEDAT和UPDATEDAT :在HubSpot中創建或更新資料的邏輯時間戳,由TIMESTAMP_NTZ值表示。這些時間戳將與HubSpot中的時間戳匹配。例如,記錄建立日期的HubSpot中顯示的時間將與雪花中的CREATEDAT欄中的時間戳相同。這些與吞噬時間戳沒有直接關係,不建議將ETL過程建立在這些屬性上。
- COMBINEDASSOCIATIONTYPE :唯一地識別關聯定義的VARCHAR值。
正在轉換資料類型
有時候,數據會從具有Varchar欄的查詢中傳回,當需要將它們設為不同類型時。在這種情況下,建議使用雪花函數將VARCHAR數據類型轉換成所需類型。例如,物件記錄的屬性在大部分資料庫物件中儲存為VARCHAR數據類型,但有時包含數字和日期時間值。例如:
try_to_number、try_to_timestamp_ntz的函數可以用於將這些Varchar資料分別轉換成其數字和日期時間類型:
從object_properties中
選擇objectid, value as amount_str, try_to_number (value) as amount
, 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視圖
在此資料庫物件中,每種可用的物件類型(包括自訂物件)都有自己的特定檢視,每種檢視都僅包含該特定物件類型的物件的記錄。這些視圖是按照以下格式命名的: 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
用於與潛在買家分享價格資訊。
0-15
HubSpot表單的個別提交詳情。
0-8
代表在交易中出售的產品子集。當產品附加到交易時,它會變成一個線項。
0-11
來自多渠道的接收消息的詳細信息。
0-25
您的登陸頁面詳情
0-27
儲存有關待辦事項清單的資訊
0-28
用於收集您的訪客和聯絡人的潛在客戶資料
0-29
市場推廣中心的電郵詳情
AD_ACCOUNT
0-30
在Linkedin、Facebook和Google上儲存有關您的廣告帳戶的資訊
0-31
廣告活動的詳細資訊。廣告活動可以包含一個或多個廣告
AD_GROUP
0-32
在廣告活動中對廣告進行合乎邏輯的分組
AD
0-33
個別廣告的詳細資訊
0-35
有關相關市場推廣資產和內容的資訊,因此您可以輕鬆衡量您的集體市場推廣工作的有效性。
SITE_PAGE
0-38
關於您網站上個別網頁的資料
0-39
關於博客文章的資料
對象 列表
0-45
有關根據其屬性或活動分組的物件記錄的資訊
0-48
其他CRM記錄(例如聯絡人)的呼叫
發票
0-53
管理發票並與外部會計系統同步
0-57
關於匯入Hubspot的媒體資產的資訊
0-58
序列是一系列有針對性的定時電子郵件模板,以培育聯絡人
0-72
交易拆分用於在多位用戶中共享交易信用
0-83
銷售文件建立內容庫,供整個團隊上傳並與聯絡人分享文件。
0-19
儲存已提交回饋調查的資訊。
0-69
訂閱包含定期付款的詳細資料
0-101
包含向客戶收取的款項資料
每個資料庫對象都會傳回以下列:
列名
類型
DESCRIPTION
OBJECTTYPEID
Varchar
對象類型的ID (例如,聯絡人為0-1 )。
對象ID
數字
記錄的ID (例如, ID為123752的聯絡人記錄)。
UPDATEDAT
時間戳
此對象上次在HubSpot中更新的日期和時間。
INGESTEDAT
時間戳
數據最後被Snowflake吞噬的日期和時間。
房源_*
Varchar
包含對象屬性的最新版本的個別欄位。對於具有日期或數字類型(由PROPERTY_DEFINITIONS指定)的每個對象屬性,將有兩個欄位:
- 包含作爲字符串的屬性值的列。列名爲PROPERTY_UNPARSED_[NAME]。例如,交易對象屬性, DEAL_AMOUNT將具有列PROPERTY_UNPARSED_DEAL_AMOUNT
- 包含轉換為本機類型的值的列。列具有name property_[name]。例如, DEAL object property , deal_amount將具有column property_deal_amount。請注意,如果由於資料無效而未能轉換為本機類型,此列將包含Null。
示例1
檢索所有聯絡人的名字、姓氏和生命周期階段。
查詢:
選擇objectId, property_firstname作為名字, property_lastname作為姓氏, property_lifecyclestage作為
lifeecyclestage從object_contact
退貨:
對象ID
名字
姓氏
LIFECYCLESTAGE
54325098
霍布斯
男爵
引線
96805401
米洛
黃金
引線
6922028
亨利
Riley
引線
示例2
檢索最多三項交易的交易名稱和階段。
查詢:
選擇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
按金額檢索前三大交易的交易名稱和階段。
查詢:
由於交易金額數據是以數字數據類型提供,因此它可用於訂購,而無需進行轉換或轉換。
選擇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記錄的資料。對此資料庫物件的查詢會為物件類型中的每個記錄(例如,聯絡人物件類型中的所有聯絡人記錄)傳回一行。所有屬性都儲存在「屬性」欄中,這是雪花變體/JSON欄。
此檢視可傳回以下列:
列名
類型
DESCRIPTION
OBJECTTYPEID
Varchar
對象類型的ID (例如,聯絡人為0-1
)。
對象ID
數字
記錄的ID (例如, ID為123752的聯絡人記錄
)。
屬性
Variant
記錄的屬性值。
UPDATEDAT
時間戳
上次在HubSpot中更新的日期和時間。進一步瞭解列資料類型。
INGESTEDAT
時間戳
數據最後被Snowflake吞噬的日期和時間。
請注意:在2022年1月25日,將更新object_with_object_properties表格和檢視中的列,時間戳,代表物件記錄上次在HubSpot中更新的日期和時間。這與剩餘數據分享中日期時間數據的顯示方式相符。由
於這是一個突破性變更,新列更新 已新增至表格和檢視中。在接下來的90天內,這兩個新欄位將與時間戳共存,即他們正在尋找替換的欄位。這讓您可以切換到使用新欄位。90天
後,系統將於2022年1月25日從表格和檢視中刪除列時間戳。在此日期之後,任何查詢object_with_object_properties表格或使用時間戳列檢視的嘗試都將失敗。
示例1
檢索所有聯系人及其屬性。
查詢:
從object_with_object_properties中
選擇objectTypeId、objectId、屬性,
其中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
, 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
)。
對象ID
數字
記錄的ID (例如, ID為123752的聯絡人記錄
)。
INGESTEDAT
時間戳
數據最後被Snowflake吞噬的日期和時間。進一步瞭解列資料類型。
示例1
檢索所有聯絡人記錄。
查詢:
從objectTypeId = '0-1'的對象
中
選擇objectTypeId、objectId
退貨:
OBJECTTYPEID
對象ID
0-1
36721864
0-1
103580363
0-1
56047670
...
...
object_properties
此資料庫對象是object_with_object_properties資料庫對象的子集。每行都包含給定記錄上設定的當前屬性值。例如,聯系人的姓氏屬性有一行,姓氏屬性有一行。如果記錄沒有屬性的值,行會顯示為空字串,或根本不會出現。
此資料庫對象可以傳回以下欄:
列名
類型
DESCRIPTION
OBJECTTYPEID
Varchar
對象類型的ID (例如,聯絡人為0-1
)。
對象ID
數字
記錄的ID (例如, ID為123752的聯絡人記錄
)。
姓名
Varchar
房源的名稱。
價值
時間戳
物業的價值。
UPDATEDAT
時間戳
上次在HubSpot中更新的日期和時間。進一步瞭解列資料類型。
INGESTEDAT
時間戳
數據最後被Snowflake吞噬的日期和時間。
示例1
檢索所有聯絡人的名字、姓氏和城市屬性。
查詢:
從objectTypeId = '0-1'的object_properties
中
選擇objectTypeId、objectId、name、value
和name IN ('firstname'、'lastname'、'city')按
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透視語法。
查詢:
從
(
SELECT objectId, name, value
FROM object_properties
WHERE objectTypeId = '0-1'
AND name IN ('firstname', 'lastname', 'lifecyclestage'))中
選擇objectId, firstname, lastname,
lifecyclestage
(MAX (value) FOR name IN ('firstname', 'lastname', 'lifecyclestage')) as p (objectId, firstname, lastname, lastname, lifecyclestage);
退貨:
OBJECTTYPEID
對象ID
名字
姓氏
LIFECYCLESTAGE
0-1
54325098
霍布斯
男爵
引線
0-1
96805401
米洛
黃金
引線
0-1
6922028
亨利
Riley
引線
...
...
...
...
...
對象_特性_歷史
此資料庫對象包含歷史屬性值。對於聯系人,它包含最新的45值。對於所有其他對象,它包含最近的20個值。顯示每個歷史屬性值的行。房源的現有價值由房源歷史中最新的UPDATEDAT時間戳決定。
此資料庫對象可以傳回以下欄:
列名
類型
DESCRIPTION
OBJECTTYPEID
Varchar
對象類型的ID (例如,聯絡人為0-1
)。
對象ID
數字
記錄的ID (例如, ID為123752的聯絡人記錄
)。
姓名
Varchar
房源的名稱。
價值
時間戳
物業的價值。
UPDATEDAT
時間戳
上次在HubSpot中更新數據的日期和時間。進一步瞭解列資料類型。
INGESTEDAT
時間戳
數據最後被Snowflake吞噬的日期和時間。
示例1
檢索單一聯絡人的單一屬性記錄。
查詢:
從object_properties_history中
選擇objectId、name、value、updatedAt ,
其中objectTypeId = '0-1'
和objectId = 136493192 ,
以及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
WHERE
object_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
檢索與特定聯絡人相關的所有交易。
查詢:
選擇
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_contact
contacts association_contact_to_deals associated 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
關聯定義的唯一識別碼。
類別
Varchar
關聯類型的來源。其中之一: HUBSPOT_DEFINED
、USER_DEFIED
、INTEGRATOR_DEFIED
身份證明文件
數字
其類別中的關聯定義的識別碼。
FROMOBJECTTYPEID
Varchar
作爲關聯定義來源的對象的ID。
TOOBJECTTYPEID
Varchar
作爲關聯定義的目標的對象的ID。
姓名
Varchar
關聯定義的名稱。
標籤
Varchar
關聯定義的標籤。
ISMAINASSOCIATIONDEFINITION
布爾值
關聯定義是否為主要類型。如果為true ,定義是HubSpot在相關記錄上顯示的定義。
INGESTEDAT
時間戳
數據最後被Snowflake吞噬的日期和時間。進一步瞭解列資料類型。
示例1
檢索帳戶中可用的關聯類型。
查詢:
選擇combinationAssociationTypeId , fromObjectTypeId , toObjectTypeId , name
FROM association_definition
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
檢索交易和公司之間的可用關聯類型。
查詢:
選擇
combinationAssociationTypeId , fromObjectTypeId , toObjectTypeId , name
FROM association_defitions ,
其中fromObjectTypeId = '0-3'和toObjectTypeId = '0-2'
和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
檢索所有關聯的交易和聯系人。
查詢:
從combinationAssociationTypeId = '0-5'的關聯
中選擇combinedAssociationTypeId、fromObjectId、toObjectId
退貨:
COMBINEDASSOCIATIONTYPEID
FROMOBJECTID
TOOBJECTID
0-5
6626541373
233620335
0-5
6616436082
3866015468
0-5
6690805943
7132752747
...
...
...
示例2
檢索與特定聯絡人關聯的所有工單(聯絡人ID : 3005 )。
查詢:
從associationCategory = 'HUBSPOT_DEFINED'和
combinedAssociationTypeId = '0-15'
且fromObjectId = 3005的相關聯中
選擇combodAssociationTypeId
、fromObjectId、toObjectId ;
退貨:
COMBINEDASSOCIATIONTYPE
FROMOBJECTID
TOOBJECTID
0-5
6626541373
233620335
示例3
檢索與特定聯絡人相關的所有交易(聯絡人ID : 4464 )。此示例使用 association_definition聯接,而不是硬編碼combAssociationTypeId。
查詢:
從中
選擇combinationAssociationTypeId = (
從
association
_defitions
中選擇combinedAssociationTypeId ,
其中fromObjectTypeId = '0-1'
和toObjectTypeId = '0-3'
和isMainAssociationDefinition)
和fromObjectId = 4464 ;
退貨:
COMBINEDASSOCIATIONTYPEID
FROMOBJECTID
TOOBJECTID
0-5
6626541373
233620335
所有者查詢
所有者
此資料庫對象包含有關您HubSpot帳戶中用戶的資訊。用戶可以設定為記錄擁有者,並且會根據其上下文包含用戶ID和擁有者ID。兩個ID可用於識別同一用戶。
此資料庫對象可以傳回以下欄:
列名
類型
DESCRIPTION
OWNERID
數字
用戶的所有者ID。
用戶ID
數字
用戶的用戶ID。已刪除此欄中為Null的用戶。
郵箱地址
Varchar
用戶的郵箱地址。
名字
Varchar
用戶的名字。
姓氏
Varchar
用戶的姓氏。
已存檔
布爾值
用戶是否已被刪除。
CREATEDAT
時間戳
用戶在HubSpot中建立的日期和時間。有關詳情,請參閱列資料類型。
UPDATEDAT
時間戳
用戶上次在HubSpot中更新的日期和時間。有關詳情,請參閱列資料類型。
INGESTEDAT
時間戳
數據最後被Snowflake吞噬的日期和時間。
示例1
檢索所有用戶。WHERE ARCHIVED = FALSE FILE
篩選器會從傳回的資料中移除刪除
查詢:
從所有者中
選擇ownerId, userId, email, firstname, lastname
WHERE archived = false
退貨:
OWNERID
用戶ID
郵箱地址
名字
姓氏
29584574
4621126
233620335
霍布斯
男爵
30532717
4874784
3866015468
Pablo
沃爾特斯
30580321
925511
7132752747
米洛
黃金
...
...
...
...
...
示例2
透過所有者ID檢索特定所有者。
查詢:
從ownerId = 29584574的所有者
中選擇ownerId、userId、
email、firstname、lastname ;
退貨:
OWNERID
用戶ID
郵箱地址
名字
姓氏
29584574
4621126
233620335
霍布斯
男爵
示例3
檢索所有聯系人及其所有者。此查詢將紀錄連結到擁有object_with_object_properties和contact屬性hubspot_owner_id的所有者。
選擇
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_contact
加入OWNERS OWNERS ON contact.property_hubspot_owner_id = owner.ownerId
退貨:
CONTACTID
聯系人名字
聯系人姓氏
聯系人_HUBSPOT_OWNER_ID
OWNER_FIRSTNAME
OWNER_LASTNAME
OWNER_EMAIL
113834202
Richard
格林菲爾德
29584574
霍布斯
男爵
hobbes.b@business.com
53540801
福特
卡爾
30241125
米洛
黃金
milo.g@business.com
...
...
...
...
...
...
...
管道查詢
在下方,瞭解如何查詢交易和門票管道資料,例如帳戶中的可用管道及其階段。
您可以使用對象數據加入此數據,以全面查看管道。例如,您可以使用管道數據連結object_deals_view或object_with_object_properties數據,以查詢交易及其管道。
管道
此資料庫對象包含有關您帳戶中的交易和工單管道的資訊。返回的每一行表示單一的管道。
此表可以返回以下列:
列名
類型
DESCRIPTION
PIPELINEID
Varchar
管道的ID。
OBJECTTYPEID
Varchar
管道可以包含的對象的ID (例如,交易或工單)。
標籤
Varchar
HubSpot中的管道名稱。
DISPLAYORDER
數字
管道在HubSpot中顯示的順序。
已存檔
布爾值
管道是否已刪除。
CREATEDAT
時間戳
管道建立時。
UPDATEDAT
時間戳
上次在HubSpot中更新數據的日期和時間。進一步瞭解列資料類型。
INGESTEDAT
時間戳
數據最後被Snowflake吞噬的日期和時間。
示例1
在HubSpot中尋找所有按其訂單排序的可用交易管道。
查詢:
選擇objectTypeId, pipelineId, label
FROM pipeline
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和管道。
查詢:
選擇
deals.objectId deal_id,
deals.property_dealname deal_name,
pipelines.label pipeline_name
FROM objects_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相同,在特定管道內檢索交易。但是,使用OBJECT_WITH_OBJECT_PROPERTY ,而不是在JOINS中使用OBJECT_DEALS。
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。
標籤
Varchar
舞臺的名字在HubSpot。
DISPLAYORDER
數字
管道在HubSpot中顯示的順序。
元數據
Variant
JSON格式的階段描述,包括是否開啟或關閉
已存檔
布爾值
管道階段是否已刪除。
CREATEDAT
時間戳
管道階段建立時。
示例1
檢索名為銷售管道的交易管道的管道階段。
查詢:
選擇pipelineid、stageId、label
FROM pipeline_stages
WHERE not archived
AND pipelineid = (
SELECT pipelineid
FROM pipeline
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
deal.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_stage
on deals.objectTypeId = pipeline_stages.pipelineid
AND deals.properties: pipeline:: string = pipeline_stages.pipelineid
AND deals.properties: dealstage: string = pipeline_stage.stageId
WHERE dealals.objectId = '0-3';
退貨:
DEAL_ID
DEAL_NAME
管道名稱
管道_舞臺_名稱
605140072
Meowmix全局注冊
銷售管道
合同已發送
605457408
Friskies Rebrand
銷售管道
Appt已安排
604362473
新建步驟應用程式構建
銷售管道
已簽訂的合同
...
...
...
...
旅居查詢
特性定義
此資料庫物件包含有關HubSpot帳戶中物件屬性和事件屬性的資訊。事件屬性包括標準事件(如電子郵件開啟和點擊)和自訂行為事件屬性。此資訊可能對於在object_properties和事件資料中找到的值有幫助。
您可以透過組合對象類型ID和名稱來識別特定屬性。您可以使用屬性API檢索類似資訊。
此資料庫對象可以傳回以下欄:
列名
類型
DESCRIPTION
OBJECTYPEID
Varchar
事件所關係的對象的ID。
姓名
Varchar
房源的內部名稱。
標籤
Varchar
房源標籤。
DESCRIPTION
Varchar
房源描述。
類型
Varchar
屬性的類型(例如字符串、數字、日期時間)。
FIELDTYPE
Varchar
房源的字段類型。定義屬性在HubSpot和表單上的顯示方式(例如,核取方塊,選擇)。
DISPLAYORDER
數字
房源的顯示順序。
羣名稱
Varchar
物業羣組名稱。
選項
Variant
對於列數屬性,屬性選項的陣列,包括每個選項的屬性(例如,顯示順序、標籤)。
CREATEDUSERID
數字
創建屬性的用戶的ID。
REFERENCEDOBJECTTYPE
Varchar
屬性引用的對象的類型。所有者屬性將傳回所有者的值。
已計算
布爾值
該屬性是否為計算屬性。
EXTERNALOPTIONS
布爾值
房源的選項是否在外部系統中定義。
HASUNIQUEVALUE
布爾值
房源的值是否唯一。只有在透過API建立屬性時才能設定。
隱藏
布爾值
房源是否隱藏在HubSpot中。
SHOWCURRENCYSYMBOL
布爾值
數字屬性值是否格式化為貨幣。
表單字段
布爾值
此屬性是否可以在窗體中使用。
READONLYDEFINITION
布爾值
是否可以在HubSpot中編輯此屬性。
READONLYVALUE
布爾值
是否可以在HubSpot中編輯屬性的值。
HUBSPOTDEFINED
布爾值
此屬性是否由HubSpot創建,而不是由用戶創建。
已存檔
布爾值
是否已刪除該屬性。
CREATEDAT
時間戳
在HubSpot中建立房源的日期和時間。
UPDATEDAT
時間戳
上次在HubSpot中更新數據的日期和時間。進一步瞭解列資料類型。
INGESTEDAT
時間戳
數據最後被Snowflake吞噬的日期和時間。
示例1
檢索所有聯絡人屬性的名稱和描述。
查詢:
從objectTypeId = '0-1'
的PROPERTY_DEFINITIONS
選擇
名稱、標籤、描述
退貨:
姓名
標籤
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
聯絡人瀏覽網站頁面。
您可以透過組合活動類型ID和ID來識別活動。傳回的欄位取決於活動,每個活動屬性有一個欄位。所有事件都會返回以下列:
請注意: HubSpot已在所有活動表格和視圖中新增兩列:
- 發生
時間
- 發生
日期
這些欄位將於2022年11月24日取代發生日期
欄位
和發生日期欄位。在該日期,舊欄將無法再使用,嘗試查詢使用這些欄位查詢包含事件的資料庫對象或檢視將失敗。了解更多關於破解雪花數據分享變更的資訊。
列名
類型
DESCRIPTION
EVENTTYPEID
Varchar
事件類型的ID ,類似於OBJECTTYPEID
您可以使用OBJECT_AND_EVENT_TYPE_DEFINIONS檢視查帳戶中的所有事件類型ID。
身份證明文件
Varchar
這是每種活動類型獨一無二的。在指定的事件類型中,沒有兩個記錄具有相同的ID。
OBJECTTYPEID
Varchar
完成事件的對象的類型。例如,電子郵件連結點擊會在此列中顯示0-1 ,代表聯絡對象。
對象ID
數字
完成事件的記錄的ID。
OCCURREDAT
時間戳
事件發生時。
OCCURREDATDATEINT
數字
表示事件發生時間的數字。包含與OCCURREDAT欄相同的資料,但格式化為數字,並用作表格羣組鍵的一部分。在大多數情況下,您可以使用OCCURREDAT
時間戳代替此號碼。
OCCUREDATDATEINT
數字
表示事件發生時間的數字。包含與OCCURREDAT欄相同的資料,但格式化為數字,並用作表格羣組鍵的一部分。在大多數情況下,您可以使用OCCURREDAT
時間戳代替此號碼。
請注意:此欄位將於2022年11月24日廃用,並由OCCUREDATDATEINT取代
。
OCCUREDAT
時間戳
事件發生時。
請注意:此欄位將於2022年11月24日廃用,並由OCCUREDAT取代
。
INGESTEDAT
時間戳
數據最後被Snowflake吞噬的日期和時間。進一步瞭解列資料類型。
房源_*
Varchar
包含事件屬性的單列。
示例1
檢索最新的50個電子郵件點擊事件。
查詢:
從EVENTS_CLICKED_LINK_IN_EMAIL_V2
ORDER BY OCCUREDAt , PROPERTY_HHS_CLICK_RAW_URL中
選擇eventTypeId , objectTypeId , objectId , occuredAt , PROPERTY_HHS_CLICK_RAW_URL AS HS_CLICK_
RAW_URL ;
退貨:
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結合來獲取聯絡資料。
查詢:
選擇
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帳戶中可用的所有物件和事件。
查詢:
從OBJECT_AND_EVENT_TYPE_DEFINIATIONS中
選擇objectTypeId, fullQualifiedName ;
退貨:
OBJECTTYPEID
FULLYQUALIFIEDNAME
0-1
聯系方式
0-8
LINE_ITEM
0-11
對話
...
...
列出查詢
在下方,瞭解如何查詢清單,例如可用的聯絡人和公司清單以及這些清單中包含的記錄。
列表
此資料庫對象包含有關HubSpot聯絡人和公司清單的資訊。傳回每個清單一行,列包含清單細節,如清單名稱、大小及其所含記錄的對象類型。不包含每個清單中個別記錄的資訊(請參閱LIST_MEMBILITION )。
此資料庫對象可以傳回以下欄:
列名
類型
DESCRIPTION
OBJECTTYPEID
Varchar
清單中的記錄類型(例如,聯絡人或公司)。
LISTID
數字
列表的ID。加入列表會員表中的LISTID列。
CLASSICLISTID
數字
特定於聯系人列表的ID ,與HubSpot中列表URL中的ID匹配。
姓名
Varchar
列表的名稱。
尺寸
數字
列表中的條目數。
CREATEDBYUSERID
數字
建立清單的用戶的ID。
CREATEDAT
時間戳
在HubSpot中建立清單時。
UPDATEDBYUSERID
數字
最近更新列表的用戶的ID。
UPDATEDAT
時間戳
上次在HubSpot中更新日期的日期和時間。進一步瞭解列資料類型。
INGESTEDAT
時間戳
數據最後被Snowflake吞噬的日期和時間。
示例1
檢索所有聯系人列表。
查詢:
從objectTypeId = '0-1'
的列表
中
選擇listId、name、size ;
退貨:
LISTID
姓名
尺寸
118131
每周外聯
103
66156
博客訂閱者
455
771852
2021年排名前茅的訂閱者
37
...
...
...
示例2
檢索名爲Top subscribers 2021的特定聯系人列表。
查詢:
從objectTypeId = '0-1'
和
listName
= 'Top subscribers 2021'的列表中
選擇listId、name、size ;
退貨:
LISTID
姓名
尺寸
771852
2021年排名前茅的訂閱者
37
list_membership
此資料庫對象包含有關哪些記錄是哪些清單成員的資訊,每項記錄在清單中有一行。例如,如果您有包含500個聯絡人的網誌訂閱者清單,則資料庫對象將傳回500行。
僅包含列表ID和對象ID。如需更多資訊,請加入清單資料庫對象。
此資料庫對象可以傳回以下欄:
列名
類型
DESCRIPTION
LISTID
Varchar
列表的ID。加入列表表中的HS_LIST_ID列。
對象ID
Varchar
列表中條目的ID。
UPDATEDAT
時間戳
上次在HubSpot中更新數據的日期和時間。進一步瞭解列資料類型。
INGESTEDAT
時間戳
數據最後被Snowflake吞噬的日期和時間。
示例1
檢索「頂尖訂閱者2021」清單中所有聯絡人的ID。
查詢:
從list_memberships
內部連結列表list_memberships.listId
= lists.listId中
選擇objectId ,
其中lists.objectTypeId = '0-1'
和lists.name = 'Top Subscribers 2021' ;
退貨:
對象ID
54325098
96805401
6922028
...
示例2
在2021年頂級訂閱者清單中檢索聯絡人詳細資料的名字和姓氏。
查詢:
選擇
contact.objectId as objectid,
contact.property_firstname as firstname,
contact.property_lastname as lastname
FROM objects_contact contact
INNER JOIN list_memberships on contact.objectId = list_memberships.objectId
INNER JOIN list 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 :
從PROPERTY_DEFINIONS中
選擇*
其中label = [column_name]
由於某些旅居名稱通常會在應用程式上解析為更具描述性的名稱,因此可能不總是完全匹配。在這種情況下,使用PROPERTY_DEFINITIONS中的標籤(甚至說明)欄中的類似數字來進行模糊搜尋可能會有所幫助。
在確定欄位屬於哪種物件類型後,決定要查詢甚麼是微不足道的。您可以輕鬆搜尋對應類型的object_x視圖。
如何將此資料類型連結到另一個資料類型,例如如何檢索活動的表單?
如果您需要將兩個或多個不同的記錄連結到對方,請查看關聯。關聯代表HubSpot CRM中物件之間的關係。兩種類型之間可能的所有不同關聯都列於association_definition中。在上面的示例中,要了解所有與廣告活動相關的表格,您需要查詢ASSOCIATIONS_CAMPATS_TO_FORMS :
選擇campaigns.property_hs_name campaign_name,
forms.property_hs_form_id form_id
FROM objects_campaign
association_campaign_to_form assoc on
assoc.campaign_objectid = campaigns.objectid
JOIN objects_formons on form.objectid = assoc.form_objectid
GROUP BY campaign_name
Reports
Thank you for your feedback, it means a lot to us.
This form is used for documentation feedback only. Learn how to get help with HubSpot.
目錄
/zh-tw/reports/query-hubspot-data-in-snowflake?