A.20. 데이터 소스 속성

참고

이 테이블의 특성 이름은 관리 CLI를 사용하는 경우와 같이 관리 모델에 표시되는 대로 나열됩니다. 관리 모델과 다를 수 있으므로 EAP_HOME/docs/schema/wildfly-datasources_5_0.xsd 에 있는 스키마 정의 파일을 참조하여 XML에 표시되는 요소를 확인합니다.

표 A.44. 데이터 소스 속성

속성데이터 소스 유형설명

allocation-retry

XA, XA가 아닌

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

allocation-retry-wait-millis

XA, XA가 아닌

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

allow-multiple-users

XA, XA가 아닌

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

authentication-context

XA, XA가 아닌

풀의 연결을 구분하는 데 사용되는 javax.security.auth.Subject 를 정의하는 Elytron 인증 컨텍스트입니다.

background-validation

XA, XA가 아닌

를 사용하기 전에 백그라운드 스레드에서 커넥션의 유효성을 검사하는 것과 먼저 연결의 유효성을 검사할지 여부입니다. 백그라운드 유효성 검사는 일반적으로 validate-on-match 와 함께 사용되지 않거나 중복 검사가 있습니다. 백그라운드 검증을 사용하면 검증 시간 간에 연결이 저하될 수 있으며 클라이언트에 전달될 수 있습니다. 따라서 애플리케이션은 이러한 가능성을 고려해야 합니다.

background-validation-millis

XA, XA가 아닌

백그라운드 검증이 실행될 빈도(밀리초)입니다.

blocking-timeout-wait-millis

XA, XA가 아닌

연결을 기다리는 동안 예외가 발생하기 전에 차단하는 최대 시간(밀리초)입니다. 이 명령은 연결 잠금을 기다리는 동안만 차단되며 새 연결을 생성하는 경우 예외가 발생하지 않습니다.

capacity-decrementer-class

XA, XA가 아닌

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

capacity-decrementer-properties

XA, XA가 아닌

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

capacity-incrementer-class

XA, XA가 아닌

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

capacity-incrementer-properties

XA, XA가 아닌

풀 연결 증가 정책을 정의하는 클래스에 삽입할 속성입니다.

check-valid-connection-sql

XA, XA가 아닌

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

연결 가능

XA, XA가 아닌

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

connection-listener-class

XA, XA가 아닌

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

connection-listener-property

XA, XA가 아닌

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

연결 속성

비 XA 만

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

connection-url

비 XA 만

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

인증 정보 참조

XA, XA가 아닌

자격 증명 저장소에서 데이터 소스 인증에 대한 자격 증명.

datasource-class

비 XA 만

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

driver-class

비 XA 만

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

driver-name

XA, XA가 아닌

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

Elytron 지원

XA, XA가 아닌

연결 인증을 처리하기 위한 Elytron 보안을 활성화합니다. 컨텍스트가 지정되지 않은 경우 사용할 Elytron authentication-context 가 현재 컨텍스트입니다. 자세한 내용은 인증 컨텍스트 에서 참조하십시오.

enabled

XA, XA가 아닌

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

enlistment-trace

XA, XA가 아닌

등록 추적을 기록해야 하는지 여부. 이는 기본적으로 false 입니다.

exception-sorter-class-name

XA, XA가 아닌

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

exception-sorter-properties

XA, XA가 아닌

예외 분류기 속성.

flush-strategy

XA, XA가 아닌

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

FailingConnectionOnly
실패한 연결만 제거됩니다. 이 설정은 기본 설정입니다.
InvalidIdleConnections
실패한 연결 및 유휴 연결은 동일한 자격 증명을 공유하며 ValidatingManagedConnectionFactory.getInvalidConnections(…​) 메서드가 제거됩니다.
IdleConnections
실패한 연결 및 동일한 자격 증명을 공유하는 유휴 연결이 제거됩니다.
정상적으로
실패한 연결 및 동일한 자격 증명을 공유하는 유휴 연결이 제거됩니다. 동일한 자격 증명을 공유하는 활성 연결은 풀로 돌아가면 삭제됩니다.
EntirePool
동일한 자격 증명을 공유하는 실패한 연결 및 유휴 및 활성 연결이 제거됩니다. 이 설정은 프로덕션 시스템에는 권장되지 않습니다.
AllInvalidIdleConnections
ValidatingManagedConnectionFactory.getInvalidConnections(…​) 메서드가 제거됩니다.
AllIdleConnections
실패한 연결과 모든 유휴 연결이 제거됩니다.
AllGracefully
실패한 연결과 모든 유휴 연결이 제거됩니다. 활성 연결은 풀로 돌아가면 삭제됩니다.
AllConnections
실패한 연결과 모든 유휴 및 활성 연결이 제거됩니다. 이 설정은 프로덕션 시스템에는 권장되지 않습니다.

idle-timeout-minutes

XA, XA가 아닌

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

initial-pool-size

XA, XA가 아닌

풀에서 보유해야 하는 초기 연결 수입니다.

인터리빙

XA만

XA 연결에 대해 인터리빙을 사용할지 여부입니다.

jndi-name

XA, XA가 아닌

데이터 소스의 고유 JNDI 이름입니다.

jta

비 XA 만

자카르타 트랜잭션 통합 활성화.

max-pool-size

XA, XA가 아닌

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

mcp

XA, XA가 아닌

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

min-pool-size

XA, XA가 아닌

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

new-connection-sql

XA, XA가 아닌

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

