กําหนดค่า Azure Cosmos DB for MongoDB ในกิจกรรมการคัดลอก

บทความนี้สรุปวิธีการใช้กิจกรรมการคัดลอกในไปป์ไลน์เพื่อคัดลอกข้อมูลจากและไปยัง Azure Cosmos DB สําหรับ MongoDB

การกําหนดค่าที่รองรับ

สําหรับการกําหนดค่าของแต่ละแท็บภายใต้กิจกรรมการคัดลอก ให้ไปที่ส่วนต่อไปนี้ตามลําดับ

• ทั่วไป
• แหล่งข้อมูลของ
• จุดหมาย
• การทําแผนที่
• การตั้งค่า

ทั่วไป

โปรดดูคําแนะนําการตั้งค่าทั่วไปเพื่อกําหนดค่าแท็บ การตั้งค่าทั่วไป

Source

ไปที่แท็บ แหล่งที่มา เพื่อกําหนดค่าแหล่งที่มาของกิจกรรมการคัดลอกของคุณ ดูเนื้อหาต่อไปนี้สําหรับการกําหนดค่าโดยละเอียด

คุณสมบัติต่อไปนี้ เป็นสิ่งจําเป็น:

• การเชื่อมต่อ: เลือกการเชื่อมต่อ Azure Cosmos DB for MongoDB จากรายการการเชื่อมต่อ หากไม่มีการเชื่อมต่อ ให้สร้างการเชื่อมต่อ Azure Cosmos DB for MongoDB ใหม่โดยเลือก เพิ่มเติม ที่ด้านล่างของรายการการเชื่อมต่อ
• ฐานข้อมูล: เลือกฐานข้อมูลของคุณจากรายการแบบเลื่อนลง
• ชื่อคอลเลกชัน: ระบุชื่อของคอลเลกชัน Azure Cosmos DB คุณสามารถเลือกคอลเลกชันจากรายการแบบหล่นลง
• เวอร์ชัน: เวอร์ชันที่คุณระบุ แนะนําให้อัปเกรดเป็นเวอร์ชันล่าสุดเพื่อใช้ประโยชน์จากการเพิ่มประสิทธิภาพใหม่ล่าสุด หากต้องการเรียนรู้ความแตกต่างระหว่างเวอร์ชันต่างๆ ให้ไปที่ ส่วนนี้

ภายใต้ ขั้นสูง คุณสามารถระบุฟิลด์ต่อไปนี้:

• ตัวกรอง: ระบุตัวกรองการเลือกโดยใช้ตัวดําเนินการแบบสอบถาม เมื่อต้องการส่งคืนเอกสารทั้งหมดในคอลเลกชัน ให้ละเว้นพารามิเตอร์นี้หรือส่งผ่านเอกสารเปล่า (){}
• วิธีการเคอร์เซอร์: เลือก + สร้าง เพื่อระบุวิธีการดําเนินการแบบสอบถามพื้นฐาน วิธีดําเนินการแบบสอบถามคือ:
  • project: ระบุเขตข้อมูลที่จะส่งคืนในเอกสารสําหรับการฉายภาพ เมื่อต้องการส่งคืนฟิลด์ทั้งหมดในเอกสารที่ตรงกัน ให้ละเว้นพารามิเตอร์นี้
  • sort: ระบุลําดับที่แบบสอบถามส่งกลับเอกสารที่ตรงกัน ไปที่ cursor.sort() สําหรับข้อมูลเพิ่มเติม
  • limit: ระบุจํานวนเอกสารสูงสุดที่เซิร์ฟเวอร์ส่งคืน ไปที่ cursor.limit() เพื่อดูข้อมูลเพิ่มเติม
  • ข้าม: ระบุจํานวนเอกสารที่จะข้ามและจากตําแหน่งที่ MongoDB เริ่มส่งคืนผลลัพธ์ ไปที่ cursor.skip() เพื่อดูข้อมูลเพิ่มเติม
