Mengubah data dengan menjalankan buku catatan

Gunakan aktivitas Notebook untuk menjalankan notebooks Anda buat di Microsoft Fabric sebagai bagian dari alur Data Factory Anda. Notebook memungkinkan Anda menjalankan pekerjaan Apache Spark untuk membawa, membersihkan, atau mengubah data Anda sebagai bagian dari alur kerja data Anda. Sangat mudah untuk menambahkan aktivitas Notebook ke alur Anda di Fabric, dan panduan ini memandu Anda melalui setiap langkah.

Prasyarat

Untuk memulai, Anda harus menyelesaikan prasyarat berikut:

• Anda harus memiliki akses ke penyewa Microsoft Fabric dengan kapasitas yang disediakan. Anda dapat coba Fabric dengan uji coba gratis.
• Ruang kerja Fabric ditetapkan ke kapasitas tersebut.

• Buku catatan dibuat di ruang kerja Anda. Untuk membuat buku catatan baru, lihat Cara membuat buku catatan Microsoft Fabric.

Membuat aktivitas buku catatan

1. Buat alur baru di ruang kerja Anda.

2. Cari Notebook di panel Activities alur, dan pilih untuk menambahkannya ke kanvas alur.

   

3. Pilih aktivitas Notebook baru di kanvas jika belum dipilih sebelumnya.

   

   Lihat panduan Pengaturan umum untuk mengonfigurasi tab Pengaturan umum.

Mengonfigurasi pengaturan buku catatan

Pilih tab Pengaturan.

Di bawah Koneksi, pilih metode autentikasi untuk buku catatan yang dijalankan dan berikan kredensial yang diperlukan.

Pilih buku catatan yang sudah ada dari menu dropdown Notebook , dan secara opsional tentukan parameter apa pun untuk diteruskan ke buku catatan.

Menggunakan Identitas Ruang Kerja Fabric (WI) dalam aktivitas Notebook

1. Membuat Identitas Ruang Kerja

   Anda harus mengaktifkan WI di ruang kerja Anda (mungkin perlu waktu sejenak untuk memuat). Buat Identitas Ruang Kerja di ruang kerja Fabric Anda. Perhatikan bahwa WI harus dibuat di ruang kerja yang sama dengan Alur Anda.

   Lihat dokumen pada Identitas Ruang Kerja.

2. Mengaktifkan pengaturan tingkat penyewa

   Aktifkan pengaturan penyewa berikut (dinonaktifkan secara default): Prinsipal layanan dapat memanggil API publik Fabric.

   Anda dapat mengaktifkan pengaturan ini di portal admin Fabric. Untuk informasi selengkapnya tentang pengaturan ini, lihat artikel tentang mengaktifkan autentikasi prinsipal layanan untuk API admin.

3. Memberikan izin ruang kerja ke Identitas Ruang Kerja

   Buka ruang kerja, pilih Kelola akses, dan tetapkan izin ke Identitas Ruang Kerja. Akses kontributor cukup untuk sebagian besar skenario. Jika Notebook Anda tidak berada di ruang kerja yang sama dengan Pipa Anda, Anda harus memberikan hak akses Kontributor pada WI yang Anda buat di ruang kerja Pipa Anda ke ruang kerja Notebook Anda.

   Lihat dokumen di Memberi pengguna akses ke ruang kerja.

Mengisi parameter dasar secara otomatis untuk aktivitas Notebook

Mengisi parameter dasar secara otomatis menemukan parameter yang ditentukan dalam buku catatan dan mengisinya ke dalam aktivitas Notebook selama penulisan alur. Fitur ini mengurangi konfigurasi manual, mencegah kesalahan, dan menjaga alur tetap selaras dengan logika buku catatan.

Prasyarat

• Buku catatan Anda harus menyertakan sel parameter.
• Hanya variabel yang ditentukan dalam sel ini yang terdeteksi sebagai parameter.

Cara kerjanya

Saat Anda memilih buku catatan dalam aktivitas Buku Catatan:

• Sistem secara otomatis mengambil parameter dari buku catatan saat Anda beralih ke parameter Dasar di Pengaturan.
• Bagian Parameter dasar diisi dengan:
  • Names
  • Jenis
  • Nilai baku

Anda dapat meninjau parameter yang diisi otomatis dan (opsional) mengambil alih nilai parameter.

Perilaku utama

• Parameter terisi otomatis saat Anda memilih buku catatan.
• Mengganti buku catatan akan menyegarkan daftar parameter.
• Tidak ada sel parameter → tidak ada parameter yang diisi.

Mengatur tag sesi

Untuk meminimalkan jumlah waktu yang diperlukan untuk menjalankan pekerjaan notebook Anda, Anda dapat secara opsional mengatur tag sesi. Mengatur tag sesi menginstruksikan Spark untuk menggunakan kembali sesi Spark yang ada, meminimalkan waktu mulai. Nilai string arbitrer apa pun dapat digunakan untuk tag sesi. Jika tidak ada sesi, sesi baru akan dibuat menggunakan nilai tag.

Catatan

Agar dapat menggunakan tag sesi, opsi Mode Konkurensi Tinggi untuk alur proses yang menjalankan beberapa notebook harus diaktifkan. Opsi ini dapat ditemukan di bawah mode Konkurensi tinggi untuk pengaturan Spark di bawah pengaturan Ruang Kerja

Simpan dan jalankan atau jadwalkan alur

Beralih ke tab Beranda di bagian atas editor alur dan pilih tombol simpan untuk menyimpan alur Anda. Pilih Jalankan untuk menjalankannya secara langsung atau Jadwalkan untuk menjadwalkan eksekusi pada waktu atau interval tertentu. Untuk informasi selengkapnya tentang proses alur, lihat: menjadwalkan proses alur.

Setelah berjalan, Anda dapat memantau eksekusi alur dan melihat riwayat eksekusi dari tab Output di bawah kanvas.

Masalah yang diketahui

• Menggunakan Service Principal untuk menjalankan notebook yang berisi kode Semantic Link memiliki batasan fungsi dan hanya mendukung sebagian fitur tautan semantik. Lihat fungsi tautan semantik yang didukung untuk detailnya. Untuk menggunakan kemampuan lain, Anda disarankan untuk mengautentikasi tautan semantik secara manual dengan perwakilan layanan.
• Aktivitas Notebook tidak mendukung pemanggilan notebook lintas wilayah.

Konten terkait

• Cara memantau jalannya pipa