Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

13.3. 데이터 소스 생성

데이터 소스는 관리 콘솔 또는 관리 CLI를 사용하여 생성할 수 있습니다.

JBoss EAP 7을 사용하면 활성화된 속성과 같은 데이터 소스 속성 값에 표현식을 사용할 수 있습니다. 구성의 표현식 사용에 대한 자세한 내용은 속성 교체 섹션을 참조하십시오.

13.3.1. 비 XA 데이터 소스 생성

비 XA 데이터 소스는 data-source add management CLI 명령을 사용하여 정의할 수 있습니다. 구성 Cryostat Datasources Non-XA 로 이동하여 관리 콘솔을 사용하여 XA 이외의 데이터 소스를 정의하고 추가 를 클릭하여 데이터 소스 생성 마법사를 열 수도 있습니다.

다음 단계에서는 관리 CLI를 사용하여 XA가 아닌 데이터 소스를 정의하는 방법을 설명합니다.

  1. 아직 수행하지 않은 경우 적절한 JDBC 드라이버를 코어 모듈로 설치 및 등록합니다.

  2. 적절한 인수 값을 지정하여 data-source add 명령을 사용하여 데이터 소스를 정의합니다.

    Copy to Clipboard Toggle word wrap 
    data-source add --name=DATASOURCE_NAME --jndi-name=JNDI_NAME --driver-name=DRIVER_NAME  --connection-url=CONNECTION_URL
    참고

    관리형 도메인에서 --profile=PROFILE_NAME 인수를 지정해야 합니다.

    이러한 매개변수 값에 대한 팁은 아래의 데이터 소스 매개변수 섹션을 참조하십시오.

자세한 예제는 지원되는 데이터베이스에 대한 데이터 소스 구성 예제 를 참조하십시오.

데이터 소스 매개변수
JNDI-name
데이터 소스에 대한 JNDI 이름은 java:/ 또는 java:jboss/ 로 시작해야 합니다. 예: java:jboss/datasources/ExampleDS.
driver-name

드라이버 이름 값은 JDBC 드라이버가 코어 모듈 또는 JAR 배포로 설치되었는지에 따라 달라집니다.

  1. 코어 모듈의 경우 드라이버 이름 값은 등록 시 JDBC 드라이버에 지정된 이름이 됩니다.

  2. JAR 배포의 경우 /META-INF/services/java.sql.Driver 파일에 나열된 클래스가 하나뿐인 경우 드라이버 이름은 JAR의 이름입니다. 여러 클래스가 나열된 경우 값은 JAR_NAME + "_" + DRIVER_CLASS_NAME + MAJOR_VERSION + "_" + MINOR_VERSION + MINOR_VERSION (예: mysql-connector-java-5.1.36-bin.jar_com.mysql.jdbc.Driver_5_1)입니다.

    JDBC JAR이 배포될 때 JBoss EAP 서버 로그에 나열된 드라이버 이름도 확인할 수 있습니다.

    Copy to Clipboard Toggle word wrap 
    WFLYJCA0018: Started Driver service with driver-name = mysql-connector-java-5.1.36-bin.jar_com.mysql.jdbc.Driver_5_1
connection-url
지원되는 데이터베이스에 대한 연결 URL 형식에 대한 자세한 내용은 데이터 소스 연결 URL 목록을 참조하십시오.

사용 가능한 모든 데이터 소스 매개변수의 전체 목록은 Datasource Parameters 섹션을 참조하십시오.

13.3.2. XA 데이터 소스 생성

XA 데이터 소스는 xa-data-source add management CLI 명령을 사용하여 정의할 수 있습니다. 구성 Cryostat Datasources XA로 이동하여 관리 콘솔을 사용하여 XA 데이터 소스를 정의하고 추가 를 클릭하여 XA 데이터 소스 생성 마법사를 열 수도 있습니다.

다음 단계에서는 관리 CLI를 사용하여 XA 데이터 소스를 정의하는 방법을 설명합니다.

참고

