หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
บทความนี้สรุปวิธีการใช้กิจกรรมการคัดลอกในไปป์ไลน์เพื่อคัดลอกข้อมูลจากและไปยัง Dataverse
ข้อกําหนดเบื้องต้น
เมื่อต้องการใช้ตัวเชื่อมต่อนี้กับการรับรองความถูกต้องของบริการหลักของ Microsoft Entra คุณต้องตั้งค่าการรับรองความถูกต้องแบบเซิร์ฟเวอร์ต่อเซิร์ฟเวอร์ (S2S) ใน Dataverse ขั้นแรกให้ลงทะเบียนผู้ใช้แอปพลิเคชัน (Service Principal) ใน Microsoft Entra สําหรับข้อมูลเพิ่มเติม โปรดดู สร้างโปรแกรมประยุกต์ Microsoft Entra และบริการหลักที่สามารถเข้าถึงทรัพยากรได้
ในระหว่างการลงทะเบียนแอปพลิเคชัน คุณจะต้องสร้างผู้ใช้รายนั้นใน Dataverse และให้สิทธิ์ สิทธิ์เหล่านั้นสามารถให้ได้โดยตรงหรือโดยอ้อมโดยการเพิ่มผู้ใช้แอปพลิเคชันไปยังทีมที่ได้รับสิทธิ์ใน Dataverse สําหรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีการตั้งค่าผู้ใช้แอปพลิเคชันเพื่อรับรองความถูกต้องด้วย Dataverse โปรดดู ใช้การรับรองความถูกต้องแบบเซิร์ฟเวอร์ต่อเซิร์ฟเวอร์ของผู้เช่ารายเดียว
การกําหนดค่าที่รองรับ
สําหรับการกําหนดค่าของแต่ละแท็บภายใต้กิจกรรมการคัดลอก ให้ไปที่ส่วนต่อไปนี้ตามลําดับ
General
สําหรับการกําหนดค่าแท็บทั่วไป ให้ไปที่การตั้งค่าทั่วไป
ที่มา
ไปที่แท็บ แหล่งที่มา เพื่อกําหนดค่าแหล่งที่มาของกิจกรรมการคัดลอกของคุณ ดูเนื้อหาต่อไปนี้สําหรับการกําหนดค่าโดยละเอียด
คุณสมบัติต่อไปนี้ เป็นสิ่งจําเป็น:
- การเชื่อมต่อ: เลือกการเชื่อมต่อ Dataverse ที่มีอยู่จากรายการการเชื่อมต่อ หากไม่มีการเชื่อมต่อ ให้สร้างการเชื่อมต่อ Dataverse ใหม่โดยเลือก ใหม่
- ชนิดการเชื่อมต่อ: เลือก Dataverse
-
ใช้คิวรี: ระบุวิธีการที่ใช้ในการอ่านข้อมูล คุณสามารถเลือก ชื่อเอนทิตี เพื่ออ่านข้อมูลโดยใช้ชื่อเอนทิตี หรือ คิวรี เพื่อใช้คิวรีเพื่ออ่านข้อมูล
ชื่อเอนทิตี: เลือกชื่อเอนทิตีของคุณจากรายการดรอปดาวน์ หรือเลือก แก้ไข เพื่อป้อนด้วยตนเอง เป็นชื่อตรรกะของเอนทิตีที่จะดึงข้อมูล
คิวรี: การใช้ FetchXML เพื่ออ่านข้อมูลจาก Dataverse FetchXML เป็นภาษาคิวรีที่เป็นกรรมสิทธิ์ที่ใช้ใน Dynamics ออนไลน์และภายในองค์กร ดูตัวอย่างต่อไปนี้ หากต้องการเรียนรู้เพิ่มเติม โปรดดู สร้างคิวรีด้วย FetchXML
ตัวอย่างคิวรี FetchXML:
<fetch> <entity name="account"> <attribute name="accountid" /> <attribute name="name" /> <attribute name="marketingonly" /> <attribute name="modifiedon" /> <order attribute="modifiedon" descending="false" /> <filter type="and"> <condition attribute ="modifiedon" operator="between"> <value>2017-03-10 18:40:00z</value> <value>2017-03-12 20:40:00z</value> </condition> </filter> </entity> </fetch>
ภายใต้ ขั้นสูง คุณสามารถระบุฟิลด์ต่อไปนี้:
- คอลัมน์เพิ่มเติม: เพิ่มคอลัมน์ข้อมูลเพิ่มเติมเพื่อจัดเก็บเส้นทางสัมพัทธ์หรือค่าคงที่ของไฟล์ต้นฉบับ นิพจน์ได้รับการสนับสนุนสําหรับรุ่นหลัง สําหรับข้อมูลเพิ่มเติม ไปที่ เพิ่มคอลัมน์เพิ่มเติมระหว่างการคัดลอก
จุดหมาย
ไปที่แท็บ ปลายทาง เพื่อกําหนดค่าปลายทางกิจกรรมการคัดลอกของคุณ ดูเนื้อหาต่อไปนี้สําหรับการกําหนดค่าโดยละเอียด
คุณสมบัติต่อไปนี้ เป็นสิ่งจําเป็น:
- การเชื่อมต่อ: เลือกการเชื่อมต่อ Dataverse ที่มีอยู่จากรายการการเชื่อมต่อ หากไม่มีการเชื่อมต่อ ให้สร้างการเชื่อมต่อ Dataverse ใหม่โดยเลือก ใหม่
- ชนิดการเชื่อมต่อ: เลือก Dataverse
- ชื่อเอนทิตี: ระบุชื่อของเอนทิตีที่จะเขียนข้อมูล เลือกชื่อเอนทิตีของคุณจากรายการดรอปดาวน์ หรือเลือก แก้ไข เพื่อป้อนด้วยตนเอง นี่คือชื่อตรรกะของเอนทิตีที่จะดึงข้อมูล
ภายใต้ ขั้นสูง คุณสามารถระบุฟิลด์ต่อไปนี้:
- ลักษณะการเขียน: ลักษณะการเขียนของการดําเนินการ คุณสมบัตินี้จําเป็น และคุณต้องเลือก Upsert ถ้าคุณใช้ เพิ่มเนื้อหาแบบไดนามิก ให้ระบุค่าเป็น Upsert
- ชื่อคีย์สํารอง: ระบุชื่อคีย์สํารองที่กําหนดไว้ในเอนทิตีของคุณเพื่ออัปเซิร์ตเรกคอร์ด
-
ละเว้นค่า null: ระบุว่าจะละเว้นค่า null จากข้อมูลอินพุตระหว่างการดําเนินการเขียนหรือไม่ มันถูกเลือกโดยค่าเริ่มต้น
- เมื่อเลือก: ปล่อยให้ข้อมูลในวัตถุปลายทางไม่เปลี่ยนแปลงเมื่อดําเนินการอัพโหลด/อัปเดต และแทรกค่าเริ่มต้นที่กําหนดไว้เมื่อทําการแทรก
- เมื่อไม่ได้เลือก: อัปเดตข้อมูลในวัตถุปลายทางเป็น NULL เมื่อดําเนินการ upsert / update และแทรกค่า NULL เมื่อทําการแทรก
- เขียนขนาดชุดงาน: ระบุจํานวนแถวของข้อมูลที่เขียนไปยัง Dataverse ในแต่ละชุดงาน
- การเชื่อมต่อพร้อมกันสูงสุด: ขีดจํากัดสูงสุดของการเชื่อมต่อพร้อมกันที่สร้างไปยังที่เก็บข้อมูลในระหว่างการเรียกใช้กิจกรรม ระบุค่าเมื่อคุณต้องการจํากัดการเชื่อมต่อที่เกิดขึ้นพร้อมกันเท่านั้น
การแม็ป
สําหรับการกําหนดค่าแท็บ การแม็ป ไปที่ กําหนดค่าการ แม็ปของคุณภายใต้แท็บการแม็ป หากคุณเลือกไบนารีเป็นรูปแบบไฟล์ของคุณจะไม่รองรับการแมป
การตั้งค่า
สําหรับการกําหนดค่าแท็บการตั้งค่า ให้ไปที่กําหนดการตั้งค่าอื่นๆ ของคุณภายใต้แท็บการตั้งค่า
ข้อมูลสรุปของตาราง
ดูตารางต่อไปนี้สําหรับข้อมูลสรุปและข้อมูลเพิ่มเติมสําหรับกิจกรรมการคัดลอก Dataverse
แหล่งข้อมูล
| ชื่อ | คำอธิบาย | ค่า | ต้องระบุ | คุณสมบัติสคริปต์ JSON |
|---|---|---|---|---|
| การเชื่อมต่อ | การเชื่อมต่อของคุณกับ Dataverse ต้นทาง | < การเชื่อมต่อของคุณ > | ใช่ | การเชื่อมต่อ |
| ชนิดการเชื่อมต่อ | ชนิดการเชื่อมต่อของคุณ | Dataverse | ใช่ | ประเภท (ภายใต้ typeProperties ->source ->datasetSettings):CommonDataServiceForAppsEntity |
| ใช้คิวรี | วิธีการอ่านข้อมูลจาก Dataverse | *ตาราง *สอบถาม |
ใช่ | / |
| ชื่อเอนทิตี | ชื่อตรรกะของเอนทิตีที่จะดึงข้อมูล | < ชื่อนิติบุคคลของคุณ > | ใช่ | ชื่อเอนทิตี |
| คิวรี | ใช้ FetchXML เพื่ออ่านข้อมูลจาก Dataverse FetchXML เป็นภาษาคิวรีที่เป็นกรรมสิทธิ์ที่ใช้ใน Dynamics ออนไลน์และภายในองค์กร หากต้องการเรียนรู้เพิ่มเติม โปรดดู สร้างคิวรีด้วย FetchXML | < แบบสอบถามของคุณ > | ใช่ | การสอบถาม |
| คอลัมน์เพิ่มเติม | เพิ่มคอลัมน์ข้อมูลเพิ่มเติมเพื่อจัดเก็บเส้นทางสัมพัทธ์หรือค่าคงที่ของไฟล์ต้นฉบับ นิพจน์ได้รับการสนับสนุนสําหรับรุ่นหลัง สําหรับข้อมูลเพิ่มเติม ไปที่ เพิ่มคอลัมน์เพิ่มเติมระหว่างการคัดลอก | *ชื่อ *ค่า |
ไม่ใช่ | คอลัมน์เพิ่มเติม: *ชื่อ *ค่า |
ข้อมูลจุดหมายปลายทาง
| ชื่อ | คำอธิบาย | ค่า | ต้องระบุ | คุณสมบัติสคริปต์ JSON |
|---|---|---|---|---|
| การเชื่อมต่อ | การเชื่อมต่อของคุณกับ Dataverse ปลายทาง | < การเชื่อมต่อของคุณ > | ใช่ | การเชื่อมต่อ |
| ชนิดการเชื่อมต่อ | ชนิดการเชื่อมต่อของคุณ | Dataverse | ใช่ | ประเภท (ภายใต้ typeProperties ->sink ->datasetSettings):CommonDataServiceForAppsEntity |
| ชื่อเอนทิตี | ชื่อตรรกะของเอนทิตีที่จะดึงข้อมูล | < นิติบุคคลของคุณ > | ใช่ | ชื่อเอนทิตี |
| พฤติกรรมการเขียน | ลักษณะการทํางานการเขียนของการดําเนินการ ค่าต้องเป็น Upsert | Upsert | ใช่ | writeBehavior: upsert |
| ชื่อคีย์สํารอง | ชื่อคีย์สํารองที่กําหนดไว้ในเอนทิตีของคุณเพื่ออัปเซิร์ตเรกคอร์ด | < ชื่อคีย์สํารอง > | ไม่ใช่ | alternateKeyName |
| ละเว้นค่า null | ระบุว่าจะละเว้นค่า Null จากข้อมูลอินพุตระหว่างการดําเนินการเขียนหรือไม่ - เลือก (จริง): ปล่อยให้ข้อมูลในวัตถุปลายทางไม่เปลี่ยนแปลงเมื่อดําเนินการอัพโหลด / อัปเดตและแทรกค่าเริ่มต้นที่กําหนดไว้เมื่อทําการแทรก - ไม่ได้เลือก (เท็จ): อัปเดตข้อมูลในวัตถุปลายทางเป็น NULL เมื่อดําเนินการ upsert / update และแทรกค่า NULL เมื่อทําการแทรก |
เลือกหรือไม่ได้เลือก (ค่าเริ่มต้น) | ไม่ใช่ | ignoreNullValues: จริง หรือ เท็จ (ค่าเริ่มต้น) |
| เขียนขนาดแบทช์ | จํานวนแถวของข้อมูลที่เขียนไปยัง Dataverse ในแต่ละชุดงาน |
< ขนาดแบทช์การเขียนของคุณ > ค่าเริ่มต้นคือ 10 |
ไม่ใช่ | เขียนขนาดแบทช์ |
| การเชื่อมต่อพร้อมกันสูงสุด | ขีดจํากัดบนของการเชื่อมต่อพร้อมกันที่สร้างขึ้นไปยังที่เก็บข้อมูลระหว่างการเรียกใช้กิจกรรม ระบุค่าเมื่อคุณต้องการจํากัดการเชื่อมต่อที่เกิดขึ้นพร้อมกันเท่านั้น | < การเชื่อมต่อพร้อมกันสูงสุด > | ไม่ใช่ | max การเชื่อมต่อพร้อมกัน |