Compartilhar via


catalog.cleanup_server_log

Aplica-se a: SQL Server SSIS Integration Runtime no Azure Data Factory

Aplica-se a: SQL Server

Limpa os logs de operação para levar o banco de dados SSISDB a um estado que permite a alteração do valor da propriedade SERVER_OPERATION_ENCRYPTION_LEVEL.

Sintaxe

catalog.cleanup_server_log  

Argumentos

Nenhum.

Valores do código de retorno

0 para êxito e 1 para falha.

Conjuntos de resultados

Nenhum.

Permissões

Este procedimento armazenado exige uma das seguintes permissões:

  • Permissões READ e EXECUTE no projeto e, se aplicável, permissões READ no ambiente referenciado.

  • Associação na função de banco de dados ssis_admin.

  • Associação à função de servidor sysadmin.

Erros e avisos

Esse procedimento armazenado gera erros nos seguintes cenários:

  • Há uma ou mais operações ativas no banco de dados SSISDB.

  • O banco de dados SSISDB não está no modo de usuário único.

Comentários

SQL Server 2012 Service Pack 2 adicionou a propriedade SERVER_OPERATION_ENCRYPTION_LEVEL à tabela internal.catalog_properties. Essa propriedade tem dois valores possíveis:

  • PER_EXECUTION (1) – O certificado e a chave simétrica usados para proteger parâmetros de execução e logs de execução confidenciais são criados para cada execução. Você pode ter problemas de desempenho (deadlocks, trabalhos de manutenção com falha, etc.) em um ambiente de produção porque chaves/certificado são gerados para cada execução. No entanto, essa configuração fornece um nível maior de segurança que o outro valor (2).

  • PER_PROJECT (2) – O certificado e a chave simétrica usados para proteger parâmetros confidenciais são criados para cada projeto. PER_PROJECT (2) é o valor padrão. Essa configuração oferece um desempenho melhor do que o nível PER_EXECUTION porque a chave e o certificado são gerados uma vez para um projeto em vez de serem gerados para cada execução.

Você precisa executar o procedimento armazenado catalog.cleanup_server_log antes de alterar o SERVER_OPERATION_ENCRYPTION_LEVEL de 2 para 1 ou de 1 para 2. Você precisa fazer o seguinte antes de executar este procedimento armazenado:

  1. Verifique se o valor da propriedade OPERATION_CLEANUP_ENABLED está definido como TRUE na tabela catalog.catalog_properties (Banco de dados SSISDB).

  2. Defina o SSISDB (banco de dados do Integration Services) para o modo de usuário único. No SQL Server Management Studio, inicie a caixa de diálogo Propriedades do Banco de Dados do SSISDB, mude para a guia Opções e defina a propriedade Restringir Acesso para o modo de usuário único (SINGLE_USER). Depois de executar o procedimento armazenado cleanup_server_log, defina o valor da propriedade para o valor original.

  3. Execute o procedimento armazenado catalog.cleanup_server_log.

  4. Agora, vá em frente e altere o valor da propriedade SERVER_OPERATION_ENCRYPTION_LEVEL na tabela catalog.catalog_properties (Banco de dados SSISDB).

  5. Execute o procedimento armazenado catalog.cleanup_server_execution_keys para limpar as chaves de certificado do banco de dados SSISDB. Descartar certificados e chaves de banco de dados SSISDB pode levar muito tempo, então isso deve ser executado periodicamente fora dos horários de pico.

    Você pode especificar o escopo ou o nível (execução versus projeto) e o número de chaves a serem excluídas. O tamanho de lote padrão para exclusão é 1000. Quando você define o nível para 2, as chaves e certificados serão excluídos somente se os projetos associados foram excluídos.

Para obter mais informações, consulte o seguinte artigo da Base de dados de Conhecimento: CORRIGIR: problemas de desempenho ao usar o SSISDB como seu repositório de implantação no SQL Server 2012

Exemplo

O exemplo a seguir chama o procedimento armazenado cleanup_server_log.

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