DBMS APPLICATION INFO
DBMS_APPLICATION_INFO#
DBMS_APPLICATION_INFO 패키지는 V$SESSION 성능 뷰의 값들을 설정하거나 가져와서, 애플리케이션의 성능을 추적 및 관리한다.
DBMS_APPLICATION_INFO 패키지를 구성하는 프로시저와 함수는 아래의 표와 같이 제공한다.
| 프로시저 및 함수 | 설명 |
|---|---|
| READ_CLIENT_INFO | V$SESSION에 설정된 모듈과 액션 값을 가져온다. |
| READ_MODULE | V$SESSION에 설정된 모듈과 액션 값을 가져온다. |
| SET_ACTION | V$SESSION의 ACTION 값을 설정한다. |
| SET_CLIENT_INFO | V$SESSION의 CLIENT_INFO 값을 설정한다. |
| SET_MODULE | V$SESSION의 MODULE 및 ACTION 값을 설정한다. |
READ_CLIENT_INFO#
현재 세션에 접속한 클라이언트의 애플리케이션 정보를 가져온다.
구문#
DBMS_APPLICATION_INFO.READ_CLIENT_INFO(client_info OUT VARCHAR(128));
파라미터#
| 이름 | 입출력 | 데이터 타입 | 설명 |
|---|---|---|---|
| client_info | OUT | VARCHAR(128) | 설정된 클라이언트의 애플리케이션 정보 |
결과값#
커서를 실행하여 처리된 레코드의 개수를 반환한다.
예외#
예외를 발생시키지 않는다.
예제#
현재 세션에서 수행중인 클라이언트의 정보 값을 가져와 출력한다.
iSQL> var v1 varchar(128);
iSQL> EXEC DBMS_APPLICATION_INFO.READ_CLIENT_INFO(:v1);
iSQL> EXEC PRINTLN(:v1);
READ_MODULE#
V$SESSION 성능 뷰에 설정된 MODULE 및 ACTION의 값을 가져온다.
구문#
DBMS_APPLICATION_INFO.READ_MODULE(module_name OUT VARCHAR(128), action_name OUT VARCHAR(128));
파라미터#
| 이름 | 입출력 | 데이터 타입 | 설명 |
|---|---|---|---|
| module_name | OUT | VARCHAR(128) | 설정된 모듈의 값 |
| action_name | OUT | VARCHAR(128) | 설정된 액션의 값 |
결과값#
저장 프로시저이므로 결과값을 반환하지 않는다.
예외#
예외를 발생시키지 않는다.
예제#
수행중인 프로시저의 모듈명과 액션 값을 가져와 출력한다.
iSQL> var v1 varchar(128);
iSQL> var v2 varchar(128)
iSQL> EXEC DBMS_APPLICATION_INFO.READ_MODEUL(:v1, :v2);
iSQL> EXEC PRINTLN(:v1);
iSQL> EXEC PRINTLN(:v2);
SET_ACTION#
V$SESSION 성능 뷰에 있는 ACTION 칼럼의 값을 설정하는 프로시저이다.
구문#
DBMS_APPLICATION_INFO.SET_ACTION (action_name VARCHAR(128));
파라미터#
| 이름 | 입출력 | 데이터 타입 | 설명 |
|---|---|---|---|
| action_name | IN | VARCHAR(128) | 설정할 ACTION 칼럼의 값 |
결과값#
저장 프로시저이므로 결과값을 반환하지 않는다.
예외#
예외를 발생시키지 않는다.
예제#
수행중인 프로시저의 동작 상태를 stop으로 변경한다.
iSQL> EXEC DBMS_APPLICATION_INFO.SET_ACTION( 'stop');
SET_CLIENT_INFO#
V$SESSION 성능 뷰에 접속된 클라이언트의 정보를 설정한다.
구문#
DBMS_APPLICATION_INFO.SET_CLIENT_INFO(client_info VARCHAR(128));
파라미터#
| 이름 | 입출력 | 데이터 타입 | 설명 |
|---|---|---|---|
| client_info | IN | VARCHAR(128) | 클라이언트의 애플리케이션 정보 |
결과값#
저장 프로시저이므로 결과값을 반환하지 않는다.
예외#
예외를 발생시키지 않는다.
예제#
클라이언트 정보를 test_application으로 설정한다.
iSQL> EXEC DBMS_APPLICATION_INFO.SET_CLIENT_INFO('test_application');
SET_MODULE#
V$SESSION 성능 뷰의 MODULE 및 ACTION 칼럼의 값을 설정하는 프로시저이다.
구문#
DBMS_APPLICATION_INFO.SET_MODULE(module_name VARCHAR(128), action_name
VARCHAR(128));
파라미터#
| 이름 | 입출력 | 데이터 타입 | 설명 |
|---|---|---|---|
| module_name | IN | VARCHAR(128) | 설정할 모듈의 값 |
| action_name | IN | VARCHAR(128) | 설정할 액션의 값 |
결과값#
저장 프로시저이므로 결과값을 반환하지 않는다.
예외#
예외를 발생시키지 않는다.
예제#
수행중인 프로시저의 모듈명을 altibase_module로 동작 상태를 running으로 변경한다.
iSQL> EXEC DBMS_APPLICATION_INFO.SET_MODULE('altibase_module', 'running');