catalog.get_parameter_values (Banco de Dados SSISDB)

Artigo
05/23/2023

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

Aplica-se: SQL Server

Resolve e recupera os valores de parâmetro padrão de um projeto e os 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 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. 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 do 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.
exigido	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çã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 um erro ou um aviso:

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

Partilhar via