catalog.create_customized_logging_level

适用于: SQL Server(所有受支持的版本) Azure 数据工厂中的 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) 事件,计算 events_value 的公式为 2^8 + 2^15 = 33024

返回代码

0(成功)

存储过程失败时引发错误。

结果集

权限

此存储过程需要下列权限之一:

  • ssis_admin 数据库角色中的成员资格

  • sysadmin 服务器角色中的成员资格

错误和警告

下表说明了导致存储过程失败的情况。

  • 用户不具有所需的权限。