Catálogo de SSISSSIS Catalog

APPLIES TO: yesSQL Server, including on Linux yesAzure SQL Database yesAzure SQL Data Warehouse noParallel Data Warehouse

El catálogo de SSISDB es el eje central cuando se trabaja con proyectos de Integration ServicesIntegration Services (SSIS) que ha implementado en el servidor Integration ServicesIntegration Services.The SSISDB catalog is the central point for working with Integration ServicesIntegration Services (SSIS) projects that you've deployed to the Integration ServicesIntegration Services server. Por ejemplo, establece los parámetros del proyecto y del paquete, configura entornos para especificar los valores en tiempo de ejecución para los paquetes, ejecuta paquetes y soluciona los problemas de los mismos, y administra las operaciones del servidor de Integration ServicesIntegration Services .For example, you set project and package parameters, configure environments to specify runtime values for packages, execute and troubleshoot packages, and manage Integration ServicesIntegration Services server operations.

Nota

En este artículo se describe el catálogo de SSIS en general y el catálogo de SSIS ejecutado de forma local.This article describes the SSIS Catalog in general, and the SSIS Catalog running on premises. El catálogo de SSIS también se puede crear en Azure SQL Database, y los paquetes SSIS se pueden implementar y ejecutar en Azure.You can also create the SSIS Catalog in Azure SQL Database, and deploy and run SSIS packages in Azure. Para obtener más información, consulte Lift and shift SQL Server Integration Services workloads to the cloud (Migrar cargas de trabajo de SQL Server Integration Services a la nube mediante lift-and-shift).For more info, see Lift and shift SQL Server Integration Services workloads to the cloud.

Aunque los paquetes SSIS también se pueden ejecutar en Linux, no se admite el catálogo de SSIS.Although you can also run SSIS packages on Linux, the SSIS Catalog is not supported on Linux. Para obtener más información, consulte Extracción, transformación y carga de datos en Linux con SSIS .For more info, see Extract, transform, and load data on Linux with SSIS.

Entre los objetos que se almacenan en el catálogo SSISDB se incluyen proyectos, paquetes, parámetros, entornos y el historial de operaciones.The objects that are stored in the SSISDB catalog include projects, packages, parameters, environments, and operational history.

Inspecciona objetos, valores y los datos operativos que se almacenan en el catálogo de SSISDB , consultando las vistas de la base de datos de SSISDB .You inspect objects, settings, and operational data that are stored in the SSISDB catalog, by querying the views in the SSISDB database. Administra los objetos al llamar a los procedimientos almacenados en la base de datos de SSISDB o mediante la interfaz de usuario del catálogo de SSISDB .You manage the objects by calling stored procedures in the SSISDB database or by using the UI of the SSISDB catalog. En muchos casos, la misma tarea se puede realizar en la interfaz de usuario o al llamar a un procedimiento almacenado.In many cases, the same task can be performed in the UI or by calling a stored procedure.

Para mantener la base de datos de SSISDB , se recomienda aplicar las directivas corporativas estándar para administrar las bases de datos de usuario.To maintain the SSISDB database, it is recommended that you apply standard enterprise policies for managing user databases. Para obtener información acerca de cómo crear planes de mantenimiento, vea Maintenance Plans.For information about creating maintenance plans, see Maintenance Plans.

El catálogo de SSISDB y la base de datos de SSISDB admiten Windows PowerShell.The SSISDB catalog and the SSISDB database support Windows PowerShell. Para obtener más información acerca de cómo usar SQL Server con Windows PowerShell, vea SQL Server PowerShell.For more information about using SQL Server with Windows PowerShell, see SQL Server PowerShell. Para obtener ejemplos de cómo usar Windows PowerShell para completar tareas como implementar un proyecto, vea la entrada del blog SSIS y PowerShell en SQL Server 2012, en blogs.msdn.com.For examples of how to use Windows PowerShell to complete tasks such as deploying a project, see the blog entry, SSIS and PowerShell in SQL Server 2012, on blogs.msdn.com.

Para más información sobre cómo ver los datos de las operaciones, consulte Monitor de ejecución de paquetes y otras operaciones.For more information about viewing operations data, see Monitor Running Package and Other Operations.

Tiene acceso al catálogo de SSISDB en SQL Server Management StudioSQL Server Management Studio al conecta a SQL ServerSQL Server el motor de base de datos y después expandir el nodo Catálogos de Integration Services en el Explorador de objetos.You access the SSISDB catalog in SQL Server Management StudioSQL Server Management Studio by connecting to the SQL ServerSQL Server Database Engine and then expanding the Integration Services Catalogs node in Object Explorer. Tiene acceso a la base de datos de SSISDB en SQL Server Management StudioSQL Server Management Studio al expandir el nodo Bases de datos en el Explorador de objetos.You access the SSISDB database in SQL Server Management StudioSQL Server Management Studio by expanding the Databases node in Object Explorer.

Nota

No puede cambiar el nombre de la base de datos de SSISDB .You cannot rename the SSISDB database.

Nota

Si la instancia de SQL ServerSQL Server a la que la base de datos SSISDB se adjuntada se detiene o no responde, el proceso de ISServerExec.exe finaliza.If the SQL ServerSQL Server instance that the SSISDB database is attached to, stops or does not respond, the ISServerExec.exe process ends. Se escribe un mensaje en un registro de eventos de Windows.A message is written to a Windows Event log.

Si los recursos de SQL ServerSQL Server conmutan por error como parte de una conmutación por error de clúster, los paquetes en ejecución no se reinician.If the SQL ServerSQL Server resources fail over as part of a cluster failover, the running packages do not restart. Puede usar los puntos de comprobación para reiniciar los paquetes.You can use checkpoints to restart packages. Para obtener más información, vea Restart Packages by Using Checkpoints.For more information, see Restart Packages by Using Checkpoints.

Características y funcionalidadesFeatures and capabilities

Identificadores de objeto de catálogoCatalog Object Identifiers

Cuando cree un nuevo objeto en el catálogo, asígnele un nombreWhen you create a new object in the catalog, assign a name to the object. El nombre del objeto es un identificador.The object name is an identifier. SQL ServerSQL Server define las reglas para las que los caracteres se pueden usar en un identificador.defines rules for which characters can be used in an identifier. Los nombres de los siguientes objetos deben seguir las reglas de identificador.Names for the following objects must follow identifier rules.

  • CarpetaFolder

  • ProyectoProject

  • EntornoEnvironment

  • ParámetroParameter

  • Variable de entornoEnvironment Variable

Carpeta, proyecto, entornoFolder, Project, Environment

Tenga en cuenta las reglas siguientes al cambiar el nombre de una carpeta, un proyecto, o un entorno.Consider the following rules when renaming a folder, project, or environment.

  • Entre los caracteres no válidos, se incluyen los caracteres ASCII/Unicode del 1 al 31, comillas dobles ("), menor que (<), mayor que (>), barra vertical (|), retroceso (\b), NULL (\0) y tabulación (\t).Invalid characters include ASCII/Unicode characters 1 through 31, quote ("), less than (<), greater than (>), pipe (|), backspace (\b), null (\0), and tab (\t).

  • El nombre no puede contener espacios delante ni detrás.The name might not contain leading or trailing spaces.

  • @ no se permite como primer carácter, pero los caracteres subsiguientes pueden utilizar @.@ is not allowed as the first character, but subsequent characters might use @.

  • La longitud del nombre debe ser mayor que 0 y menor o igual que 128.The length of the name must be greater than 0 and less than or equal to 128.

ParámetroParameter

Tenga en cuenta las reglas siguientes cuando asigne un nombre a un parámetro.Consider the following rules when naming a parameter.

  • El primer carácter del nombre debe ser una letra, tal como se define en el Estándar Unicode 2.0, o un carácter de subrayado ().The first character of the name must be a letter as defined in the Unicode Standard 2.0, or an underscore ().

  • Los caracteres siguientes pueden ser letras o números, tal como se define en el Estándar Unicode 2.0, o un carácter de subrayado ().Subsequent characters can be letters or numbers as defined in the Unicode Standard 2.0, or an underscore ().

Variable de entornoEnvironment Variable

Tenga en cuenta las reglas siguientes cuando asigne un nombre a una variable de entorno.Consider the following rules when naming an environment variable.

  • Entre los caracteres no válidos, se incluyen los caracteres ASCII/Unicode del 1 al 31, comillas dobles ("), menor que (<), mayor que (>), barra vertical (|), retroceso (\b), NULL (\0) y tabulación (\t).Invalid characters include ASCII/Unicode characters 1 through 31, quote ("), less than (<), greater than (>), pipe (|), backspace (\b), null (\0), and tab (\t).

  • El nombre no puede contener espacios delante ni detrás.The name might not contain leading or trailing spaces.

  • @ no se permite como primer carácter, pero los caracteres subsiguientes pueden utilizar @.@ is not allowed as the first character, but subsequent characters might use @.

  • La longitud del nombre debe ser mayor que 0 y menor o igual que 128.The length of the name must be greater than 0 and less than or equal to 128.

  • El primer carácter del nombre debe ser una letra, tal como se define en el Estándar Unicode 2.0, o un carácter de subrayado ().The first character of the name must be a letter as defined in the Unicode Standard 2.0, or an underscore ().

  • Los caracteres siguientes pueden ser letras o números, tal como se define en el Estándar Unicode 2.0, o un carácter de subrayado ().Subsequent characters can be letters or numbers as defined in the Unicode Standard 2.0, or an underscore ().

