Oracle SQL: the Essential Reference

AUDIT (Schema Objects)

AUDIT {object_option[,object_option ...] | ALL} ON {[schema.]objectname | DIRECTORY directory_name | DEFAULT} [BY SESSION [WHENEVER [NOT] SUCCESSFUL] [BY ACCESS [WHENEVER [NOT] SUCCESSFUL]

Sets up auditing for a specific schema object.

Keywords

object_option

Indicates that a particular operation will be audited. The following operations are valid: ALTER, AUDIT, COMMENT, DELETE, EXECUTE, GRANT, INDEX, INSERT, LOCK, RENAME, SELECT, and UPDATE. The keyword ALL specifies all the operations.

object_name

Specifies the name of the schema object to be audited.

DIRECTORY directory_name

Specifies the name of a directory to audit.

DEFAULT

Establishes the specified object option as the default for objects that have not yet been created.

BY SESSION

Causes Oracle to write a single record for all SQL statements of the same type issued in the same session.

BY ACCESS

Causes Oracle to write a single record for each audited statement.

WHENEVER SUCCESSFUL

Chooses auditing only for SQL statements that complete successfully.

WHENEVER NOT SUCCESSFUL

Chooses auditing only for SQL statements that fail or result in errors.

Examples

Audit for any UPDATE statement issued for scott's bonus table:

AUDIT UPDATE ON scott.bonus;

Audit for any unsuccessful operation on scott's emp table:

AUDIT ALL ON scott.emp WHENEVER NOT SUCCESSFUL;