catalog.create_customized_logging_level
適用対象: SQL Server Azure Data Factory の SSIS 統合ランタイム
適用対象: 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 サーバー ロールのメンバーシップ
エラーおよび警告
ストアド プロシージャが失敗する原因となる条件を以下に示します。
- ユーザーには、必要なアクセス許可がありません。