Configuración de catálogoCatalog Configuration

Ajusta con precisión cómo se comporta el catálogo ajustando las propiedades del catálogo.You fine-tune how the catalog behaves by adjusting the catalog properties. Las propiedades del catálogo definen cómo se cifra la información confidencial y cómo se conservan las operaciones y los datos de versiones del proyecto.Catalog properties define how sensitive data is encrypted, and how operations and project versioning data is retained. Para establecer las propiedades del catálogo, use el cuadro de diálogo Propiedades del catálogo o llame al procedimiento almacenado catalog.configure_catalog (base de datos de SSISDB).To set catalog properties, use the Catalog Properties dialog box or call the catalog.configure_catalog (SSISDB Database) stored procedure. Para ver las propiedades, use el cuadro de diálogo o la consulta catalog.catalog_properties (base de datos de SSISDB).To view the properties, use the dialog box or query catalog.catalog_properties (SSISDB Database). Puede acceder al cuadro de diálogo si hace clic con el botón derecho en SSISDB en el Explorador de objetos.You access the dialog box by right-clicking SSISDB in Object Explorer.

Limpieza de las operaciones y los datos de versiones del proyectoOperations and Project Version Cleanup

Los datos de estado para muchas de las operaciones del catálogo se almacena en tablas de base de datos internas.Status data for many of the operations in the catalog is stored in internal database tables. Por ejemplo, el catálogo realiza el seguimiento del estado de las ejecuciones de paquetes y las implementaciones de proyecto.For example, the catalog tracks the status of package executions and project deployments. Para mantener el tamaño de los datos de operaciones, se usa Tareas de mantenimiento de SSIS Server de SQL Server Management StudioSQL Server Management Studio para quitar los datos antiguos.To maintain the size of the operations data, the SSIS Server Maintenance Job in SQL Server Management StudioSQL Server Management Studio is used to remove old data. Este trabajo del agente de SQL ServerSQL Server se crea al instalar Integration ServicesIntegration Services .This SQL ServerSQL Server Agent job is created when Integration ServicesIntegration Services is installed.

Puede actualizar o volver a implementar un proyecto de Integration ServicesIntegration Services implementándolo con el mismo nombre en la misma carpeta en el catálogo.You can update or redeploy an Integration ServicesIntegration Services project by deploying it with the same name to the same folder in the catalog. De forma predeterminada, cada vez que vuelve a implementar un proyecto, el catálogo de SSISDB conserva la versión anterior del proyecto.By default, each time you redeploy a project, the SSISDB catalog retains the previous version of the project. Para mantener el tamaño de los datos de las operaciones, se utiliza el trabajo de mantenimiento del Agente SQL Server para quitar las versiones anteriores de proyectos.To maintain the size of the operations data, the SSIS Server Maintenance Job is used to remove old versions of projects.

Para ejecutar el trabajo de mantenimiento del servidor SSIS, SSIS crea el inicio de sesión de SQL Server ##MS_SSISServerCleanupJobLogin## .To run the SSIS Server Maintenance Job, SSIS creates the SQL Server login ##MS_SSISServerCleanupJobLogin##. Este inicio de sesión es solo para uso interno de SSIS.This login is only for internal use by SSIS.

Las siguientes propiedades del catálogo de SSISDB definen cómo se comporta este trabajo del Agente SQL ServerSQL Server .The following SSISDB catalog properties define how this SQL ServerSQL Server Agent job behaves. Puede ver y modificar las propiedades mediante el cuadro de diálogo Propiedades del catálogo o mediante catalog.catalog_properties (base de datos de SSISDB) y catalog.configure_catalog (base de datos de SSISDB).You can view and modify the properties by using the Catalog Properties dialog box or by using catalog.catalog_properties (SSISDB Database) and catalog.configure_catalog (SSISDB Database).

Borrar registros periódicamenteClean Logs Periodically
El paso de trabajo de limpieza de operaciones se ejecuta cuando esta propiedad se establece en True.The job step for operations cleanup runs when this property is set to True.

Período de retención (días)Retention Period (days)
Define la antigüedad máxima de los datos permitidos para las operaciones (en días).Defines the maximum age of allowable operations data (in days). Se quitan los datos más antiguos.Older data are removed.

El valor mínimo es un día.The minimum value is one day. El valor máximo solo está limitado por el valor máximo de los datos int de SQL ServerSQL Server.The maximum value is limited only by the maximum value of the SQL ServerSQL Server int data. Para más información sobre este tipo de datos, vea int, bigint, smallint y tinyint (Transact-SQL).For information about this data type, see int, bigint, smallint, and tinyint (Transact-SQL).

Quitar periódicamente versiones anterioresPeriodically Remove Old Versions
El paso de trabajo de limpieza de versiones del proyecto se ejecuta cuando esta propiedad se establece en True.The job step for project version cleanup runs when this property is set to True.

Número máximo de versiones por proyectoMaximum Number of Versions per Project
Define cuántas versiones de un proyecto se almacenan en el catálogo.Defines how many versions of a project are stored in the catalog. Se quitan las versiones anteriores de proyectos.Older versions of projects are removed.

Algoritmo de cifradoEncryption Algorithm

La propiedad Algoritmo de cifrado especifica el tipo de cifrado que se utiliza para cifrar los valores de los parámetros confidenciales.The Encryption Algorithm property specifies the type of encryption that is used to encrypt sensitive parameter values. Puede elegir entre los siguientes tipos de cifrado.You can choose from the following types of encryption.

  • AES_256 (predeterminado)AES_256 (default)

  • AES_192AES_192

  • AES_128AES_128

  • DESXDESX

  • TRIPLE_DES_3KEYTRIPLE_DES_3KEY

  • TRIPLE_DESTRIPLE_DES

  • DESDES

Al implementar un proyecto de Integration ServicesIntegration Services en el servidor Integration ServicesIntegration Services , el catálogo cifra automáticamente los datos del paquete y los valores confidenciales.When you deploy an Integration ServicesIntegration Services project to the Integration ServicesIntegration Services server, the catalog automatically encrypts the package data and sensitive values. El catálogo también descifra automáticamente los datos cuando lo recupera.The catalog also automatically decrypts the data when you retrieve it. El catálogo de SSISDB emplea el nivel de protección ServerStorage .The SSISDB catalog uses the ServerStorage protection level. Para más información, consulte Access Control for Sensitive Data in Packages.For more information, see Access Control for Sensitive Data in Packages.

Cambiar el algoritmo de cifrado es una operación que lleva mucho tiempo.Changing the encryption algorithm is a time-intensive operation. En primer lugar, el servidor tiene que utilizar el algoritmo especificado previamente para descifrar todos los valores de configuración.First, the server has to use the previously specified algorithm to decrypt all configuration values. A continuación, el servidor tiene que utilizar el nuevo algoritmo para volver a cifrar los valores.Then, the server has to use the new algorithm to re-encrypt the values. Durante este tiempo, no puede haber otras operaciones de Integration ServicesIntegration Services en el servidor.During this time, there cannot be other Integration ServicesIntegration Services operations on the server. Así, para que las operaciones de Integration ServicesIntegration Services continúen sin interrupción, el algoritmo de cifrado es un valor de solo lectura en el cuadro de diálogo de Management StudioManagement Studio.Thus, to enable Integration ServicesIntegration Services operations to continue uninterrupted, the encryption algorithm is a read-only value in the dialog box in Management StudioManagement Studio.

Para cambiar la configuración de la propiedad Algoritmo de cifrado , establezca la base de datos de SSISDB en modo de usuario único y, luego, llame al procedimiento almacenado catalog.configure_catalog.To change the Encryption Algorithm property setting, set the SSISDB database to the single-user mode and then call the catalog.configure_catalog stored procedure. Use ENCRYPTION_ALGORITHM para el argumento property_name.Use ENCRYPTION_ALGORITHM for the property_name argument. Para más información sobre los valores de propiedad admitidos, vea catalog.catalog_properties (base de datos de SSISDB).For the supported property values, see catalog.catalog_properties (SSISDB Database). Para más información sobre el procedimiento almacenado, vea catalog.configure_catalog (base de datos de SSISDB).For more information about the stored procedure, see catalog.configure_catalog (SSISDB Database).

Para más información sobre el modo de usuario único, vea Establecer una base de datos en modo de usuario único.For more information about single-user mode, see Set a Database to Single-user Mode. Para más información sobre el cifrado y los algoritmos de cifrado en SQL ServerSQL Server, vea los temas de la sección Cifrado de SQL Server.For information about encryption and encryption algorithms in SQL ServerSQL Server, see the topics in the section, SQL Server Encryption.

Para el cifrado se utiliza una clave maestra de base de datos.A database master key is used for the encryption. La clave se crea al crear el catálogo.The key is created when you create the catalog.

