แชร์ผ่าน

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

  • บทความ

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

โดยเฉพาะตัวเชื่อมต่อ REST ทั่วไปนี้สนับสนุน:

  • การคัดลอกข้อมูลจากจุดสิ้นสุด REST โดยใช้วิธีการรับหรือโพสต์และคัดลอกข้อมูลไปยังจุดสิ้นสุด REST โดยใช้วิธี POST, PUT หรือ PATCH
  • การ แบ่งหน้าใน REST API
  • สําหรับ REST เป็นแหล่งข้อมูล ให้คัดลอกการตอบสนอง REST JSON ตามที่เป็นหรือแยกวิเคราะห์โดยใช้การแมป schema รองรับเฉพาะส่วนข้อมูลการตอบสนองใน JSON เท่านั้น

การกําหนดค่าที่ได้รับการสนับสนุน

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

ทั่วไป

สําหรับการกําหนดค่าแท็บทั่วไป ไปที่ทั่วไป

ทรัพยากร

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

Screenshot showing source tab and the list of properties.

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

  • ชนิดของที่เก็บข้อมูล: เลือก ภายนอก
  • เชื่อมต่อ: เลือกการเชื่อมต่อ REST จากรายการการเชื่อมต่อ ถ้าไม่มีการเชื่อมต่ออยู่ สร้างการเชื่อมต่อ REST ใหม่ โดยการเลือกใหม่
  • ชนิดเชื่อมต่อ: เลือก REST
  • URL สัมพัทธ์: URL สัมพัทธ์ไปยังทรัพยากรที่ประกอบด้วยข้อมูล เมื่อไม่ได้ระบุคุณสมบัตินี้ จะใช้ URL ที่ระบุไว้ในข้อกําหนดการเชื่อมต่อเท่านั้น ตัวเชื่อมต่อ HTTP จะคัดลอกข้อมูลจาก URL ที่รวมกัน: [URL specified in connection]/[relative URL specified]

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

  • วิธีการร้องขอ: เมธอด HTTP ค่าที่อนุญาตคือ GET (ค่าเริ่มต้น) และ POST

    Screenshot showing request method.

  • คําขอหมดเวลา: หมดเวลา (ค่าช่วงเวลา) สําหรับคําขอ HTTP เพื่อรับคําตอบ ค่านี้คือหมดเวลาเพื่อให้ได้คําตอบ ไม่ใช่การหมดเวลาในการอ่านข้อมูลการตอบสนอง ค่าเริ่มต้นคือ 00:01:40

  • ช่วงเวลาคําขอ (ms): ช่วงเวลาระหว่างคําขอที่แตกต่างกันสําหรับหลายหน้าในหน่วยมิลลิวินาที ค่าช่วงเวลาคําขอควรเป็นตัวเลขระหว่าง [10, 60000]

  • ส่วนหัวเพิ่มเติม: ส่วนหัวของคําขอ HTTP เพิ่มเติม

    Screenshot showing additional headers.

  • กฎการแบ่งหน้า: กฎการแบ่งหน้าเพื่อเขียนคําขอหน้าถัดไป โปรดดูส่วน การสนับสนุนการ แบ่งหน้า สําหรับรายละเอียด

    Screenshot showing pagination rules.

  • คอลัมน์เพิ่มเติม: เพิ่มคอลัมน์ข้อมูลเพิ่มเติมเพื่อจัดเก็บเส้นทางสัมพัทธ์หรือค่าคงที่ของไฟล์ต้นฉบับ ถ้าคุณกําลังใช้ค่าคงที่ คุณสามารถใช้ นิพจน์ แบบกําหนดเองเพื่อสร้างได้

    Screenshot showing additional columns.

ปลายทาง

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

