หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
เมื่อคุณปรับใช้รายการ Fabric ในพื้นที่ทํางาน (ตัวอย่างเช่น จากการพัฒนา การทดสอบ ไปจนถึงการผลิต) การขึ้นต่อกันระหว่างรายการอาจหยุดทํางาน บางรายการเก็บการอ้างอิงไปยังการขึ้นต่อกันเป็น รหัสวัตถุ (GUID เฉพาะพื้นที่ทํางาน) ในขณะที่บางรายการใช้ รหัสตรรกะ (ตัวระบุแบบพกพาข้ามพื้นที่ทํางานที่เก็บไว้ใน .platform ไฟล์)
ไอเท็มที่ใช้ ID โลจิคัลในนิยามจะผูกกับไอเท็มที่สอดคล้องกันในพื้นที่ทํางานเป้าหมายอย่างถูกต้อง รายการที่ใช้รหัสออบเจ็กต์ยังคงชี้ไปที่พื้นที่ทํางานต้นทาง ซึ่งจะทําลายการปรับใช้
บทความนี้แมปว่าชนิดรายการ Fabric ใดสนับสนุนการผูกการขึ้นต่อกันผ่านรหัสตรรกะเมื่อคุณใช้การรวม Git และประเภทใดที่ไม่รองรับ หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับรหัสตรรกะและวิธีการแสดงรายการในการควบคุมแหล่งที่มา โปรดดู รหัสตรรกะใน Fabric
แนวคิดหลัก
-
รหัสตรรกะ: ตัวระบุข้ามพื้นที่ทํางานที่สร้างขึ้นโดยอัตโนมัติใน
.platformไฟล์ รายการที่มีรหัสตรรกะเดียวกันจะถือว่าเป็นรายการเดียวกันในพื้นที่ทํางาน - รหัสออบเจ็กต์: GUID เฉพาะพื้นที่ทํางานที่ระบุอินสแตนซ์เฉพาะ รหัสออบเจ็กต์ไม่สามารถอยู่รอดจากการปรับใช้ข้ามพื้นที่ทํางานได้หากไม่มีการแทรกแซงด้วยตนเองหรือการกําหนดพารามิเตอร์
- การผูกการขึ้นต่อกัน (Git): เมื่อคุณซิงค์สาขา Git กับพื้นที่ทํางานใหม่ Fabric จะแก้ไขการอ้างอิงการขึ้นต่อกันโดยใช้รหัสตรรกะ โดยชี้ไปยังรายการที่ถูกต้องในพื้นที่ทํางานเป้าหมายโดยอัตโนมัติ
- ตามชื่อหรือตาม URI: บางรายการอ้างอิงการขึ้นต่อกันตามชื่อที่แสดงหรือ URI แทนที่จะเป็นรหัส การอ้างอิงเหล่านี้อาจแก้ไขได้อย่างถูกต้องหรือไม่ก็ได้ ขึ้นอยู่กับแบบแผนการตั้งชื่อในพื้นที่ทํางาน
การผูกการขึ้นต่อกันทํางานอย่างไร
ภายในพื้นที่ทํางาน รายการจะอ้างอิงการขึ้นต่อกันโดยใช้รหัสออบเจ็กต์ เมื่อ Fabric ส่งออกรายการไปยัง Git จะแทนที่รหัสออบเจ็กต์เหล่านี้บางส่วนด้วยรหัสตรรกะจาก.platformไฟล์ เมื่อคุณซิงค์สาขา Git ไปยังพื้นที่ทํางานอื่น Fabric จะแก้ไขรหัสตรรกะเหล่านั้นกลับไปยังรหัสวัตถุที่ถูกต้องในพื้นที่ทํางานเป้าหมาย นี่คือสิ่งที่ทําให้การผูกการพึ่งพาทํางานได้
อย่างไรก็ตาม การอ้างอิงการขึ้นต่อกันทั้งหมดไม่ได้ถูกแทนที่ด้วย ID ตรรกะในระหว่างการส่งออก รายการที่เก็บรหัสออบเจ็กต์ในการแสดง Git ยังคงชี้ไปที่พื้นที่ทํางานเดิมหลังจากการซิงค์ และคุณจําเป็นต้องอัปเดตด้วยตนเองหรือผ่านการกําหนดพารามิเตอร์
Important
การผูกการขึ้นต่อกันจะใช้กับการอ้างอิงระหว่างรายการ Fabric ภายในพื้นที่ทํางานเดียวกันเท่านั้น ถ้ารายการอ้างอิงรายการ Fabric ในพื้นที่ทํางานอื่น การอ้างอิงนั้นจะใช้รหัสออบเจ็กต์และไม่ผูกโดยอัตโนมัติ การอ้างอิงถึง การเชื่อมต่อ (การเชื่อมต่อแหล่งข้อมูล เกตเวย์) จะไม่ผูกอัตโนมัติ ใช้ ไลบรารีตัวแปร ที่มีชุดค่าเฉพาะสภาพแวดล้อมเพื่อจัดการการอ้างอิงการเชื่อมต่อในสภาพแวดล้อมต่างๆ
ความเข้ากันได้ของการผูกการพึ่งพา
ตารางต่อไปนี้แสดงให้เห็นว่าการขึ้นต่อกันของรายการ Fabric แต่ละชนิดผูกอย่างถูกต้องเมื่อคุณปรับใช้ในพื้นที่ทํางานหรือไม่ ปัจจุบันบทความนี้ครอบคลุมพฤติกรรมการรวม Git เนื่องจากการผูกถูกกําหนดโดยวิธีที่แต่ละรายการจัดเก็บการอ้างอิงการขึ้นต่อกันในข้อกําหนด ลักษณะการทํางานเดียวกันนี้ใช้กับกลไกการปรับใช้อื่นๆ ที่นําคําจํากัดความเหล่านั้นกลับมาใช้ใหม่ เช่น ไปป์ไลน์การปรับใช้และ API การนําเข้า (จํานวนมาก)
ตารางเหล่านี้ถือว่าการขึ้นต่อกันเป็นรายการอื่นในพื้นที่ ทํางานเดียวกัน กับรายการต้นทาง การอ้างอิงไปยังรายการในพื้นที่ ทํางานอื่น จะไม่ผูกอัตโนมัติ โดยจะปักหมุดไว้ที่รหัสออบเจ็กต์ต้นทางโดยไม่คํานึงถึงค่าที่แสดงในตาราง
คอลัมน์ ผูกอัตโนมัติใน Git ระบุว่า:
- ใช่: ข้อกําหนดรายการใน Git จัดเก็บการอ้างอิงการขึ้นต่อกันเป็นรหัสตรรกะ เมื่อคุณซิงค์สาขาไปยังพื้นที่ทํางานใหม่ การอ้างอิงจะผูกกับรายการที่ตรงกันในพื้นที่ทํางานนั้นโดยอัตโนมัติ
- ไม่: คําจํากัดความของรายการใน Git จัดเก็บการอ้างอิงการขึ้นต่อกันเป็นรหัสอ็อบเจ็กต์ (GUID เฉพาะพื้นที่ทํางาน) การอ้างอิงยังคงชี้ไปยังพื้นที่ทํางานต้นทางหลังจากการซิงค์ คุณต้องอัปเดตหรือกําหนดพารามิเตอร์ด้วยตนเองสําหรับการปรับใช้ข้ามพื้นที่ทํางาน
- บางส่วน: รายการแก้ไขการขึ้นต่อกันตามชื่อหรือ URI ซึ่งอาจใช้ได้หากการตั้งชื่อสอดคล้องกันในพื้นที่ทํางาน
สมุดบันทึก
| การพึ่งพา | ผูกอัตโนมัติใน Git | หมายเหตุ |
|---|---|---|
| Lakehouse | ใช่ | ต้องเปิดใช้งาน "Lakehouse Auto-Binding in Git" ในการตั้งค่าโน้ตบุ๊ก เมื่อเปิดใช้งาน รหัสออบเจ็กต์จะถูกแทนที่ด้วยรหัสตรรกะในnotebook-settings.json การตั้งค่านี้ถูกตามค่าเริ่มต้น สําหรับข้อมูลเพิ่มเติม โปรดดู การผูกอัตโนมัติของ Lakehouse ใน Git |
| สิ่งแวดล้อม | ใช่ | |
| ฐานข้อมูลมิเรอร์ | ไม่ |
Note
การผูกโน้ตบุ๊คกับ Lakehouse ไม่ได้เปิดใช้งานตามค่าเริ่มต้น คุณต้องเปิดการตั้งค่า "Lakehouse Auto-Binding in Git" ในการตั้งค่าของสมุดบันทึกแต่ละเล่ม สําหรับข้อมูลเพิ่มเติม โปรดดู การควบคุมและการปรับใช้แหล่งที่มาของสมุดบันทึก
รายงาน
| การพึ่งพา | ผูกอัตโนมัติใน Git | หมายเหตุ |
|---|---|---|
| แบบจําลองความหมาย (จากรายงาน Power BI) | บางส่วน | รายงานอ้างอิงแบบจําลองผ่านการอ้างอิงสัมพัทธ์ byPath ใน definition.pbirไม่ใช่รหัสตรรกะที่ชัดเจน แก้ไขได้อย่างถูกต้องเมื่อโมเดลปรับใช้กับตําแหน่งสัมพัทธ์เดียวกันในพื้นที่ทํางานเป้าหมาย แต่ไม่ผูกผ่านรหัสตรรกะ สําหรับข้อมูลเพิ่มเติม โปรดดู โฟลเดอร์รายงานโครงการ Power BI Desktop |
| แบบจําลองความหมาย (จากรายงานที่มีการแบ่งหน้า) | ไม่ | สายอักขระการเชื่อมต่อ ของรายงานอ้างอิงแบบจําลองความหมายตามรหัสเฉพาะพื้นที่ทํางานที่ไม่ได้เขียนใหม่ในการปรับใช้ ดังนั้นจึงยังคงชี้ไปที่แบบจําลองต้นทาง คุณต้องอัปเดตการอ้างอิงนี้สําหรับการปรับใช้ข้ามพื้นที่ทํางาน (รายงานที่เขียนใน Report Builder ที่อ้างอิงแบบจําลองตามชื่ออาจแก้ไขตามชื่อที่แสดงแทน ซึ่งก็คือ บางส่วน) |
Pipeline
| การพึ่งพา | ผูกอัตโนมัติใน Git | หมายเหตุ |
|---|---|---|
| Pipeline | ใช่ | |
| โน้ตบุ๊ก | ใช่ | |
| ระบบการไหลเวียนข้อมูล Gen2 | ใช่ | |
| ฐานข้อมูล SQL | ใช่ | |
| ข้อกําหนดงาน Spark | ไม่ | กิจกรรม SparkJobDefinition อ้างอิง Spark Job Definition ตาม ID ออบเจ็กต์ ไม่ใช่ ID เชิงตรรกะ ดังนั้นจึงยังคงชี้ไปที่รายการต้นทางหลังจากการปรับใช้ คุณต้องกําหนดพารามิเตอร์ค่านี้สําหรับการปรับใช้ข้ามพื้นที่ทํางาน |
| Lakehouse | ใช่ | |
| แบบจําลองแสดงความหมาย | ไม่ | กิจกรรม PBISemanticModelRefresh อ้างอิงแบบจําลองความหมายตามรหัสรายการ ไม่ใช่รหัสตรรกะ คุณต้องกําหนดพารามิเตอร์ค่านี้สําหรับการปรับใช้ข้ามพื้นที่ทํางาน |
| คลังสินค้า | ไม่ | คลังสินค้า artifactId แก้ไขผ่านรหัสตรรกะและการผูกใหม่ แต่ยัง linkedService จัดเก็บ SQL endpointของพื้นที่ทํางานต้นทาง ซึ่งไม่ได้เขียนใหม่ กําหนดพารามิเตอร์สําหรับ endpoint การปรับใช้ข้ามพื้นที่ทํางาน |
แบบจําลองความหมาย
| การพึ่งพา | ผูกอัตโนมัติใน Git | หมายเหตุ |
|---|---|---|
| แบบจําลองแสดงความหมาย | บางส่วน | การอ้างอิงแบบจําลองแบบต่อเนื่องหรือแบบรวมใช้สตริงการเชื่อมต่อตามชื่อ |
| SQL Analytics Endpoint (เลคเฮาส์) | ไม่ | สตริง สายอักขระการเชื่อมต่อ Direct Lake ใน TMDL expressions.tmdl ประกอบด้วย URL ปลายทางเฉพาะพื้นที่ทํางานและ GUID ฐานข้อมูล คุณต้องแทนที่พารามิเตอร์เหล่านี้สําหรับการปรับใช้ข้ามพื้นที่ทํางาน |
| ฐานข้อมูล KQL | ไม่ | สายอักขระการเชื่อมต่อ ที่มี URI คลัสเตอร์ในนิพจน์ TMDL มีค่าเฉพาะพื้นที่ทํางาน |
| ฐานข้อมูล SQL | ไม่ | สายอักขระการเชื่อมต่อ ในนิพจน์ TMDL ประกอบด้วยค่าเฉพาะพื้นที่ทํางาน |
| คลังสินค้า | ไม่ | การเชื่อมต่อกับจุดสิ้นสุดการวิเคราะห์ SQL ของคลังสินค้าใช้ URL เฉพาะพื้นที่ทํางาน |
เลคเฮาส์
| การพึ่งพา | ผูกอัตโนมัติใน Git | หมายเหตุ |
|---|---|---|
| เลคเฮาส์ (ทางลัด) | ใช่ | ทางลัด OneLake ภายในที่ชี้ไปยังรายการ Fabric อื่น เช่น เลคเฮาส์หรือคลังสินค้า จะถูกจัดเก็บเป็นรหัสตรรกะและผูกใหม่กับรายการพื้นที่ทํางานเป้าหมาย ทางลัดไปยังแหล่งข้อมูลภายนอก เช่น Azure Data Lake Storage รุ่น2 หรือ Amazon S3 ชี้ไปที่ภายนอก Fabric และดําเนินการอ้างอิงการเชื่อมต่อแทน ดังนั้นจึงไม่อยู่ภายใต้การผูกรหัสตรรกะ สําหรับรายการเป้าหมายทางลัดทั้งหมด โปรดดู ทางลัด OneLake สําหรับพฤติกรรมการปรับใช้ โปรดดู ไปป์ไลน์การรวมและการปรับใช้ Lakehouse Git |
กระแสข้อมูล (Gen2)
ตามค่าเริ่มต้น กระแสข้อมูล Gen2 จะสร้างการอ้างอิงแบบสัมบูรณ์ไปยังรายการ Fabric: คิวรีจะจัดเก็บรหัสพื้นที่ทํางานต้นทางและรหัสออบเจ็กต์ของรายการ ซึ่งจะไม่ถูกเขียนใหม่ในการปรับใช้ การอ้างอิงแหล่งที่มาสามารถใช้การอ้างอิงแบบสัมพัทธ์แทนได้: เมื่อคุณเลือกรายการภายใต้ !( พื้นที่ทํางานปัจจุบัน) ในตัวเชื่อมต่อ Fabric คิวรีจะจัดเก็บรายการตามชื่อ (ไม่มี GUID) และแก้ไขเป็นรายการที่ตรงกันในพื้นที่ทํางานเป้าหมายในการปรับใช้ ปลายทางเอาต์พุตจะใช้การอ้างอิงแบบสัมบูรณ์เสมอและไม่ผูกใหม่ สําหรับปลายทาง และสําหรับการอ้างอิงแหล่งที่มาแบบสัมบูรณ์ใดๆ ให้ตั้งค่าพารามิเตอร์สําหรับการปรับใช้ข้ามพื้นที่ทํางาน สําหรับข้อมูลเพิ่มเติม โปรดดู การอ้างอิงสัมพัทธ์กับตัวเชื่อมต่อ Fabric ใน Dataflow Gen2 และ Dataflow Gen2 ที่มีการรวม CI/CD และ Git
การอ้างอิงแหล่งที่มา:
| การพึ่งพา | ผูกอัตโนมัติใน Git | หมายเหตุ |
|---|---|---|
| Lakehouse | บางส่วน | ผูกใหม่เฉพาะเมื่อเขียนเป็นการอ้างอิงแบบสัมพัทธ์ (!( พื้นที่ทํางานปัจจุบัน)); การอ้างอิงแบบสัมบูรณ์เริ่มต้นจะไม่ผูกใหม่ |
| คลังสินค้า | บางส่วน | ผูกใหม่เฉพาะเมื่อเขียนเป็นการอ้างอิงแบบสัมพัทธ์ (!( พื้นที่ทํางานปัจจุบัน)); การอ้างอิงแบบสัมบูรณ์เริ่มต้นจะไม่ผูกใหม่ |
การอ้างอิงปลายทาง:
| การพึ่งพา | ผูกอัตโนมัติใน Git | หมายเหตุ |
|---|---|---|
| Lakehouse | ไม่ | |
| คลังสินค้า | ไม่ | |
| ฐานข้อมูล SQL | ไม่ |
คําจํากัดความของ Spark Job
| การพึ่งพา | ผูกอัตโนมัติใน Git | หมายเหตุ |
|---|---|---|
| สิ่งแวดล้อม | ใช่ | |
| Lakehouse | ไม่ | ใช้ defaultLakehouseArtifactId รหัสอ็อบเจ็กต์ |
คัดลอกงาน
| การพึ่งพา | ผูกอัตโนมัติใน Git | หมายเหตุ |
|---|---|---|
| Lakehouse | ใช่ | |
| คลังสินค้า | ไม่ | คลังสินค้า artifactId แก้ไขผ่านรหัสตรรกะและการผูกใหม่ แต่ยัง linkedService จัดเก็บ SQL endPointของพื้นที่ทํางานต้นทาง ซึ่งไม่ได้เขียนใหม่ กําหนดพารามิเตอร์สําหรับ endPoint การปรับใช้ข้ามพื้นที่ทํางาน |
| ฐานข้อมูล SQL | ใช่ |
GraphQL API
| การพึ่งพา | ผูกอัตโนมัติใน Git | หมายเหตุ |
|---|---|---|
| จุดสิ้นสุด SQL | ใช่ | |
| คลังสินค้า | ใช่ | |
| ฐานข้อมูล SQL | ใช่ |
สําหรับแหล่งข้อมูล GraphQL API ทั้งหมด คุณอาจต้องกําหนดค่าการเชื่อมต่อและข้อมูลประจําตัวใหม่หลังจากการปรับใช้
สตรีมเหตุการณ์
| การพึ่งพา | ผูกอัตโนมัติใน Git | หมายเหตุ |
|---|---|---|
| Lakehouse | ใช่ | |
| Eventhouse | ใช่ | ปลายทางทั้งหมดได้รับการสนับสนุนอย่างเต็มที่สําหรับ CI/CD เมื่อรายการอยู่ในพื้นที่ทํางานเดียวกัน สําหรับ Eventhouse ที่มีโหมดการนําเข้าโดยตรง คุณอาจต้องกําหนดค่าการเชื่อมต่อใหม่ด้วยตนเองหลังจากการปรับใช้ หากต้องการข้อมูลเพิ่มเติม โปรดดู Eventstream CI/CD |
| ตัวกระตุ้น (สะท้อนกลับ) | ใช่ | ปลายทางทั้งหมดได้รับการสนับสนุนอย่างเต็มที่สําหรับ CI/CD เมื่อรายการอยู่ในพื้นที่ทํางานเดียวกัน หากต้องการข้อมูลเพิ่มเติม โปรดดู Eventstream CI/CD |
รายการ KQL
| การพึ่งพา | ผูกอัตโนมัติใน Git | หมายเหตุ |
|---|---|---|
| ฐานข้อมูล KQL ไปยัง eventhouse | ใช่ |
parentEventhouseItemId in DatabaseProperties.json เป็น ID เชิงตรรกะและผูกกับอีเวนต์เฮาส์เป้าหมาย ฐานข้อมูล KQL ปรับใช้เป็นลูกของบ้านเหตุการณ์หลัก |
| ชุดแบบสอบถาม KQL ไปยังฐานข้อมูล KQL | บางส่วน | แก้ไขผ่าน clusterUri และ databaseNameไม่ใช่ ID สินค้า คําจํากัดความประกอบด้วย แต่ databaseItemIdเป็นรหัสออบเจ็กต์ที่ไม่ผูกใหม่ ดังนั้นความละเอียดจึงขึ้นอยู่กับ URI ในสภาพแวดล้อมต่างๆ |
| แดชบอร์ด Real-Time ไปยังฐานข้อมูล KQL | บางส่วน | ใช้ dataSources อาร์เรย์ที่มี URI คลัสเตอร์ รูปแบบเดียวกับชุดคิวรี KQL |
คลังสินค้า
| การพึ่งพา | ผูกอัตโนมัติใน Git | หมายเหตุ |
|---|---|---|
| คลังสินค้า (การอ้างอิงโยง) | ไม่ | การอ้างอิงไปยังคลังสินค้าอื่นใช้รหัสออบเจ็กต์ |
| จุดสิ้นสุด SQL | ไม่ | การอ้างอิงปลายทาง SQL ใช้ตัวระบุเฉพาะพื้นที่ทํางาน |
ไลบรารีตัวแปร
| การพึ่งพา | ผูกอัตโนมัติใน Git | หมายเหตุ |
|---|---|---|
| รายการ Fabric (ประเภท ItemReference) | ไม่ | ประเภทตัวแปร ItemReference จะจัดเก็บ workspaceId และเป็น itemId GUID ดิบ คุณต้องอัปเดตหรือแทนที่ค่าเหล่านี้ด้วยตนเองผ่านชุดค่าต่อสภาพแวดล้อม |
รายการที่ไม่มีการขึ้นต่อกัน
รายการต่อไปนี้ไม่มีข้อกังวลเกี่ยวกับการผูกการขึ้นต่อกันข้ามพื้นที่ทํางาน:
- สิ่งแวดล้อม
- ฐานข้อมูล SQL
- Eventhouse (รายการคอนเทนเนอร์ ฐานข้อมูล KQL อ้างอิง)
- ฐานข้อมูลมิเรอร์ (การกําหนดค่าแหล่งข้อมูลภายนอกเท่านั้น)
Summary
เมื่อคุณปรับใช้รายการ Fabric ในพื้นที่ทํางาน การขึ้นต่อกันระหว่างรายการอาจหยุดทํางานได้หากการอ้างอิงถูกจัดเก็บเป็นรหัสออบเจ็กต์เฉพาะพื้นที่ทํางานแทนรหัสตรรกะแบบพกพา รายการบางชนิดไม่รองรับการผูกการขึ้นต่อกันผ่านรหัสตรรกะ ก่อนที่คุณจะตั้งค่าการปรับใช้ข้ามพื้นที่ทํางาน ให้ตรวจสอบตารางความเข้ากันได้ในบทความนี้เพื่อระบุว่าการขึ้นต่อกันใดที่ผูกโดยอัตโนมัติและต้องมีการกําหนดพารามิเตอร์ด้วยตนเอง