Bagikan melalui

Membuat buku catatan berparameter dengan menggunakan tindakan Jalankan dengan Parameter

  • Artikel

Parameterisasi di Azure Data Studio menjalankan notebook yang sama dengan sekumpulan parameter yang berbeda.

Artikel ini memperlihatkan kepada Anda cara membuat dan menjalankan notebook berparameter di Azure Data Studio dengan menggunakan kernel Python.

Catatan

Saat ini, Anda dapat menggunakan parameterisasi dengan kernel Python, PySpark, PowerShell, dan .NET Interactive.

Prasyarat

Jalankan dengan tindakan Parameter

Saat Anda menggunakan tindakan Jalankan dengan notebook Parameter, pengguna dapat memasukkan parameter baru di UI untuk mengatur parameter baru dengan cepat untuk notebook Anda. Pengguna kemudian dapat menjalankan notebook dengan parameter baru.

Catatan

Penting untuk memformat sel parameter dengan setiap parameter baru pada baris baru.

Contoh parameterisasi

Anda bisa menggunakan contoh file buku catatan untuk menelusuri langkah-langkah dalam artikel ini:

  1. Buka file buku catatan di GitHub. Pilih Mentah.
  2. Pilih Ctrl+S atau klik kanan, lalu simpan file dengan ekstensi .ipynb.
  3. Buka file di Azure Data Studio.

Menyiapkan buku catatan untuk parameterisasi

Anda bisa memulai dengan contoh buku catatan yang terbuka di Azure Data Studio atau menyelesaikan langkah-langkah berikut untuk membuat buku catatan. Kemudian, coba gunakan parameter yang berbeda. Semua langkah berjalan di dalam buku catatan Azure Data Studio.

  1. Buat notebook baru. Ubah Kernel menjadi Python 3:

    Screenshot that shows the New notebook menu option and setting the Kernel value to Python 3.

  2. Jika Anda diminta untuk meningkatkan paket Python saat paket Anda perlu diperbarui, pilih Ya:

    Screenshot that shows the dialog prompt to update Python packages.

  3. Verifikasi bahwa Kernel diatur ke Python 3:

    Screenshot that shows the Kernel value to Python 3.

  4. Buat sel kode baru. Pilih Parameter untuk menandai sel sebagai sel parameter.

    x = 2.0
y = 5.0

    Screenshot that shows creating a new parameters cell with Parameters selected.

  5. Tambahkan sel lain untuk menguji parameter yang berbeda:

    addition = x + y
multiply = x * y

    print("Addition: " + str(addition))
print("Multiplication: " + str(multiply))

    Hasilnya akan terlihat mirip dengan contoh ini:

    Screenshot that shows the output of cells added to test new parameters.

  6. Simpan buku catatan sebagai Input.ipynb:

    Screenshot that shows saving the notebook file.

Menjalankan buku catatan dengan parameter

  1. Pada toolbar buku catatan, pilih ikon Jalankan dengan Parameter :

    Screenshot that shows the Run with Parameters icon selected on the toolbar.

  2. Serangkaian dialog baru meminta Anda untuk memasukkan parameter baru untuk x dan y:

    Screenshot that shows entering a new parameter for x.

    Screenshot that shows entering a new parameter for y.

  3. Setelah Anda memasukkan parameter baru, lihat buku catatan parameter baru. Pada toolbar, pilih Jalankan semua untuk menjalankan semua sel dan melihat output baru. Sel baru berlabel # Injected-Parameters berisi nilai parameter baru yang diteruskan:

    Screenshot that shows the output for new parameters.

Langkah berikutnya

Pelajari selengkapnya tentang buku catatan dan parameterisasi: