Bagikan melalui


Tentukan Tindakan Titik Henti

Berlaku untuk: SQL Server

Tindakan breakpoint Saat Hit menentukan tugas kustom yang dilakukan debugger Transact-SQL untuk titik henti. Jika jumlah hit yang ditentukan tercapai dan kondisi titik henti yang ditentukan terpenuhi, debugger melakukan tindakan yang ditentukan untuk titik henti.

Fitur ini berfungsi dengan SSMS versi 17.9.1 dan yang lebih lama.

Pertimbangan Tindakan

Tindakan default untuk titik henti adalah memutuskan eksekusi ketika jumlah hit dan kondisi titik henti telah terpenuhi. Penggunaan utama tindakan Saat Tekan di debugger Transact-SQL adalah mencetak informasi ke jendela Output debugger dengan menentukan pesan cetak.

Pesan cetak ditentukan dalam opsi Cetak Pesan , dan ditentukan sebagai string teks yang menyertakan ekspresi yang berisi informasi dari Transact-SQL yang sedang di-debug. Ekspresi meliputi:

  • Ekspresi Transact-SQL yang terkandung dalam kurung kurawal ({}). Ekspresi dapat mencakup variabel Transact-SQL, parameter, dan fungsi bawaan. Contohnya termasuk {@MyVariable}, {@NameParameter}, {@@SPID}, atau {SERVERPROPERTY('ProcessID')}.

  • Salah satu kata kunci berikut:

    1. $ADDRESS mengembalikan nama prosedur tersimpan atau fungsi yang ditentukan pengguna tempat titik henti diatur. Jika titik henti diatur di jendela editor, $ADDRESS mengembalikan nama file skrip yang sedang diedit. $ADDRESS dan $FUNCTION mengembalikan informasi yang sama dalam debugger Transact-SQL.

    2. $CALLER mengembalikan nama unit kode Transact-SQL yang disebut prosedur atau fungsi tersimpan. Jika titik henti berada di jendela editor, $CALLER mengembalikan Tidak ada pemanggil yang <tersedia>. Jika titik henti berada dalam prosedur tersimpan atau fungsi yang ditentukan pengguna yang dipanggil dari kode di jendela editor, $CALLER mengembalikan nama file yang sedang diedit. Jika titik henti berada dalam prosedur tersimpan atau fungsi yang ditentukan pengguna yang dipanggil dari prosedur atau fungsi tersimpan lain, $CALLER mengembalikan nama prosedur atau fungsi panggilan.

    3. $CALLSTACK mengembalikan tumpukan fungsi panggilan dalam rantai yang disebut prosedur tersimpan saat ini atau fungsi yang ditentukan pengguna. Jika titik henti berada di jendela editor, $CALLSTACK mengembalikan nama file skrip yang sedang diedit.

    4. $FUNCTION mengembalikan nama prosedur tersimpan atau fungsi yang ditentukan pengguna tempat titik henti diatur. Jika titik henti diatur di jendela editor, $FUNCTION mengembalikan nama file skrip yang sedang diedit.

    5. $PID dan $PNAME mengembalikan ID dan nama proses sistem operasi yang menjalankan instans Mesin Database tempat Transact-SQL berjalan. $PID mengembalikan ID yang sama dengan SERVERPROPERTY('ProcessID'), kecuali bahwa $PID adalah nilai heksadesimal sementara SERVERPROPERTY('ProcessID') adalah nilai desimal.

    6. $TID dan $TNAME mengembalikan ID dan nama utas sistem operasi yang menjalankan batch Transact-SQL. Utas adalah utas yang terkait dengan proses yang menjalankan instans Mesin Database. $TID mengembalikan nilai yang sama dengan SELECT kpid FROM sys.sysprocesses WHERE spid = @@SPID, kecuali bahwa $TID adalah nilai heksadesimal sementara kpid adalah nilai desimal.

  • Anda juga dapat menggunakan karakter garis miring terbalik (\) sebagai karakter escape untuk mengizinkan kurung kurawal dan garis miring terbalik dalam pesan: \{, \}, dan \\.

Untuk Menentukan Tindakan Saat Dipukul

  1. Di jendela editor, klik kanan glyph titik henti, lalu klik Saat Ditemui di menu pintasan.

    -atau-

    Di jendela Titik Henti , klik kanan glyph titik henti, lalu klik Saat ditemui di menu pintasan.

  2. Dalam kotak dialog Saat Titik Henti Ditemui , pilih perilaku yang Anda inginkan:

    1. Pilih Cetak Pesan untuk mencetak pesan di jendela Output debugger saat titik henti ditemui.

    2. Opsi Jalankan Makro tidak tersedia dari debugger Transact-SQL, dan berwarna abu-abu.

    3. Pilih Lanjutkan eksekusi jika Anda tidak ingin titik henti dijeda eksekusi. Opsi ini hanya aktif jika Anda telah memilih opsi Cetak Pesan .

  3. Klik OK untuk menerapkan perubahan, atau Batal untuk keluar tanpa menerapkan perubahan.

Lihat Juga

Tentukan Kondisi Titik Henti
Tentukan Hit Count