catalog.validate_project (Banco de Dados SSISDB)

se aplica a:SQL Server SSIS Integration Runtime no Azure Data Factory

Aplica-se a:SQL Server

Valida de forma assíncrona um projeto no catálogo do Integration Services.

Sintaxe

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 ]  

Argumentos

[ @folder_name = ] folder_name
O nome de uma pasta que contém o projeto. O folder_name é nvarchar(128).

[ @project_name = ] project_name
O nome do projeto. O project_name é nvarchar(128).

[ @validate_type = ] validate_type
Indica o tipo de validação a ser executada. Use o F de caracteres para executar uma validação completa. Este parâmetro é opcional, o F de caracteres será usado por padrão. O validate_type é char(1).

[ @validation_id = ] validation_id
Retorna o identificador exclusivo (ID) da validação. O validation_id é bigint.

[ @use32bitruntime = ] use32bitruntime
Indica se o tempo de execução de 32 bits deve ser usado para executar o pacote em um sistema operacional de 64 bits. Use o valor de 1 para executar o pacote com o tempo de execução de 32 bits ao executar em um sistema operacional de 64 bits. Use o valor de 0 para executar o pacote com o tempo de execução de 64 bits ao executar em um sistema operacional de 64 bits. Este parâmetro é opcional. O use32bitruntime é bit.

[ @environment_scope = ] environment_scope
Indica as referências de ambiente que são consideradas pela validação. Quando o valor é A, todas as referências de ambiente associadas ao projeto são incluídas na validação. Quando o valor é S, apenas uma única referência de ambiente é incluída. Quando o valor é D, nenhuma referência de ambiente é incluída e cada parâmetro deve ter um valor padrão literal para passar na validação. Este parâmetro é opcional, o D de caracteres será usado por padrão. O environment_scope é char(1).

[ @reference_id = ] reference_id
A ID exclusiva da referência de ambiente. Este parâmetro é necessário somente quando uma única referência de ambiente é incluída na validação, quando environment_scope é S. O reference_id é bigint.

Valores do código de retorno

0 (sucesso)

Conjuntos de resultados

A saída das etapas de validação é retornada como seções diferentes do conjunto de resultados.

Permissões

Este procedimento armazenado requer uma das seguintes permissões:

• Permissões READ no projeto e, se aplicável, permissões READ nos ambientes referenciados

• Associação à função de banco de dados ssis_admin

• Associação à função de servidor sysadmin

Erros e Avisos

A lista a seguir fornece algumas condições que podem gerar um erro ou aviso:

• A validação falha para um ou mais pacotes no projeto

• A validação falhará se um ou mais dos ambientes referenciados incluídos na validação não contiverem variáveis referenciadas

• O tipo de validação especificado não é válido

• O nome do projeto ou ID de referência do ambiente não é válido

• O usuário não tem as permissões apropriadas

Comentários

A validação ajuda a identificar problemas que impedirão que os pacotes no projeto sejam executados com êxito. Use o catalog.validations ou catalog.operations modos de exibição para monitorar o status de validação.

Somente ambientes acessíveis pelo usuário podem ser usados na validação. A saída de validação é enviada ao cliente como um conjunto de resultados.

Nesta versão, a validação de projeto não oferece suporte à validação de dependência.

A validação completa confirma que todas as variáveis de ambiente referenciadas são encontradas dentro dos ambientes referenciados que foram incluídos na validação. Os resultados da validação completa listam as referências de ambiente que não são válidas e as variáveis de ambiente referenciadas que não puderam ser encontradas em nenhum dos ambientes referenciados que foram incluídos na validação.