Compartir a través de

catalog.cleanup_server_log

  • Artículo

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

Se aplica a:SQL Server

Limpia los registros de operaciones para poner la base de datos de SSISDB en un estado que permita cambiar el valor la propiedad SERVER_OPERATION_ENCRYPTION_LEVEL.

Sintaxis

catalog.cleanup_server_log

Argumentos

Ninguno.

Valores de código de retorno

0 si es correcto y 1 si es erróneo.

Conjuntos de resultados

Ninguno.

Permisos

Este procedimiento almacenado necesita uno de los permisos siguientes:

  • Permisos de lectura y ejecución en el proyecto y, si es aplicable, permisos de lectura en el entorno al que se hace referencia.

  • Pertenencia al rol de base de datos ssis_admin.

  • Pertenencia al rol del servidor de sysadmin

Errores y advertencias

Este procedimiento almacenado genera errores en los escenarios siguientes:

  • Hay una o más operaciones activas en la base de datos SSISDB.

  • La base de datos SSISDB no está en modo de usuario único.

Observaciones

SQL Server 2012 Service Pack 2 agregó la propiedad SERVER_OPERATION_ENCRYPTION_LEVEL a la tabla internal.catalog_properties. Esta propiedad tiene dos valores posibles:

  • PER_EXECUTION (1): el certificado y la clave simétrica que se usan para proteger los parámetros de ejecución confidenciales y los registros de ejecución se crean en cada ejecución. Es posible que se encuentre con problemas de rendimiento (interbloqueos, trabajos de mantenimiento con errores, etc.) en un entorno de producción, porque los certificados o las claves se generan en cada ejecución. Sin embargo, esta configuración proporciona un mayor nivel de seguridad que el otro valor (2).

  • PER_PROJECT (2): el certificado y la clave simétrica que se usan para proteger parámetros confidenciales se crean en cada proyecto. PER_PROJECT (2) es el valor predeterminado. Esta configuración le proporciona un rendimiento mayor que el que ofrece el nivel PER_EXECUTION, debido a que la clave y el certificado se generan una vez por proyecto, en lugar de crearse para cada ejecución.

Tendrá que ejecutar el procedimiento almacenado catalog.cleanup_server_log antes de poder cambiar SERVER_OPERATION_ENCRYPTION_LEVEL de 2 a 1 o de 1 a 2. Debe hacer lo siguiente antes de ejecutar este procedimiento almacenado:

  1. Asegúrese de que el valor de la propiedad OPERATION_CLEANUP_ENABLED esté establecido en TRUE en la tabla catalog.catalog_properties (base de datos de SSISDB).

  2. Establezca la base de datos de Integration Services (SSISDB) en modo de usuario único. En SQL Server Management Studio, inicie el cuadro de diálogo Propiedades de la base de datos para SSISDB, vaya a la pestaña Opciones y establezca la propiedad Restringir acceso en modo de usuario único (SINGLE_USER). Después de ejecutar el procedimiento almacenado cleanup_server_log, vuelva a establecer el valor de propiedad original.

  3. Ejecute el procedimiento almacenado catalog.cleanup_server_log.

  4. A continuación, cambia el valor de la propiedad SERVER_OPERATION_ENCRYPTION_LEVEL en la tabla catalog.catalog_properties (base de datos de SSISDB).

  5. Ejecute el procedimiento almacenado catalog.cleanup_server_execution_keys para borrar las claves de certificados de la base de datos SSISDB. Quitar certificados y claves de la base de datos SSISDB puede llevar bastante tiempo, por lo que debe realizar este proceso periódicamente durante horas de poca actividad.

    Puede especificar el ámbito o el nivel (ejecución o proyecto) y el número de claves que va a eliminar. El tamaño predeterminado del lote para la eliminación es 1000. Cuando el nivel se establece en 2, solo se eliminan las claves y certificados si se han eliminado los proyectos asociados.

Para obtener más información, consulte el artículo de Knowledge Base siguiente: FIX: Performance issues when you use SSISDB as your deployment store in SQL Server 2012 (Corrección: problemas de rendimiento al usar SSISDB como almacén de implementación en SQL Server 2012).

Ejemplo

En el ejemplo siguiente se llama al procedimiento almacenado cleanup_server_log.

USE [SSISDB]  
GO  
  
DECLARE@return_value int  
EXEC@return_value = [internal].[cleanup_server_log]  
SELECT'Return Value' = @return_value  
GO