중단점 동작 지정Specify a Breakpoint Action

중단점 적중될 때 동작은 Transact-SQLTransact-SQL 디버거가 중단점에 대해 수행하는 사용자 지정 태스크를 지정합니다.A breakpoint When Hit action specifies a custom task that the Transact-SQLTransact-SQL debugger performs for a breakpoint. 지정한 적중 횟수에 도달하고 지정한 중단 조건을 만족하면 디버거는 해당 중단점에 대해 지정된 동작을 수행합니다.If the specified hit count is reached and any specified breakpoint condition is satisfied, the debugger performs the action specified for the breakpoint.

동작 고려 사항 Action Considerations

중단점의 기본 동작은 적중 횟수와 중단점 조건을 모두 만족하면 실행을 중단하는 것입니다.The default action for a breakpoint is to break execution when both the hit count and breakpoint condition have been satisfied. 디버거에서 적중될 때 Transact-SQLTransact-SQL 동작은 주로 출력 메시지를 지정하여 대신 디버거 출력 창에 정보를 출력하는 데 사용됩니다.The primary use of a When Hit action in the Transact-SQLTransact-SQL debugger is to instead print information to the debugger Output window by specifying a print message.

출력 메시지는 디버깅 중인 의 정보가 포함된 식을 포함하는 텍스트 문자열로 메시지 표시 Transact-SQLTransact-SQL 옵션에 지정합니다.A print message is specified in the Print a Message option, and is specified as a text string that includes expressions containing information from the Transact-SQLTransact-SQL being debugged. 식은 다음과 같습니다.Expressions include:

  • 중괄호({})에 포함된 Transact-SQLTransact-SQL 식.A Transact-SQLTransact-SQL expression contained in curly braces ({}). 식은 Transact-SQLTransact-SQL 변수, 매개 변수 및 기본 제공 함수를 포함할 수 있습니다.The expressions can include Transact-SQLTransact-SQL variables, parameters, and built-in functions. 예제에는 {@MyVariable}, {@NameParameter}, {@@SPID} 또는 {SERVERPROPERTY('ProcessID')}가 포함됩니다.Examples include {@MyVariable}, {@NameParameter}, {@@SPID}, or {SERVERPROPERTY(‘ProcessID’)}.

  • 다음 키워드 중 하나:One of the following keywords:

    1. $ADDRESS는 중단점이 설정된 저장 프로시저 또는 사용자 정의 함수의 이름을 반환합니다.$ADDRESS returns the name of the stored procedure or user-defined function where the breakpoint is set. 중단점이 편집기 창에 설정되어 있으면 $ADDRESS는 편집 중인 스크립트 파일의 이름을 반환합니다.If the breakpoint is set in the editor window, $ADDRESS returns the name of the script file being edited. Transact-SQLTransact-SQL 디버거에서 $ADDRESS와 $FUNCTION은 동일한 정보를 반환합니다.$ADDRESS and $FUNCTION return the same information in the Transact-SQLTransact-SQL debugger.

    2. $CALLER는 저장 프로시저 또는 함수를 호출한 Transact-SQLTransact-SQL 코드 단위의 이름을 반환합니다.$CALLER returns the name of the unit of Transact-SQLTransact-SQL code that called a stored procedure or function. 중단점이 편집기 창에 있으면 $CALLER는 <No caller available>을 반환합니다.If the breakpoint is in the editor window, $CALLER returns <No caller available>. 중단점이 편집기 창의 코드에서 호출되는 저장 프로시저 또는 사용자 정의 함수에 있으면 $CALLER는 편집 중인 파일의 이름을 반환합니다.If the breakpoint is in a stored procedure or user-defined function called from the code in the editor window, $CALLER returns the name of the file being edited. 중단점이 다른 저장 프로시저 또는 함수에서 호출되는 저장 프로시저 또는 사용자 정의 함수에 있으면 $CALLER는 호출하는 프로시저 또는 함수의 이름을 반환합니다.If the breakpoint is in a stored procedure or user-defined function called from another stored procedure or function, $CALLER returns the name of the calling procedure or function.

    3. $CALLSTACK은 체인에서 현재 저장 프로시저 또는 사용자 정의 함수를 호출한 함수 호출 스택을 반환합니다.$CALLSTACK returns the call stack of functions in the chain that called the current stored procedure or user-defined function. 중단점이 편집기 창에 있으면 $CALLSTACK은 편집 중인 스크립트 파일의 이름을 반환합니다.If the breakpoint is in the editor window, $CALLSTACK returns the name of the script file being edited.

    4. $FUNCTION은 중단점이 설정된 저장 프로시저 또는 사용자 정의 함수의 이름을 반환합니다.$FUNCTION returns the name of the stored procedure or user-defined function where the breakpoint is set. 중단점이 편집기 창에 설정되어 있으면 $FUNCTION은 편집 중인 스크립트 파일의 이름을 반환합니다.If the breakpoint is set in the editor window, $FUNCTION returns the name of the script file being edited.

    5. $PID 및 $PNAME은 Transact-SQLTransact-SQL 이 실행되고 있는 데이터베이스 엔진 인스턴스를 실행하는 운영 체제 프로세스의 ID 및 이름을 반환합니다.$PID and $PNAME return the ID and name of the operating system process running the instance of the Database Engine where the Transact-SQLTransact-SQL is running. $PID는 SERVERPROPERTY('ProcessID')와 동일한 ID를 반환합니다. 다른 점은 $PID는 16진수 값이고 SERVERPROPERTY('ProcessID')는 10진수 값이라는 것입니다.$PID returns the same ID as SERVERPROPERTY(‘ProcessID’), except that $PID is a hexadecimal value while SERVERPROPERTY(‘ProcessID’) is a decimal value.

    6. $TID 및 $TNAME은 Transact-SQLTransact-SQL 일괄 처리를 실행하는 운영 체제 스레드의 ID 및 이름을 반환합니다.$TID and $TNAME return the ID and name of the operating system thread running the Transact-SQLTransact-SQL batch. 이 스레드는 데이터베이스 엔진 인스턴스를 실행하는 프로세스에 연결되어 있는 스레드입니다.The thread is one associated with the process running the instance of the Database Engine. $TID는 SELECT kpid FROM sys.sysprocesses WHERE spid = @@SPID와 동일한 값을 반환합니다. 다른 점은 $TID는 16진수 값이고 kpid는 10진수 값이라는 것입니다.$TID returns the same value as SELECT kpid FROM sys.sysprocesses WHERE spid = @@SPID, except that $TID is a hexadecimal value while kpid is a decimal value.

  • 백슬래시(\) 문자를 이스케이프 문자로 사용하여 \{, \}, \\등의 중괄호 및 백슬래시를 메시지에 허용할 수 있습니다.You can also use the backslash character (\) as an escape character to allow curly braces and backslashes in the message: \{, \}, and \\.

