Implementación de proyectos y paquetes de Integration Services (SSIS)

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

Integration Services admite dos modelos de implementación, el modelo de implementación del proyecto y el modelo de implementación de paquetes heredados. El modelo de implementación del proyecto le permite implementar sus proyectos en el servidor de Integration Services .

Para más información sobre el modelo de implementación de paquetes heredada, vea Implementación de paquetes heredada (SSIS).

Comparación del modelo de implementación de proyectos y el modelo de implementación de paquetes heredados

El tipo de modelo de implementación que elija para un proyecto determina qué opciones de desarrollo y administrativas están disponibles para ese proyecto. En la tabla siguiente se muestran las diferencias y similitudes entre utilizar el modelo de implementación del proyecto y utilizar el modelo de implementación de paquetes.

Cuando se usa el modelo de implementación del proyecto	Cuando se usa el modelo de implementación de paquetes heredados
Un proyecto es la unidad de implementación.	Un paquete es la unidad de implementación.
Los parámetros se usan para asignar valores a las propiedades del paquete.	Las configuraciones se usan para asignar valores a las propiedades del paquete.
Un proyecto, que contiene paquetes y parámetros, se genera en un archivo de implementación del proyecto (extensión .ispac).	Los paquetes (extensión .dtsx) y las configuraciones (extensión .dtsConfig) se guardan por separado en el sistema de archivos.
Un proyecto, que contiene paquetes y parámetros, se implementa en el catálogo de SSISDB en una instancia de SQL Server.	Los paquetes y las configuraciones se copian en el sistema de archivos en otro equipo. Los paquetes también pueden guardarse en la base de datos MSDB en una instancia de SQL Server.
Se requiere la integración con CLR en el motor de base de datos.	No se requiere la integración con CLR en el motor de base de datos.
Los valores de parámetros específicos del entorno se almacenan en variables de entorno.	Los valores de configuración específicos del entorno se almacenan en archivos de configuración.
Los proyectos y los paquetes del catálogo se pueden validar en el servidor antes de la ejecución. Puede utilizar SQL Server Management Studio, procedimientos almacenados o código administrado para realizar la validación.	Los paquetes se validan inmediatamente antes de la ejecución. También puede validar un paquete con dtExec o con código administrado.
Los paquetes se ejecutan iniciando una ejecución en el motor de base de datos. Se asignan un identificador del proyecto, valores de parámetros explícitos (opcional) y referencias de entorno (opcional) a una ejecución antes de que se inicie. También puede ejecutar paquetes mediante dtExec.	Los paquetes se ejecutan con las utilidades de ejecución de dtExec y de DTExecUI . Las configuraciones aplicables se identifican mediante los argumentos del símbolo del sistema (opcional).
Durante la ejecución, los eventos producidos por el paquete se capturan automáticamente y se guardan en el catálogo. Puede consultar estos eventos con las vistas de Transact-SQL.	Durante la ejecución, los eventos producidos por un paquete no se capturan automáticamente. Un proveedor de registro se debe agregar al paquete para capturar eventos.
Los paquetes se ejecutan en un proceso de Windows independiente.	Los paquetes se ejecutan en un proceso de Windows independiente.
Se utiliza el Agente SQL Server para programar la ejecución del paquete.	Se utiliza el Agente SQL Server para programar la ejecución del paquete.

Características del modelo de implementación del proyecto

En la tabla siguiente se enumeran las características disponibles en los proyectos desarrollados solo para el modelo de implementación del proyecto.

Característica	Descripción
Parámetros	Un parámetro especifica los datos que usará un paquete. Puede establecer el ámbito de los parámetros en el nivel de paquete o en el nivel de proyecto con parámetros de paquete y parámetros de proyecto, respectivamente. Los parámetros se pueden usar en expresiones o tareas. Cuando el proyecto se implementa en el catálogo, se puede asignar un valor literal para cada parámetro o utilizar el valor predeterminado que se asignó en tiempo de diseño. En lugar de un valor literal, se puede hacer referencia a una variable de entorno. Los valores de variables de entorno se resuelven en el momento de la ejecución del paquete.
Entornos	Un entorno es un contenedor de variables a las que pueden hacer referencia los proyectos de Integration Services . Cada proyecto puede tener varias referencias de entorno, pero una instancia de ejecución del paquete solo puede hacer referencia a variables de un único entorno. Los entornos permiten organizar los valores que se asignan a un paquete. Por ejemplo, se pueden tener entornos denominados "Dev", "test" y "Production".
Variables de entorno	Una variable de entorno define un valor literal que se puede asignar a un parámetro durante la ejecución del paquete. Para utilizar una variable de entorno, se debe crear una referencia de entorno (en el proyecto que corresponde al entorno que tiene el parámetro), asignar un valor de parámetro al nombre de la variable de entorno y especificar la referencia de entorno correspondiente al configurar una instancia de ejecución.
Catálogo de SSISDB	Todos los objetos de Integration Services se almacenan y administran en una instancia de SQL Server en una base de datos denominada catálogo de SSISDB. El catálogo permite utilizar carpetas para organizar los proyectos y los entornos. Cada instancia de SQL Server solo puede tener un catálogo. Cada catálogo puede tener cero o más carpetas. Cada carpeta puede tener cero o más proyectos y cero o más entornos. Una carpeta del catálogo también se puede utilizar como límite para los permisos a objetos de Integration Services .
Procedimientos almacenados y vistas de catálogo	Se puede utilizar un gran número de procedimientos almacenados y vistas para administrar los objetos de Integration Services en el catálogo. Por ejemplo, se pueden especificar valores para parámetros y variables de entorno, crear e iniciar ejecuciones y supervisar las operaciones de catálogo. Incluso se puede ver exactamente qué valores usará un paquete antes de que empiece la ejecución.

