กําหนดค่า Dataverse ในกิจกรรมการคัดลอก
บทความนี้สรุปวิธีการใช้กิจกรรมการคัดลอกในไปป์ไลน์ข้อมูลเพื่อคัดลอกข้อมูลจากและไปยัง Dataverse
ข้อกำหนดเบื้องต้น
ในการใช้ตัวเชื่อมต่อนี้กับการรับรองความถูกต้องของบริการหลัก Microsoft Entra คุณต้องตั้งค่าการรับรองความถูกต้อง server-to-server (S2S) ใน Dataverse ก่อนอื่นให้ลงทะเบียนผู้ใช้แอปพลิเคชัน (บริการหลัก) ใน Microsoft Entra สําหรับข้อมูลเพิ่มเติม ดูสร้างแอปพลิเคชัน Microsoft Entra และบริการหลักที่สามารถเข้าถึงทรัพยากร
ในระหว่างการลงทะเบียนแอปพลิเคชัน คุณจะต้องสร้างผู้ใช้รายนั้นใน Dataverse และให้สิทธิ์ สิทธิ์เหล่านั้นสามารถมอบให้โดยตรงหรือโดยอ้อมได้โดยการเพิ่มผู้ใช้แอปพลิเคชันให้กับทีมที่ได้รับสิทธิ์ในการผกผันข้อมูล สําหรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีการตั้งค่าผู้ใช้แอปพลิเคชันเพื่อรับรองความถูกต้องด้วย Dataverse ดู ใช้การรับรองความถูกต้องเซิร์ฟเวอร์แบบผู้เช่ารายเดียวกับเซิร์ฟเวอร์
การกําหนดค่าที่ได้รับการสนับสนุน
สําหรับการกําหนดค่าของแต่ละแท็บภายใต้กิจกรรมการคัดลอก ให้ไปที่ส่วนต่อไปนี้ตามลําดับ
ทั่วไป
สําหรับ การกําหนดค่าแท็บทั่วไป ไปที่ การตั้งค่าทั่วไป
ทรัพยากร
ไปที่ แท็บแหล่งที่มา เพื่อกําหนดค่าแหล่งข้อมูลกิจกรรมการคัดลอกของคุณ ดูเนื้อหาต่อไปนี้สําหรับการกําหนดค่าโดยละเอียด
จําเป็นต้องมีคุณสมบัติต่อไปนี้:
- ชนิดของที่เก็บข้อมูล: เลือก ภายนอก
- เชื่อมต่อ: เลือกการเชื่อมต่อ Dataverse ที่มีอยู่จากรายการการเชื่อมต่อ ถ้าไม่มีการเชื่อมต่ออยู่ ให้สร้างการเชื่อมต่อ Dataverse ใหม่โดยการเลือก ใหม่
- ชนิดเชื่อมต่อ: เลือก Dataverse
- ใช้คิวรี: ระบุวิธีที่ใช้ในการอ่านข้อมูล คุณสามารถเลือก ชื่อ เอนทิตีเพื่ออ่านข้อมูลโดยใช้ชื่อเอนทิตีหรือ คิวรี เพื่อใช้คิวรีเพื่ออ่านข้อมูลได้
ชื่อเอนทิตี: เลือกชื่อเอนทิตีของคุณจากรายการดรอปดาวน์ หรือเลือก แก้ไข เพื่อป้อนด้วยตนเอง ซึ่งเป็นชื่อตรรกะของเอนทิตีที่จะเรียกใช้
คิวรี: ใช้ FetchXML เพื่ออ่านข้อมูลจาก Dataverse FetchXML เป็นภาษาคิวรีที่เป็นกรรมสิทธิ์ที่ใช้ใน Dynamics online และภายในองค์กร ดูตัวอย่างดังต่อไปนี้ เมื่อต้องการเรียนรู้เพิ่มเติม ดูสร้างคิวรีด้วย 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
- ชื่อคีย์สํารอง: ระบุชื่อคีย์สํารองที่กําหนดไว้บนเอนทิตีของคุณเพื่อบันทึก upsert
- ละเว้นค่า null: ระบุว่าจะละเว้นค่า null จากข้อมูลป้อนเข้าในระหว่างการเขียนหรือไม่ ซึ่งจะถูกเลือกตามค่าเริ่มต้น
- เมื่อเลือกแล้ว: ปล่อยให้ข้อมูลในวัตถุปลายทางไม่เปลี่ยนแปลงเมื่อดําเนินการ upsert/update และแทรกค่าเริ่มต้นที่กําหนดไว้เมื่อทําการแทรกการดําเนินการ
- เมื่อไม่ได้เลือก: อัปเดตข้อมูลในออบเจ็กต์ปลายทางเป็น NULL เมื่อดําเนินการ upsert/update และแทรกค่า NULL เมื่อทําการแทรกการดําเนินการ
- เขียนขนาดของชุดงาน: ระบุจํานวนแถวของข้อมูลที่เขียนไปยัง Dataverse ในแต่ละชุดงาน
- การเชื่อมต่อพร้อมกันสูงสุด: ขีดจํากัดสูงสุดของการเชื่อมต่อพร้อมกันที่สร้างไปยังที่เก็บข้อมูลในระหว่างการเรียกใช้กิจกรรม ระบุค่าเมื่อคุณต้องการจํากัดการเชื่อมต่อที่เกิดขึ้นพร้อมกันเท่านั้น
การแม็ป
สําหรับ การกําหนดค่าแท็บการแมป ไปที่ กําหนดค่าการแมปของคุณภายใต้แท็บการแมป ถ้าคุณเลือกไบนารีเป็นรูปแบบไฟล์ของคุณ การแมปจะไม่ได้รับการสนับสนุน
การตั้งค่า
สําหรับการกําหนดค่าแท็บการตั้งค่า ให้ไปที่ กําหนดการตั้งค่าอื่น ๆ ของคุณภายใต้แท็บ การตั้งค่า
ข้อมูลสรุปของตาราง
ดูตารางต่อไปนี้สําหรับข้อมูลสรุปและข้อมูลเพิ่มเติมสําหรับกิจกรรมการคัดลอกข้อมูลแบบผกผัน
ข้อมูลต้นทาง
| ชื่อ | รายละเอียด | ค่า | ต้องมี | คุณสมบัติสคริปต์ JSON |
|---|---|---|---|---|
| ชนิดของที่เก็บข้อมูล | ประเภทที่เก็บข้อมูลของคุณ | ภายนอก | ใช่ | / |
| เชื่อมต่อชั่น | การเชื่อมต่อของคุณไปยังแหล่งข้อมูล Dataverse | < การเชื่อมต่อของคุณ > | ใช่ | เชื่อม ต่อ |
| ชนิดเชื่อมต่อ | ชนิดการเชื่อมต่อของคุณ | Dataverse | ใช่ | type (ภายใต้ typeProperties ->source ->datasetSettings):CommonDataServiceForAppsEntity |
| ใช้คิวรี | วิธีการอ่านข้อมูลจาก Dataverse | *ตาราง *แบบ สอบ ถาม |
ใช่ | / |
| ชื่อเอนทิตี | ชื่อตรรกะของเอนทิตีที่จะเรียกใช้ | < ชื่อเอนทิตีของคุณ > | ใช่ | entityName |
| แบบ สอบ ถาม | ใช้ FetchXML เพื่ออ่านข้อมูลจาก Dataverse FetchXML เป็นภาษาคิวรีที่เป็นกรรมสิทธิ์ที่ใช้ใน Dynamics online และภายในองค์กร เมื่อต้องการเรียนรู้เพิ่มเติม ดูสร้างคิวรีด้วย FetchXML | < คิวรีของคุณ > | ใช่ | การสอบถาม |
| คอลัมน์เพิ่มเติม | เพิ่มคอลัมน์ข้อมูลเพิ่มเติมเพื่อจัดเก็บเส้นทางสัมพัทธ์หรือค่าคงที่ของไฟล์ต้นฉบับ นิพจน์ได้รับการสนับสนุนสําหรับอย่างหลัง สําหรับข้อมูลเพิ่มเติม ให้ไปที่ เพิ่มคอลัมน์เพิ่มเติมในระหว่างการคัดลอก | *ชื่อ *ค่า |
ไม่ | additionalColumns: *ชื่อ *ค่า |
ข้อมูลปลายทาง
| ชื่อ | รายละเอียด | ค่า | ต้องมี | คุณสมบัติสคริปต์ JSON |
|---|---|---|---|---|
| ชนิดของที่เก็บข้อมูล | ประเภทที่เก็บข้อมูลของคุณ | ภายนอก | ใช่ | / |
| เชื่อมต่อชั่น | การเชื่อมต่อของคุณไปยังส่วนข้อมูลปลายทาง | < การเชื่อมต่อของคุณ > | ใช่ | เชื่อม ต่อ |
| ชนิดเชื่อมต่อ | ชนิดการเชื่อมต่อของคุณ | Dataverse | ใช่ | type (ภายใต้ typeProperties ->sink ->datasetSettings):CommonDataServiceForAppsEntity |
| ชื่อเอนทิตี | ชื่อตรรกะของเอนทิตีที่จะเรียกใช้ | < เอนทิตีของคุณ > | ใช่ | entityName |
| ลักษณะการทํางานของการเขียน | ลักษณะการทํางานการเขียนของการดําเนินการ ค่าต้องเป็น Upsert | Upsert | ใช่ | writeBehavior: upsert |
| ชื่อคีย์สํารอง | ชื่อคีย์สํารองที่กําหนดไว้บนเอนทิตีของคุณเพื่อบันทึก upsert | < ชื่อคีย์สํารอง > | ไม่ | alternateKeyName |
| ละเว้นค่า null | ระบุว่าจะละเว้นค่า null จากข้อมูลป้อนเข้าในระหว่างการดําเนินการเขียนหรือไม่ - เลือก (จริง): ปล่อยข้อมูลในวัตถุปลายทางไม่เปลี่ยนแปลงเมื่อดําเนินการ upsert/update และแทรกค่าเริ่มต้นที่กําหนดไว้เมื่อทําการแทรกการดําเนินการ - ยกเลิกการเลือก (เท็จ): อัปเดตข้อมูลในวัตถุปลายทางเป็น NULL เมื่อดําเนินการ upsert/update และแทรกค่า NULL เมื่อทําการแทรกการดําเนินการ |
เลือกหรือไม่เลือก (ค่าเริ่มต้น) | ไม่ | ignoreNullValues: จริง หรือ เท็จ (ค่าเริ่มต้น) |
| เขียนขนาดของชุดงาน | จํานวนแถวของข้อมูลที่เขียนลงใน Dataverse ในแต่ละชุดงาน | < เขียนขนาดของชุดงานของคุณ > ค่าเริ่มต้นคือ 10 |
ไม่ | writeBatchSize |
| การเชื่อมต่อพร้อมกันสูงสุด | ขีดจํากัดสูงสุดของการเชื่อมต่อพร้อมกันที่สร้างขึ้นกับที่เก็บข้อมูลในระหว่างการเรียกใช้กิจกรรม ระบุค่าเมื่อคุณต้องการจํากัดการเชื่อมต่อที่เกิดขึ้นพร้อมกันเท่านั้น | < การเชื่อมต่อพร้อมกันสูงสุด > | ไม่ | maxConcurrent เชื่อมต่อ ions |