DBMS_AUDIT_MGMT

DBMS_AUDIT_MGMT 패키지의 기본 개념과 패키지 내의 프로시저와 함수를 사용하는 방법을 설명합니다.

개요

DBMS_AUDIT_MGMT는 감사 추적(Audit Trail) 테이블의 관리와 감사 기록 정리, 주기적 정리 잡(Purge Job) 생성·변경·삭제를 위한 프러시저와 함수를 제공합니다.

상수

DBMS_AUDIT_MGMT에서는 프로시저·함수의 파라미터 등에 사용할 상수를 정의하고 있습니다.

• 감사 추적 유형

상수	값	타입	설명
AUDIT_TRAIL_AUD_STD	1	BINARY_INTEGER	표준 감사 추적(Standard audit trail)
AUDIT_TRAIL_FGA_STD	2	BINARY_INTEGER	FGA(세분화 감사) 표준 감사 추적
AUDIT_TRAIL_DB_STD	3	BINARY_INTEGER	표준·FGA 감사 추적을 함께 나타내는 값
AUDIT_TRAIL_OS	4	BINARY_INTEGER	OS 감사 추적
AUDIT_TRAIL_ALL	7	BINARY_INTEGER	표준·FGA·OS 감사 추적을 모두 포함하는 값

• 정리 잡 상태

상수	값	타입	설명
PURGE_JOB_DISABLE	1	BINARY_INTEGER	정리 잡 비활성화
PURGE_JOB_ENABLE	2	BINARY_INTEGER	정리 잡 활성화

프러시저와 함수

본 절에서는 DBMS_SYSTEM 패키지에서 제공하는 프러시저와 함수를 알파벳 순으로 설명합니다.

ALTER_PARTITION_INTERVAL

표준 감사 로그 또는 FGA 로그 파티션 테이블의 파티션 간격(INTERVAL)을 변경합니다.

ALTER_PARTITION_INTERVAL 프러시저의 세부 내용은 다음과 같습니다.

• 프로토타입

DBMS_AUDIT_MGMT.ALTER_PARTITION_INTERVAL (
   audit_trail_type      IN PLS_INTEGER,
   interval_number       IN BINARY_INTEGER,
   interval_frequency    IN VARCHAR2
);

• 파라미터

파라미터	설명
audit_trail_type	감사 추적 유형 AUDIT_TRAIL_AUD_STD 또는 AUDIT_TRAIL_FGA_STD만 가능합니다.
interval_number	간격의 수치
interval_frequency	간격의 단위(DAY, MONTH, YEAR)

• 예외 상황

예외 상황	설명
INVALID_ARGUMENT	audit_trail_type이 AUDIT_TRAIL_AUD_STD, AUDIT_TRAIL_FGA_STD가 아닌 경우 interval_frequency가 DAY, MONTH, YEAR 외의 값인 경우

• 예제

BEGIN
  DBMS_AUDIT_MGMT.ALTER_PARTITION_INTERVAL(
    audit_trail_type    => DBMS_AUDIT_MGMT.AUDIT_TRAIL_AUD_STD,
    interval_number     => 1,
    interval_frequency  => 'MONTH'
  );
END;
/

CLEAN_AUDIT_TRAIL

지정한 감사 추적 유형에 대해 감사 기록 정리(Purge)를 수행합니다.

CLEAN_AUDIT_TRAIL 프러시저의 세부 내용은 다음과 같습니다.

• 프로토타입

DBMS_AUDIT_MGMT.CLEAN_AUDIT_TRAIL (
   audit_trail_type         IN PLS_INTEGER,
   use_last_arch_timestamp  IN BOOLEAN DEFAULT TRUE
);

• 파라미터

파라미터	설명
audit_trail_type	정리 대상 감사 추적 유형
use_last_arch_timestamp	TRUE이면 마지막 아카이브 시각 이전에 기록된 감사 기록을 정리합니다.

• 예제

BEGIN
  DBMS_AUDIT_MGMT.CLEAN_AUDIT_TRAIL(
    audit_trail_type         => DBMS_AUDIT_MGMT.AUDIT_TRAIL_AUD_STD,
    use_last_arch_timestamp  => FALSE
  );
END;
/

CLEAR_LAST_ARCHIVE_TIMESTAMP

지정한 감사 추적 유형에 대한 마지막 아카이브 시각을 초기화합니다.

CLEAR_LAST_ARCHIVE_TIMESTAMP 프러시저의 세부 내용은 다음과 같습니다.

• 프로토타입

DBMS_AUDIT_MGMT.CLEAR_LAST_ARCHIVE_TIMESTAMP (
   audit_trail_type  IN PLS_INTEGER
);

• 파라미터

파라미터	설명
audit_trail_type	초기화할 감사 추적 유형 AUDIT_TRAIL_AUD_STD, AUDIT_TRAIL_FGA_STD, AUDIT_TRAIL_OS 등 개별 지정 가능 AUDIT_TRAIL_DB_STD, AUDIT_TRAIL_ALL 등 복수 유형 지정 가능

