page no. 96404863
- 기능 설명
- 제품내 DB Connection Pool을 사용할 경우 Java파일을 생성하지 않도록 개선
- 제품내 DB Connection Pool을 사용할 경우 Java파일을 생성하지 않도록 개선
- 사용 방법
- Repository DB 커넥션 풀 설정 및 해지는 matrix.properties 파일에서
matrix.pooluse="true" 혹은 matrix.pooluse="false" 로 설정한 후에 WAS재기동을 해야한다. - 타겟DB 커넥션 풀 설정 및 해지는 Admin > 자원관리 > 데이터베이스관리에서
DB Pool 사용을 체크 해제 혹은 체크를 한 후 저장한다.
- Repository DB 커넥션 풀 설정 및 해지는 matrix.properties 파일에서
참고 사항
- Repository DB, 타겟 DB 모두 같은 커넥션 풀 옵션값을 사용한다.
단, DB최소 연결 수 DB최대 연결 수는 Admin에서 설정 가능하다.
커넥션 풀 사용 옵션은 Dbcp 1.4버젼 기반으로 한다.
Dbcp1.4 옵션명 옵션 설명 matrix.properties 설정방법 빈값일 경우 제품내 설정 기본값 비고 minIdle 풀에서 유지할 최소 유휴 연결 수 matrix.pool.minidle="숫자" 10 하위 호환성 값 10 maxIdle 풀에서 유지할 수 있는 최대 유휴 연결 수 matrix.pool.maxidle="숫자" 설정하지 않음 설정하지 않을 경우 dbcp에서는 8로 설정 maxActive 풀에서 허용되는 최대 활성 연결 수 matrix.pool.maxactive="숫자" 50 하위 호환성 값 50 maxWait 풀에서 연결을 가져오기 위해 대기할 최대 연결 시간 matrix.pool.maxwait="숫자" -1 하위 호환성 값이-1이며 무한정 대기한다. initialSize 풀을 초기화할 때 생성할 연결 수 설정 방법 없음 설정하지 않음 설정하지 않을 경우 dbcp에서는 0으로 설정 validationQuery 데이터베이스 연결이 유효한지 확인하기 위해 사용할 SQL 설정 방법 없음 (자동으로 쿼리 생성) 자동으로 쿼리 생성 testOnBorrow 데이터베이스 연결을 풀에서 빌릴때 유효성 검사를 할지 여부를 설정 matrix.pool.testonborrow="true" or "false" false 이 옵션은 확실한 커넥션을 보장하지만 DB부하를 주는 옵션이다. testWhileIdle 주기적으로 유휴 연결을 검사할지 여부 matrix.pool.testwhileidle="true" or "false" 설정하지 않음 설정하지 않을경우 dbcp에서는 false로 설정 timeBetweenEvictionRunsMillis 유휴 연결의 제거를 위한 검사 주기를 설정 matrix.pool.timebetweenevictionrunsmillis="숫자(밀리초)" 설정하지 않음 설정하지 않을경우 dbcp에서는 -1로 설정됨. minEvictableIdleTimeMillis 유휴 연결을 풀에서 제거하기 전에 허용되는 최소 유휴 시간을 설정 matrix.pool.minevictableidletimemillis="숫자(밀리초)" 설정하지 않음 설정하지 않을경우 dbcp에서는 30분(1800000)으로 설정됨. Db Connection Pool 생성시 커넥션 풀 생성이 Matrix.log 로그에 info레벨로 출력되며 설정정보가 포함되어있습니다.
주의 사항
matrix-service , maf , Admin 의존성 버젼을 맞춰야한다.
변경 전 변경 후 릴리즈 번호 1. WEB-INF\classes\matrix\pools\에 Java파일을 생성한다. 2. Db Connection Pool 사용시 "Connection(커넥션코드): Before: NumActive = 사용중 커넥션 갯수, NumIdle = 유후 커넥션 갯수" 로그가 Matrix.log에 출력된다. 예) Connection(DBF65901E94971452E89EE5A73EED50B79): Before: NumActive = 1, NumIdle = 2 1. WEB-INF\classes\matrix\pools\에 Java파일을 생성하지 않는다.
2. Db Connection Pool 사용시 "[AudDbPool][커넥션코드] Connection : Before: NumActive = 사용중 커넥션 갯수, NumIdle = 유후 커넥션 갯수" 로그가 Matrix.log에 출력된다.
예) [AudDbPool][DBF65901E94971452E89EE5A73EED50B79] Connection : Before: NumActive = 1, NumIdle = 2
3. DB Connection Pool 생성시 아래 로그가 생성된다.
4. DB Connection Pool 해제시 아래 로그가 생성된다.
5. DB Connection Pool에서 커넥션 유효성 검사시 Debug모드일경우 아래 로그가 생성된다.
유효성 검사 예시
1) matrix.pool.testonborrow="true"
- 커넥션 획득전에 유효성 쿼리 호출
2) matrix.pool.testwhileidle="true"
matrix.pool.timebetweenevictionrunsmillis="60000" #60 초마다 커넥션 검사
7.0.500.20240926
| 기능 정보 |
|
|
|
|
|
|
|
|---|---|---|---|---|---|---|---|
| 시작 버전 정보 |
의존성이 설정되어있어서 반드시 해당버젼 이상으로 맞춰야 한다. | ||||||
샘플 정보
- 샘플 URL :
- 샘플 파일