CONTEXT_INFO (Transact-SQL)

SET CONTEXT_INFO ステートメントを使用して現在のセッションまたはバッチに設定された context_info 値を返します。

トピック リンク アイコン Transact-SQL 構文表記規則

構文

CONTEXT_INFO()

戻り値

context_info の値、または context_info が設定されていない場合は NULL が返されます。

説明

複数のアクティブな結果セット (MARS) によって、アプリケーションは複数のバッチまたは要求を同じ接続上で同時に実行できます。 MARS 接続上の 1 つのバッチで SET CONTEXT_INFO を実行する場合、CONTEXT_INFO 関数を SET ステートメントと同時に実行すると、新しいコンテキスト値が返されます。 接続上のその他の 1 つ以上のバッチで CONTEXT_INFO 関数を実行するには、SET ステートメントの実行が完了した後のバッチで開始しないと、新しい値は返されません。

権限

特に必要な権限はありません。 コンテキスト情報は、sys.dm_exec_requestssys.dm_exec_sessions、および sys.sysprocesses システム ビュー内にも保存されますが、これらのビューを直接クエリする場合は SELECT および VIEW SERVER STATE 権限が必要です。

使用例

次の簡単な例では、context_info 値を 0x1256698456 に設定してから、CONTEXT_INFO 関数を使用して値を取得します。

SET CONTEXT_INFO 0x1256698456
GO
SELECT CONTEXT_INFO()
GO

関連項目

参照

SET CONTEXT_INFO (Transact-SQL)