เบต้าเข้าถึงข้อมูล HubSpot ของคุณจาก Amazon Redshift

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

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

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

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

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

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

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

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

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

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

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

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

HubSpot ส่งออกข้อมูลเป็นไฟล์ Parquet จัดลำดับไฟล์ในที่เก็บ S3 ของคุณและโหลดลงในตาราง Redshift

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

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

HubSpot สร้างตารางหนึ่งตารางต่อแหล่งข้อมูลใน Schema ที่จัดการโดย HubSpot ตามชื่อปลายทางของคุณ:

.hubspot_data_out_.

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

• 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 ไฟล์ปาร์เก้ในที่เก็บ S3 ของคุณภายใต้คำนำหน้าที่จัดการโดย HubSpot จากนั้นโหลดลงใน Redshift:

s3:////hubspot-dataout/////

ไฟล์การจัดฉากเหล่านี้จะอยู่ในถังของคุณจนกว่าคุณจะลบออก หากต้องการลบออกโดยอัตโนมัติให้กำหนดค่านโยบายวงจรชีวิต S3 บนถังหรือคำนำหน้า

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

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

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

OBJECT_PROPER

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

OBJECT_WITH_OBJECT_PROPER

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

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

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

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

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

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

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

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

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

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

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

SELECT * FROM your_database.hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES WHERE OBJECTTYPEID = '0-1';

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

SELECT OBJECTID, JSON_EXTRACT_PATH_TEXT(PROPERTIES, 'email') AS email FROM your_database.hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES WHERE OBJECTTYPEID = '0-1';

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

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

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

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

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

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

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

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