Implementación del proyecto

En el centro del modelo de implementación del proyecto está el archivo de implementación del proyecto (extensión .ispac). El archivo de implementación del proyecto es una unidad autónoma de implementación que incluye solamente la información esencial sobre los paquetes y los parámetros del proyecto. El archivo de implementación del proyecto no captura toda la información contenida en el archivo de proyecto de Integration Services (extensión .dtproj). Por ejemplo, los archivos de texto adicional que se utilizan para escribir notas no se almacenan en el archivo de implementación del proyecto y, por lo tanto, no se implementan en el catálogo.

Permisos necesarios para implementar proyectos y paquetes de SSIS

Si cambia la configuración predeterminada de la cuenta de servicio de SSIS, es posible que tenga que proporcionar permisos adicionales a la cuenta de servicio no predeterminada para poder implementar paquetes correctamente. Si la cuenta de servicio no predeterminada no tiene los permisos necesarios, verá el siguiente mensaje de error.

A .NET Framework error occurred during execution of user-defined routine or aggregate "deploy_project_internal": System.ComponentModel.Win32Exception: A required privilege is not held by the client.

Este error suele ser el resultado de la falta de permisos de DCOM. Para corregir el error, siga estos pasos:

1. Abra la consola Servicios de componente (o ejecute Dcomcnfg.exe).
2. En la consola Servicios de componente, expanda Servicios de componente>Equipos>Mi PC>Configuración DCOM.
3. En la lista, busque Microsoft SQL Server Integration Services xx.0 para encontrar la versión de SQL Server que esté usando. Por ejemplo, SQL Server 2016 es la versión 13.
4. Haga clic con el botón secundario y seleccione Propiedades.
5. En el cuadro de diálogo Propiedades de Microsoft SQL Server Integration Services 13.0, seleccione la pestaña Seguridad.
6. Por cada uno de los tres conjuntos de permisos (inicio y activación, acceso y configuración), seleccione Personalizar y, luego, Editar para abrir el cuadro de diálogo Permiso.
7. En el cuadro de diálogo Permiso, agregue la cuenta de servicio no predeterminada y conceda los permisos Permitir según sea necesario. Normalmente, una cuenta tiene los permisos Ejecución local y Activación local.
8. Haga clic en Aceptar dos veces y, a continuación, cierre la consola Servicios de componente.

Para más información sobre el error descrito en esta sección y los permisos necesarios para la cuenta de servicio de SSIS, vea la entrada de blog siguiente:

• System.ComponentModel.Win32Exception: el cliente no dispone de un privilegio requerido durante la implementación de un proyecto de SSIS

Implementación de paquetes en el servidor de Integration Services

En la versión actual de Integration Services, puede implementar los proyectos en el servidor de Integration Services . El servidor de Integration Services permite administrar paquetes, ejecutar paquetes y configurar valores de tiempo de ejecución para paquetes usando entornos.

Para implementar un proyecto en el servidor de Integration Services , debe completar las tareas siguientes:

1. Crear un catálogo de SSISDB, si aún no lo ha hecho. Para obtener más información, vea SSIS Catalog (Catálogo de SSIS).

2. Ejecute el Asistente para conversión de proyectos de Integration Services para convertir el proyecto al modelo de implementación de proyectos. Para más información, vea las instrucciones siguientes: Para convertir un proyecto al modelo de implementación de proyectos

   • Si creó el proyecto en SQL Server 2014 Integration Services (SSIS) o en una versión posterior, de forma predeterminada el proyecto utiliza el modelo de implementación de proyectos.

   • Si creó el proyecto en la versión anterior de Integration Services, después de abrir el archivo de proyecto en Visual Studio, deberá convertir el proyecto al modelo de implementación de proyectos.

     Nota

     Si el proyecto contiene uno o más orígenes de datos, se quitan los orígenes de datos cuando se completa la conversión del proyecto. Para crear una conexión a un origen de datos que los paquetes del proyecto puedan compartir, agregue un administrador de conexiones en el nivel de proyecto. Para obtener más información, consulte agregar, eliminar o compartir un administrador de conexiones en un paquete.

     Dependiendo de si ejecuta el Asistente para la conversión de proyectos de Integration Services desde Visual Studio o desde SQL Server Management Studio, el asistente realiza tareas de conversión diferentes.

     • Si ejecuta el asistente desde Visual Studio, los paquetes incluidos en el proyecto se convierten de Integration Services 2005, 2008 o 2008 R2 al formato utilizado por la versión actual de Integration Services. Se actualizan los archivos originales del proyecto (.dtproj) y del paquete (.dtsx).

     • Si ejecuta el asistente desde SQL Server Management Studio, el asistente genera un archivo de implementación del proyecto (.ispac) a partir de los paquetes y las configuraciones incluidos en el proyecto. Los archivos originales del paquete (.dtsx) no se actualizan.

       Puede seleccionar un archivo existente o crear un archivo nuevo en la página Destino de selección del asistente.

       Para actualizar archivos del paquete cuando se convierte un proyecto, ejecute el Asistente para conversión de proyectos de Integration Services desde Visual Studio. Para actualizar los archivos de paquete independientemente de la conversión del proyecto, ejecute el Asistente para la conversión de proyectos de Integration Services de SQL Server Management Studio y el Asistente para actualizar paquetes SSIS. Si actualiza los archivos de paquete por separado, asegúrese de guardar los cambios. De lo contrario, cuando convierte el proyecto al modelo de implementación de proyectos, los cambios no guardados efectuados en el paquete no se convierten.

   Para obtener más información sobre la actualización de paquetes, vea Actualizar paquetes de Integration Services y Actualizar paquetes de Integration Services mediante el Asistente para actualizar paquetes SSIS.