En la tabla siguiente se muestran los nombres de propiedad que aparecen en el cuadro de diálogo Propiedades del catálogo y las propiedades correspondientes de la vista de base de datos.The following table lists the property names shown in the Catalog Properties dialog box and the corresponding properties in the database view.

Nombre de la propiedad (cuadro de diálogoPropiedades del catálogo )Property Name (Catalog Properties dialog box) Nombre de la propiedad (vista de base de datos)Property Name (database view)
Nombre del algoritmo de cifradoEncryption Algorithm Name ENCRYPTION_ALGORITHMENCRYPTION_ALGORITHM
Borrar registros periódicamenteClean Logs Periodically OPERATION_CLEANUP_ENABLED​OPERATION_CLEANUP_ENABLED​
Período de retención (días)Retention Period (days) RETENTION_WINDOWRETENTION_WINDOW
Quitar periódicamente versiones anterioresPeriodically Remove Old Versions VERSION_CLEANUP_ENABLEDVERSION_CLEANUP_ENABLED
Número máximo de versiones por proyectoMaximum Number of Versions per Project MAX_PROJECT_VERSIONSMAX_PROJECT_VERSIONS
Nivel de registro predeterminado de todo el servidorServer-wide Default Logging Level SERVER_LOGGING_LEVELSERVER_LOGGING_LEVEL

PermisosPermissions

Los proyectos, los entornos y los paquetes se encuentran en carpetas que son objetos protegibles.Projects, environments, and packages are contained in folders that are securable objects. Puede conceder permisos a una carpeta, incluido el permiso de MANAGE_OBJECT_PERMISSIONS.You can grant permissions to a folder, including the MANAGE_OBJECT_PERMISSIONS permission. MANAGE_OBJECT_PERMISSIONS le permite delegar la administración del contenido de la carpeta a un usuario sin tener que conceder la pertenencia del usuario al rol ssis_admin.MANAGE_OBJECT_PERMISSIONS enables you to delegate the administration of folder contents to a user without having to grant the user membership to the ssis_admin role. También puede conceder permisos a los proyectos, entornos y operaciones.You can also grant permissions to projects, environments, and operations. Las operaciones incluyen inicializar Integration ServicesIntegration Services, implementar proyectos, crear e iniciar ejecuciones, validar proyectos y paquetes, y configurar el catálogo de SSISDB .Operations include initializing Integration ServicesIntegration Services, deploying projects, creating and starting executions, validating projects and packages, and configuring the SSISDB catalog.

Para obtener más información sobre los roles de base de datos, vea Roles de nivel de base de datos.For more information about database roles, see Database-Level Roles.

El catálogo de SSISDB usa un desencadenador DDL, ddl_cleanup_object_permissions, para exigir la integridad de la información sobre permisos para elementos de SSIS protegibles.The SSISDB catalog uses a DDL trigger, ddl_cleanup_object_permissions, to enforce the integrity of permissions information for SSIS securables. El desencadenador se activa cuando se quita de la base de datos de SSISDB una entidad de seguridad de base de datos, como un usuario de base de datos, un rol de base de datos o un rol de aplicación de base de datos.The trigger fires when a database principal, such as a database user, database role, or a database application role, is removed from the SSISDB database.

Si la entidad de seguridad ha concedido o denegado los permisos a otras entidades de seguridad, revoque los permisos proporcionados por el otorgante, antes de que la entidad de seguridad se pueda quitar.If the principal has granted or denied permissions to other principals, revoke the permissions given by the grantor, before the principal can be removed. De lo contrario, se devuelve un mensaje de error cuando el sistema intenta quitar la entidad de seguridad.Otherwise, an error message is returned when the system tries to remove the principal. El desencadenador quita todos los registros de permisos donde la entidad de seguridad de base de datos es un receptor.The trigger removes all permission records where the database principal is a grantee.

Se recomienda que el desencadenador no se deshabilite porque garantiza que no hay ningún registro de permiso huérfano después de que una entidad de seguridad de base de datos se quita de la base de datos de SSISDB .It is recommended that the trigger is not disabled because it ensures that are no orphaned permission records after a database principal is dropped from the SSISDB database.

Administrar permisosManaging Permissions

Puede administrar permisos mediante la interfaz de usuario de SQL Server Management StudioSQL Server Management Studio , los procedimientos almacenados y el espacio de nombres Microsoft.SqlServer.Management.IntegrationServices .You can manage permissions by using the SQL Server Management StudioSQL Server Management Studio UI, stored procedures, and the Microsoft.SqlServer.Management.IntegrationServices namespace.

Para administrar permisos con la interfaz de usuario de SQL Server Management StudioSQL Server Management Studio, use los cuadros de diálogo siguientes:To manage permissions using the SQL Server Management StudioSQL Server Management Studio UI, use the following dialog boxes:

Para administrar permisos mediante Transact-SQL, llame a catalog.grant_permission (base de datos de SSISDB), catalog.deny_permission (base de datos de SSISDB) y catalog.revoke_permission (base de datos de SSISDB).To manage permissions using Transact-SQL, call catalog.grant_permission (SSISDB Database), catalog.deny_permission (SSISDB Database), and catalog.revoke_permission (SSISDB Database). Para ver los permisos efectivos de la entidad de seguridad actual para todos los objetos, consulte catalog.effective_object_permissions (base de datos de SSISDB).To view effective permissions for the current principal for all objects, query catalog.effective_object_permissions (SSISDB Database). Este tema proporciona descripciones de los diferentes tipos de permisos.This topic provides descriptions of the different types of permissions. Para ver los permisos asignados explícitamente al usuario, consulte catalog.explicit_object_permissions (base de datos de SSISDB).To view permissions that have been explicitly assigned to the user, query catalog.explicit_object_permissions (SSISDB Database).

CarpetasFolders

Una carpeta contiene uno o más proyectos y entornos en el catálogo de SSISDB .A folder contains one or more projects and environments in the SSISDB catalog. Puede usar la vista catalog.folders (base de datos de SSISDB) para acceder a información sobre las carpetas del catálogo.You can use the catalog.folders (SSISDB Database) view to access information about folders in the catalog. Puede utilizar los siguientes procedimientos almacenados para administrar carpetas:You can use the following stored procedures to manage folders:

Proyectos y paquetesProjects and Packages

Cada proyecto puede contener varios paquetes.Each project can contain multiple packages. Proyectos y paquetes pueden contener parámetros y referencias a los entornos.Both projects and packages can contain parameters and references to environments. Puede tener acceso a los parámetros y referencias del entorno mediante el uso de Configure Dialog Box.You can access the parameters and environment references by using the Configure Dialog Box.

Puede realizar otras tareas de proyectos llamando a los siguientes procedimientos almacenados:You can carry out other project tasks by calling the following stored procedures:

Estas vistas proporcionan detalles sobre los paquetes, proyectos y versiones del proyecto.These views provide details about packages, projects, and project versions.

ParámetrosParameters

Use parámetros para asignar valores a las propiedades del paquete en el momento de la ejecución del mismo.You use parameters to assign values to package properties at the time of package execution. Para establecer el valor de un paquete o parámetro de proyecto y borrar el valor, llame a catalog.set_object_parameter_value (base de datos de SSISDB) y catalog.clear_object_parameter_value (base de datos de SSISDB).To set the value of a package or project parameter and to clear the value, call catalog.set_object_parameter_value (SSISDB Database) and catalog.clear_object_parameter_value (SSISDB Database). Para establecer el valor de un parámetro para una instancia de ejecución, llame a catalog.set_execution_parameter_value (base de datos de SSISDB).To set the value of a parameter for an instance of execution, call catalog.set_execution_parameter_value (SSISDB Database). Puede recuperar los valores de parámetro predeterminados si llama a catalog.get_parameter_values (base de datos de SSISDB).You can retrieve default parameter values by calling catalog.get_parameter_values (SSISDB Database).

Estas vistas muestran los parámetros de todos los paquetes y proyectos, así como los valores de los parámetros que se usan para una instancia de ejecución.These views show the parameters for all packages and projects, and parameter values that are used for an instance of execution.

Entornos de servidor, variables de servidor y referencias del entorno de servidorServer Environments, Server Variables, and Server Environment References

Los entornos de servidor contienen variables de servidor.Server environments contain server variables. Los valores variables se pueden usar cuando un paquete se ejecuta o se valida en el servidor Integration ServicesIntegration Services .The variable values can be used when a package is executed or validated on the Integration ServicesIntegration Services server.

Los siguientes procedimientos almacenados permiten realizar muchas otras tareas de administración para entornos y variables.The following stored procedures enable you to perform many other management tasks for environments and variables.

Al llamar al procedimiento almacenado catalog.set_environment_variable_protection (base de datos de SSISDB), puede establecer el bit de sensibilidad de una variable.By calling the catalog.set_environment_variable_protection (SSISDB Database) stored procedure, you can set the sensitivity bit for a variable.

