catalog.validate_package (Banco de Dados SSISDB)

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

Sintaxe

validate_package [ @folder_name = ] folder_name
    , [ @project_name = ] project_name
    , [ @package_name = ] package_name
    , [ @validation_id = ] validation_id OUTPUT
 [  , [ @use32bitruntime = ] use32bitruntime ]
 [  , [ @target_environment = ] target_environment ]
 [  , [ @reference_id = ] reference_id ]

Argumentos

• [ @folder\_name = ] folder_name
  O nome da pasta que contém o pacote. O folder_name é nvarchar(128).

• [ @project\_name = ] project_name
  O nome do projeto que contém o pacote. O project_name é nvarchar(128).

• [ @package\_name = ] package_name
  O nome do pacote. O package_name é nvarchar(260).

• [ @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

Nenhum

Permissões

Este 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 descreve algumas condições que podem gerar erros ou avisos:

• O nome do projeto ou pacote não é válido.

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

• Um ou mais dos ambientes referenciados incluído na validação não contêm variáveis referenciadas

• Há falha na validação do pacote

• O ambiente referenciado não existe

• As variáveis referenciadas não podem ser localizadas nos ambientes referenciados incluídos na validação

• As variáveis são referenciadas nos parâmetros de pacote, mas nenhum ambiente referenciado foi incluído na validação

Comentários

A validação ajuda a identificar problemas que impedirão a execução bem-sucedida do pacote. Use as exibições catalog.validations ou catalog.operations para monitorar o status da validação.