3. Implemente el proyecto en el servidor de Integration Services . Para más información, vea las instrucciones siguientes: Para implementar un proyecto en el servidor de Integration Services.

4. (Opcional) Crear un entorno para el proyecto implementado.

Para convertir un proyecto al modelo de implementación de proyectos

1. Abra el proyecto en Visual Studioy, en el Explorador de soluciones, haga clic con el botón derecho en el proyecto y seleccione Convertir al modelo de implementación de proyectos.

   o bien

   En el Explorador de objetos de Management Studio, haga clic con el botón derecho en el nodo Proyectos y seleccione Importar paquetes.

2. Finalice el asistente.

Para implementar un proyecto en el servidor de Integration Services

1. Abra el proyecto en Visual Studioy, en el menú Proyecto , seleccione Implementar para iniciar el Asistente para implementación de Integration Services.

   o bien

   En SQL Server Management Studio, expanda el nodo Integration Services>SSISDB en el Explorador de objetos y busque la carpeta Proyectos correspondiente al proyecto que quiere implementar. Haga clic con el botón derecho en la carpeta Proyectos y, después, haga clic en Implementar proyecto.

   o bien

   En el símbolo del sistema, ejecute isdeploymentwizard.exe de %Archivos de programa%\Microsoft SQL Server\130\DTS\Binn. En equipos de 64 bits, también hay una versión de 32 bits de la herramienta en %Archivos de programa (x86)%\Microsoft SQL Server\130\DTS\Binn.

2. En la página Seleccionar origen , haga clic en Archivo de implementación de proyecto para seleccionar el archivo de implementación del proyecto.

   o bien

   Haga clic en Catálogo de Integration Services para seleccionar un proyecto que ya se haya implementado en el catálogo de SSISDB.

3. Finalice el asistente.

Implementación de paquetes en el servidor de Integration Services

La característica Implementación incremental de paquetes presentada en SQL Server 2016 (13.x) Integration Services (SSIS) permite implementar uno o varios paquetes en un proyecto nuevo o existente sin implementar todo el proyecto.

Implementación de paquetes mediante el Asistente para implementación de Integration Services

1. En el símbolo del sistema, ejecute isdeploymentwizard.exe de %Archivos de programa%\Microsoft SQL Server\130\DTS\Binn. En equipos de 64 bits, también hay una versión de 32 bits de la herramienta en %Archivos de programa (x86)%\Microsoft SQL Server\130\DTS\Binn.

2. En la página Seleccionar origen , cambie a Modelo de implementación de paquetes. Después, seleccione la carpeta que contiene los paquetes de origen y configúrelos.

3. Finalice el asistente. Siga los pasos restantes descritos en Package Deployment Model.

Implementación de paquetes mediante SQL Server Management Studio

1. En SQL Server Management Studio, expanda el nodo Catálogos de Integration Services>SSISDB en el Explorador de objetos.

2. Haga clic con el botón derecho en la carpeta Proyectos y luego en Implementar proyectos.

3. Si ve la página Introducción , haga clic en Siguiente para continuar.

4. En la página Seleccionar origen , cambie a Modelo de implementación de paquetes. Después, seleccione la carpeta que contiene los paquetes de origen y configúrelos.

5. Finalice el asistente. Siga los pasos restantes descritos en Package Deployment Model.

Implementación de paquetes mediante SQL Server Data Tools (Visual Studio)

1. En Visual Studio, con un proyecto de Integration Services abierto, seleccione el paquete o paquetes que desea implementar.

2. Haga clic con el botón derecho y seleccione Implementar paquete. Se abre el Asistente para implementación con los paquetes seleccionados configurados como los paquetes de origen.

3. Finalice el asistente. Siga los pasos restantes descritos en Package Deployment Model.

Implementación de paquetes mediante el procedimiento almacenado deploy_packages

Puede usar el procedimiento almacenado [catalog].[deploy_packages] para implementar uno o más paquetes SSIS en el catálogo de SSIS. En el ejemplo de código siguiente se muestra el uso de este procedimiento almacenado para implementar paquetes en un servidor de SSIS. Para obtener más información, vea catalog.deploy_packages.

  
private static void Main(string[] args)  
{  
    // Connection string to SSISDB  
    var connectionString = "Data Source=.;Initial Catalog=SSISDB;Integrated Security=True;MultipleActiveResultSets=false";  
  
    using (var sqlConnection = new SqlConnection(connectionString))  
    {  
        sqlConnection.Open();  
  
        var sqlCommand = new SqlCommand  
        {  
            Connection = sqlConnection,  
            CommandType = CommandType.StoredProcedure,  
            CommandText = "[catalog].[deploy_packages]"  
        };  
  
        var packageData = Encoding.UTF8.GetBytes(File.ReadAllText(@"C:\Test\Package.dtsx"));  
  
        // DataTable: name is the package name without extension and package_data is byte array of package.  
        var packageTable = new DataTable();  
        packageTable.Columns.Add("name", typeof(string));  
        packageTable.Columns.Add("package_data", typeof(byte[]));  
        packageTable.Rows.Add("Package", packageData);  
  
        // Set the destination project and folder which is named Folder and Project.  
        sqlCommand.Parameters.Add(new SqlParameter("@folder_name", SqlDbType.NVarChar, ParameterDirection.Input, "Folder", -1));  
        sqlCommand.Parameters.Add(new SqlParameter("@project_name", SqlDbType.NVarChar, ParameterDirection.Input, "Project", -1));  
        sqlCommand.Parameters.Add(new SqlParameter("@packages_table", SqlDbType.Structured, ParameterDirection.Input, packageTable, -1));  
  
        var result = sqlCommand.Parameters.Add("RetVal", SqlDbType.Int);  
        result.Direction = ParameterDirection.ReturnValue;  
  
        sqlCommand.ExecuteNonQuery();  
    }  
}  
  