복구 없음

XA만

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

no-tx-separate-pool

XA만

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

pad-xid

XA만

Xid를 채울지 여부입니다.

암호

XA, XA가 아닌

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

Pool-fair

XA, XA가 아닌

풀이 공정해야 하는지를 정의합니다. 이 설정은 자카르타 커넥터에서 연결 풀을 관리하는 데 사용되는 Semapotre 클래스 의 일부로, 연결 임대 순서가 필요하지 않은 일부 사용 사례에서 성능상의 이점을 제공합니다.

pool-prefill

XA, XA가 아닌

풀을 미리 입력해야 하는지 여부입니다.

pool-use-strict-min

XA, XA가 아닌

min-pool-size 가 엄격하게 고려되어야 하는지 여부.

prepared-statements-cache-size

XA, XA가 아닌

LRU(Least Recently Used) 캐시에서 연결당 준비된 문 수입니다.

query-timeout

XA, XA가 아닌

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

reauth-plugin-class-name

XA, XA가 아닌

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

reauth-plugin-properties

XA, XA가 아닌

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

recovery-authentication-context

XA만

풀의 연결을 구분하는 데 사용되는 javax.security.auth.Subject 를 정의하는 Elytron 인증 컨텍스트입니다.

recovery-credential-reference

XA만

자격 증명 저장소에서 데이터 소스 인증에 대한 자격 증명.

복구-elytron 지원

XA만

복구를 위한 연결 인증을 처리하기 위해 Elytron 보안을 활성화합니다. 인증 컨텍스트가 지정되지 않은 경우 사용되는 Elytron authentication-context 는 현재 컨텍스트가 됩니다. 자세한 내용은 인증 컨텍스트 에서 참조하십시오.

recovery-password

XA만

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

recovery-plugin-class-name

XA만

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

recovery-plugin-properties

XA만

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

recovery-security-domain

XA만

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

recovery-username

XA만

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

same-rm-override

XA만

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

security-domain

XA, XA가 아닌

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

set-tx-query-timeout

XA, XA가 아닌

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

share-prepared-statements

XA, XA가 아닌

JBoss EAP가 캐시해야 하는지 여부에 따라 애플리케이션에 제공된 래퍼가 애플리케이션 코드에 의해 종료될 때 기본 실제 문이 닫힙니다. 기본값은 false입니다.

spy

XA, XA가 아닌

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

stale-connection-checker-class-name

XA, XA가 아닌

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

stale-connection-checker-properties

XA, XA가 아닌

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

통계 지원

XA, XA가 아닌

런타임 통계 활성화 여부. 기본값은 false입니다.

track-statements

XA, XA가 아닌

연결이 풀에 반환될 때 닫히지 않은 문을 확인할지 여부가 준비된 문 캐시로 반환됩니다. false인 경우 문이 추적되지 않습니다. 유효한 값은 다음과 같습니다.

  • true: 문과 결과 세트가 추적되며, 종료되지 않은 경우 경고가 발행됩니다.
  • false: 문이나 결과 세트는 추적되지 않습니다.
  • nowarn: 문은 추적되지만 경고가 발행되지 않습니다(기본값).

추적

XA, XA가 아닌

커넥션이 트랜잭션 경계에서 처리할지 여부입니다.

transaction-isolation

XA, XA가 아닌

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

  • TRANSACTION_READ_UNCOMMITTED
  • TRANSACTION_READ_COMMITTED
  • TRANSACTION_REPEATABLE_READ
  • TRANSACTION_SERIALIZABLE
  • TRANSACTION_NONE

url-delimiter

XA, XA가 아닌

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

URL-property

XA만

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

url-selector-strategy-class-name

XA, XA가 아닌

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

use-ccm

XA, XA가 아닌

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

use-fast-fail

XA, XA가 아닌

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

use-java-context

XA, XA가 아닌

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

use-try-lock

XA, XA가 아닌

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

user-name

XA, XA가 아닌

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

valid-connection-checker-class-name

XA, XA가 아닌

연결을 검증하기 위한 SQLException .isValidConnection(Connection e) 메서드를 제공하는 org.jboss.jca.adaptors.jdbc.ValidConnection Checker 구현. 예외는 연결이 삭제되었음을 의미합니다. 이렇게 하면 check-valid-connection-sql 특성이 재정의됩니다.

valid-connection-checker-properties

XA, XA가 아닌

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

validate-on-match

XA, XA가 아닌

연결 팩토리가 관리되는 연결과 일치하려고 할 때 연결 유효성 검사가 수행되는지 여부. 클라이언트가 사용하기 전에 연결 유효성을 검사해야 하는 경우 이 값을 사용해야 합니다. 보통 validate-on-match는 백그라운드 유효성 검사와 함께 사용되지 않거나 중복 검사가 있습니다.

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 메서드로 전달됩니다.

표 A.45. JDBC 드라이버 속성

속성데이터 소스 유형설명

datasource-class-info

XA, XA가 아닌

the jdbc-driver 에 대해 datasource-classxa-datasource-class 에 사용할 수 있는 속성입니다. datasource-classxa-datasource-class 특성은 javax.sql. DataSource 또는 javax.sql.XADataSource 클래스를 구현하는 정규화된 클래스 이름을 정의합니다. 정의된 클래스에는 다양한 속성의 세터가 있을 수 있습니다. datasource-class-info 특성은 클래스에 대해 설정할 수 있는 이러한 속성을 나열합니다.