Compartilhar via


catalog.get_parameter_values (Banco de Dados SSISDB)

Resolve e recupera os valores de parâmetro padrão de um projeto e os pacotes correspondentes no catálogo do Integration Services.

Sintaxe

get_parameter_values [ @folder_name = ] folder_name
     , [ @project_name = ] project_name
     , [ @package_name = ] package_name
  [  , [ @reference_id = ] reference_id  ]

Argumentos

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

  • [ @project\_name = ] project_name
    O nome do projeto em que o parâmetro reside. O project_name é nvarchar(128).

  • [ @package\_name = ] package_name
    O nome do pacote. Especifique o nome do pacote para recuperar todos os parâmetros de projeto e os parâmetros de um pacote específico. Use NULL para recuperar todos os parâmetros de projeto e os parâmetros de todos os pacotes. O package_name é nvarchar(260).

  • [ @reference\_id = ] reference_id
    O identificador exclusivo de uma referência do ambiente. Esse parâmetro é opcional. O reference_id é bigint.

Valor de código de retorno

0 (êxito)

Conjuntos de resultados

Retorna uma tabela que tem o seguinte formato:

Nome da coluna

Tipo de dados

Descrição

object_type

smallint

O tipo do parâmetro. O valor é 20 para um parâmetro de projeto e o valor é 30 para um parâmetro de pacote.

parameter_data_type

nvarchar(128)

O tipo de dados do parâmetro.

parameter_name

sysname

O nome do parâmetro.

parameter_value

sql_variant

O valor do parâmetro.

sensitive

bit

Quando o valor é 1, o valor do parâmetro é confidencial. Quando o valor é 0, o valor do parâmetro não é confidencial.

required

bit

Quando o valor é 1, o valor do parâmetro é necessário para iniciar a execução. Quando o valor é 0, o valor de parâmetro não é necessário para iniciar a execução.

value_set

bit

Quando o valor é 1, o valor do parâmetro foi atribuído. Quando o valor é 0, o valor do parâmetro não foi atribuído.

ObservaçãoObservação

Valores literais são exibidos em texto não criptografado. NULL é exibido no lugar de valores confidenciais.

Permissões

Este procedimento armazenado exige uma das seguintes permissões:

  • Permissões READ no projeto e, se aplicável, permissão READ no ambiente referenciado

  • 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:

  • Não é possível encontrar o pacote na pasta ou projeto especificado

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

  • A referência de ambiente especificado não existe