ข้ามไปที่เนื้อหา
HubSpot ฐานความรู้
โปรดทราบ:: บทความนี้จัดทำขึ้นเพื่อความสะดวกของคุณ ได้รับการแปลโดยอัตโนมัติโดยใช้ซอฟต์แวร์การแปลและอาจไม่ได้รับการพิสูจน์อักษร บทความฉบับภาษาอังกฤษนี้ควรถือเป็นฉบับทางการที่คุณสามารถค้นหาข้อมูลล่าสุดได้มากที่สุด คุณสามารถเข้าถึงได้ที่นี่

สืบค้นข้อมูล HubSpot ใน Snowflake

อัปเดตล่าสุด: 28 กันยายน 2026

สามารถใช้ได้กับการสมัครใช้บริการใดๆ ต่อไปนี้ ยกเว้นที่ระบุไว้:

หลังจาก เชื่อมต่อ Snowflake กับบัญชี HubSpot ของคุณแล้วคุณสามารถใช้ Snowflake's Data Share เพื่อค้นหาข้อมูล HubSpot จากบัญชี Snowflake ของคุณได้

ความล่าช้าของข้อมูลและภูมิภาคบัญชี Snowflake ของคุณ

คุณจะสามารถเข้าถึงรูปแบบ V2_LIVE ซึ่งอัปเดตทุก 15 นาทีและรูปแบบ V2_DAILY ซึ่งอัปเดตทุกวัน

โปรดทราบ: มุมมองต่อไปนี้ใน V2_LIVE SCHEMA จะได้รับการอัปเดตทุกวันเท่านั้น: ASSOCIATION_DEFINITIONS เจ้าของท่อและ PIPELINE_STAGES

ตั้งค่าสภาพแวดล้อม Snowflake ของคุณ

หากต้องการสืบค้นข้อมูล HubSpot ของคุณใน Snowflake คุณจะต้องเลือกคลังสินค้าฐานข้อมูลและสคีมาที่คุณต้องการสืบค้น คุณสามารถตั้งค่าไว้ที่ระดับเวิร์กชีตเพื่อรวมไว้ในข้อซักถามของคุณโดยอัตโนมัติหรือจะเพิ่มด้วยตนเองก็ได้

วิธีเลือกคลังสินค้าฐานข้อมูลและสคีมาของคุณในระดับเวิร์กชีต:

  1. ในแถวบนสุดของเวิร์กชีตให้คลิกแถบการทำงาน ของเวิร์กชีต

    snowflake-worksheet-settings0
  2. ในหน้าต่างป๊อปอัป:
    • คลิกเมนูแบบเลื่อนลงคลังสินค้า จากนั้นเลือกคลังสินค้าของคุณ
    • คลิกเมนูแบบเลื่อนลงฐานข้อมูล จากนั้นเลือกฐานข้อมูล HubSpot ของคุณ
    • คลิกเมนูแบบเลื่อนลง Schema จากนั้นเลือก Schema ที่คุณต้องการใช้:
        • V2_DAILY: แผนผังรายวันในการสืบค้นข้อมูลตามตาราง ข้อมูลในสคีมานี้จะได้รับการอัปเดตวันละครั้ง การใช้สคีมานี้จะส่งผลให้เกิดการสืบค้นที่เร็วขึ้นและแนะนำให้ใช้สำหรับการสืบค้นโดยตรงใน Snowflake
        • V2_LIVE: สคีมาแบบสดตาม Secure Views ของข้อมูล HubSpot ข้อมูลในสคีมานี้จะได้รับการอัปเดตทุกๆ 15 นาที หากคุณกำลังสอบถามข้อมูลชุดใหญ่การสอบถามอาจช้า ในกรณีนี้ขอแนะนำให้คัดลอกข้อมูลลงในตารางของคุณเองก่อนด้วย กระบวนการ ETL จากนั้นค้นหาตารางนั้น


      snowflake-worksheet-settings-window0

ด้วยการกำหนดค่าสภาพแวดล้อมของคุณคุณสามารถทำการสืบค้นไปยังข้อมูล HubSpot ของคุณโดยไม่จำเป็นต้องเพิ่มฐานข้อมูลหรือประเภทสคีมาของคุณไปยังการสืบค้นด้วยตนเอง

หากต้องการเพิ่มฐานข้อมูลและประเภทสคีมาของคุณลงในการค้นหาด้วยตนเองให้เพิ่มชื่อฐานข้อมูลตามด้วยสคีมาที่จุดเริ่มต้น FROM ของฟิลด์ ตัวอย่างเช่น:

 

เลือก objectTypeId, objectId, updatedAt

จาก hubspot_share_name.V2_LIVE.objects

โดยที่ objectTypeId = '0 -3'

จำกัด 1;

ภาพรวมข้อมูล

ข้อความค้นหาถูกสร้างขึ้นโดยใช้ SQL และสามารถใช้เพื่อดึงข้อมูล HubSpot เช่น:

  • วัตถุ: วัตถุมาตรฐานและวัตถุที่กำหนดเองเช่นรายชื่อผู้ติดต่อบริษัทผลิตภัณฑ์ 
  • บันทึก: บันทึกส่วนบุคคลเช่นการติดต่อส่วนบุคคลหรือบริษัท 
  • การเชื่อมโยง: ประเภทการเชื่อมโยง ที่มีอยู่ทั้งหมดและระเบียนที่เกี่ยวข้องในปัจจุบัน
  • กิจกรรม: ข้อมูลกิจกรรมสำหรับทั้งกิจกรรม HubSpot มาตรฐานเช่นการเปิดอีเมลและกิจกรรมพฤติกรรมที่กำหนดเอง
  • เซกเมนต์: ผู้ติดต่อ HubSpot และเซกเมนต์บริษัท
  • เจ้าของ: ผู้ใช้ในบัญชี HubSpot ของคุณที่เกี่ยวข้องกับบันทึกที่พวกเขาได้รับการตั้งค่าให้เป็นเจ้าของ
  • ไปป์ไลน์: ไปป์ไลน์ deal และ ticket รวมถึงขั้นตอนไปป์ไลน์
  • พร็อพ เพอร์ตี้ : พร็อพเพอร์ตี้และคุณค่าของพร็อพเพอร์ตี้ในบันทึก CRM รวมถึง

เรียนรู้เพิ่มเติมเกี่ยวกับโมเดลข้อมูล CRM ของ HubSpot 

โปรดทราบ: ในขณะที่เราปรับปรุงการแชร์ข้อมูลเราจะนำเสนอการเปลี่ยนแปลงบางส่วนทำลายการเปลี่ยนแปลง ขอแนะนำให้สมัครสมาชิกบันทึกการเปลี่ยนแปลงนักพัฒนาซอฟต์แวร์ของ HubSpot การเปลี่ยนแปลง เหล่านี้จะถูกโพสต์ลงในบันทึกการเปลี่ยนแปลงล่วงหน้าก่อนการอัพเดทใดๆเสมอ

การจำกัดและการสั่งซื้อข้อมูลที่ส่งคืน

เมื่อสร้างข้อความค้นหาคุณสามารถควบคุมจำนวนข้อมูลที่ส่งคืนพร้อมกับลำดับการส่งคืนโดยการรวมLIMITและORDER BYในข้อความค้นหาของคุณ ตัวอย่างเช่นในการสอบถามผู้ติดต่อทั้งหมดที่มีคุณสมบัติของพวกเขาแต่แสดงผลเพียงสามผลลัพธ์และเรียงลำดับตาม ID ผู้ติดต่อคุณสามารถสร้างการสอบถามของคุณดังนี้:

 

เลือก objectTypeId, updatedAt, ingestedAt

จากออบเจ็กต์

WHERE objectTypeId = '0 -1'

สั่งซื้อตาม ObjectId

จำกัด 10;

ประเภทข้อมูลคอลัมน์

เมื่อสืบค้นข้อมูลใน Snowflake คอลัมน์ที่ส่งคืนจะขึ้นอยู่กับข้อมูลที่คุณกำลังสืบค้น คุณสามารถดูคอลัมน์ที่มีอยู่สำหรับตารางหรือมุมมองที่กำหนดใน Snowflake โดยเลือกมุมมองในแถบด้านซ้าย

โปรดทราบ: สำหรับส่วนที่เหลือของเอกสารนี้เราใช้คำว่าอ็อบเจ็กต์ฐานข้อมูลเมื่อบริบทนำไปใช้กับทั้งตารางและมุมมอง

snowflake-sidebar-view-column-details0

