Bagikan melalui


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.

Penting

Fitur ini dalam pratinjau.

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.

    Cuplikan layar membuat buku catatan baru dari dalam ruang kerja.

  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.

    Cuplikan layar buku catatan terbuka dari editor DW SQL.

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.

Cuplikan layar menambahkan gudang data atau titik akhir sql ke dalam buku catatan.

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.

Cuplikan layar pengaturan gudang 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.

Cuplikan layar memperlihatkan cara membuat sel kode t-sql.

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

Cuplikan layar memperlihatkan templat kode t-sql.

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.

Catatan

Setiap sel kode dijalankan dalam sesi terpisah, sehingga variabel yang ditentukan dalam satu sel tidak tersedia di sel lain.

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.

Cuplikan layar memperlihatkan cara menjalankan sel kode yang dipilih.

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

Cuplikan layar memperlihatkan 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.

Cuplikan layar memperlihatkan cara beralih di tab hasil.

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

Cuplikan layar memperlihatkan pemeriksaan hasil dalam formulir bagan.

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 .

Cuplikan layar memperlihatkan cara menyimpan kueri sebagai tabel.

Cuplikan layar tentang cara menyimpan tabel sebagai dialog.

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

Cuplikan layar memperlihatkan cara membuat tampilan.

Cuplikan layar memperlihatkan simpan sebagai dialog tampilan.

Catatan

  • Karena menu Simpan sebagai tabel dan Simpan sebagai tampilan hanya tersedia untuk teks kueri yang dipilih, Anda perlu memilih teks kueri sebelum menggunakan menu ini.

  • Buat Tampilan tidak mendukung penamaan tiga bagian, sehingga tampilan selalu dibuat di gudang utama dengan mengatur gudang sebagai gudang utama.

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.

Cuplikan layar memperlihatkan cara menjalankan kueri lintas gudang.

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.

Cuplikan layar memperlihatkan cara melewati kode non-TSQL.

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.

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