Para utilizar el valor de una variable de servidor, especifique la referencia entre el proyecto y el entorno del servidor.To use the value of a server variable, specify the reference between the project and the server environment. Puede usar los procedimientos almacenados siguientes para crear y eliminar referencias.You can use the following stored procedures to create and delete references. También puede indicar si el entorno se puede encontrar en la misma carpeta que el proyecto o en una carpeta diferente.You can also indicate whether the environment can be located in the same folder as the project or in a different folder.

Para obtener más detalles sobre entornos y variables, consulte estas vistas.For more details about environments and variables, query these views.

Ejecuciones y validacionesExecutions and Validations

Una ejecución es una instancia de una ejecución del paquete.An execution is an instance of a package execution. Llame a catalog.create_execution (base de datos de SSISDB) y catalog.start_execution (base de datos de SSISDB) para crear e iniciar una ejecución.Call catalog.create_execution (SSISDB Database) and catalog.start_execution (SSISDB Database) to create and start an execution. Para detener una ejecución o una validación de paquete o proyecto, llame a catalog.stop_operation (base de datos de SSISDB).To stop an execution or a package/project validation, call catalog.stop_operation (SSISDB Database).

Para que un paquete en ejecución se ponga en pausa y cree un archivo de volcado, llame al procedimiento almacenado de catalog.create_execution_dump.To cause a running package to pause and create a dump file, call the catalog.create_execution_dump stored procedure. Un archivo de volcado proporciona información sobre la ejecución de un paquete que puede ayudarle a solucionar problemas de ejecución.A dump file provides information about the execution of a package that can help you troubleshoot execution issues. Para obtener más información acerca de cómo generar y configurar archivos de volcado, vea Generating Dump Files for Package Execution.For more information about generating and configuring dump files, see Generating Dump Files for Package Execution.

Para obtener más información sobre ejecuciones, validaciones, mensajes que se registran durante las operaciones y la información contextual relacionada con errores, consulte estas vistas.For details about executions, validations, messages that are logged during operations, and contextual information related to errors, query these views.

Puede validar proyectos y paquetes si llama a los procedimientos almacenados catalog.validate_project (base de datos de SSISDB) y catalog.validate_package (base de datos de SSISDB).You can validate projects and packages by calling the catalog.validate_project (SSISDB Database) and catalog.validate_package (SSISDB Database) stored procedures. La vista catalog.validations (base de datos de SSISDB) proporciona detalles sobre validaciones, como las referencias del entorno de servidor que se consideran en la validación, si se trata de una validación de dependencia o de una validación completa, y si para ejecutar el paquete se usa el tiempo de ejecución de 32 bits o el tiempo de ejecución de 64 bits.The catalog.validations (SSISDB Database) view provides details about validations such as the server environment references that are considered in the validation, whether it is a dependency validation or a full validation, and whether the 32-bit runtime or the 64-bit runtime is used to run the package.

Crear el catálogo de SSISCreate the SSIS Catalog

Después de diseñar y probar paquetes en SQL Server Data ToolsSQL Server Data Tools, puede implementar los proyectos que contienen los paquetes en un servidor de Integration ServicesIntegration Services .After you design and test packages in SQL Server Data ToolsSQL Server Data Tools, you can deploy the projects that contain the packages to an Integration ServicesIntegration Services server. Para poder implementar los proyectos en el servidor de Integration ServicesIntegration Services , el servidor debe contener el catálogo de SSISDB .Before you can deploy the projects to the Integration ServicesIntegration Services server, the server must contain the SSISDB catalog. El programa de instalación de SQL Server 2012 (11.x)SQL Server 2012 (11.x) no crea automáticamente el catálogo; es necesario crear manualmente el catálogo usando las instrucciones siguientes.The installation program for SQL Server 2012 (11.x)SQL Server 2012 (11.x) does not automatically create the catalog; you need to manually create the catalog by using the following instructions.

Puede crear el catálogo de SSISDB en SQL Server Management StudioSQL Server Management Studio.You can create the SSISDB catalog in SQL Server Management StudioSQL Server Management Studio. También crea el catálogo mediante programación con Windows PowerShell.You also create the catalog programmatically by using Windows PowerShell.

Para crear un catálogo de SSISDB en SQL Server Management StudioTo create the SSISDB catalog in SQL Server Management Studio

  1. Abra SQL Server Management StudioSQL Server Management Studio.Open SQL Server Management StudioSQL Server Management Studio.

  2. Conéctese al motor de base de datos de SQL ServerSQL Server .Connect to the SQL ServerSQL Server Database Engine.

  3. En el Explorador de objetos, expanda el nodo del servidor, haga clic con el botón derecho en el nodo Catálogos de Integration Services y, después, haga clic en Crear catálogo.In Object Explorer, expand the server node, right-click the Integration Services Catalogs node, and then click Create Catalog.

  4. Haga clic en Habilitar integración con CLR.Click Enable CLR Integration.

    El catálogo usar los procedimientos almacenados de CLR.The catalog uses CLR stored procedures.

  5. Haga clic en Habilitar la ejecución automática del procedimiento almacenado de Integration Services al iniciar SQL Server para permitir que el procedimiento almacenado catalog.startup se ejecute cada vez que se reinicie la instancia del servidor de SSISSSIS .Click Enable automatic execution of Integration Services stored procedure at SQL Server startup to enable the catalog.startup stored procedure to run each time the SSISSSIS server instance is restarted.

    El procedimiento almacenado realiza el mantenimiento del estado de las operaciones del catálogo de SSISDB.The stored procedure performs maintenance of the state of operations for the SSISDB catalog. Corrige el estado de los paquetes que estaban en ejecución si la instancia del servidor de SSISSSIS se bloquea.It fixes the status of any packages there were running if the SSISSSIS server instance goes down.

  6. Escriba una contraseña y haga clic en Aceptar.Enter a password, and then click Ok.

    La contraseña protege la clave maestra de la base de datos que se usar para cifrar los datos del catálogo.The password protects the database master key that is used for encrypting the catalog data. Guarde la contraseña en un lugar seguro.Save the password in a secure location. Se recomienda que haga también una copia de seguridad de la clave maestra de la base de datos.It is recommended that you also back up the database master key. Para más información, consulte Back Up a Database Master Key.For more information, see Back Up a Database Master Key.

Para crear el catálogo de SSISDB mediante programaciónTo create the SSISDB catalog programmatically

  1. Ejecute el siguiente script de PowerShell:Execute the following PowerShell script:

    # Load the IntegrationServices Assembly  
    [Reflection.Assembly]::LoadWithPartialName("Microsoft.SqlServer.Management.IntegrationServices")  
    
    # Store the IntegrationServices Assembly namespace to avoid typing it every time  
    $ISNamespace = "Microsoft.SqlServer.Management.IntegrationServices"  
    
    Write-Host "Connecting to server ..."  
    
    # Create a connection to the server  
    $sqlConnectionString = "Data Source=localhost;Initial Catalog=master;Integrated Security=SSPI;"  
    $sqlConnection = New-Object System.Data.SqlClient.SqlConnection $sqlConnectionString  
    
    # Create the Integration Services object  
    $integrationServices = New-Object $ISNamespace".IntegrationServices" $sqlConnection  
    
    # Provision a new SSIS Catalog  
    $catalog = New-Object $ISNamespace".Catalog" ($integrationServices, "SSISDB", "P@assword1")  
    $catalog.Create()  
    
    

    Para obtener más ejemplos de cómo usar Windows PowerShell y el espacio de nombres Microsoft.SqlServer.Management.IntegrationServices, vea la entrada del blog SSIS and PowerShell in SQL Server 2012 (SSIS y PowerShell en SQL Server 2012), en blogs.msdn.com.For more examples of how to use Windows PowerShell and the Microsoft.SqlServer.Management.IntegrationServices namespace, see the blog entry, SSIS and PowerShell in SQL Server 2012, on blogs.msdn.com. Para obtener información general sobre el espacio de nombres y ejemplos de código, vea la entrada del blog sobre el Modelo de objetos administrados del catálogo de SSISen blogs.msdn.com.For an overview of the namespace and code examples, see the blog entry, A Glimpse of the SSIS Catalog Managed Object Model, on blogs.msdn.com.

Propiedades del catálogo, cuadro de diálogoCatalog Properties Dialog Box

Utilice el cuadro de diálogo Propiedades del catálogo para configurar el catálogo de SSISDB.Use the Catalog Properties dialog box to configure the SSISDB catalog. Las propiedades del catálogo definen cómo se cifra la información confidencial, cómo se conservan las operaciones y los datos de versiones del proyecto, y el tiempo de espera de las operaciones de validación. El catálogo de SSISDB es un punto centralizado de almacenamiento y administración para los proyectos, paquetes, parámetros y entornos de Integration ServicesIntegration Services .Catalog properties define how sensitive data is encrypted, how operations and project versioning data is retained, and when validation operations time out. The SSISDB catalog is a central storage and administration point for Integration ServicesIntegration Services projects, packages, parameters, and environments.

También puede ver las propiedades del catálogo en la vista catalog.catalog_properties y establecer las propiedades mediante el procedimiento almacenado catalog.configure_catalog.You can also view catalog properties in the catalog.catalog_properties view, and set the properties by using the catalog.configure_catalog stored procedure. Para más información, vea catalog.catalog_properties (base de datos SSISDB) y catalog.configure_catalog (base de datos SSISDB).For more information, see catalog.catalog_properties (SSISDB Database) and catalog.configure_catalog (SSISDB Database).

