Compartilhar via


catalog.validate_project (Banco de Dados SSISDB)

De forma assíncrona, valida um projeto no catálogo do Integration Services.

Sintaxe

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 ]

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 executado. Use o caractere F para executar uma validação completa. O validate_type é char(1).

  • [ @validation\_id = ] validation_id
    Retorna o ID (identificador exclusivo) 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 0 para executar o pacote com o tempo de execução de 64 bits ao executar em um sistema operacional de 64 bits. Esse 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 for A, todas as referências de ambiente associadas ao projeto serão incluídas na validação. Quando o valor for S, apenas uma única referência de ambiente será incluída. Quando o valor for D, nenhuma referência de ambiente será incluída e cada parâmetro deverá ter um valor padrão literal para passar na validação. Esse parâmetro é opcional, o caractere D será usado por padrão. O environment_scope é Char(1).

  • [ @reference\_id = ] reference_id
    A ID exclusiva da referência do ambiente. Esse parâmetro é necessário apenas quando uma única referência de ambiente é incluída na validação, quando environment_scope for S. O reference_id é bigint.

Valores de código de retorno

0 (êxito)

Conjuntos de resultados

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

Permissões

Esse procedimento armazenado exige 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 um 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 o ID de referência de 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 a execução bem-sucedida dos pacotes no projeto. Use as exibições catalog.validations ou catalog.operations para monitorar o status da 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 dá suporte para a validação de dependência.

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