Arahkan buku catatan dan editor file di Databricks

Artikel ini menjelaskan fungsi yang tersedia untuk membantu Anda menavigasi buku catatan Databricks dan editor file, termasuk pintasan keyboard, saran kode dan pelengkapan otomatis, inspeksi variabel, dan pelipatan kode. Saat Anda menggunakan notebook atau editor file, Asisten Databricks tersedia untuk membantu Anda membuat, menjelaskan, dan men-debug kode. Lihat untuk mendapatkan bantuan pengkodean dari Asisten Databricks terkait detailnya.

Anda dapat memilih dari pilihan tema editor. Pilih Tampilkan tema Editor > dan buat pilihan dari menu.

Palet Perintah

Anda dapat dengan cepat melakukan tindakan di buku catatan menggunakan palet perintah. Untuk membuka panel tindakan buku catatan, klik di sudut kanan bawah ruang kerja atau gunakan pintasan Cmd + Shift + P di MacOS atau Ctrl + Shift + P di Windows.

Peta mini eksekusi sel

Untuk mendapatkan gambaran umum visual status eksekusi buku catatan Anda, gunakan minimap eksekusi sel. Peta mini muncul di margin kanan dan memperlihatkan bilah status untuk setiap sel yang dapat dieksekusi.

Bilah status menunjukkan status eksekusi berikut:

• Abu-abu muda: Sel statis.
• Abu-abu tua: Sel dilewati atau diantrekan untuk dieksekusi.
• Abu-abu muda dengan bilah bergerak: Sel saat ini sedang berjalan.
• Hijau: Sel berhasil dijalankan tanpa kesalahan.
• Merah: Sel gagal dengan kesalahan.

Untuk berinteraksi dengan peta mini:

• Arahkan mouse ke atas peta mini untuk melihat daftar sel yang dapat dieksekusi, judulnya, dan status eksekusinya.
• Klik entri untuk melompat langsung ke sel tersebut di buku catatan.
• Klik Buka sel yang terakhir dijalankan atau Buka sel pertama yang gagal untuk menavigasi ke sel yang terakhir dijalankan atau pertama kali gagal.

Peta mini membantu Anda melacak kemajuan eksekusi secara sekilas dan dengan cepat menavigasi saat menelusuri kesalahan atau mengembangkan.

Menemukan dan mengganti teks

Untuk menemukan dan mengganti teks dalam buku catatan, gunakan pintasan keyboard, Cmd + F (Mac) atau (Windows), atau Ctrl + Fklik Edit > Temukan... untuk membuka kotak dialog Temukan . Masukkan teks yang ingin Anda temukan. Pertandingan yang sekarang disorot dengan warna oranye dan semua pertandingan lainnya disorot dengan warna kuning. Untuk mengakses pencarian browser asli, tekan Cmd + F (Mac) atau Ctrl + F(Windows) lagi.

Klik untuk membuka opsi Ganti . Masukkan teks yang ingin Anda gunakan sebagai gantinya. Untuk mengganti pencocokan saat ini, klik Ganti. Untuk mengganti semua kecocokan dalam buku catatan, klik Ganti Semua.

Untuk berpindah antar kecocokan, klik (kecocokan sebelumnya) atau (kecocokan berikutnya). Anda juga dapat menekan Shift + Enter dan Enter untuk pergi ke pertandingan sebelumnya dan berikutnya, masing-masing.

Untuk menutup alat temukan dan ganti, klik atau tekan esc.

Inspeksi variabel

Untuk menampilkan informasi tentang variabel yang ditentukan dalam buku catatan SQL atau Python, arahkan kursor Anda ke atas nama variabel. Inspeksi variabel Python memerlukan Databricks Runtime 12.2 LTS atau lebih tinggi.

Lihat Penjelajah variabel.

Masuk ke definisi

Saat notebook Python dilampirkan ke sumber daya komputasi, Anda dapat dengan cepat masuk ke definisi variabel, fungsi, atau kode di balik %run pernyataan. Untuk melakukan ini, klik kanan variabel atau nama fungsi, lalu klik Buka definisi atau Definisi intip.