Implementación de paquetes mediante la API del modelo de objetos de administración

En el ejemplo de código siguiente se muestra el uso de la API del modelo de objetos de administración para implementar paquetes en un servidor.

  
static void Main()  
 {  
     // Before deploying packages, make sure the destination project exists in SSISDB.  
     var connectionString = "Data Source=.;Integrated Security=True;MultipleActiveResultSets=false";  
     var catalogName = "SSISDB";  
     var folderName = "Folder";  
     var projectName = "Project";  
  
     // Get the folder instance.  
     var sqlConnection = new SqlConnection(connectionString);  
     var store = new Microsoft.SqlServer.Management.IntegrationServices.IntegrationServices(sqlConnection);  
     var folder = store.Catalogs[catalogName].Folders[folderName];  
  
     // Key is package name without extension and value is package binaries.  
     var packageDict = new Dictionary<string, string>();  
  
     var packageData = File.ReadAllText(@"C:\Folder\Package.dtsx");  
     packageDict.Add("Package", packageData);  
  
     // Deploy package to the destination project.  
     folder.DeployPackages(projectName, packageDict);  
 }  
  

Convertir a modelo de implementación de paquetes, cuadro de diálogo

El comando de Convertir a modelo de implementación de paquetes permite convertir un paquete al modelo de implementación de paquetes después de comprobar el proyecto y cada paquete en el proyecto para ver la compatibilidad con ese modelo. Si un paquete usa las características exclusivas del modelo de implementación de proyectos, como los parámetros, el paquete no se podrá convertir.

Para convertir un paquete al modelo de implementación de paquetes es preciso realizar dos pasos.

1. Cuando se selecciona el comando Convertir a modelo de implementación de paquetes en el menú Proyecto , el proyecto y cada paquete se comprueban para ver su compatibilidad con este modelo. Los resultados se muestran en tabla Resultados .

   Si el proyecto o un paquete no supera la prueba de compatibilidad, haga clic en Error en la columna Resultado para obtener más información. Haga clic en Guardar informe para guardar una copia de esta información en un archivo de texto.

2. Si el proyecto y todos los paquetes superan la prueba de compatibilidad, haga clic Aceptar para convertir el paquete.

Asistente para implementación de Integration Services

El Asistente para implementación de Integration Services admite dos modelos de implementación:

• Modelo de implementación de proyectos
• Modelo de implementación de paquetes

El modelo de implementación de proyectos permite implementar un proyecto de SQL Server Integration Services (SSIS) como una sola unidad en el catálogo de SSIS.

El modelo de implementación de paquetes permite implementar paquetes que se han actualizado en el catálogo de SSIS sin tener que implementar todo el proyecto.

Inicio del asistente

Inicie el asistente de una de estas dos formas:

• Escriba "Asistente de implementación de SQL Server" en Windows Search

o bien

• Busque el archivo ejecutable ISDeploymentWizard.exe en la carpeta de instalación de SQL Server; por ejemplo: “C:\Archivos de programa (x86)\Microsoft SQL Server\130\DTS\Binn”.

La configuración de esta página es diferente en cada modelo de implementación. Siga los pasos de la sección Project Deployment Model o Package Deployment Model en función del modelo que haya seleccionado en esta página.

Modelo de implementación de proyectos

Selección del origen

Para implementar un archivo de implementación de proyectos que haya creado, seleccione Archivo de implementación de proyecto y especifique la ruta de acceso del archivo .ispac. Para implementar un proyecto que resida en el catálogo de Integration Services , seleccione Catálogo de Integration Servicesy especifique el nombre del servidor y la ruta de acceso al proyecto en el catálogo. Haga clic en Siguiente para ver la página Seleccionar destino .

Seleccionar destino

Para seleccionar la carpeta de destino para el proyecto en el catálogo Integration Services , escriba la instancia de SQL Server o haga clic en Examinar para seleccionarla en una lista de servidores. Escriba la ruta de acceso del proyecto en SSISDB o haga clic en Examinar para seleccionarla. Haga clic en Siguiente para ver la página Revisión .

Revisión e implementación

La página permite revisar la configuración seleccionada. Puede cambiar las selecciones si hace clic en Anterioro si hace clic en cualquiera de los pasos del panel izquierdo. Haga clic en Implementar para iniciar el proceso de implementación.

Results

Una vez completado el proceso de implementación, debería ver la página Resultados . Esta página muestra si cada acción si se completó correctamente o no. Si la acción no se realiza correctamente, haga clic en Error en la columna Resultado para que aparezca una explicación del error. Haga clic en Guardar informe para guardar los resultados en un archivo XML o haga clic en Cerrar para salir del asistente.

Modelo de implementación de paquetes

Selección del origen

La página Seleccionar origen del Asistente para implementación de Integration Services muestra la configuración específica del modelo de implementación de paquetes cuando selecciona la opción lmplementación del paquete del modelo de implementación.

Para seleccionar los paquetes de origen, haga clic en el botón Examinar… para seleccionar la carpeta que contiene los paquetes, o bien escriba la ruta de la carpeta en el cuadro de texto Ruta de acceso de la carpeta de paquetes y haga clic en el botón Actualizar situado en la parte inferior de la página. Ahora, debería ver todos los paquetes en la carpeta especificada en el cuadro de lista. De forma predeterminada, se seleccionan todos los paquetes. Haga clic en la casilla de la primera columna para elegir los paquetes que desea implementar en el servidor.