¿Qué desea hacer?What do you want to do?

Abrir el cuadro de diálogo Propiedades del catálogoOpen the Catalog Properties Dialog Box

  1. Abra SQL ServerSQL ServerManagement StudioManagement Studio.Open SQL ServerSQL ServerManagement StudioManagement Studio.

  2. Conéctese al motor de base de datos de Microsoft SQL Server.Connect Microsoft SQL Server Database Engine.

  3. En el Explorador de objetos, expanda el nodo Integration Services , haga clic con el botón derecho en SSISDBy luego haga clic en Propiedades.In Object Explorer, expand the Integration Services node, right-click SSISDB, and then click Properties.

Configurar las opcionesConfigure the Options

OpcionesOptions

En la tabla siguiente se describen algunas propiedades del cuadro de diálogo y las propiedades correspondientes de la vista catalog.catalog_properties.The following table describes certain properties in the dialog box and the corresponding properties in the catalog.catalog_properties view.

Nombre de la propiedad (cuadro de diálogo Propiedades del catálogo)Property Name (Catalog Properties dialog box) Nombre de la propiedad (vista catalog.catalog_properties)Property Name (catalog.catalog_properties view) DescripciónDescription
Nombre del algoritmo de cifradoEncryption Algorithm Name ENCRYPTION_ALGORITHMENCRYPTION_ALGORITHM Especifica el tipo de cifrado que se utiliza para cifrar los valores de los parámetros confidenciales del catálogo.Specifies the type of encryption that is used to encrypt the sensitive parameter values in the catalog. Los posibles valores son los siguientes:The following are the possible values:

DESDES

TRIPLE_DESTRIPLE_DES

TRIPLE_DES_3KEYTRIPLE_DES_3KEY

DESPXDESPX

AES_128AES_128

AES_192AES_192

AES_256 (predeterminado)AES_256 (default)
Número máximo de versiones por proyectoMaximum Number of Versions per Project MAX_PROJECT_VERSIONSMAX_PROJECT_VERSIONS Especifica cuántas versiones de un proyecto se almacenan en el catálogo.Specify how many versions of a project are stored in the catalog. Las versiones anteriores de los proyectos que superen el máximo se quitarán cuando se ejecute el trabajo de limpieza de versiones del proyecto.Older versions of projects that exceed the maximum are removed when the project version cleanup job runs.
Borrar registros periódicamenteClean Logs Periodically OPERATION_CLEANUP_ENABLEDOPERATION_CLEANUP_ENABLED Establezca la propiedad en True para indicar que se ejecuta el trabajo limpieza de operaciones del Agente SQL Server.Set the property to True to indicate that the SQL Server Agent job, operations cleanup, runs. En caso contrario, establezca la propiedad en False.Otherwise, set the property to False.
Período de retención (días)Retention Period (days) RETENTION_WINDOWRETENTION_WINDOW Especifique la antigüedad máxima de los datos permitidos para las operaciones (en días).Specify the maximum age of allowable operations data (in days). El trabajo limpieza de operaciones del Agente SQL quitará los datos anteriores al número de días especificado.Data that is older than the specified number of days are removed by the SQL Agent job, operations cleanup.

Copia de seguridad, restauración y traslado del catálogo de SSISBack up, Restore, and Move the SSIS Catalog

APPLIES TO: síSQL Server (a partir de 2016) noAzure SQL Database noAzure SQL Data Warehouse noAlmacenamiento de datos paralelosAPPLIES TO: yesSQL Server (starting with 2016) noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

SQL Server 2017 Integration Services (SSIS)SQL Server 2017 Integration Services (SSIS) incluye la base de datos de SSISDB.includes the SSISDB database. En la base de datos de SSISDB, se consultan vistas para inspeccionar objetos, valores y los datos operativos que se almacenan en el catálogo de SSISDB , consultando las vistas de la base de datos de SSISDB.You query views in the SSISDB database to inspect objects, settings, and operational data that are stored in the SSISDB catalog. Este tema proporciona instrucciones para hacer una copia de seguridad de la base de datos y restaurarla.This topic provides instructions for backing up and restoring the database.

El catálogo de SSISDB almacena los paquetes que se han implementado en el servidor de Integration ServicesIntegration Services.The SSISDB catalog stores the packages that you've deployed to the Integration ServicesIntegration Services server. Para más información sobre el catálogo, vea Catálogo de SSIS.For more information about the catalog, see SSIS Catalog.

Para realizar una copia de seguridad de la base de datos de SSISTo Back up the SSIS Database

  1. Abra SQL Server Management StudioSQL Server Management Studio y conéctese a una instancia de SQL ServerSQL Server.Open SQL Server Management StudioSQL Server Management Studio and connect to an instance of SQL ServerSQL Server.

  2. Para realizar una copia de seguridad de la clave maestra de la base de datos de SSISDB, use la instrucción Transact-SQL BACKUP MASTER KEY.Back up the master key for the SSISDB database, by using the BACKUP MASTER KEY Transact-SQL statement. La clave se almacena en un archivo que especifique.The key is stored in a file that you specify. Use una contraseña utilizada para cifrar la clave maestra del archivo.Use a password to encrypt the master key in the file.

    Para más información sobre la instrucción, vea BACKUP MASTER KEY (Transact-SQL).For more information about the statement, see BACKUP MASTER KEY (Transact-SQL).

    En el ejemplo siguiente, la clave maestra se exporta al archivo c:\temp directory\RCTestInstKey .In the following example, the master key is exported to the c:\temp directory\RCTestInstKey file. La contraseña de LS2Setup! se usa para cifrar la clave maestra.The LS2Setup! password is used to encrypt the master key.

    backup master key to file = 'c:\temp\RCTestInstKey'  
           encryption by password = 'LS2Setup!'  
    
    
  3. Use el cuadro de diálogo Copia de seguridad de la base de datos en SQL Server Management StudioSQL Server Management Studiopara realizar una copia de seguridad de la base de datos de SSISDB.Back up the SSISDB database by using the Backup Database dialog box in SQL Server Management StudioSQL Server Management Studio. Para más información, vea Cómo: Realizar una copia de seguridad de una base de datos (SQL Server Management Studio).For more information, see How to: Back Up a Database (SQL Server Management Studio).

  4. Realice los procedimientos siguientes para generar el script CREATE LOGIN para ##MS_SSISServerCleanupJobLogin##.Generate the CREATE LOGIN script for ##MS_SSISServerCleanupJobLogin##, by doing the following things. Para obtener más información, vea CREATE LOGIN (Transact-SQL).For more information, see CREATE LOGIN (Transact-SQL).

    1. En el Explorador de objetos de SQL Server Management StudioSQL Server Management Studio, expanda el nodo Seguridad y el nodo Inicios de sesión .In Object Explorer in SQL Server Management StudioSQL Server Management Studio, expand the Security node and then expand the Logins node.

    2. Haga clic con el botón derecho en ##MS_SSISServerCleanupJobLogin## y, después, haga clic en Incluir inicio de sesión como > CREATE To > Nueva ventana del Editor de consultas.Right-click ##MS_SSISServerCleanupJobLogin##, and then click Script Login as > CREATE To > New Query Editor Window.

  5. Si restaura la base de datos de SSISDB a una instancia de SQL ServerSQL Server en la que nunca se ha creado el catálogo de SSISDB, genere el script CREATE PROCEDURE para sp_ssis_startup como se indica aquí.If you are restoring the SSISDB database to an SQL ServerSQL Server instance where the SSISDB catalog was never created, generate the CREATE PROCEDURE script for sp_ssis_startup, by doing the following things. Para obtener más información, vea CREATE PROCEDURE (Transact-SQL).For more information, see CREATE PROCEDURE (Transact-SQL).

    1. En el Explorador de objetos, expanda el nodo Bases de datos y el nodo maestro > Programación > Procedimientos almacenados .In Object Explorer, expand the Databases node and then expand the master > Programmability > Stored Procedures node.

    2. Haga clic con el botón derecho en dbo.sp_ssis_startupy, después, haga clic en Incluir procedimiento almacenado como > CREATE To > Nueva ventana del Editor de consultas.Right-click dbo.sp_ssis_startup, and then click Script Stored Procedure as > CREATE To > New Query Editor Window.

  6. Confirme que se ha iniciado el Agente SQL ServerConfirm that SQL Server Agent has been started

  7. Si restaura la base de datos de SSISDB a una instancia de SQL ServerSQL Server donde el catálogo de SSISDB nunca se creó, genere un script para el trabajo de mantenimiento de SSIS Server como se indica a continuación.If you are restoring the SSISDB database to an SQL ServerSQL Server instance where the SSISDB catalog was never created, generate a script for the SSIS Server Maintenance Job by doing the following things. El script se crea en el Agente SQL ServerSQL Server automáticamente cuando se crea el catálogo de SSISDB.The script is created in SQL ServerSQL Server Agent automatically when the SSISDB catalog is created. El trabajo sirve de ayuda para limpiar los registros de operación de la limpieza fuera de la ventana de retención y para eliminar versiones anteriores de proyectos.The job helps clean up cleanup operation logs outside the retention window and remove older versions of projects.

    1. En el Explorador de objetos, expanda el nodo Agente SQL Server y luego expanda el nodo Trabajos .In Object Explorer, expand the SQL Server Agent node and then expand the Jobs node.

    2. Haga clic con el botón derecho en el trabajo de mantenimiento del Servidor SSIS y, después, haga clic en Incluir trabajo como > CREATE To > Nueva ventana del Editor de consultas.Right-click SSIS Server Maintenance Job, and then click Script Job as > CREATE To > New Query Editor Window.

