通过

catalog.validate_package（SSISDB 数据库）

  • 项目

以异步方式验证 Integration Services 目录中的包。

语法

validate_package [ @folder_name = ] folder_name
    , [ @project_name = ] project_name
    , [ @package_name = ] package_name
    , [ @validation_id = ] validation_id OUTPUT
 [  , [ @use32bitruntime = ] use32bitruntime ]
 [  , [ @target_environment = ] target_environment ]
 [  , [ @reference_id = ] reference_id ]

参数

  • [ @folder\_name = ] folder_name
    包含包的文件夹的名称。 folder_name 的数据类型为 nvarchar(128)。

  • [ @project\_name = ] project_name
    包含此包的项目的名称。 project_name 的数据类型为 nvarchar(128)。

  • [ @package\_name = ] package_name
    包的名称。 package_name 的数据类型为 nvarchar(260)。

  • [ @validation\_id = ] validation_id
    返回验证的唯一标识符 (ID)。 validation_id 的数据类型为 bigint。

  • [ @use32bitruntime = ] use32bitruntime
    指示是否应使用 32 位运行时在 64 位操作系统上运行包。 在 64 位操作系统上运行时，使用值 1 以便使用 32 位运行时执行此包。 在 64 位操作系统上运行时，使用值 0 以便使用 64 位运行时执行此包。 此参数可选。 use32bitruntime 的数据类型为 bit。

  • [ @environment\_scope = ] environment_scope
    指示由验证考虑的环境引用。 如果值为 A，则验证中包括与项目关联的所有环境引用。 值为 S 时，只包括一个环境引用。 当值为 D 时，不包括环境引用，并且每个参数必须有文字默认值才能通过验证。 此参数是可选的，默认情况下，将使用 D 字符。 environment_scope 的数据类型为 Char(1)。

  • [ @reference\_id = ] reference_id
    环境引用的唯一 ID。 如果 environment_scope 为 S，仅当在验证中包含单个环境引用时，才需要此参数。 reference_id 的数据类型为 bigint。

返回代码值

0（成功）

结果集

无

权限

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

  • 针对项目的 READ 权限，如果适用，则包含针对引用环境的 READ 权限

  • ssis_admin 数据库角色的成员身份

  • sysadmin 服务器角色的成员身份

错误和警告

下面的列表描述了一些可能引发错误或警告的情况：

  • 项目名称或包名称无效

  • 用户不具备适当的权限

  • 验证中包含的一个或多个引用环境不包含引用的变量

  • 包验证失败

  • 所引用的环境不存在

  • 在验证中包含的引用环境中找不到引用的变量

  • 包参数中引用了变量，但验证中不包括任何引用的环境

注释

验证有助于识别将阻止包成功运行的问题。 使用 catalog.validations 或 catalog.operations 视图监视验证状态。