หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
เคล็ดลับ
สําหรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีการใช้ประโยชน์จากความสามารถนี้ในสถานการณ์การรวมต่อเนื่อง / การปรับใช้ต่อเนื่อง (CI/CD) โปรดอ่านบทความเกี่ยวกับ สถาปัตยกรรมโซลูชัน CI/CD และ ALM สําหรับ Dataflow Gen2 และบทช่วยสอนแบบ end-to-end เกี่ยวกับ Parameterized Dataflow Gen2
พารามิเตอร์ในกระแสข้อมูล Gen2 ช่วยให้คุณสามารถควบคุมและปรับแต่งกระแสข้อมูลแบบไดนามิกทําให้มีความยืดหยุ่นและสามารถนํามาใช้ใหม่ได้โดยการเปิดใช้งานอินพุตและสถานการณ์ที่แตกต่างกันโดยไม่ต้องปรับเปลี่ยนกระแสข้อมูลเอง ซึ่งช่วยให้สิ่งต่างๆ ได้รับการจัดระเบียบโดยลดความจําเป็นสําหรับกระแสข้อมูลหลายชุดและรวมศูนย์ตัวควบคุมภายในกระแสข้อมูลแบบพารามิเตอร์เดียว
พารามิเตอร์สาธารณะ ใน Dataflow Gen2 เป็นโหมดใหม่ที่คุณสามารถอนุญาตให้เรียกใช้กระแสข้อมูลของคุณโดยการส่งผ่านค่าพารามิเตอร์ภายนอกตัวแก้ไข Power Query ผ่าน Fabric REST API หรือผ่านประสบการณ์ Fabric ดั้งเดิม ช่วยให้คุณมีประสบการณ์แบบไดนามิกมากขึ้นกับกระแสข้อมูลของคุณ ซึ่งการเรียกใช้แต่ละครั้งสามารถเรียกใช้ด้วยพารามิเตอร์ต่างๆ ที่ส่งผลต่อวิธีการทํางานของกระแสข้อมูลของคุณ
Prerequisites
- Dataflow Gen2 ที่รองรับ CI/CD
- ต้องตั้งค่าพารามิเตอร์ภายในกระแสข้อมูลของคุณเรียนรู้เพิ่มเติมเกี่ยวกับวิธีตั้งค่าพารามิเตอร์คิวรีในกระแสข้อมูล
เปิดใช้งานโหมดพารามิเตอร์สาธารณะ
ในฐานะเจ้าของกระแสข้อมูล ให้เปิดกระแสข้อมูล ภายในแท็บ หน้าแรก ของ Ribbon ให้เลือกปุ่ม ตัวเลือก
การเลือกปุ่มจะเปิดกล่องโต้ตอบ ตัวเลือก ใหม่ ในเมนูแนวตั้ง ให้เลือกตัวเลือกที่มีป้ายชื่อ พารามิเตอร์ ภายในกลุ่มกระแสข้อมูล ภายในส่วนพารามิเตอร์คุณสามารถเปิดใช้งานตัวเลือกที่อ่าน "เปิดใช้งานพารามิเตอร์ที่จะค้นหาและแทนที่สําหรับการดําเนินการ" เพื่อเปิดใช้งานโหมดพารามิเตอร์สาธารณะ
เลือกปุ่ม ตกลง เพื่อยอมรับการเปลี่ยนแปลงเหล่านี้
เมื่อเปิดใช้งานโหมดนี้ คุณจะได้รับการแจ้งเตือนในกล่องโต้ตอบ จัดการพารามิเตอร์ ที่อ่านว่า "เปิดใช้งานโหมดพารามิเตอร์สาธารณะ" ที่ด้านบนของกล่องโต้ตอบ
เมื่อเปิดใช้งานโหมดพารามิเตอร์สาธารณะแล้ว คุณสามารถบันทึกกระแสข้อมูลของคุณ
ส่งผ่านค่าพารามิเตอร์แบบกําหนดเองสําหรับการเรียกใช้กระแสข้อมูล
โหมดพารามิเตอร์สาธารณะเป็นไปตามข้อกําหนดของพารามิเตอร์ภายในกระแสข้อมูลซึ่งมีความแตกต่างระหว่างพารามิเตอร์ที่จําเป็นและพารามิเตอร์ที่ไม่ผ่านข้อกําหนด
- พารามิเตอร์ที่จําเป็น: ถ้ามีการตั้งค่าพารามิเตอร์ตามต้องการ เพื่อเรียกใช้กระแสข้อมูล จําเป็นต้องส่งค่าไปยังงานที่เรียกใช้ การรันล้มเหลวหากไม่มีการส่งผ่านค่าสําหรับพารามิเตอร์ที่ตั้งค่าเป็น required
- พารามิเตอร์ที่ไม่จําเป็น: พารามิเตอร์เหล่านี้เรียกอีกอย่างว่าพารามิเตอร์ ทางเลือก และไม่จําเป็นต้องส่งผ่านค่าเพื่อให้การเรียกใช้ถูกทริกเกอร์ หากไม่มีการส่งผ่านค่า ค่า ปัจจุบัน ที่กําหนดไว้ภายในพารามิเตอร์ของคุณจะถูกใช้สําหรับการเรียกใช้
ใช้กิจกรรมกระแสข้อมูลภายในไปป์ไลน์
Note
เราขอแนะนําให้อ่านเพิ่มเติมเกี่ยวกับ กิจกรรมกระแสข้อมูลจากไปป์ไลน์ Fabric เพื่อทําความเข้าใจความสามารถทั้งหมด
เมื่อคุณสร้างไปป์ไลน์ใน Fabric คุณสามารถใช้กิจกรรมกระแสข้อมูลเพื่อทริกเกอร์การเรียกใช้กระแสข้อมูล Gen2 ที่มีการสนับสนุน CI/CD ที่เปิดใช้งานโหมดพารามิเตอร์สาธารณะ
คุณสามารถเลือกกระแสข้อมูลที่คุณต้องการใช้ และตั้งค่าพารามิเตอร์ที่คุณต้องการใช้ในส่วน พารามิเตอร์กระแสข้อมูล
ในส่วน พารามิเตอร์กระแสข้อมูล คุณสามารถดูพารามิเตอร์ทั้งหมดที่พร้อมใช้งานในกระแสข้อมูลของคุณและค่าเริ่มต้นจากแต่ละพารามิเตอร์ภายในส่วนค่า
พารามิเตอร์ที่จําเป็นจะมีเครื่องหมายดอกจันถัดจากชื่อ ในขณะที่พารามิเตอร์ที่ไม่บังคับไม่มี ในขณะเดียวกัน พารามิเตอร์ทางเลือกสามารถลบออกจากกริดได้ ในขณะที่พารามิเตอร์ที่จําเป็นไม่สามารถลบได้ และต้องส่งผ่านค่าเพื่อให้กระแสข้อมูลทํางาน
คุณสามารถเลือกปุ่มรีเฟรชเพื่อร้องขอข้อมูลพารามิเตอร์ล่าสุดจากกระแสข้อมูลของคุณ
ชนิดพารามิเตอร์ที่สนับสนุน
เคล็ดลับ
อ่านและใช้พารามิเตอร์กระแสข้อมูล REST API เอกสารประกอบมีชนิดพารามิเตอร์ที่มีอยู่ทั้งหมดและค่าที่คาดหวัง และ REST API มีวิธีการรับข้อมูลพารามิเตอร์จากกระแสข้อมูลของคุณ
ตารางต่อไปนี้แสดงชนิดพารามิเตอร์ที่รองรับในปัจจุบันและลิงก์ไปยังข้อกําหนด REST API เพื่อทําความเข้าใจว่าค่าใดที่ REST API คาดหวัง
| ชนิดพารามิเตอร์กระแสข้อมูล | คําจํากัดความของ REST API |
|---|---|
| ข้อความ | พารามิเตอร์ DataflowString |
| จํานวนเต็ม (int64) | DataflowIntegerParameter |
| เลขทศนิยม | DataflowNumberParameter |
| วันที่ | พารามิเตอร์ DataflowDateParameter |
| DateTime | พารามิเตอร์ DataflowDateTime |
| Time | พารามิเตอร์ DataflowTimeParameter |
| โซนวันที่เวลา | DataflowDateTimeZoneParameter |
| Duration | พารามิเตอร์ DataflowDuration |
| จริง / เท็จ | กระแสข้อมูล BooleanParameter |
ข้อควรพิจารณาและข้อจำกัด
ต่อไปนี้เป็นรายการข้อควรพิจารณาและข้อจํากัดทั้งหมดเมื่อใช้โหมดพารามิเตอร์สาธารณะใน Dataflow Gen2 กับ CI/CD:
- การจัดกําหนดการและการทริกเกอร์ด้วยตนเอง: กระแสข้อมูลที่มีพารามิเตอร์สาธารณะไม่สามารถจัดกําหนดการหรือทริกเกอร์ด้วยตนเองผ่าน Fabric เว้นแต่จะไม่มีการตั้งค่าพารามิเตอร์ที่จําเป็น
- การกําหนดพารามิเตอร์ที่ไม่รองรับ: ไม่รองรับพารามิเตอร์ที่เปลี่ยนแปลงเส้นทางทรัพยากรสําหรับแหล่งที่มาหรือปลายทาง การเชื่อมต่อได้รับการแก้ไขกับเส้นทางที่เขียน
- การรีเฟรชแบบเพิ่มหน่วย: เข้ากันไม่ได้กับโหมดพารามิเตอร์สาธารณะ
- การปรับเปลี่ยนตรรกะ: พารามิเตอร์สาธารณะช่วยให้ผู้ใช้สามารถเข้าถึงการแทนที่ค่า ซึ่งอาจเปลี่ยนแปลงเอาต์พุตกระแสข้อมูล
- ฮับการตรวจสอบ: ฮับการตรวจสอบไม่แสดงค่าพารามิเตอร์ที่ใช้ระหว่างการดําเนินการ
- พฤติกรรมการแสดงละคร: เฉพาะการเรียกใช้ล่าสุดเท่านั้นที่จะถูกเก็บไว้ในเลคเฮาส์การแสดงละคร ใช้ปลายทางที่กําหนดไว้เพื่อเก็บรักษาข้อมูล
- คําขอที่ซ้ํากัน: หากมีการส่งค่าพารามิเตอร์เดียวกันหลายครั้ง จะยอมรับเฉพาะคําขอแรกจนกว่าจะเสร็จสมบูรณ์
- การแม็ป schema: พารามิเตอร์ไม่สามารถแก้ไขการแม็ป schema ปลายทางได้ การแม็ปทั้งหมดเป็นไปตามการกําหนดค่าที่เขียนไว้ ลองดูบทความสําหรับข้อมูลเพิ่มเติมเกี่ยวกับปลายทางของข้อมูลและการตั้งค่าที่มีการจัดการใน Dataflow Gen2