Configuraciones de paquetes de SSIS

SQL Server Integration Services proporciona configuraciones de paquetes que se pueden utilizar para actualizar los valores de las propiedades en tiempo de ejecución. Una configuración es una par propiedad/valor que se agrega a un paquete completo. Normalmente, se crean las propiedades establecidas de un paquete para los objetos del paquete durante el desarrollo y, después, se agrega la configuración al paquete. Cuando se ejecuta el paquete, éste recibe de la configuración los nuevos valores de la propiedad. Por ejemplo, al utilizar una configuración, se puede modificar la cadena de conexión de un administrador de conexión o actualizar el valor de una variable. 

Las configuraciones de paquetes ofrecen las siguientes ventajas:

• Permiten mover más fácilmente los paquetes de un entorno de desarrollo a un entorno de producción. Por ejemplo, una configuración puede actualizar la ruta de acceso de un archivo de origen, o bien cambiar el nombre de una base de datos o servidor.

• Son útiles para implementar paquetes en varios servidores distintos. Por ejemplo, una variable en la configuración de cada paquete implementado puede contener un valor de espacio de disco distinto, y si el espacio de disco disponible es menor que dicho valor, el paquete no se ejecuta.

• Aumentan la flexibilidad de los paquetes. Por ejemplo, una configuración puede actualizar el valor de una variable que se utiliza en una expresión de propiedad.

Integration Services admite varios métodos distintos para almacenar configuraciones de paquetes, como archivos XML, tablas de una base de datos de SQL Server y variables de entorno y de paquete.

Cada configuración es una pareja propiedad/valor. El archivo de configuración XML y los tipos de configuración de SQL Server pueden incluir varias configuraciones.

Las configuraciones se incluyen al crear una utilidad de implementación de paquetes para instalar paquetes. Al instalar los paquetes, las configuraciones se pueden actualizar como un paso en la instalación del paquete.

Nota

Para saber más sobre los conceptos explicados en esta sección, vea Tutorial: Implementar paquetes y Lección 3: Agregar configuraciones de paquetes en Tutorial de SSIS> Crear un paquete ETL simple.

Cómo se aplican las configuraciones de paquetes de SSIS en tiempo de ejecución

Al emplear la utilidad de símbolo del sistema dtexec (dtexec.exe) para ejecutar un paquete implementado, la utilidad aplica las configuraciones de paquetes dos veces: antes y después de aplicar las opciones que se especificaron en la línea de comandos.

A medida que la utilidad carga y ejecuta el paquete, los eventos se producen en el orden siguiente:

1. La utilidad dtexec carga el paquete.

2. La utilidad aplica las configuraciones que se especificaron en el paquete en tiempo de diseño, en el orden indicado en el paquete. (Las configuraciones de las variables de paquetes primarios son la excepción. La utilidad solo aplica estas configuraciones una vez y al final en el proceso).

3. A continuación, la utilidad aplica cualquier opción que especificara en la línea de comandos.

4. La utilidad vuelve a cargar entonces las configuraciones que se especificaron en el paquete en tiempo de diseño, en el orden indicado en el paquete. (De nuevo, la excepción a esta regla son las configuraciones de variables de paquetes primarios). La utilidad utiliza las opciones de la línea de comandos que se especificaran para volver a cargar las configuraciones. Por consiguiente, se podrían volver a cargar valores diferentes desde una ubicación diferente.

5. La utilidad aplica las configuraciones de variables de paquetes primarios.

6. La utilidad ejecuta el paquete.

La manera en la que la utilidad dtexec aplica las configuraciones afecta a las opciones de la línea de comandos siguientes:

• Puede usar la opción /Connection o /Set en tiempo de ejecución para cargar configuraciones de paquete desde una ubicación distinta de la que especificó en tiempo de diseño.

• Puede emplear la opción /ConfigFile para cargar configuraciones adicionales que no especificó en tiempo de diseño.

Sin embargo, estas opciones de la línea de comandos tienen algunas restricciones:

• No puede usar la opción /Set o /Connection para invalidar valores únicos que también se establezcan en una configuración.

• No puede usar la opción /ConfigFile para cargar configuraciones que reemplacen las configuraciones que especificó en tiempo de diseño.

Para obtener más información sobre estas opciones y sobre cómo difiere su comportamiento en SQL Server 2005 Integration Services y SQL Server 2008 Integration Services, vea Cambios de comportamiento en las características de Integration Services en SQL Server 2008 R2.

Tipos de configuraciones de paquetes de SSIS

En la tabla siguiente se describen los tipos de configuraciones de paquetes.

Tipo	Descripción
Archivo de configuración XML	Un archivo XML contiene las configuraciones. El archivo XML puede incluir varias configuraciones.
Variable de entorno	Una variable de entorno contiene la configuración.
Entrada del Registro	Una entrada del Registro contiene la configuración.
Variable de paquete primario	Una variable del paquete contiene la configuración. Este tipo de configuración se utiliza habitualmente para actualizar las propiedades de los paquetes secundarios.
Tabla de SQL Server	Una tabla de una base de datos de SQL Server contiene la configuración. La tabla puede incluir varias configuraciones.

