เบต้าเข้าถึงข้อมูล HubSpot ของคุณจาก PostgreSQL หรือ MySQL

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

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

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

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

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

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

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

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

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

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

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

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

HubSpot ส่งออกข้อมูลเป็นไฟล์ Parquet และโหลดลงในตารางในฐานข้อมูลของคุณโดยตรง PostgreSQL และ MySQL ไม่ได้ใช้ถังจัดฉากที่ลูกค้าเป็นเจ้าของ HubSpot จัดการการดำเนินการภายใน

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

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

• PostgreSQL: .hubspot_data_out_.
• MySQL: hubspot_data_out_. ใน MySQL สคีมาและฐานข้อมูลเป็นแนวคิดเดียวกันและ HubSpot สร้างมันขึ้นมา ไม่มีระดับฐานข้อมูลแยกให้เลือก

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

• 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

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

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

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

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

ชื่อตารางและคอลัมน์มาจากข้อมูลที่ส่งออก ตัวระบุ PostgreSQL ถูกจำกัดไว้ที่ 63 ตัวอักษรและตัวระบุ MySQL ถูกจำกัดไว้ที่ 64 ตัวอักษร HubSpot ย่อชื่อที่ยาวขึ้นให้พอดี

กรณีตัวระบุ

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

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

ตัวอย่าง PostgreSQL:

เลือก * จาก your_database.hubspot_data_out_456"OBJECT_WITH_OBJECT_PROPERTIES" ที่ "OBJECTTYPEID" = '0 -1 ';

ตัวอย่าง MySQL:

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

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

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

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

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

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

OBJECT_PROPERTIES

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

OBJECT_WITH_OBJECT_PROPERTIES

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

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

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

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

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

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

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

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

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

PostgreSQL

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

เลือก * จาก your_database.hubspot_data_out_456"OBJECT_WITH_OBJECT_PROPERTIES" ที่ "OBJECTTYPEID" = '0 -1 ';

อ่านคุณสมบัติเฉพาะจากคอลัมน์PROPERTIES JSON โยนคอลัมน์ไปที่ JSON ก่อนเพราะจัดเก็บเป็นข้อความ:

เลือก "ObjectID ", json_extract_path_text (" PROPERTIES ":: json, 'email ') เป็นอีเมลจาก your_database.hubspot_data_out_456"OBJECT_WITH_OBJECT_PROPERTIES" ที่ "OBJECTTYPEID" = '0 -1 ';

MySQL

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

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

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

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

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

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

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

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

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

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

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

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