6.2. 데이터베이스에 메시지 데이터 유지

절차

1. 브로커 런타임에 적절한 JDBC 클라이언트 라이브러리를 추가합니다. 이렇게 하려면 관련 .jar 파일을 < broker_instance_dir> /lib 디렉터리에 추가합니다.
2. &lt ;broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

3. core 요소 내에서 데이터베이스 저장소 요소를 포함하는 store 요소를 추가합니다.

   <configuration>
     <core>
       <store>
          <database-store>
          </database-store>
       </store>
     </core>
   </configuration>

4. database-store 요소 내에서 JDBC 지속성에 대한 구성 매개 변수를 추가하고 값을 지정합니다. 예를 들면 다음과 같습니다.

   <configuration>
     <core>
       <store>
          <database-store>
             <jdbc-connection-url>jdbc:oracle:data/oracle/database-store;create=true</jdbc-connection-url>
             <jdbc-user>ENC(5493dd76567ee5ec269d11823973462f)</jdbc-user>
             <jdbc-password>ENC(56a0db3b71043054269d11823973462f)</jdbc-password>
             <bindings-table-name>BIND_TABLE</bindings-table-name>
             <message-table-name>MSG_TABLE</message-table-name>
             <large-message-table-name>LGE_TABLE</large-message-table-name>
             <page-store-table-name>PAGE_TABLE</page-store-table-name>
             <node-manager-store-table-name>NODE_TABLE</node-manager-store-table-name>
             <jdbc-driver-class-name>oracle.jdbc.driver.OracleDriver</jdbc-driver-class-name>
             <jdbc-network-timeout>10000</jdbc-network-timeout>
             <jdbc-lock-renew-period>2000</jdbc-lock-renew-period>
             <jdbc-lock-expiration>20000</jdbc-lock-expiration>
             <jdbc-journal-sync-period>5</jdbc-journal-sync-period>
          </database-store>
       </store>
     </core>
   </configuration>

   jdbc-connection-url

   데이터베이스 서버에 대한 JDBC 연결 URL입니다. 연결 URL에는 모든 구성 매개변수와 데이터베이스 이름이 포함되어야 합니다.

   jdbc-user

   데이터베이스 서버의 암호화된 사용자 이름입니다. 구성 파일에 사용할 사용자 이름 및 암호를 암호화하는 방법에 대한 자세한 내용은 5.9절. “구성 파일에서 암호 암호화” 을 참조하십시오.

   jdbc-password

   데이터베이스 서버의 암호화된 암호입니다. 구성 파일에 사용할 사용자 이름 및 암호를 암호화하는 방법에 대한 자세한 내용은 5.9절. “구성 파일에서 암호 암호화” 을 참조하십시오.

   bindings-table-name

   데이터를 바인딩하는 테이블의 이름입니다. 테이블 이름을 지정하면 간섭 없이 여러 서버 간에 단일 데이터베이스를 공유할 수 있습니다.

   message-table-name

   메시지 데이터가 저장되는 테이블의 이름입니다. 이 테이블 이름을 지정하면 간섭 없이 여러 서버 간에 단일 데이터베이스를 공유할 수 있습니다.

   large-message-table-name

   큰 메시지 및 관련 데이터가 지속되는 테이블의 이름입니다. 또한 클라이언트가 청크로 큰 메시지를 스트리밍하면 청크가 이 테이블에 저장됩니다. 이 테이블 이름을 지정하면 간섭 없이 여러 서버 간에 단일 데이터베이스를 공유할 수 있습니다.

   page-store-table-name

   디렉터리 정보를 페이징하는 테이블의 이름입니다. 이 테이블 이름을 지정하면 간섭 없이 여러 서버 간에 단일 데이터베이스를 공유할 수 있습니다.

   node-manager-store-table-name

   라이브 및 백업 브로커 및 기타 HA 관련 데이터에 대한 공유 저장소 HA(고가용성) 잠금이 브로커 서버에 저장되는 테이블의 이름입니다. 이 테이블 이름을 지정하면 간섭 없이 여러 서버 간에 단일 데이터베이스를 공유할 수 있습니다. 공유 저장소 HA를 사용하는 각 라이브 백업 쌍은 동일한 테이블 이름을 사용해야 합니다. 동일한 테이블을 여러 개의 (및 관련이 없는) 라이브 백업 쌍 간에 공유할 수 없습니다.

   jdbc-driver-class-name

   JDBC 데이터베이스 드라이버의 정규화된 클래스 이름입니다. 지원되는 데이터베이스에 대한 자세한 내용은 Red Hat 고객 포털에서 Red Hat AMQ 7 지원 구성을 참조하십시오.

   jdbc-network-timeout

   JDBC 네트워크 연결 시간(밀리초)입니다. 기본값은 10.0.0.1밀리초입니다. 공유 저장소 HA에 JDBC를 사용하는 경우 시간 제한을 jdbc-lock-expiration 보다 작거나 같은 값으로 설정하는 것이 좋습니다.

   jdbc-lock-renew-period

   현재 JDBC 잠금의 갱신 기간의 길이(밀리초)입니다. 이 시간이 지나면 브로커가 잠금을 갱신할 수 있습니다. jdbc-lock-expiration 값보다 작은 값을 여러 번 설정하는 것이 좋습니다. 이를 통해 브로커는 임대를 연장하기에 충분한 시간을 제공하고 연결 문제가 발생한 경우 브로커에 잠금을 갱신하려고 할 수 있습니다. 기본값은 2000밀리초입니다.

   jdbc-lock-expiration

   jdbc-lock-renew-period 값이 경과하더라도 현재 JDBC 잠금을 소유하는 것으로 간주되는 시간(밀리초)입니다.

   브로커는 jdbc-lock-renew-period 값에 따라 소유한 잠금을 주기적으로 갱신하려고 합니다. 브로커가 잠금을 갱신 하지 못하는 경우 (예: 연결 문제로 인해) 잠금을 마지막으로 획득하거나 갱신한 이후 jdbc-lock-expiration 값이 통과될 때까지 브로커가 잠금을 갱신하려고 합니다.

   위에서 설명한 갱신 동작에 대한 예외는 다른 브로커가 잠금을 취득하는 경우입니다. DBMS(Database Management System)와 브로커 간에 시간 정렬이 있거나 가비지 수집에 대한 일시 중지가 있는 경우 발생할 수 있습니다. 이 경우 처음 잠금을 소유한 브로커는 잠금이 손실된 것으로 간주하고 갱신을 시도하지 않습니다.

   만료 시간이 지나면 현재 이를 보유한 브로커에 의해 JDBC 잠금을 갱신하지 않은 경우 다른 브로커가 JDBC 잠금을 설정할 수 있습니다.

   jdbc-lock-expiration 의 기본값은 10.0.0.1밀리초입니다.

   jdbc-journal-sync-period

   브로커 저널이 JDBC와 동기화되는 기간(밀리초)입니다. 기본값은 5밀리초입니다.

