catalog.validate_package (база данных SSISDB)

Статья
05/23/2023

Область применения: среда выполнения интеграции SSIS SQL Server в Фабрика данных Azure

Область применения: SQL Server

Асинхронно проверяет пакет в каталоге служб Integration Services.

Синтаксис

catalog.validate_package [ @folder_name = ] folder_name  
    , [ @project_name = ] project_name  
    , [ @package_name = ] package_name  
    , [ @validation_id = ] validation_id OUTPUT  
 [  , [ @use32bitruntime = ] use32bitruntime ]  
 [  , [ @environment_scope = ] environment_scope ]  
 [  , [ @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-разрядной операционной системе. Используйте значение 1 для выполнения пакета в 32-разрядной среде выполнения при его запуске в 64-разрядной операционной системе. Используйте значение 0 для выполнения пакета в 64-разрядной среде выполнения при его запуске в 64-разрядной операционной системе. Это необязательный параметр. Параметр use32bitruntime имеет тип bit.

[ @environment_scope = ] environment_scope
Указывает ссылки на среду, которые учитываются при проверке. Если это значение равно A, то в проверку включены все ссылки на среду, связанные с проектом. Если это значение равно S, то включена лишь единственная ссылка на среду. Если это значение равно D, то никакие ссылки на среду не включены и каждый параметр, чтобы пройти проверку, должен иметь литеральное значение по умолчанию. Это необязательный параметр. По умолчанию используется знак D. Параметр environment_scope имеет тип char(1).

[ @reference_id = ] reference_id
Уникальный идентификатор ссылки на среду. Этот параметр является обязательным, только если в проверку включена единственная ссылка на среду, при том что environment_scope имеет значение S. Параметр reference_id имеет тип bigint.

Значения кода возврата

0 (успешное завершение)

Результирующие наборы

нет

Разрешения

Эта хранимая процедура требует применения одного из следующих разрешений:

Разрешения READ на проект, а также, если применимо, разрешения READ на среды, указанные в ссылках
Членство в роли базы данных ssis_admin
Членство в роли сервера sysadmin

Ошибки и предупреждения

Следующий список содержит описания некоторых условий, которые могут вызвать ошибку или предупреждение.

Имя проекта или имя пакета недопустимы
Пользователь не имеет соответствующих разрешений
Одна или несколько ссылочных сред, включенных в проверку, не содержат переменные, на которые имеется ссылка
Пакет не прошел проверку
Среда, на которую указывает ссылка, не существует.
Не удается найти переменные, на которые имеется ссылка, в ссылочных средах, включенных в проверку
Параметры пакета ссылаются на переменные, но в проверку не включены ссылочные среды

Замечания

Проверка помогает выявить проблемы, которые могут помешать пакету правильно выполняться. Используйте представления catalog.validations или catalog.operations для контроля состояния проверки.

Поделиться через