A.17. 데이터 소스 매개변수

allocation-retry

Non-XA, XA

예외를 throw하기 전에 연결 할당을 시도해야 하는 횟수입니다. 기본값은 0 이므로 첫 번째 실패 시 예외가 발생합니다.

allocation-retry-wait-millis

Non-XA, XA

연결을 할당하기 위해 재시도할 때까지 대기하는 시간(밀리초)입니다. 기본값은 5000 ms입니다.

allow-multiple-users

Non-XA, XA

getConnection(user, password) 메서드를 통해 여러 사용자가 데이터 소스에 액세스했는지 여부와 내부 풀 유형이 이 동작에 대한 계정인지 여부입니다.

background-validation

Non-XA, XA

사용하기 전에 유효성을 검사하는 대신 백그라운드 스레드에서 연결을 검증해야 하는지 여부입니다. 배경 검증은 일반적으로 validate-on-match 와 함께 사용되지 않거나 중복 검사를 수행합니다. 백그라운드 유효성 검사를 사용하면 유효성 검사 시간이 잘못되고 클라이언트에 전달될 수 있으므로 애플리케이션에서 이러한 가능성을 고려해야 합니다.

background-validation-millis

Non-XA, XA

백그라운드 유효성 검사가 실행되는 빈도(밀리초)입니다.

blocking-timeout-wait-millis

Non-XA, XA

예외를 throw하기 전에 연결을 기다리는 동안 차단할 최대 시간(밀리초)입니다. 이 블록은 연결을 잠그는 동안에만 차단되며 새 연결을 만드는 데 시간이 오래 걸리는 경우 예외가 발생하지 않습니다.

capacity-decrementer-class

Non-XA, XA

풀에서 연결 감소를 위한 정책을 정의하는 클래스입니다.

capacity-decrementer-properties

Non-XA, XA

풀에서 연결 감소를 위한 정책을 정의하는 클래스에 삽입할 속성입니다.

capacity-incrementer-class

Non-XA, XA

풀에서 연결을 늘리기 위한 정책을 정의하는 클래스입니다.

capacity-incrementer-properties

Non-XA, XA

풀에서 연결을 늘리기 위한 정책을 정의하는 클래스에 삽입할 속성입니다.

check-valid-connection-sql

Non-XA, XA

풀 연결의 유효성을 확인하는 SQL 문입니다. 이 작업은 풀에서 관리되는 연결을 가져올 때 호출할 수 있습니다.

connectable

Non-XA, XA

CMR 사용을 활성화합니다. 즉, 로컬 리소스가 XA 트랜잭션에 안정적으로 참여할 수 있습니다.

connection-listener-class

Non-XA, XA

org.jboss.jca.adapters.jdbc.spi.listener.ConnectionListener 를 확장하는 클래스 이름을 지정합니다. 이 클래스는 연결 활성화 및 비활성화를 수신하여 연결이 애플리케이션 또는 풀로 반환되기 전에 작업을 수행합니다. 지정된 클래스는 두 개의 리소스 수준(코어 모듈로 JDBC 드라이버 설치) 또는 별도의 글로벌 모듈(Global 모듈 정의)을 사용하여 한 모듈에서 JDBC 드라이버와 함께 번들링해야 합니다.

connection-listener-property

Non-XA, XA

connection-listener-class 에 지정된 클래스에 삽입할 속성입니다. 삽입된 속성은 JavaBeans 규칙을 준수합니다. 예를 들어 foo 라는 속성을 지정하는 경우 연결 리스너 클래스에 String 을 인수로 수락하는 메서드 setFoo 가 있어야 합니다.

connection-properties

비 XA 전용

Driver.connect(url, props) 메서드에 전달할 임의의 문자열 이름/값 쌍 연결 속성입니다.

connection-url

비 XA 전용

JDBC 드라이버 연결 URL입니다.

datasource-class

비 XA 전용

JDBC 데이터 소스 클래스의 정규화된 이름입니다.

driver-class

비 XA 전용

JDBC 드라이버 클래스의 정규화된 이름입니다.

driver-name

Non-XA, XA

데이터 소스에서 사용해야 하는 JDBC 드라이버를 정의합니다. 설치된 드라이버의 이름과 일치하는 심볼릭 이름입니다. 드라이버가 JAR로 배포된 경우 이름은 배포 이름입니다.

enabled

Non-XA, XA

데이터 소스를 활성화해야 하는지 여부입니다.

enlistment-trace

Non-XA, XA

추적을 기록해야 하는지 여부입니다.

exception-sorter-class-name

Non-XA, XA