관리형 도메인에서 사용할 프로필을 지정해야 합니다. 관리 CLI 명령의 형식에 따라 명령 앞에 /profile=PROFILE_NAME 또는 --profile=PROFILE_NAME 인수를 전달합니다.

  1. 아직 수행하지 않은 경우 적절한 JDBC 드라이버를 코어 모듈로 설치 및 등록합니다.

  2. 적절한 인수 값을 지정하여 xa-data-source add 명령을 사용하여 데이터 소스를 정의합니다.

    Copy to Clipboard Toggle word wrap 
    xa-data-source add --name=XA_DATASOURCE_NAME --jndi-name=JNDI_NAME --driver-name=DRIVER_NAME --xa-datasource-class=XA_DATASOURCE_CLASS --xa-datasource-properties={"ServerName"=>"HOSTNAME","DatabaseName"=>"DATABASE_NAME"}

    이러한 매개변수 값에 대한 팁은 아래의 데이터 소스 매개변수 섹션을 참조하십시오.

  3. XA 데이터 소스 속성을 설정합니다.

    XA 데이터 소스를 정의할 때 하나 이상의 XA 데이터 소스 속성이 필요하거나 이전 단계에서 데이터 소스를 추가할 때 오류가 발생합니다. XA 데이터 소스를 정의할 때 설정되지 않은 속성은 나중에 개별적으로 설정할 수 있습니다.

    1. 서버 이름을 설정합니다.

      Copy to Clipboard Toggle word wrap 
      /subsystem=datasources/xa-data-source=XA_DATASOURCE_NAME/xa-datasource-properties=ServerName:add(value=HOSTNAME)

    2. 데이터베이스 이름을 설정합니다.

      Copy to Clipboard Toggle word wrap 
      /subsystem=datasources/xa-data-source=XA_DATASOURCE_NAME/xa-datasource-properties=DatabaseName:add(value=DATABASE_NAME)

자세한 예제는 지원되는 데이터베이스에 대한 데이터 소스 구성 예제 를 참조하십시오.

데이터 소스 매개변수
JNDI-name
데이터 소스에 대한 JNDI 이름은 java:/ 또는 java:jboss/ 로 시작해야 합니다. 예: java:jboss/datasources/ExampleDS.
driver-name

드라이버 이름 값은 JDBC 드라이버가 코어 모듈 또는 JAR 배포로 설치되었는지에 따라 달라집니다.

  1. 코어 모듈의 경우 드라이버 이름 값은 등록 시 JDBC 드라이버에 지정된 이름이 됩니다.

  2. JAR 배포의 경우 /META-INF/services/java.sql.Driver 파일에 나열된 클래스가 하나뿐인 경우 드라이버 이름은 JAR의 이름입니다. 여러 클래스가 나열된 경우 값은 JAR_NAME + "_" + DRIVER_CLASS_NAME + MAJOR_VERSION + "_" + MINOR_VERSION + MINOR_VERSION (예: mysql-connector-java-5.1.36-bin.jar_com.mysql.jdbc.Driver_5_1)입니다.

    JDBC JAR이 배포될 때 JBoss EAP 서버 로그에 나열된 드라이버 이름도 확인할 수 있습니다.

    Copy to Clipboard Toggle word wrap 
    WFLYJCA0018: Started Driver service with driver-name = mysql-connector-java-5.1.36-bin.jar_com.mysql.jdbc.Driver_5_1
XA-datasource-class
javax.sql.XADataSource 클래스의 JDBC 드라이버 구현에 대한 XA 데이터 소스 클래스를 지정합니다.
XA-datasource-properties
XA 데이터 소스를 정의할 때 하나 이상의 XA 데이터 소스 속성이 필요하거나 추가하려고 할 때 오류가 발생합니다. 또한 XA 데이터 소스를 정의한 후 XA 데이터 소스에 속성을 추가할 수도 있습니다.

사용 가능한 모든 데이터 소스 매개변수의 전체 목록은 Datasource Parameters 섹션을 참조하십시오.

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2025 Red Hat, Inc.