절차

1. &lt ;broker-instance-dir> /etc/broker.xml 구성 파일을 엽니다.

2. JDBC 구성에 이전에 추가한 database-store 요소에서 jdbc-driver-class-name,jdbc-connection-url,jdbc-user,jdbc-password, 매개변수를 제거합니다. 이 절차의 뒷부분에서 이러한 매개변수를 해당 DBCP 구성 매개변수로 바꿉니다.

   참고

   이전 매개변수를 명시적으로 제거하지 않으면 이 절차의 뒷부분에서 추가하는 해당 DBCP 매개변수가 우선합니다.

3. database-store 요소 내에서 data-source-properties 요소를 추가합니다. 예를 들면 다음과 같습니다.

   <store>
       <database-store>
           <data-source-properties>
           </data-source-properties>
           <bindings-table-name>BINDINGS</bindings-table-name>
           <message-table-name>MESSAGES</message-table-name>
           <large-message-table-name>LARGE_MESSAGES</large-message-table-name>
           <page-store-table-name>PAGE_STORE</page-store-table-name>
           <node-manager-store-table-name>NODE_MANAGER_STORE</node-manager-store-table-name>
           <jdbc-network-timeout>10000</jdbc-network-timeout>
           <jdbc-lock-renew-period>2000</jdbc-lock-renew-period>
           <jdbc-lock-expiration>20000</jdbc-lock-expiration>
           <jdbc-journal-sync-period>5</jdbc-journal-sync-period>
       </database-store>
   </store>

4. 새로운 data-source-properties 요소 내에서 연결 풀링을 위한 DBCP 데이터 소스 속성을 추가합니다. 키-값 쌍을 지정합니다. 예를 들면 다음과 같습니다.

   <store>
       <database-store>
           <data-source-properties>
               <data-source-property key="driverClassName" value="com.mysql.jdbc.Driver" />
               <data-source-property key="url" value="jdbc:mysql://localhost:3306/artemis" />
               <data-source-property key="username" value="ENC(5493dd76567ee5ec269d1182397346f)"/>
               <data-source-property key="password" value="ENC(56a0db3b71043054269d1182397346f)"/>
               <data-source-property key="poolPreparedStatements" value="true" />
               <data-source-property key="maxTotal" value="-1" />
           </data-source-properties>
           <bindings-table-name>BINDINGS</bindings-table-name>
           <message-table-name>MESSAGES</message-table-name>
           <large-message-table-name>LARGE_MESSAGES</large-message-table-name>
           <page-store-table-name>PAGE_STORE</page-store-table-name>
           <node-manager-store-table-name>NODE_MANAGER_STORE</node-manager-store-table-name>
           <jdbc-network-timeout>10000</jdbc-network-timeout>
           <jdbc-lock-renew-period>2000</jdbc-lock-renew-period>
           <jdbc-lock-expiration>20000</jdbc-lock-expiration>
           <jdbc-journal-sync-period>5</jdbc-journal-sync-period>
       </database-store>
   </store>

   driverClassName

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

   url

   데이터베이스 서버에 대한 JDBC 연결 URL입니다.

   사용자 이름

   데이터베이스 서버의 암호화된 사용자 이름입니다. 이 값을 암호화되지 않은 일반 텍스트로 지정할 수도 있습니다. 구성 파일에 사용할 사용자 이름 및 암호를 암호화하는 방법에 대한 자세한 내용은 5.9절. “구성 파일에서 암호 암호화” 을 참조하십시오.

   암호

   데이터베이스 서버의 암호화된 암호입니다. 이 값을 암호화되지 않은 일반 텍스트로 지정할 수도 있습니다. 구성 파일에 사용할 사용자 이름 및 암호를 암호화하는 방법에 대한 자세한 내용은 5.9절. “구성 파일에서 암호 암호화” 을 참조하십시오.

   poolPreparedStatements

   이 매개 변수의 값을 true 로 설정하면 풀에 캐시된 준비 문을 무제한으로 사용할 수 있습니다. 이렇게 하면 초기화 비용이 줄어듭니다.

   maxTotal

   풀의 최대 연결 수입니다. 이 매개변수의 값이 -1 로 설정되면 제한이 없습니다.