예외가 오류를 브로드캐스트해야 하는지 검증하는 방법을 제공하는 org.jboss.jca.adapters.jdbc.ExceptionSorter 의 인스턴스입니다.

exception-sorter-properties

Non-XA, XA

예외 분류기 속성입니다.

flush-strategy

Non-XA, XA

오류 발생 시 풀을 플러시하는 방법을 지정합니다. 유효한 값은 다음과 같습니다.

idle-timeout-minutes

Non-XA, XA

최대 시간(분)은 닫히기 전에 유휴 상태일 수 있습니다. 지정하지 않으면 기본값은 30 분입니다. 실제 최대 시간은 모든 풀의 가장 작은 idle-timeout-minutes 값의 절반인 IdleRemover 검사 시간에 따라 달라집니다.

initial-pool-size

Non-XA, XA

풀이 유지해야 하는 초기 연결 수입니다.

interleaving

XA만 해당

XA 연결에 대해 인터리브를 활성화할지 여부입니다.

JNDI-name

Non-XA, XA

데이터 소스에 대한 고유한 JNDI 이름입니다.

jta

비 XA 전용

JTA 통합을 활성화합니다.

max-pool-size

Non-XA, XA

풀에서 보유할 수 있는 최대 연결 수입니다.

mcp

Non-XA, XA

ManagedConnectionPool 구현 예를 들어 org.jboss.jca.core.connectionmanager.pool.mcp.SemaphoreArrayListManagedConnectionPool

min-pool-size

Non-XA, XA

풀에 보유할 수 있는 최소 연결 수입니다.

new-connection-sql

Non-XA, XA

연결 풀에 연결을 추가할 때마다 실행할 SQL 문입니다.

복구되지 않음

XA만 해당

연결 풀을 복구에서 제외해야 하는지 여부입니다.

no-tx-separate-pool

XA만 해당

각 컨텍스트에 대해 별도의 하위 풀을 생성할지 여부입니다. 이는 JTA 트랜잭션 내부 및 외부의 XA 연결을 허용하지 않을 수 있는 일부 Oracle 데이터 소스에 필요할 수 있습니다. 이 옵션을 사용하면 두 개의 실제 풀이 생성되므로 총 풀 크기가 max-pool-size 의 두 배가 됩니다.

Pad-xid

XA만 해당

Xid를 패딩할 수 있습니다.

암호

Non-XA, XA

새 연결을 만들 때 사용할 암호입니다.

pool-fair

Non-XA, XA

풀이 공정해야 하는지 여부를 정의합니다. 이 설정은 JCA의 연결 풀을 관리하는 데 사용되는 Semaphore 클래스의 일부이며, 이는 연결 중단 순서가 필요하지 않은 일부 사용 사례에서 성능 이점을 제공합니다.

pool-prefill

Non-XA, XA

풀을 미리 채워야 하는지 여부입니다.

pool-use-strict-min

Non-XA, XA

min-pool-size 를 엄격하게 고려해야 하는지 여부입니다.

prepared-statements-cache-size

Non-XA, XA

LRU(LRU) 캐시의 연결당 준비된 문 수입니다.

query-timeout

Non-XA, XA

쿼리 제한 시간(초)입니다. 기본값은 시간 초과입니다.

reauth-plugin-class-name

Non-XA, XA

물리적 연결을 재인증하기 위한 재인증 플러그인 구현의 정규화된 클래스 이름입니다.

reauth-plugin-properties

Non-XA, XA

reauthentication 플러그인의 속성입니다.

recovery-password

XA만 해당

복구를 위해 리소스에 연결하는 데 사용할 암호입니다.

recovery-plugin-class-name

XA만 해당

복구 플러그인 구현의 정규화된 클래스 이름입니다.

recovery-plugin-properties

XA만 해당

복구 플러그인의 속성입니다.

recovery-security-domain

XA만 해당

복구를 위해 리소스에 연결하는 데 사용할 보안 도메인입니다.

recovery-username

XA만 해당

복구를 위해 리소스에 연결하는 데 사용할 사용자 이름입니다.

same-rm-override

XA만 해당

javax. Cryostat.xa.XAResource.isSameRM(XAResource) 클래스가 true 또는 false 를 반환하는지 여부입니다.

security-domain

Non-XA, XA

인증을 처리하는 JAAS security-manager의 이름입니다. 이 이름은 JAAS 로그인 구성의 application-policy/name 속성과 관련이 있습니다.

set-tx-query-timeout

Non-XA, XA

트랜잭션 시간 초과까지 남은 시간에 따라 쿼리 시간 초과를 설정할지 여부입니다. 트랜잭션이 없는 경우 구성된 쿼리 시간 초과가 사용됩니다.

