catalog.create_customized_logging_level

  • [アーティクル]

適用対象:SQL Server Azure Data Factory の SSIS Integration Runtime

適用対象: SQL Server 2016 (13.x) 以降のバージョン

新しいカスタマイズされたログ記録レベルを作成します。 カスタマイズされたログ記録レベルの詳細については、「Integration Services (SSIS) のログ記録」を参照してください。

構文

catalog.create_customized_logging_level [ @level_name = ] level_name  
    , [ @level_description = ] level_description  
    , [ @profile_value = ] profile_value  
    , [ @events_value = ] events_value  
    , [ @level_id = ] level_id OUT

引数

[ @level_name = ] level_name
新しいの既存の名前は、ログ記録レベルをカスタマイズします。

level_name は nvarchar(128) です。

[ @level_description = ] level_description
新しいの既存の説明では、ログ記録レベルをカスタマイズします。

level_description は nvarchar(max) です。

[ @profile_value = ] profile_value
新しいする統計情報は、ログに記録するログ記録レベルをカスタマイズできます。

統計情報の有効な値には、次の項目が含まれます。 これらの値は、[カスタマイズされたログ記録レベルの管理] ダイアログ ボックスの [統計] タブの値に対応しています。

  • 実行 = 0

  • ボリューム = 1

  • パフォーマンス = 2

profile_value は bigint です。

[ @events_value = ] events_value
新しいイベントは、ログに記録するログ記録レベルをカスタマイズできます。

イベントの有効な値には、次の項目が含まれます。 これらの値は、[カスタマイズされたログ記録レベルの管理] ダイアログ ボックスの [イベント] タブの値に対応しています。

イベントをイベントのコンテキスト イベントのコンテキストを持つイベント
OnVariableValueChanged = 0

OnExecutionStatusChanged = 1

OnPreExecute = 2

OnPostExecute = 3

OnPreValidate = 4

OnPostValidate = 5

OnWarning = 6

OnInformation = 7

OnError = 8

OnTaskFailed = 9

OnProgress = 10

OnQueryCancel = 11

OnBreakpointHit = 12

OnCustomEvent = 13

Diagnostic = 14

DiagnosticEx = 15

NonDiagnostic = 16		 OnVariableValueChanged_IncludeContext = 32

OnExecutionStatusChanged_IncludeContext = 33

OnPreExecute_IncludeContext = 34

OnPostExecute_IncludeContext = 35

OnPreValidate_IncludeContext = 36

OnPostValidate_IncludeContext = 37

OnWarning_IncludeContext = 38

OnInformation_IncludeContext = 39

OnError_IncludeContext = 40

OnTaskFailed_IncludeContext = 41

OnProgress_IncludeContext = 42

OnQueryCancel_IncludeContext= 43

OnBreakpointHit_IncludeContext = 44

OnCustomEvent_IncludeContext = 45

Diagnostic_IncludeContext = 46

DiagnosticEx_IncludeContext = 47

NonDiagnostic_IncludeContext = 48

events_value は bigint です。

[ @level_id = ] level_id OUT
新しい ID では、ログ記録レベルをカスタマイズします。

level_id は bigint です。

解説

Transact-SQL で profile_value または events_value 引数の複数の値を結合するには、この例に従います。 OnError (8) と DiagnosticEx (15) イベントをキャプチャする場合、event_value を計算する式は 2^8 + 2^15 = 33024 です。

リターン コード

成功した場合は 0 を返します。

ストアド プロシージャが失敗した場合は、エラーをスローします。

結果セット

なし

アクセス許可

このストアド プロシージャには、次の権限のいずれかが必要です。

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

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

エラーおよび警告

ストアド プロシージャが失敗する原因となる条件を以下に示します。

  • ユーザーには、必要なアクセス許可がありません。