次の方法で共有

dm_execution_performance_counters (SSISDB データベース)

  • [アーティクル]

Integration Services サーバーで処理中の実行のパフォーマンス統計を返します。

構文

dm_execution_performance_counters [ @execution_id = ] execution_id

引数

  • [ @execution\_id = ] execution_id
    1 つまたは複数のパッケージを含む実行の一意識別子。 パッケージ実行タスクで実行されるパッケージは、親パッケージと同じ実行で実行されます。

    実行 ID が指定されていない場合は、複数の実行のパフォーマンス統計が返されます。 ssis_admin データベース ロールのメンバーである場合は、処理中のすべての実行のパフォーマンス統計が返されます。 ssis_admin データベース ロールのメンバーでない場合は、処理中の実行のうち読み取り権限を持つ実行のパフォーマンス統計が返されます。 execution_id は BigInt 型です。

解説

次の表に、dm_execution_performance_counter 関数によって返されるカウンター名の値を一覧で示します。

カウンター名

説明

BLOB bytes read

データ フロー エンジンがすべてのソースから読み取るバイナリ ラージ オブジェクト (BLOB) データのバイト数。

BLOB bytes written

データ フロー エンジンがすべての出力先に書き込む BLOB データのバイト数。

BLOB files in use

データ フロー エンジンがスプールのために使用している BLOB ファイル数。

Buffer memory

物理メモリや仮想メモリなど、Integration Services のバッファーによって使用されるメモリ量。

Buffers in use

すべてのデータ フロー コンポーネントおよびデータ フロー エンジンが使用している、すべての種類のバッファー オブジェクト数。

Buffers spooled

ディスクに書き込むバッファーの数。

Flat buffer memory

すべてのフラット バッファーが使用するメモリ量 (バイト単位)。 フラット バッファーはコンポーネントがデータの格納に使用するメモリ ブロックです。

Flat buffers in use

データ フロー エンジンが使用するフラット バッファー数。 フラット バッファーはすべてプライベート バッファーです。

Private buffer memory

すべてのプライベート バッファーが使用しているメモリ量。 プライベート バッファーは、変換が一時作業のために使用するバッファーです。

データ フロー エンジンがデータ フローをサポートするためにバッファーを作成する場合、バッファーはプライベートではありません。

Private buffers in use

変換が一時作業のために使用するバッファー数。

Rows read

実行準備ができている行の合計数。

Rows written

実行によって書き込まれた行の合計数。

戻り値

dm_execution_performance_counters 関数は、1 つの処理中の実行に対して次の列を持つ表を返します。 返す情報は、実行に含まれているすべてのパッケージが対象です。 処理中の実行がない場合は、空の表を返します。

列名

列の型

説明

解説

execution_id

BigInt

NULL は無効な値です。

パッケージを含む実行の一意識別子。

counter_name

nvarchar(128)

カウンターの名前。

値の「解説」セクションを参照してください。

counter_value

BigInt

カウンターによって返される値です。

使用例

次の例では、ID が 34 である処理中の実行の統計を関数で返します。

select * from [catalog].[dm_execution_performance_counters] (34)

次の例では、権限に応じて、Integration Services サーバーで処理中のすべての実行の統計を関数で返します。

select * from [catalog].[dm_execution_performance_counters] (NULL)

権限

この関数には、次の権限のいずれかが必要です。

  • 実行のインスタンスの READ および MODIFY 権限

  • ssis_admin データベース ロールのメンバーシップ

  • sysadmin サーバー ロールのメンバーシップ

エラーおよび警告

関数が失敗する原因となる条件を以下に示します。

  • ユーザーには指定された実行に対する MODIFY 権限がない。

  • 指定された実行 ID が無効である。