การกำหนดค่า ข้อกำหนด และแนวทางปฏิบัติที่ดีที่สุดของตัวให้บริการข้อมูล OData v4

หัวข้อนี้จะอธิบายวิธีการกำหนดค่าตัวให้บริการข้อมูล OData v4 รวมถึงข้อกำหนดต่างๆ และแนวทางปฏิบัติที่ดีที่สุดที่แนะนำสำหรับการใช้งานตัวให้บริการข้อมูล OData v4 เพื่อเชื่อมต่อกับบริการเว็บ OData v4

แนวทางปฏิบัติที่ดีที่สุดของตัวให้บริการข้อมูล OData v4

• Microsoft Dataverse ต้องการให้ตารางทั้งหมดมีแอตทริบิวต์รหัส โดยรหัสนี้เรียกว่ารหัสเฉพาะ และค่าต้องเป็น GUID คุณสามารถคอลัมน์รหัสแผนที่ไปยังคอลัมน์ภายนอกด้วยชนิดข้อมูล Edm.Guid เท่านั้น คุณไม่สามารถแม็ปชนิดข้อมูล Edm.Int32 ไปยังคอลัมน์ชนิดข้อมูลรหัสเฉพาะใน Dataverse ได้
• ตาราง OData ที่มีคุณสมบัติเป็นนัลได้ ต้องตั้งค่าให้ตรงกับคอลัมน์ที่ถูกแมปในตารางเสมือน ตัวอย่างเช่น คุณสมบัติตาราง OData ที่มี Nullable=False ต้องมีคอลัมน์ที่แม็ปได้ในแอตทริบิวต์ ข้อกำหนดฟิลด์ ของ Dataverse ซึ่งถูกตั้งค่าเป็น ธุรกิจที่ต้องการ
• สำหรับการเรียกใช้แบบสอบถามหลายรายการ เช่น เมื่อคุณโหลดข้อมูลเป็นเส้นตาราง ควบคุมขนาดของชุดข้อมูลที่ส่งกลับจากแหล่งข้อมูลจากภายนอกโดยใช้พารามิเตอร์การสอบถามตัวกรองและการเลือก
• ถ้ายังไม่ได้เปิดใช้งาน ผู้ดูแลระบบควรเปิดใช้งานการสืบค้นกลับปลั๊กอิน เมื่อเปิดการใช้งานแล้ว ข้อผิดพลาดทั้งหมดจากจุดสิ้นสุด OData จะถูกจับภาพในล็อกการติดตามที่ปลั๊กอิน ข้อมูลเพิ่มเติม: คู่มือผู้ดูแลระบบ: กล่องโต้ตอบการตั้งค่าระบบ - แท็บการกำหนดเอง
• คุณไม่สามารถใช้ตัวให้บริการข้อมูล OData v4 เพื่อเชื่อมต่อกับสภาพแวดล้อมอื่นได้

การแมปชนิดข้อมูล

ตารางต่อไปนี้แสดงรายการการแมปชนิดข้อมูลแบบจำลองข้อมูลในตาราง OData (EDM) ที่มีชนิดข้อมูล Dataverse

ชนิดข้อมูล OData	Dataverse ชนิดข้อมูล
Edm.Boolean	สองตัวเลือก
Edm.DateTime	วันที่และเวลา
Edm.DateTimeOffset	วันที่และเวลา
Edm.Decimal	จำนวนทศนิยมหรือสกุลเงิน
Edm.Double	เลขจุดทศนิยมลอยตัว
Edm.Guid	รหัสเฉพาะ
Edm.Int32	จำนวนเต็ม
Edm.Int64	จำนวนเต็ม
Edm.String	ข้อความบรรทัดเดียวหรือข้อความหลายบรรทัด

ชนิดข้อมูล OData EDM ที่ไม่รองรับสำหรับการแมปด้วยตารางเสมือน

• Edm.Binary
• Edm.Time
• Edm.Float
• Edm.Single
• Edm.Int16
• Edm.Byte
• Edm.SByte

เพิ่มแหล่งข้อมูลโดยใช้ตัวให้บริการข้อมูล OData v4

กระบวนงานนี้แสดงวิธีการใช้ตัวให้บริการข้อมูล OData สำเร็จรูปเพื่อใช้เป็นแหล่งข้อมูลตารางแบบเสมือน

1. ไปที่ การตั้งค่า > การจัดการ > แหล่งข้อมูลของเอนทิตีเสมือน

2. บนแถบเครื่องมือการดำเนินการ คลิก สร้าง

