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


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

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

Синтаксис

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

  • [ @validate\_type = ] validate_type
    Указывает тип выполняемой проверки. Используйте символ 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 для контроля состояния проверки.

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

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

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