A.21. 리소스 어댑터 속성


다음 표에서는 리소스 어댑터 특성에 대해 설명합니다.

표 A.39. 기본 속성
속성설명

archive

리소스 어댑터 아카이브입니다.

Cryostatvalidationgroups

사용해야 하는 8080 검증 그룹입니다.

bootstrap-context

사용해야 하는 부트스트랩 컨텍스트의 고유 이름입니다.

config-properties

사용자 정의 정의된 구성 속성입니다.

module

리소스 어댑터가 로드될 모듈입니다.

statistics-enabled

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

transaction-support

리소스 어댑터의 트랜잭션 지원 수준입니다.

wm-security

이 리소스 어댑터의 wm.security 를 토글합니다. false인 경우 기본값에도 모든 wm-security-* 매개변수가 무시됩니다.

wm-security-default-groups

사용된 주체 인스턴스에 추가해야 하는 기본 그룹 목록입니다.

wm-security-default-principal

사용된 주체 인스턴스에 추가해야 하는 기본 주체 이름입니다.

wm-security-domain

사용해야 하는 보안 도메인의 이름입니다.

WM-security-mapping-groups

그룹 매핑 목록입니다.

WM-security-mapping-required

보안 자격 증명에 매핑이 필요한지 여부를 정의합니다.

wm-security-mapping-users

사용자 매핑 목록입니다.

표 A.40. admin-objects 특성
속성설명

class-name

관리 오브젝트의 정규화된 클래스 이름입니다.

enabled

관리 오브젝트를 활성화해야 하는지 여부를 지정합니다.

JNDI-name

관리 오브젝트의 JNDI 이름입니다.

use-java-context

이를 false로 설정하면 오브젝트를 글로벌 JNDI에 바인딩합니다.

표 A.41. connection-definitions 속성
속성설명

allocation-retry

예외를 throw하기 전에 연결 할당을 시도해야 하는 횟수를 나타냅니다.Indicates the number of times that allocating a connection should be tried before throwing an exception.

allocation-retry-wait-millis

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

background-validation

사용하기 전에 유효성을 검사하는 대신 백그라운드 스레드에서 연결을 검증하도록 지정합니다. 이 값을 변경하려면 서버를 다시 시작해야 합니다.

background-validation-millis

백그라운드 유효성 검사가 실행되는 시간(밀리초)입니다. 이 값을 변경하려면 서버를 다시 시작해야 합니다.

blocking-timeout-wait-millis

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

capacity-decrementer-class

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

capacity-decrementer-properties

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

capacity-incrementer-class

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

capacity-incrementer-properties

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

class-name

관리되는 연결 팩토리 또는 admin 오브젝트의 정규화된 클래스 이름입니다.

connectable

CMR 사용을 활성화합니다. 이 기능은 로컬 리소스가 XA 트랜잭션에 안정적으로 참여할 수 있음을 의미합니다.

enabled

리소스 어댑터를 활성화해야 하는지 여부를 지정합니다.

Enlistment

리소스 어댑터에서 지원하는 경우 lazy Enlistment를 사용해야 하는지 여부를 지정합니다.

enlistment-trace

JBoss EAP/IronJacamar가 등록 추적을 기록해야 하는지 여부를 지정합니다.

flush-strategy

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

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

idle-timeout-minutes

최대 시간(분)은 닫히기 전에 유휴 상태일 수 있습니다. 실제 최대 시간은 모든 풀의 가장 작은 idle-timeout-minutes 값의 절반인 IdleRemover 검사 시간에 따라 다릅니다. 이 값을 변경하려면 서버를 다시 시작해야 합니다.

initial-pool-size

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

interleaving

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

JNDI-name

연결 팩토리에 대한 JNDI 이름입니다.

max-pool-size

풀의 최대 연결 수입니다. 각 하위 풀에 더 이상 연결이 생성되지 않습니다.

mcp

ManagedConnectionPool 구현 예: org.jboss.jca.core.connectionmanager.pool.mcp.SemaphoreArrayListManagedConnectionPool.

min-pool-size

풀에 대한 최소 연결 수입니다.

복구되지 않음

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

no-tx-separate-pool

Oracle은 JTA 트랜잭션 내부 및 외부에서 사용되는 XA 연결을 선호하지 않습니다. 문제를 해결하려면 다른 컨텍스트에 대해 별도의 하위 풀을 생성할 수 있습니다.

Pad-xid

Xid를 패딩해야 하는지 여부를 지정합니다.

pool-fair

풀 사용을 공정하게 사용해야 하는지 여부를 지정합니다.

pool-prefill

풀을 미리 채워야 하는지 여부를 지정합니다. 이 값을 변경하려면 서버를 다시 시작해야 합니다.

pool-use-strict-min

min-pool-size 가 strict으로 간주되어야 하는지 여부를 지정합니다.

recovery-password

복구에 사용되는 암호입니다.

recovery-plugin-class-name

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

recovery-plugin-properties

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

recovery-security-domain

복구에 사용되는 보안 도메인입니다.

recovery-username

복구에 사용되는 사용자 이름입니다.

same-rm-override

기본적으로 javax. Cryostat.xa.XAResource.isSameRM(XAResource) 이 true 또는 false를 반환하는지 여부를 설정합니다.

security-application

getConnection(user, pw) 와 같은 애플리케이션 제공 매개 변수가 풀에서 연결을 구분하는 데 사용됨을 나타냅니다.

security-domain

풀에서 연결을 구분하는 데 사용되는 javax.security.auth.Subject 를 정의하는 보안 도메인입니다.

security-domain-and-application

getConnection(user, pw) 와 같은 애플리케이션 제공 매개 변수 또는 주체 (보안 도메인의 대상)가 풀의 연결을 구분하는 데 사용됨을 나타냅니다.

sharable

지원되는 경우 lazy 연결을 활성화할 수 있는 sharable 연결 사용을 활성화합니다.

추적

controlPlaneJacamar이 트랜잭션 경계에서 연결 처리를 추적해야 하는지 여부를 지정합니다.

use-ccm

캐시된 연결 관리자 사용을 활성화합니다.

use-fast-fail

첫 번째 시도에서 연결 할당이 유효하지 않은 경우(true) 또는 풀이 모든 잠재적인 연결에서 소진될 때까지 계속 시도합니다(false).

use-java-context

이를 false 로 설정하면 오브젝트를 글로벌 JNDI에 바인딩합니다.

validate-on-match

연결 팩토리에서 관리형 연결과 일치하려고 할 때 연결 유효성 검사를 수행해야 하는지 여부를 지정합니다. 이는 일반적으로 배경 검증 사용에 한정적입니다.

wrap-xa-resource

XAResource 인스턴스를 org.jboss.tm.XAResourceWrapper 인스턴스에서 래핑해야 하는지 여부를 지정합니다.

XA-resource-timeout

이 값은 XAResource.setTransactionTimeout() 에 전달됩니다. 기본값은 0입니다.

리소스 어댑터 스키마는 EAP_HOME/docs/schema/wildfly-resource-adapters_4_0.xsd 에서 확인할 수 있습니다.

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat