เบต้าส่งออกข้อมูล HubSpot ไปยัง PostgreSQL หรือ MySQL

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

สรุป

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

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

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

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

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

อนุญาตที่อยู่ IP ของ HubSpot

เพิ่มช่วง IP ของ HubSpot สำหรับภูมิภาคบัญชีของคุณลงในรายการที่อนุญาตของเซิร์ฟเวอร์ฐานข้อมูลของคุณ

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

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

เชื่อมต่อ HubSpot กับ PostgreSQL หรือ MySQL

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

HubSpot ใช้ผู้ใช้ฐานข้อมูลที่เชื่อมต่อเพื่อสร้างตารางและโหลดข้อมูลลงในฐานข้อมูลของคุณ

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

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

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

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

HubSpot สร้าง Schema หรือฐานข้อมูลที่จัดการโดย HubSpot สำหรับแต่ละปลายทาง

PostgreSQL

ตาราง PostgreSQL ใช้รูปแบบต่อไปนี้:

.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"

MySQL

ตาราง MySQL ใช้รูปแบบต่อไปนี้:

hubspot_data_out_.

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

hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES
hubspot_data_out_456.EVENTS_VISITED_PAGE
hubspot_data_out_456.ASSOCIATIONS_CONTACTS_TO_COMPANIES

คุณสามารถค้นหาสคีมาหรือชื่อฐานข้อมูลที่แน่นอนได้ในหน้าการกำหนดค่าการซิงค์

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

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

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

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

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

คอPROPERTIESในตาราง OBJECT_WITH_OBJECT_PROPERTIES จะถูกจัดเก็บเป็นสตริงที่จัดรูปแบบ JSON ซึ่งจัดเก็บเป็นTEXTใน PostgreSQL LONGTEXT LONGTEXT ใน MySQL ไม่ใช่ประเภทคอลัมน์ JSON แบบเนทีฟ

ตารางวัตถุ

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

OBJECT_PROPERTIES

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

OBJECT_WITH_OBJECT_PROPERTIES

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

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

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

OBJECT_PROPERTIES_HISTORY

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

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

ตารางสมาคม

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

ASSOCIATIONS

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

ASSOCIATION_DEFINITIONS

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

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

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

ASSOCIATIONS__TO_

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

ASSOCIATIONS_CONTACTS_TO_COMPANIES

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

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

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

EVENTS_

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

EVENTS_VISITED_PAGE

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

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

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

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

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

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

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

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

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

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

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

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

PostgreSQL

-- อ่านบันทึกการติดต่อทั้งหมด
เลือก *
จาก your_database.hubspot_data_out_456"OBJECT_WITH_OBJECT_PROPERTIES"
โดยที่ "OBJECTTYPEID" = '0 -1 ';

-- อ่านคุณสมบัติจากคอ
ลัมน์คุณสมบัติเลือก
  "ObjectID ",
  json_extract_path_text (" คุณสมบัติ ":: json,' email ') เป็นอีเมลจาก
your_database.hubspot_data_out_456"OBJECT_WITH_OBJECT_PROPERTIES"
ที่ "OBJECTTYPEID" = '0 -1 ';

MySQL

-- อ่านบันทึกการติดต่อทั้งหมด
เลือก *
จาก `hubspot_data_out_456``OBJECT_WITH_OBJECT_PROPERTIES`
WHERE 'OBJECTTYPEID' = '0 -1 ';

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

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

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

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

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

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

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

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

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

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

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

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

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

จะเกิดอะไรขึ้นถ้าฉันเปลี่ยนผู้ใช้ฐานข้อมูล

หากคุณเชื่อมต่ออีกครั้งโดยใช้ผู้ใช้ฐานข้อมูลอื่นคุณต้องให้สิทธิ์ผู้ใช้ใหม่ในการเข้าถึงสคีมาฐานข้อมูลหรือตารางที่จัดการโดย HubSpot ที่มีอยู่