ในการส่งคืนคอลัมน์ที่ระบุให้รวมคอลัมน์นั้นไว้ในฟิลด์ของการค้นหาของคุณ ตัวอย่างเช่นข้อความค้นหาต่อไปนี้จะส่งกลับเฉพาะ OBJECTID และ UpdatedAt คอลัมน์

 

เลือก objectTypeId, updatedAt, ingestedAt

จากออบเจ็กต์

WHERE objectTypeId = '0 -1'

สั่งซื้อตาม ObjectId

จำกัด 10;

 

ด้านล่างนี้เป็นคำจำกัดความทั่วไปสำหรับคอลัมน์ที่ข้อความค้นหาอาจส่งกลับ สำหรับคำจำกัดความอื่นๆที่ไม่รวมอยู่ด้านล่างโปรดดูคำจำกัดความมุมมองส่วนบุคคลในบทความด้านบน

  • OBJECTTYPEID: ค่าตัวแปรที่แสดงถึงประเภทของวัตถุ ตัวอย่างเช่น 0 -1 หมายถึงออบเจ็กต์ผู้ติดต่อ 0 -2 หมายถึงออบเจ็กต์บริษัทและ 2 -1232 อาจ หมายถึงออบเจ็กต์ที่กำหนดเองในบัญชีของคุณ ในเซกเมนต์สิ่งนี้อ้างอิงถึงชนิดของเซกเมนต์ (ตัวอย่างเช่นการติดต่อหรือบริษัท) คุณสามารถค้นหาอ็อบเจ็กต์และรหัสกิจกรรมทั้งหมดในบัญชีของคุณโดยใช้มุมมอง OBJECT _AND_EVENT_ TYPE_DEFINITIONS
  • OBJECTID: หมายเลข BIGINT ที่แสดงถึงระเบียนเดียวของวัตถุประเภทที่กำหนดในบัญชี HubSpot ของคุณ ในการระบุระเบียนคุณต้องใช้ทั้ง ID ประเภทวัตถุและ ID วัตถุ
  • INGESTEDAT: การประทับเวลาเมื่อมีการเพิ่มแถวของข้อมูลลงใน Snowflake ซึ่งแสดงด้วยค่า TIMESTAMP_NTZ ไม่เกี่ยวข้องกับการประทับเวลาเชิงตรรกะของการดำเนินการสร้างหรืออัปเดตใน HubSpot
    • เนื่องจากการประมวลผลภายในของ HubSpot การประทับเวลาการกลืนกินของแถวอาจได้รับการอัปเดตแม้ว่าจะไม่มีคอลัมน์อื่นๆในแถวเปลี่ยนไปก็ตาม
    • เมื่อสร้าง กระบวนการ ETL ที่คัดลอกข้อมูลที่เปลี่ยนแปลงเมื่อเร็วๆนี้ขอแนะนำให้ตั้งคำถามของคุณตามการประทับเวลาการบริโภค นอกจากนี้หากโฟลว์ของคุณคัดลอกข้อมูลรายวันขอแนะนำให้คัดลอกข้อมูลจากสองวันก่อนหน้าเพื่อพิจารณาความล่าช้า
  • CREATEDAT และ UPDATEDAT: การประทับเวลาเชิงตรรกะเมื่อข้อมูลถูกสร้างขึ้นหรืออัปเดตใน HubSpot แสดงด้วยค่า TIMESTAMP_NTZ ตราประทับเวลาเหล่านี้จะตรงกับตราประทับเวลาใน HubSpot ตัวอย่างเช่นเวลาที่แสดงใน HubSpot สำหรับวันที่สร้างของระเบียนจะเหมือนกับการประทับเวลาใน คอลัมน์ CREATEDAT ใน Snowflake สิ่งเหล่านี้ไม่เกี่ยวข้องโดยตรงกับการประทับเวลาการบริโภคและไม่แนะนำให้ใช้ กระบวนการ ETL กับคุณสมบัติเหล่านี้
  • COMBINEDASSOCIATIONTYPE: ค่า VARCHAR ที่ ระบุคำจำกัดความของสมาคมที่ไม่ซ้ำกัน

กำลังแปลงประเภทข้อมูล

บางครั้งข้อมูลจะถูกส่งกลับจากการสืบค้นที่มีคอลัมน์ VARCHAR เมื่อมันเป็นที่ต้องการที่จะมีพวกมันเป็นประเภทที่แตกต่างกัน ในกรณีเช่นนี้ขอแนะนำให้แปลงชนิดข้อมูล VARCHAR เป็นชนิดที่ต้องการโดยใช้ฟังก์ชัน Snowflake ตัวอย่างเช่นคุณสมบัติของระเบียนออบเจ็กต์ถูกจัดเก็บเป็นชนิดข้อมูล VARCHAR ในออบเจ็กต์ฐานข้อมูลส่วนใหญ่แต่บางครั้งมีค่าจำนวนและวันที่และเวลา ฟังก์ชันเช่น:
try_to_number, try_to_timestamp_ntz สามารถใช้เพื่อแปลงข้อมูล VARCHAR เหล่านี้เป็น จำนวน และประเภท วันที่ ตามลำดับ:


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 เฉพาะพร้อมกับข้อมูลที่ส่งคืน 

ข้อมูลอ็อบเจ็กต์มีอยู่ในอ็อบเจ็กต์ฐานข้อมูลที่ใช้ร่วม กรองตาม objectTypeId เพื่อเรียกดูประเภทวัตถุเฉพาะ ใช้ OBJECT_WITH_OBJECT_PROPERTIES เมื่อคุณต้องการคุณสมบัติปัจจุบันสำหรับแต่ละเรคคอร์ด ค่าคุณสมบัติจะถูกเก็บไว้ในคอลัมน์ properties J SON ใช้ OBJECTS สำหรับแอตทริบิวต์บันทึกหลักและ OBJECT_PROPERTIES หรือ OBJECT_PROPERTIES_HISTORY สำหรับข้อมูล per-property


ชื่ออ็อบเจกต์ ObjectTypeId
รายชื่อผู้ติดต่อ 0 -1
บริษัท 0 -2
ไลน์ไอเท็ม 0 -8

วัตถุที่กำหนดเอง จะถูกกำหนด ID ในขณะที่สร้างและจะถูกระบุเป็น 2 - UNIQUE_ID ตัวอย่างเช่น 2 -12345 เรียนรู้เพิ่มเติมเกี่ยวกับ OBJECT_AND_EVENT_TYPE_DEFINITIONS

ดูรายละเอียดเพิ่มเติมใน OBJECT_WITH_OBJECT_PROPERTIES, OBJECT_PROPERTIES, OBJECT_PROPERTI

object_with_object_properties

ออบเจ็กต์ฐานข้อมูลนี้มีข้อมูลจากระเบียน HubSpot ของคุณ การสืบค้นไปยังอ็อบเจ็กต์ฐานข้อมูลนี้จะส่งกลับหนึ่งแถวสำหรับแต่ละระเบียนภายในอ็อบเจ็กต์ประเภท (เช่นระเบียนผู้ติดต่อทั้งหมดในอ็อบเจ็กต์ประเภทผู้ติดต่อ) คุณสมบัติทั้งหมดจะถูกเก็บไว้ในคอลัมน์ คุณสมบัติ ซึ่งเป็นคอลัมน์ Snowflake Variant/JSON 

มุมมองนี้สามารถแสดงคอลัมน์ต่อไปนี้:

ชื่อคอลัมน์ ประเภท คำอธิบาย
OBJECTTYPEID วาร์ชาร์ ID ของประเภทวัตถุ (เช่นผู้ติดต่อคือ 0-1)
OBJECTID หมายเลข ID ของระเบียน (เช่นระเบียนผู้ติดต่อที่มี ID ของ 123752)
PROPERTIES ตัวแปร ค่าคุณสมบัติของระเบียน
UPDATEDAT การประทับเวลา วันที่และเวลาที่บันทึกได้รับการอัปเดตครั้งล่าสุดใน HubSpot เรียนรู้เพิ่มเติมเกี่ยวกับ ประเภทข้อมูลคอลัมน์
INGESTEDAT การประทับเวลา วันที่และเวลาที่ข้อมูลเมื่อข้อมูลถูกกลืนกินครั้งสุดท้ายโดย Snowflake 