Archivos de configuración XML en SSS

Si selecciona el tipo de configuración Archivo de configuración XML, puede crear un archivo de configuración, reutilizar un archivo existente y agregarle configuraciones nuevas, o bien reutilizar un archivo existente sobrescribiendo el contenido actual.

Un archivo de configuración XML tiene dos secciones:

• Un encabezado que contiene información acerca del archivo de configuración. Este elemento incluye atributos como por ejemplo, cuándo se creó el archivo y el nombre de la persona que lo generó.

• Elementos de configuración que contienen información acerca de cada configuración. Este elemento incluye atributos como la ruta de acceso de la propiedad y el valor configurado de una propiedad.

El siguiente código XML muestra la sintaxis de un archivo de configuración XML. En el siguiente ejemplo se muestra una configuración para la propiedad Value de una variable entera llamada MyVar.

<?xml version="1.0"?>
<DTSConfiguration>
   <DTSConfigurationHeading>
      <DTSConfigurationFileInfo
          GeneratedBy="DomainName\UserName"
          GeneratedFromPackageName="Package"
          GeneratedFromPackageID="{2AF06766-817A-4E28-9878-0DE37A150648}"
          GeneratedDate="2/01/2005 5:58:09 PM"/>
   </DTSConfigurationHeading>
   <Configuration ConfiguredType="Property" Path="\Package.Variables[User::MyVar].Value" ValueType="Int32">
      <ConfiguredValue>0</ConfiguredValue>
   </Configuration>
</DTSConfiguration>

Entrada del Registro para almacenar la configuración de paquetes de SSIS

Si desea usar una entrada del Registro para guardar la configuración, puede usar una clave existente o crear otra en HKEY_CURRENT_USER. La clave del Registro que utilice debe tener un valor denominado Valor. El valor puede ser DWORD o una cadena.

Si selecciona el tipo de configuración Entrada del Registro, debe escribir el nombre de la clave del Registro en el cuadro de texto del Registro. El formato es <clave del Registro>. Si desea usar una clave del Registro que no está en la raíz de HKEY_CURRENT_USER, use el formato <clave del Registro\clave del Registro\...> para identificarla. Por ejemplo, para usar la clave MyPackage de SSISPackages, escriba SSISPackages\MyPackage.

Tipo de configuración de SSIS de SQL Server

Si selecciona el tipo de configuración SQL Server, debe especificar la conexión a la base de datos de SQL Server en la que desee almacenar las configuraciones. Puede guardar las configuraciones en una tabla existente o crear una tabla nueva en la base de datos especificada.

La siguiente instrucción SQL muestra la instrucción CREATE TABLE predeterminada que proporciona el Asistente para la configuración de paquetes.

CREATE TABLE [dbo].[SSIS Configurations]
(
ConfigurationFilter NVARCHAR(255) NOT NULL,
ConfiguredValue NVARCHAR(255) NULL,
PackagePath NVARCHAR(255) NOT NULL,
ConfiguredValueType NVARCHAR(20) NOT NULL
)

El nombre que asigna a la configuración es el valor almacenado en la columna ConfigurationFilter.

Configuraciones directas e indirectas

Integration Services proporciona configuraciones directas e indirectas. Si especifica las configuraciones directamente, Integration Services crea un vínculo directo entre el elemento de configuración y la propiedad del objeto de paquete. Las configuraciones directas son una opción mejor cuando la ubicación del origen no cambia. Por ejemplo, si está seguro de que todas las implementaciones del paquete utilizarán la misma ruta de acceso al archivo, puede especificar un archivo de configuración XML.

Las configuraciones indirectas utilizan variables de entorno. En lugar de especificar el entorno de configuración directamente, la configuración apunta a una variable de entorno, que a su vez contiene el valor de configuración. Las configuraciones indirectas son una opción mejor cuando la ubicación de la configuración puede cambiar en cada implementación de un paquete.

Recursos externos

• Artículo técnico con una introducción a las configuraciones de paquetes de Integration Services, en msdn.microsoft.com

• Entrada de blog, Crear paquetes en código: configuraciones de paquetes, en www.sqlis.com.

• Entrada de blog, API de ejemplo: agregar mediante programación un archivo de configuración a un paquete, en blogs.msdn.com.

• Herramienta, Editor de archivos de configuración del paquete, en codeplex.com.

Manténgase al día con Integration Services Para obtener las descargas, los artículos, los ejemplos y los vídeos más recientes de Microsoft, así como una selección de soluciones de la comunidad, visite la página de Integration Services en MSDN: Visite la página de Integration Services en MSDN Para recibir notificaciones automáticas de estas actualizaciones, suscríbase a las fuentes RSS disponibles en la página.

Vea también

Tasks

Crear configuraciones de paquetes

Historial de cambios

Contenido actualizado
Se ha agregado información sobre la opción de la línea de comandos /Connection y la aplicación de configuraciones.