Configuraciones de paquetes

Actualizado: 17 de julio de 2006

SQL Server 2005 Integration Services (SSIS) proporciona configuraciones de paquetes que se pueden emplear 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 familiarizarse más con los conceptos explicados en esta sección, vea Implementar paquetes (Tutorial) y Lección 3: Agregar configuraciones de paquetes de Tutorial para crear un paquete ETL sencillo.

Tipos de configuraciones de paquetes

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

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

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.

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 que se almacena 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.

Vea también

Tareas

Crear configuraciones de paquetes

Ayuda e información

Obtener ayuda sobre SQL Server 2005

Historial de cambios

Versión Historial

17 de julio de 2006

Contenido modificado:
  • Se agregó un vínculo a un tutorial que explica cómo crear y utilizar las configuraciones de paquetes en una implementación.

14 de abril de 2006

Contenido modificado:
  • Se agregó información acerca de cómo usar las entradas del Registro para almacenar configuraciones.