หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
Notebook Utilities (NotebookUtils) เป็นแพคเกจในตัวเพื่อช่วยให้คุณทํางานทั่วไปได้อย่างง่ายดายใน Fabric Notebook คุณสามารถใช้ NotebookUtils เพื่อทํางานกับระบบไฟล์ เพื่อรับตัวแปรสภาพแวดล้อม เพื่อเกี่ยวโยงสมุดบันทึกเข้าด้วยกัน และทํางานกับข้อมูลลับ แพคเกจ NotebookUtils มีให้ใช้งานใน PySpark (Python) Scala, SparkR notebooks และ Fabric pipelines
Note
- MsSparkUtils ถูกเปลี่ยนชื่อเป็น NotebookUtils อย่างเป็นทางการ โค้ดที่มีอยู่ยังคงเข้ากันได้แบบ ย้อนหลัง และไม่ก่อให้เกิดการเปลี่ยนแปลงที่เสียหาย ขอ แนะนํา อย่างยิ่งให้อัปเกรดเป็นโน้ตบุ๊คยูทิลิตี้เพื่อให้แน่ใจว่าได้รับการสนับสนุนอย่างต่อเนื่องและเข้าถึงคุณสมบัติใหม่ๆ เนมสเปซ mssparkutils จะถูกยกเลิกในอนาคต
- NotebookUtils ได้รับการออกแบบมาเพื่อทํางานร่วมกับ Spark 3.4 (รันไทม์ v1.2) ขึ้นไป คุณลักษณะและการอัปเดตใหม่ทั้งหมดได้รับการสนับสนุนเฉพาะกับเนมสเปซ notebookutils ในอนาคต
โมดูล NotebookUtils
NotebookUtils มีโมดูลต่อไปนี้ เลือกโมดูลเพื่อดูเอกสารประกอบโดยละเอียด ตัวอย่างโค้ด และแนวทางปฏิบัติที่ดีที่สุด
| โมดูล | Namespace | คำอธิบาย |
|---|---|---|
| ยูทิลิตี้ระบบไฟล์ | notebookutils.fs |
ทํางานกับไฟล์และไดเรกทอรีใน ADLS Gen2, Azure Blob Storage และที่เก็บข้อมูล Lakehouse รวมถึงการดําเนินการคัดลอก ย้าย อ่าน เขียน ลบ และแสดงรายการ |
| การเมานต์และยกเลิกการต่อเชื่อมไฟล์ | notebookutils.fs |
แนบที่เก็บข้อมูลระยะไกล (ADLS Gen2) กับโหนด Spark เป็นจุดต่อเชื่อมในเครื่องเพื่อการเข้าถึงไฟล์ที่ง่ายขึ้น |
| การเรียกใช้โน้ตบุ๊กและการประสานงาน | notebookutils.notebook |
เรียกใช้และเชื่อมโยงสมุดบันทึกเข้าด้วยกัน รวมถึงการดําเนินการแบบขนานด้วยการสนับสนุน DAG การอ้างอิงข้ามพื้นที่ทํางาน และค่าออก |
| การจัดการโน้ตบุ๊ค | notebookutils.notebook |
สร้าง รับ อัปเดต ลบ และแสดงรายการสิ่งประดิษฐ์สมุดบันทึกโดยทางโปรแกรม |
| ยูทิลิตี้ข้อมูลประจําตัว | notebookutils.credentials |
รับโทเค็นการเข้าถึงสําหรับบริการ Azure และดึงข้อมูลลับจาก Azure Key Vault |
| สาธารณูปโภคเลคเฮาส์ | notebookutils.lakehouse |
สร้าง รับ อัปเดต ลบ และจัดการรายการและตาราง Lakehouse โดยทางโปรแกรม |
| บริบทรันไทม์ | notebookutils.runtime |
เข้าถึงข้อมูลบริบทของเซสชัน รวมถึงชื่อสมุดบันทึก รายละเอียดพื้นที่ทํางาน และบริบทการดําเนินการ |
| การจัดการเซสชัน | notebookutils.session |
หยุดเซสชันแบบโต้ตอบและรีสตาร์ทล่าม Python |
| ยูทิลิตี้ฟังก์ชันข้อมูลผู้ใช้ (UDF) | notebookutils.udf |
ดึงและเรียกใช้ฟังก์ชันข้อมูลผู้ใช้จากสมุดบันทึก |
| ยูทิลิตี้ไลบรารีตัวแปร | notebookutils.variableLibrary |
เข้าถึงตัวแปรและการกําหนดค่าที่มีการจัดการจากส่วนกลางจากรายการไลบรารีตัวแปร |
หากต้องการดูภาพรวมของโมดูลและวิธีการที่มีอยู่ทั้งหมด ให้เรียกใช้:
notebookutils.help()
หากต้องการรับความช่วยเหลือสําหรับโมดูลเฉพาะ ให้เรียกใช้:
notebookutils.fs.help()
notebookutils.notebook.help()
notebookutils.credentials.help()
ปัญหาที่ทราบกันดี
- เมื่อใช้เวอร์ชันรันไทม์ที่สูงกว่า 1.2 และเรียกใช้
notebookutils.help()API fabricClient และ PBIClient ที่ระบุไว้ยังไม่ได้รับการสนับสนุน แต่จะพร้อมใช้งานในรุ่นต่อๆ ไป