Consulte las columnas Estado y Mensaje para comprobar el estado del paquete. Si el estado es Listo o Advertencia, el Asistente para la implementación no bloquearía el proceso de implementación. Si el estado está establecido en Error, el asistente no continuará con la implementación de los paquetes seleccionados. Para ver los mensajes de advertencia o error detallados, haga clic en el vínculo de la columna Mensaje.

Si la información confidencial o los datos del paquete están cifrados con una contraseña, escríbala en la columna Contraseña y haga clic en el botón Actualizar para comprobar si se acepta la contraseña. Si la contraseña es correcta, el estado cambiaría a Listo y desaparecerá el mensaje de advertencia. Si hay varios paquetes con la misma contraseña, seleccione los que tengan la misma contraseña de cifrado, escriba la contraseña en el cuadro de texto Contraseña y seleccione el botón Aplicar. La contraseña se aplicaría a los paquetes seleccionados.

Si el estado de todos los paquetes seleccionados no es Error, el botón Siguiente se habilitará para que pueda continuar con el proceso de implementación de paquetes.

Seleccionar destino

Después de seleccionar los orígenes de paquetes, haga clic en el botón Siguiente para cambiar a la página Seleccionar destino. Los paquetes deben implementarse en un proyecto del catálogo de SSIS (SSISDB). Antes de implementar los paquetes, asegúrese de que el proyecto de destino ya exista en el catálogo de SSIS. Cree un proyecto vacío si no existe uno. En la página Seleccionar destino, escriba el nombre del servidor en el cuadro de texto Nombre del servidor, o bien haga clic en el botón Examinar… para seleccionar una instancia de servidor. Después, haga clic en el botón Examinar… situado junto al cuadro de texto Ruta para especificar el proyecto de destino. Si el proyecto no existe, haga clic en el botón Nuevo proyecto… para crear un proyecto vacío como proyecto de destino. El proyecto se debe crear en una carpeta.

Revisión e implementación

Haga clic en la opción Siguiente de la página Seleccionar destino para cambiar a la página Revisión del Asistente para implementación de Integration Services. En esta página, revise el informe de resumen sobre la acción de implementación. Después de la comprobación, haga clic en el botón Implementar para realizar la acción de implementación.

Results

Una vez completada la implementación, debería ver la página Resultados . En la página Resultados, revise los resultados de cada paso del proceso de implementación. Haga clic en Guardar informe para guardar el informe de implementación o en Cerrar para cerrar el asistente.

Crear y asignar un entorno de servidor

Los entornos de servidor se crean con el fin de especificar valores en tiempo de ejecución para los paquetes contenidos en un proyecto implementado en el servidor Integration Services. Después puede asignar las variables de entorno a parámetros para un paquete concreto, para los paquetes de punto de entrada o para todos los paquetes de un proyecto determinado. Un paquete de punto de entrada suele ser un paquete primario que ejecuta un paquete secundario.

Puede consultar las vistas para obtener una lista de entornos de servidor, referencias de entorno y variables de entorno. También puede llamar a procedimientos almacenados para agregar, eliminar y modificar entornos, referencias de entorno y variables de entorno. Para más información, vea la sección Entornos de servidor, variables de servidor y referencias del entorno de servidor en Catálogo de SSIS.

Para crear y utilizar un entorno de servidor

1. En Management Studio, expanda el nodo SSISDB de Catálogos de Integration Services en el Explorador de objetos y busque la carpeta Entornos del proyecto para el que quiera crear un entorno.

2. Haga clic con el botón derecho en la carpeta Entornos y, después, haga clic en Crear entorno.

3. Escriba un nombre para el entorno y opcionalmente una descripción. Haga clic en Aceptar.

4. Haga clic con el botón derecho en el nuevo entorno y, después, haga clic en Propiedades.

5. En la página Variables , haga lo siguiente para agregar una variable.

   1. Seleccione Tipo para la variable. No es necesario que el nombre de la variable coincida con el nombre del parámetro del proyecto al que se asigna la variable.

   2. Escriba la Descripción opcional para la variable.

   3. Escriba el Valor para la variable de entorno.

      Para obtener información sobre las reglas para los nombres de las variables de entorno, vea la sección Variable de entorno en SSIS Catalog.

   4. Indique si la variable contiene un valor confidencial; para ello, active o desactive la casilla Confidencial .

      Si selecciona Confidencial, el valor de la variable no aparece en el campo Valor .

      Los valores confidenciales se cifran en el catálogo de SSISDB. Para obtener más información acerca del cifrado, vea SSIS Catalog.

6. En la página Permisos , haga lo siguiente para conceder o denegar permisos para los usuarios y roles seleccionados.

   1. Haga clic en Examinary, a continuación, seleccione uno o más usuarios y roles en el cuadro de diálogo Examinar todas las entidades .

   2. En el área Inicios de sesión o roles , seleccione el usuario o el rol al que desea conceder o denegar permisos.

   3. En el área Explícito, seleccione Conceder o Denegar junto a cada permiso.

7. Para incluir el entorno en el script, haga clic en Script. De forma predeterminada, el script aparece en una nueva ventana del Editor de consultas.

   Sugerencia

   Tiene que hacer clic en Script después de realizar cambios en las propiedades del entorno (como agregar una variable) y antes de hacer clic en Aceptar en el cuadro de diálogo Propiedades del entorno. De lo contrario, no se generará un script.

8. Haga clic en Aceptar para guardar los cambios realizados en las propiedades de entorno.

