Bagikan melalui

Buku Catatan SQL (pratinjau)

SQL Notebooks di ekstensi MSSQL untuk Visual Studio Code menyediakan pengembangan SQL berbasis buku catatan menggunakan notebook Jupyter Visual Studio Code asli. Anda dapat menggabungkan eksekusi kueri SQL interaktif dengan sel dokumentasi Markdown untuk membangun koleksi kueri yang dapat dijalankan, operasi database dokumen, dan berbagi analisis yang dapat direproduksi.

Petunjuk / Saran

SQL Notebooks saat ini dalam pratinjau dan mungkin berubah berdasarkan umpan balik. Bergabunglah dengan komunitas di GitHub Discussions untuk berbagi ide atau melaporkan masalah.

Features

SQL Notebooks menawarkan kemampuan ini:

  • Jalankan kueri T-SQL secara interaktif di sel kode buku catatan dengan hasil sebaris yang ditampilkan di bawah setiap sel.

  • Gunakan format buku catatan Visual Studio Code Jupyter asli (.ipynb file) untuk kompatibilitas penuh dengan alat notebook yang sudah ada.

  • Tampilkan hasil kueri dalam grid data yang kaya dengan pengurutan, pemfilteran, seleksi sel, penyorotan nilai nol, serta pilihan salin (termasuk salin dengan header).

  • Tulis SQL dengan IntelliSense, termasuk saran nama tabel dan kolom berdasarkan koneksi database aktif Anda.

  • Tambahkan sel teks Markdown bersama sel kode SQL ke kueri dokumen, anotasi hasil, dan buat alur kerja narasi.

  • Sambungkan setiap buku catatan ke instans SQL Server dan beralih antar database di server yang sama.

  • Jalankan sel satu per satu atau jalankan semua sel secara berurutan.

  • Gunakan GitHub Copilot untuk saran kueri sebaris dalam sel kode, serta pembuatan buku catatan berbasis percakapan, untuk memproduksi buku catatan lengkap dari deskripsi bahasa alami.

  • Gabungkan sel SQL dengan kernel bahasa lain (seperti Python) di notebook yang sama dengan menginstal ekstensi Jupyter.

  • Ekspor dan bagikan buku catatan sebagai .ipynb file yang dapat dibuka orang lain di Visual Studio Code atau lingkungan yang kompatibel dengan Jupyter.

Prasyarat

Sebelum Anda menggunakan SQL Notebooks, pastikan persyaratan berikut terpenuhi:

Membuat buku catatan SQL

Anda bisa membuat buku catatan SQL baru dengan beberapa cara:

  • Buka Palet Perintah (Ctrl+Shift+P di Windows dan Linux, atau Cmd+Shift+P di macOS), ketik New Notebook, dan pilih perintah .

  • Buka menu File dan pilih File Baru, lalu pilih jenis Jupyter Notebook.

  • Klik kanan pada database di Object Explorer ekstensi MSSQL dan pilih Notebook Baru dari menu konteks.

Saat Anda membuat buku catatan baru, pilih kernel MSSQL untuk mengaktifkan eksekusi T-SQL di sel kode.

Sambungkan ke database

Setiap notebook SQL memerlukan koneksi database aktif untuk menjalankan kueri. Saat Anda membuka buku catatan dengan kernel MSSQL, ekstensi akan meminta Anda untuk memilih profil koneksi atau membuat yang baru.

Penting

Setiap notebook mendukung satu koneksi server per kernel. Anda bisa menyambungkan ke satu instans SQL Server dan beralih antar database di server tersebut, tetapi Anda tidak dapat menyambungkan ke beberapa server dalam buku catatan yang sama. Untuk bekerja dengan server lain, buat buku catatan terpisah atau ubah koneksi buku catatan.

Menulis dan menjalankan sel SQL

Sel kode SQL memungkinkan Anda menulis dan menjalankan kueri T-SQL secara interaktif dalam buku catatan.

  1. Pilih + Kode di toolbar buku catatan untuk menambahkan sel kode baru.

  2. Masukkan kueri T-SQL Anda di sel. Sel memberikan pengalaman pengeditan SQL yang sama dengan editor kueri standar, termasuk IntelliSense dengan saran nama tabel dan kolom dari database yang terhubung.

  3. Pilih Jalankan Sel (tombol putar di sebelah kiri sel) untuk menjalankan kueri.

  4. Hasil muncul tepat di bawah sel dalam kisi data yang kaya.

Untuk menjalankan semua sel di buku catatan secara berurutan, pilih Jalankan Semua di toolbar buku catatan.