โปรดทราบ: ในวันที่ 25 มกราคม 2022 คอลัมน์การประทับเวลาในตารางและมุมมอง object_with_object_properties ซึ่งแสดงถึงวันที่และเวลาที่บันทึกวัตถุได้รับการอัปเดตครั้งล่าสุดใน HubSpot จะได้รับการอัปเดต เพื่อให้สอดคล้องกับวิธีการแสดงข้อมูลวันที่และเวลาในส่วนที่เหลือของการแชร์ข้อมูลเนื่องจากนี่เป็นการเปลี่ยนแปลงที่ผิดพลาดคอลัมน์ใหม่ซึ่งได้รับการปรับปรุงใหม่ได้ถูกเพิ่มลงในตารางและมุมมอง ในอีก 90 วันข้างหน้าคอลัมน์ใหม่ทั้งสองนี้จะอยู่ร่วมกันกับการประทับเวลาซึ่งเป็นคอลัมน์ที่พวกเขากำลังมองหาเพื่อแทนที่ ซึ่งจะเปิดโอกาสให้คุณเปลี่ยนไปใช้คอลัมน์ใหม่หลังจาก 90 วันในวันที่ 25 มกราคม 2022 การประทับเวลาคอลัมน์จะถูกลบออกจากตารางและมุมมอง หลังจากวันที่นี้ความพยายามในการสืบค้นตาราง object_with_object_properties หรือมุมมองโดยใช้คอลัมน์การประทับเวลาจะล้มเหลว

ตัวอย่างที่ 1

ดึงข้อมูลผู้ติดต่อและคุณสมบัติทั้งหมด

คำค้นหา:


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


ผลตอบแทน:

OBJECTTYPEID OBJECTID คุณสมบัติ
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;


ผลตอบแทน:

OBJECTID DEALNAME DEALSTAGE DEALAMOUNT
38960439 ชื่อดีล 1 closedlost 7488939
321740651 ชื่อดีล 1 closedwon 9292029
98392101 ชื่อดีล 1 closedlost 62626528

ออบเจ็ก

ออบเจ็กต์ฐานข้อมูลนี้เป็นชุดย่อยของข้อมูลในออบเจ็กต์ฐานข้อมูล object_with_object_properties แต่ละแถวที่ส่งคืนจะส่งกลับ ID ออบเจ็กต์สำหรับแต่ละเรคคอร์ด ออบเจ็กต์ฐานข้อมูลนี้จะส่งกลับระเบียนที่มีอยู่เท่านั้น เมื่อระเบียนถูกลบใน HubSpot ระเบียนนั้นจะถูกลบออกจากออบเจ็กต์ฐานข้อมูลนี้ ออบเจ็กต์ฐานข้อมูลนี้เป็นชุดย่อยของข้อมูลในตาราง object_with_object_properties แต่ละแถวที่ส่งคืนจะส่งกลับ ID ออบเจ็กต์สำหรับแต่ละเรคคอร์ด มุมมองนี้จะแสดงเฉพาะระเบียนที่มีอยู่เท่านั้น เมื่อระเบียนถูกลบใน HubSpot ระเบียนนั้นจะถูกลบออกจากมุมมองนี้ 

อ็อบเจ็กต์ฐานข้อมูลนี้มีข้อมูลอ็อบเจ็กต์ปัจจุบันที่ไม่มีค่า ใช้เมื่อคุณต้องการแอตทริบิวต์บันทึกหลักเท่านั้นหรือเข้าร่วมกับ OBJECT_PROPERTIES เมื่อคุณต้องการคุณสมบัติที่เลือก การใช้ออบเจ็กต์ฐานข้อมูลนี้กับออบเจ็กต์ฐานข้อมูล object_properties ทำให้สามารถทำซ้ำข้อมูลใน object_with_object_properties ได้ในขณะที่ยังคงควบคุมคุณสมบัติที่ส่งคืน

วัตถุฐานข้อมูลนี้สามารถส่งคืนคอลัมน์ต่อไปนี้:

ชื่อคอลัมน์ ประเภท คำอธิบาย
OBJECTTYPEID วาร์ชาร์ ID ของประเภทวัตถุ (เช่นผู้ติดต่อคือ 0-1)
OBJECTID หมายเลข ID ของระเบียน (เช่นระเบียนผู้ติดต่อที่มี ID ของ 123752)
INGESTEDAT การประทับเวลา วันที่และเวลาที่ข้อมูลถูกกลืนกินครั้งสุดท้ายโดยเกล็ดหิมะ เรียนรู้เพิ่มเติมเกี่ยวกับ ประเภทข้อมูลคอลัมน์

ตัวอย่างที่ 1

เรียกดูบันทึกการติดต่อทั้งหมด

คำค้นหา:


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


ผลตอบแทน:

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

object_properties

ออบเจ็กต์ฐานข้อมูลนี้เป็นชุดย่อยของ ออบเจ็กต์ฐานข้อมูล object_with_object_properties แต่ละแถวประกอบด้วยค่าคุณสมบัติปัจจุบันที่ตั้งไว้ในระเบียนที่กำหนด ตัวอย่างเช่นผู้ติดต่อจะมีหนึ่งแถวสำหรับที่พัก ชื่อ และหนึ่งแถวสำหรับที่พักนามสกุล หากระเบียนไม่มีค่าสำหรับคุณสมบัติแถวจะปรากฏด้วยสตริงว่างหรือจะไม่ปรากฏเลย

วัตถุฐานข้อมูลนี้สามารถส่งคืนคอลัมน์ต่อไปนี้:

ชื่อคอลัมน์ ประเภท คำอธิบาย
OBJECTTYPEID วาร์ชาร์ ID ของประเภทวัตถุ (เช่นผู้ติดต่อคือ 0-1)
OBJECTID หมายเลข ID ของระเบียน (เช่นระเบียนผู้ติดต่อที่มี ID ของ 123752)
NAME วาร์ชาร์ ชื่อที่พัก
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 OBJECTID ชื่อ ความคุ้มค่า
0 -1 10401 ชื่อ ไบรอัน
0 -1 10401 city ดับลิน
0 -1 10401 นามสกุล แกลลาเกอร์
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 OBJECTID ชื่อ นามสกุล LIFECYCLESTAGE
0 -1 54325098 ฮอบส์ บารอน นำ
0 -1 96805401 ไมโล ทอง นำ
0 -1 6922028 เฮนรี่ ไรลีย์ นำ
... ... ... ... ...

object_properties_history

วัตถุฐานข้อมูลนี้มีค่าคุณสมบัติในอดีต สำหรับผู้ติดต่อจะมี 45 ค่าล่าสุด สำหรับออบเจ็กต์อื่นๆทั้งหมดจะมี 20 ค่าล่าสุด แสดงแถวสำหรับแต่ละค่าคุณสมบัติในอดีต มูลค่าปัจจุบันของทรัพย์สินจะถูกกำหนดโดยการประทับเวลา UPDATEDAT ล่าสุดในประวัติของทรัพย์สิน

วัตถุฐานข้อมูลนี้สามารถส่งคืนคอลัมน์ต่อไปนี้:

ชื่อคอลัมน์ ประเภท คำอธิบาย
OBJECTTYPEID วาร์ชาร์ ID ของประเภทวัตถุ (เช่นผู้ติดต่อคือ 0-1)
OBJECTID หมายเลข ID ของระเบียน (เช่นระเบียนผู้ติดต่อที่มี ID ของ 123752)
NAME วาร์ชาร์ ชื่อที่พัก
VALUE การประทับเวลา มูลค่าของทรัพย์สิน
UPDATEDAT การประทับเวลา วันที่และเวลาที่ข้อมูลได้รับการอัปเดตครั้งล่าสุดใน HubSpot เรียนรู้เพิ่มเติมเกี่ยวกับ ประเภทข้อมูลคอลัมน์
INGESTEDAT การประทับเวลา วันที่และเวลาที่ข้อมูลถูกกลืนกินครั้งสุดท้ายโดยเกล็ดหิมะ 

ตัวอย่างที่ 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;

 
ผลตอบแทน:

OBJECTID ชื่อ ความคุ้มค่า 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'
);


ผลตอบแทน:

OBJECTID ชื่อ นามสกุล
54325098 ฮอบส์ บารอน
96805401 ไมโล ทอง
6922028 เฮนรี่ ไรลีย์
... ... ...

ข้อซักถามของสมาคม

ข้อมูลการเชื่อมโยงมีอยู่ ASSOCIATIONSใน กรองตาม combinedAssociationTypeId เพื่อเรียกดูประเภทการเชื่อมโยงที่เฉพาะเจาะจง เข้าร่วม ASSOCIATIONS กับ ASSOCIATION_DEFINITIONS เพื่อระบุประเภทวัตถุที่เกี่ยวข้องและคำจำกัดความของการเชื่อมโยง

