Parámetros de Integration Services (SSIS)

Los parámetros de Integration Services (SSIS) permiten asignar valores a las propiedades de los paquetes en el momento de la ejecución de los mismos. Puede crear parámetros de proyecto en el nivel de proyecto y parámetros de paquete en el nivel de paquete. Los parámetros de proyecto se usan para proporcionar cualquier entrada externa que el proyecto recibe a uno o más paquetes del proyecto. Los parámetros de paquete permiten modificar la ejecución del paquete sin tener que modificarlo ni volver a implementarlo.

En SQL Server Data Tools puede crear, modificar o eliminar parámetros del proyecto en la ventana Project.params. Para crear, modificar y eliminar los parámetros de paquetes, use la pestaña Parámetros en el Diseñador de SSIS. Puede asociar un parámetro nuevo o existente a una propiedad de tarea con el cuadro de diálogo Parametrizar. Para obtener más información sobre cómo usar la ventana Project.params y las pestaña Parámetros, vea Crear parámetros. Para obtener más información acerca del cuadro de diálogo Parametrizar, vea Parametrizado, cuadro de diálogo.

Parámetros y modelo de implementación de paquetes

En general, si implementa un paquete con el modelo de implementación de paquetes, debe utilizar configuraciones en lugar de parámetros.

Al implementar un paquete que contenga parámetros utilizando el modelo de implementación de paquetes y después ejecutar el paquete, los parámetros no se llaman durante la ejecución. Si el paquete contiene parámetros de paquetes y las expresiones dentro del paquete utilizan los parámetros, los valores resultantes se aplican en tiempo de ejecución. Si el paquete contiene parámetros de proyecto, la ejecución del paquete puede producir un error.

Modelo de implementación de proyectos y paquetes

Al implementar un proyecto de servidor de Integration Services , use las vistas, los procedimientos almacenados y la interfaz de usuario de SQL Server Management Studio para administrar los parámetros de paquete y del proyecto. Para obtener más información, vea los siguientes temas.

• Vistas (catálogo de Integration Services)

• Procedimientos almacenados (catálogo de Integration Services)

• Cuadro de diálogo Configurar

• Cuadro de diálogo Ejecutar paquete

Valores de parámetros

Puede asignar hasta tres tipos de valores para un parámetro. Cuando se inicia la ejecución del paquete, se utiliza un único valor para el parámetro y el parámetro se resuelve en un valor literal final.

La tabla siguiente enumera los tipos de valores.

Puede utilizar un único parámetro para asignar un valor a varias propiedades del paquete. A una propiedad del paquete se le puede asignar un valor solo de un único parámetro.

Ejecuciones y valores de parámetros

La ejecución es un objeto que representa una sola instancia de ejecución del paquete. Cuando se crea una ejecución, debe especificar todos los detalles para ejecutar un paquete como los valores de los parámetros de ejecución. También puede modificar los valores de parámetros para las ejecuciones existentes.

Cuando se establece explícitamente un valor de parámetro de ejecución, el valor solo es aplicable a esa instancia de ejecución concreta. El valor de ejecución se utiliza en lugar de un valor de servidor o de un valor de diseño. Si no establece explícitamente un valor de ejecución y se ha especificado un valor de servidor, se utiliza el valor del servidor.

Si un parámetro se marca como sea necesario, se debe especificar el valor de servidor o el valor de ejecución para ese parámetro. De lo contrario, el paquete correspondiente no se ejecuta. Aunque el parámetro tenga un valor predeterminado en tiempo de diseño, nunca se usará una vez que se implemente el proyecto.

Variables de entorno

Si un parámetro hace referencia a una variable de entorno, el valor literal de esa variable se resuelve mediante la referencia de entorno especificada y se aplica al parámetro. El valor del parámetro literal final que se utiliza para la ejecución del paquete se conoce como valor de parámetro de ejecución. Especifica la referencia de entorno para una ejecución mediante el cuadro de diálogo Ejecutar

Si un parámetro de proyecto hace referencia a una variable de entorno y el valor literal de la variable no puede resolverse en la ejecución, se utiliza el valor de diseño. El valor del servidor no se utiliza.

Para ver las variables de entorno que se asignan a los valores de parámetro, consulte la vista catalog.object_parameters. Para obtener más información, vea catalog.object_parameters (base de datos de SSISDB).

Determinar los valores de parámetros de ejecución

Pueden utilizarse las vistas y el procedimiento almacenado siguientes de Transact-SQL para mostrar y establecer los valores de parámetro.

• catalog.execution_parameter_values (base de datos de SSISDB) (vista)
  Muestra los valores de parámetros reales que serán utilizados por una ejecución concreta

• catalog.get_parameter_values (base de datos de SSISDB) (procedimiento almacenado)
  Resuelve y muestra los valores reales del paquete y la referencia de entorno especificados

• catalog.object_parameters (base de datos de SSISDB) (vista)
  Muestra los parámetros y las propiedades de todos los paquetes y proyectos en el catálogo de Integration Services , incluidos los valores predeterminados de servidor y de diseño.

• catalog.set_execution_parameter_value (base de datos de SSISDB)
  Establece el valor de un parámetro para una instancia de ejecución en el catálogo Integration Services.

También puede utilizar el cuadro de diálogo Ejecutar paquete en SQL Server Data Tools (SSDT) para modificar el valor de parámetro. Para obtener más información, vea Cuadro de diálogo Ejecutar paquete.

También puede utilizar la opción de /Parameter dtexec para modificar un valor de parámetro. Para obtener más información, vea dtexec (utilidad).

Validación de parámetros

Si los valores de parámetros no se pueden resolver, la ejecución del paquete correspondiente generará un error. Para ayudar a evitar errores, puede validar los proyectos y los paquetes mediante el cuadro de diálogo Validar en SQL Server Data Tools (SSDT). La validación permite confirmar que todos los parámetros tienen los valores necesarios o pueden resolver los valores necesarios con referencias de entorno específicas. La validación comprueba también otros problemas comunes del paquete.

Para obtener más información, vea Validar, cuadro de diálogo.

Ejemplo de parámetro

En este ejemplo se describe un parámetro denominado pkgOptions que se utiliza para especificar opciones para el paquete en que reside.

En tiempo de diseño, cuando el parámetro se creó en SQL Server Data Tools, se asignó al parámetro el valor predeterminado 1. Este valor predeterminado se conoce como valor predeterminado de diseño. Si el proyecto se implementó en el catálogo de SSISDB y no se asignaron otros valores a este parámetro, se asignará a la propiedad del paquete correspondiente al parámetro pkgOptions el valor 1 durante la ejecución del paquete. El valor predeterminado de diseño se mantiene con el proyecto en su ciclo de vida.

En la preparación de una instancia específica de la ejecución del paquete, se asigna el valor 5 al parámetro pkgOptions. Este valor se conoce como valor de ejecución porque se aplica al parámetro solo para esa instancia concreta de ejecución. Cuando se inicia la ejecución, se asigna el valor 5 a la propiedad del paquete correspondiente al parámetro pkgOptions.

Tareas relacionadas

Crear parámetros

Establecer valores de parámetro después de la implementación del proyecto

Contenido relacionado

Entrada de blog, Sugerencia rápida de SSIS: parámetros necesarios, en mattmasson.com.