サインイン

Select the product you need help with

[FIX] Sysprocesses システムテーブルのハンドルに対する SQL テキストを返す fn_get_sql 関数

文書番号: 325607 - 対象製品

すべて展開する | すべて折りたたむ

概要

この資料では、以下の変更を実装する、SQL Server 2000 の機能上の修正プログラムについて説明します。

この修正プログラムによって、新しい fn_get_sql システムテーブル値関数が作成されます。
この修正プログラムによって、以下の 3 つの新しい列が master..sysprocesses システムテーブルの末尾に追加されます。
- sql_handle (binary)
- stmt_start (int)
- stmt_end (int)
この修正プログラムによって、新しいトレースフラグ 2861 が作成されます。

先頭へ戻る | フィードバック

解決方法

この問題を解決するには、Microsoft SQL Server 2000 の最新の Service Pack を入手します。関連情報を参照するには、以下の「サポート技術情報」 (Microsoft Knowledge Base) をクリックしてください。

290211

(http://support.microsoft.com/kb/290211/ )

最新の SQL Server 2000 Service Pack の入手方法

注 : 次の修正プログラムは Microsoft SQL Server 2000 Service Pack 3 がリリースされる前に作成されました。

修正プログラムファイル

fn_get_sql 関数を実装する、SQL Server 2000 の修正プログラムがあります。

Microsoft Product Support Services にお問い合わせのうえ、修正プログラムを入手してください。修正プログラム (英語版) のファイル属性は次表のとおりです。ただし、これより新しい修正プログラムがリリースされている可能性もあります。各ファイルの日付および時刻は、世界協定時刻 (UTC) で示されています。ファイル情報に表示される時刻は、ローカル時刻に変換されています。UTC とローカル時刻との時差を確認するには、コントロールパネルの [日付と時刻] の [タイムゾーン] タブを使用してください。

   日付            時刻       バージョン    サイズ              ファイル名
   -----------------------------------------------------------------

   07/01/2002   4:50 PM   8.00.652   7,285 kilobytes   Sqlservr.exe

注 : ファイルの依存関係のため、最新の修正プログラムまたは機能には上記以外の追加ファイルが含まれていることがあります。

重要 : この修正プログラムの機能が必要な場合は、Sqlservr.exe のビルド 8.00.652 以降を適用し、この修正プログラムに含まれている Sp2_qfe_serv_uni.sql ファイルを実行する必要があります。詳細については、修正プログラムファイルに含まれている Readme.txt ファイルを参照してください。

状況

マイクロソフトでは、この問題をこの資料の冒頭に記載したマイクロソフト製品の問題として認識しています。この問題は、Microsoft SQL Server 2000 Service Pack 3 で最初に修正されました。

詳細

fn_get_sql システムテーブル値関数の定義と構文は以下のとおりです。

fn_get_sql

指定したハンドルで参照される SQL テキストを返します。

構文

fn_get_sql ([@SqlHandle = ]SqlHandle)

引数

[@SqlHandle = ] SqlHandle

バイナリのハンドル値です。SqlHandle は、デフォルト値を持たない binary(20) です。

戻りテーブル

元に戻す全体を表示する

列名	データ型	説明
dbid	smallint	データベース ID。アドホック SQL ステートメントの場合は NULL です。
objectid	int	データベースオブジェクトの ID。アドホック SQL ステートメントの場合は NULL です。
number	smallint	プロシージャがグループ化されている場合は、グループ内の番号。プロシージャではないエントリの場合は 0 です。アドホック SQL ステートメントの場合は NULL です。
encrypted	bit	オブジェクトが暗号化されているかどうかを示します。 0 = 暗号化されていない 1 = 暗号化されている
Text	text	SQL テキスト。暗号化されたオブジェクトの場合は NULL です。

解説

fn_get_sql は、指定した SQLHANDLE の SQL テキストを返すシステムテーブル値関数です。有効な SQLHANDLE は、sysprocesses システムテーブルの sql_handle 列から取得できます。

既にキャッシュに存在しないハンドルを渡した場合、fn_get_sql は空の結果セットを返します。無効なハンドルを渡した場合、バッチが中断され、次のエラーメッセージが表示されます。

サーバー : メッセージ 569、レベル 16、状態 1、プロシージャ fn_get_sql、行 12fn_get_sql に渡されたハンドルが無効でした。

SQL Server では、一括操作のステートメントや 8 KB を超える文字列リテラルを含むステートメントなど、一部の Transact-SQL ステートメントをキャッシュできません。このようなステートメントのハンドルは、fn_get_sql 関数を使用して取得できません。

text 列では、パスワードを含む可能性があるテキストがフィルタ処理されます。監視されないセキュリティ関連のストアドプロシージャの詳細については、SQL Server Books Online の「トレースの制限」を参照してください。

権限

fn_get_sql 関数を実行できるのは、sysadmin 固定サーバーロールのメンバのみです。

例

fn_get_sql 関数が返す情報は、DBCC INPUTBUFFER コマンドで返される情報に似ています。次のように DBCC INPUTBUFFER が制限されている場合には、fn_get_sql 関数を使用します。

イベントが 255 文字を超える場合。
ストアドプロシージャの現在最高のネストレベルを返す必要がある場合。たとえば、sp_1 および sp_2 という名前の 2 つのストアドプロシージャがあるとします。sp_1 が sp_2 を呼び出し、sp_2 の実行中にハンドルを sysprocesses システムテーブルから取得する場合、fn_get_sql 関数は sp_2 に関する情報を返します。さらに、fn_get_sql 関数は現在最高のネストレベルでストアドプロシージャ全体を返します。

データベース管理者は、fn_get_sql 関数を使用して、問題のプロセスを診断できます。管理者は問題のサーバープロセス ID (SPID) を特定した後、その SPID の SQLHANDLE を取得します。次に、このハンドルを指定して fn_get_sql 関数を呼び出し、開始オフセットと終了オフセットを使用して問題の SPID の SQL テキストを特定します。以下に例を示します。

DECLARE @Handle binary(20)
SELECT @Handle = sql_handle FROM sysprocesses WHERE spid = 52
SELECT * FROM ::fn_get_sql(@Handle)

また、fn_get_sql 関数を使用して、サーバーを連続的に監視することもできます。たとえば、sysprocesses システムテーブルから SQLHANDLE、およびステートメントの開始オフセットと終了オフセットを定期的に取得するクライアントツールがあるとします。そのツールは、SQL ハンドルを一意キーとして、さらに fn_get_sql 関数の結果を値として持つ SQL テキストのキャッシュを管理します。ツールは、sysprocesses システムテーブル行セット内の行ごとに、SQLHANDLE に基づいてそのキャッシュ内のテキストを検索します。テキストがそのツールのキャッシュに存在しない場合、ツールは fn_get_sql 関数を呼び出し、テキストを取得してキャッシュに保存します。

トレースフラグ 2861

トレースフラグ 2861 は、SQL Server がキャッシュにコスト 0 のプランを保持するように指示します。SQL Server は、通常、単純なアドホッククエリ、Set ステートメント、コミットトランザクションなどをキャッシュしません。

トレースフラグ 2861 を有効にすると、fn_get_sql 関数は、コスト 0 のプランを含むアクティビティの SQL テキストを返すことができます。トレースフラグ 2861 を無効にすると、fn_get_sql 関数は、コスト 0 のプランを含むアクティビティの SQL テキストを返すことができません。
この修正プログラムを適用した場合、デフォルトでは、トレースフラグ 2861 は無効になります。

解説

トレースフラグ 2861 を有効にすると、プロシージャキャッシュ内のオブジェクト数が増加します。しかし、追加されるオブジェクトは非常に小さいため、プロシージャキャッシュのメモリ使用量の増加はわずかです。

SQL Server 2000 には、指定した任意の SQL ステートメントのための既存の実行プランを検索するための効率的なアルゴリズムがあります。ただし、プロシージャキャッシュに格納されるオブジェクト数が増加するため、リレーショナルエンジンが既存のプランを検索する際にかかる時間が増加し、システムのパフォーマンスに悪影響を与える可能性があります。

通常、データベースサイズがメモリサイズよりも非常に大きいシステムでは、メモリ不足になることが予想されます。他のオブジェクトのためにメモリが必要であるような状況でメモリが不足する場合、lazywriter プロセスはプロシージャキャッシュ内のオブジェクトの割り当てを解除します。これによって、プロシージャキャッシュのサイズが適正に保たれ、この変更によって発生する可能性のある悪影響が最小限に抑えられます。

ただし、メモリサイズがデータベースサイズより大きいシステムでは、通常、メモリ不足になりません。その結果、メモリ不足のためにオブジェクトの割り当てがプロシージャキャッシュから解除されることはありません。そのため、プロシージャキャッシュのサイズが、パフォーマンスに悪影響を与える程度まで大きくなることがあります。

システムパフォーマンスに悪影響が出た場合には、以下の手順を実行します。

トレースフラグ 2861 を無効にします。
クエリアナライザから DBCC FREEPROCCACHE コマンドを実行します。SQL Server を再起動する必要はありません。

先頭へ戻る | フィードバック

プロパティ

文書番号: 325607 - 最終更新日: 2006年1月24日 - リビジョン: 5.2

この資料は以下の製品について記述したものです。

Microsoft SQL Server 2000 Standard Edition

kbhotfixserver kbqfe kbsqlserv2000sp3fix kbfix kbinfo kbsqlserv2000presp3fix KB325607

"Microsoft Knowledge Baseに含まれている情報は、いかなる保証もない現状ベースで提供されるものです。Microsoft Corporation及びその関連会社は、市場性および特定の目的への適合性を含めて、明示的にも黙示的にも、一切の保証をいたしません。さらに、Microsoft Corporation及びその関連会社は、本文書に含まれている情報の使用及び使用結果につき、正確性、真実性等、いかなる表明・保証も行ないません。Microsoft Corporation、その関連会社及びこれらの権限ある代理人による口頭または書面による一切の情報提供またはアドバイスは、保証を意味するものではなく、かつ上記免責条項の範囲を狭めるものではありません。Microsoft Corporation、その関連会社及びこれらの者の供給者は、直接的、間接的、偶発的、結果的損害、逸失利益、懲罰的損害、または特別損害を含む全ての損害に対して、状況のいかんを問わず一切責任を負いません。（Microsoft Corporation、その関連会社またはこれらの者の供給者がかかる損害の発生可能性を了知している場合を含みます。) 結果的損害または偶発的損害に対する責任の免除または制限を認めていない地域においては、上記制限が適用されない場合があります。なお、本文書においては、文書の体裁上の都合により製品名の表記において商標登録表示、その他の商標表示を省略している場合がありますので、予めご了解ください。"

先頭へ戻る | フィードバック