association_definitions

ออบเจ็กต์ฐานข้อมูลนี้มีข้อมูลเกี่ยวกับประเภทการเชื่อมโยงที่มีอยู่ทั้งหมดระหว่างออบเจ็กต์ HubSpot โดยมีหนึ่งแถวต่อประเภทการเชื่อมโยง คุณสามารถเข้าร่วมออบเจ็กต์ฐานข้อมูลนี้กับออบ เจ็กต์ฐานข้อมูลการเชื่อมโยง เพื่อรับข้อมูลการเชื่อมโยงเฉพาะระเบียน

การเชื่อมโยงระหว่างออบเจ็กต์เดียวกันอาจมีได้หลายประเภท ประเภทการเชื่อมโยงหลักซึ่งเป็นประเภทที่แสดงใน HubSpot เมื่อมีการเชื่อมโยงระเบียนให้ใช้การเชื่อมโยงที่ ISMAINASSOCIATIONDEFINITION trueอยู่

วัตถุฐานข้อมูลนี้สามารถส่งคืนคอลัมน์ต่อไปนี้:

ชื่อคอลัมน์ ประเภท คำอธิบาย
COMBINEDASSOCIATIONTYPEID วาร์ชาร์ ตัวระบุที่ไม่ซ้ำกันของคำจำกัดความของสมาคม
CATEGORY วาร์ชาร์ แหล่งที่มาของประเภทสมาคม หนึ่งใน: HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED
ID หมายเลข ตัวระบุคำจำกัดความของสมาคมภายในหมวดหมู่
FROMOBJECTTYPEID วาร์ชาร์ ID ของวัตถุที่เป็นที่มาของคำจำกัดความของสมาคม
TOOBJECTTYPEID วาร์ชาร์ ID ของวัตถุที่เป็นปลายทางของคำจำกัดความของสมาคม
NAME วาร์ชาร์ ชื่อของคำจำกัดความของสมาคม
LABEL วาร์ชาร์ ฉลากของคำจำกัดความของสมาคม
ISMAINASSOCIATIONDEFINITION บูลีน คำจำกัดความของสมาคมเป็นประเภทหลักหรือไม่ เมื่อเป็นจริงคำจำกัดความคือคำจำกัดความที่ HubSpot แสดงในระเบียนที่เกี่ยวข้อง
INGESTEDAT การประทับเวลา วันที่และเวลาที่ข้อมูลถูกกลืนกินครั้งสุดท้ายโดยเกล็ดหิมะ เรียนรู้เพิ่มเติมเกี่ยวกับ ประเภทข้อมูลคอลัมน์

ตัวอย่างที่ 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 COMPANY_TO_CONTACT
0 -3 0 -3 0 -1 DEAL_TO_CONTACT
0 -4 0 -1 0 -3 CONTACT_TO_DEAL
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 DEAL_TO_COMAPNY_UNLABELED

สมาคม

อ็อบเจ็กต์ฐานข้อมูลนี้มีข้อมูลเกี่ยวกับการเชื่อมโยงระหว่างระเบียนเฉพาะ แต่ละแถวแสดงถึงการเชื่อมโยงจากวัตถุหนึ่งไปยังอีกวัตถุหนึ่ง แถวอาจมีอยู่ในออบเจ็กต์ฐานข้อมูลนี้แม้ว่าเรคคอร์ดที่อ้างอิงจะถูกลบไปแล้วก็ตาม คุณสามารถตรวจสอบว่ามีระเบียนอยู่หรือไม่โดยการเข้าร่วมกับตาราง วัตถุ

วัตถุฐานข้อมูลนี้มีระเบียนการเชื่อมโยงสำหรับทุกประเภทการเชื่อมโยง กรองตาม combinedAssociationTypeId และเข้าร่วมด้วย ASSOCIATION_DEFINITIONS เมื่อคุณต้องการข้อมูลเมตาการเชื่อมโยง

วัตถุฐานข้อมูลนี้สามารถส่งคืนคอลัมน์ต่อไปนี้:

ชื่อคอลัมน์ ประเภท คำอธิบาย
COMBINEDASSOCIATIONTYPEID วาร์ชาร์ ตัวระบุที่ไม่ซ้ำกันของคำจำกัดความของสมาคม
FROMOBJECTID หมายเลข ID ของออบเจ็กต์ต้นทาง
TOOBJECTID หมายเลข ID ของวัตถุปลายทาง
INGESTEDAT การประทับเวลา วันที่และเวลาที่ข้อมูลถูกกลืนกินครั้งสุดท้ายโดยเกล็ดหิมะ เรียนรู้เพิ่มเติมเกี่ยวกับ ประเภทข้อมูลคอลัมน์

ตัวอย่างที่ 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) แทนที่จะใช้ hard-coding combinedAssociationTypeId ตัวอย่างนี้จะรวมเข้ากับ association_definitions

คำค้นหา:


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 สามารถใช้เพื่อระบุผู้ใช้เดียวกันได้ 

วัตถุฐานข้อมูลนี้สามารถส่งคืนคอลัมน์ต่อไปนี้:

ชื่อคอลัมน์ ประเภท คำอธิบาย
OWNERID หมายเลข ID เจ้าของผู้ใช้
USERID หมายเลข ID ผู้ใช้ของผู้ใช้ ลบผู้ใช้ที่มี ค่า NULL ในคอลัมน์นี้แล้ว
EMAIL วาร์ชาร์ ที่อยู่อีเมลของผู้ใช้
FIRSTNAME วาร์ชาร์ ชื่อของผู้ใช้
LASTNAME วาร์ชาร์ นามสกุลของผู้ใช้
ARCHIVED บูลีน ไม่ว่าผู้ใช้จะถูกลบหรือไม่
CREATEDAT การประทับเวลา วันที่และเวลาที่ผู้ใช้ถูกสร้างขึ้นใน HubSpot ดูประเภทข้อมูลคอลัมน์สำหรับข้อมูลเพิ่มเติม
UPDATEDAT การประทับเวลา วันที่และเวลาที่ผู้ใช้ได้รับการอัปเดตครั้งล่าสุดใน HubSpot ดูประเภทข้อมูลคอลัมน์สำหรับข้อมูลเพิ่มเติม
INGESTEDAT การประทับเวลา วันที่และเวลาที่ข้อมูลถูกกลืนกินครั้งสุดท้ายโดยเกล็ดหิมะ

ตัวอย่างที่ 1 

ดึงข้อมูลผู้ใช้ทั้งหมด WHERE archived = false ตัวกรองจะลบผู้ใช้ที่ถูกลบออกจากข้อมูลที่ส่งคืน

คำค้นหา:


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

 
ผลตอบแทน: 

OWNERID USERID อีเมล ชื่อ นามสกุล
29584574 4621126 233620335 ฮอบส์ บารอน
30532717 4874784 3866015468 พาโบล วอลเตอร์ส
30580321 925511 7132752747 ไมโล ทอง
... ... ... ... ...

ตัวอย่างที่ 2

ดึงข้อมูลเจ้าของเฉพาะตามรหัสเจ้าของ

คำค้นหา:


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


ผลตอบแทน: 

OWNERID USERID อีเมล ชื่อ นามสกุล
29584574 4621126 233620335 ฮอบส์ บารอน

ตัวอย่างที่ 3

ดึงข้อมูลผู้ติดต่อและเจ้าของทั้งหมด ข้อความค้นหานี้รวมระเบียนไปยังเจ้าของที่มี object_with_object_properties และคุณสมบัติ การติดต่อ hubspot_owner_id

 

เลือก

contact.objectId AS contact_id,

contact.properties: firstname:: สตริง AS CONTACT_FIRSTNAME,

contact.properties: lastname:: สตริง AS CONTACT_LASTNAME,

contact.properties: hubspot_owner_id:: number AS contact_hubspot_owner_id,

owner.firstname AS owner_firstname,

owner.lastname AS owner_lastname,

owner.email AS owner_email

จาก OBJECT_WITH_OBJECT_ PROPERTI

เข้าร่วมกับเจ้าของในฐานะ เจ้าของ

ON contact.properties: hubspot_owner_id:: number = owner.ownerId

ในกรณีที่ contact.objectTypeId = '0 -1 ';

 


ผลตอบแทน: 

CONTACTID CONTACT_FIRSTNAME CONTACT_LASTNAME ติดต่อ_HUBSPOT_OWNER_ID OWNER_FIRSTNAME OWNER_LASTNAME OWNER_EMAIL
113834202 ริชาร์ด กรีนฟิลด์ 29584574 ฮอบส์ บารอน hobbes.b@business.com
53540801 ฟอร์ด คาร์ล 30241125 ไมโล ทอง milo.g@business.com
... ... ... ... ... ... ...

ข้อซักถามของทีม

ทีม

Teams ใน HubSpot ช่วยให้คุณจัดระเบียบผู้ใช้ของคุณเป็นกลุ่มเพื่อวัตถุประสงค์ในการจัดองค์กรและการรายงาน คุณสามารถมีทีมหลักและทีมพิเศษได้

อ็อบเจ็กต์ฐานข้อมูลนี้มีข้อมูลเกี่ยวกับทีมในบัญชี HubSpot ของคุณ 

วัตถุฐานข้อมูลนี้สามารถส่งคืนคอลัมน์ต่อไปนี้:

ชื่อคอลัมน์ ประเภท คำอธิบาย
TEAMID หมายเลข ID ทีม
TEAMNAME วาร์ชาร์ ชื่อทีม
PARENTTEAMID หมายเลข ID ทีมของทีมแม่
CHILDTEAMIDS อาร์เรย์ ID ทีมของทีมย่อย
PRIMARYOWNERMEMBERS วาร์ชาร์ ID เจ้าของของสมาชิกหลักของทีม
SECONDARYOWNERMEMBERS บูลีน ID เจ้าของของสมาชิกรองของทีม
INGESTEDAT การประทับเวลา วันที่และเวลาที่ข้อมูลถูกกลืนกินครั้งสุดท้ายโดยเกล็ดหิมะ 

ตัวอย่างที่ 1

ดึงข้อมูลทุกทีม

คำค้นหา:

SELECT teamId,teamName, primaryOwnerMembers

จากทีม

ผลตอบแทน:

TEAMID TEAMNAME PRIMARYOWNERMEMBERS
29584574 ทีมย่อย [233620335, 1234553]
30532717 ซูเปอร์ทีม [3866015468, 126221873]
3058032 ทีม [7132752747]

owner_team

อ็อบเจ็กต์ฐานข้อมูลนี้มีข้อมูลเกี่ยวกับเจ้าของที่สอดคล้องกับทีมใดในบัญชี HubSpot ของคุณ 

วัตถุฐานข้อมูลนี้สามารถส่งคืนคอลัมน์ต่อไปนี้:

ชื่อคอลัมน์ ประเภท คำอธิบาย
TEAMID หมายเลข ID ทีม
OWNERID หมายเลข ID เจ้าของผู้ใช้ 
ISTEAMPRIMARY บูลีน ไม่ว่าทีมนี้จะเป็นทีมหลักสำหรับเจ้าของทีมนี้
INGESTEDAT การประทับเวลา วันที่และเวลาที่ข้อมูลถูกกลืนกินครั้งสุดท้ายโดยเกล็ดหิมะ 

ตัวอย่างที่ 1

เรียกคืนเจ้าของทั้งหมดสำหรับทีมที่กำหนด

คำค้นหา:

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

ผลตอบแทน

TEAMID TEAMNAME ISTEAMPRIMARY
29584574 233620335 จริง
29584574 1234553 จริง 

การสอบถามไปป์ไลน์

ด้านล่างเรียนรู้วิธีค้นหาข้อตกลงและข้อมูลท่อส่งตั๋วเช่นท่อส่งที่มีอยู่ในบัญชีของคุณและขั้นตอนของพวกเขา

คุณสามารถรวมข้อมูลนี้เข้ากับข้อมูลวัตถุเพื่อดูท่อของคุณแบบเต็มรูปแบบได้ ตัวอย่างเช่นคุณสามารถสอบถามข้อเสนอและท่อส่งโดยเข้าร่วม object_with_object_properties pipelinesกับ 

ท่อส่งน้ำ

อ็อบเจ็กต์ฐานข้อมูลนี้มีข้อมูลเกี่ยวกับข้อตกลงและท่อส่งตั๋วในบัญชีของคุณ แต่ละแถวที่ส่งคืนแสดงถึงท่อเดียว

ตารางนี้สามารถส่งคืนคอลัมน์ต่อไปนี้:

ชื่อคอลัมน์ ประเภท คำอธิบาย
PIPELINEID วาร์ชาร์ ID ของท่อ
OBJECTTYPEID วาร์ชาร์ ID ของวัตถุที่ไปป์ไลน์สามารถมีได้ (เช่นข้อตกลงหรือตั๋ว) The ID of the object that the pipeline can contain (e.g., deals or ticket).
LABEL วาร์ชาร์ ชื่อของ pipeline ใน HubSpot
DISPLAYORDER หมายเลข ลำดับที่ท่อแสดงใน HubSpot
ARCHIVED บูลีน ไม่ว่าจะเป็นท่อที่ถูกลบไปแล้วหรือไม่
CREATEDAT การประทับเวลา เมื่อสร้างไปป์ไลน์
UPDATEDAT การประทับเวลา วันที่และเวลาที่ข้อมูลได้รับการอัปเดตครั้งล่าสุดใน HubSpot เรียนรู้เพิ่มเติมเกี่ยวกับ ประเภทข้อมูลคอลัมน์
INGESTEDAT การประทับเวลา วันที่และเวลาที่ข้อมูลถูกกลืนกินครั้งสุดท้ายโดยเกล็ดหิมะ 

ตัวอย่างที่ 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.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';

 

ผลตอบแทน: 

ID_ข้อเสนอ

DEAL_NAME

PIPELINE_NAME

605140072

ลงชื่อสมัครใช้ Meowmix Global

ขั้นตอนการขาย

605457408

Friskies Rebrand

ขั้นตอนการขาย

604362473

บิลด์ Fresh Step App

ขั้นตอนการขาย

pipeline_stages

มุมมองนี้มีข้อมูลเกี่ยวกับแต่ละขั้นตอนภายในไปป์ไลน์ ระบุขั้นตอนโดยการรวม ID ประเภทวัตถุ ID ไปป์ไลน์และ ID ขั้นตอน เมื่อเข้าร่วมกับ ไปป์ไลน์ให้ใช้ ID ประเภทวัตถุและ ID ไปป์ไลน์

วัตถุฐานข้อมูลนี้สามารถส่งคืนคอลัมน์ต่อไปนี้:

ชื่อคอลัมน์ ประเภท คำอธิบาย
PIPELINEID วาร์ชาร์ ID ของท่อ
STAGEID วาร์ชาร์ บัตรประจำตัวของสเตจ
LABEL วาร์ชาร์ ชื่อสเตจใน HubSpot
DISPLAYORDER หมายเลข ลำดับที่ท่อแสดงใน HubSpot
METADATA ตัวแปร คำอธิบายที่จัดรูปแบบ 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';


ผลตอบแทน: 

ID_ข้อเสนอ DEAL_NAME PIPELINE_NAME PIPELINE_STAGE_NAME
605140072 ลงชื่อสมัครใช้ Meowmix Global ขั้นตอนการขาย ส่งสัญญาแล้ว
605457408 Friskies Rebrand ขั้นตอนการขาย กำหนดเวลา Appt แล้ว
604362473 บิลด์ Fresh Step App ขั้นตอนการขาย ลงนามในสัญญาแล้ว
... ... ... ...

การสืบค้นที่พัก

property_definitions

อ็อบเจ็กต์ฐานข้อมูลนี้มีข้อมูลเกี่ยวกับ คุณสมบัติอ็อบ เจ็กต์และคุณสมบัติกิจกรรมในบัญชี HubSpot ของคุณ คุณสมบัติของกิจกรรมประกอบด้วยกิจกรรมมาตรฐานเช่นการเปิดและคลิกอีเมลและคุณสมบัติของ กิจกรรมพฤติกรรมที่กำหนดเอง ข้อมูลนี้จะเป็นประโยชน์สำหรับการกำหนดค่าที่พบในข้อมูล object_properties และ เหตุการณ์

คุณสามารถระบุคุณสมบัติเฉพาะได้โดยการรวม ID และชื่อประเภทวัตถุเข้าด้วยกัน คุณสามารถดึงข้อมูลที่คล้ายกันได้โดยใช้ API คุณสมบัติ

วัตถุฐานข้อมูลนี้สามารถส่งคืนคอลัมน์ต่อไปนี้:

