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

สอบถามข้อมูล HubSpot ใน Snowflake

อัปเดตล่าสุด: เมษายน 14, 2025

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

Operations Hub   Enterprise

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

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

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

โปรดทราบ: มุมมองต่อไปนี้ใน schema V2_LIVE จะได้รับการอัปเดตรายวันเท่านั้น: association_definitions, owners, pipelines และ pipeline_stages

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

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

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

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

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


      การตั้งค่าแผ่นงานเกล็ดหิมะ-หน้าต่าง0

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

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


SELECT objectTypeId, property_createddate
FROM hubspot_share_name.V2_LIVE.objects_deals

LIMIT 1

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

แบบสอบถามจะถูกสร้างขึ้นโดยใช้ SQL และสามารถใช้ในการดึงข้อมูล HubSpot เช่น:

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

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

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

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

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


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

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

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

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

แถบด้านข้างเกล็ดหิมะ-ดูคอลัมน์-รายละเอียด0


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


SELECTobjectId, updatedAt
FROM objects_contacts

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

  • ประเภทวัตถุ: เอ วาร์ชาร์ ค่าที่แสดงประเภทของวัตถุ ตัวอย่างเช่น 0-1 แสดงถึง อ็อบเจกต์ ชื่อติดต่อ 0-2 แสดงถึง อ็อบเจกต์ บริษัท และ 2-1232 อาจแสดงถึง อ็อบเจกต์ที่กำหนดเอง ใน บัญชี ของคุณ ในรายการจะหมายถึงประเภทของรายการ (เช่น ผู้ติดต่อหรือบริษัท) คุณสามารถค้นหา ID ของ อ็อบเจกต์ และ เหตุการณ์ ทั้งหมดใน บัญชี ของคุณได้โดยใช้มุมมอง 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 เหล่านี้เป็นประเภท NUMBER และ DATETIME ตามลำดับ:


SELECT objectid, value AS amount_str, try_to_number(value) AS amount
FROM object_properties
WHERE objecttypeid='0-3' AND name='amount'
LIMIT 1

การสอบถาม อ็อบเจกต์

ด้านล่างนี้ เรียนรู้วิธีการสอบถามข้อมูลจากวัตถุและบันทึก HubSpot เฉพาะ พร้อมทั้งข้อมูลที่ได้รับกลับมา 

ข้อมูล อ็อบเจกต์ ประเภทต่างๆ จะถูกจัดระเบียบและพร้อมใช้งานได้สองวิธี: 

  • รายบุคคล: ประเภท อ็อบเจกต์ แต่ละประเภทจะถูกเก็บไว้ในมุมมองของตัวเองและประกอบด้วยเฉพาะระเบียนของประเภท อ็อบเจกต์ เดียวกัน เช่น objects_contacts ประกอบด้วยเฉพาะระเบียนผู้ติดต่อ วิธีนี้ช่วยลดความจำเป็นในการระบุ objecttypeid ในระหว่างการสอบถาม การดูมุมมองเหล่านี้ง่ายกว่าเนื่องจากคุณไม่จำเป็นต้องทราบ ObjectTypeIds นอกจากนี้พวกเขายังส่งคืนข้อมูลในรูปแบบที่ใช้งานได้มากขึ้น โดยแต่ละแถวจะสอดคล้องกับ อ็อบเจกต์ และเวอร์ชันปัจจุบันของคุณสมบัติ ตราบใดที่คุณไม่ประสบปัญหาการค้นหาข้อมูลช้า แนะนำให้ใช้มุมมองเหล่านี้ในการดึงข้อมูล อ็อบเจกต์ ดูเพิ่มเติมในมุมมอง Objects_X ด้านล่าง 
  • รวม: บันทึกทั้งหมดสำหรับประเภท อ็อบเจกต์ ทั้งหมดจะถูกรวมเข้าไว้ใน อ็อบเจกต์ ฐานข้อมูลหนึ่งเดียว ดังนั้นเมื่อทำการสอบถาม คุณจะต้องระบุตัวกรอง เช่น “WHERE objectTypeId='0-1'” ตัวอย่างเช่น คุณสามารถใช้ objecttypeid ต่อไปนี้เมื่อทำการสอบถาม:
ชื่อ อ็อบเจกต์ รหัสประเภทวัตถุ
ผู้ติดต่อ 0-1
บริษัท 0-2
รายการสินค้า 0-8

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

โดยทั่วไปวัตถุฐานข้อมูลเหล่านี้เหมาะสมหากคุณต้องการประสิทธิภาพการค้นหาที่ดีกว่าที่ได้รับจากมุมมอง objects_x ดูรายละเอียดเพิ่มเติมใน object_with_object_properties, object_properties, objects และ object_properties_history ด้านล่าง

มุมมอง objects_x

ใน อ็อบเจกต์ ฐานข้อมูลนี้ ประเภท อ็อบเจกต์ ที่พร้อมใช้งานแต่ละประเภท รวมถึงวัตถุที่กำหนดเอง จะมีมุมมองเฉพาะของตัวเอง โดยแต่ละมุมมองจะมีเฉพาะเร็กคอร์ดสำหรับวัตถุของประเภท อ็อบเจกต์ เฉพาะนั้นๆ เท่านั้น มุมมองเหล่านี้ได้รับการตั้งชื่อตามรูปแบบ OBJECTS_<object type name> ที่ไหน <object type name> เป็น ป้ายชื่อรูปแบบพหูพจน์ของประเภทวัตถุ (หมายเหตุว่าหากประเภท อ็อบเจกต์ ไม่มีรูปแบบพหูพจน์ ดังนั้น <object type name> จะเป็นเพียงป้ายรูปแบบเอกพจน์ของชื่อประเภท อ็อบเจกต์ ที่เรียงต่อกันด้วย "S")

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

ดูด้านล่างเป็นรายการครอบคลุมของประเภท อ็อบเจกต์ HubSpot (นั่นคือ ไม่กำหนดเอง) ที่มีอยู่ คำอธิบายสั้นๆ ของข้อมูลที่พวกมันแสดง และมุมมองที่สอดคล้องกัน:

 

