เบต้าส่งออกข้อมูล HubSpot ไปยัง Microsoft Fabric

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

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

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

ก่อนที่คุณจะเริ่มต้น

ทำความเข้าใจข้อกำหนด

ในการส่งออกข้อมูลไปยัง Microsoft Fabric คุณจะต้อง:

• พื้นที่ทำงานของ Microsoft Fabric พร้อมคลังสินค้า Fabric
• ตัวหลักของบริการ Microsoft Entra ID ถูกเพิ่มลงในพื้นที่ทำงาน Fabric ด้วยบทบาท Contributor
• ID ผู้เช่ารหัสลูกค้าและความลับของลูกค้าของผู้ให้บริการหลัก
• สตริงการเชื่อมต่อ Fabric Warehouse SQL ของคุณ (ที่อยู่เซิร์ฟเวอร์โดยไม่มีหมายเลขพอร์ต) และชื่อคลังสินค้า

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

• สร้างสคีมา
• สร้างตาราง
• แทรกแถว
• เปลี่ยนชื่อหรือปรับเปลี่ยนตารางที่เป็นเจ้าของ HubSpot
• วางตารางและสคีมาที่เป็นเจ้าของ HubSpot

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

หากพื้นที่ทำงาน Fabric ของคุณจำกัดการเข้าถึงเครือข่ายให้เพิ่มที่อยู่ IP ขาออกของ HubSpot สำหรับภูมิภาคบัญชีของคุณลงในรายการที่อนุญาต

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

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

เชื่อมต่อ HubSpot กับ Microsoft Fabric

ขอแนะนำให้เปิดบัญชี HubSpot และคอนโซล Microsoft Fabric ของคุณในแท็บแยกต่างหาก

1. ในบัญชี HubSpot ของคุณ ให้คลิก เพิ่มเติม จากนั้นไปที่ การจัดการข้อมูล > ดาต้าสตูดิโอ หาก เพิ่มเติม ไม่ปรากฏในบัญชีของคุณ ให้ไปที่ การจัดการข้อมูล > ดาต้าสตูดิโอ โดยตรง
2. ที่ด้านบนขวาให้คลิกเชื่อมต่อแหล่งข้อมูลภายนอก
3. ในแผงเพิ่มแหล่งข้อมูลให้ค้นหาหรือเรียกดูใน Microsoft Fabric
4. คลิกติดตั้งจากนั้นคลิกถัดไป
5. ป้อน ID ผู้เช่ารหัสลูกค้าและความลับของลูกค้าของตัวการบริการของคุณ
6. กรอกรายละเอียดปลายทางต่อไปนี้:
   • สตริงการเชื่อมต่อ SQL: ที่อยู่เซิร์ฟเวอร์สำหรับคลังสินค้าผ้าของคุณโดยไม่มีหมายเลขพอร์ต
   • ชื่อคลังสินค้า: ชื่อของคลังสินค้าผ้าที่จะส่งออกไปยัง
7. คลิกทดสอบการเชื่อมต่อหากการทดสอบการเชื่อมต่อสำเร็จให้คลิกถัดไป

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

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

1. เลือกแหล่งข้อมูลที่จะส่งออก:
   • วัตถุ
   • สมาคม
   • กิจกรรม
2. เลือกวัตถุคุณสมบัติการเชื่อมโยงหรือเหตุการณ์ที่จะรวม
3. เลือกความถี่ในการเรียกใช้การซิงค์และเวลาที่จะเริ่มต้น
4. คลิกเริ่มการซิงค์

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

เข้าถึงข้อมูลที่ส่งออกของคุณ

HubSpot สร้าง Schema ที่จัดการโดย 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 ตัวอักษรจะถูกทำให้สั้นลง
• ชื่อคอลัมน์ที่ชนกันจะได้รับส่วนต่อท้าย
• การชนกันของชื่อตารางทำให้การส่งออกที่ได้รับผลกระทบล้มเหลว

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

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

ตารางวัตถุ

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

OBJECT_PROPERTIES

ตารางนี้มีหนึ่งแถวสำหรับแต่ละค่าคุณสมบัติวัตถุ

OBJECT_WITH_OBJECT_PROPERTIES

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

ข้อมูลอ็อบเจ็กต์สำหรับอ็อบเจ็กต์ประเภทต่างๆจะถูกรวมไว้ในตารางนี้ กรองตาม OBJECTTYPEID เพื่ออ่านระเบียนสำหรับประเภทวัตถุเฉพาะ:

• รายชื่อผู้ติดต่อ: 0 -1
• วัตถุที่กำหนดเอง: 2 -{ unique_id} เช่น 2 -12345

OBJECT_PROPERTIES_HISTORY

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

หากต้องการดูประวัติทั้งหมดสำหรับระเบียนและทรัพย์สินเฉพาะให้เรียงลำดับผลลัพธ์UPDATEDAT UPDATEDAT

ตารางการเชื่อมโยง

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

สมาคม

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

ASSOCIATION_DEFINITIONS

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

ตารางการเชื่อมโยงแบบเฉพาะคู่

สำหรับคู่การเชื่อมโยงที่เลือก HubSpot ยังสามารถส่งออกตารางที่มีรูปแบบต่อไปนี้:

ASSOCIATIONS__TO_

ตัวอย่างเช่น: ASSOCIATIONS_CONTACTS_TO_COMPANIESCOMPANIES

ตารางเหล่านี้มีระเบียนการเชื่อมโยงและเมต้าดาต้าคำนิยามการเชื่อมโยง

ตารางกิจกรรม

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

EVENTS_

ตัวอย่างเช่น: EVENTS_VISITED_PAGE

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

ตรวจสอบการซิงค์ของคุณ

1. ในบัญชี HubSpot ของคุณ ให้คลิก เพิ่มเติม จากนั้นไปที่ การจัดการข้อมูล > ดาต้าสตูดิโอ หาก เพิ่มเติม ไม่ปรากฏในบัญชีของคุณ ให้ไปที่ การจัดการข้อมูล > ดาต้าสตูดิโอ โดยตรง
2. คลิกซิงค์แอปทางด้านซ้าย
3. ค้นหาหรือเลือกการซิงค์ Microsoft Fabric

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

สถานะการซิงค์

แก้ปัญหาความล้มเหลวในการซิงค์

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

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

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

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

สืบค้นตารางในสคีมาปลายทางด้วย SQL

-- อ่านบันทึกการติดต่อทั้งหมด
เลือก *
จาก [your_database]. [hubspot_data_out_456][OBJECT_WITH_OBJECT_PROPERTIES]
โดยที่ [OBJECTTYPEID] = '0 -1 '; -- อ่านคุณสมบัติเฉพาะจากคุณสมบัติสตริง JSON
เลือก
  [ObjectID],
  JSON_VALUE ([PROPERTIES],' $ .email ') เป็น [email]
จาก [your_database] [hubspot_data_out_456][OBJECT_WITH_OBJECT_PROPERTIES]
โดยที่ [OBJECTTYPEID] = '0 -1 ';

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

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

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

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

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

รองรับข้อมูลที่ละเอียดอ่อนหรือไม่

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

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

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

HubSpot ใช้ถังจัดฉากที่ฉันจัดการหรือไม่?

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

จะเกิดอะไรขึ้นหากฉันเชื่อมต่อกับผู้อำนวยการฝ่ายบริการคนอื่นอีกครั้ง

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