Bagikan melalui

Pengeditan dasar di buku catatan Databricks

  • Artikel

Notebook Databricks adalah editor kode berbasis web yang memungkinkan Anda menulis kode dan melihat hasil untuk analisis data interaktif. Halaman ini membahas dasar-dasar penggunaan notebook pada Databricks, termasuk beberapa langkah untuk menavigasi toolbar dan melakukan berbagai tindakan pada sel.

Membuat buku catatan

Untuk membuat buku catatan baru, klik tombol Baru di bilah samping ruang kerja atau Buat buku catatan di folder mana pun.

Membuka buku catatan

Untuk membuka buku catatan, gunakan ruang kerja fungsi Pencarian atau gunakan browser ruang kerja untuk menavigasi ke buku catatan dan klik nama atau ikon buku catatan.

Sel buku catatan

Notebook berisi kumpulan dua jenis sel: sel kode dan sel Markdown. Sel kode berisi kode yang dapat dijalankan. Sel markdown berisi kode Markdown yang dirender sebagai teks dan grafik. Gunakan Markdown untuk mendokumen atau mengilustrasikan kode Anda. Anda bisa menambahkan atau menghapus sel dari salah satu jenis ke buku catatan Anda untuk menyusun pekerjaan Anda.

Anda bisa menjalankan satu sel, sekelompok sel, atau seluruh buku catatan. Sel buku catatan dapat berisi paling banyak 10MB, dan outputnya dibatasi hingga 20 MB.

ikon dan tombol pada toolbar Notebook

Toolbar menyertakan menu dan ikon yang bisa Anda gunakan untuk mengelola dan mengedit buku catatan.

Toolbar Buku Catatan

Di samping nama buku catatan adalah tombol untuk mengubah bahasa default buku catatan dan, jika buku catatan disertakan dalam folder Databricks Git, membuka dialog Git.

Untuk menampilkan versi sebelumnya dari buku catatan, klik "Suntingan terakhir..." pesan di sebelah kanan menu.

Ikon dan tombol di sebelah kanan toolbar dijelaskan dalam tabel berikut:

Ikon Deskripsi
tombol Jalankan Semua tombol Hentikan Eksekusi Jalankan semua sel atau hentikan eksekusi. Nama tombol ini berubah tergantung pada status buku catatan.
Pemilih komputasi header buku catatan Buka pengatur komputasi . Saat buku catatan tersambung ke kluster atau gudang SQL, tombol ini memperlihatkan nama sumber daya komputasi.
Penjadwal tugas header notebook Buka penjadwal pekerjaan.
Pemilih DLT header Notebook Buka DLT. Tombol ini hanya muncul jika buku catatan adalah bagian dari alur DLT.
tombol berbagi pada header Notebook Buka dialog izin .

Beberapa tindakan tersedia dari bilah sisi kanan buku catatan, seperti yang dijelaskan dalam tabel berikut ini:

Ikon Deskripsi
ikon komentar header Notebook Buka komentar buku catatan .
ikon eksperimen header buku catatan Buka eksperimen notebook MLflow.
ikon riwayat versi buku catatan Buka riwayat versi notebook .
Penjelajah Variabel Notebook Buka penjelajah variabel. (Tersedia untuk variabel Python dengan Databricks Runtime 12.2 LTS ke atas.)
lingkungan notebook Buka panel lingkungan Python. Panel ini memperlihatkan semua pustaka Python yang tersedia untuk notebook, termasuk pustaka yang khusus untuk notebook, pustaka kluster, dan pustaka yang disertakan dalam Databricks Runtime. Hanya tersedia saat notebook terhubung ke kluster.

Membuat sel

Notebook memiliki dua jenis sel: kode dan Markdown. Konten sel Markdown dirender ke dalam HTML. Misalnya, cuplikan ini berisi markup untuk judul tingkat satu:

%md ### Libraries
Import the necessary libraries.

Ditampilkan seperti yang ditunjukkan:

contoh Markdown yang dirender

Untuk membuat sel baru, arahkan mouse ke atas sel di bagian atas atau bawah. Klik Kode atau Teks untuk membuat kode atau sel Markdown.

tombol untuk membuat sel baru

Tindakan sel

Menu tindakan sel memungkinkan Anda menjalankan, memotong, dan menyalin sel, memindahkan sel di sekitar buku catatan, dan menyembunyikan kode atau hasil.

Jalankan sel

Untuk menjalankan sel kode, klik panah bawah di kiri atas sel kode.

menu menjalankan sel

Setelah sel dijalankan, pemberitahuan muncul di sebelah kanan menu jalankan sel, memperlihatkan terakhir kali sel dijalankan dan durasinya. Arahkan kursor Anda ke atas pemberitahuan untuk detail selengkapnya.

Untuk menampilkan informasi eksekusi terperinci secara default, klik gambar profil Anda di kanan atas. Kemudian klik Pengaturan >Pengembang>Tampilkan informasi eksekusi perintah terperinci.

gambar hasil proses terakhir

Jika Anda memiliki output hasil tabular, Anda juga dapat mengakses informasi ini dengan mengarahkan mouse ke bagian "Terakhir diperbarui" antarmuka pengguna.

Jalankan sel terpilih

Anda dapat menjalankan sel tunggal atau kumpulan sel. Untuk memilih sel tunggal, klik di mana saja di dalam sel. Untuk memilih beberapa sel, tahan tombol Command di MacOS atau tombol Ctrl di Windows, dan klik sel di luar area teks seperti yang ditunjukkan pada cuplikan layar.

cara memilih beberapa sel

