catalog.get_parameter_values (base de datos de SSISDB)

Artículo
05/23/2023

Se aplica a:SQL Server SSIS Integration Runtime en Azure Data Factory

Se aplica a:SQL Server

Resuelve y recupera los valores de los parámetros predeterminados de un proyecto y los paquetes correspondientes en el catálogo de Integration Services.

Sintaxis

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
Nombre de la carpeta que contiene el proyecto. folder_name es nvarchar(128) .

[ @project_name = ] project_name
Nombre del proyecto donde los parámetros residen. project_name es nvarchar(128) .

[ @package_name = ] package_name
Nombre del paquete. Especifique el nombre del paquete para recuperar todos los parámetros de proyecto y los parámetros de un paquete concreto. El parámetro package_name es de tipo nvarchar(260).

[ @reference_id = ] reference_id
Identificador único de una referencia de entorno. Este parámetro es opcional. reference_id es bigint.

Valor de código de retorno

0 (correcto)

Conjuntos de resultados

Devuelve una tabla que tiene el siguiente formato:

Nombre de la columna	Tipo de datos	Descripción
object_type	smallint	Tipo de parámetro. El valor es `20` para un parámetro de proyecto y `30` para un parámetro de paquete.
parameter_data_type	nvarchar(128)	El tipo de datos del parámetro.
parameter_name	sysname	El nombre del parámetro.
parameter_value	sql_variant	Valor del parámetro.
sensitive	bit	Cuando el valor es `1`, el valor del parámetro es confidencial. Cuando el valor es `0`, el valor del parámetro no es confidencial.
requerido	bit	Cuando el valor es `1`, se requiere el valor del parámetro para iniciar la ejecución. Cuando el valor es `0`, no se requiere el valor del parámetro para iniciar la ejecución.
value_set	bit	Cuando el valor es `1`, el valor del parámetro se ha asignado. Cuando el valor es `0`, el valor del parámetro no se ha asignado.

Nota

Los valores literales se muestran en texto simple. NULL se muestra en lugar de los valores confidenciales.

Permisos

Este procedimiento almacenado necesita uno de los permisos siguientes:

Permisos de lectura en el objeto y, si es aplicable, el permiso de lectura en el entorno al que se hace referencia
Pertenencia al rol de base de datos de ssis_admin
Pertenencia al rol de servidor de sysadmin

Errores y advertencias

En la siguiente lista se describen algunas condiciones que pueden producir un error o una advertencia:

El paquete no se puede encontrar en la carpeta o proyecto especificados
El usuario no tiene los permisos adecuados.
La referencia del entorno especificado no existe

Compartir vía