• ขนาดแบทช์: ระบุจํานวนเอกสารที่จะส่งคืนในแต่ละชุดของการตอบสนองจากอินสแตนซ์ MongoDB ในกรณีส่วนใหญ่ การปรับเปลี่ยนขนาดแบทช์จะไม่ส่งผลกระทบต่อผู้ใช้หรือแอปพลิเคชัน Azure Cosmos DB จํากัดแต่ละชุดต้องมีขนาดไม่เกิน 40MB ซึ่งเป็นผลรวมของจํานวน ขนาดชุดงาน ของขนาดเอกสาร ดังนั้นให้ลดค่านี้หากขนาดเอกสารของคุณมีขนาดใหญ่ ค่าเริ่มต้นคือ 100
• คอลัมน์เพิ่มเติม: เพิ่มคอลัมน์ข้อมูลเพิ่มเติมเพื่อจัดเก็บเส้นทางสัมพัทธ์หรือค่าคงที่ของไฟล์ต้นฉบับ นิพจน์ได้รับการสนับสนุนสําหรับรุ่นหลัง

ปลายทาง

ไปที่แท็บ ปลายทาง เพื่อกําหนดค่าปลายทางกิจกรรมการคัดลอกของคุณ ดูเนื้อหาต่อไปนี้สําหรับการกําหนดค่าโดยละเอียด

คุณสมบัติต่อไปนี้ เป็นสิ่งจําเป็น:

• การเชื่อมต่อ: เลือกการเชื่อมต่อ Azure Cosmos DB for MongoDB จากรายการการเชื่อมต่อ หากไม่มีการเชื่อมต่อ ให้สร้างการเชื่อมต่อ Azure Cosmos DB for MongoDB ใหม่โดยเลือก เพิ่มเติม ที่ด้านล่างของรายการการเชื่อมต่อ
• ฐานข้อมูล: เลือกฐานข้อมูลของคุณจากรายการแบบเลื่อนลง
• ชื่อคอลเลกชัน: ระบุชื่อของคอลเลกชัน Azure Cosmos DB คุณสามารถเลือกคอลเลกชันจากรายการแบบหล่นลง

ภายใต้ ขั้นสูง คุณสามารถระบุฟิลด์ต่อไปนี้:

• ลักษณะการเขียน: อธิบายวิธีการเขียนข้อมูลไปยัง Azure Cosmos DB for MongoDB ค่าที่อนุญาต: แทรกและเพิ่ม

  ลักษณะการทํางานของ Upsert คือการแทนที่เอกสารหากมี _id เอกสารเดียวกันอยู่แล้ว มิฉะนั้น ให้แทรกเอกสาร

  Note

  บริการจะสร้าง for _id a เอกสารโดยอัตโนมัติหากไม่ได้ระบุไว้ใน _id เอกสารต้นฉบับหรือโดยการแม็ปคอลัมน์ ซึ่งหมายความว่าคุณต้องแน่ใจว่าเพื่อให้ Upsert ทํางานได้ตามที่คาดไว้ เอกสารของคุณมี ID

• การหมดเวลาของชุดการเขียน: ระบุเวลารอให้การดําเนินการแทรกชุดงานเสร็จสิ้นก่อนที่จะหมดเวลา ค่าที่อนุญาตคือ timespan และค่าเริ่มต้นคือ 00:30:00 (30 นาที)

• ขนาดแบทช์เขียน: คุณสมบัตินี้ควบคุมขนาดของเอกสารที่จะเขียนในแต่ละแบทช์ คุณสามารถลองเพิ่มค่าเพื่อปรับปรุงประสิทธิภาพและลดค่าหากขนาดเอกสารของคุณมีขนาดใหญ่ ค่าเริ่มต้นคือ 10,000

การทําแผนที่

สําหรับการกําหนดค่าแท็บ การแม็ป โปรดดู กําหนดค่าการแมปของคุณภายใต้แท็บการแมป ไม่รองรับการแมปเมื่อทั้งต้นทางและปลายทางเป็นข้อมูลตามลําดับชั้น

การแมปชนิดข้อมูลสําหรับ Azure Cosmos DB for MongoDB

เมื่อคัดลอกข้อมูลจาก Azure Cosmos DB for MongoDB จะใช้การแม็ปต่อไปนี้จากชนิดข้อมูล Azure Cosmos DB for MongoDB ไปยังชนิดข้อมูลชั่วคราวที่ใช้โดยบริการภายใน

