Partilhar via


catalog.validate_package (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 pacote no catálogo do Integration Services.

Sintaxe

catalog.validate_package [ @folder_name = ] folder_name  
    , [ @project_name = ] project_name  
    , [ @package_name = ] package_name  
    , [ @validation_id = ] validation_id OUTPUT  
 [  , [ @use32bitruntime = ] use32bitruntime ]  
 [  , [ @environment_scope = ] environment_scope ]  
 [  , [ @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 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 caractere D é 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

Nenhum

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 descreve algumas condições que podem gerar um erro ou aviso:

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

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

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

  • A validação do pacote falha

  • O ambiente referenciado não existe

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

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

Comentários

A validação ajuda a identificar problemas que podem impedir que o pacote seja executado com êxito. Use o catalog.validations ou catalog.operations modos de exibição para monitorar o status de validação.