Para restaurar la base de datos de SSISTo Restore the SSIS Database

  1. Si va a restaurar la base de datos de SSISDB en una instancia de SQL ServerSQL Server en la que nunca se ha creado el catálogo de SSISDB, habilite Common Language Runtime (CLR) mediante la ejecución del procedimiento almacenado sp_configure.If you are restoring the SSISDB database to an SQL ServerSQL Server instance where the SSISDB catalog was never created, enable common language runtime (clr) by running the sp_configure stored procedure. Para más información, vea sp_configure (Transact-SQL) y clr enabled (opción).For more information, see sp_configure (Transact-SQL) and clr enabled Option.

    use master   
           sp_configure 'clr enabled', 1  
           reconfigure  
    
    
  2. Si va a restaurar la base de datos de SSISDB a una instancia de SQL ServerSQL Server en la que el catálogo de SSISDB nunca se creó, cree la clave asimétrica y el inicio de sesión de la clave asimétrica y conceda el permiso UNSAFE al inicio de sesión.If you are restoring the SSISDB database to an SQL ServerSQL Server instance where the SSISDB catalog was never created, create the asymmetric key and the login from the asymmetric key, and grant UNSAFE permission to the login.

    Create Asymmetric key MS_SQLEnableSystemAssemblyLoadingKey  
           FROM Executable File = 'C:\Program Files\Microsoft SQL Server\110\DTS\Binn\Microsoft.SqlServer.IntegrationServices.Server.dll'  
    
    

    Integration ServicesIntegration Services requieren permisos UNSAFE para el inicio de sesión porque este debe disponer de acceso adicional con el fin de restringir recursos como, por ejemplo la API Win32 de Microsoft.CLR stored procedures require UNSAFE permissions to be granted to the login because the login requires additional access to restricted resources, such as the Microsoft Win32 API. Para obtener más información sobre el permiso de código UNSAFE, vea Creating an Assembly.For more information about the UNSAFE code permission, see Creating an Assembly.

    Create Login MS_SQLEnableSystemAssemblyLoadingUser  
           FROM Asymmetric key MS_SQLEnableSystemAssemblyLoadingKey   
    
           Grant unsafe Assembly to MS_SQLEnableSystemAssemblyLoadingUser  
    
    
  3. Use el cuadro de diálogo Restaurar base de datos en SQL Server Management StudioSQL Server Management Studiopara restaurar la base de datos de SSISDB a partir de una copia de seguridad.Restore the SSISDB database from the backup by using the Restore Database dialog box in SQL Server Management StudioSQL Server Management Studio. Para obtener más información, consulte los temas siguientes:For more information, see the following topics:

  4. Ejecute los scripts que ha creado en Para realizar una copia de seguridad de la base de datos de SSIS para ##MS_SSISServerCleanupJobLogin##, sp_ssis_startup y el trabajo de mantenimiento del servidor de SSIS.Execute the scripts that you created in the To Back up the SSIS Database for ##MS_SSISServerCleanupJobLogin##, sp_ssis_startup, and SSIS Server Maintenance Job. Confirme que se ha iniciado el Agente SQL Server.Confirm that SQL Server Agent has been started.

  5. Ejecute la instrucción siguiente con el fin de establecer el procedimiento de sp_ssis_startup para que se ejecute automáticamente.Run the following statement to set the sp_ssis_startup procedure for autoexecution. Para más información, vea sp_procoption (Transact-SQL).For more information, see sp_procoption (Transact-SQL).

    EXEC sp_procoption N'sp_ssis_startup','startup','on'  
    
  6. Asigne el usuario de SSISDB ##MS_SSISServerCleanupJobUser## (base de datos de SSISDB) a ##MS_SSISServerCleanupJobLogin## (para hacerlo, use el cuadro de diálogo Propiedades de inicio de sesión en SQL Server Management StudioSQL Server Management Studio).Map the SSISDB user ##MS_SSISServerCleanupJobUser## (SSISDB database) to ##MS_SSISServerCleanupJobLogin##, by using the Login Properties dialog box in SQL Server Management StudioSQL Server Management Studio.

  7. Restaure la clave maestra mediante uno de los métodos siguientes.Restore the master key by using one of the following methods. Para obtener más información acerca del cifrado, vea Encryption Hierarchy.For more information about encryption, see Encryption Hierarchy.

    • Método 1Method 1

      Use este método si ya ha realizado una copia de seguridad de la clave maestra de la base de datos y dispone de la contraseña que se utilizó para cifrar la clave maestra.Use this method if you've already performed a backup of the database master key, and you have the password used to encrypt the master key.

             Restore master key from file = 'c:\temp\RCTestInstKey'  
             Decryption by password = 'LS2Setup!' -- 'Password used to encrypt the master key during SSISDB backup'  
             Encryption by password = 'LS3Setup!' -- 'New Password'  
             Force  
      
      

      Nota

      Confirme que la cuenta de servicio de SQL ServerSQL Server tiene permisos para leer el archivo de la clave de la copia de seguridad.Confirm that the SQL ServerSQL Server service account has permissions to read the backup key file.

      Nota

      Verá el mensaje de advertencia siguiente que se muestra en SQL Server Management StudioSQL Server Management Studio si la clave maestra de la base de datos no se ha cifrado aún con la clave maestra de servicio.You see the following warning message displayed in SQL Server Management StudioSQL Server Management Studio if the database master key has not yet been encrypted by the service master key. Omita el mensaje de advertencia.Ignore the warning message.

      No se puede descifrar la clave maestra actual. Se omitió el error porque se especificó la opción FORCE.The current master key cannot be decrypted. The error was ignored because the FORCE option was specified.

      El argumento FORCE especifica que el proceso de restauración debe continuar aunque la clave maestra de la base de datos actual no está abierta.The FORCE argument specifies that the restore process should continue even if the current database master key is not open. Dado que la clave maestra de la base de datos no se ha abierto aún en la instancia donde se está restaurando la base de datos, verá este mensaje para el catálogo de SSISDB.For the SSISDB catalog, because the database master key has not been opened on the instance where you are restoring the database, you see this message.

    • Método 2Method 2

      Use este método si tiene la contraseña original que se usó para crear SSISDB.Use this method if you have the original password that was used to create SSISDB.

      open master key decryption by password = 'LS1Setup!' --'Password used when creating SSISDB'  
             Alter Master Key Add encryption by Service Master Key  
      
  8. Determine si el esquema del catálogo de SSISDB y los binarios de Integration ServicesIntegration Services (ensamblado de ISServerExec y SQLCLR) son compatibles (para hacerlo, ejecute catalog.check_schema_version).Determine whether the SSISDB catalog schema and the Integration ServicesIntegration Services binaries (ISServerExec and SQLCLR assembly) are compatible, by running catalog.check_schema_version.

  9. Para confirmar que la base de datos de SSISDB se ha restaurado correctamente, realice operaciones sobre el catálogo de SSISDB como, por ejemplo, ejecutar paquetes que se hayan implementado en el servidor de Integration ServicesIntegration Services .To confirm that the SSISDB database has been restored successfully, perform operations against the SSISDB catalog such as running packages that have been deployed to the Integration ServicesIntegration Services server. Para más información, consulte Run Integration Services (SSIS) Packages (Ejecución de paquetes de Integration Services [SSIS]).For more information, see Run Integration Services (SSIS) Packages.

Para mover la base de datos de SSISTo Move the SSIS Database

  • Siga las instrucciones para mover las bases de datos de usuarios.Follow the instructions for moving user databases. Para más información, consulte Move User Databases.For more information, see Move User Databases.

    Asegúrese de realizar una copia de seguridad de la clave maestra de la base de datos de SSISDB y de proteger el archivo de copia de seguridad.Ensure that you back up the master key for the SSISDB database and protect the backup file. Para más información, vea Para realizar una copia de seguridad de la base de datos de SSIS.For more information, see To Back up the SSIS Database.

    Asegúrese de que los objetos correspondientes de Integration Services (SSIS) se han creado en la nueva instancia de SQL ServerSQL Server donde aún no se haya creado el catálogo de SSISDB.Ensure that the Integration Services (SSIS) relevant objects are created in the new SQL ServerSQL Server instance where the SSISDB catalog has not yet been created.

Actualización del catálogo de SSIS (SSISDB)Upgrade the SSIS Catalog (SSISDB)