ชนิดข้อมูล Azure Cosmos DB for MongoDB	ชนิดข้อมูลบริการชั่วคราว (สําหรับรุ่น 1.1)	ชนิดข้อมูลบริการชั่วคราว (สําหรับรุ่น 1.0)
Date	วันที่เวลา	อินเตอร์เนชั่นแนล 64
ObjectId	เชือก	เชือก
ทศนิยม 128	เชือก	เชือก
ไทม์ประทับ	32 บิตที่สําคัญที่สุด -> DateTime 32 บิตที่มีนัยสําคัญน้อยที่สุด -> Int64	32 บิตที่สําคัญที่สุด -> Int64 32 บิตที่มีนัยสําคัญน้อยที่สุด -> Int64
เชือก	เชือก	เชือก
คู่	คู่	คู่
อินเตอร์เนชั่นแนล 32	อินเตอร์เนชั่นแนล 64	อินเตอร์เนชั่นแนล 64
อินเตอร์เนชั่นแนล 64	อินเตอร์เนชั่นแนล 64	อินเตอร์เนชั่นแนล 64
แบบบูลีน	แบบบูลีน	แบบบูลีน
โมฆะ	โมฆะ	โมฆะ
JavaScript	เชือก	เชือก
นิพจน์ทั่วไป	เชือก	เชือก
ปุ่มขั้นต่ํา	เชือก	อินเตอร์เนชั่นแนล 64
ปุ่มสูงสุด	เชือก	อินเตอร์เนชั่นแนล 64
Binary	GUID (เมื่อ SubType เป็น "04") เชือก	เชือก

การตั้งค่า

สําหรับการกําหนดค่าแท็บการตั้งค่า ให้ไปที่ กําหนดการตั้งค่าอื่นๆ ภายใต้แท็บการตั้งค่า

ความแตกต่างระหว่างเวอร์ชัน Azure Cosmos DB for MongoDB

ตารางด้านล่างแสดงความแตกต่างของคุณลักษณะระหว่างเวอร์ชันต่างๆ

เวอร์ชัน 1.1	เวอร์ชัน 1.0
การแม็ปต่อไปนี้ใช้จากชนิดข้อมูล Azure Cosmos DB for MongoDB ไปยังชนิดข้อมูลบริการชั่วคราว วันที่ -> วันที่และเวลา TimeStamp (32 บิตที่สําคัญที่สุด) -> DateTime ปุ่มขั้นต่ํา -> สตริง ปุ่มสูงสุด -> สตริง ไบนารี -> GUID (เมื่อ SubType เป็น "04") / สตริง	การแม็ปต่อไปนี้ใช้จากชนิดข้อมูล Azure Cosmos DB for MongoDB ไปยังชนิดข้อมูลบริการชั่วคราว วันที่ -> Int64 TimeStamp (32 บิตที่สําคัญที่สุด) -> Int64 ปุ่มขั้นต่ํา -> Int64 คีย์สูงสุด -> Int64 ไบนารี -> สตริง

ข้อมูลสรุปของตาราง

ตารางต่อไปนี้ประกอบด้วยข้อมูลเพิ่มเติมเกี่ยวกับกิจกรรมการคัดลอกใน Azure Cosmos DB for MongoDB

แหล่งข้อมูล

