• [アーティクル]

DBCC TRACEON (Transact-SQL)

指定されたトレース フラグを有効にします。

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

構文

DBCC TRACEON ( trace# [ ,...n ][ , -1 ] ) [ WITH NO_INFOMSGS ]

引数

  • trace#
    有効にするトレース フラグの番号を指定します。

  • n
    複数のトレース フラグを指定できることを示すプレースホルダです。

  • -1
    指定されたトレース フラグをグローバルに有効にします。

  • WITH NO_INFOMSGS
    すべての情報メッセージを表示しないようにします。

説明

稼働サーバーでは、予期しない動作を避けるため、次のいずれかの方法を使用してトレース フラグをサーバー規模でのみ有効にすることをお勧めします。

  • Sqlservr.exe のコマンド ライン スタートアップ オプション -T を使用します。すべてのステートメントがトレース フラグを有効にした状態で実行されるので、この方法をお勧めします。これらはスタートアップ スクリプトのコマンドに含まれています。詳細については、「sqlservr アプリケーション」を参照してください。

  • DBCC TRACEON (trace# [, ....n],-1) は、システムでユーザーまたはアプリケーションが同時にステートメントを実行していない場合にのみ使用します。

トレース フラグは、SQL Server の動作を制御して特定の特性をカスタマイズするために使用されます。トレース フラグは、有効になると、DBCC TRACEOFF ステートメントを実行して無効にするまで、サーバー内では有効のままです。SQL Server には、セッションとグローバルという 2 種類のトレース フラグがあります。セッション トレース フラグは、1 つの接続についてアクティブで、その接続に対してのみ表示可能です。グローバル トレース フラグは、サーバー レベルで設定され、サーバー上のすべての接続に対して表示可能です。トレース フラグの状態を確認するには、DBCC TRACESTATUS を使用します。トレース フラグを無効にするには、DBCC TRACEOFF を使用します。

結果セット

DBCC TRACEON は次の結果セット (メッセージ) を返します。

DBCC execution completed. If DBCC printed error messages, contact your system administrator.

権限

固定サーバー ロール sysadmin のメンバシップである必要があります。

例

次の例では、トレース フラグ 3205 を有効にすることにより、テープ ドライバのハードウェア圧縮を無効にします。このフラグは、現在の接続に対してのみオンとなります。

DBCC TRACEON (3205);
GO

次の例では、トレース フラグ 3205 をグローバルに有効にします。

DBCC TRACEON (3205, -1);
GO

次の例では、トレース フラグ 3205 および 260 をグローバルに有効にします。

DBCC TRACEON (3205, 260, -1);
GO