ALTER SERVER AUDIT (Transact-SQL)

Sintassi

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 } 
}

Argomenti

• TO { FILE | APPLICATION_LOG | SECURITY }
  Determina la posizione della destinazione del controllo. Le opzioni possibili sono un file binario, il registro applicazioni o il registro di sicurezza di Windows.

  Nota

  La scrittura nel registro di sicurezza non è disponibile in Windows XP.

• FILEPATH = 'os_file_path'
  Percorso dell'itinerario di controllo. Il nome del file viene generato in base al nome e al GUID del controllo.

• MAXSIZE **=**max_size
  Specifica le dimensioni massime consentite per il file di controllo. Il valore max_size deve essere un valore integer seguito da MB, GB, TB o UNLIMITED. Il valore minimo che è possibile specificare per max_size è 2 MB, mentre il valore massimo è 2.147.483.647 TB. Se si specifica UNLIMITED, le dimensioni del file possono aumentare fino a quando non si esaurisce lo spazio su disco. Se si specifica un valore minore di 2 MB, verrà generato l'errore MSG_MAXSIZE_TOO_SMALL. Il valore predefinito è UNLIMITED.

• MAX_ROLLOVER_FILES **=**integer | UNLIMITED
  Specifica il numero massimo di file da mantenere nel file system. Quando viene specificata l'impostazione MAX_ROLLOVER_FILES=0, non esiste alcun limite al numero di file di rollover che verranno creati. Il valore predefinito è 0. mentre il numero massimo di file che è possibile specificare è 2.147.483.647.

• RESERVE_DISK_SPACE = { ON | OFF }
  Questa opzione prealloca il file sul disco in base al valore MAXSIZE. Viene applicata solo se MAXSIZE non è uguale a UNLIMITED. Il valore predefinito è OFF.

• QUEUE_DELAY **=**integer
  Specifica la quantità di tempo in millisecondi che può trascorrere prima che venga forzata l'esecuzione delle azioni di controllo. Il valore 0 indica un recapito sincrono. Il valore minimo di ritardo di query che è possibile impostare è 1000 (1 secondo). Tale valore è quello predefinito. Il valore massimo è 2.147.483.647 (2.147.483,647 secondi o 24 giorni, 20 ore, 31 minuti e 23,647 secondi). Se si specifica un numero non valido, verrà generato l'errore MSG_INVALID_QUEUE_DELAY.

• ON_FAILURE = { CONTINUE | SHUTDOWN }
  Indica se l'istanza che scrive nella destinazione deve continuare oppure arrestarsi se la destinazione non può eseguire la scrittura. L'account di accesso che esegue questa operazione deve disporre dell'autorizzazione SHUTDOWN. In caso contrario questa funzione non verrà eseguita e verrà generato il messaggio di errore MSG_NO_SHUTDOWN_PERMISSION. Il valore predefinito è CONTINUE.

• STATE = { ON | OFF }
  Abilita o disabilita la raccolta dei record mediante il controllo. La modifica dello stato di un controllo in esecuzione (da ON a OFF) crea una voce che indica l'arresto del controllo, l'entità che ha arrestato il controllo e l'ora in cui si è verificata l'arresto.

• MODIFY NAME = new_audit_name
  Modifica il nome del controllo. Questa opzione non può essere utilizzata con altre opzioni.

Osservazioni

È necessario specificare almeno una delle clausole TO, WITH o MODIFY NAME quando si chiama ALTER AUDIT.

Per apportare modifiche a un controllo è necessario impostare lo stato del controllo sull'opzione OFF. Se ALTER AUDIT viene eseguita quando un controllo è abilitato con qualsiasi altra opzione diversa da STATE=OFF, verrà visualizzato il messaggio di errore MSG_NEED_AUDIT_DISABLED.

È possibile aggiungere, modificare e rimuovere specifiche del controllo senza arrestare il controllo stesso.

Non è possibile modificare il GUID di un controllo dopo che il controllo è stato creato.

Autorizzazioni

Per creare, modificare o eliminare un'entità del controllo del server, è necessario disporre dell'autorizzazione ALTER ANY SERVER AUDIT o CONTROL SERVER.

Esempi

A. Modifica del nome di un controllo del server

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. Modifica della destinazione di un controllo del server

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

Vedere anche

Riferimento

Concetti