• 예제

BEGIN
  DBMS_AUDIT_MGMT.CLEAR_LAST_ARCHIVE_TIMESTAMP(
    audit_trail_type => DBMS_AUDIT_MGMT.AUDIT_TRAIL_AUD_STD
  );
END;
/

CREATE_PURGE_JOB

감사 추적을 주기적으로 정리하는 스케줄러 잡을 생성합니다. 동일한 감사 추적 유형에 대해 잡은 하나만 존재할 수 있습니다.

CREATE_PURGE_JOB 프러시저의 세부 내용은 다음과 같습니다.

• 프로토타입

DBMS_AUDIT_MGMT.CREATE_PURGE_JOB (
   audit_trail_type            IN PLS_INTEGER,
   audit_trail_purge_interval  IN PLS_INTEGER,
   audit_trail_purge_name      IN VARCHAR2,
   use_last_arch_timestamp     IN BOOLEAN DEFAULT TRUE
);

• 파라미터

파라미터	설명
audit_trail_type	정리 대상 감사 추적 유형
audit_trail_purge_interval	잡 반복 주기
audit_trail_purge_name	생성할 스케줄러 잡의 이름
use_last_arch_timestamp	잡이 호출하는 CLEAN_AUDIT_TRAIL에 전달할 use_last_arch_timestamp 값

• 예외 상황

예외 상황	설명
JOB_NAME_EXIST	audit_trail_purge_name과 동일한 이름의 잡이 이미 존재하는 경우
JOB_ALREADY_EXIST	동일한 audit_trail_type에 대한 정리 잡이 이미 존재하는 경우
INVALID_ARGUMENT	audit_trail_type이 AUDIT_TRAIL_AUD_STD, AUDIT_TRAIL_FGA_STD, AUDIT_TRAIL_DB_STD가 아닌 경우

• 예제

BEGIN
  DBMS_AUDIT_MGMT.CREATE_PURGE_JOB(
    audit_trail_type            => DBMS_AUDIT_MGMT.AUDIT_TRAIL_AUD_STD,
    audit_trail_purge_interval  => 24,
    audit_trail_purge_name      => 'AUD_PURGE_JOB',
    use_last_arch_timestamp     => TRUE
  );
END;
/

DROP_PURGE_JOB

CREATE_PURGE_JOB으로 생성한 정리 잡을 삭제합니다.

DROP_PURGE_JOB 프러시저의 세부 내용은 다음과 같습니다.

• 프로토타입

DBMS_AUDIT_MGMT.DROP_PURGE_JOB (
   audit_trail_purge_name  IN VARCHAR2
);

• 파라미터

파라미터	설명
audit_trail_purge_name	삭제할 잡의 이름

• 예외 상황

예외 상황	설명
JOB_NOT_EXIST	audit_trail_purge_name에 해당하는 잡이 존재하지 않는 경우

• 예제

BEGIN
  DBMS_AUDIT_MGMT.DROP_PURGE_JOB(
    audit_trail_purge_name => 'AUD_PURGE_JOB'
  );
END;
/

GET_LAST_ARCHIVE_TIMESTAMP

지정한 감사 추적 유형에 대해 현재 저장된 마지막 아카이브 시각을 반환합니다.

GET_LAST_ARCHIVE_TIMESTAMP 함수의 세부 내용은 다음과 같습니다.

• 프로토타입

DBMS_AUDIT_MGMT.GET_LAST_ARCHIVE_TIMESTAMP (
   audit_trail_type  IN PLS_INTEGER
) RETURN TIMESTAMP;

• 파라미터

파라미터	설명
audit_trail_type	조회할 감사 추적 유형

• 반환값

반환값	설명
TIMESTAMP	해당 감사유형의 마지막 아카이브 시각

• 예외 상황

예외 상황	설명
INVALID_ARGUMENT	해당 유형에 대한 마지막 아카이브 시각이 설정되어 있지 않은 경우

• 예제

set serveroutpu on;

BEGIN
  DBMS_AUDIT_MGMT.SET_LAST_ARCHIVE_TIMESTAMP(
    audit_trail_type   => DBMS_AUDIT_MGMT.AUDIT_TRAIL_AUD_STD,
    last_archive_time  => SYSTIMESTAMP - 30
  );
END;
/

DECLARE
  v_ts TIMESTAMP;
BEGIN
  v_ts := DBMS_AUDIT_MGMT.GET_LAST_ARCHIVE_TIMESTAMP(
            audit_trail_type => DBMS_AUDIT_MGMT.AUDIT_TRAIL_AUD_STD
          );
  DBMS_OUTPUT.PUT_LINE('Last archive timestamp: ' || v_ts);
END;
/

SET_AUDIT_TRAIL_LOCATION

감사 테이블이 저장되는 테이블스페이스를 변경합니다.