ชื่อคอลัมน์ ประเภท คำอธิบาย
OBJECTYPEID วาร์ชาร์ ID ของวัตถุที่เกี่ยวข้องกับเหตุการณ์
NAME วาร์ชาร์ ชื่อภายในของที่พัก
LABEL วาร์ชาร์ ฉลากของที่พัก
DESCRIPTION วาร์ชาร์ รายละเอียดที่พัก
TYPE วาร์ชาร์ ประเภทที่พัก (เช่นสตริงหมายเลขวันที่และเวลา)
FIELDTYPE วาร์ชาร์ ประเภทฟิลด์ของที่พัก กำหนดวิธีแสดงคุณสมบัติใน HubSpot และในแบบฟอร์ม (เช่นช่องทำเครื่องหมายเลือก)
DISPLAYORDER หมายเลข ลำดับการแสดงผลของที่พัก
GROUPNAME วาร์ชาร์ ชื่อกลุ่มของที่พัก
OPTIONS ตัวแปร สำหรับคุณสมบัติการแจกแจงอาร์เรย์ของตัวเลือกของที่พักรวมถึงแอตทริบิวต์ของแต่ละตัวเลือก (เช่นลำดับการแสดงผลป้ายกำกับ)
CREATEDUSERID หมายเลข ID ของผู้ใช้ที่สร้างที่พัก
REFERENCEDOBJECTTYPE วาร์ชาร์ ประเภทของออบเจ็กต์ที่พักอ้างอิง ที่พักของเจ้าของจะส่งคืนมูลค่าของ เจ้าของ
CALCULATED บูลีน ไม่ว่าที่พักนั้นจะเป็นที่ พักที่คำนวณได้หรือไม่
EXTERNALOPTIONS บูลีน ตัวเลือกของที่พักถูกกำหนดไว้ในระบบภายนอกหรือไม่
HASUNIQUEVALUE บูลีน คุณค่าของที่พักจะไม่เหมือนใครหรือไม่ สามารถตั้งค่าได้เมื่อ สร้างพร็อพเพอร์ตี้ผ่าน API เท่านั้น
HIDDEN บูลีน ที่พักนี้ซ่อนอยู่ใน HubSpot หรือไม่
SHOWCURRENCYSYMBOL บูลีน ไม่ว่าค่าคุณสมบัติตัวเลขจะถูกจัดรูปแบบเป็นสกุลเงินหรือไม่
FORMFIELD บูลีน คุณสมบัตินี้สามารถใช้ในรูปแบบต่างๆได้หรือไม่
READONLYDEFINITION บูลีน สามารถแก้ไขคุณสมบัติใน HubSpot ได้หรือไม่
READONLYVALUE บูลีน แก้ไขค่าที่พักใน HubSpot ได้หรือไม่
HUBSPOTDEFINED บูลีน ไม่ว่าจะเป็นพร็อพเพอร์ตี้ที่สร้างโดย HubSpot เทียบกับที่สร้างโดยผู้ใช้
ARCHIVED บูลีน พร็อพเพอร์ตี้ถูกลบไปแล้วหรือไม่
CREATEDAT การประทับเวลา วันที่และเวลาที่สร้างพร็อพเพอร์ตี้ใน HubSpot
UPDATEDAT การประทับเวลา วันที่และเวลาที่ข้อมูลได้รับการอัปเดตครั้งล่าสุดใน HubSpot เรียนรู้เพิ่มเติมเกี่ยวกับ ประเภทข้อมูลคอลัมน์
INGESTEDAT การประทับเวลา วันที่และเวลาที่ข้อมูลถูกกลืนกินครั้งสุดท้ายโดยเกล็ดหิมะ 

ตัวอย่างที่ 1

ดึงชื่อและคำอธิบายสำหรับคุณสมบัติการติดต่อทั้งหมด

คำค้นหา:


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

 
ผลตอบแทน:

ชื่อ ป้ายกำกับ คำอธิบาย
enter_sql_stage เข้าสู่ขั้นตอน SQL แล้ว เริ่มนับจำนวนวันของขั้นตอน SQL
first_conversion_event_name
การแปลงครั้งแรก แบบฟอร์มแรกที่ผู้ติดต่อรายนี้ส่งมา
ที่อยู่ ที่อยู่ ที่อยู่ของผู้ติดต่อ

ข้อซักถามเกี่ยวกับกิจกรรม

กิจกรรมรวมถึงกิจกรรม HubSpot มาตรฐานและ กิจกรรมพฤติกรรมที่กำหนดเอง แต่ละเหตุการณ์มีออบเจ็กต์ฐานข้อมูลของตัวเองซึ่งมีป้ายกำกับ events_eventnameว่า

ชื่อ  
EVENTS_AD_INTERACTION รายละเอียดของโฆษณาและผู้ติดต่อที่โต้ตอบกับโฆษณาโดยคลิกที่โฆษณาหรือส่งแบบฟอร์มหลังจากมีส่วนร่วมกับโฆษณา
เหตุการณ์_AD_METRICS_IMPORT_V0

 รายละเอียดของโฆษณาและตัวชี้วัดประสิทธิภาพ
EVENTS_CALL_MENTIONED_KEYWORD รายละเอียดของคำหลักที่กล่าวถึงโดยผู้เข้าร่วมในการโทร
EVENT_CLICKED_LINK_IN_EMAIL_V2

 ลิงก์ที่คลิกในอีเมลการตลาดโดยผู้ติดต่อ
EVENT_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8 ลิงก์ที่คลิกในอีเมลบ็อกซ์การสนทนาโดยผู้ติดต่อ
EVENTS_COOKIE_BANNER_CLICKED ผู้ติดต่อที่คลิกคุกกี้
EVENTS_COOKIE_BANNER_VIEW ผู้ติดต่อที่ดูคุกกี้
EVENTS_DOCUMENT_SHARED_V2 เอกสารการขายที่แชร์กับผู้ติดต่อผ่านลิงก์ภายนอก
EVENTS_DOCUMENT_VIEW_V2 เอกสารการขายและผู้ติดต่อที่ดูโดยพวกเขาโดยเปิดลิงก์ภายนอก
EVENTS_DOCUMENT_COMPLETED_V2 เอกสารการขายและรายชื่อผู้ติดต่อที่ปิดไว้
EVENTS_HS_SCHEDULED_EMAIL_V2 อีเมลที่ส่งไปยังเซิร์ฟเวอร์อีเมล HubSpot ที่จะส่ง
EVENTS_MTA_Deliver_EMAIL_V2 ส่งอีเมลไปยังผู้รับโดยเซิร์ฟเวอร์อีเมล HubSpot เรียบร้อยแล้ว
EVENTS_MTA_BUNCED_EMAIL_V2 ความพยายามในการส่งอีเมลที่ถูกปฏิเสธโดยเซิร์ฟเวอร์อีเมลของผู้รับ
EVENTS_OPENED_EMAIL_V2 อีเมลจะเปิดโดยผู้ติดต่อ
EVENTS_REPORTED_SPAM_EMAIL_V2 อีเมลที่ทำเครื่องหมายว่าเป็นสแปมโดยผู้รับ
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2 การเปลี่ยนแปลงการสมัครสมาชิกอีเมลโดยผู้รับ
EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8 อีเมลบ็อกซ์การอนุรักษ์จะเปิดโดยผู้ติดต่อ
กิจกรรม_MB_MEDIA_PLAY กิจกรรมการเล่นวิดีโอโดยผู้ติดต่อ
กิจกรรม_V2_ติดต่อ_จอง_ประชุม_ผ่าน_ลำดับ ผู้ติดต่อจองการประชุมผ่านลำดับ
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE ผู้ติดต่อที่ลงทะเบียนจากลำดับ
EVENTS_V2_CONTACT_FINISHED_SEQUENCE ลำดับเสร็จสิ้น
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL ผู้ติดต่อตอบกลับไปยังอีเมล (หรืออีเมลขาเข้าซึ่งไม่ได้ลงทะเบียนลำดับ) ที่ส่งผ่านลำดับ
เหตุการณ์_V2_ติดต่อ_ยกเลิกการลงทะเบียน_จาก_ลำดับ ยกเลิกการลงทะเบียนผู้ติดต่อตามลำดับ
เหตุการณ์_V2_ติดต่อ_ยกเลิกการลงทะเบียน_ด้วยตนเอง_จาก_ลำดับ ผู้ใช้ยกเลิกการลงทะเบียนผู้ติดต่อด้วยตนเอง
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL ติดต่อยกเลิกการสมัครยกเลิกการลงทะเบียนลำดับ
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED อีเมลลำดับถูกตีกลับ
EVENTS_V2_SEQUENCE_ERRORED เกิดการกัดเซาะตามลำดับทำให้ไม่มีการลงทะเบียน
EVENTS_V2_SEQUENCE_STEP_EXECUTED ดำเนินการตามขั้นตอนลำดับแล้ว
EVENTS_VISITED_PAGE การเข้าชมหน้าเว็บไซต์โดยผู้ติดต่อ
กิจกรรม_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER> เหตุการณ์การบูรณาการ (Timeline V3 API)