Ejecute el Asistente para actualización de SSISDB para actualizar la base de datos del catálogo de SSIS, SSISDB, cuando esta sea anterior a la versión actual de la instancia de SQL Server.Run the SSISDB Upgrade Wizard to upgrade the SSIS Catalog database, SSISDB, when the database is older than the current version of the SQL Server instance. Es posible que la base de datos sea anterior cuando se presenta alguna de las siguientes condiciones.The database may be older when one of the following conditions is true.

  • Restauró la base de datos de una versión anterior de SQL Server.You restored the database from an older version of SQL Server.

  • No quitó la base de datos de un grupo de disponibilidad AlwaysOn antes de actualizar la instancia de SQL Server.You did not remove the database from an Always On Availability Group before upgrading the SQL Server instance. Esta condición evita la actualización automática de la base de datos.This condition prevents the automatic upgrade of the database. Para obtener más información, vea Upgrading SSISDB in an availability group.For more info, see Upgrading SSISDB in an availability group.

El asistente solo puede actualizar la base de datos en una instancia de servidor local.The wizard can only upgrade the database on a local server instance.

Actualización del catálogo de SSIS (SSISDB) mediante la ejecución del Asistente para actualización de SSISDBUpgrade the SSIS Catalog (SSISDB) by running the SSISDB Upgrade Wizard

  1. Copia de seguridad de la base de datos Catálogo de SSIS, SSISDB.Back up the SSIS Catalog database, SSISDB.

  2. En SQL Server Management StudioSQL Server Management Studio, expanda el servidor local y luego expanda Catálogos de Integration Services.In SQL Server Management StudioSQL Server Management Studio, expand the local server, and then expand Integration Services Catalogs.

  3. Haga clic con el botón derecho en SSISDBy, después, seleccione Actualización de base de datos para iniciar el Asistente para actualización de SSISDB.Right-click on SSISDB, and then select Database Upgrade to launch the SSISDB Upgrade Wizard. O bien, inicie el Asistente para actualización de SSISDB mediante la ejecución de C:\Program Files\Microsoft SQL Server\140\DTS\Binn\ISDBUpgradeWizard.exe con permisos elevados en el servidor local.Or launch the SSISDB Upgrade Wizard by running C:\Program Files\Microsoft SQL Server\140\DTS\Binn\ISDBUpgradeWizard.exe with elevated permissions on the local server.

    Inicio del Asistente para actualización de SSISDB

  4. En la página Seleccionar instancia , seleccione una instancia de SQL Server en el servidor local.On the Select Instance page, select a SQL Server instance on the local server.

    Importante

    El asistente solo puede actualizar la base de datos en una instancia de servidor local.The wizard can only upgrade the database on a local server instance.

    Active la casilla para indicar que ha realizado la copia de seguridad de la base de datos SSISDB antes de ejecutar al asistente.Select the checkbox to indicate that you have backed up the SSISDB database before running the wizard.

    Selección del servidor en el Asistente para actualización de SSISDBSelect the server in the SSISDB Upgrade Wizard

  5. Seleccione Actualizar para actualizar la base de datos Catálogo de SSIS.Select Upgrade to upgrade the SSIS Catalog database.

  6. En la página Resultado , examine los resultados.On the Result page, review the results.

    Examen de resultados en el Asistente para actualización de SSISDBReview the results in the SSISDB Upgrade Wizard

AlwaysOn para el catálogo de SSIS (SSISDB)Always On for SSIS Catalog (SSISDB)

La característica Grupos de disponibilidad AlwaysOn es una solución de alta disponibilidad y de recuperación ante desastres que proporciona una alternativa empresarial a la creación de reflejo de la base de datos.The Always On Availability Groups feature is a high-availability and disaster-recovery solution that provides an enterprise-level alternative to database mirroring. Un grupo de disponibilidad admite un entorno de conmutación por error para un conjunto discreto de bases de datos de usuario, conocido como “bases de datos de disponibilidad”, que realizan la conmutación por error conjuntamente.An availability group supports a failover environment for a discrete set of user databases, known as availability databases, that fail over together. Para obtener más información, vea Grupos de disponibilidad AlwaysOn.For more information, see Always On Availability Groups.

Con el objetivo de ofrecer alta disponibilidad al catálogo de SSIS (SSISDB) y su contenido (proyectos, paquetes, registros de ejecución, etc.), puede agregar la base de datos SSISDB (al igual que cualquier otra base de datos de usuario) a un grupo de disponibilidad AlwaysOn.In order to provide the high-availability for the SSIS catalog (SSISDB) and its contents (projects, packages, execution logs, etc.), you can add the SSISDB database (just the same as any other user database) to an Always On Availability Group. Cuando se produce una conmutación por error, uno de los nodos secundarios se convierte automáticamente en el nuevo nodo principal.When a failover occurs, one of the secondary nodes automatically becomes the new primary node.

Importante

Cuando se produce una conmutación por error, los paquetes que se estuvieran ejecutando no se reinician o reanudan.When a failover occurs, packages that were running do not restart or resume.

Esta sección:In this section:

  1. Requisitos previosPrerequisites

  2. Configuración de la compatibilidad con SSIS para AlwaysOnConfigure SSIS support for Always On

  3. Actualización de SSISDB en un grupo de disponibilidadUpgrading SSISDB in an availability group

Requisitos previosPrerequisites

Lleve a cabo los siguientes pasos, que constituyen unos requisitos previos, antes de habilitar la compatibilidad de AlwaysOn para la base de datos SSISDB.Do the following prerequisite steps before enabling Always On support for the SSISDB database.

  1. Configure un clúster de conmutación por error de Windows.Set up a Windows failover cluster. Consulte la entrada de blog Installing the Failover Cluster Feature and Tools for Windows Server 2012 (Instalación de las herramientas y la característica de clúster de conmutación por error para Windows Server 2012) a fin de obtener instrucciones.See Installing the Failover Cluster Feature and Tools for Windows Server 2012 blog post for instructions. Instale la característica y las herramientas en todos los nodos del clúster.Install the feature and tools on all cluster nodes.

  2. Instale SQL Server 2016 con la característica Integration Services (SSIS) en cada nodo del clúster.Install SQL Server 2016 with Integration Services (SSIS) feature on each node of the cluster.

  3. Habilite los Grupos de disponibilidad AlwaysOn para cada instancia de SQL Server.Enable Always On Availability Groups for each SQL Server instance. Consulte Habilitar y deshabilitar grupos de disponibilidad AlwaysOn (SQL Server) para obtener más información.See Enable Always On Availability Groups for details.

Configuración de la compatibilidad con SSIS para AlwaysOnConfigure SSIS support for Always On

Importante

  • Debe realizar estos pasos en el nodo principal del grupo de disponibilidad.You must perform these steps on the primary node of the availability group.
  • Debe habilitar la compatibilidad con SSIS para AlwaysOn después de agregar SSISDB a un grupo de disponibilidad AlwaysOn.You must enable SSIS support for Always On after you add SSISDB to an Always On Availability Group.

Nota

Para más información sobre este procedimiento, vea el tutorial siguiente con capturas de pantalla adicionales de Marcos Freccia, MVP de Data Platform: Adding SSISDB to AG for SQL Server 2016 (Adición de SSISDB a grupos de disponibilidad para SQL Server 2016).For more info about this procedure, see the following walkthrough with additional screen shots by Data Platform MVP Marcos Freccia: Adding SSISDB to AG for SQL Server 2016.

Paso 1: Creación del catálogo de Integration ServicesStep 1: Create Integration Services Catalog

  1. Inicie SQL Server Management Studio y conéctese a una instancia de SQL Server en el clúster que quiere establecer como el nodo principal del grupo de alta disponibilidad AlwaysOn para SSISDB.Launch SQL Server Management Studio and connect to a SQL Server instance in the cluster that you want to set as the primary node of Always On high availability group for SSISDB.

  2. En el Explorador de objetos, expanda el nodo del servidor, haga clic con el botón derecho en el nodo Catálogos de Integration Services y, después, haga clic en Crear catálogo.In Object Explorer, expand the server node, right-click the Integration Services Catalogs node, and then click Create Catalog.

  3. Haga clic en Habilitar integración con CLR.Click Enable CLR Integration. El catálogo usar los procedimientos almacenados de CLR.The catalog uses CLR stored procedures.

  4. Haga clic en Habilitar la ejecución automática del procedimiento almacenado de Integration Services al iniciar SQL Server para permitir que el procedimiento almacenado catalog.startup se ejecute cada vez que se reinicie la instancia del servidor de SSIS.Click Enable automatic execution of Integration Services stored procedure at SQL Server startup to enable the catalog.startup stored procedure to run each time the SSIS server instance is restarted. El procedimiento almacenado realiza el mantenimiento del estado de las operaciones del catálogo de SSISDB.The stored procedure performs maintenance of the state of operations for the SSISDB catalog. Corrige el estado de los paquetes que estaban en ejecución si y cuando la instancia del servidor de SSIS se bloquea.It fixes the status of any packages there were running if and when the SSIS server instance goes down.

  5. Escriba una contraseñay haga clic en Aceptar.Enter a password, and then click Ok. La contraseña protege la clave maestra de la base de datos que se usar para cifrar los datos del catálogo.The password protects the database master key that is used for encrypting the catalog data. Guarde la contraseña en un lugar seguro.Save the password in a secure location. Se recomienda que haga también una copia de seguridad de la clave maestra de la base de datos.It is recommended that you also back up the database master key. Para más información, consulte Back Up a Database Master Key.For more information, see Back Up a Database Master Key.