SET_AUDIT_TRAIL_LOCATION 프로시저의 세부 내용은 다음과 같습니다.

• 프로토타입

DBMS_AUDIT_MGMT.SET_AUDIT_TRAIL_LOCATION (
   audit_trail_type            IN PLS_INTEGER,
   audit_trail_location_value  IN VARCHAR2
);

• 파라미터

파라미터	설명
audit_trail_type	대상 감사 추적 유형
audit_trail_location_value	변경할 테이블스페이스 이름

• 예외 상황

예외 상황	설명
INVALID_ARGUMENT	audit_trail_type 또는 테이블스페이스의 이름이 유효하지 않은 경우

• 예제

create tablespace audit_tbs;

BEGIN
  DBMS_AUDIT_MGMT.SET_AUDIT_TRAIL_LOCATION(
    audit_trail_type            => DBMS_AUDIT_MGMT.AUDIT_TRAIL_AUD_STD,
    audit_trail_location_value  => 'AUDIT_TBS'
  );
END;
/

SET_LAST_ARCHIVE_TIMESTAMP

감사 테이블 정리 시 삭제하지 않고 남겨 둘 마지막 아카이브 시각을 지정하는 프로시저입니다.

SET_LAST_ARCHIVE_TIMESTAMP 프로시저의 세부 내용은 다음과 같습니다.

• 프로토타입

DBMS_AUDIT_MGMT.SET_LAST_ARCHIVE_TIMESTAMP (
   audit_trail_type   IN PLS_INTEGER,
   last_archive_time  IN TIMESTAMP
);

• 파라미터

파라미터	설명
audit_trail_type	대상 감사 추적 유형
last_archive_time	감사 기록을 남겨 둘 마지막 아카이브 시각

• 예외 상황

예외 상황	설명
INVALID_ARGUMENT	audit_trail_type이 유효하지 않은 경우

• 예제

BEGIN
  DBMS_AUDIT_MGMT.SET_LAST_ARCHIVE_TIMESTAMP(
    audit_trail_type   => DBMS_AUDIT_MGMT.AUDIT_TRAIL_AUD_STD,
    last_archive_time  => SYSTIMESTAMP - 30
  );
END;
/

SET_PURGE_JOB_INTERVAL

CREATE_PURGE_JOB으로 생성한 잡의 수행 주기를 변경하는 프로시저입니다.

SET_PURGE_JOB_INTERVAL 프로시저의 세부 내용은 다음과 같습니다.

• 프로토타입

DBMS_AUDIT_MGMT.SET_PURGE_JOB_INTERVAL (
   audit_trail_purge_name      IN VARCHAR2,
   audit_trail_interval_value  IN PLS_INTEGER
);

• 파라미터

파라미터	설명
audit_trail_purge_name	대상 잡 이름
audit_trail_interval_value	새로운 반복 주기

• 예외 상황

예외 상황	설명
JOB_NOT_EXIST	audit_trail_purge_name에 해당하는 잡이 존재하지 않는 경우

• 예제

BEGIN
  DBMS_AUDIT_MGMT.CREATE_PURGE_JOB(
    audit_trail_type            => DBMS_AUDIT_MGMT.AUDIT_TRAIL_AUD_STD,
    audit_trail_purge_interval  => 24,
    audit_trail_purge_name      => 'AUD_PURGE_JOB',
    use_last_arch_timestamp     => TRUE
  );
END;
/

BEGIN
  DBMS_AUDIT_MGMT.SET_PURGE_JOB_INTERVAL(
    audit_trail_purge_name      => 'AUD_PURGE_JOB',
    audit_trail_interval_value  => 12
  );
END;
/

SET_PURGE_JOB_STATUS

CREATE_PURGE_JOB으로 생성한 정리 잡을 활성화 또는 비활성화합니다.

SET_PURGE_JOB_STATUS 프로시저의 세부 내용은 다음과 같습니다.

• 프로토타입

DBMS_AUDIT_MGMT.SET_PURGE_JOB_STATUS (
   audit_trail_purge_name     IN VARCHAR2,
   audit_trail_status_value   IN PLS_INTEGER
);

• 파라미터

파라미터	설명
audit_trail_purge_name	대상 잡 이름
audit_trail_status_value	PURGE_JOB_ENABLE: 잡을 활성화합니다. PURGE_JOB_DISABLE: 잡을 비활성화합니다.

• 예외 상황

예외 상황	설명
JOB_NOT_EXIST	audit_trail_purge_name에 해당하는 잡이 존재하지 않는 경우
INVALID_ARGUMENT	audit_trail_status_value가 유효하지 않은 경우

• 예제

BEGIN
  DBMS_AUDIT_MGMT.SET_PURGE_JOB_STATUS(
    audit_trail_purge_name     => 'AUD_PURGE_JOB',
    audit_trail_status_value   => DBMS_AUDIT_MGMT.PURGE_JOB_DISABLE
  );
END;
/