6.2. 在数据库中保留消息数据

流程

1. 将适当的 JDBC 客户端库添加到代理运行时。要做到这一点，将相关的 .JAR 文件添加到 < broker_instance_dir>/lib 目录中。

   如果要将 .JAR 文件添加到其他目录中，您必须将该目录添加到 Java 类路径中。如需更多信息，请参阅 第 1.5 节 “扩展 JAVA 类路径”

2. 打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。

3. 在 core 元素中，添加一个包含 database-store 元素的 store 元素。

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

   Copy to Clipboard Toggle word wrap

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>
             <jdbc-max-page-size-bytes>100K</jdbc-max-page-size-bytes>
          </database-store>
       </store>
     </core>
   </configuration>

   Copy to Clipboard Toggle word wrap

   jdbc-connection-url

   您的数据库服务器的完整 JDBC 连接 URL。连接 URL 应包含所有配置参数和数据库名称。

   jdbc-user

   数据库服务器的加密用户名。有关加密在配置文件中使用的用户名和密码的更多信息，请参阅 第 5.10 节 “在配置文件中加密密码”。

   jdbc-password

   数据库服务器的加密密码。有关加密在配置文件中使用的用户名和密码的更多信息，请参阅 第 5.10 节 “在配置文件中加密密码”。

   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 AMQ 7 支持的配置。

   jdbc-network-timeout

   JDBC 网络连接超时，以毫秒为单位。默认值为 20000 毫秒。当使用 JDBC 进行共享存储 HA 时，建议将 timeout 设置为小于或等于 jdbc-lock-expiration 的值。

   jdbc-lock-renew-period

   当前 JDBC 锁定的续订周期的长度（以毫秒为单位）。当这个时间过后，代理可以续订锁定。建议设置一个小于 jdbc-lock-expiration 的值多次的值。这会给代理有足够的时间扩展租期，并给代理时间来尝试续订连接问题时的锁定。默认值为 2000 毫秒。

   jdbc-lock-expiration

   以毫秒为单位，当前的 JDBC 锁定被视为拥有（即获取或续订），即使 jdbc-lock-renew-period 值已经过。

   代理定期尝试根据 jdbc-lock-renew-period 值更新它拥有的锁定。如果代理 无法 续订锁定（例如，由于连接问题），代理会持续尝试更新锁定，直到 jdbc-lock-expiration 的值自上次成功获取或更新后通过。

   上述续订行为的一个例外是在另一个代理获取锁定时。如果数据库管理系统(DBMS)和代理之间存在时间对齐，或者对垃圾回收有较长的暂停，会出现这种情况。在这种情况下，最初拥有锁定的代理会考虑锁定丢失，且不会尝试更新它。

   过期时间后，如果 JDBC 锁定尚未由当前拥有它的代理续订，则另一个代理可以建立 JDBC 锁定。

   jdbc-lock-expiration 的默认值为 20000 毫秒。

   jdbc-journal-sync-period

   代理日志与 JDBC 同步的时间（以毫秒为单位）。默认值为 5 毫秒。

   jdbc-max-page-size-bytes

   当 AMQ Broker 将消息保留到 JDBC 数据库时，每个页面文件的最大大小（以字节为单位）。默认值为 102400，即 100KB。您指定的值还支持字节表示法，如 "K" "MB" 和 "GB"。

流程

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>

   Copy to Clipboard Toggle word wrap

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>

   Copy to Clipboard Toggle word wrap

   driverClassName

   JDBC 数据库驱动程序的完全限定域名。

   url

   您的数据库服务器的完整 JDBC 连接 URL。

   username

   数据库服务器的加密用户名。您还可以将这个值指定为未加密的纯文本。有关加密在配置文件中使用的用户名和密码的更多信息，请参阅 第 5.10 节 “在配置文件中加密密码”。

   password

   数据库服务器的加密密码。您还可以将这个值指定为未加密的纯文本。有关加密在配置文件中使用的用户名和密码的更多信息，请参阅 第 5.10 节 “在配置文件中加密密码”。

   poolPreparedStatements

   当此参数的值设置为 true 时，池可以有无限数量的缓存准备语句。这降低了初始化成本。

   maxTotal

   池中的最大连接数。当此参数的值设置为 1 时，没有限制。