Untuk menjalankan sel yang dipilih, klik Jalankan>Jalankan dan debug>Jalankan sel yang dipilih atau gunakan pintasan keyboard Command + Enter di MacOS atau Crtl + Enter di Windows. Perilaku perintah ini tergantung pada sumber daya komputasi tempat buku catatan dilampirkan.

  • Pada sumber daya komputasi yang menjalankan Databricks Runtime 13.3 LTS atau di bawahnya, sel yang dipilih dijalankan satu per satu. Jika terjadi kesalahan dalam sel, eksekusi berlanjut dengan sel berikutnya.
  • Pada sumber daya komputasi yang menjalankan Databricks Runtime 14.0 atau lebih tinggi, atau pada gudang SQL, sel yang dipilih dijalankan sebagai batch. Kesalahan apa pun menghentikan eksekusi, dan Anda tidak dapat membatalkan eksekusi sel individual. Anda dapat menggunakan tombol Interupsi untuk menghentikan eksekusi semua sel.

Jalankan teks yang dipilih

Anda dapat menyoroti kode atau pernyataan SQL di sel buku catatan dan hanya menjalankan kode yang disorot. Ini berguna ketika Anda ingin dengan cepat melakukan iterasi pada kode dan kueri.

  1. Pilih baris yang ingin Anda jalankan.

  2. Pilih Jalankan > Jalankan teks yang dipilih atau gunakan pintasan keyboard Ctrl+Shift+Enter. Jika tidak ada teks yang disorot, Jalankan Teks Terpilih menjalankan baris saat ini.

    jalankan baris yang dipilih

Jika Anda menggunakan bahasa campuran dalam sel, Anda harus menyertakan baris %<language> dalam pilihan.

Jalankan teks yang dipilih juga menjalankan kode yang diciutkan, jika ada dalam pilihan yang terpilih.

Perintah sel khusus seperti %run, %pip, dan %sh didukung.

Anda tidak dapat menggunakan Jalankan teks terpilih pada sel yang memiliki beberapa tab output (yaitu, sel tempat Anda menentukan profil data atau visualisasi).

Ikon sel

Cuplikan layar berikut ini menjelaskan ikon yang muncul di kanan atas sel buku catatan:

ikon sel kanan atas

pemilih bahasa : Pilih bahasa untuk sel.

Asisten Databricks: Aktifkan atau nonaktifkan Asisten Databricks untuk saran kode dalam sel.

Fokus sel: Memperbesar sel untuk mempermudah pengeditan.

Tampilkan menu tindakan sel: Buka menu tindakan sel. Opsi dalam menu ini sedikit berbeda untuk kode dan sel Markdown.

Menu Tindakan Sel

Menghapus sel

Untuk menghapus sel, klik ikon sampah di sebelah kanan sel. Ikon ini hanya muncul saat Anda mengarahkan kursor ke sel.

ikon tempat sampah sel

Memindahkan sel

Untuk memindahkan sel ke atas atau ke bawah, klik dan tahan ikon gagang seret pindahkan ikon sel ke kiri sel.

menyeret sel ke atas atau ke bawah

Anda juga dapat memilih Pindah ke atas atau Pindahkan ke bawah dari menu tindakan sel.

Memotong, menyalin, dan menempelkan sel

Ada beberapa opsi untuk memotong dan menyalin sel. Namun, jika Anda menggunakan browser Safari, hanya pintasan keyboard yang tersedia.

  • Dari menu tindakan sel pilih Potong sel atau Salin sel.
  • Gunakan pintasan keyboard: Command-X atau Ctrl-X untuk memotong dan Command-C atau Ctrl-C untuk disalin.
  • Gunakan menu Edit di bagian atas buku catatan. Pilih Potong atau Salin.

Setelah memotong atau menyalin sel, Anda bisa menempelkan sel tersebut di tempat lain di buku catatan, ke buku catatan lain, atau buku catatan di tab atau jendela browser lain. Untuk menempelkan sel, gunakan pintasan keyboard Command-V atau Ctrl-V. Sel-sel ditempelkan di bawah sel saat ini.

Untuk membatalkan tindakan potong atau tempel, Anda bisa menggunakan pintasan keyboard Command-Z atau Ctrl-Z atau opsi menu Edit > Batalkan pemotongan sel atau Edit > Batalkan sel tempel.

Untuk memilih sel yang berdekatan, klik sel Markdown lalu gunakan Shift + Atas atau Bawah untuk memilih sel di atas atau di bawahnya. Gunakan menu edit untuk menyalin, memotong, menempelkan, atau menghapus sel yang dipilih sebagai grup. Untuk memilih semua sel, pilih Edit > Pilih semua sel atau gunakan pintasan mode perintah Cmd+A.

Menambahkan komentar kode

Untuk menambahkan komentar ke kode dalam sel, sorot kode. Di sebelah kanan sel, ikon komentar muncul. Klik ikon untuk membuka kotak komentar.

ikon komentar

Menambahkan sel ke papan kendali

Untuk menambahkan sel Markdown atau sel yang memiliki hasil tabular ke dasbor, pilih Tambahkan ke dasbor dari menu tindakan sel. Untuk informasi selengkapnya, lihat Dasbor di buku catatan.

Untuk mendapatkan tautan URL ke perintah tertentu di buku catatan Anda, klik ikon fokus sel untuk membuka mode fokus dan menyalin URL dari bilah alamat browser. Untuk keluar dari mode fokus, klik keluar dari ikon fokus sel.

Buka Asisten Databricks tersebut

Untuk membuka kotak teks Asisten Databricks dalam sel, klik ikon Asisten Databricks ikon Asisten Databricks di sudut kanan atas sel.

Anda dapat menggunakannya dalam sel kode untuk mendapatkan bantuan atau saran untuk kode Anda. Asisten Databricks harus diaktifkan di ruang kerja Anda.