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

Применимо к: SQL Server Integration Runtime служб SSIS в Фабрика данных Azure

Применимо к:SQL Server

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

Синтаксис

catalog.validate_project [ @folder_name = ] folder_name  
    , [ @project_name = ] project_name  
    , [ @validate_type = ] validate_type  
    , [ @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) .

[ @validate_type = ] validate_type
Указывает тип выполняемой проверки. Используйте символ F для выполнения полной проверки. Этот параметр является необязательным. По умолчанию будет использоваться символ F. Параметр validate_type имеет тип char(1).

[ @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 для контроля состояния проверки.

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

В этом выпуске проверка проектов не поддерживает проверку зависимостей.

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