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

Статья
05/23/2023

Область применения: среда выполнения интеграции SSIS SQL Server в Фабрика данных 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 для контроля состояния проверки.

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

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

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

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