NotebookUtils (mantan MSSparkUtils) untuk Fabric

Notebook Utilities (NotebookUtils) adalah paket bawaan untuk membantu Anda dengan mudah melakukan tugas umum di notebook di Microsoft Fabric. Anda dapat menggunakan NotebookUtils untuk bekerja dengan sistem file, mendapatkan variabel lingkungan, menghubungkan buku catatan secara berantai, dan mengelola rahasia. Paket NotebookUtils tersedia di PySpark (Python), Scala, notebook SparkR, dan alur Fabric.

Note

  • MsSparkUtils secara resmi diganti namanya menjadi NotebookUtils. Kode yang ada tetap kompatibel ke belakang dan tidak menyebabkan perubahan yang merusak. Sangat disarankan untuk memutakhirkan ke notebookutils untuk memastikan dukungan dan akses berkelanjutan ke fitur baru. Namespace mssparkutils akan dihentikan nantinya.
  • NotebookUtils dirancang untuk bekerja dengan Spark 3.4 (Runtime v1.2) ke atas. Semua fitur dan pembaruan baru didukung secara eksklusif dengan namespace notebookutils mulai sekarang.

Modul NotebookUtils

NotebookUtils menyediakan modul berikut. Pilih modul untuk melihat dokumentasi terperinci, contoh kode, dan praktik terbaik.

Modul Namespace Deskripsi
Utilitas sistem file notebookutils.fs Bekerja dengan file dan direktori di seluruh penyimpanan ADLS Gen2, Azure Blob Storage, dan Lakehouse. Termasuk operasi salin, pindahkan, baca, tulis, hapus, dan daftar.
Pemasangan dan pelampiran file notebookutils.fs Pasang penyimpanan jarak jauh (ADLS Gen2) ke simpul Spark sebagai mount point lokal untuk akses file yang disederhanakan.
Pemrosesan dan orkestrasi Notebook notebookutils.notebook Jalankan dan gabungkan notebook bersama-sama, termasuk eksekusi paralel dengan dukungan DAG, referensi antar ruang kerja, dan nilai hasil.
Manajemen buku catatan notebookutils.notebook Buat, dapatkan, perbarui, hapus, dan daftar artefak buku catatan secara terprogram.
Utilitas kredensial notebookutils.credentials Dapatkan token akses untuk layanan Azure dan ambil rahasia dari Azure Key Vault.
Utilitas Lakehouse notebookutils.lakehouse Membuat, mendapatkan, memperbarui, menghapus, dan mengelola item dan tabel Lakehouse secara terprogram.
Konteks runtime notebookutils.runtime Akses informasi konteks sesi termasuk nama buku catatan, detail ruang kerja, dan konteks eksekusi.
Manajemen sesi notebookutils.session Hentikan sesi interaktif dan mulai ulang penerjemah Python.
Utilitas Fungsi Data Pengguna (UDF) notebookutils.udf Mengambil dan memanggil Fungsi Data Pengguna dari buku catatan.
Utilitas pustaka variabel notebookutils.variableLibrary Akses variabel dan konfigurasi yang dikelola secara terpusat dari item Pustaka Variabel.

Untuk mendapatkan gambaran umum semua modul dan metode yang tersedia, jalankan:

notebookutils.help()

Untuk mendapatkan bantuan untuk modul tertentu, jalankan:

notebookutils.fs.help()
notebookutils.notebook.help()
notebookutils.credentials.help()

Masalah yang diketahui

  • Saat menggunakan versi runtime di atas 1.2 dan menjalankan notebookutils.help(), API fabricClient dan PBIClient yang tercantum belum didukung, tetapi akan tersedia dalam rilis mendatang.

Konten terkait

  • Last updated on