Petunjuk / Saran

Gunakan Ctrl+Enter (Windows dan Linux) atau Cmd+Enter (macOS) untuk menjalankan sel saat ini dan tetap di dalamnya. Gunakan Shift+Enter untuk menjalankan sel saat ini dan lanjutkan ke sel berikutnya.

Hasil kueri

Hasil kueri di SQL Notebooks memberikan pengalaman kisi data kaya yang sama yang tersedia di editor kueri standar:

  • Pengurutan: Pilih header kolom untuk mengurutkan hasil naik atau turun.
  • Pemfilteran: Gunakan ikon filter pada header kolom untuk memfilter data hasil.
  • Pilihan sel: Pilih sel individual atau rentang sel dalam kisi hasil.
  • Penyorotan null: NULL nilai disorot secara visual dalam kisi hasil untuk memudahkan identifikasi.
  • Opsi salin: Klik kanan sel yang dipilih untuk mengakses Salin, Salin dengan Header, dan Pilih Semua opsi.

Menambahkan sel Markdown

Anda dapat menggunakan sel Markdown untuk menambahkan teks, judul, daftar, dan tautan yang diformat bersama sel kode SQL Anda. Gunakan untuk mendokumen kueri Anda, menjelaskan logika bisnis, atau menambahkan catatan tentang hasil yang diharapkan.

  1. Pilih + Markdown di toolbar buku catatan untuk menambahkan sel teks baru.

  2. Ketik konten Markdown Anda. Pratinjau ditampilkan saat Anda mengetik.

  3. Pilih di luar sel untuk merender teks Markdown.

Pilih sel lagi untuk kembali ke mode edit.

Menggunakan beberapa kernel

Ekstensi MSSQL menyediakan kernel SQL di luar kotak. Anda dapat memperluas notebook Anda dengan lebih banyak kernel bahasa dengan menginstal ekstensi Jupyter, yang membundel dukungan untuk Python dan kernel lainnya. Anda dapat menggabungkan kueri data SQL dengan pemrosesan data Python dan sel visualisasi di buku catatan yang sama.

Integrasi GitHub Copilot

GitHub Copilot berfungsi dengan SQL Notebooks untuk membantu Anda menulis kueri dan membuat buku catatan. Saat menginstal ekstensi GitHub Copilot, Anda mendapatkan:

  • Saran sebaris: Saat Anda mengetikkan sel kode SQL, GitHub Copilot menyarankan penyelesaian kueri berdasarkan konteks database Anda dan sel Markdown di sekitarnya.

  • Penulisan buku catatan berbasis obrolan: Gunakan GitHub Copilot Chat untuk menghasilkan buku catatan lengkap dengan sel Markdown dan SQL alternatif. Jelaskan analisis yang ingin Anda lakukan, dan GitHub Copilot membuat struktur buku catatan lengkap.

Misalnya, Anda dapat membuka GitHub Copilot Chat dan menggunakan perintah seperti:

I have a SQL Notebook open connected to AdventureWorks. Create cells for a sales
analysis: list all tables, find top 10 customers by revenue, show revenue by product
category, and demonstrate a safe data modification using BEGIN TRAN / ROLLBACK.

GitHub Copilot menghasilkan sel dokumentasi Markdown dan sel kode T-SQL, yang kemudian dapat Anda jalankan satu per satu atau sekaligus menggunakan Jalankan Semua.

Beralih database

Untuk beralih ke database lain dalam koneksi server yang sama:

  1. Pilih nama database yang ditampilkan di area status koneksi buku catatan.

  2. Pilih database lain dari daftar dropdown.

Semua eksekusi sel berikutnya menggunakan database yang baru dipilih.

Nota

Untuk beralih ke server lain, Anda perlu mengubah profil koneksi buku catatan. Pertimbangkan untuk membuat buku catatan terpisah untuk setiap server yang perlu Anda kerjakan.

Keterbatasan

Koneksi server tunggal per notebook: Saat ini, setiap notebook tersambung ke satu instans SQL Server. Anda bisa beralih database di server tersebut tetapi tidak dapat tersambung ke server kedua dalam buku catatan yang sama.

Tanggapan dan dukungan

Jika Anda memiliki ide, umpan balik, atau ingin terlibat dengan komunitas, bergabunglah dengan diskusi di https://aka.ms/vscode-mssql-discussions. Untuk melaporkan bug, kunjungi https://aka.ms/vscode-mssql-bug. Untuk meminta fitur baru, buka https://aka.ms/vscode-mssql-feature-request.

Konten terkait

  • Last updated on