share-prepared-statements

Non-XA, XA

JBoss EAP가 애플리케이션에 제공된 래퍼가 애플리케이션 코드로 닫힐 때 기본 물리 명령 대신 캐시해야 하는지 여부입니다. 기본값은 false입니다.

spy

Non-XA, XA

JDBC 계층에서 spy 기능을 활성화합니다. 모든 JDBC 트래픽을 데이터 소스에 기록합니다. 로깅 카테고리 jboss.jdbc.spy 도 로깅 하위 시스템에서 로그 수준 DEBUG 로 설정해야 합니다.

stale-connection-checker-class-name

Non-XA, XA

isStaleConnection(SQLException) 방법을 제공하는 org.jboss.jca.adapters.jdbc.StaleConnectionChecker 의 인스턴스입니다. 이 메서드에서 true 를 반환하면 예외가 org.jboss.jca.adapters.jdbc.StaleConnectionException 으로 래핑됩니다.

stale-connection-checker-properties

Non-XA, XA

오래된 연결 검사 속성입니다.

statistics-enabled

Non-XA, XA

런타임 통계가 활성화되어 있는지 여부입니다. 기본값은 false입니다.

track-statements

Non-XA, XA

연결이 풀로 반환되고 문이 준비된 문 캐시로 반환될 때 닫히지 않은 문을 확인할지 여부입니다. whether to check for unclosed statements when a connection is returned to a pool and a statement is returned to the prepared statement cache. false인 경우 문이 추적되지 않습니다. 유효한 값은 다음과 같습니다.

추적

Non-XA, XA

트랜잭션 경계에서 연결을 추적할지 여부입니다.

transaction-isolation

Non-XA, XA

java.sql.Connection 트랜잭션 격리 수준입니다. 유효한 값은 다음과 같습니다.

url-delimiter

Non-XA, XA

HA(고가용성) 데이터 소스용 connection-url의 URL 구분 기호입니다.

url-property

XA만 해당

xa-datasource-property 값의 URL 속성입니다.

url-selector-strategy-class-name

Non-XA, XA

org.jboss.jca.adapters.jdbc.URLSelectorStrategy 를 구현하는 클래스입니다.

use-ccm

Non-XA, XA

캐시된 연결 관리자를 활성화합니다.

use-fast-fail

Non-XA, XA

true인 경우 연결이 유효하지 않은 경우 첫 번째 시도에서 연결 할당이 실패합니다. false인 경우 풀이 소진될 때까지 계속 시도합니다.

use-java-context

Non-XA, XA

데이터 소스를 글로벌 JNDI에 바인딩할지 여부입니다.

use-try-lock

Non-XA, XA

내부 잠금에 대한 시간 초과 값입니다. 이렇게 하면 잠금을 사용할 수 없는 경우 즉시 실패하는 대신 시간 초과 전에 구성된 시간(초)에 대한 잠금을 가져오려고 합니다. lock() 대신 tryLock() 을 사용합니다.

user-name

Non-XA, XA

새 연결을 만들 때 사용할 사용자 이름입니다.

valid-connection-checker-class-name

Non-XA, XA

연결의 유효성을 검사하는 SQLException.isValidConnection(Connection e) 방법을 제공하는 org.jboss.jca.adaptors.jdbc.ValidConnectionChecker 의 구현입니다. 예외는 연결이 끊어졌음을 의미합니다. 이 매개 변수가 있는 경우 check-valid-connection-sql 매개변수를 덮어씁니다.

valid-connection-checker-properties

Non-XA, XA

유효한 연결 검사기 속성입니다.

validate-on-match

Non-XA, XA

연결 팩토리에서 관리되는 연결과 일치하려고 할 때 연결 유효성 검사가 수행되는지 여부입니다. whether connection validation is performed when a connection factory attempts to match a managed connection. 클라이언트 사용 전에 유효성이 검사된 연결이 있어야 하는 경우 이 값을 사용해야 합니다. validate-on-match는 일반적으로 background-validation 와 함께 사용되지 않거나 중복 검사를 수행합니다.

wrap-xa-resource

XA만 해당

XAResource를 org.jboss.tm.XAResourceWrapper 인스턴스에서 래핑할지 여부입니다.

XA-datasource-class

XA만 해당

javax.sql.XADataSource 구현 클래스의 정규화된 이름입니다.

XA-datasource-properties

XA만 해당

XA 데이터 소스 속성의 문자열 이름/값 쌍입니다.

XA-resource-timeout

XA만 해당

0이 아닌 경우 이 값은 XAResource.setTransactionTimeout 메서드로 전달됩니다.