Compartilhar via

catalog.validate_project (Banco de Dados SSISDB)

  • Artigo

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

Aplica-se: SQL Server

De forma assíncrona, valida 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 executado. Use o caractere F para executar uma validação completa. Esse parâmetro é opcional, o caractere F será usado por padrão. 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 runtime de 32 bits deve ser usado para executar o pacote em um sistema operacional de 64 bits. Use o valor 1 para executar o pacote com o runtime de 32 bits ao executar em um sistema operacional de 64 bits. Use o valor 0 para executar o pacote com o runtime 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 a fim de ser aprovado 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 é S. O reference_id é bigint.

Valores do 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

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 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.