9. En el nodo SSISDB del Explorador de objetos, expanda la carpeta Proyectos , haga clic con el botón derecho en el proyecto y, después, haga clic en Configurar.

10. En la página Referencias , haga clic en Agregar para agregar un entorno y, a continuación, haga clic en Aceptar para guardar la referencia al entorno.

11. Vuelva a hacer clic con el botón derecho en el proyecto y, después, haga clic en Configurar.

12. Para asignar la variable de entorno a un parámetro que ha agregado al paquete en tiempo de diseño o a un parámetro que se ha generado al convertir el proyecto de Integration Services al modelo de implementación del proyecto, siga estos pasos:

    1. En la pestaña Parámetros de la página Parámetros , haga clic en el botón Examinar situado junto al campo Valor .

    2. Haga clic en Usar variable de entornoy seleccione la variable de entorno que creó.

13. Para asignar la variable de entorno a una propiedad del administrador de conexiones, haga lo siguiente. Se generan automáticamente parámetros en el servidor SSIS para las propiedades del administrador de conexiones.

    1. En la pestaña Administradores de conexiones de la página Parámetros, haga clic en el botón Examinar situado junto al campo Valor.

    2. Haga clic en Usar variable de entornoy seleccione la variable de entorno que creó.

14. Haga clic en Aceptar dos veces para guardar los cambios.

Implementar y ejecutar paquetes SSIS mediante procedimientos almacenados

Al configurar un proyecto de Integration Services para que use el modelo de implementación de proyectos, puede emplear procedimientos almacenados del catálogo de SSIS implementar el proyecto y ejecutar los paquetes. Para obtener información acerca del modelo de implementación de proyectos, vea Deployment of Projects and Packages.

También puede usar SQL Server Management Studio o SQL Server Data Tools (SSDT) para implementar el proyecto y ejecutar los paquetes. Para obtener más información, vea los temas de la sección Vea también .

Para implementar y ejecutar un paquete mediante procedimientos almacenados

1. Llame a catalog.deploy_project (base de datos de SSISDB) para implementar el proyecto de Integration Services que contiene el paquete en el servidor de Integration Services.

   Para recuperar el contenido binario del archivo de implementación de proyecto de Integration Services, para el parámetro @project_stream, use una instrucción SELECT con la función OPENROWSET y el proveedor de conjuntos de filas BULK. El proveedor de conjuntos de filas BULK le permite leer datos de un archivo. El argumento SINGLE_BLOB del proveedor de conjuntos de filas BULK devuelve el contenido del archivo de datos como un conjunto de filas de una sola fila y una sola columna de tipo varbinary(max). Para obtener más información, vea OPENROWSET (Transact-SQL).

   En el ejemplo siguiente, el proyecto SSISPackages_ProjectDeployment se implementa en la carpeta Paquetes SSIS del servidor de Integration Services . Los datos binarios se leen del archivo de proyecto (SSISPackage_ProjectDeployment.ispac) y se almacenan en el parámetro _@ProjectBinary de tipo varbinary(max). El valor de parámetro @ProjectBinary se asigna al parámetro @project_stream.

   DECLARE @ProjectBinary as varbinary(max)  
   DECLARE @operation_id as bigint  
   Set @ProjectBinary = (SELECT * FROM OPENROWSET(BULK 'C:\MyProjects\ SSISPackage_ProjectDeployment.ispac', SINGLE_BLOB) as BinaryData)  
   
   Exec catalog.deploy_project @folder_name = 'SSIS Packages', @project_name = 'DeployViaStoredProc_SSIS', @Project_Stream = @ProjectBinary, @operation_id = @operation_id out  
   
   

2. Llame a catalog.create_execution (base de datos de SSISDB) para crear una instancia de la ejecución de paquetes y llame opcionalmente a catalog.set_execution_parameter_value (base de datos de SSISDB) para establecer los valores de parámetro en tiempo de ejecución.

   En el ejemplo siguiente, catalog.create_execution crea una instancia de ejecución del package.dtsx contenido en el proyecto SSISPackage_ProjectDeployment. El proyecto se encuentra en la carpeta SSIS Packages. El execution_id devuelto por el procedimiento almacenado se emplea en la llamada a catalog.set_execution_parameter_value. Este segundo procedimiento almacenado establece el parámetro LOGGING_LEVEL en 3 (registro detallado) y establece un parámetro de paquete denominado Parameter1 en un valor de 1.

   Para los parámetros como LOGGING_LEVEL, el valor de object_type es 50. Para los parámetros de paquete, el valor de object_type es 30.

   Declare @execution_id bigint  
   EXEC [SSISDB].[catalog].[create_execution] @package_name=N'Package.dtsx', @execution_id=@execution_id OUTPUT, @folder_name=N'SSIS Packages', @project_name=N'SSISPackage_ProjectDeployment', @use32bitruntime=False, @reference_id=1  
   
   Select @execution_id  
   DECLARE @var0 smallint = 3  
   EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id,  @object_type=50, @parameter_name=N'LOGGING_LEVEL', @parameter_value=@var0  
   
   DECLARE @var1 int = 1  
   EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id,  @object_type=30, @parameter_name=N'Parameter1', @parameter_value=@var1  
   
   GO  
   
   

