ALTER SERVER AUDIT (Transact-SQL)

使用 SQL Server Audit 功能更改服务器审核对象。有关详细信息,请参阅了解 SQL Server 审核

主题链接图标Transact-SQL 语法约定

语法

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

参数

  • TO { FILE | APPLICATION_LOG | SECURITY }
    确定审核目标的位置。可用的选项包括二进制文件、Windows 应用程序日志或 Windows 安全日志。

    注意注意

    在 Windows XP 上不可写入安全日志。

  • FILEPATH = 'os_file_path'
    审核记录的路径。文件名是基于审核名称和审核 GUID 生成的。

  • MAXSIZE **=**max_size
    指定审核文件可增大到的最大大小。max_size 值必须是后跟 MBGBTBUNLIMITED 的整数。为 max_size 指定的最小大小为 2 MB,最大大小为 2,147,483,647 TB。如果指定为 UNLIMITED,则文件将增长到磁盘变满为止。指定一个小于 2 MB 的值将引发错误 MSG_MAXSIZE_TOO_SMALL。默认值为 UNLIMITED

  • MAX_ROLLOVER_FILES **=**integer | UNLIMITED
    指定要保留在文件系统中的最大文件数。设置为 MAX_ROLLOVER_FILES=0 时,可创建的滚动更新文件的数量不受任何限制。默认值为 0。可以指定的最大文件数为 2,147,483,647。

  • RESERVE_DISK_SPACE = { ON | OFF }
    此选项会按 MAXSIZE 值为磁盘上的文件预先分配大小。仅在 MAXSIZE 不等于 UNLIMITED 时适用。默认值为 OFF。

  • QUEUE_DELAY **=**integer
    确定在强制处理审核操作之前可能经过的时间(以毫秒为单位)。值 0 指示同步传递。可设置的最小延迟值为 1000(1 秒),这是默认值。最大值为 2,147,483,647(2,147,483.647 秒或者 24 天 20 小时 31 分钟 23.647 秒)。指定无效数字将引发错误 MSG_INVALID_QUEUE_DELAY。

  • ON_FAILURE = { CONTINUE | SHUTDOWN }
    指示在目标无法执行写操作时写入目标的实例是应继续还是停止。发出此命令的登录名必须具有 SHUTDOWN 权限。如果登录名不具有此权限,则此函数将失败并出现 MSG_NO_SHUTDOWN_PERMISSION 消息。默认值为 CONTINUE。

  • STATE = { ON | OFF }
    启用或禁用审核收集记录。更改运行的审核的状态(从 ON 到 OFF)将创建审核停止时的审核项、停止审核的主体以及停止审核的时间。

  • MODIFY NAME = new_audit_name
    更改审核的名称。不能与任何其他选项一起使用。

注释

调用 ALTER AUDIT 时,必须指定至少一个 TO、WITH 或 MODIFY NAME 子句。

为了更改审核,必须将审核的状态设置为 OFF 选项。使用 STATE=OFF 以外的任何选项启用审核时,如果 ALTER AUDIT 正在运行,您将接收到 MSG_NEED_AUDIT_DISABLED 错误消息。

无需停止审核即可添加、更改和删除审核规范。

创建审核后无法更改审核的 GUID。

权限

若要创建、更改或删除服务器审核主体,必须具有 ALTER ANY SERVER AUDIT 或 CONTROL SERVER 权限。

示例

A. 更改服务器审核名称

下面的示例将服务器审核 HIPPA_Audit 的名称更改为 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. 更改服务器审核目标

下面的示例将名为 HIPPA_Audit 的服务器审核更改为以文件为目标。

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

更改历史记录

更新的内容

更正了“权限”部分。

将 UNLIMITED 选项添加到了 MAX_ROLLOVER_FILES。

请参阅

参考

概念