เบต้าเข้าถึงข้อมูล HubSpot ของคุณจาก Microsoft Azure Synapse Analytics

ใช้ Data Out สำหรับ Azure Synapse เพื่อส่งออกข้อมูล HubSpot CRM ที่เลือกไปยังตารางในกลุ่ม SQL เฉพาะของ Azure Synapse ที่คุณเป็นเจ้าของ HubSpot จะรีเฟรชตารางเอาต์พุตแต่ละตารางจากการส่งออกข้อมูลที่เลือกทั้งหมด หลังจากการซิงค์คุณสามารถค้นหาตารางด้วย SQL หรือด้วย BI และเครื่องมือวิเคราะห์ที่คุณต้องการเพื่อรวมข้อมูล HubSpot กับข้อมูลธุรกิจอื่นๆ

โปรดทราบ: หากคุณเป็นซูเปอร์แอดมินให้เลือกบัญชีของคุณใน Data Studio เบต้าเพื่อใช้ฟีเจอร์นี้

ทำความเข้าใจข้อจำกัดและข้อพิจารณา

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

• HubSpot อัปเดตตารางแยกต่างหาก หากคุณค้นหาในหลายตารางในขณะที่ซิงค์กำลังทำงานบางตารางอาจอัปเดตก่อนตารางอื่น
• Data Out ไม่มีการเก็บสแนปชอตในอดีต หลังจากรีเฟรชสำเร็จแล้วตารางปลายทางจะมีสแนปชอตล่าสุด
• ออบเจ็กต์ประเภทเหตุการณ์หรือคู่การเชื่อมโยงแต่ละคู่สามารถรวมอยู่ในการซิงค์ Azure Synapse ที่เกิดขึ้นประจำหนึ่งครั้งต่อบัญชี HubSpot ขีดจำกัดนี้เป็นอิสระจากผู้ให้บริการ Data Out รายอื่น
• ยังไม่รองรับตารางเฉพาะOBJECTS_CONTACTSCONTACTS
• หากชื่อตารางสองชื่อชนกันหลังจาก HubSpot ทำให้เป็นปกติการส่งออกที่ได้รับผลกระทบจะล้มเหลว สำหรับข้อมูลเพิ่มเติมโปรดตรวจสอบกฎชื่อตารางและคอลัมน์

ทำความเข้าใจข้อมูลที่คุณสามารถส่งออกได้

คุณสามารถซิงค์ข้อมูลต่อไปนี้จาก HubSpot ไปยัง Azure Synapse Analytics:

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

ข้อมูลสำหรับวัตถุที่แตกต่างกันจะถูกรวมไว้ในตารางวัตถุ เมื่อคุณอ่านตารางวัตถุให้ใช้ OBJECTTYPEID เพื่อกรองไปยังวัตถุที่ต้องการ ตัวอย่างเช่นผู้ติดต่อใช้ 0-1 วัตถุที่กำหนดเองจะถูกกำหนด ID เมื่อสร้างขึ้นและระบุเป็น 2-{unique_id} เช่น 2-12345 -12345

ทำความเข้าใจรูปแบบการส่งออก

ในระหว่างการตั้งค่าคุณเลือก:

• ปลายทาง Azure Synapse ทุ่มเทจุดสิ้นสุด SQL และฐานข้อมูล
• แหล่งข้อมูลที่จะซิงค์: วัตถุเหตุการณ์การเชื่อมโยงหรือการรวมกันของแหล่งข้อมูลเหล่านี้
• กำหนดการซิงค์

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

ค้นหาข้อมูลของคุณใน Azure Synapse

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

.hubspot_data_out_.

คุณสามารถค้นหาชื่อสคีมาที่แน่นอนได้ในหน้าการกำหนดค่าของการซิงค์ตัวอย่างเช่น:

• your_database.hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES
• your_database.hubspot_data_out_456.EVENTS_VISITED_PAGE
• your_database.hubspot_data_out_456.ASSOCIATIONS_CONTACTS_TO_COMPANIES

ชื่อตารางและคอลัมน์

HubSpot ทำให้ชื่อตารางและคอลัมน์ที่ส่งออกเป็นตัวอักษรพิมพ์ใหญ่ตัวเลขและเครื่องหมายขีดล่างเป็นปกติ:

• ช่องว่างและเครื่องหมายยัติภังค์กลายเป็นเครื่องหมายขีดล่าง
• อักขระอื่นๆที่ไม่ใช่ตัวอักษรและตัวเลขจะถูกลบออก
• ชื่อที่มีความยาวมากกว่า 128 ตัวอักษรจะถูกทำให้สั้นลง
• ชื่อคอลัมน์ที่ชนกันจะได้รับส่วนต่อท้าย
• การชนกันของชื่อตารางทำให้การส่งออกที่ได้รับผลกระทบล้มเหลว

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

เลือก *
จาก [your_database]. [hubspot_data_out_456][OBJECT_WITH_OBJECT_PROPERTIES]
โดยที่ [OBJECTTYPEID] = '0 -1 ';

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

ประเภทคอลัมน์เป็นไปตามข้อมูลที่ส่งออกและจับคู่กับประเภท Azure Synapse ดังนี้:

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

ตรวจสอบตารางอ็อบเจกต์

หากคุณเลือกข้อมูลวัตถุ HubSpot จะส่งออกตารางต่อไปนี้

OBJECT_PROPER

ตารางนี้มีหนึ่งแถวต่อค่าคุณสมบัติ หากต้องการอ่านวัตถุเฉพาะให้กรองOBJECTTYPEID OBJECTTYPEID

OBJECT_WITH_OBJECT_PR

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

OBJECT_PROPERTIES_HISTORY

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

ตรวจสอบตารางการเชื่อมโยง

หากคุณเลือกข้อมูลการเชื่อมโยงบันทึกการเชื่อมโยงการส่งออกของ HubSpot และคำจำกัดความของการเชื่อมโยง

สมาคม

ตารางนี้มีหนึ่งแถวต่อการเชื่อมโยงที่เลือกระหว่างสองระเบียน

ASSOCIATION_DEFINIT

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

ASSOCIATIONS _< FROM_OBJECT >_TO_< TO_OBJECT >

สำหรับคู่สมาคมที่เลือก HubSpot ยังสามารถส่งออกตารางการเชื่อมโยงเฉพาะคู่ได้เช่น ASSOCIATIONSASSOCIATIONS_CONTACTS_TO_COMPANIESCOMPANIES ตารางเหล่านี้รวมถึงระเบียนการเชื่อมโยงพร้อมกับเมต้าดาต้าคำนิยามการเชื่อมโยง

ตรวจสอบตารางกิจกรรม

หากคุณเลือกข้อมูลกิจกรรม HubSpot จะส่งออกหนึ่งตารางต่อประเภทกิจกรรม ชื่อตารางใช้รูปแบบ EVENTS_ เช่น EVENTS_VISITED_PAGEPAGE

ตารางกิจกรรมแต่ละตารางมีคอลัมน์กิจกรรมมาตรฐานและหนึ่งคอลัมน์สำหรับแต่ละคุณสมบัติกิจกรรมที่เลือก

จัดการกำหนดการซิงค์

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

โปรดทราบ: ในช่วงเบต้าความถี่ในการซิงค์ที่มีอยู่อาจถูกจำกัด อาจมีการเพิ่มตัวเลือกความถี่เพิ่มเติมในรุ่นถัดไป

ตรวจสอบการซิงค์และจัดการข้อผิดพลาด

คุณสามารถตรวจสอบการซิงค์ Azure Synapse ใน HubSpot การซิงค์สามารถมีสถานะใดสถานะหนึ่งต่อไปนี้:

เมื่อการซิงค์ล้มเหลว:

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

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

ฉันจะสืบค้นข้อมูลได้อย่างไร

สืบค้นตารางในสคีมาปลายทางของคุณด้วย SQL ตัวอย่างเช่นอ่านบันทึกการติดต่อทั้งหมด:

เลือก *
จาก [your_database]. [hubspot_data_out_456][OBJECT_WITH_OBJECT_PROPERTIES]
โดยที่ [OBJECTTYPEID] = '0 -1 ';

อ่านคุณสมบัติเฉพาะจากสตริงPROPERTIES JSON:

เลือก
  [OBJECTID],
  JSON_VALUE ([คุณสมบัติ], '$ .email ') เป็น [email]
จาก [your_database]. [hubspot_data_out_456][OBJECT_WITH_OBJECT_PROPERTIES]
โดยที่ [OBJECTTYPEID] = '0 -1 ';

ฉันสามารถส่งออกข้อมูลหนึ่งประเภทในการซิงค์หลายรายการได้หรือไม่?

ออบเจ็กต์ประเภทเหตุการณ์หรือคู่การเชื่อมโยงแต่ละคู่สามารถรวมอยู่ในการซิงค์ Azure Synapse ที่เกิดขึ้นประจำหนึ่งครั้งต่อบัญชี HubSpot ขีดจำกัดนี้เป็นอิสระจากผู้ให้บริการ Data Out รายอื่น

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

รองรับตารางเฉพาะวัตถุหรือไม่

ยังไม่รองรับตารางเฉพาะOBJECTS_CONTACTSCONTACTS ใช้ OBJECT_WITH_OBJECT_PROPERTIES และกรองOBJECTTYPEID OBJECTTYPEID เพื่อรับระเบียนสำหรับวัตถุเฉพาะ

HubSpot เก็บสแน็ปช็อตก่อนหน้านี้ไว้หรือไม่

ไม่ Data Out ไม่มีการเก็บสแนปชอตในอดีต หลังจากรีเฟรชสำเร็จแล้วตารางปลายทางจะมีสแนปชอตล่าสุด หากไม่สามารถอัปเดตตารางได้ข้อมูลที่ประสบความสำเร็จก่อนหน้านี้มักจะยังคงมีอยู่