ชื่อ	คำอธิบาย	ค่า	ต้องมี	คุณสมบัติสคริปต์ JSON
การเชื่อมต่อ	การเชื่อมต่อของคุณกับที่เก็บข้อมูลต้นทาง	< การเชื่อมต่อ Azure Cosmos DB for MongoDB ของคุณ >	ใช่	การเชื่อมต่อ
ฐานข้อมูล	ฐานข้อมูลของคุณที่คุณใช้เป็นแหล่งข้อมูล	< ฐานข้อมูลของคุณ >	ใช่	ฐานข้อมูล
ชื่อคอลเลกชัน	ชื่อของคอลเลกชัน Azure Cosmos DB	< คอลเลกชันของคุณ >	ใช่	คอลเลกชัน
รุ่น	เวอร์ชันที่คุณระบุ	• 1.1 • 1.0	ใช่	เวอร์ชัน: • 1.1 • 1.0
ตัวกรอง	ตัวกรองการเลือกโดยใช้ตัวดําเนินการแบบสอบถาม เมื่อต้องการส่งคืนเอกสารทั้งหมดในคอลเลกชัน ให้ละเว้นพารามิเตอร์นี้หรือส่งผ่านเอกสารเปล่า (){}	< ตัวกรองการเลือกของคุณ >	ไม่	ตัวกรอง
วิธีการเคอร์เซอร์	วิธีการดําเนินการแบบสอบถามต้นแบบ	• โครงการ • เรียงลําดับ • จํากัด • ข้าม	ไม่	cursorMethods: •โครงการ •ประเภท •เขต •ข้าม
ขนาดแบทช์	จํานวนเอกสารที่จะส่งคืนในแต่ละชุดของการตอบกลับจากอินสแตนซ์ MongoDB ในกรณีส่วนใหญ่ การปรับเปลี่ยนขนาดแบทช์จะไม่ส่งผลกระทบต่อผู้ใช้หรือแอปพลิเคชัน Azure Cosmos DB จํากัดแต่ละชุดต้องมีขนาดไม่เกิน 40MB ซึ่งเป็นผลรวมของจํานวน ขนาดชุดงาน ของขนาดเอกสาร ดังนั้นให้ลดค่านี้หากขนาดเอกสารของคุณมีขนาดใหญ่	< ขนาดแบทช์การเขียนของคุณ > (ค่าเริ่มต้นคือ 100)	ไม่	ขนาดแบทช์
คอลัมน์เพิ่มเติม	เพิ่มคอลัมน์ข้อมูลเพิ่มเติมเพื่อจัดเก็บเส้นทางสัมพัทธ์หรือค่าคงที่ของไฟล์ต้นฉบับ นิพจน์ได้รับการสนับสนุนสําหรับรุ่นหลัง	•ชื่อ •ค่า	ไม่	คอลัมน์เพิ่มเติม: •ชื่อ •ค่า

ข้อมูลจุดหมายปลายทาง

ชื่อ	คำอธิบาย	ค่า	ต้องมี	คุณสมบัติสคริปต์ JSON
การเชื่อมต่อ	การเชื่อมต่อของคุณไปยังที่เก็บข้อมูลปลายทาง	< การเชื่อมต่อ Azure Cosmos DB for MongoDB ของคุณ >	ใช่	การเชื่อมต่อ
ฐานข้อมูล	ฐานข้อมูลของคุณที่คุณใช้เป็นปลายทาง	< ฐานข้อมูลของคุณ >	ใช่	ฐานข้อมูล
ชื่อคอลเลกชัน	ชื่อของคอลเลกชัน Azure Cosmos DB	< คอลเลกชันของคุณ >	ใช่	คอลเลกชัน
พฤติกรรมการเขียน	อธิบายวิธีการเขียนข้อมูลไปยัง Azure Cosmos DB สําหรับ MongoDB ค่าที่อนุญาต: แทรกและเพิ่ม ลักษณะการทํางานของ Upsert คือการแทนที่เอกสารหากมี _id เอกสารเดียวกันอยู่แล้ว มิฉะนั้น ให้แทรกเอกสาร หมายเหตุ: บริการจะสร้าง an สําหรับ _id เอกสารโดยอัตโนมัติหากไม่ได้ระบุไว้ใน _id เอกสารต้นฉบับหรือโดยการแมปคอลัมน์ ซึ่งหมายความว่าคุณต้องแน่ใจว่าเพื่อให้ Upsert ทํางานได้ตามที่คาดไว้ เอกสารของคุณมี ID	• แทรก (ค่าเริ่มต้น) • อัพเซิร์ต	ไม่	เขียนพฤติกรรม: •สอด • อัพเซิร์ต
การหมดเวลาชุดการเขียน	เวลารอให้การดําเนินการแทรกแบทช์เสร็จสิ้นก่อนที่จะหมดเวลา	timespan (ค่าเริ่มต้นคือ 00:30:00 - 30 นาที)	ไม่	writeBatchTimeout
เขียนขนาดแบทช์	ควบคุมขนาดของเอกสารที่จะเขียนในแต่ละชุด คุณสามารถลองเพิ่มค่านี้เพื่อปรับปรุงประสิทธิภาพและลดค่าหากขนาดเอกสารของคุณมีขนาดใหญ่	< ขนาดแบทช์การเขียนของคุณ > (ค่าเริ่มต้นคือ 10,000)	ไม่	เขียนขนาดแบทช์

เนื้อหาที่เกี่ยวข้อง

• ภาพรวมของ Azure Cosmos DB for MongoDB