3. บนกล่องโต้ตอบ เลือกตัวให้บริการข้อมูล เลือกจากแหล่งข้อมูลต่อไปนี้ และจากนั้น คลิก ตกลง

   • ผู้ให้บริการข้อมูล OData v4 Dataverse รวมตัวให้บริการข้อมูล Odata ที่สามารถใช้เพื่อเชื่อมต่อกับแหล่งข้อมูลที่สนับสนุนมาตรฐาน OData v4 แบบเปิด
   • ผู้ให้บริการข้อมูลแบบกำหนดเอง ถ้าคุณนำเข้าข้อมูลปลั๊กอินตัวให้บริการข้อมูล ตัวให้บริการข้อมูลจะปรากฏขึ้นที่นี่ ข้อมูลเพิ่มเติม: คู่มือของนักพัฒนา: เริ่มต้นใช้งานตารางเสมือน

4. บนหน้าคุณสมบัติ แหล่งข้อมูลใหม่ ให้กรอกข้อมูลคอลัมน์ต่อไปนี้ และจากนั้น บันทึกแถว

   • ชื่อ พิมพ์ชื่อที่อธิบายถึงแหล่งข้อมูล
   • Uri ถ้าคุณกำลังใช้ตัวให้บริการข้อมูล OData ให้ป้อน uri สำหรับบริการเว็บ OData ตัวอย่างเช่น ถ้าคุณใช้ตัวให้บริการ OData เพื่อเชื่อมต่อไปยัง Web Service ที่เป็นโฮสต์ใน Azure URI อาจมีลักษณะคล้ายกับ https://contosodataservice.azurewebsites.net/odata/
   • การหมดเวลาเป็นวินาที ป้อนจำนวนของวินาทีที่จะรอการตอบกลับจากบริการเว็บก่อนที่จะหมดเวลาการร้องขอข้อมูล ตัวอย่างเช่น ป้อน 30 เพื่อ รอสูงสุดสามสิบวินาทีก่อนที่จะหมดเวลา
   • โหมดการจัดแบ่งหน้า เลือกว่าจะใช้การแบ่งหน้า ฝั่งไคลเอ็นต์ หรือ ฝั่งเซิร์ฟเวอร์เพื่อควบคุมวิธีการแบ่งหน้าผลลัพธ์แบบสอบถาม ค่าเริ่มต้นคือ การแบ่งหน้าฝั่งไคลเอ็นต์ ด้วยการแบ่งหน้าฝั่งเซิร์ฟเวอร์ เซิร์ฟเวอร์จะสามารถควบคุมวิธีการแบ่งหน้าผลลัพธ์โดยใช้พารามิเตอร์ $skiptoken ที่ถูกเพิ่มเข้าไปในสตริงการสอบถาม ข้อมูลเพิ่มเติม: ตัวเลือกการข้ามการสอบถามระบบโทเค็น ($skiptoken)
     • แสดงจำนวนแบบอินไลน์ แสดงแถวจำนวนทั้งหมดในชุดผลลัพธ์ การตั้งค่านี้จะใช้เพื่อเปิดใช้งานฟังก์ชันหน้าถัดไปเมื่อคุณแสดงข้อมูลเป็นเส้นตาราง ใช้ค่า เท็จ หากจุดสิ้นสุด OData ของคุณไม่รองรับพารามิเตอร์ OData $inclinecount ค่าเริ่มต้นคือ เท็จ
   • พารามิเตอร์การร้องขอ อีกทางหนึ่งคือ คุณสามารถเพิ่มหัวกระดาษแบบกำหนดเองหรือพารามิเตอร์สตริงแบบสอบถามที่ใช้ในการเชื่อมต่อกับบริการเว็บ OData เช่น พารามิเตอร์การรับรองความถูกต้องไปยังบริการภายนอก คลิก สตริงแบบสอบถาม เพื่อสลับระหว่างพารามิเตอร์สตริงแบบสอบถามและส่วนหัวและค่า คุณสามารถเพิ่มสตริงแบบสอบถามหรือส่วนหัวได้สูงสุด 10 รายการ

     

ดูเพิ่มเติม

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

หมายเหตุ

บอกให้เราทราบเกี่ยวกับภาษาที่คุณต้องการในคู่มือ ทำแบบสำรวจสั้นๆ (โปรดทราบว่าแบบสำรวจนี้เป็นภาษาอังกฤษ)

แบบสำรวจนี้ใช้เวลาทำประมาณเจ็ดนาที ไม่มีการเก็บข้อมูลส่วนบุคคล (คำชี้แจงสิทธิ์ส่วนบุคคล)