Screenshot showing destination tab.

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

  • ชนิดของที่เก็บข้อมูล: เลือก ภายนอก
  • เชื่อมต่อ: เลือกการเชื่อมต่อ REST จากรายการการเชื่อมต่อ ถ้าไม่มีการเชื่อมต่ออยู่ สร้างการเชื่อมต่อ REST ใหม่ โดยการเลือกใหม่
  • ชนิดเชื่อมต่อ: เลือก REST
  • URL สัมพัทธ์: URL สัมพัทธ์ไปยังทรัพยากรที่ประกอบด้วยข้อมูล เมื่อไม่ได้ระบุคุณสมบัตินี้ จะใช้ URL ที่ระบุไว้ในข้อกําหนดการเชื่อมต่อเท่านั้น ตัวเชื่อมต่อ HTTP จะคัดลอกข้อมูลจาก URL ที่รวมกัน: [URL specified in connection]/[relative URL specified]

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

  • วิธีการร้องขอ: เมธอด HTTP ค่าที่อนุญาตคือ POST (ค่าเริ่มต้น) PUT และ PATCH

  • คําขอหมดเวลา: หมดเวลา (ค่าช่วงเวลา) สําหรับคําขอ HTTP เพื่อรับคําตอบ ค่านี้คือหมดเวลาเพื่อให้ได้คําตอบ ไม่ใช่การหมดเวลาในการเขียนข้อมูล ค่าเริ่มต้นคือ 00:01:40

  • ช่วงเวลาคําขอ (ms): ช่วงเวลาระหว่างคําขอที่แตกต่างกันสําหรับหลายหน้าในหน่วยมิลลิวินาที ค่าช่วงเวลาคําขอควรเป็นตัวเลขระหว่าง [10, 60000]

  • เขียนขนาดของชุดงาน: จํานวนเรคคอร์ดที่จะเขียนไปยังปลายทาง REST ต่อชุดงาน ค่าเริ่มต้นคือ 10000

  • ชนิดการบีบอัด HTTP: ชนิดการบีบอัด HTTP ที่จะใช้ในขณะส่งข้อมูลที่มีระดับการบีบอัดที่เหมาะสม ค่าที่อนุญาตคือ None และ GZip

  • ส่วนหัวเพิ่มเติม: ส่วนหัวของคําขอ HTTP เพิ่มเติม

    Screenshot showing additional headers.

การแม็ป

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

การตั้งค่า

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

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

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

ข้อมูลต้นทาง

ชื่อ รายละเอียด ค่า ต้องมี คุณสมบัติสคริปต์ JSON
ชนิดของที่เก็บข้อมูล ประเภทที่เก็บข้อมูลของคุณ • พื้นที่ทํางาน
• ภายนอก
• ชุดข้อมูลตัวอย่าง
 ใช่ ชนิด
เชื่อมต่อชั่น การเชื่อมต่อของคุณไปยังที่เก็บข้อมูลต้นทาง <การเชื่อมต่อของคุณ> ใช่ เชื่อม ต่อ
ชนิดเชื่อมต่อ ชนิดการเชื่อมต่อของคุณ เลือก REST เหลือ ใช่ ชนิด:
RestResource
URL สัมพัทธ์ URL สัมพัทธ์ไปยังทรัพยากรที่ประกอบด้วยข้อมูล เมื่อไม่ได้ระบุคุณสมบัตินี้ จะใช้ URL ที่ระบุไว้ในข้อกําหนดการเชื่อมต่อเท่านั้น ตัวเชื่อมต่อ HTTP จะคัดลอกข้อมูลจาก URL ที่รวมกัน: [URL specified in connection]/[relative URL specified] <URL สัมพัทธ์ของคุณ> ไม่ relativeUrl
วิธีการร้องขอ เมธอด HTTP ค่าที่อนุญาตคือ GET (ค่าเริ่มต้น) และ POST • รับ
• โพสต์		 ไม่ requestMethod
คําขอหมดเวลา หมดเวลา (ค่าช่วงเวลา) สําหรับคําขอ HTTP เพื่อรับการตอบสนอง ค่านี้คือหมดเวลาเพื่อให้ได้คําตอบ ไม่ใช่การหมดเวลาในการอ่านข้อมูลการตอบสนอง ค่าเริ่มต้นคือ 00:01:40 timespan ไม่ httpRequestTimeout
ช่วงเวลาคําขอ (ms) ช่วงเวลาระหว่างคําขอที่แตกต่างกันสําหรับหลายหน้าในหน่วยมิลลิวินาที ค่าช่วงเวลาคําขอควรเป็นตัวเลขระหว่าง [10, 60000] [10, 60000] ไม่ requestInterval
ส่วนหัวเพิ่มเติม ส่วนหัวของคําขอ HTTP เพิ่มเติม <ส่วนหัวเพิ่มเติมของคุณ> ไม่ additionalHeaders
กฎการแบ่งหน้า กฎการแบ่งหน้าเพื่อเขียนคําขอหน้าถัดไป โปรดดูส่วน การสนับสนุนการ แบ่งหน้า สําหรับรายละเอียด ไปที่ การแบ่งหน้า ไม่ กฎการแบ่งหน้า
คอลัมน์เพิ่มเติม เพิ่มคอลัมน์ข้อมูลเพิ่มเติมไปยังเส้นทางสัมพัทธ์ของไฟล์ต้นฉบับของร้านค้าหรือค่าคงที่ นิพจน์ได้รับการสนับสนุนสําหรับอย่างหลัง • ชื่อ
•ค่า		 ไม่ additionalColumns:
•ชื่อ
•ค่า