3. Llame a catalog.start_execution (base de datos de SSISDB) para ejecutar el paquete.

   En el ejemplo siguiente, se agrega a Transact-SQL una llamada a catalog.start_execution para iniciar la ejecución del paquete. Se empela el execution_id devuelto por el procedimiento almacenado catalog.create_execution.

   Declare @execution_id bigint  
   EXEC [SSISDB].[catalog].[create_execution] @package_name=N'Package.dtsx', @execution_id=@execution_id OUTPUT, @folder_name=N'SSIS Packages', @project_name=N'SSISPackage_ProjectDeployment', @use32bitruntime=False, @reference_id=1  
   
   Select @execution_id  
   DECLARE @var0 smallint = 3  
   EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id,  @object_type=50, @parameter_name=N'LOGGING_LEVEL', @parameter_value=@var0  
   
   DECLARE @var1 int = 1  
   EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id,  @object_type=30, @parameter_name=N'Parameter1', @parameter_value=@var1  
   
   EXEC [SSISDB].[catalog].[start_execution] @execution_id  
   GO  
   
   

Para implementar un proyecto entre servidores mediante procedimientos almacenados

Puede implementar un proyecto entre servidores mediante los procedimientos almacenados catalog.get_project (base de datos de SSISDB) y catalog.deploy_project (base de datos de SSISDB).

Debe hacer lo siguiente antes de ejecutar los procedimientos almacenados.

• Cree un objeto de servidor vinculado. Para obtener más información, vea Crear servidores vinculados (motor de base de datos de SQL Server).

  En la página Opciones del servidor del cuadro de diálogo Propiedades del servidor vinculado , establezca RPC y Salida RPC en True. Establezca también Habilitar la promoción de transacciones distribuidas para RPC en False.

• Habilite los parámetros dinámicos del proveedor seleccionado para el servidor vinculado; para ello, expanda el nodo de Proveedores en Servidores vinculados en el Explorador de objetos, haga clic con el botón derecho en el proveedor y, después, haga clic en Propiedades. Seleccione Habilitar junto a Parámetro dinámico.

• Confirme que el Coordinador de transacciones distribuidas (DTC) se inicia en ambos servidores.

Llame a catalog.get_project para devolver el contenido binario del proyecto y llame después a catalog.deploy_project. El valor devuelto por catalog.get_project se inserta en una variable de tabla de tipo varbinary(max). El servidor vinculado no puede devolver resultados que son varbinary(max).

En el ejemplo siguiente, catalog.get_project devuelve un contenido binario para el proyecto SSISPackages del servidor vinculado. catalog.deploy_project implementa el proyecto en el servidor local, en la carpeta denominada DestFolder.

declare @resultsTableVar table (  
project_binary varbinary(max)  
)  
  
INSERT @resultsTableVar (project_binary)  
EXECUTE [MyLinkedServer].[SSISDB].[catalog].[get_project] 'Packages', 'SSISPackages'  
  
declare @project_binary varbinary(max)  
select @project_binary = project_binary from @resultsTableVar  
  
exec [SSISDB].[CATALOG].[deploy_project] 'DestFolder', 'SSISPackages', @project_binary  
  

Asistente para conversión de proyectos de Integration Services

El Asistente para conversión de proyectos de Integration Services convierte un proyecto al modelo de implementación de proyectos.

¿Qué desea hacer?

• Abrir el Asistente para conversión de proyectos de Integration Services

• Establecer las opciones de la página Buscar paquetes

• Establecer las opciones de la página Seleccionar paquete

• Establecer las opciones de la página Seleccionar destino

• Establecer las opciones de la página Especificar propiedades del proyecto

• Establecer las opciones de la página Actualizar la tarea Ejecutar paquete

• Establecer las opciones de la página Seleccionar configuraciones

• Establecer las opciones de la página Crear parámetros

• Establecer las opciones de la página Configurar parámetros

• Establecer las opciones en la página Revisar

• Establecer las opciones en Realizar conversión

Abrir el Asistente para conversión de proyectos de Integration Services

Para abrir el asistente Conversión de proyecto de Integration Services , realice una de las acciones siguientes:

• Abra el proyecto en Visual Studioy, en el Explorador de soluciones, haga clic con el botón derecho en el proyecto y seleccione Convertir al modelo de implementación de proyectos.

• En el Explorador de objetos en Management Studio, haga clic con el botón derecho en el nodo Proyectos de Catálogo de Integration Services y seleccione Importar paquetes.

Dependiendo de si ejecuta el Asistente para la conversión de proyectos de Integration Services desde Visual Studio o desde SQL Server Management Studio, el asistente realiza tareas de conversión diferentes.

Establecer las opciones de la página Buscar paquetes

La siguiente opción aparece en la página al seleccionar Sistema de archivos en la lista desplegable Origen . Seleccione esta opción si el paquete reside en el sistema de archivos.

Carpeta
Escriba la ruta de acceso al paquete, o bien haga clic en Examinarpara abrir la ubicación del paquete.

En la página se muestran las opciones siguientes al seleccionar Almacén de paquetes SSIS en la lista desplegable Origen. Para más información sobre el almacén de paquetes, vea Administración de paquetes (servicio SSIS).

Server
Especifique el nombre del servidor o seleccione el servidor.

Carpeta
Escriba la ruta de acceso al paquete, o bien haga clic en Examinarpara abrir la ubicación del paquete.

En la página se muestran las opciones siguientes al seleccionar Microsoft SQL Server en la lista desplegable Origen . Seleccione esta opción si el paquete reside en Microsoft SQL Server.

Server
Especifique el nombre del servidor o seleccione el servidor.

Usar la autenticación de Windows
El modo de autenticación de Microsoft Windows permite que un usuario pueda conectarse a través de una cuenta de usuario de Windows. Si utiliza la autenticación de Windows, no será necesario que proporcione un nombre de usuario o una contraseña.

