탐색 트리에서 [리소스] 노드를 확장합니다.
[리소스] 노드에서 JDBC 노드를 선택합니다.
JDBC 노드에서 [접속 풀] 노드를 선택합니다.
[접속 풀] 페이지가 열립니다.
[접속 풀] 페이지에서 편집할 풀의 이름을 누릅니다.
[접속 풀 편집] 페이지가 열립니다.
[접속 풀 편집] 페이지에서 [고급] 탭을 누릅니다.
[접속 풀 고급 속성 편집] 페이지가 열립니다.
[명령문 시간 초과] 필드에 비정상적으로 길게 실행되는 질의를 종료하기 전까지의 시간(초)을 입력합니다.
GlassFish Server에서는 명령문을 생성할 때 QueryTimeout
을 설정합니다. 이 옵션을 사용 안함으로 설정하려면 값을 -1로 설정합니다. 기본값은 -1입니다.
[명령문 캐시 크기] 필드에 LRU(가장 오래 전에 사용됨) 캐싱 방식을 사용하여 캐시할 명령문 수입니다.
명령문 캐싱을 사용 안함으로 설정하려면 값을 0으로 지정합니다. 기본값은 0입니다.
[초기 SQL 필드]에 풀에서 접속이 생성될 때마다(재사용되지 않음) 실행할 SQL 문자열을 입력합니다.
이 문자열이 실행되면 접속 상태가 초기화됩니다.
[SQL 추적 리스너] 필드에서 리스너 구현 클래스 이름의 콤마로 구분된 목록을 입력하여 응용 프로그램에서 실행된 SQL 명령문이 추적되도록 지정합니다.
리스너 클래스는 org.glassfish.api.jdbc.SQLTraceListener
인터페이스를 구현해야 합니다. 리스너를 사용하면 SQL 문에 대한 로그 메시지를 쉽게 필터링하고 관리자가 명령문을 분석하도록 할 수 있습니다.
[JDBC 객체 래핑 사용] 체크 박스를 선택하면 응용 프로그램에서 Statement
, PreparedStatement
, CallableStatement
, ResultSet
, DatabaseMetaData
에 대한 JDBC 객체가 래핑됩니다.
이 옵션은 기본적으로 사용으로 설정되어 있습니다.
풀에 대한 접속 풀링을 사용으로 설정하려면 [풀링] 체크 박스를 선택합니다.
이 옵션은 기본적으로 사용으로 설정되어 있습니다.
[최대 1회 검증 기간] 필드에서 접속이 최대 1회 검증되기까지의 시간(초)을 입력합니다.
이 속성을 적절한 값으로 설정하면 접속의 검증 요청 횟수가 최소화됩니다. 기본값은 0입니다. 값이 0이면 속성이 사용으로 설정되지 않습니다.
[접속 누수 시간 초과] 필드에서 접속 풀의 접속 누수를 추적할 시간(초)을 입력합니다.
이 필드를 사용하여 응용 프로그램에서 발생할 수 있는 잠재적인 접속 누수를 검색합니다. 지정된 기간 내에 접속이 응용 프로그램에 의해 풀로 되돌아가지 않으면 잠재적으로 누수되고 있다고 간주되어 호출자의 스택 추적이 로깅됩니다. 접속 누수 추적을 사용 안함으로 설정하려면 값을 0으로 설정합니다. 기본값은 0입니다.
이 필드를 접속 누수 재생과 함께 사용하면 응용 프로그램에서 잠재적인 접속 누수가 발생하는 것을 방지할 수 있습니다.
[접속 누수 재생] 체크 박스를 선택하면 누수 연결 추적이 완료된 후에 누수된 연결이 풀로 복원됩니다.
이 옵션은 기본적으로 사용 안함으로 설정되어 있습니다.
[명령문 누수 시간 초과] 필드에서 접속 풀의 명령문 누수를 추적할 시간(초)을 입력합니다.
이 필드에서는 응용 프로그램에서 발생할 수 있는 명령문 누수를 검색할 수 있습니다. 지정된 기간 내에 명령문이 응용 프로그램에 의해 풀로 되돌아가지 않으면 잠재적으로 누수되고 있다고 간주되어 호출자의 스택 추적이 로깅됩니다. 명령문 누수 추적을 사용 안함으로 설정하려면 값을 0으로 설정합니다. 기본값은 0입니다.
이 필드를 명령문 누수 재생과 함께 사용하면 응용 프로그램에서 잠재적인 명령문 누수가 발생하는 것을 방지할 수 있습니다.
[누수 재생] 체크 박스를 선택하면 누수 명령문 추적이 완료된 후에 누수된 명령문이 풀로 복원됩니다.
이 옵션은 기본적으로 사용 안함으로 설정되어 있습니다.
[생성 재시도 횟수] 필드에서 새 접속 생성에 실패할 경우 재시도할 횟수를 입력합니다.
접속 다시 생성하기 위한 횟수를 지정하지 않으려면 값을 0으로 설정합니다. 기본값은 0입니다.
[재시도 간격] 필드에서 접속을 생성하기 위한 두 시도 간의 간격(초)을 입력합니다.
기본값은 10입니다. 이 속성은 생성 재시도 횟수의 값이 0보다 큰 경우에만 사용됩니다.
접속이 사용될 때에만 물리적 접속을 논리 모음과 연관시키려면 [느린 연결 사용] 체크 박스를 선택합니다.
또한 트랜잭션이 완료되고 구성 요소 메소드가 종료되면 연관 해제되어 물리적 접속을 재사용할 수 있습니다. 이 옵션이 사용 안함으로 설정된 경우 물리적 접속은 사용되기 전이라도 논리적 접속과 연관됩니다. 이 옵션은 기본적으로 사용 안함으로 설정되어 있습니다.
실제로 메소드에서 사용될 경우에만 리소스를 트랜잭션에 등록하려면 [지연 접속 참여 사용] 체크 박스를 선택합니다.
이 옵션은 기본적으로 사용 안함으로 설정되어 있습니다.
접속과 스레드 간에 연관을 생성하려면 [스레드와 연결] 사용 체크 박스를 선택합니다.
다른 접속에 대해 동일한 스레드가 필요한 경우 해당 스레드와 이미 연관된 접속을 재사용할 수 있기 때문에 풀에서 다른 접속에 대한 오버헤드가 발생하지 않습니다. 이 옵션은 기본적으로 사용 안함으로 설정되어 있습니다.
풀에 대해 일치하는 접속을 사용으로 설정하려면 [접속 일치 사용] 체크 박스를 선택합니다.
이 옵션을 사용으로 설정하면 풀에서 선택하는 접속이 특정 인증서가 있는 접속과 일치해야 합니다. 이 옵션은 여러 개의 사용자 인증서가 있는 응용 프로그램에서 접속 풀이 사용되는 경우 사용으로 설정해야 합니다. 이 옵션은 풀의 접속이 항상 같은 종류이며 따라서 풀에서 선택된 접속을 리소스 어댑터와 일치시킬 필요가 없음을 관리자가 알고 있을 때 사용 안함으로 설정할 수 있습니다. 이 옵션은 기본적으로 사용 안함으로 설정되어 있습니다.
[최대 접속 사용 수] 필드에 풀에서 접속을 다시 사용할 횟수를 입력합니다.
접속을 지정된 횟수만큼 재사용한 다음에는 해당 접속이 닫힙니다. 접속이 재사용될 수 있는 횟수를 제한하여 응용 프로그램이 명령문을 종료하지 않은 경우 명령문 누수 발생을 방지할 수 있습니다. 이 속성을 사용 안함으로 설정하려면 값을 0으로 설정합니다. 기본값은 0입니다.
[접속 검증 필요] 체크 박스를 선택하여 접속 검증을 사용하도록 설정합니다.
실패하는 경우 서버에서 접속 검증을 사용하여 재접속할 수 있습니다.
[검증 방법] 드롭다운 목록에서 검증 방법을 선택합니다.
GlassFish Server에서 데이터베이스 접속을 검증하는 방법은 다음과 같습니다.
auto-commit
및 metadata
GlassFish Server에서는 con.getAutoCommit
및 con.getMetaData
메소드를 호출하여 접속을 검증합니다.
주:
많은 JDBC 드라이버에서 이러한 호출의 결과를 캐시합니다. 그러므로 이러한 호출을 사용하면 경우에 따라 신뢰할 수 없는 검증이 제공될 수 있습니다. 이러한 호출의 캐시 여부를 판단하려면 드라이버 공급업체에 확인합니다.custom-validation
GlassFish Server에서는 사용자 정의 구현 클래스에 의해 [검증 클래스 이름] 필드에 지정된 사용자 정의 검증 방식을 사용합니다.
table
응용 프로그램에서 지정된 데이터베이스 테이블을 질의합니다. 액세스할 수 있는 테이블이 있어야 하지만 행은 없어도 됩니다. 행이 많이 있는 기존 테이블이나 이미 자주 액세스하는 테이블은 사용하지 마십시오.
[검증 방법] 드롭다운 목록에서 table
을 선택한 경우 데이터베이스 테이블의 이름을 입력하거나 테이블 이름 드롭다운 목록에서 선택합니다.
[검증 방법] 드롭다운 목록에서 custom-validation
을 선택한 경우 사용자 정의 검증 구현 클래스 이름을 입력하거나 검증 클래스 이름 드롭다운 목록에서 선택합니다.
제공된 클래스 이름은 GlassFish Server에서 액세스할 수 있어야 합니다. 지정된 클래스는 org.glassfish.api.jdbc.ConnectionValidation
인터페이스를 구현해야 합니다.
[실패 시 모든 접속 닫기] 체크 박스를 선택하여 단일 접속이 실패할 경우 서버에서 풀의 모든 접속을 닫고 재설정하도록 합니다.
이 옵션이 사용 안함으로 설정된 경우 개별 접속이 사용되는 경우에만 다시 설정됩니다. 이 옵션은 기본적으로 사용 안함으로 설정되어 있습니다.
서블릿 필터 및 타사 지속성 관리자와 같이 구성 요소가 아닌 호출자가 풀을 사용할 수 있게 하려면 [구성 요소가 아닌 호출자 허용 사용] 체크 박스를 선택합니다.
구성 요소가 아닌 호출자가 얻은 접속은 트랜잭션이 종료될 때 컨테이너에 의해 자동으로 닫히지 않습니다. 이 연결은 호출자가 명시적으로 닫아야 합니다. 이 옵션은 기본적으로 사용 안함으로 설정되어 있습니다.
[일반] 탭의 [비우기] 단추를 눌러 풀에서 모든 접속을 비웁니다.
[비우기] 단추를 누르면 기존 접속이 모두 삭제되고, 풀에 대해 설정된 접속이 다시 생성되며, 풀이 초기 및 최소 풀 크기로 복원됩니다.
[저장]을 누릅니다.
팁:
기본 설정으로 돌아가려면 [기본값 로드] 단추를 누른 다음 [저장]을 누릅니다.