ข้อมูลปลายทาง

ชื่อ รายละเอียด ค่า ต้องมี คุณสมบัติสคริปต์ JSON
ชนิดของที่เก็บข้อมูล ประเภทที่เก็บข้อมูลของคุณ • พื้นที่ทํางาน
• ภายนอก		 ใช่ ชนิด
เชื่อมต่อชั่น การเชื่อมต่อของคุณไปยังที่เก็บข้อมูลต้นทาง <การเชื่อมต่อของคุณ> ใช่ เชื่อม ต่อ
ชนิดเชื่อมต่อ ชนิดการเชื่อมต่อของคุณ เลือก REST เหลือ ใช่ ชนิด:
RestResource
URL สัมพัทธ์ URL สัมพัทธ์ไปยังทรัพยากรที่ประกอบด้วยข้อมูล เมื่อไม่ได้ระบุคุณสมบัตินี้ จะใช้ URL ที่ระบุไว้ในข้อกําหนดการเชื่อมต่อเท่านั้น ตัวเชื่อมต่อ HTTP จะคัดลอกข้อมูลจาก URL ที่รวมกัน: [URL specified in connection]/[relative URL specified] <URL สัมพัทธ์ของคุณ> ไม่ relativeUrl
วิธีการร้องขอ เมธอด HTTP ค่าที่อนุญาตคือ POST (ค่าเริ่มต้น) PUT และ PATCH • โพสต์
• รับ
• โปรแกรมแก้ไข		 ไม่ requestMethod
คําขอหมดเวลา หมดเวลา (ค่าช่วงเวลา) สําหรับคําขอ HTTP เพื่อรับการตอบสนอง ค่านี้คือหมดเวลาเพื่อให้ได้คําตอบ ไม่ใช่การหมดเวลาในการอ่านข้อมูลการตอบสนอง ค่าเริ่มต้นคือ 00:01:40 timespan ไม่ httpRequestTimeout
ช่วงเวลาคําขอ (ms) ช่วงเวลาระหว่างคําขอที่แตกต่างกันสําหรับหลายหน้าในหน่วยมิลลิวินาที ค่าช่วงเวลาคําขอควรเป็นตัวเลขระหว่าง [10, 60000] [10, 60000] ไม่ requestInterval
เขียนขนาดของชุดงาน จํานวนของเรกคอร์ดที่จะเขียนไปยังปลายทาง REST ต่อชุดงาน ค่าเริ่มต้นคือ 10000 <จํานวนแถว>
(จํานวนเต็ม)		 ไม่ writeBatchSize
ชนิดการบีบอัด Http ชนิดการบีบอัด HTTP ที่จะใช้ในขณะส่งข้อมูลที่มีระดับการบีบอัดที่เหมาะสม ค่าที่อนุญาตคือ None และ GZip • ไม่มี
• GZip		 ไม่ httpCompressionType
ส่วนหัวเพิ่มเติม ส่วนหัวของคําขอ HTTP เพิ่มเติม <ส่วนหัวเพิ่มเติมของคุณ> ไม่ additionalHeaders

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