หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
บทช่วยสอนนี้แสดงวิธีใช้เนื้อหาแบบไดนามิกในไปป์ไลน์ Microsoft Fabric เมื่อคุณสร้างรายการไลบรารีตัวแปรและเพิ่มตัวแปร คุณสามารถกําหนดค่าอัตโนมัติสําหรับขั้นตอนต่างๆ ของไปป์ไลน์การปรับใช้ของคุณ ในบทช่วยสอนนี้ คุณคัดลอกข้อมูลจากเลคเฮาส์หนึ่งไปยังอีกเลคเฮาส์หนึ่ง จากนั้น คุณใช้ไลบรารีตัวแปรเพื่อตั้งค่าต้นทางและปลายทางสําหรับกิจกรรมการคัดลอก
ในบทช่วยสอนนี้ คุณ:
- สร้างไลบรารีตัวแปร
- เพิ่มตัวแปรลงในไลบรารี
- กําหนดชุดค่าเพิ่มเติมสําหรับตัวแปร
- ใช้ตัวแปรในรายการอื่นในพื้นที่ทํางาน (ไปป์ไลน์)
- แก้ไขตัวแปรในที่เก็บ Git
- สร้างไปป์ไลน์การปรับใช้และปรับใช้ไลบรารีตัวแปร
- เปลี่ยนค่าที่ใช้งานอยู่ที่ตั้งค่าในขั้นตอนเป้าหมายของไปป์ไลน์การปรับใช้
- แสดงให้เห็นว่าค่าของตัวแปรสอดคล้องกับค่าที่ใช้งานอยู่ในแต่ละขั้นตอน
ไดอะแกรมต่อไปนี้แสดงเค้าโครงพื้นที่ทํางานสําหรับบทช่วยสอนนี้
ข้อกำหนดเบื้องต้น
บัญชีผู้เช่า Fabric ที่มีการสมัครใช้งานที่ใช้งานอยู่ สร้างบัญชีฟรี
สวิตช์ผู้เช่าต่อไปนี้ถูกเปิดใช้งานจากพอร์ทัลผู้ดูแลระบบ:
ผู้ดูแลระบบผู้เช่า ผู้ดูแลระบบความจุ หรือผู้ดูแลระบบพื้นที่ทํางานสามารถเปิดใช้งานสวิตช์เหล่านี้ได้ โดยขึ้นอยู่กับ การตั้งค่าขององค์กรของคุณ
สร้างพื้นที่ทํางาน LH ของขั้นตอน เลคเฮาส์ SourceLH_Stage ด้วยข้อมูลตัวอย่าง และไปป์ไลน์ Pipeline_Stage
ขั้นแรก ให้สร้างพื้นที่ทํางานและเลคเฮาส์เพื่อใช้เป็นข้อมูลการจัดเตรียมเริ่มต้นของคุณ:
ไปที่ Power BI
บนแถบด้านข้าง ให้เลือกพื้นที่ทํางาน
สร้างพื้นที่ทํางาน เรียกมันว่า Stage LHs
สร้างเลคเฮาส์:
สร้างไปป์ไลน์:
ในเลคเฮาส์ ให้เลือก ไปป์ไลน์ใหม่
ป้อนชื่อ Pipeline_Stage แล้วเลือก สร้าง
ในตัวช่วยสร้าง คัดลอกข้อมูลไปยัง Lakehouse บนหน้า เลือกแหล่งข้อมูล ให้เลือก ข้อมูลตัวอย่าง
เลือกวันหยุดนักขัตฤกษ์
หลังจากโหลดข้อมูลตัวอย่างเสร็จแล้ว ให้เลือก ถัดไป
บนหน้า เชื่อมต่อกับปลายทางข้อมูล ให้เลือก ถัดไป
บนหน้า รีวิว + บันทึก ให้เลือก บันทึก + เรียกใช้
สร้างพื้นที่ทํางาน LH ต้นทางด้วยตัวแปร
ตอนนี้ สร้างพื้นที่ทํางานที่คุณจะทํางานและใช้กับไลบรารีตัวแปรของคุณ:
ไปที่ Power BI
บนแถบด้านข้าง ให้เลือกพื้นที่ทํางาน
สร้างพื้นที่ทํางาน เรียกมันว่า LH แหล่งที่มาพร้อมตัวแปร
สร้างเลคเฮาส์ SourceLH_Dev SourceLH_Test และ SourceLH_Prod
จากนั้นสร้างเลคเฮาส์สามแห่งเพื่อใช้กับไลบรารีตัวแปร:
สร้างเลคเฮาส์แห่งแรก:
บนแถบด้านข้าง ให้เลือกพื้นที่ทํางาน LH ต้นทางที่มีตัวแปร
เลือก รายการใหม่
ภายใต้ จัดเก็บข้อมูล ให้เลือก Lakehouse
ป้อนชื่อ SourceLH_Dev แล้วเลือก สร้าง
สร้างเลคเฮาส์แห่งที่สองโดยทําตามขั้นตอนก่อนหน้านี้ ตั้งชื่อ SourceLH_Test
สร้างเลคเฮาส์แห่งที่สามโดยทําตามขั้นตอนก่อนหน้านี้ ตั้งชื่อ SourceLH_Prod
บนแถบด้านข้าง ให้เลือกพื้นที่ทํางาน LH ต้น ทางที่มีตัวแปร และตรวจสอบให้แน่ใจว่ามีเลคเฮาส์ที่สร้างขึ้นใหม่ทั้งหมด
รับรหัสพื้นที่ทํางานและรหัสอ็อบเจ็กต์สําหรับเลคเฮาส์
ในขั้นตอนเหล่านี้ คุณจะได้รับตัวระบุที่ไม่ซ้ํากันเพื่อใช้ในไลบรารีตัวแปร
ใน Power BI บนแถบด้านข้าง ให้เลือกพื้นที่ทํางาน LH ของขั้นตอน
ในพื้นที่ทํางาน ให้เลือกเลคเฮาส์ SourceLH_Stage
คัดลอกรหัสพื้นที่ทํางานและรหัสออบเจ็กต์เลคเฮาส์ใน URL
ทําซ้ําขั้นตอนก่อนหน้านี้สําหรับเลคเฮาส์ SourceLH_Dev และSourceLH_Test ในพื้นที่ทํางาน LH แหล่งที่มาที่มีตัวแปร
สร้างไลบรารีตัวแปรด้วยตัวแปร
ตอนนี้สร้างไลบรารีตัวแปร:
ในพื้นที่ทํางาน LH ต้นทางที่มีตัวแปร ให้เลือก รายการใหม่
ภายใต้ พัฒนาข้อมูล ให้เลือก **ไลบรารีตัวแปร **
ตั้งชื่อไลบรารีตัวแปร WS แล้วเลือก สร้าง
เลือก ตัวแปรใหม่
สร้างตัวแปรต่อไปนี้:
ชื่อ ประเภท ตั้งค่าเริ่มต้น Source_LHสตริง <GUID ของ SourceLH_Stage lakehouse> Source_WSIDสตริง <GUID ของพื้นที่ทํางาน SourceLH_Stage> Destination_LHสตริง <GUID ของ SourceLH_Dev lakehouse> Destination_WSIDสตริง <GUID ของพื้นที่ทํางาน SourceLH_Dev> SourceTable_Nameสตริง ProcessedDestinationTable_Nameสตริง DevCopiedDataเลือก บันทึก
สร้างชุดค่าสํารอง
ในขั้นตอนเหล่านี้ คุณจะเพิ่มชุดค่าสํารองลงในไลบรารีตัวแปรของคุณ:
สร้างชุดค่าแรก:
ในไลบรารีตัวแปร WS ให้เลือกเพิ่มชุดค่า
ป้อน ทดสอบ VS สําหรับชื่อ แล้วเลือก สร้าง
สร้างตัวแปรต่อไปนี้:
ชื่อ ประเภท ตั้งค่าเริ่มต้น Source_LHสตริง <GUID ของ SourceLH_Dev lakehouse> Source_WSIDสตริง <GUID ของพื้นที่ทํางาน SourceLH_Dev> Destination_LHสตริง <GUID ของ SourceLH_Test lakehouse> Destination_WSIDสตริง <GUID ของพื้นที่ทํางาน SourceLH_Test> SourceTable_Nameสตริง DevCopiedDataDestinationTable_Nameสตริง TestCopiedDataเลือก บันทึก>ตกลง
สร้างชุดค่าที่สอง:
เลือก เพิ่มชุดค่า
ป้อน Prod VS สําหรับชื่อ แล้วเลือก สร้าง
สร้างตัวแปรต่อไปนี้:
ชื่อ ประเภท ตั้งค่าเริ่มต้น Source_LHสตริง <GUID ของ SourceLH_Test lakehouse> Source_WSIDสตริง <GUID ของพื้นที่ทํางาน SourceLH_Test> Destination_LHสตริง <GUID ของ SourceLH_Prod เลคเฮาส์> Destination_WSIDสตริง <GUID ของพื้นที่ทํางาน SourceLH_Prod> SourceTable_Nameสตริง TestCopiedDataDestinationTable_Nameสตริง ProdCopiedDataเลือก บันทึก>ตกลง
สร้างไปป์ไลน์ Pipeline_Deploy และประกาศตัวแปร
ในขั้นตอนเหล่านี้ คุณจะสร้างไปป์ไลน์และประกาศตัวแปรของคุณ:
ในพื้นที่ทํางาน LH ต้นทางที่มีตัวแปร ให้เลือก รายการใหม่
ภายใต้ รับข้อมูล ให้เลือก ไปป์ไลน์
ป้อนชื่อ Pipeline_Deploy แล้วเลือก สร้าง
เลือก คัดลอกข้อมูล>เพิ่มลงในพื้นที่ทํางาน
เลือกพื้นที่ทํางานเพื่อให้โฟกัสปิด คัดลอกข้อมูล
เลือก **ตัวแปรไลบรารี **
เลือก สร้าง แล้วเพิ่มตัวแปรต่อไปนี้:
ชื่อ ห้องสมุด ชื่อตัวแปร ประเภท SourceLHตัวแปร WS Source_LHสตริง SourceWSIDตัวแปร WS Source_WSIDสตริง DestinationLHตัวแปร WS Destination_LHสตริง DestinationWSIDตัวแปร WS Destination_WSIDสตริง SourceTableNameตัวแปร WS SourceTable_Nameสตริง DestinationTableNameตัวแปร WS DestinationTable_Nameสตริง เลือก บันทึก
กําหนดค่าการเชื่อมต่อต้นทางสําหรับไปป์ไลน์ Pipeline_Deploy
ในขั้นตอนเหล่านี้ คุณกําหนดค่าการเชื่อมต่อต้นทางสําหรับไปป์ไลน์ของคุณ:
ในพื้นที่ทํางาน LH ต้นทางที่มีตัวแปร ไปที่ Pipeline_Deploy
บนพื้นที่ทํางาน ให้เลือก คัดลอกข้อมูล เพื่อให้โฟกัสอยู่ที่ คัดลอกข้อมูล
เลือก แหล่งที่มา
กําหนดค่า SourceLH:
กําหนดค่า SourceWSID:
กําหนดค่า SourceTableName:
เมื่อตั้งค่าการเชื่อมต่อต้นทางแล้ว คุณสามารถทดสอบได้ เลือก แสดงตัวอย่างข้อมูล แล้วเลือก ตกลง บนเมนูลอย หลังจากเติมข้อมูลแล้ว คุณสามารถปิดการแสดงตัวอย่างข้อมูลได้
กําหนดค่าการเชื่อมต่อปลายทางสําหรับไปป์ไลน์ Pipeline_Deploy
ในขั้นตอนเหล่านี้ คุณกําหนดค่าการเชื่อมต่อปลายทางสําหรับไปป์ไลน์ของคุณ:
ในพื้นที่ทํางาน LH ต้นทางที่มีตัวแปร ไปที่ Pipeline_Deploy
บนพื้นที่ทํางาน ให้เลือก คัดลอกข้อมูล เพื่อให้โฟกัสอยู่ที่ คัดลอกข้อมูล
เลือก ปลายทาง
กําหนดค่า SourceLH:
กําหนดค่า DestinationWSID:
กําหนดค่า DestinationTableName:
ตอนนี้ตั้งค่าการเชื่อมต่อปลายทางแล้ว ให้บันทึกไปป์ไลน์และเลือก เรียกใช้ ยืนยันว่าทํางานสําเร็จ
สร้างไปป์ไลน์การปรับใช้
ตอนนี้ สร้างไปป์ไลน์การปรับใช้ของคุณ:
ในพื้นที่ทํางาน LH ต้นทางที่มีตัวแปร ให้เลือก สร้างไปป์ไลน์การปรับใช้
ตั้งชื่อไปป์ไลน์ Deployment_Pipeline_Var แล้วเลือก ถัดไป
ในไปป์ไลน์การปรับใช้ ให้เลือก สร้างและดําเนินการต่อ
สําหรับขั้นตอน การพัฒนา :
สําหรับ ขั้นตอนการทดสอบ :
สําหรับขั้นตอน การผลิต :
ตั้งค่าชุดที่ใช้งานอยู่ของไลบรารีตัวแปรสําหรับแต่ละขั้นตอน
ในขั้นตอนเหล่านี้ คุณกําหนดค่าชุดที่ใช้งานอยู่สําหรับแต่ละขั้นตอนในไปป์ไลน์การปรับใช้ของคุณ:
ตั้งค่าคอนฟิกชุดที่ใช้งานอยู่สําหรับขั้นตอน การทดสอบ :
กําหนดค่าชุดที่ใช้งานอยู่ สําหรับขั้นตอนการผลิต :
บนแถบด้านข้าง ให้เลือกไปป์ไลน์ Deployment_Pipeline_Var
เลือกขั้นตอนการผลิต
เลือก ตัวแปร WS
เลือกจุดไข่ปลา (...) แล้วเลือก ตั้งค่าเป็นใช้งานอยู่ เลือกปุ่ม ตั้งค่าเป็นใช้งาน
เลือก บันทึก>ตกลง
ตรวจสอบและทดสอบไลบรารีตัวแปร
เมื่อคุณตั้งค่าไลบรารีตัวแปรและกําหนดค่าชุดที่ใช้งานอยู่ทั้งหมดสําหรับแต่ละขั้นตอนของไปป์ไลน์การปรับใช้ คุณสามารถตรวจสอบได้:
ตรวจสอบเลคเฮาส์ SourceLHs_Dev :
เปลี่ยนไปใช้เลคเฮาส์ SourceLHs_Test และทําซ้ําขั้นตอนก่อนหน้านี้
ตาราง TestCopiedData ไม่ควรปรากฏขึ้นเนื่องจากคุณยังไม่ได้เรียกใช้ไปป์ไลน์ด้วยชุดทดสอบ VS ที่ใช้งานอยู่
เปลี่ยนไปใช้เลคเฮาส์ SourceLHs_Prod และทําซ้ําขั้นตอนก่อนหน้า
ตาราง ProdCopiedData ไม่ควรปรากฏขึ้นเนื่องจากคุณยังไม่ได้เรียกใช้ไปป์ไลน์ด้วยชุด Prod VS ที่ใช้งานอยู่
ตรวจสอบ ขั้นตอนการทดสอบ ของไปป์ไลน์ Deployment_Pipeline_Var :
สลับไปยังไปป์ไลน์ Deployment_Pipeline_Var และเลือกขั้นตอนการทดสอบ
เลือกไปป์ไลน์ Pipeline_Deploy
เลือก เรียกใช้ กระบวนการนี้ควรเสร็จสิ้นเรียบร้อย
ตรวจสอบเลคเฮาส์ SourceLHs_Test อีกครั้ง:
ตรวจสอบขั้นตอน การผลิต ของไปป์ไลน์ Deployment_Pipeline_Var :
สลับไปยังไปป์ไลน์ Deployment_Pipeline_Var และเลือกขั้นตอนการผลิต
เลือกไปป์ไลน์ Pipeline_Deploy
เลือก เรียกใช้ กระบวนการนี้ควรเสร็จสิ้นเรียบร้อย
ตรวจสอบเลคเฮาส์ SourceLHs_Prod อีกครั้ง:
เปลี่ยนไปใช้เลคเฮาส์ SourceLHs_Prod
เปลี่ยนการเชื่อมต่อจาก Lakehouse เป็นจุดสิ้นสุดการวิเคราะห์ SQL
ในตัวสํารวจ ให้ขยาย Schemas>dbo>Tables
ยืนยันว่า ตาราง ProdCopiedData ปรากฏขึ้น
ปรับแต่งค่าตัวแปรใน Git (ไม่บังคับ)
หากต้องการดูว่าไลบรารีตัวแปรแสดง ใน Git อย่างไร หรือแก้ไขตัวแปรจากที่เก็บ Git:
ในพื้นที่ทํางาน ให้เลือก การควบคุมแหล่งที่มา และเชื่อมต่อพื้นที่ทํางานกับที่เก็บ Git
บนบานหน้าต่าง การควบคุม แหล่งที่มา ให้เลือก คอมมิตเพื่อ ส่งเนื้อหาพื้นที่ทํางานไปยังที่เก็บ Git
ที่เก็บ Git มีโฟลเดอร์สําหรับแต่ละรายการในพื้นที่ทํางาน โฟลเดอร์ที่เรียกว่าตัว แปร WS VariableLibrary แสดงรายการไลบรารีตัวแปร สําหรับข้อมูลเพิ่มเติมเกี่ยวกับเนื้อหาของโฟลเดอร์นี้ ให้ดูที่ ไลบรารีตัวแปร CI/CD
เปรียบเทียบไฟล์ ProdVS.json และ TestVS.json ในโฟลเดอร์ valueSets ยืนยันว่าตัว
overridesแปรถูกตั้งค่าเป็นค่าที่แตกต่างกัน คุณสามารถแก้ไขค่าเหล่านี้ได้โดยตรงใน UI หรือโดยการแก้ไขไฟล์นี้ใน Git และอัปเดตไปยังพื้นที่ทํางาน{ "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/VariablesLibrary/definition/valueSets/1.0.0/schema.json", "valueSetName": "Test VS", "overrides": [ { "name": "Source_LH", "value": "4fe228d3-a363-4b7f-a5d4-fae9d2abca43" }, { "name": "DestinationTableName", "value": "TestCopiedData" } ] }{ "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/VariablesLibrary/definition/valueSets/1.0.0/schema.json", "valueSetName": "Prod VS", "overrides": [ { "name": "Source_LH", "value": "c0f13027-9bf4-4e8c-8f57-ec5c18c8656b" }, { "name": "DestinationTableName", "value": "ProdCopiedData" } ] }