Artigo
04/01/2012

ALTER SERVER AUDIT (Transact-SQL)

Altera um objeto de auditoria de servidor usando o recurso de Auditoria do SQL Server. Para obter mais informações, consulte Compreendendo a auditoria do SQL Server.

Ícone de vínculo de tópico Convenções de sintaxe Transact-SQL

Sintaxe

ALTER SERVER AUDIT audit_name
{ 
    [ TO { { FILE ( <file_options> [, ...n] ) } | APPLICATION_LOG | SECURITY_LOG } ]
    [ WITH ( <audit_options> [, ...n] ) ] 
}
| MODIFY NAME = new_audit_name
[ ; ]
<file_options>::=
{
      FILEPATH = 'os_file_path' 
    | MAXSIZE = { max_size { MB | GB | TB } | UNLIMITED } 
    | MAX_ROLLOVER_FILES = { integer | UNLIMITED } 
    | RESERVE_DISK_SPACE = { ON | OFF } 
}
<audit_options>::=
{
      QUEUE_DELAY =integer 
    | ON_FAILURE = { CONTINUE | SHUTDOWN } 
    | STATE = = { ON | OFF } 
}

Argumentos

TO { FILE | APPLICATION_LOG | SECURITY }
Determina o local do destino da auditoria. As opções são um arquivo binário, o log de aplicativos do Windows ou o log de segurança do Windows.

Observação

A gravação no log de segurança não está disponível no Windows XP.
FILEPATH = 'os_file_path'
O caminho da trilha de auditoria. O nome de arquivo é gerado com base no nome de auditoria e no GUID de auditoria.
MAXSIZE **=**max_size
Especifica o tamanho máximo até o qual o arquivo de auditoria pode crescer. O valor max_size deve ser um inteiro seguido por MB, GB, TB ou UNLIMITED. O tamanho mínimo que você pode especificar para max_size é 2 MB e o máximo é 2.147.483.647 TB. Quando UNLIMITED é especificado, o arquivo aumenta até que o disco esteja cheio. A especificação de um valor inferior a 2 MB gera o erro MSG_MAXSIZE_TOO_SMALL. O valor padrão é UNLIMITED.
MAX_ROLLOVER_FILES **=**integer | UNLIMITED
Especifica o número máximo de arquivos a serem retidos no sistema de arquivos. Ao configurar MAX_ROLLOVER_FILES=0 não há nenhum limite imposto sobre o número de arquivos de substituição a serem criados. O valor padrão é 0. O número máximo de arquivos que pode ser especificado é 2.147.483.647.
RESERVE_DISK_SPACE = { ON | OFF }
Essa opção pré-aloca o arquivo no disco para o valor MAXSIZE. Só será aplicável se MAXSIZE não for igual a UNLIMITED. O valor padrão é OFF.
QUEUE_DELAY **=**integer
Determina a hora, em milissegundos, que pode decorrer antes que o processamento das ações de auditoria seja forçado. Um valor 0 indica entrega síncrona. O valor mínimo de atraso de consulta configurável é 1000 (1 segundo), que é o padrão. O máximo é 2.147.483.647 (2.147.483.647 segundos ou 24 dias, 20 horas, 31 minutos, 23.647 segundos). A especificação de um número inválido gera o erro MSG_INVALID_QUEUE_DELAY.
ON_FAILURE = { CONTINUE | SHUTDOWN }
Indica se a instância que grava no destino deverá continuar ou parar, se o destino não puder executar a gravação. O logon que emite isso deve ter a permissão SHUTDOWN. Se o logon não tiver essa permissão, essa função falhará com uma mensagem MSG_NO_SHUTDOWN_PERMISSION. O valor padrão é CONTINUE.
STATE = { ON | OFF }
Permite ou não permite que a auditoria colete registros. A alteração do estado de uma auditoria em execução (de ON para OFF) cria uma entrada de auditoria indicando que a auditoria foi interrompida, a entidade que interrompeu a auditoria e a hora da interrupção.
MODIFY NAME = new_audit_name
Altera o nome da auditoria. Não pode ser usado com qualquer outra opção.

Observação
A gravação no log de segurança não está disponível no Windows XP.

Comentários

Você deve especificar pelo menos uma das cláusulas TO, WITH ou MODIFY NAME, ao chamar ALTER AUDIT.

Você deve definir o estado de uma auditoria para a opção OFF para fazer alterações em uma auditoria. Se ALTER AUDIT for executada quando uma auditoria estiver habilitada com qualquer opção diferente de STATE=OFF, você receberá uma mensagem de erro MSG_NEED_AUDIT_DISABLED.

Você pode adicionar, alterar e remover especificações de auditoria sem interromper uma auditoria.

Não é possível alterar o GUID de uma auditoria após a criação da auditoria.

Permissões

Para criar, alterar ou descartar uma entidade de auditoria de servidor, você deve ter a permissão ALTER ANY SERVER AUDIT ou CONTROL SERVER.

Exemplos

A. Alterando o nome de uma auditoria de servidor

O exemplo a seguir altera o nome da auditoria de servidor HIPPA_Audit para HIPAA_Audit_Old.

USE master
GO
ALTER SERVER AUDIT HIPAA_Audit
WITH (STATE = OFF);
GO
ALTER SERVER AUDIT HIPAA_Audit
MODIFY NAME = HIPAA_Audit_Old;
GO
ALTER SERVER AUDIT HIPAA_Audit_Old
WITH (STATE = ON);
GO

B. Alterando o destino de uma auditoria de servidor

O exemplo a seguir altera a auditoria de servidor denominada HIPPA_Audit para um destino de arquivo.

USE master
GO
ALTER SERVER AUDIT HIPAA_Audit
WITH (STATE = OFF);
GO
ALTER SERVER AUDIT HIPAA_Audit
TO FILE (FILEPATH ='\\SQLPROD_1\Audit\',
          MAXSIZE = 1000 MB,
          RESERVE_DISK_SPACE=OFF)
WITH (QUEUE_DELAY = 1000,
       ON_FAILURE = CONTINUE);
GO
ALTER SERVER AUDIT HIPAA_Audit
WITH (STATE = ON);
GO