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

流程

1. 将适当的 JDBC 客户端库添加到代理运行时。要做到这一点，将相关的 .jar 文件添加到 < broker_instance_dir>/lib 目录中。
2. 打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。

3. 在 core 元素中，添加一个包含 database-store 元素的 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 的每个 live-backup 对都必须使用相同的表名称。您不能在多个（和不相关）实时备份对之间共享相同的表。

   jdbc-driver-class-name

   JDBC 数据库驱动程序的完全限定类名称。有关支持的数据库的详情，请查看红帽客户门户网站中的 Red Hat AMQ 7 支持的配置。

   jdbc-network-timeout

   JDBC 网络连接超时，以毫秒为单位。默认值为 20000 毫秒。将 JDBC 用于共享存储 HA 时，建议将超时设置为小于或等于 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 毫秒。

流程

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。

   username

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

   password

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

   poolPreparedStatements

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

   maxTotal

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