แชร์ผ่าน


กําหนดค่า Dataverse ในกิจกรรมการคัดลอก

บทความนี้สรุปวิธีการใช้กิจกรรมการคัดลอกในไปป์ไลน์เพื่อคัดลอกข้อมูลจากและไปยัง 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 การเชื่อมต่อพร้อมกัน