ALTER SERVER AUDIT (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.

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

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

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

Histórico de alterações

Consulte também

Referência

Conceitos