Paso 2: Adición de SSISDB a un grupo de disponibilidad Always OnStep 2: Add SSISDB to an Always On Availability Group

Puede agregar la base de datos SSISDB a un grupo de disponibilidad AlwaysOn prácticamente con el mismo procedimiento que emplearía para agregar cualquier otra base de datos de usuario a un grupo de disponibilidad.Adding the SSISDB database to an Always On Availability Group is almost same as adding any other user database into an availability group. Consulte Usar el Asistente para grupo de disponibilidad (SQL Server Management Studio).See Use the Availability Group Wizard.

Escriba la contraseña que especificó al crear el catálogo de SSIS en la página Seleccionar bases de datos del asistente Nuevo grupo de disponibilidad.Provide the password that you specified while creating the SSIS Catalog in the Select Databases page of the New Availability Group wizard.

Asistente para nuevo grupo de disponibilidadNew Availability Group

Paso 3: Habilitación de la compatibilidad con SSIS para Always OnStep 3: Enable SSIS support for Always On

Después de crear el catálogo de Integration Services, haga clic con el botón derecho en el nodo Integration Service Catalogs (Catálogos de Integration Services) y haga clic en Enable AlwaysOn Support (Habilitar compatibilidad con AlwaysOn).After you create the Integration Service Catalog, right-click the Integration Service Catalogs node, and click Enable Always On Support. Verá el siguiente cuadro de diálogo: Habilitar compatibilidad con AlwaysOn .You should see the following Enable Support for Always On dialog box. Si este elemento de menú está deshabilitado, confirme que tiene todos los requisitos previos instalados y haga clic en Actualizar.If this menu item is disabled, confirm that you have all the prerequisites installed and click Refresh.

Habilitar compatibilidad con AlwaysOn

Advertencia

No se admite la conmutación por error automática de la base de datos SSISDB hasta que habilite la compatibilidad con SSIS para AlwaysOn.Auto-failover of SSISDB database is not supported until you enable SSIS Support for Always On.

Las réplicas secundarias recién agregadas desde el grupo de disponibilidad AlwaysOn se mostrarán en la tabla.The newly added secondary replicas from the Always On availability group are shown in the table. Haga clic en el botón Conectar... de cada réplica de la lista y escriba las credenciales de autenticación para conectarse a ella.Click Connect... button for each replica in the list and enter authentication credentials to connect to the replica. La cuenta de usuario debe ser miembro del grupo sysadmin en cada réplica para habilitar la compatibilidad con SSIS para AlwaysOn.The user account must be a member of sysadmin group on each replica to enable SSIS support for Always On. Después de conectarse correctamente a cada réplica, haga clic en Aceptar a fin de habilitar la compatibilidad con SSIS para AlwaysOn.After you successfully connect to each replica, click OK to enable SSIS support for Always On.

Si la opción Habilitar compatibilidad con AlwaysOn del menú contextual parece estar desactivada después de haber completado los requisitos previos, pruebe lo siguiente:If the Enable Always On support option on the context menu appears to be disabled after you've completed the other prerequisites, try these things:

  1. Actualice el menú contextual; para ello, haga clic en la opción Actualizar.Refresh the context menu by clicking the Refresh option.
  2. Asegúrese de que se está conectando al nodo principal.Make sure you are connecting to the primary node. Tiene que habilitar la compatibilidad con AlwaysOn en el nodo principal.You have to enable Always On support on the primary node.
  3. Asegúrese de que la versión de SQL Server es 13.0 o posterior.Make sure the SQL Server version is 13.0 or higher. SSIS solo admite AlwaysOn en SQL Server 2016 y versiones posteriores.SSIS supports Always On only on SQL Server 2016 and later versions.

Actualización de SSISDB en un grupo de disponibilidadUpgrading SSISDB in an availability group

Si va a actualizar SQL Server desde una versión anterior y SSISDB se encuentra en un grupo de disponibilidad AlwaysOn, la regla “Comprobación de SSISDB en grupo de disponibilidad AlwaysOn” podría bloquear la actualización.If you're upgrading SQL Server from a previous version, and SSISDB is in an Always On availability group, your upgrade may be blocked by the "SSISDB in Always On Availability Group check" rule. Este bloqueo se produce porque la actualización se ejecuta en modo de usuario único, mientras que una base de datos de disponibilidad debe ser multiusuario.This blocking occurs because upgrade runs in single-user mode, while an availability database must be a multi-user database. Por lo tanto, durante la actualización o la aplicación de una revisión, todas las bases de datos disponibilidad, incluida SSISDB, se desconectan y no se actualizan ni se les aplica la revisión.Therefore, during upgrade or patching, all availability databases including SSISDB are taken offline and are not upgraded or patched. Para permitir que la actualización continúe, quite SSISDB primero del grupo de disponibilidad; después, actualice cada nodo o aplíquele una revisión y, por último, vuelva a agregar SSISDB al grupo de disponibilidad.To let upgrade continue, first remove SSISDB from the availability group, then upgrade or patch each node, then add SSISDB back to the availability group.

Si la regla “Comprobación de SSISDB en grupo de disponibilidad AlwaysOn” está causando un bloqueo, siga estos pasos para actualizar SQL Server.If you are blocked by the "SSISDB in Always On Availability Group check" rule, follow these steps to upgrade SQL Server.

  1. Quite la base de datos SSISDB del grupo de disponibilidad.Remove the SSISDB database from the availability group. Para obtener más información, vea Quitar una base de datos secundaria de un grupo de disponibilidad (SQL Server) y Quitar una base de datos principal de un grupo de disponibilidad (SQL Server).For more info, see Remove a Secondary Database from an Availability Group (SQL Server) and Remove a Primary Database from an Availability Group (SQL Server).

  2. Haga clic en Volver a ejecutar en el Asistente para actualización.Click Rerun in the upgrade wizard. Se aplicará la regla “Comprobación de SSISDB en grupo de disponibilidad AlwaysOn”.The "SSISDB in Always On Availability Group check" rule passes.

  3. Haga clic en Siguiente para continuar con la actualización.Click the Next to continue the upgrade.

  4. Después de actualizar todos los nodos, vuelva a agregar la base de datos SSISDB al grupo de disponibilidad AlwaysOn.After you have upgraded all the nodes, add the SSISDB database back to the Always On availability group. Para obtener más información, vea Agregar una base de datos a un grupo de disponibilidad (SQL Server).For more info, see Add a Database to an Availability Group (SQL Server).

Si no se encuentra con un bloqueo al actualizar SQL Server y SSISDB está en un grupo de disponibilidad AlwaysOn, actualice SSISDB por separado tras actualizar el motor de base de datos de SQL Server.If you're not blocked when you upgrade SQL Server, and SSISDB is in an Always On availability group, upgrade SSISDB separately after you upgrade the SQL Server database engine. Use el Asistente para actualización de SQL Server Integration Services a fin de actualizar SSISDB como se describe en el siguiente procedimiento.Use the SSIS Upgrade Wizard to upgrade the SSISDB as described in the following procedure.

  1. Saque la base de datos SSISDB del grupo de disponibilidad o elimine el grupo de disponibilidad, si SSISDB es la única base de datos de este.Move the SSISDB database out of the availability group, or delete the availability group if SSISDB is the only database in the availability group. Inicie SQL Server Management Studio en el nodo principal del grupo de disponibilidad para realizar esta tarea.Launch SQL Server Management Studio on the primary node of the availability group to perform this task.

  2. Quite la base de datos SSISDB de todos los nodos de réplicas.Remove the SSISDB database from all replica nodes.

  3. Actualice la base de datos SSISDB en el nodo principal.Upgrade the SSISDB database on the primary node. En elExplorador de objetos de SQL Server Management Studio, expanda Catálogos de Integration Services, haga clic con el botón derecho en SSISDBy, después, seleccione Actualización de base de datos.InObject Explorer in SQL Server Management Studio, expand Integration Services Catalogs, right-click SSISDB, and then select Database Upgrade. Siga las instrucciones del Asistente para actualización de SSISDB a fin de actualizar la base de datos.Follow the instructions in the SSISDB Upgrade Wizard to upgrade the database. Inicie el Asistente para actualización de SSIDB localmente en el nodo primario.Launch the SSIDB Upgrade Wizard locally on the primary node.

  4. Siga las instrucciones de Paso 2: Adición de SSISDB a un grupo de disponibilidad Always On para volver a agregar SSISDB a un grupo de disponibilidad.Follow the instructions in Step 2: Add SSISDB to an Always On Availability Group to add the SSISDB back to an availability group.

  5. Siga las instrucciones de Paso 3: Habilitación de la compatibilidad con SSIS para Always On.Follow the instructions in Step 3: Enable SSIS support for Always On.

Contenido relacionadoRelated Content