Dukungan T-SQL di notebook Microsoft Fabric

Fitur notebook T-SQL di Microsoft Fabric memungkinkan Anda menulis dan menjalankan kode T-SQL dalam buku catatan. Anda dapat menggunakan notebook T-SQL untuk mengelola kueri kompleks dan menulis dokumentasi markdown yang lebih baik. Ini juga memungkinkan eksekusi langsung T-SQL pada gudang yang terhubung atau titik akhir analitik SQL. Dengan menambahkan titik akhir analitik Gudang Data atau SQL ke notebook, pengembang T-SQL dapat menjalankan kueri langsung di titik akhir yang terhubung. Analis BI juga dapat melakukan kueri lintas database untuk mengumpulkan wawasan dari beberapa gudang dan titik akhir analitik SQL.

Sebagian besar fungsi notebook yang ada tersedia untuk notebook T-SQL. Ini termasuk membuat bagan hasil kueri, penulisan bersama notebook, menjadwalkan eksekusi reguler, dan memicu eksekusi dalam alur Integrasi Data.

Dalam artikel ini, Anda akan mempelajari cara:

• Membuat buku catatan T-SQL
• Menambahkan titik akhir analitik Gudang Data atau SQL ke buku catatan
• Membuat dan menjalankan kode T-SQL di buku catatan
• Menggunakan fitur pembuatan bagan untuk mewakili hasil kueri secara grafis
• Menyimpan kueri sebagai tampilan atau tabel
• Menjalankan kueri lintas gudang
• Lewati eksekusi kode non-T-SQL

Membuat buku catatan T-SQL

Untuk memulai pengalaman ini, Anda bisa membuat buku catatan T-SQL dengan cara berikut:

1. Buat notebook T-SQL dari ruang kerja Fabric: pilih Item baru, lalu pilih Notebook dari panel yang terbuka.

   

2. Buat buku catatan T-SQL dari editor gudang yang sudah ada: navigasikan ke gudang yang sudah ada dan, dari pita navigasi atas, pilih kueri SQL Baru, lalu Notebook kueri T-SQL Baru.

   

Setelah buku catatan dibuat, T-SQL diatur sebagai bahasa default. Anda dapat menambahkan gudang data atau titik akhir analitik SQL dari ruang kerja saat ini ke notebook Anda.

Menambahkan titik akhir analitik Gudang Data atau SQL ke dalam buku catatan

Untuk menambahkan gudang data atau titik akhir analitik SQL ke dalam buku catatan, dari editor buku catatan, pilih tombol + Sumber data dan pilih Gudang. Dari panel hub data, pilih gudang data atau titik akhir analitik SQL yang ingin Anda sambungkan.

Mengatur gudang utama

Anda dapat menambahkan beberapa gudang atau titik akhir analitik SQL ke dalam notebook, dengan salah satunya ditetapkan sebagai yang utama. Gudang utama menjalankan kode T-SQL. Untuk mengaturnya, buka penjelajah objek, pilih ... di samping gudang, dan pilih Atur sebagai utama.

Untuk setiap perintah T-SQL yang mendukung penamaan tiga bagian, gudang utama digunakan sebagai gudang default jika tidak ada gudang yang ditentukan.

Membuat dan menjalankan kode T-SQL di buku catatan

Untuk membuat dan menjalankan kode T-SQL di buku catatan, tambahkan sel baru dan atur T-SQL sebagai bahasa sel.

Anda dapat membuat kode T-SQL secara otomatis menggunakan templat kode dari menu konteks penjelajah objek. Templat berikut ini tersedia untuk notebook T-SQL:

• Pilih 100 teratas
• Buat tabel
• Buat sebagai pilih
• Hilangkan
• Jatuhkan dan buat

Anda dapat menjalankan satu sel kode T-SQL dengan memilih tombol Jalankan di toolbar sel atau menjalankan semua sel dengan memilih tombol Jalankan semua di toolbar.

Dalam sel kode yang sama, mungkin berisi beberapa baris kode. Pengguna dapat memilih bagian dari kode ini dan hanya menjalankan yang dipilih. Setiap eksekusi juga menghasilkan sesi baru.

Setelah kode dijalankan, perluas panel pesan untuk memeriksa ringkasan eksekusi.

Tab Tabel mencantumkan rekaman dari kumpulan hasil yang dikembalikan. Jika eksekusi berisi beberapa kumpulan hasil, Anda dapat beralih dari satu ke yang lain melalui menu dropdown.

Menggunakan fitur pembuatan bagan untuk mewakili hasil kueri secara grafis

Dengan mengklik Inspeksi, Anda dapat melihat bagan yang mewakili kualitas data dan distribusi setiap kolom

Menyimpan kueri sebagai tampilan atau tabel

Anda bisa menggunakan menu Simpan sebagai tabel untuk menyimpan hasil kueri ke dalam tabel menggunakan perintah CTAS . Untuk menggunakan menu ini, pilih teks kueri dari sel kode dan pilih menu Simpan sebagai tabel .

Demikian pula, Anda dapat membuat tampilan dari teks kueri yang Anda pilih menggunakan menu Simpan sebagai tampilan di bilah perintah sel.

Kueri lintas gudang

Anda dapat menjalankan kueri lintas gudang dengan menggunakan penamaan tiga bagian. Penamaan tiga bagian terdiri dari nama database, nama skema, dan nama tabel. Nama database adalah nama titik akhir analitik gudang atau SQL, nama skema adalah nama skema, dan nama tabel adalah nama tabel.

Lewati eksekusi kode non-T-SQL

Dalam buku catatan yang sama, Anda dapat membuat sel kode yang menggunakan bahasa yang berbeda. Misalnya, sel kode PySpark dapat mendahului sel kode T-SQL. Dalam kasus seperti itu, pengguna dapat memilih untuk melewati eksekusi kode PySpark apa pun untuk notebook T-SQL. Dialog ini muncul saat Anda menjalankan semua sel kode dengan mengklik tombol Jalankan semua di toolbar.

Batasan pratinjau publik

• Sel parameter belum didukung di notebook T-SQL. Parameter yang diteruskan dari alur atau penjadwal tidak akan dapat digunakan dalam notebook T-SQL.
• Fitur Jalankan Terbaru belum didukung di notebook T-SQL. Anda perlu menggunakan fitur pemantauan gudang data saat ini untuk memeriksa riwayat eksekusi notebook T-SQL. Lihat artikel Memantau Gudang Data untuk detail selengkapnya.
• URL monitor di dalam eksekusi alur belum didukung di notebook T-SQL.
• Fitur rekam jepret belum didukung di notebook T-SQL.
• Dukungan alur Git dan Deployment belum didukung di notebook T-SQL.

Konten terkait

Untuk informasi selengkapnya tentang notebook Fabric, lihat artikel berikut ini.

• Apa itu pergudangan data di Microsoft Fabric?
• Pertanyaan? Coba tanyakan kepada Komunitas Fabric.
• Ada saran? Berkontribusi ide untuk meningkatkan Fabric.