Tahan tombol Cmd di macOS atau tombol Ctrl di Windows dan arahkan mouse ke atas variabel atau nama fungsi. Jika definisi ditemukan, nama akan berubah menjadi hyperlink.

Fitur "buka definisi" tersedia di Databricks Runtime 12.2 LTS ke atas.

Pelipatan kode

Pelipatan kode memungkinkan Anda menyembunyikan bagian kode untuk sementara waktu. Ini dapat membantu saat bekerja dengan blok kode panjang karena memungkinkan Anda fokus pada bagian kode tertentu yang sedang Anda kerjakan.

Untuk menyembunyikan kode, letakkan kursor Anda di paling kiri sel. Panah menunjuk ke bawah muncul di titik logis tempat Anda dapat menyembunyikan bagian kode. Klik panah untuk menyembunyikan bagian kode. Klik panah lagi (sekarang menunjuk ke kanan) untuk memperlihatkan kode.

Untuk detail selengkapnya, termasuk pintasan keyboard, lihat dokumentasi Visual Studio Code.

Dukungan multikursor

Anda dapat membuat beberapa kursor untuk membuat pengeditan simultan lebih mudah, seperti yang ditunjukkan dalam video:

Untuk membuat beberapa kursor dalam sel:

• Di macOS, tahan Option tombol dan klik di setiap lokasi untuk menambahkan kursor.
• Di Windows, tahan Alt tombol dan klik di setiap lokasi untuk menambahkan kursor.
• Anda juga memiliki opsi untuk mengubah pintasan. Lihat Ubah pintasan untuk pilihan multikursor dan kolom.

Di macOS, Anda dapat membuat beberapa kursor yang diratakan secara vertikal dengan menggunakan pintasan Option+Commandkeyboard + tombol panah atas atau bawah.

Pemilihan kolom (kotak pilihan)

Untuk memilih beberapa item dalam kolom, klik di kiri atas area yang ingin Anda ambil. Then:

• Di macOS, tekan Shift + Option dan seret ke kanan bawah untuk mengambil satu atau beberapa kolom.
• Di Windows, tekan Shift + Alt dan seret ke kanan bawah untuk mengambil satu atau beberapa kolom.
• Anda juga memiliki opsi untuk mengubah pintasan. Lihat Ubah pintasan untuk pilihan multikursor dan kolom.

Ubah pintasan untuk pemilihan multikursor dan kolom

Pintasan alternatif tersedia untuk pemilihan multikursor dan kolom (kotak). Dengan pilihan alternatif, pintasan berubah sebagai berikut:

• Untuk membuat beberapa kursor dalam sel:
  • Di macOS, tahan Cmd tombol dan klik di setiap lokasi untuk menambahkan kursor.
  • Di Windows, tahan Ctrl tombol dan klik di setiap lokasi untuk menambahkan kursor.
• Untuk memilih beberapa item dalam kolom, klik di kiri atas area yang ingin Anda ambil. Then:
  • Di macOS, tekan Option dan seret ke kanan bawah untuk mengambil satu atau beberapa kolom.
  • Di Windows, tekan Alt dan seret ke kanan bawah untuk mengambil satu atau beberapa kolom.

Untuk mengaktifkan pintasan alternatif, lakukan hal berikut:

1. Klik nama pengguna Anda di kanan atas ruang kerja, lalu klik pengaturan di daftar dropdown.
2. Di bilah samping Pengaturan, pilih Pengembang.
3. Di bagian Code editor, ubah pengaturan Pemodifikasi kunci untuk klik multi-kursor ke Cmd untuk macOS atau Ctrl untuk Windows.

Saat Anda mengaktifkan pintasan alternatif, pintasan keyboard untuk membuat beberapa kursor yang diratakan secara vertikal tidak berubah.

Telusuri data

Gunakan browser skema untuk menjelajahi objek Katalog Unity yang tersedia untuk buku catatan. Klik di sisi kiri buku catatan untuk membuka browser skema.

Tombol Untuk Anda hanya menampilkan objek yang telah Anda gunakan dalam sesi saat ini atau yang sebelumnya ditandai sebagai Favorit.

