중단점 동작 지정

적용 대상:SQL Server

중단점 적중될 때 동작은 Transact-SQL 디버거가 중단점에 대해 수행하는 사용자 지정 태스크를 지정합니다. 지정된 적중 횟수에 도달하고 지정된 중단점 조건이 충족되면 디버거는 중단점에 대해 지정된 작업을 수행합니다.

이 기능은 SSMS 버전 17.9.1 이하 버전에서 작동합니다.

동작 고려 사항

중단점에 대한 기본 동작은 적중 횟수와 중단점 조건이 모두 충족된 경우 실행을 중단하는 것입니다. Transact-SQL 디버거에서 적중 시 작업의 주요 용도는 대신 인쇄 메시지를 지정하여 디버거 출력 창에 정보를 인쇄하는 것입니다.

인쇄 메시지는 메시지 인쇄 옵션에 지정되며 디버깅 중인 Transact-SQL의 정보가 포함된 표현식을 포함하는 텍스트 문자열로 지정됩니다. 식은 다음을 포함합니다.

  • 중괄호({})에 포함된 Transact-SQL 식입니다. 식은 Transact-SQL 변수, 매개 변수, 기본 제공 함수를 포함할 수 있습니다. 예를 들면 {@MyVariable}, {@NameParameter}, {@@SPID}, 또는 {SERVERPROPERTY(‘ProcessID’)}와 같습니다.

  • 다음 키워드 중 하나:

    1. $ADDRESS는 중단점이 설정된 저장 프로시저 또는 사용자 정의 함수의 이름을 반환합니다. 중단점이 편집기 창에 설정되어 있으면 $ADDRESS는 편집 중인 스크립트 파일의 이름을 반환합니다. Transact-SQL 디버거에서 $ADDRESS와 $FUNCTION은 동일한 정보를 반환합니다.

    2. $CALLER는 저장 프로시저 또는 함수를 호출한 Transact-SQL 코드 단위의 이름을 반환합니다. 중단점이 편집기 창에 있으면 $CALLER는 <No caller available>을 반환합니다. 중단점이 편집기 창의 코드에서 호출된 저장 프로시저 또는 사용자 정의 함수에 있는 경우 $CALLER는 편집 중인 파일의 이름을 반환합니다. 중단점이 저장 프로시저 또는 다른 저장 프로시저 또는 함수에서 호출된 사용자 정의 함수에 있는 경우 $CALLER는 호출 프로시저 또는 함수의 이름을 반환합니다.

    3. $CALLSTACK은 현재 저장 프로시저 또는 사용자 정의 함수를 호출한 체인의 함수 호출 스택을 반환합니다. 중단점이 편집기 창에 있으면 $CALLSTACK은 편집 중인 스크립트 파일의 이름을 반환합니다.

    4. $FUNCTION는 중단점이 설정된 저장 프로시저 또는 사용자 정의 함수의 이름을 반환합니다. 중단점이 편집기 창에 설정되어 있으면 $FUNCTION은 편집 중인 스크립트 파일의 이름을 반환합니다.

    5. $PID 및 $PNAME은 Transact-SQL이 실행되고 있는 데이터베이스 엔진 인스턴스를 실행하는 운영 체제 프로세스의 ID 및 이름을 반환합니다. $PID는 SERVERPROPERTY('ProcessID')와 동일한 ID를 반환하는데, 예외적으로 $PID는 16진수 값이지만 SERVERPROPERTY('ProcessID')는 10진수 값입니다.

    6. $TID 및 $TNAME은 Transact-SQL 일괄 처리를 실행하는 운영 체제 스레드의 ID 및 이름을 반환합니다. 스레드는 데이터베이스 엔진 인스턴스를 실행하는 프로세스와 연결된 스레드입니다. $TID는 SELECT kpid FROM sys.sysprocesses WHERE spid = @@SPID와 동일한 값을 반환합니다. 다른 점은 $TID는 16진수 값이고 kpid는 10진수 값이라는 것입니다.

  • 백슬래시(\) 문자를 이스케이프 문자로 사용하여 {, }, 등의 중괄호 및 백슬래시를 메시지에 허용할 수 있습니다(\{, \}, 및 \\ 등).

적중 시 동작을 지정하려면

  1. 편집기 창에서 중단점 문자 모양을 마우스 오른쪽 단추로 클릭한 다음 바로 가기 메뉴에서 적중 시 를 클릭합니다.

    또는

    중단점 창에서 중단점 문자 모양을 마우스 오른쪽 단추로 클릭한 다음 바로 가기 메뉴에서 적중될 때 를 클릭합니다.

  2. 중단점 적중 시 대화 상자에서 원하는 동작을 선택합니다.

    1. 중단점이 적중되면 디버거 출력 창에 메시지를 인쇄하려면 메시지 인쇄를 선택합니다.

    2. 매크로 실행 옵션은 Transact-SQL 디버거에서 사용할 수 없으므로 회색으로 나타납니다.

    3. 중단점이 실행을 일시 중지하지 않게 하려면 실행 계속을 선택합니다. 이 옵션은 메시지 인쇄 옵션을 선택한 경우에만 활성화됩니다.

  3. 확인을 클릭하여 변경 내용을 구현하거나 취소를 클릭하여 변경 내용을 적용하지 않고 종료합니다.

참고 항목

중단점 조건 지정
적중 횟수 지정