catalog.get_parameter_values (Banco de Dados SSISDB)

Artigo
03/05/2025

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

Aplica-se a:SQL Server

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

Sintaxe

catalog.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 onde residem os parâmetros. O project_name é nvarchar(128).

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

[ @reference_id = ] reference_id
O identificador exclusivo de uma referência de ambiente. Este parâmetro é opcional. O reference_id é bigint.

Valor do código de retorno

0 (sucesso)

Conjuntos de resultados

Retorna uma tabela que tem o seguinte formato:

Nome da coluna	Tipo de dados	Descrição
object_type	pequeno	O tipo de 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.
sensível	pouco	Quando o valor é `1`, o valor do parâmetro é sensível. Quando o valor é `0`, o valor do parâmetro não é sensível.
Necessário	pouco	Quando o valor é `1`, o valor do parâmetro é necessário para iniciar a execução. Quando o valor é `0`, o valor do parâmetro não é necessário para iniciar a execução.
value_set	pouco	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ção

Os valores literais são exibidos em texto sem formatação. NULL é exibido no lugar de valores sensíveis.

Permissões

Este procedimento armazenado requer 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 um erro ou aviso:

O pacote não pode ser encontrado na pasta ou projeto especificado
O usuário não tem as permissões apropriadas
A referência de ambiente especificada não existe

Partilhar via