適用対象:
SQL Server
ブレークポイント アクションを実行すると、ブレークポイントに対して Transact-SQL デバッガーによって実行されるカスタム タスクが指定されます。 指定したヒット カウントに達し、指定したブレークポイントの条件が満たされると、ブレークポイントに指定されたアクションがデバッガーによって実行されます。
アクションに関する考慮事項
ブレークポイントの既定のアクションでは、ヒット カウントとブレークポイントの条件の両方が満たされたときに、実行が中断されます。 Transact-SQL デバッガーでのアクションの主な用途は、デバッガーの [出力] ウィンドウに情報を出力することです。
メッセージは、[出力ウィンドウにメッセージを表示します] オプションで指定されるとともに、デバッグ中の Transact-SQL からの情報を含む式を含む文字列として指定されます。 式には、次の内容が含まれます。
中かっこ (
{}) で囲まれた Transact-SQL 式。 式には、Transact-SQL 変数、パラメーター、および組み込み関数を含めることができます。 例としては、{@MyVariable}、{@NameParameter}、{@@SPID}または{SERVERPROPERTY('ProcessID')}です。次のキーワードのいずれかになります。
$ADDRESSは、ブレークポイントが設定されているストアド プロシージャまたはユーザー定義関数の名前を返します。 ブレークポイントがエディター ウィンドウに設定されている場合、$ADDRESSは編集されているスクリプト ファイルの名前を返します。$ADDRESSと$FUNCTIONは、Transact-SQL デバッガーで同じ情報を返します。$CALLERは、ストアド プロシージャまたは関数を呼び出した Transact-SQL コードの単位の名前を返します。 ブレークポイントがエディター ウィンドウにある場合は、$CALLERは<No caller available>を返します。 ブレークポイントが、エディター ウィンドウ内のコードから呼び出されるストアド プロシージャまたはユーザー定義関数にある場合は、$CALLERは編集されているファイルの名前を返します。 ブレークポイントが、他のストアド プロシージャまたは関数から呼び出されるストアド プロシージャまたはユーザー定義関数にある場合は、$CALLERは呼び出しているプロシージャまたは関数の名前を返します。$CALLSTACKは、現在のストアド プロシージャまたはユーザー定義関数を呼び出したチェーン内の関数の呼び出し履歴を返します。 ブレークポイントがエディター ウィンドウにある場合、$CALLSTACKは編集されているスクリプト ファイルの名前を返します。$FUNCTIONは、ブレークポイントが設定されているストアド プロシージャまたはユーザー定義関数の名前を返します。 ブレークポイントがエディター ウィンドウに設定されている場合、$FUNCTIONは編集されているスクリプト ファイルの名前を返します。$PIDと$PNAMEは、Transact-SQL が実行されているデータベース エンジンのインスタンスを実行しているオペレーティング システム プロセスの ID と名前を返します。$PIDはSERVERPROPERTY('ProcessID')と同じ ID を返します。ただし、$PIDは 16 進値、SERVERPROPERTY('ProcessID')は 10 進値です。$TIDおよび$TNAMEは、Transact-SQL バッチを実行しているオペレーティング システム スレッドの ID と名前を返します。 スレッドは、データベース エンジンのインスタンスを実行しているプロセスに関連付けられています。$TIDはSELECT kpid FROM sys.sysprocesses WHERE spid = @@SPIDと同じ値を返します。ただし、$TIDは 16 進値、kpidは 10 進値です。
\、\{、\}のようにバックスラッシュ記号 (\\) をエスケープ文字とすることで、メッセージ内で中かっことバックスラッシュを使用することもできます。
アクションを指定する
エディター ウィンドウで、ブレークポイント グリフを右クリックし、ショートカット メニューの [アクション] を選択します。
または
[ブレークポイント] ウィンドウで、ブレークポイント グリフを右クリックし、ショートカット メニューの [設定] を選択します。
[ブレークポイント設定] ダイアログ ボックスで、[アクション] オプションを選択します。
[出力ウィンドウにメッセージを表示します] ダイアログに、式を入力します。
ブレークポイントの実行を中断したくない場合は、[コードの実行を継続する] を選択します。 このオプションは、[アクション] オプションを選択した場合にのみ有効です。
[閉じる] を選択して変更を実装します。