Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Berlaku untuk:SQL Server
Anda dapat memulai debugger Transact-SQL setelah membuka jendela Editor Kueri Mesin Database. Anda dapat mengatur opsi untuk menyesuaikan cara debugger berjalan dan menjalankan kode Transact-SQL Anda dalam mode debug hingga Anda menghentikan debugger.
Memulai dan menghentikan debugger
Persyaratan untuk memulai debugger Transact-SQL adalah sebagai berikut:
Jika Editor Kueri Mesin Database tersambung ke instans Mesin Database di komputer lain, Anda harus mengonfigurasi debugger untuk penelusuran kesalahan jarak jauh. Untuk informasi selengkapnya, lihat Mengonfigurasi aturan firewall sebelum menjalankan debugger Transact-SQL.
Jendela Editor Kueri Mesin Database harus tersambung menggunakan login Autentikasi Windows atau Autentikasi SQL Server yang merupakan anggota dari peran server tetap sysadmin.
Jendela Editor Kueri Mesin Database harus tersambung ke instans Mesin Database SQL Server. Anda tidak dapat menjalankan debugger saat jendela Editor Kueri tersambung ke instans yang berada dalam mode pengguna tunggal.
Sebaiknya debug kode Transact-SQL di server pengujian, bukan server produksi, karena alasan berikut:
Penelusuran kesalahan adalah operasi yang sangat istimewa. Oleh karena itu, hanya anggota peran server tetap sysadmin yang diizinkan untuk men-debug di SQL Server.
Sesi debugging sering berjalan untuk jangka waktu yang lama saat Anda menyelidiki operasi beberapa perintah Transact-SQL. Kunci, seperti kunci pembaruan, yang diperoleh oleh sesi mungkin ditahan untuk jangka waktu yang lama, hingga sesi berakhir atau transaksi disetujui atau digulung balik.
Memulai debugger Transact-SQL menempatkan jendela Editor Kueri ke dalam mode debug. Saat jendela Editor Kueri memasuki mode debug, debugger berhenti sejenak di baris pertama kode. Anda kemudian dapat menelusuri kode, menjeda eksekusi pada pernyataan Transact-SQL tertentu, dan menggunakan jendela debugger untuk melihat status eksekusi saat ini. Anda dapat memulai debugger dengan memilih tombol Debug pada toolbar Kueri atau memilih Mulai Debug pada menu Debug.
Jendela Editor Kueri tetap dalam mode debug hingga pernyataan terakhir di jendela Editor Kueri selesai atau Anda menghentikan mode debug. Anda dapat menghentikan mode debug dan eksekusi pernyataan dengan menggunakan salah satu metode berikut:
- Pada menu Debug, pilih Hentikan Debugging.
- Pada toolbar Debug, pilih tombol Hentikan Debugging.
- Pada menu Kueri , pilih Batalkan Eksekusi Kueri.
- Pada toolbar Kueri , pilih tombol Batalkan Eksekusi Kueri .
Anda juga dapat menghentikan mode debug dan memungkinkan pernyataan Transact-SQL yang tersisa selesai dijalankan dengan memilih Lepaskan Semua pada menu Debug .
Mengontrol debugger
Anda dapat mengontrol cara Transact-SQL debugger beroperasi dengan menggunakan perintah menu, toolbar, dan pintasan berikut:
Menu Debug dan toolbar Debug . Menu Debug dan toolbar Debug tidak aktif hingga fokus ditempatkan di jendela Editor Kueri yang terbuka. Mereka tetap aktif sampai proyek saat ini ditutup.
Pintasan papan ketik debugger.
Menu pintasan Editor Kueri. Menu pintasan ditampilkan saat Anda mengklik kanan garis di jendela Editor Kueri. Saat jendela Editor Kueri dalam mode debug, menu pintasan menampilkan perintah debugger yang berlaku untuk baris atau string yang dipilih.
Menu item dan perintah konteks di jendela yang dibuka oleh debugger, seperti jendela Watch atau Breakpoints .
Tabel berikut ini memperlihatkan perintah menu debugger, tombol toolbar, dan pintasan keyboard.
| Perintah menu debug | Perintah pintasan editor | Tombol toolbar | Pintasan keyboard | Tindakan |
|---|---|---|---|---|
| Windows/Breakpoints | Tidak tersedia | Breakpoint | Ctrl+Alt+B | Tampilkan jendela Titik Henti tempat Anda dapat melihat dan mengelola titik henti. |
| Windows/Watch/Watch1 | Tidak tersedia | Breakpoints/Watch/Watch1 | Ctrl+Alt+W, 1 | Tampilkan jendela Watch1 . |
| Windows/Watch/Watch2 | Tidak tersedia | Breakpoints/Watch/Watch2 | Ctrl+Alt+W, 2 | Tampilkan jendela Watch2 . |
| Windows/Watch/Watch3 | Tidak tersedia | Breakpoints/Watch/Watch3 | Ctrl+Alt+W, 3 | Tampilkan jendela Watch3 . |
| Windows/Watch/Watch4 | Tidak tersedia | Breakpoints/Watch/Watch4 | Ctrl+Alt+W, 4 | Tampilkan jendela Watch4 . |
| Windows/Lokals | Tidak tersedia | Breakpoint/Local | Ctrl+Alt+V, L | Tampilkan jendela Lokal . |
| Panggilan/Tumpukan Windows | Tidak tersedia | Titik Henti/Tumpukan Panggilan | Ctrl+Alt+C | Tampilkan jendela Tumpukan Panggilan . |
| Windows/Thread | Tidak tersedia | Titik Henti/Thread | Ctrl+Alt+H | Tampilkan window Thread. |
| Lanjutkan | Tidak tersedia | Lanjutkan | Alt+F5 | Jalankan ke titik henti berikutnya. Lanjutkan tidak aktif sampai Anda berfokus pada jendela Editor Kueri yang berada dalam mode debug. |
| Mulai Debug | Tidak tersedia | Mulai Debug | Alt+F5 | Masukkan jendela Editor Kueri ke mode debug dan jalankan ke titik henti pertama. Jika Anda sedang fokus pada jendela Editor Kueri yang berada dalam mode debug, Mulai Debugging digantikan oleh Lanjutkan. |
| Putuskan Semua | Tidak tersedia | Hentikan Semua | Ctrl+Alt+Break | Fitur ini tidak digunakan oleh debugger Transact-SQL. |
| Hentikan Debugging | Tidak tersedia | Hentikan Debug | Shift+F5 | Keluarkan jendela Editor Kueri dari mode debug dan kembalikan ke mode reguler. |
| Lepaskan Semua | Tidak tersedia | Tidak tersedia | Tidak tersedia | Menghentikan mode debug, tetapi menjalankan pernyataan yang tersisa di jendela Editor Kueri. |
| Melangkah Ke | Tidak tersedia | Masuk Ke | F11 | Jalankan pernyataan berikutnya, dan buka juga jendela Editor Kueri baru dalam mode debug jika pernyataan berikutnya menjalankan prosedur, pemicu, atau fungsi tersimpan. |
| Langkah Di Atas | Tidak tersedia | Langkah Di Atas | F10 | Sama seperti Step Into, kecuali bahwa tidak ada fungsi, prosedur tersimpan, atau pemicu yang di-debug. |
| Keluar | Tidak tersedia | Keluar | Shift+F11 | Jalankan kode yang tersisa dalam pemicu, fungsi, atau prosedur tersimpan tanpa menjeda titik henti apa pun. Mode debug reguler dilanjutkan saat kontrol dikembalikan ke kode yang memanggil modul. |
| Tidak tersedia | Jalankan Hingga Kursor | Tidak tersedia | Ctrl+F10 | Jalankan semua kode dari lokasi pemberhentian terakhir ke lokasi kursor saat ini tanpa berhenti di titik henti apa pun. |
| QuickWatch | QuickWatch | Tidak tersedia | Ctrl+Alt+Q | Tampilkan jendela QuickWatch . |
| Aktifkan/Nonaktifkan Titik Henti | Titik Henti/Sisipkan Titik Henti | Tidak tersedia | F9 | Posisikan titik henti pada pernyataan Transact-SQL saat ini atau yang dipilih. |
| Tidak tersedia | Titik Henti/Hapus Titik Henti | Tidak tersedia | Tidak tersedia | Hapus titik henti dari baris yang dipilih. |
| Tidak tersedia | Breakpoint/Nonaktifkan Breakpoint | Tidak tersedia | Tidak tersedia | Nonaktifkan titik henti pada baris yang dipilih. Titik henti tetap berada di baris kode, tetapi eksekusi tidak berhenti sampai dapat diaktifkan kembali. |
| Tidak tersedia | Breakpoint/Aktifkan Breakpoint | Tidak tersedia | Tidak tersedia | Aktifkan titik henti pada baris yang dipilih. |
| Hapus Semua Titik Henti | Tidak tersedia | Tidak tersedia | Ctrl+Shift+F9 | Hapus semua titik henti. |
| Nonaktifkan Semua Titik Henti | Tidak tersedia | Tidak tersedia | Tidak tersedia | Nonaktifkan semua titik henti. |
| Tidak tersedia | Tambahkan Watch | Tidak tersedia | Tidak tersedia | Tambahkan ekspresi yang dipilih ke jendela Watch . |