คุณสามารถระบุกิจกรรมได้โดยรวม ID ประเภทกิจกรรมและ ID เข้าด้วยกัน คอลัมน์ที่ได้รับคืนจะขึ้นอยู่กับกิจกรรมโดยมีหนึ่งคอลัมน์สำหรับแต่ละคุณสมบัติของกิจกรรม กิจกรรมทั้งหมดจะแสดงคอลัมน์ต่อไปนี้:

โปรดทราบ: HubSpot ได้เพิ่มสองคอลัมน์ใหม่ในตารางกิจกรรมและมุมมองทั้งหมด:

  • occurredat
  • occurredatdateint

คอลัมน์เหล่านี้จะถูกแทนที่ occuredat และ occuredatdateint คอลัมน์ในวันที่ 24 พฤศจิกายน 2022 ในวันนั้นคอลัมน์เก่าจะไม่สามารถใช้งานได้อีกต่อไปและความพยายามในการสืบค้นวัตถุฐานข้อมูลหรือมุมมองที่มีเหตุการณ์ที่ใช้คอลัมน์เหล่านั้นจะล้มเหลว เรียนรู้เพิ่มเติมเกี่ยวกับ การทำลายการเปลี่ยนแปลงสำหรับการแชร์ข้อมูล Snowflake



ชื่อคอลัมน์ ประเภท คำอธิบาย
EVENTTYPEID วาร์ชาร์ ID ประเภทเหตุการณ์คล้ายกับ OBJECTTYPEID
คุณสามารถค้นหา ID ประเภทเหตุการณ์ทั้งหมดในบัญชีของคุณโดยใช้มุมมอง OBJECT_AND_EVENT_ TYPE_DEFINTS
ID วาร์ชาร์ ซึ่งจะไม่ซ้ำกันในแต่ละประเภทกิจกรรม ไม่มีบันทึกสองรายการที่จะมี ID เดียวกันภายในประเภทเหตุการณ์ที่กำหนด
OBJECTTYPEID วาร์ชาร์ ประเภทของออบเจ็กต์ที่เสร็จสิ้นกิจกรรม ตัวอย่างเช่นการคลิกลิงก์อีเมลจะแสดง0-1 ในคอลัมน์นี้ซึ่งแสดงถึงวัตถุที่ติดต่อ
OBJECTID หมายเลข ID ของระเบียนที่เสร็จสิ้นกิจกรรม
OCCURREDAT การประทับเวลา เมื่อเหตุการณ์เกิดขึ้น

OCCURREDATDATEINT

 

 หมายเลข ตัวเลขที่แสดงถึงเวลาที่เหตุการณ์เกิดขึ้น มีข้อมูลเดียวกันกับ OCCURREDAT คอลัมน์แต่จัดรูปแบบเป็นตัวเลขและใช้เป็นส่วนหนึ่งของคีย์คลัสเตอร์ของตาราง ในกรณีส่วนใหญ่คุณสามารถใช้การ OCCURREDAT ประทับเวลาแทนหมายเลขนี้ได้

OCCUREDATDATEINT

 หมายเลข

ตัวเลขที่แสดงถึงเวลาที่เหตุการณ์เกิดขึ้น มีข้อมูลเดียวกันกับ OCCURREDAT คอลัมน์แต่จัดรูปแบบเป็นตัวเลขและใช้เป็นส่วนหนึ่งของคีย์คลัสเตอร์ของตาราง ในกรณีส่วนใหญ่คุณสามารถใช้การ OCCURREDAT ประทับเวลาแทนหมายเลขนี้ได้

โปรดทราบ: คอลัมน์นี้จะเลิกใช้ในวันที่ 24 พฤศจิกายน 2022 และแทนที่ OCCURREDATDATEINTด้วย
OCCUREDAT การประทับเวลา

เมื่อเหตุการณ์เกิดขึ้น

โปรดทราบ: คอลัมน์นี้จะเลิกใช้ในวันที่ 24 พฤศจิกายน 2022 และแทนที่ OCCURREDATด้วย
INGESTEDAT การประทับเวลา วันที่และเวลาที่ข้อมูลถูกกลืนกินครั้งสุดท้ายโดยเกล็ดหิมะ เรียนรู้เพิ่มเติมเกี่ยวกับ ประเภทข้อมูลคอลัมน์
PROPERTY_* วาร์ชาร์ แต่ละคอลัมน์ที่มีคุณสมบัติของเหตุการณ์

ตัวอย่างที่ 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 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
... ... ... ... ...

ตัวอย่างที่ 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;


ผลตอบแทน: 

CLICK_TIMESTAMP CLICK_URL CONTACT_FIRSTNAME CONTACT_LASTNAME
2019 -01 -04 22:35:41.264 https://help.website.com/articles/tutorial/how-to-use-email-tool?utm_source=hs_automation&utm_medium=email&utm_content=68042217 ฮอบส์ บารอน
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 ฮาร์โลว์ บียารี
... ... ... ...

OBJECT_AND_EVENT_TYPE_QUERIES

object_and_event_type_definitions

อ็อบเจ็กต์ฐานข้อมูลนี้มีคำจำกัดความสำหรับอ็อบเจ็กต์และกิจกรรมทั้งหมดที่มีอยู่ในบัญชี HubSpot ของคุณ

วัตถุฐานข้อมูลนี้สามารถส่งคืนคอลัมน์ต่อไปนี้:

ชื่อคอลัมน์ ประเภท คำอธิบาย
OBJECTTYPEID วาร์ชาร์ ID ของวัตถุที่ไปป์ไลน์สามารถมีได้ (เช่นข้อตกลงหรือตั๋ว) The ID of the object that the pipeline can contain (e.g., deals or ticket).
FULLYQUALIFIEDNAME วาร์ชาร์ ชื่อของวัตถุหรือเหตุการณ์
INGESTEDAT การประทับเวลา วันที่และเวลาที่ข้อมูลถูกกลืนกินครั้งสุดท้ายโดยเกล็ดหิมะ เรียนรู้เพิ่มเติมเกี่ยวกับ ประเภทข้อมูลคอลัมน์

ตัวอย่างที่ 1

เรียกดูวัตถุและกิจกรรมทั้งหมดที่มีอยู่ในบัญชี HubSpot ของคุณ

คำค้นหา:


SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;

 
ผลตอบแทน: 

OBJECTTYPEID FULLYQUALIFIEDNAME
0 -1 ติดต่อ
0 -8 LINE_ITEM
0 -11 การสนทนา
... ...

การสืบค้นเซกเมนต์

ด้านล่างเรียนรู้วิธีค้นหาเซกเมนต์ของคุณเช่นผู้ติดต่อที่มีอยู่และเซกเมนต์ของบริษัทและบันทึกที่รวมอยู่ในเซกเมนต์เหล่านั้น

เซกเมนต์

ออบเจ็กต์ฐานข้อมูลนี้มีข้อมูลเกี่ยวกับผู้ติดต่อ HubSpot และกลุ่มบริษัท ส่งกลับหนึ่งแถวต่อเซกเมนต์และคอลัมน์ประกอบด้วยรายละเอียดเซกเมนต์เช่นชื่อเซกเมนต์ขนาดและประเภทวัตถุของระเบียนที่มี ไม่มีข้อมูลเกี่ยวกับระเบียนแต่ละรายการภายในแต่ละเซ็กเมนต์ (ดู SEGMENT_AMBITION) 

วัตถุฐานข้อมูลนี้สามารถส่งคืนคอลัมน์ต่อไปนี้:

ชื่อคอลัมน์ ประเภท คำอธิบาย
OBJECTTYPEID วาร์ชาร์ ประเภทของระเบียนในส่วน (เช่นการติดต่อหรือบริษัท)
SEGMENTID หมายเลข ID ของเซกเมนต์ เข้าร่วมคอลัมน์ Segment ID ใน ตาราง Segment-memberships
CLASSICSEGMENTID หมายเลข ID เฉพาะสำหรับติดต่อกลุ่มที่ตรงกับ ID ใน URL ของกลุ่มใน HubSpot
NAME วาร์ชาร์ ชื่อของเซกเมนต์
SIZE หมายเลข จำนวนระเบียนในเซกเมนต์
CREATEDBYUSERID หมายเลข ID ของผู้ใช้ที่สร้างเซกเมนต์
CREATEDAT การประทับเวลา เมื่อกลุ่มถูกสร้างขึ้นใน HubSpot
UPDATEDBYUSERID หมายเลข ID ของผู้ใช้ที่อัปเดตเซกเมนต์ล่าสุด
UPDATEDAT การประทับเวลา วันที่และเวลาที่อัพเดทวันที่ล่าสุดใน HubSpot เรียนรู้เพิ่มเติมเกี่ยวกับ ประเภทข้อมูลคอลัมน์ 
INGESTEDAT การประทับเวลา วันที่และเวลาที่ข้อมูลถูกกลืนกินครั้งสุดท้ายโดยเกล็ดหิมะ

ตัวอย่างที่ 1

ดึงข้อมูลกลุ่มผู้ติดต่อทั้งหมด

คำค้นหา:


SELECT segmentId, name, size
FROM segments
WHERE objectTypeId = '0-1';

 
ผลตอบแทน: 

SEGMENTSID ชื่อ ขนาด
118131 การประชาสัมพันธ์รายสัปดาห์ 103
66156 ผู้สมัครรับข้อมูลบล็อก 455
771852 ผู้สมัครรับข่าวสารยอดนิยมประจำปี 2021 37
... ... ...

ตัวอย่างที่ 2

ดึงข้อมูลกลุ่มผู้ติดต่อเฉพาะที่ชื่อ สมาชิกยอดนิยม 2021 

คำค้นหา:


SELECT segmentId, name, size 
FROM segments
WHERE objectTypeId = '0-1'
ANDsegmentName = 'Top subscribers 2021';


ผลตอบแทน: 

SEGMENTID ชื่อ ขนาด
771852 ผู้สมัครรับข่าวสารยอดนิยมประจำปี 2021 37

segment_membership

อ็อบเจ็กต์ฐานข้อมูลนี้มีข้อมูลเกี่ยวกับระเบียนที่เป็นสมาชิกของเซกเมนต์ใดโดยมีหนึ่งแถวต่อระเบียนในเซกเมนต์ ตัวอย่างเช่นหากคุณมีกลุ่มสมาชิกบล็อกที่มีผู้ติดต่อ 500 รายวัตถุฐานข้อมูลจะส่งกลับ 500 แถว 

มี ID เซกเมนต์และ ID ออบเจ็กต์เท่านั้น สำหรับข้อมูลเพิ่มเติมให้เข้าร่วมกับออบ เจ็กต์ฐานข้อมูลเซกเมนต์

วัตถุฐานข้อมูลนี้สามารถส่งคืนคอลัมน์ต่อไปนี้:

ชื่อคอลัมน์ ประเภท คำอธิบาย
SEGMENTID วาร์ชาร์ ID ของเซกเมนต์ เข้าร่วมคอลัมน์ HS_SEGMENT_ID ในตาราง เซกเมนต์
OBJECTID วาร์ชาร์ ID ของระเบียนในเซกเมนต์
UPDATEDAT การประทับเวลา วันที่และเวลาที่ข้อมูลได้รับการอัปเดตครั้งล่าสุดใน HubSpot เรียนรู้เพิ่มเติมเกี่ยวกับ ประเภทข้อมูลคอลัมน์
INGESTEDAT การประทับเวลา วันที่และเวลาที่ข้อมูลถูกกลืนกินครั้งสุดท้ายโดยเกล็ดหิมะ 

ตัวอย่างที่ 1

ดึง ID ของผู้ติดต่อทั้งหมดในส่วนสมาชิกยอดนิยม 2021

คำค้นหา:


SELECT objectId
FROM segment_memberships
INNER JOIN segments
ON segment_memberships.segmentId = segments.segmentId
WHERE segments.objectTypeId = '0-1'
AND segments.name = 'Top Subscribers 2021';

 
ผลตอบแทน: 

OBJECTID
54325098
96805401
6922028
...

ตัวอย่างที่ 2

ดึงข้อมูลชื่อและนามสกุลของรายชื่อผู้ติดต่อในส่วน สมาชิกยอดนิยม 2021

คำค้นหา:

 

เลือก

contact.objectId AS object_id,

contact.properties: FIRSTNAME:: สตริงเป็น FIRSTNAME,

contact.properties: lastname:: สตริงเป็น นามสกุล

จาก OBJECT_WITH_OBJECT_ PROPERTI

INNER JOIN SEGMENT_MEMBERS AS

ON contact.objectId = membership.objectId

กลุ่มการผนวกภายใน

บน membership.segmentId = segments.segmentId

ในกรณีที่ contact.objectTypeId = '0 -1'

และ segments.objectTypeId = '0 -1'

และ segments.name = 'สมาชิกสูงสุด 2021 ';

 


ผลตอบแทน: 

OBJECTID

ชื่อ

นามสกุล

54325098

ฮอบส์

บารอน

96805401

ไมโล

ทอง

6922028

เฮนรี่

ไรลีย์

...

...

...

คำถามที่พบบ่อย

ฉันต้องการสร้างข้อมูลที่คล้ายกับรายงานจากแอป Hubspot ฉันจะทำอย่างไร?

โดยทั่วไปคุณอาจต้องการดูคอลัมน์ที่มีอยู่ในรายงานที่คุณกำลังเปรียบเทียบ หากการสร้างภาพรายงานไม่ใช่แบบตารางการแปลงเป็นตารางจะแสดงคอลัมน์ที่รายงานมีอยู่ คอลัมน์เหล่านี้มักเป็นคุณสมบัติของประเภทวัตถุหรือประเภทเหตุการณ์ ขั้นตอนต่อไปคือการหาคุณสมบัติประเภทวัตถุที่คอลัมน์สอดคล้อง คุณสามารถทำได้โดยการสอบถาม property_definitions:


SELECT * FROM property_definitions

WHERE label = [column_name]

 

อาจไม่ใช่ชื่อที่ตรงกันเสมอไปเพราะชื่อที่พักบางชื่อมักจะได้รับการแก้ไขให้เป็นชื่อที่สื่อความหมายได้ดีกว่าในแอพ ในกรณีเช่นนี้การค้นหาแบบคลุมเครือโดยใช้ตัวดำเนินการ LIKE บนคอลัมน์ LABEL (หรือแม้แต่คำอธิบาย) ใน PROPERTY_DEFINITIONS สามารถช่วยได้

หลังจากพิจารณาว่าคอลัมน์เป็นของประเภทวัตถุใดแล้วก็เป็นเรื่องเล็กน้อยที่จะกำหนดว่าจะค้นหาอะไร สอบถาม object_with_object_properties และกรองตาม objectTypeId สำหรับประเภทนั้น อ่านค่าคุณสมบัติที่จำเป็นจากคอลัมน์คุณสมบัติ JSON

ฉันจะเชื่อมโยงประเภทข้อมูลนี้กับประเภทอื่นได้อย่างไรเช่นจะเรียกดูแบบฟอร์มสำหรับแคมเปญได้อย่างไร

เพื่อเรียกดูแบบฟอร์มที่เกี่ยวข้องกับแต่ละ OBJECT_WITH_OBJECT_PROPERTIESแคมเปญ ASSOCIATIONSเข้าร่วม ASSOCIATION_DEFINITIONSและ


เลือกรายการที่แตกต่างกัน

campaigns.properties: hs_name:: สตริงเป็น campaign_name,

form.properties: hs_form_id:: สตริงเป็น form_id

จาก OBJECT_WITH_OBJECT_PROPERTS เป็น แคมเปญ

เข้าร่วมสมาคมในฐานะ สมาคม

 ON association.fromObjectId = campaigns.objectId

เข้าร่วม ASSOCIATION_DEFINITIONS ตาม

 ON definition.combinedAssociationTypeId =

association.combinedAssociationTypeId

เข้าร่วม OBJECT_WITH_OBJECT_ PROPERT

ON forms.objectId = association.toObjectId

WHERE campaigns.objectTypeId = '0 -35'

และ forms.objectTypeId = '0 -28'

และ definition.fromObjectTypeId = '0 -35'

และ definition.toObjectTypeId = '0 -28 ';

ฉันจะทราบสถานะของการผสานรวม 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
สารบัญ เมนู

เนื้อหาที่เกี่ยวข้อง

New call-to-action