Saat Anda mengetik teks ke dalam kotak Filter , tampilan berubah untuk memperlihatkan hanya objek yang berisi teks yang Anda ketik. Hanya objek yang saat ini terbuka atau telah dibuka dalam sesi saat ini yang muncul. Kotak Filter tidak melakukan pencarian lengkap katalog, skema, tabel, dan volume yang tersedia untuk buku catatan.

Untuk membuka menu kebab, arahkan kursor ke atas nama objek seperti yang ditunjukkan:

Jika objek adalah tabel, Anda bisa melakukan hal berikut:

• Buat dan jalankan sel secara otomatis untuk menampilkan pratinjau data dalam tabel. Pilih Pratinjau di sel baru dari menu kebab untuk tabel.
• Menampilkan katalog, skema, atau tabel di Catalog Explorer. Pilih Buka di Catalog Explorer dari menu kebab. Tab baru terbuka memperlihatkan objek yang dipilih.
• Dapatkan jalur ke katalog, skema, atau tabel. Pilih Salin ... jalur dari menu kebab untuk objek.
• Tambahkan tabel ke Favorit. Pilih Tambahkan ke favorit dari menu kebab pada tabel.

Jika objek adalah katalog, skema, atau volume, Anda dapat menyalin jalur objek atau membukanya di Catalog Explorer.

Untuk menyisipkan nama tabel atau kolom langsung ke dalam sel:

1. Klik kursor Anda pada sel tempat Anda ingin memasukkan nama.
2. Pindahkan kursor Anda ke atas nama tabel atau nama kolom di browser skema.
3. Klik yang muncul di sebelah kanan nama objek.

Menggunakan terminal web dan Databricks CLI

Untuk membuka terminal web di buku catatan, klik di bagian bawah bilah sisi kanan.

Di Databricks Runtime 15.0 ke atas, Anda dapat menggunakan Databricks CLI dari terminal web di notebook. Lihat Menjalankan perintah shell di terminal web Azure Databricks untuk informasi persyaratan dan penggunaan.

Anda tidak dapat menggunakan CLI dari sel buku catatan. Di notebook, perintah seperti %sh databricks ... tidak berfungsi dengan Databricks Runtime 15.0 atau yang lebih baru.

Pelengkapan otomatis yang dipersonalisasi

Pelengkapan otomatis secara otomatis menyelesaikan segmen kode saat Anda mengetiknya. Objek yang dapat diselesaikan termasuk jenis, kelas, dan objek, serta database SQL, nama tabel, struktur, peta, array, dan cuplikan kueri. Saat mereferensikan ekspresi tabel umum (CTA) yang menggunakan SELECT *, lengkapi otomatis menyediakan rekomendasi kolom berdasarkan struktur tabel yang mendasarinya. Databricks menggunakan metadata dan penggunaan Unity Catalog Anda untuk mempersonalisasi saran.

• Untuk sel Python, buku catatan harus dilampirkan ke sumber daya komputasi agar pelengkapan otomatis berfungsi, dan Anda harus menjalankan semua sel yang menentukan objek yang dapat diselesaikan.
• Untuk sel SQL, lengkapi otomatis menyarankan kata kunci dan sintaks dasar meskipun buku catatan tidak dilampirkan ke sumber daya komputasi apa pun.
  • Jika ruang kerja diaktifkan untuk Katalog Unity, fitur lengkapi otomatis juga merekomendasikan nama katalog, skema, tabel, dan kolom untuk tabel di Katalog Unity.
  • Jika ruang kerja tidak diaktifkan untuk Katalog Unity, buku catatan harus dilampirkan ke sumber daya komputasi serba guna atau gudang SQL untuk menyarankan nama tabel atau kolom.

Saran lengkapi otomatis muncul secara otomatis saat Anda mengetik dalam sel. Gunakan tombol panah atas dan bawah atau mouse Anda untuk memilih saran, dan tekan tab atau Masukkan untuk menyisipkan pilihan ke dalam sel.

Note

Pelengkapan otomatis server di buku catatan R diblokir selama eksekusi perintah.

Pelengkapan otomatis diaktifkan secara default tetapi dapat dinonaktifkan di pengaturan pengguna Anda:

