หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
คําอธิบายวัตถุสคีมาให้บริบททางธุรกิจแก่เอเจนต์ข้อมูลเกี่ยวกับตาราง คอลัมน์ และองค์ประกอบอื่น ๆ ในสคีมาแหล่งข้อมูล บริบทนี้ช่วยให้เอเจนต์แยกแยะระหว่างวัตถุที่มีชื่อคล้ายกันหรือคลุมเครือ เข้าใจวัตถุประสงค์ของแต่ละวัตถุ และสร้างคําสั่งค้นหาที่แม่นยํามากขึ้น คําอธิบายมีประโยชน์โดยเฉพาะสําหรับสคีมาขนาดใหญ่ที่ชื่อวัตถุเพียงอย่างเดียวไม่สามารถสื่อสารความหมายได้อย่างชัดเจน
คําอธิบายวัตถุสคีมารองรับแหล่งข้อมูล SQL รวมถึงบ้านพักน้ํา คลังสินค้า ฐานข้อมูล Fabric SQL และฐานข้อมูลมิเรอร์
หมายเหตุ
คําอธิบายวัตถุสคีมากําลังอยู่ในโหมดแสดงตัวอย่างสาธารณะ
หมายเหตุ
คําอธิบายวัตถุสคีมาจะพร้อมใช้งานเฉพาะเมื่อเอเจนต์ข้อมูลของคุณใช้ โหมดรันไทม์แบบพรีวิวเท่านั้น
เพิ่มหรือแก้ไขคําอธิบาย
โดยค่าเริ่มต้น ตัวแทนข้อมูลจะสืบทอดคําอธิบายที่มีอยู่จากแหล่งข้อมูลและอัปเดตโดยอัตโนมัติ เมื่อคุณแก้ไขคําอธิบายที่สืบทอดมาใน data agent การเปลี่ยนแปลงจะมีผลเฉพาะกับ data agent เท่านั้น มันจะไม่เขียนทับคําอธิบายในซอร์สโค้ด และวัตถุนั้นจะไม่ได้รับการอัปเดตคําอธิบายจากซอร์สอีกต่อไป
- เปิด data agent ของคุณ แล้วเลือก Setup
- ภายใต้แหล่งข้อมูล ให้เลือก คําอธิบายวัตถุ Schema
- ขยายสคีมาเพื่อค้นหาวัตถุที่คุณต้องการอธิบาย
- เลือกไอคอน แก้ไข ถัดจากวัตถุ
- กรอกคําอธิบาย แล้วเลือก เสร็จสิ้น
เพิ่มคําอธิบายด้วย Python SDK
ใช้ Fabric data agent Python SDK เพื่อจัดการคําอธิบายอ็อบเจ็กต์สคีมาแบบโปรแกรม ตัวอย่างต่อไปนี้ตั้งค่าคําอธิบายสําหรับตารางหนึ่งตารางในแหล่งข้อมูลแรกของเอเจนต์ข้อมูลที่มีอยู่:
from fabric.dataagent.client import FabricDataAgentManagement
agent = FabricDataAgentManagement("<data-agent-name>")
datasource = agent.get_datasources()[0]
table_path = ("Schemas", "dbo", "Tables", "adoptions")
datasource.update_description({
table_path: "Contains one row for each pet adoption transaction."
})
ทูเพิลจะระบุองค์ประกอบสคีมาโดยเส้นทางของมันในแหล่งข้อมูล หากต้องการอธิบายคอลัมน์ ให้เพิ่มชื่อคอลัมน์ลงในเส้นทางของตาราง ตัวอย่างเช่น ใช้table_path + ("adoption_date",) ชื่อเส้นทางต้องแยกแยะตัวพิมพ์ใหญ่-เล็กและต้องตรงกับลําดับชั้นที่แสดงสําหรับแหล่งข้อมูล
เขียนคําอธิบายที่มีประสิทธิภาพ
ใช้คําอธิบายเพื่ออธิบายความหมายทางธุรกิจที่ไม่ชัดเจนจากชื่อของวัตถุ ทําให้แต่ละคําอธิบายกระชับและเฉพาะเจาะจง
- สําหรับตาราง ให้อธิบายหน่วยงานธุรกิจหรือเหตุการณ์ที่นําเสนอ ระดับรายละเอียดของตาราง และวัตถุประสงค์หลักของตาราง
- สําหรับคอลัมน์ ให้กําหนดความหมายทางธุรกิจ รูปแบบ หน่วย หรือค่าคาดหวังของค่านั้นเมื่ออาจไม่ชัดเจน
- สําหรับองค์ประกอบสคีมาอื่น ๆ ให้อธิบายบทบาทและเวลาที่ตัวแทนข้อมูลควรใช้มัน
- ชี้แจงตัวย่อ คําศัพท์ภายใน และวัตถุที่มีชื่อคล้ายกัน
- รวมบริบทที่ช่วยให้เอเจนต์เลือกวัตถุและความสัมพันธ์ที่ถูกต้องเมื่อสร้างคําสั่งค้นหา