ประเภท อ็อบเจกต์ HubSpot

รหัสประเภทวัตถุ

คำอธิบาย

ติดต่อ

0-1

ข้อมูลเกี่ยวกับบุคคลที่โต้ตอบกับธุรกิจของคุณ

บริษัท

0-2

ข้อมูลเกี่ยวกับธุรกิจหรือองค์กรแต่ละแห่ง

ข้อเสนอ

0-3

รายละเอียดเกี่ยวกับโอกาสในการสร้างรายได้กับผู้ติดต่อหรือบริษัท

การว่าจ้าง

0-4

จัดเก็บข้อมูลจากการดำเนินการ CRM รวมถึงบันทึก งาน อีเมล การประชุม และการโทร

ตั๋ว

0-5

เป็นตัวแทนลูกค้าในการขอความช่วยเหลือหรือการสนับสนุน

อ้าง

0-14

ใช้เพื่อแบ่งปันข้อมูลราคาให้กับผู้ซื้อที่มีศักยภาพ

แบบฟอร์มการส่ง

0-15

รายละเอียดการส่งแบบฟอร์มรายบุคคลสำหรับ HubSpot

รายการไลน์

0-8

แสดงถึงผลิตภัณฑ์ย่อยที่ขายในข้อตกลง เมื่อแนบผลิตภัณฑ์เข้ากับข้อตกลงแล้ว ผลิตภัณฑ์นั้นจะกลายเป็น รายการบรรทัด

การสนทนา

0-11

รายละเอียดข้อความเข้าจากหลายช่องทาง

หน้าแลนดิ้ง

0-25

รายละเอียดของหน้า Landing Page ของคุณ

 งาน

0-27

จัดเก็บข้อมูลเกี่ยวกับรายการสิ่งที่ต้องทำ

รูปร่าง

0-28

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

อีเมลการตลาด

0-29

รายละเอียดเกี่ยวกับอีเมล์จากศูนย์กลาง การตลาด

บัญชีโฆษณา

0-30

จัดเก็บข้อมูลเกี่ยวกับบัญชีโฆษณาของคุณบน Linkedin, Facebook และ Google

โฆษณา_แคมเปญ

0-31

รายละเอียดเกี่ยวกับ แคมเปญ โฆษณาของคุณ แคมเปญโฆษณาสามารถมี โฆษณา ได้หนึ่งรายการหรือมากกว่า

กลุ่มโฆษณา

0-32

การจัดกลุ่ม โฆษณา อย่างมีตรรกะภายในแคมเปญโฆษณา

โฆษณา

0-33

รายละเอียดเกี่ยวกับ โฆษณา แต่ละรายการ

แคมเปญ

0-35

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

SITE_PAGE

0-38

ข้อมูลเกี่ยวกับหน้าแต่ละหน้าบนเว็บไซต์ของคุณ

โพสต์บล็อก

0-39

ข้อมูลเกี่ยวกับโพสต์ บล็อก

รายการ วัตถุ

0-45

ข้อมูลเกี่ยวกับการจัดกลุ่มของระเบียน อ็อบเจกต์ ตามคุณสมบัติหรือกิจกรรมของพวกมัน

เรียก

0-48

การโทรที่ทำโดยข้อมูล CRM อื่น เช่น รายชื่อผู้ติดต่อ

ใบแจ้งหนี้

0-53

จัดการและซิงค์ใบแจ้งหนี้กับระบบบัญชีภายนอก

มีเดีย_บริดจ์

0-57

ข้อมูลเกี่ยวกับสินทรัพย์สื่อที่นำเข้าสู่ Hubspot

ลำดับ

0-58

ลำดับ คือชุดเทมเพลตอีเมลที่มีเป้าหมายและกำหนดเวลาไว้เพื่อดูแลผู้ติดต่อในแต่ละช่วงเวลา

เทมเพลต

0-62

เนื้อหา อีเมล์ที่บันทึกไว้ซึ่งสามารถนำมาใช้ซ้ำในการส่งอีเมลได้

ดีล_สปลิท

0-72

การแบ่งข้อตกลงใช้เพื่อแบ่งปันเครดิตข้อตกลงระหว่างผู้ใช้หลายราย

เอกสารการขาย

0-83

เอกสาร การขายสร้าง ไลบรารี เนื้อหา เพื่อให้ทีมของคุณทั้งหมด อัปโหลด และแบ่งปัน เอกสาร กับผู้ติดต่อของคุณ

การส่งคำติชม

0-19

จัดเก็บข้อมูลที่ส่งไปยังแบบสำรวจความคิดเห็น

การสมัครสมาชิก

0-69

การสมัครสมาชิกประกอบด้วยรายละเอียดการชำระเงินซ้ำๆ

การชำระเงินเชิงพาณิชย์

0-101

ประกอบด้วยข้อมูลเกี่ยวกับเงินทุนที่รวบรวมจากลูกค้า



อ็อบเจกต์ ฐานข้อมูลแต่ละรายการจะส่งคืนคอลัมน์ต่อไปนี้:

ชื่อคอลัมน์

พิมพ์

คำอธิบาย

ประเภทวัตถุID

วาร์ชาร์

ID ของประเภท อ็อบเจกต์ (เช่น รายชื่อติดต่อเป็น 0-1)

รหัสวัตถุ

ตัวเลข

ID ของบันทึก (เช่น บันทึกการติดต่อที่มี ID 123752)

อัปเดตแล้ว

ตราประทับเวลา

วันที่และเวลาที่ อ็อบเจกต์ นี้ได้รับการอัปเดตครั้งล่าสุดใน HubSpot 

กินเข้าไป

ตราประทับเวลา

วันที่และเวลาที่ข้อมูลถูกรวบรวมโดย Snowflake ครั้งล่าสุด 

คุณสมบัติ_*