• Untuk menonaktifkan saran lengkapi otomatis, alihkan Lengkapi Otomatis saat Anda mengetik. Saat pelengkapan otomatis nonaktif, Anda dapat menampilkan saran lengkapi otomatis dengan menekan Ctrl + Spasi.
• Untuk mencegah Enter menyisipkan saran lengkapi otomatis, aktifkan atau nonaktifkan fungsi tombol Enter menerima saran lengkapi otomatis.

Pencocokan tanda kurung siku

Saat Anda mengklik di dekat tanda kurung, kurung siku, atau kurung kurawal, editor menyoroti karakter tersebut dan tanda kurung yang cocok.

Penyorotan kesalahan Python

Ruang kerja dengan fitur AI yang didukung Mitra diaktifkan juga dapat memilih Perbaiki dengan Asisten untuk saran yang dibantu AI.

Notebook Databricks mendukung penyorotan kesalahan berikut:

• Penyorotan kesalahan sintaks Python: Kesalahan sintaks pada sel kode Python akan disorot dengan warna merah. Jika memungkinkan, Asisten akan menyarankan perbaikan cepat untuk Anda. Ini didukung untuk komputasi yang menjalankan Databricks Runtime 12.1 ke atas atau komputasi tanpa server. Anda dapat mengonfigurasi penyorotan kesalahan sintaks dengan pyproject.toml file. Lihat Mengonfigurasi penyorotan sintaks Python.
• Penyorotan kesalahan format Python: Kesalahan pemformatan kode Python dan peringatan digarisbawahi menggunakan warna kuning atau merah, tergantung pada tingkat keparahannya. Ini dapat membantu mengidentifikasi masalah pemformatan seperti indentasi tak terduga, panjang garis panjang, dan banyak lagi. Arahkan mouse ke atas peringatan sintaks untuk melihat informasi selengkapnya. Ini didukung untuk komputasi yang menjalankan Databricks Runtime 12.1 ke atas atau komputasi tanpa server.
• Penyorotan kesalahan jenis Python: Pemeriksaan jenis dapat meningkatkan kualitas kode, keterbacaan, dan pemeliharaan dalam proyek Python dan PySpark. Pemeriksa jenis dapat menandai kesalahan yang terkait dengan atribut yang tidak ada, argumen yang hilang, dan argumen yang tidak cocok dalam panggilan fungsi sebelum eksekusi kode. Arahkan mouse ke atas peringatan yang disorot untuk melihat informasi selengkapnya. Ini didukung untuk komputasi yang menjalankan Databricks Runtime 16.0 ke atas atau lingkungan tanpa server 2.

Mengaktifkan penyorotan kesalahan Python

Untuk mengaktifkan atau menonaktifkan penyorotan kesalahan, lakukan hal berikut:

1. Klik nama pengguna Anda di kanan atas ruang kerja, lalu klik pengaturan di daftar dropdown.
2. Di bilah samping Pengaturan, pilih Pengembang.
3. Alihkan pengaturan untuk penyorotan kesalahan sintaks Python (di bawah Editor kode), penyorotan kesalahan format Python (di bawah Fitur eksperimental), dan/atau penyorotan kesalahan jenis Python (di bawah Fitur eksperimental).

Mengonfigurasi penyorotan tata bahasa Python

Saat notebook tersambung ke komputasi yang menjalankan Databricks Runtime 16.4 atau lebih tinggi atau lingkungan tanpa server versi 3 atau lebih tinggi, Anda dapat menyesuaikan perilaku penyorotan sintaks dengan membuat pyproject.toml file. Untuk buku catatan tertentu, file terdekat pyproject.toml di jalur leluhur langsungnya di Sistem File Ruang Kerja akan digunakan. Jika file pyproject.toml tidak dapat ditemukan di dalam jalur induk, maka file tersebut akan digunakan dari folder beranda pengguna saat ini.

Misalnya, jika Anda memiliki buku catatan dengan jalur a/b/c/d/notebook.py dan ada pyproject.toml file di a/b/pyproject.toml dan a/b/c/pyproject.toml kemudian yang kedua akan digunakan karena lebih dekat. File pyproject.toml di /a/b/c/e/pyproject.toml tidak akan dipertimbangkan karena tidak berada di jalur leluhur langsung.

