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 サーバー ロールのメンバーシップ

エラーおよび警告

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

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