Partilhar via

catalog.set_object_parameter_value (Banco de Dados SSISDB)

  • Artigo

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

Aplica-se a:SQL Server

Define o valor de um parâmetro no catálogo do Integration Services. Associa o valor a uma variável de ambiente ou atribui um valor literal que é usado por padrão quando nenhum outro valor é atribuído.

Sintaxe

catalog.set_object_parameter_value [ @object_type = ] object_type   
    , [ @folder_name = ] folder_name   
    , [ @project_name = ] project_name   
    , [ @parameter_name = ] parameter_name   
    , [ @parameter_value = ] parameter_value   
 [  , [ @object_name = ] object_name ]  
 [  , [ @value_type = ] value_type ]

Argumentos

[@object_type =] object_type
O tipo de parâmetro. Use o valor 20 para indicar um parâmetro de projeto ou o valor 30 para indicar um parâmetro de pacote. O object_type é smallInt.

[@folder_name =] folder_name
O nome da pasta que contém o parâmetro. O folder_name é nvarchar(128).

[@project_name =] project_name
O nome do projeto que contém o parâmetro. O project_name é nvarchar(128).

[@parameter_name =] parameter_name
O nome do parâmetro. O parameter_name é nvarchar(128).

[@parameter_value =] parameter_value
O valor do parâmetro. O parameter_value é sql_variant.

[@object_name =] object_name
O nome do pacote. Este argumento é necessário quando o parâmetro é um parâmetro de pacote. O object_name é nvarchar(260).

[@value_type =] value_type
O tipo de valor do parâmetro. Use a V de caracteres para indicar que parameter_value é um valor literal que é usado por padrão quando nenhum outro valor é atribuído antes da execução. Use a R de caracteres para indicar que parameter_value é um valor referenciado e foi definido como o nome de uma variável de ambiente. Este argumento é opcional, o caractere V é usado por padrão. O value_type é char(1).

Valor do código de retorno

0 (sucesso)

Conjuntos de resultados

Nenhum

Permissões

Este procedimento armazenado requer uma das seguintes permissões:

  • Permissões LER e MODIFICAR no projeto

  • 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 fazer com que o procedimento armazenado gere um erro:

  • O tipo de parâmetro não é válido

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

  • Para parâmetros de pacote, o nome do pacote não é válido

  • O tipo de valor não é válido

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

Comentários

  • Se nenhum value_type for especificado, um valor literal para parameter_value será usado por padrão. Quando um valor literal é usado, o value_set na visualização object_parameters é definido como 1. Um valor de parâmetro NULL não é permitido.

  • Se value_type contiver o caractere R, que denota um valor referenciado, parameter_value se refere ao nome de uma variável de ambiente.

  • O valor 20 pode ser usado para object_type denotar um parâmetro de projeto. Nesse caso, um valor para object_name não é necessário e qualquer valor especificado para object_name é ignorado. Esse valor é usado quando o usuário deseja definir um parâmetro de projeto.

  • O valor 30 pode ser usado para object_type denotar um parâmetro de pacote. Nesse caso, um valor para object_name é usado para indicar o pacote correspondente. Se object_name não for especificado, o procedimento armazenado retornará um erro e será encerrado.