查詢雪花中的HubSpot數據
上次更新時間: 五月 31, 2024
可与下列任何一种订阅一起使用,除非有说明:
Operations Hub Enterprise |
將Snowflake連接到您的HubSpot帳戶後,您可以使用Snowflake的數據共享從您的Snowflake帳戶查詢HubSpot數據。
資料延遲和您的Snowflake帳戶區域
您將可以訪問每15分鐘更新一次的V2_LIVE模式,以及每天更新的V2_DAILY模式。
請注意: V2_LIVE架構中的以下檢視僅每日更新: ASSOCIATION_DEFINITIONS、OWNERS、PIPELINES和PIPELINE_STAGES。
設定您的雪花環境
若要查詢雪花中的HubSpot資料,您需要選擇要查詢的倉庫、資料庫和架構。您可以將它們設定在工作表層級,以自動將它們包含在查詢中,也可以手動新增它們。
要在工作表層級選擇倉庫、資料庫和架構:
- 在工作表頂行中,按一下工作表操作列。
- 在彈出窗口中:
- 按一下倉庫下拉選單,然後選擇你的倉庫。
- 按一下資料庫下拉菜單,然後選擇您的HubSpot資料庫。
- 單擊架構下拉菜單,然後選擇要使用的架構:
- V2_DAILY :根據表格查詢資料的每日模式。此架構中的數據每天更新一次。使用此架構將導致更快的查詢,並建議直接在Snowflake中查詢。
- V2_LIVE :基於Secure Views of HubSpot數據的實時架構。此架構中的資料最多每15分鐘更新一次。如果你正在查詢大量資料,查詢速度可能會很慢。在這種情況下,建議首先使用ETL流程將資料複製到自己的表格中,然後查詢該表格。
配置環境後,您可以對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;
列數據類型
查詢雪花中的資料時,傳回的欄位取決於您要查詢的資料。您可以透過選擇左側邊欄中的檢視方式,在「雪花」中查看指定表格或檢視方式的可用欄位。
請注意:在本文檔的剩餘部分,當上下文適用於表格和檢視時,我們會使用「資料庫對象」一詞。
若要傳回特定欄位,請在查詢SELECT
欄位中包含該欄位。例如,以下查詢將只返回OBJECTID
和UpdatedAt
列:
SELECTobjectId, updatedAt
FROM objects_contacts
以下是查詢可能傳回的欄的一般定義。如需其他未包含的定義,請參閱上方文章中的個別檢視定義。
- OBJECTTYPEID :表示物件類型的VARCHAR值。例如, 0-1表示聯系人對象, 0-2表示公司對象, 2-1232可能表示您帳戶中的自訂對象。在列表中,這指的是列表類型(例如,聯絡人或公司)。您可以使用OBJECT_AND_EVENT_TYPE_DEFINIONS檢視功能查詢帳戶中的所有對象和活動ID。
- OBJECTID :一個BIGINT數字,表示HubSpot帳戶中給定類型物件的單個記錄。若要識別記錄,您需要使用物件類型ID和物件ID。
- INGESTEDAT :一行數據被添加到Snowflake的時間戳記,由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數據分別轉換為它們的NUMBER和DATETIME類型:
SELECT objectid, value AS amount_str, try_to_number(value) AS amountFROM 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 |
用於與潛在買家分享價格資訊。 |
|
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所指定) ,將會有兩欄:
|
示例1
檢索所有聯絡人的名字、姓氏和生命周期階段。
查詢:
SELECT objectId, property_firstname AS firstname, property_lastname AS lastname,property_lifecyclestage AS lifecyclestageFROM objects_contact
退貨:
對象ID |
名字 |
姓氏 |
LIFECYCLESTAGE |
54325098 |
霍布斯 |
男爵 |
引線 |
96805401 |
米洛 |
黃金 |
引線 |
6922028 |
亨利 |
Riley |
引線 |
示例2
檢索最多三項交易的交易名稱和階段。
查詢:
SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmountFROM 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 dealAmountFROM 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
檢索最多三個交易的交易名稱和階段。
查詢:
SELECTobjectId,
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
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
檢索與特定聯絡人相關的所有交易。
查詢:
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
檢索交易和公司之間的可用關聯類型。
查詢:
SELECT
combinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
WHERE fromObjectTypeId = '0-3' AND toObjectTypeId = '0-2'
AND isMainAssociationDefinition = trueORDER 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
檢索所有交易及其各自的管道階段。
查詢:
SELECTdeals.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日取代occuredat
和occuredatdateint
欄位。在該日期,舊欄將無法再使用,嘗試查詢使用這些欄位查詢包含事件的資料庫對象或檢視將失敗。了解更多關於破解雪花數據分享變更的資訊。
列名 | 類型 | DESCRIPTION |
EVENTTYPEID |
Varchar | 事件類型的ID ,類似於OBJECTTYPEID 您可以使用OBJECT_AND_EVENT_TYPE_DEFINIONS檢視查帳戶中的所有事件類型ID。 |
ID |
Varchar | 這是每種活動類型獨一無二的。在指定的事件類型中,沒有兩個記錄具有相同的ID。 |
OBJECTTYPEID |
Varchar | 完成事件的對象的類型。例如,電子郵件連結點擊將顯示在此列0-1 中,代表聯絡人物件。 |
OBJECTID |
數字 | 完成事件的記錄的ID。 |
OCCURREDAT |
時間戳 | 事件發生時。 |
|
數字 | 表示事件發生時間的數字。包含與OCCURREDAT 列相同的數據,但格式化爲數字並用作表的集羣鍵的一部分。在大多數情況下,您可以使用OCCURREDAT 時間戳記而不是此數字。 |
|
數字 | 表示事件發生時間的數字。包含與 請注意:此欄將於2022年11月24日停用,並替換為 |
OCCUREDAT |
時間戳 | 事件發生時。 請注意:此欄將於2022年11月24日停用,並替換為 |
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'
ANDlistName = '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 |
此視圖按逆向時間順序提供有關整合狀態的更新。將此查詢的結果整合到控制面板中,將有助於您跟蹤整合的性能,並檢測任何停機或中斷。