Azure Databricks menggunakan sintaks standar untuk pyproject.toml file. Misalnya, Anda dapat merujuk ke dokumentasi Ruff untuk melihat cara mengonfigurasi linter Ruff dengan pyproject.toml file.

Saat ini, Azure Databricks hanya mendukung konfigurasi ruff, , pylintpyright dan flake8 untuk melakukan linting melalui pyproject.toml.

Untuk mengaktifkan linter, berkas pyproject.toml harus memiliki blok [tool.<name-of-linter>].

Untuk menonaktifkan linter secara eksplisit, tambahkan blok berikut:

[tool.<name-of-linter>]
disabled=true

Anda juga dapat menonaktifkan aturan penyorotan sintaks yang ditulis Azure Databricks dengan blok seperti:

[tool.databricks]
disabled_rules = ['DB01', 'DB03']

Karena Flake8 mengharapkan konfigurasi dalam format yang berbeda, Anda harus meneruskan konfigurasi untuk Flake8 sebagai string:

[tool.flake8]
config = """ \
[flake8] \
extend_ignore = E303 \
"""

Mengkustomisasi pemformatan SQL

Anda bisa mengkustomisasi pengaturan untuk pemformatan SQL di editor SQL baru dan editor buku catatan. Klik Tampilkan > Pengaturan Pengembang. Gulir ke bawah ke Format SQL dan tentukan pengaturan Anda.

Gunakan pintasan keyboard

Untuk menampilkan pintasan keyboard, pilih Bantuan > Pintasan keyboard. Pintasan keyboard yang tersedia bergantung pada apakah kursor berada dalam sel kode (mode edit) atau tidak (mode perintah).

Tabel di bawah ini memperlihatkan pintasan keyboard yang tersedia.

Mengedit pintasan mode