วาร์ชาร์

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

  1. คอลัมน์ที่มีค่า คุณสมบัติ เป็นสตริง ชื่อคอลัมน์จะเป็น property_unparsed_[name] ตัวอย่างเช่น คุณสมบัติ อ็อบเจกต์ DEAL deal_amount จะมีคอลัมน์ property_unparsed_deal_amount
  2. คอลัมน์ที่มีค่าที่ถูกแปลงเป็นชนิดดั้งเดิม คอลัมน์จะมีชื่อเป็น property_[name] ตัวอย่างเช่น คุณสมบัติ อ็อบเจกต์ DEAL อย่าง deal_amount จะมีคอลัมน์ property_deal_amount โปรดทราบว่าคอลัมน์นี้จะมีค่าว่างถ้า คอนเวอร์ชัน เป็นชนิดดั้งเดิมล้มเหลวเนื่องจากข้อมูลไม่ถูกต้อง

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


ดึงข้อมูลชื่อ นามสกุล และ ขั้นตอนของวงจรชีวิต สำหรับผู้ติดต่อทั้งหมด

สอบถาม :


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

การส่งคืน:

รหัสวัตถุ

ชื่อจริง

นามสกุล

วงจรชีวิต

54325098

ฮ็อบส์

บารอน

ลูกค้าที่มุ่งหวัง

96805401

ไมโล

ระดับ Elite

ลูกค้าที่มุ่งหวัง

6922028

เฮนรี่

ไรลีย์

ลูกค้าที่มุ่งหวัง

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

 

ดึงข้อมูลชื่อข้อตกลงและขั้นตอนของข้อตกลงสูงสุดสามข้อ

สอบถาม :


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals

LIMIT 3

การส่งคืน:

รหัสวัตถุ

ชื่อข้อตกลงทรัพย์สิน

ข้อตกลงเกี่ยวกับทรัพย์สิน

ทรัพย์สิน_ข้อตกลง

38960439

ชื่อดีล 1

ปิดวอน

34199

321740651

ทดลองดีล 123

14845019

8383663

98392101

กันสาดแบบป๊อปอัพ

ปิดวอน

9309007

 

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

 

ดึงข้อมูลชื่อดีลและระยะของดีล 3 อันดับแรกตามจำนวน

สอบถาม :

เนื่องจากข้อมูลจำนวนข้อตกลงมีให้ใช้งานในรูปแบบข้อมูลตัวเลข จึงสามารถใช้ในการจัดลำดับได้โดยไม่ต้องทำการ คอนเวอร์ชัน หรือแคสต์


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals
ORDER BY property_amount DESC
LIMIT 3


การส่งคืน:

รหัสวัตถุ

ชื่อข้อตกลงทรัพย์สิน

ข้อตกลงเกี่ยวกับทรัพย์สิน

ทรัพย์สิน_ข้อตกลง

98392101

กันสาดแบบป๊อปอัพ

ปิดวอน

9309007

321740651

ทดลองดีล 123

14845019

8383663

38960439

ชื่อดีล 1

ปิดวอน

34199

วัตถุที่มีคุณสมบัติของวัตถุ

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

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

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

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

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

90 วัน ในวันที่ 25 มกราคม 2022 เวลาประทับของคอลัมน์จะถูกลบออกจากตารางและมุมมอง หลังจากวันที่นี้ ความพยายามใด ๆ ที่จะสอบถาม วัตถุที่มีคุณสมบัติของวัตถุ ตารางหรือมุมมองที่ใช้คอลัมน์ค่าเวลาจะล้มเหลว

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

ดึงข้อมูลรายชื่อผู้ติดต่อทั้งหมดและคุณสมบัติของรายชื่อเหล่านั้น

สอบถาม :


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


การส่งคืน:

ประเภทวัตถุID รหัสวัตถุ คุณสมบัติ
0-1 38960439 {"วันที่สร้าง": "1504656970152"...}
0-1 321740651 { "วันที่สร้าง": "1590183081949"...} 
0-1 98392101 { "วันที่สร้าง": "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;


การส่งคืน:

รหัสวัตถุ ชื่อข้อตกลง ดีลสเตจ ดีลจำนวนเงิน
38960439 ชื่อดีล 1 ปิดหายไป 7488939
321740651 ชื่อดีล 1 ปิดวอน 9292029
98392101 ชื่อดีล 1 ปิดหายไป 62626528

อ็อบเจกต์

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

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

อ็อบเจกต์ ฐานข้อมูลนี้สามารถส่งคืนคอลัมน์ต่อไปนี้ได้:

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

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

ดึงข้อมูลบันทึกการติดต่อทั้งหมด

สอบถาม :


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


การส่งคืน:

ประเภทวัตถุID รหัสวัตถุ
0-1 36721864
0-1 103580363
0-1 56047670
- -

คุณสมบัติของวัตถุ

อ็อบเจกต์ ฐานข้อมูลนี้เป็นส่วนย่อยของ อ็อบเจกต์ ฐานข้อมูล 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;


การส่งคืน:

ประเภทวัตถุID รหัสวัตถุ ชื่อ ค่า
0-1 10401 ชื่อจริง ไบรอัน
0-1 10401 เมือง ดับลิน
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);

 

การส่งคืน:

ประเภทวัตถุID รหัสวัตถุ ชื่อจริง นามสกุล วงจรชีวิต
0-1 54325098 ฮ็อบส์ บารอน ลูกค้าที่มุ่งหวัง
0-1 96805401 ไมโล ระดับ Elite ลูกค้าที่มุ่งหวัง
0-1 6922028 เฮนรี่ ไรลีย์ ลูกค้าที่มุ่งหวัง
- - - - -

ประวัติคุณสมบัติของวัตถุ

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

อ็อบเจกต์ ฐานข้อมูลนี้สามารถส่งคืนคอลัมน์ต่อไปนี้ได้:

ชื่อคอลัมน์ พิมพ์ คำอธิบาย
OBJECTTYPEID วาร์ชาร์ ID ของประเภท อ็อบเจกต์ (เช่น ผู้ติดต่อคือ 0-1 -
OBJECTID ตัวเลข ID ของบันทึก (เช่น บันทึกการติดต่อที่มี ID ของ 123752 -
NAME วาร์ชาร์ ชื่อของ คุณสมบัติ.
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;

 
การส่งคืน:

รหัสวัตถุ ชื่อ ค่า อัปเดตแล้ว

136493192

ระดับคะแนนการทำนาย hs_predictivescore

ชั้น_1

2022-06-22 22:45:05.931

136493192

ระดับคะแนนการทำนาย hs

ชั้น_2

2021-09-18 08:20:56.622

136493192

ระดับคะแนนการทำนาย hs

ชั้นที่ 3

31/11/2019 18:20:22.851 น.

-

-

-

-

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

ดึงข้อมูลชื่อปัจจุบันของผู้ติดต่อทั้งหมดที่เคยมี ขั้นตอนของวงจรชีวิต ของ Subscriber

สอบถาม :


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


การส่งคืน:

รหัสวัตถุ ชื่อจริง นามสกุล
54325098 ฮ็อบส์ บารอน
96805401 ไมโล ระดับ Elite
6922028 เฮนรี่ ไรลีย์
- - -

การสอบถามเกี่ยว ความเชื่อมโยง

ข้อมูลวัตถุจะถูกจัดระเบียบในลักษณะสองวิธี:

  • รายบุคคล: ประเภท ความเชื่อมโยง แต่ละประเภทจะถูกเก็บไว้ในมุมมองของตัวเองและจะมีเฉพาะบันทึกของประเภทนั้นเท่านั้น ตัวอย่างเช่น associations_contacts_to_deals จะมีเฉพาะเรกคอร์ด ความเชื่อมโยง ระหว่างวัตถุ contact และ deal เท่านั้น วิธีนี้ทำให้ไม่จำเป็นต้องระบุ associationtypeid ในระหว่างการสอบถาม การสอบถามมุมมองเหล่านี้ค่อนข้างง่ายเนื่องจากไม่จำเป็นต้องมีความคุ้นเคยกับ รูปแบบข้อมูล CRM จึงจะใช้งานได้ นอกจากนี้พวกเขายังส่งคืนคำอธิบายที่สมบูรณ์ของบันทึก ความเชื่อมโยง ระหว่างสองวัตถุ ซึ่งสามารถนำไปใช้อย่างง่ายดายในการรวมกับมุมมอง objects_x ตราบใดที่คุณไม่ประสบปัญหาการค้นหาที่ช้า แนะนำให้ใช้มุมมองเหล่านี้ในการดึงข้อมูล ความเชื่อมโยง ดูเพิ่มเติมในมุมมอง associations_x_to_y ด้านล่าง 
  • รวม: บันทึกทั้งหมดสำหรับประเภท ความเชื่อมโยง ทั้งหมดจะถูกรวมเข้าไว้ใน อ็อบเจกต์ ฐานข้อมูลหนึ่งเดียว ดังนั้นเมื่อคุณสอบถาม คุณจะต้องระบุตัวกรอง เช่น “WHERE combinedassociationtypeid='0-32' ” ดูเพิ่มเติมได้ใน associations และ association_definitions ด้านล่าง

มุมมอง associations_x_to_y

ประเภท ความเชื่อมโยง แต่ละประเภทมีมุมมองของตัวเอง ซึ่งเรียกว่า ความสัมพันธ์<association type name> เช่น การเชื่อมโยง_การติดต่อ_กับ_ข้อตกลง มุมมองแต่ละมุมมองเป็นชุดย่อยของข้อมูลใน อ็อบเจกต์ ฐานข้อมูลความสัมพันธ์ และจะมีเฉพาะบันทึกของ combinedassociationtypeid ที่เฉพาะเจาะจงเท่านั้น

อ็อบเจกต์ ฐานข้อมูลแต่ละรายการจะส่งคืนคอลัมน์ต่อไปนี้:

ชื่อคอลัมน์

พิมพ์

คำอธิบาย

รหัสประเภทสมาคมรวม

วาร์ชาร์

ตัวระบุที่ไม่ซ้ำกันของคำจำกัดความ ความเชื่อมโยง

หมวดหมู่สมาคม

วาร์ชาร์

แหล่งที่มาของประเภท ความเชื่อมโยง หนึ่งใน: HUBSPOT_DEFINED, USER_DEFINED, อินทีเกรเตอร์_DEFINED

รหัสสมาคมประเภท

วาร์ชาร์

ตัวระบุที่ไม่ซ้ำกันของคำจำกัดความ ความเชื่อมโยง ภายในหมวดหมู่ ความเชื่อมโยง ที่เฉพาะเจาะจง กล่าวคือ คำจำกัดความสองรายการในหมวดหมู่ ความเชื่อมโยง เดียวกันจะไม่มี associationtypeid เดียวกัน 

จากวัตถุประเภทID

วาร์ชาร์

objecttypeid ที่เป็นแหล่งที่มาของคำจำกัดความ ความเชื่อมโยง

จากวัตถุประเภท

วาร์ชาร์

ชื่อของประเภทวัตถุที่เป็นแหล่งที่มาของคำจำกัดความ ความเชื่อมโยง

TOOBJECTTYPEID

วาร์ชาร์

objecttypeid ที่เป็นจุดหมายปลายทางของคำจำกัดความ ความเชื่อมโยง

ประเภทวัตถุ

วาร์ชาร์

ชื่อของประเภทวัตถุที่เป็นจุดหมายปลายทางของคำจำกัดความของ ความเชื่อมโยง

ชื่อ

วาร์ชาร์

ชื่อคำจำกัดความของ ความเชื่อมโยง

ฉลาก

วาร์ชาร์

คำอธิบายคำจำกัดความของ ความเชื่อมโยง

คำจำกัดความของสมาคม

บูลีน

ว่าคำจำกัดความ ความเชื่อมโยง เป็นประเภทหลักหรือไม่ เมื่อเป็นจริง คำจำกัดความจะเป็นคำจำกัดความที่ HubSpot แสดงบนบันทึกที่เกี่ยวข้อง

[FROMOBJECTTYPE_OBJECTID] เช่น สำหรับมุมมอง ASSOCIATIONS_CONTACTS_TO_DEALS นี่จะเป็น CONTACT_OBJECTID

ตัวเลข

ID ของ อ็อบเจกต์ ของ อ็อบเจกต์ แหล่งที่มา

[TOOBJECTTYPE_OBJECTID] เช่น สำหรับมุมมอง ASSOCIATIONS_CONTACTS_TO_DEALS นี่จะเป็น DEAL_OBJECTID

ตัวเลข

ID ของ อ็อบเจกต์ อ็อบเจกต์

กินเข้าไป

ตราประทับเวลา

วันที่และเวลาที่ข้อมูลถูกรวบรวมโดย Snowflake ครั้งล่าสุด

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

 

ดึงข้อมูลข้อตกลงทั้งหมดที่เกี่ยวข้องกับผู้ติดต่อเฉพาะ

สอบถาม :


SELECT
รหัสวัตถุการติดต่อ, รหัสวัตถุข้อตกลง

จากสมาคม_ผู้ติดต่อ_สู่_ข้อตกลง

WHERE contactId = 6626541373

 

การส่งคืน:

รหัสวัตถุที่ติดต่อ

รหัสข้อตกลง

6626541373

233620335

6626541373

90253678

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

 

ดึงข้อมูลผู้ติดต่อทั้งหมดตามโซนเวลาโบโกตาและข้อเสนอของพวกเขา


เลือกรายชื่อผู้ติดต่อ.คุณสมบัติ_ชื่อผู้ติดต่อ_ชื่อผู้ติดต่อ,

contacts.property_lastname contact_lastname,
contacts.property_email contact_email,
deals.property_dealtype deal_type, deals.property_amount deal_amount
FROM objects_contacts contacts
JOIN associations_contacts_to_deals assoc on
assoc.contact_objectid=contacts.objectid
JOIN objects_deals deals on deals.objectid=assoc.deal_objectid
where contacts.property_hs_timezone='america_slash_bogota'

 

CONTACT_FIRSTNAME

นามสกุลผู้ติดต่อ

อีเมลติดต่อ

ประเภทข้อตกลง

ข้อตกลง_จำนวนเงิน

เดวิด

มากาลเฮส

dmagalhaes@example.com

ธุรกิจใหม่

74848

เฟอร์นันดา

โรดริเกซ

fmoreira@example.com

ธุรกิจใหม่

253530

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

 

ดึงข้อมูลรายชื่อผู้ติดต่อทั้งหมดและยอดรวมของ จำนวนเงินที่ปิดการขาย ข้อตกลงสำหรับผู้ติดต่อแต่ละราย


SELECT SUM(deals.property_hs_closed_amount) AS
total_closed_amount, contacts.property_email contact_email
FROM objects_contacts contacts
JOIN associations_contacts_to_deals assoc on
assoc.contact_objectid=contacts.objectid
JOIN objects_deals deals on deals.objectid=assoc.deal_objectid
GROUP BY contact_email
ORDER BY total_closed_amount DESC

 

การส่งคืน:

รวมยอดปิดแล้ว

อีเมลติดต่อ

98474793

จอห์นโด@riverview.com

849488

sallymae@longford.com

คำจำกัดความของสมาคม

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

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

อ็อบเจกต์ ฐานข้อมูลนี้สามารถส่งคืนคอลัมน์ต่อไปนี้ได้:

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

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

ดึงข้อมูลประเภทของสมาคมที่มีอยู่ใน บัญชี ของคุณ

สอบถาม :


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

 
การส่งคืน:

ประเภทสมาคมแบบผสมผสาน จากวัตถุประเภทID TOOBJECTTYPEID ชื่อ
0-1 0-1 0-2 ติดต่อบริษัท
0-2 0-2 0-1 บริษัท_ติดต่อ
0-3 0-3 0-1 ข้อตกลงในการติดต่อ
0-4 0-1 0-3 ติดต่อเพื่อทำการตกลง
0-5 0-3 0-2 ข้อตกลงกับบริษัท
- - - -

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

ดึงข้อมูลประเภท ความเชื่อมโยง ที่มีอยู่ระหว่างข้อตกลงและบริษัท

สอบถาม :


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


การส่งคืน:

ประเภทสมาคมแบบผสมผสาน จากวัตถุประเภทID TOOBJECTTYPEID ชื่อ
0-5 0-3 0-2 ข้อตกลงกับบริษัท
0-271 0-3 0-2 ข้อตกลงกับบริษัทหลัก
0-341 0-3 0-2 ข้อตกลงถึง COMAPNY_ไม่มีป้ายกำกับ

ความเชื่อมโยง

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

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

อ็อบเจกต์ ฐานข้อมูลนี้สามารถส่งคืนคอลัมน์ต่อไปนี้ได้:

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

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

ดึงข้อมูลข้อตกลงและข้อมูลติดต่อที่เกี่ยวข้องทั้งหมด

สอบถาม :


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

 
การส่งคืน:

รหัสประเภทสมาคมรวม จากวัตถุประสงค์ TOOBJECTID
0-5 6626541373 233620335
0-5 6616436082 3866015468
0-5 6690805943 7132752747
- - -

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

ดึงข้อมูลตั๋วทั้งหมดที่เกี่ยวข้องกับผู้ติดต่อเฉพาะ (รหัสผู้ติดต่อ: 3005 )

สอบถาม :


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


การส่งคืน:

ประเภทสมาคมแบบผสมผสาน จากวัตถุประสงค์ TOOBJECTID
0-5 6626541373 233620335

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

ดึงข้อมูลข้อตกลงทั้งหมดที่เกี่ยวข้องกับผู้ติดต่อเฉพาะ (รหัสผู้ติดต่อ: 4464 ) แทนที่จะใช้การเข้ารหัสแบบรวม CombineAssociationTypeId ตัวอย่างนี้จะรวมเข้ากับ 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;


การส่งคืน:

รหัสประเภทสมาคมรวม จากวัตถุประสงค์ TOOBJECTID
0-5 6626541373 233620335

การสอบถามเจ้าของ

เจ้าของ

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

อ็อบเจกต์ ฐานข้อมูลนี้สามารถส่งคืนคอลัมน์ต่อไปนี้ได้:

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

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

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

สอบถาม :


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

 
การส่งคืน:

รหัสเจ้าของ รหัสผู้ใช้ อีเมล ชื่อจริง นามสกุล
29584574 4621126 233620335 ฮ็อบส์ บารอน
30532717 4874784 3866015468 ปาโบล วอลเตอร์ส
30580321 925511 7132752747 ไมโล ระดับ Elite
- - - - -

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

ดึงข้อมูลเจ้าของที่เฉพาะเจาะจงโดยใช้รหัสเจ้าของของพวกเขา

สอบถาม :


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


การส่งคืน:

รหัสเจ้าของ รหัสผู้ใช้ อีเมล ชื่อจริง นามสกุล
29584574 4621126 233620335 ฮ็อบส์ บารอน

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

ดึงข้อมูลผู้ติดต่อทั้งหมดและเจ้าของของพวกเขา แบบสอบถามนี้จะรวมระเบียนกับเจ้าของโดยใช้ object_with_object_properties และ คุณสมบัติสำหรับการติดต่อ 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


การส่งคืน:

หมายเลขติดต่อ CONTACT_FIRSTNAME นามสกุลผู้ติดต่อ รหัสเจ้าของฮับติดต่อ เจ้าของชื่อจริง นามสกุลเจ้าของ เจ้าของอีเมล
113834202 ริชาร์ด กรีนฟิลด์ 29584574 ฮ็อบส์ บารอน ฮอบส์ บี@business.com
53540801 ฟอร์ด คาร์ล 30241125 ไมโล ระดับ Elite ไมโล.จี@business.com
- - - - - - -

การสอบถามทีม

ทีม

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

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

อ็อบเจกต์ ฐานข้อมูลนี้สามารถส่งคืนคอลัมน์ต่อไปนี้ได้:

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

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

ดึงข้อมูลทีมทั้งหมด

สอบถาม :

SELECT teamId,teamName, primaryOwnerMembers

จากทีม

การส่งคืน:

ทีมไอดี ชื่อทีม เจ้าของหลักสมาชิก
29584574 ทีมย่อย [233620335, 1234553]
30532717 ซุปเปอร์ทีม [3866015468, 126221873]
3058032 ทีม [7132752747]

เจ้าของทีม

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

อ็อบเจกต์ ฐานข้อมูลนี้สามารถส่งคืนคอลัมน์ต่อไปนี้ได้:

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

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

ดึงข้อมูลเจ้าของทั้งหมดสำหรับทีมที่กำหนด

สอบถาม :

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

ผลตอบแทน

ทีมไอดี ชื่อทีม ISTEAMPRIMARY
29584574 233620335 จริง
29584574 1234553 จริง 

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

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

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

ท่อส่งน้ำ

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

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

ชื่อคอลัมน์ พิมพ์ คำอธิบาย
PIPELINEID วาร์ชาร์ ID ของท่อส่งน้ำมัน
OBJECTTYPEID วาร์ชาร์ ID ของ อ็อบเจกต์ ที่ ไปป์ไลน์ สามารถมีได้ (เช่น ข้อเสนอหรือตั๋ว)
LABEL วาร์ชาร์ ชื่อไปป์ไลน์ใน 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;

 
การส่งคืน:

ประเภทวัตถุID รหัสท่อส่งน้ำ ฉลาก
0-3 1bed503c-37f7-4f51-9d40-7598902673f4 ไปป์ไลน์การขาย
0-3 12659678 ไปป์ไลน์ ใบอนุญาต
0-3 75e28846-ad0d-4be2-a027-5e1da6590b98 ธุรกิจใหม่
- - -

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

ดึงข้อมูลข้อตกลงภายใน ไปป์ไลน์ ที่ระบุ รวม object_with_object_properties และ pipelines

สอบถาม :


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_NAME ชื่อท่อ
605140072 สมัครสมาชิก Meowmix ทั่วโลก ไปป์ไลน์การขาย
605457408 ฟริสกี้ส์รีแบรนด์ ไปป์ไลน์การขาย
604362473 สร้างแอป Fresh Step ไปป์ไลน์การขาย

 

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

 

เช่นเดียวกับตัวอย่างที่ 2 ด้านบน ดึงข้อมูลข้อตกลงภายใน ไปป์ไลน์ ที่ระบุ แต่แทนที่จะใช้ objects_deals ในการ joins ให้ใช้ 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';

 

การส่งคืน: 

รหัสข้อตกลง

DEAL_NAME

ชื่อท่อ

605140072

สมัครสมาชิก Meowmix ทั่วโลก

ไปป์ไลน์การขาย

605457408

ฟริสกี้ส์รีแบรนด์

ไปป์ไลน์การขาย

604362473

สร้างแอป Fresh Step

ไปป์ไลน์การขาย

ขั้นตอนของท่อส่งน้ำ

มุมมองนี้ประกอบด้วยข้อมูลเกี่ยวกับขั้นตอนต่างๆ ภายใน ไปป์ไลน์ ระบุ ขั้นตอนโดยการรวม 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;

 
การส่งคืน:

รหัสท่อส่งน้ำ สเตจไอดี ฉลาก
941650 941651 ติดต่อแล้ว
941650 941652 กำหนดการนัดหมาย
941650 941653 ส่งใบแจ้งหนี้แล้ว
- - -

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

ดึงข้อมูลข้อตกลงทั้งหมดและขั้นตอน ไปป์ไลน์ ที่เกี่ยวข้อง

สอบถาม :


SELECT
deals.objectId deal_id,
deals.properties:dealname::varchar deal_name,
pipelines.label pipeline_name,
pipeline_stages.label pipeline_stage_name
FROM object_with_object_properties deals
INNER JOIN pipelines
ON deals.objectTypeId = pipelines.objectTypeId
AND deals.properties:pipeline::string = pipelines.pipelineid
INNER JOIN pipeline_stages
ON deals.objectTypeId = pipeline_stages.pipelineid
AND deals.properties:pipeline::string = pipeline_stages.pipelineid
AND deals.properties:dealstage::string = pipeline_stages.stageId
WHERE deals.objecttypeId = '0-3';


การส่งคืน:

รหัสข้อตกลง DEAL_NAME ชื่อท่อ ชื่อเวทีท่อ
605140072 สมัครสมาชิก Meowmix ทั่วโลก ไปป์ไลน์การขาย ส่งสัญญาแล้ว
605457408 ฟริสกี้ส์รีแบรนด์ ไปป์ไลน์การขาย กำหนดการนัดหมาย
604362473 สร้างแอป Fresh Step ไปป์ไลน์การขาย เซ็นสัญญาแล้ว
- - - -

การสอบถามเกี่ยวกับ คุณสมบัติ

นิยามของทรัพย์สิน

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

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

อ็อบเจกต์ ฐานข้อมูลนี้สามารถส่งคืนคอลัมน์ต่อไปนี้ได้:

ชื่อคอลัมน์ พิมพ์ คำอธิบาย
OBJECTYPEID วาร์ชาร์ ID ของ อ็อบเจกต์ ที่เกี่ยวข้องกับ เหตุการณ์
NAME วาร์ชาร์ ชื่อภายในของทรัพย์สิน
LABEL วาร์ชาร์ ป้ายทรัพย์สิน
DESCRIPTION วาร์ชาร์ คำอธิบายของทรัพย์สิน
TYPE วาร์ชาร์ ประเภทของทรัพย์สิน (เช่น สตริง, ตัวเลข, วันที่และเวลา)
FIELDTYPE วาร์ชาร์ ประเภทฟิลด์ของทรัพย์สิน กำหนดวิธีการแสดง คุณสมบัติ ใน HubSpot และบนแบบฟอร์ม (เช่น ช่องทำเครื่องหมาย เลือก)
DISPLAYORDER ตัวเลข ลำดับการแสดงทรัพย์สิน
GROUPNAME วาร์ชาร์ ชื่อกลุ่มของทรัพย์สิน
OPTIONS ตัวแปร สำหรับคุณสมบัติการแจงนับ อาร์เรย์ของตัวเลือกคุณสมบัติ รวมถึงแอตทริบิวต์ของแต่ละตัวเลือก (เช่น ลำดับการแสดง ป้ายชื่อ)
CREATEDUSERID ตัวเลข รหัสของผู้ใช้ที่สร้าง คุณสมบัติ
REFERENCEDOBJECTTYPE วาร์ชาร์ ชนิดของ อ็อบเจกต์ ที่ คุณสมบัติ อ้างอิง คุณสมบัติของเจ้าของจะส่งคืนค่าของ OWNER
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'

 
การส่งคืน:

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

การสอบถาม เหตุการณ์

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

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

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

 ลิงก์ที่คลิกในอีเมล การตลาด โดยผู้ติดต่อ
กิจกรรม_คลิกลิงก์_ติดตาม_กล่องข้อความ_อีเมล_V8 ลิงก์ที่คลิกใน การสนทนา การสนทนาอีเมลตามผู้ติดต่อ
กิจกรรม_คุกกี้_แบนเนอร์_คลิกแล้ว ผู้ติดต่อที่คลิกคุกกี้
EVENTS_COOKIE_BANNER_VIEWED ผู้ติดต่อที่ดูคุกกี้
เอกสารกิจกรรม_SHARED_V2 เอกสาร การขายที่แชร์กับผู้ติดต่อผ่านลิงค์ภายนอก
EVENTS_DOCUMENT_VIEWED_V2 เอกสาร การขายและผู้ติดต่อที่พวกเขาได้ดูโดยการเปิดลิงก์ภายนอก
EVENTS_DOCUMENT_COMPLETED_V2 เอกสาร การขายและผู้ติดต่อที่ได้ปิดการขายแล้ว
กิจกรรม_HS_SCHEDULED_EMAIL_V2 อีเมลที่ส่งไปยังเซิร์ฟเวอร์อีเมลของ HubSpot จะถูกส่ง
กิจกรรม_MTA_DELIVERED_EMAIL_V2 อีเมลถูกส่งไปยังผู้รับโดยเซิร์ฟเวอร์อีเมล HubSpot สำเร็จแล้ว
กิจกรรม_MTA_BOUNCED_EMAIL_V2 ความพยายามในการส่งอีเมลที่ถูกปฏิเสธโดยเซิร์ฟเวอร์อีเมลของผู้รับ
กิจกรรม_เปิดอีเมล_V2 อีเมล์เปิดตามรายชื่อติดต่อ
EVENTS_REPORTED_SPAM_EMAIL_V2 อีเมล์ที่ถูกทำเครื่องหมายว่าเป็นสแปมโดยผู้รับ
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2 การเปลี่ยนแปลงการสมัครรับอีเมลโดยผู้รับ
กิจกรรม_เปิด_ติดตาม_กล่องจดหมาย_อีเมล_V8 กล่องจดหมายการอนุรักษ์จะเปิดตามรายชื่อติดต่อ
EVENTS_MB_MEDIA_เล่นแล้ว กิจกรรมการเล่นวิดีโอตามผู้ติดต่อ
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE ติดต่อจองการประชุมผ่าน ลำดับ
กิจกรรม_V2_ติดต่อลงทะเบียนตามลำดับ ติดต่อลงทะเบียนจาก ลำดับ
กิจกรรม_V2_ติดต่อ_เสร็จสิ้น_ลำดับ ลำดับ เสร็จสิ้นแล้ว
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL ติดต่อตอบกลับอีเมล์ (หรืออีเมล์ขาเข้าที่ยกเลิก ลำดับ การลงทะเบียน) ที่ส่งผ่าน ลำดับ
กิจกรรม_V2_ติดต่อ_ยกเลิกลงทะเบียน_ตามลำดับ ติดต่อยกเลิกการลงทะเบียนจาก ลำดับ
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE ผู้ใช้ยกเลิกการลงทะเบียนผู้ติดต่อด้วยตนเอง
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL ติดต่อยกเลิกการสมัคร,ยกเลิกลำดับ ลำดับ.
เหตุการณ์_V2_ลำดับ_อีเมลเด้งออก ลำดับ อีเมลถูกตีกลับ
เหตุการณ์_V2_ลำดับเหตุการณ์_เกิดข้อผิดพลาด ลำดับ มีข้อผิดพลาดทำให้ไม่สามารถลงทะเบียนได้
กิจกรรม V2_SEQUENCE_STEP_ดำเนินการแล้ว ดำเนินการขั้นตอน ลำดับ แล้ว
หน้ากิจกรรมที่เยี่ยมชม การเยี่ยมชม หน้าเว็บไซต์ ตามการติดต่อ
EVENTS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER> เหตุการณ์บูรณาการ ( ไทม์ไลน์ V3 API )

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

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

  • occurredat
  • occurredatdateint

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



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

OCCURREDATDATEINT

 

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

OCCUREDATDATEINT

 ตัวเลข

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

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

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

โปรดทราบ: คอลัมน์นี้จะถูกยกเลิกในวันที่ 24 พฤศจิกายน 2022 และจะแทนที่ด้วย OCCURREDAT -
INGESTEDAT ตราประทับเวลา วันที่และเวลาที่ข้อมูลถูกรวบรวมโดย Snowflake ครั้งล่าสุด เรียนรู้เพิ่มเติมเกี่ยวกับ ประเภทข้อมูลคอลัมน์
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;


การส่งคืน:

ประเภทเหตุการณ์ ประเภทวัตถุID รหัสวัตถุ เกิดขึ้น คลิกลิงก์ HST_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;


การส่งคืน:

คลิก_ประทับเวลา คลิก_URL CONTACT_FIRSTNAME นามสกุลผู้ติดต่อ
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 ไมโล ระดับ Elite
2018-11-08 09:37:41.426 https://www.website.net/contact?utm_source=hs_automation&utm_medium=email&utm_content=55200164 ฮาร์โลว์ วิลลารี
- - - -

แบบสอบถามประเภทวัตถุและเหตุการณ์

คำจำกัดความของประเภทวัตถุและเหตุการณ์

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

อ็อบเจกต์ ฐานข้อมูลนี้สามารถส่งคืนคอลัมน์ต่อไปนี้ได้:

ชื่อคอลัมน์ พิมพ์ คำอธิบาย
OBJECTTYPEID วาร์ชาร์ ID ของ อ็อบเจกต์ ที่ ไปป์ไลน์ สามารถมีได้ (เช่น ข้อเสนอหรือตั๋ว)
FULLYQUALIFIEDNAME วาร์ชาร์ ชื่อของ อ็อบเจกต์ หรือ เหตุการณ์
INGESTEDAT ตราประทับเวลา วันที่และเวลาที่ข้อมูลถูกรวบรวมโดย Snowflake ครั้งล่าสุด เรียนรู้เพิ่มเติมเกี่ยวกับ ประเภทข้อมูลคอลัมน์

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

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

สอบถาม :


SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;

 
การส่งคืน:

ประเภทวัตถุID ชื่อที่มีคุณสมบัติครบถ้วน
0-1 ติดต่อ
0-8 รายการไลน์
0-11 การสนทนา
- -

รายการสอบถาม

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

รายการ

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

อ็อบเจกต์ ฐานข้อมูลนี้สามารถส่งคืนคอลัมน์ต่อไปนี้ได้:

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

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

ดึงข้อมูลรายชื่อผู้ติดต่อทั้งหมด

สอบถาม :


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

 
การส่งคืน:

รายการ ชื่อ ขนาด
118131 การเข้าถึงรายสัปดาห์ 103
66156 สมาชิก บล็อก 455
771852 สมาชิกสูงสุด 2021 37
- - -

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

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

สอบถาม :


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


การส่งคืน:

รายการ ชื่อ ขนาด
771852 สมาชิกสูงสุด 2021 37

รายการสมาชิก

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

มีเฉพาะ ID รายการและ ID ของ อ็อบเจกต์ เท่านั้น สำหรับข้อมูลเพิ่มเติม ให้เชื่อมโยงกับ อ็อบเจกต์ ฐานข้อมูล รายการ

อ็อบเจกต์ ฐานข้อมูลนี้สามารถส่งคืนคอลัมน์ต่อไปนี้ได้:

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

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

ดึงข้อมูล ID ของผู้ติดต่อทั้งหมดในรายชื่อ สมาชิกรายสูงสุดประจำปี 2021

สอบถาม :


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

 
การส่งคืน:

รหัสวัตถุ
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'


การส่งคืน:

รหัสวัตถุ

ชื่อจริง

นามสกุล

54325098

ฮ็อบส์

บารอน

96805401

ไมโล

ระดับ Elite

6922028

เฮนรี่

ไรลีย์

-

-

-

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

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


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


SELECT * FROM property_definitions

WHERE label = [column_name]

 

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

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

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


หากคุณต้องการเชื่อมโยงสองระเบียนที่แตกต่างกันหรือมากกว่าเข้าด้วยกัน โปรดดูที่การเชื่อมโยง สมาคมแสดงถึงความสัมพันธ์ระหว่างวัตถุใน HubSpot CRM การเชื่อมโยงที่เป็นไปได้ทั้งหมดที่แตกต่างระหว่างสองประเภทนั้นมีอยู่ใน association_definitions ในตัวอย่างข้างต้น หากต้องการทราบแบบฟอร์มทั้งหมดที่แคมเปญเชื่อมโยงอยู่ คุณจะต้องสอบถาม ASSOCIATIONS_CAMPAIGNS_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

ผลลัพธ์จะแสดงเป็นดังนี้:

สถานะ ข้อความ อัปเดตแล้ว
ตกลง ไม่มีเหตุการณ์ที่ทราบในขณะนี้ 2023-04-10 09:21:20.123

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

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