debugger Transact-SQL

Berlaku untuk:SQL Server

Debugger Transact-SQL membantu Anda menemukan kesalahan dalam kode Transact-SQL dengan menyelidiki perilaku run-time kode. Setelah Anda mengatur jendela Editor Kueri Mesin Database ke mode debug, Anda dapat menjeda eksekusi pada baris kode tertentu dan memeriksa informasi dan data yang digunakan oleh atau dikembalikan oleh pernyataan Transact-SQL tersebut.

Penelusuran kesalahan T-SQL tersedia di SQL Server Data Tools untuk Visual Studio.

Menelusuri kode Transact-SQL

Debugger Transact-SQL menyediakan opsi berikut yang bisa Anda gunakan untuk menavigasi melalui kode Transact-SQL saat jendela Editor Kueri Mesin Database dalam mode debug:

• Atur titik henti pada pernyataan Transact-SQL individual.

  Titik henti menentukan titik di mana Anda ingin eksekusi dijeda sehingga Anda dapat memeriksa data. Saat Anda memulai debugger, program akan dijeda dulu pada baris pertama kode di jendela Editor Kueri. Untuk menjalankan ke titik henti pertama, gunakan Lanjutkan. Anda juga dapat menggunakan Lanjutkan untuk menjalankan ke titik henti berikutnya dari lokasi mana pun di mana jendela saat ini dijeda. Anda dapat mengedit titik henti untuk menentukan tindakan seperti kondisi di mana titik henti harus menjeda eksekusi, informasi untuk dicetak ke jendela Output , dan mengubah lokasi titik henti.

• Melangkah ke pernyataan berikutnya.

  Opsi ini memungkinkan Anda menavigasi melalui serangkaian pernyataan satu per satu, dan mengamati perilakunya seiring Anda melanjutkan.

• Masuki atau lewati panggilan ke prosedur atau fungsi tersimpan.

  Jika Anda yakin tidak ada kesalahan dalam prosedur tersimpan, Anda dapat melangkahinya. Prosedur dijalankan secara penuh, dan hasilnya dikembalikan ke kode.

  Jika Anda ingin men-debug prosedur atau fungsi tersimpan, Anda dapat masuk ke modul. Jendela Editor Kueri Mesin Database baru terbuka yang diisi dengan kode sumber untuk modul. Jendela dalam mode debug, dan eksekusi dijeda pada pernyataan pertama dalam modul. Anda kemudian dapat menavigasi melalui kode modul, misalnya, dengan mengatur titik henti atau melangkah melalui kode.

Untuk informasi selengkapnya tentang bagaimana debugger memungkinkan Anda menavigasi kode, lihat Menelusuri kode Transact-SQL.

Lihat informasi debugger

Setiap kali debugger menjeda eksekusi pada pernyataan Transact-SQL tertentu, Anda dapat menggunakan jendela debugger berikut untuk melihat status eksekusi saat ini:

• Penduduk setempat dan Watch. Jendela ini menampilkan ekspresi Transact-SQL yang sedang dialokasikan. Ekspresi adalah klausa Transact-SQL yang mengevaluasi ke ekspresi skalar tunggal. Debugger Transact-SQL mendukung ekspresi tampilan yang mereferensikan Transact-SQL variabel, parameter, atau fungsi bawaan yang memiliki nama yang dimulai dengan @@. Jendela ini juga menampilkan nilai-nilai data yang saat ini diberikan kepada ekspresi.

• QuickWatch. Jendela ini menampilkan nilai ekspresi Transact-SQL, dan memungkinkan penyimpanan ekspresi tersebut ke jendela Watch .

• Titik henti. Jendela ini menampilkan titik henti yang saat ini diatur dan memungkinkan Anda mengelolanya.

• Tumpukan Panggilan. Jendela ini menampilkan lokasi eksekusi saat ini. Dan juga menyediakan informasi tentang bagaimana eksekusi diteruskan dari jendela Editor Kueri asli melalui fungsi apa pun, prosedur tersimpan, atau pemicu untuk mencapai lokasi eksekusi saat ini.

• Output. Jendela ini menampilkan berbagai pesan dan data program, seperti pesan sistem dari debugger.

• Hasil dan Pesan. Tab ini pada jendela Editor Kueri menampilkan hasil pernyataan Transact-SQL yang dijalankan sebelumnya.

Masalah dan batasan yang diketahui

Debugger T-SQL hanya berlaku untuk instans SQL Server. Debugger tidak mendukung penelusuran kesalahan kode Transact-SQL yang berjalan di Azure SQL Database, Azure SQL Managed Instance, atau database SQL pada Microsoft Fabric.

Dalam kondisi tertentu, penyorotan baris dan titik henti pada debugger T-SQL dapat tidak sinkron dengan titik eksekusi sebenarnya saat melangkah melalui skrip SQL. Masalah ini dapat muncul dalam beberapa skenario, termasuk komentar di bagian atas skrip atau baris kosong setelah GO pernyataan.

Transact-SQL tugas debugger

Deskripsi Tugas	Article
Menjelaskan cara mengonfigurasi debugger Transact-SQL untuk penelusuran kesalahan jarak jauh.	Mengonfigurasi aturan firewall sebelum menjalankan debugger Transact-SQL
Menjelaskan cara memulai, menghentikan, dan mengontrol operasi debugger.	Jalankan debugger Transact-SQL
Menjelaskan cara menggunakan debugger Transact-SQL untuk menelusuri kode.	Menelusuri kode Transact-SQL
Menjelaskan cara menggunakan debugger Transact-SQL untuk menelusuri kode prosedur tersimpan.	Debug prosedur tersimpan
Menjelaskan cara menggunakan debugger untuk melihat data Transact-SQL, seperti parameter dan variabel, dan informasi sistem.	Transact-SQL informasi debugger