Function	Pintasan MacOS	Pintasan Windows
Beralih ke Mode Perintah	Esc	Esc
Jalankan perintah dan sisipkan sel baru di bawah ini	Option + Enter	Alt + Enter
Sisipkan sel di atas	Ctrl + Option + P	Ctrl + Alt + P
Sisipkan sel di bawah ini	Ctrl + Option + N	Ctrl + Alt + N
Pindah ke sel sebelumnya/berikutnya	Option + Up/Down	Alt + Up/Down
Memisahkan sel pada kursor	Ctrl + Option + -	Ctrl + Alt + -
Hapus baris saat ini	⌘ + Shift + K	Ctrl + Shift + K
Hapus sel saat ini	Ctrl + Option + D	Ctrl + Alt + D
Memindahkan ke atas atau ke sel sebelumnya	Up	Up
Pindah ke bawah atau ke sel berikutnya	Down	Down
Pelengkapan otomatis	Ctrl + Space	Ctrl + Space
Asisten Otomatis Lengkapi Otomatis	Ctrl + Shift + Space	Ctrl + Shift + Space
Asisten Sebaris	⌘ + I	Ctrl + I
Petunjuk parameter	⌘ + Shift + Space	Ctrl + Shift + Space
Docstring	⌘ + (K, I)	Ctrl + (K, I)
Beberapa kursor	Option + Click	Alt + Click
Kolom (kotak) pilih	Option + Shift + Drag	Alt + Shift + Drag
Pilihan Inden/Tidak Terindentasi	⌘ + ]/[	Ctrl + ]/[
Urungkan pengetikan	⌘ + Z	Ctrl + Z
Pengetikan ulang	⌘ + Shift + Z	Ctrl + Shift + Z
Alihkan komentar baris	⌘ + /	Ctrl + /
Tambahkan komentar baris	⌘ + (K, C)	Ctrl + (K, C)
Hapus komentar baris	⌘ + (K, U)	Ctrl + (K, U)
Pengeditan multi-kursor	⌘ + Option + Up/Down	Ctrl + Option + Up/Down
Memperbesar ukuran font	Option + +	Alt + +
Kurangi ukuran font	Option + -	Alt + -

Pintasan mode perintah

Function	Pintasan Mac OS	Pintasan Windows
Beralih ke Mode Edit	Enter	Enter
Batalkan eksekusi untuk sel yang dipilih	I, I	I, I
Batalkan eksekusi (lewati prompt)	Shift + (I, I)	Shift + (I, I)
Hapus sel saat ini	D, D	D, D
Hapus sel saat ini (lewati perintah)	Shift + (D, D)	Shift + (D, D)
Masuk ke sel pertama	G, G	G, G
Masuk ke sel terakhir	Shift + G	Shift + G
Batalkan potong/hapus sel	⌘ + Z/Z	Ctrl + Z/Z
Salin sel saat ini	⌘ + C	Ctrl + C
Memotong sel saat ini	⌘ + X	Ctrl + X
Tempel sel	⌘ + V	Ctrl + V
Sisipkan sel di atas	A	A
Sisipkan sel di bawah ini	B	B
Alihkan output sel	O	O
Alihkan judul sel	T	T
Gulir ke bawah	Space	Space
Menggulir ke atas	Shift + Space	Shift + Space
Menu ganti pintasan keyboard	H	H
Gabungkan dengan sel di bawah ini	Shift + M	Shift + M
Pindah ke sel sebelumnya	Up/P/K	Up/P/K
Pindah ke sel berikutnya	Down/N/J	Down/N/J
Tambahkan sel yang berdekatan ke pilihan	Shift + Up/Down	Shift + Up/Down
Pilih semua sel	⌘ + A	Ctrl + A
Pilih beberapa sel	⌘ + Click	Ctrl + Click
Alihkan nomor baris	L	L
Memperluas/Menciutkan judul sel	Right/Left	Right/Left

Pintasan bersama

Function	Pintasan MacOS	Pintasan Windows
Alihkan palet perintah	⌘ + Shift + P	Ctrl + Shift + P
Temukan	⌘ + F	Ctrl + F
Mengganti	Ctrl + Option + F	Ctrl + Alt + F
Memformat kode	⌘ + Shift + F	Ctrl + Shift + F
Jalankan perintah dan pindahkan ke sel berikutnya	Shift + Enter	Shift + Enter
Jalankan perintah yang dipilih	⌘ + Enter	Ctrl + Enter
Sel debug	Option + Shift + D	Alt + Shift + D
Debugger: Lanjutkan	F7	F7
Debugger: Baris Berikutnya	F8	F8
Debugger: Masuk	F9	F9
Debugger: Keluar	Shift + F9	Shift + F9
Jalankan semua perintah	Option + Shift + Enter	Alt + Shift + Enter
Jalankan semua perintah di atas (eksklusif)	Option + Shift + Up	Alt + Shift + Up
Jalankan semua perintah di bawah ini (inklusif)	Option + Shift + Down	Alt + Shift + Down
Status dan output yang jelas	0, 0	0, 0
Jalankan teks yang dipilih atau pernyataan aktif	Ctrl + Shift + Enter	Ctrl + Shift + Enter
Menjalankan pernyataan SQL aktif	⌘ + Shift + Enter	Ctrl + Shift + Enter
Memindahkan sel ke atas	Ctrl + Option + Up	Ctrl + Alt + Up
Memindahkan sel ke bawah	Ctrl + Option + Down	Ctrl + Alt + Down
Alihkan panel komentar/ tambahkan komentar	Ctrl + Option + M	Ctrl + Alt + M
Alihkan panel ruang kerja	Ctrl + Option + E	Ctrl + Alt + E
Alihkan panel katalog	Ctrl + Option + C	Ctrl + Alt + C
Alihkan panel asisten	Ctrl + Option + A	Ctrl + Alt + A
Alihkan mode fokus	Ctrl + Option + O	Ctrl + Alt + O
Tutup tab saat ini	Ctrl + Option + W	Ctrl + Alt + W
Buat tab baru	Ctrl + Option + T	Ctrl + Alt + T
Beralih ke tab kiri	Ctrl + Option + Left	Ctrl + Alt + Left
Beralih ke tab kanan	Ctrl + Option + Right	Ctrl + Alt + Right
Tutup semua tab	Ctrl + Option + Shift + A	Ctrl + Alt + Shift + A