적중될 때 동작을 지정하려면To Specify a When Hit Action

  1. 편집기 창에서 중단점 문자 모양을 마우스 오른쪽 단추로 클릭한 다음 바로 가기 메뉴에서 적중될 때 를 클릭합니다.In the editor window, right-click the breakpoint glyph, and then click When Hit on the shortcut menu.

    -또는--or-

    중단점 창에서 중단점 문자 모양을 마우스 오른쪽 단추로 클릭한 다음 바로 가기 메뉴에서 적중될 때 를 클릭합니다.In the Breakpoints window, right-click the breakpoint glyph, and then click When hit on the shortcut menu.

  2. 중단점이 적중될 때 대화 상자에서 원하는 동작을 선택합니다.In the When Breakpoint Is Hit dialog box, select the behavior you want:

    1. 중단점이 적중될 때 디버거 출력 창에 메시지를 출력하려면 메시지 표시 를 선택합니다.Select Print a Message to print a message in the debugger Output window when the breakpoint is hit.

    2. 매크로 실행 옵션은 Transact-SQLTransact-SQL 디버거에서 사용할 수 없으므로 회색으로 나타납니다.The Run a Macro option is not available from the Transact-SQLTransact-SQL debugger, and is greyed out.

    3. 중단점이 실행을 일시 중지하지 않도록 하려면 계속 실행 을 선택합니다.Select Continue execution if you do not want the breakpoint to pause execution. 이 옵션은 메시지 표시 옵션을 선택한 경우에만 활성화됩니다.This option is active only if you have selected the Print a Message option.

  3. 확인 을 클릭하여 변경 내용을 구현하거나 취소 를 클릭하여 변경 내용을 적용하지 않고 종료합니다.Click OK to implement the changes, or Cancel to exit without applying the changes.

참고 항목See Also

중단점 조건 지정 Specify a Breakpoint Condition
적중 횟수 지정 Specify a Hit Count