Utilizar autenticación de SQL Server
Cuando un usuario se conecta con un nombre de inicio de sesión y una contraseña especificados desde una conexión que no es de confianza, SQL Server autentica la conexión (para hacerlo, comprueba si se ha configurado una cuenta de inicio de sesión de SQL Server y si la contraseña especificada coincide con la almacenada anteriormente). Si SQL Server no tiene configurada una cuenta de inicio de sesión, la autenticación no se realizará correctamente y el usuario recibirá un mensaje de error.

Nombre de usuario
Especifique un nombre de usuario cuando utilice la autenticación de SQL Server.

Contraseña
Especifique la contraseña cuando use la autenticación de SQL Server.

Carpeta
Escriba la ruta de acceso al paquete, o bien haga clic en Examinarpara abrir la ubicación del paquete.

Establecer las opciones de la página Seleccionar paquete

Nombre del paquete
Muestra el archivo de paquete.

Estado
Indica si un paquete está listo para convertir el modelo de implementación de proyectos.

Message
Muestra un mensaje asociado al paquete.

Contraseña
Muestra una contraseña asociada al paquete. Se oculta el texto de la contraseña.

Aplicar a la selección
Haga clic en el cuadro de texto Contraseña para aplicar la contraseña a los paquetes seleccionados.

Actualizar
Actualiza la lista de paquetes.

Establecer las opciones de la página Seleccionar destino

En esta página, especifique el nombre y la ruta de un nuevo archivo de implementación del proyecto (.ispac) o seleccione un archivo existente.

Ruta de acceso de salida
Escriba la ruta de acceso al archivo de implementación, o bien haga clic en Examinarpara abrir la ubicación del archivo.

Nombre del proyecto
Escriba el nombre del proyecto.

Nivel de protección
Seleccione el nivel de protección. Para más información, consulte Access Control for Sensitive Data in Packages.

Descripción del proyecto
Escriba una descripción opcional para el proyecto.

Establecer las opciones de la página Especificar propiedades del proyecto

Nombre del proyecto
Muestra el nombre del proyecto.

Nivel de protección
Seleccione un nivel de protección para los paquetes que se incluyen en el proyecto. Para obtener más información acerca de los niveles de protección, vea Access Control for Sensitive Data in Packages.

Descripción del proyecto
Escriba una descripción del proyecto opcional.

Establecer las opciones de la página Actualizar la tarea Ejecutar paquete

Actualice las tareas Ejecutar paquete que se incluyen en los paquetes para usar una referencia basada en proyectos. Para obtener más información, vea Execute Package Task Editor.

Paquete primario
Muestra el nombre del paquete que ejecuta el paquete secundario mediante la tarea Ejecutar paquete.

Nombre de la tarea
Muestra el nombre de la tarea Ejecutar paquete.

Referencia original
Muestra la ruta de acceso actual del paquete secundario.

Asignar referencia
Seleccione un paquete secundario que esté almacenado en el proyecto.

Establecer las opciones de la página Seleccionar configuraciones

Seleccione las configuraciones del paquete que desea reemplazar por parámetros.

Paquete
Muestra el archivo de paquete.

Tipo
Muestra el tipo de configuración como, por ejemplo, un archivo de configuración XML.

Cadena de configuración
Muestra la ruta de acceso del archivo de configuración.

Estado
Muestra un mensaje de estado para la configuración. Haga clic en el mensaje para ver el mensaje de texto completo.

Agregar configuraciones
Agregue configuraciones de paquetes que se incluyan en otros proyectos a la lista de valores de configuración disponibles que desee reemplazar con parámetros. Puede seleccionar las configuraciones almacenadas en un sistema de archivos o en SQL Server.

Actualizar
Haga clic para actualizar la lista de configuraciones.

Quite las configuraciones de todos los paquetes después de la conversión
Es recomendable que quite todas las configuraciones del proyecto seleccionando esta opción.

Si no selecciona esta opción, solo se quitan las configuraciones que haya elegido reemplazar por parámetros.

Establecer las opciones de la página Crear parámetros

Seleccione el nombre y el ámbito de parámetro para cada propiedad de configuración.

Paquete
Muestra el archivo de paquete.

Nombre de parámetro
Muestra el nombre de parámetro.

Ámbito
Seleccione el ámbito del parámetro, un paquete o un proyecto.

Establecer las opciones de la página Configurar parámetros

Nombre
Muestra el nombre de parámetro.

Ámbito
Muestra el ámbito del parámetro.

Valor
Muestra el valor del parámetro.

Haga clic en los puntos suspensivos junto al campo del valor para configurar las propiedades de parámetro.

En el cuadro de diálogo Establecer detalles de parámetro , puede modificar el valor del parámetro. También puede especificar si el valor del parámetro debe proporcionarse al ejecutar el paquete.

Puede modificar el valor en la página Parámetros del cuadro de diálogo Configurar de Management Studio; para ello, haga clic en el botón Examinar situado junto al parámetro. Aparece el cuadro de diálogo Establecer valor de parámetro .

El cuadro de diálogo Establecer detalles de parámetros también muestra el tipo de datos de parámetro y el origen del parámetro.

Establecer las opciones en la página Revisar

Use la página Revisar para confirmar las opciones que ha seleccionado para la conversión del proyecto.

Anterior
Haga clic aquí para cambiar una opción.

Convertir
Haga clic en esta opción para convertir el proyecto al modelo de implementación de proyectos.

Establecer las opciones en Realizar conversión

La página Realizar conversión muestra el estado de la conversión del proyecto.

Acción
Enumera un paso concreto de la conversión.

Resultado
Muestra el estado de cada paso de conversión. Haga clic en el mensaje de estado para obtener más información.

La conversión de proyectos no se guarda hasta que el proyecto se guarde en Visual Studio.

Guardar informe
Haga clic en esta opción para guardar un resumen de la conversión del proyecto en un archivo .xml.