14.7. 客户端连接分区

流程

1. 为第一个代理打开 < broker_instance_dir> /etc/broker.xml 配置文件。

2. 创建 connection-routers 元素，并创建一个 connection-route 来使用一致的哈希算法过滤客户端 ID。例如：

   <configuration>
      <core>
         ...
         <connection-routers>
            <connection-route name=”consistent-hash-routing”>
               <key>CLIENT_ID</target-key>
               <local-target-filter>NULL|0</local-target-filter>
               <policy name="CONSISTENT_HASH_MODULO">
                  <property key="modulo" value="<number_of_brokers_in_cluster>">
                  </property>
               </policy>
            </connection-route>
         </connection-routers>
         ...
      </core>
   </configuration>

   Copy to Clipboard Toggle word wrap

   connection-route

   对于 connection-route 名称，请为此连接路由配置指定一个识别字符串。您必须将此名称添加到要应用一致的散列过滤器的每个代理接受者。

   key

   将过滤器应用到的密钥类型。要过滤客户端 ID，请在 key 字段中指定 CLIENT_ID。

   local-target-filter

   代理与 modulo 操作返回的整数值进行比较，以确定是否存在匹配项，代理是否可以接受连接。示例中的 NULL|0 值为没有客户端 ID(NULL)的连接提供了匹配的连接，其中 modulo 操作返回的数量为 0。

   policy

   接受 modulo 属性键，它对哈希客户端 ID 执行 modulo 操作，以识别目标代理。modulo 属性键的值必须等于集群中的代理数量。

   重要

   策略名称必须是 CONSISTENT_HASH_MODULO。

3. 为第二个代理打开 < broker_instance_dir> /etc/broker.xml 配置文件。

4. 创建 connection-routers 元素，并使用一致的哈希算法创建一个 连接路由 来过滤客户端 ID。

   在以下示例中，NULL|1 的 local-target-filter 值为没有客户端 ID (NULL)的连接提供了匹配，其中 modulo 操作返回的值为 1。

   <configuration>
      <core>
         ...
         <connection-routers>
            <connection-route name=”consistent-hash-routing”>
               <key>CLIENT_ID</target-key>
               <local-target-filter>NULL|1</local-target-filter>
               <policy name="CONSISTENT_HASH_MODULO">
                  <property key="modulo" value="<number_of_brokers_in_cluster>">
                  </property>
               </policy>
            </connection-route>
         </connection-routers>
         ...
      </core>
   </configuration>

   Copy to Clipboard Toggle word wrap
5. 重复此步骤，为集群中的每个额外代理创建一个一致的哈希过滤器。

流程

1. 为第一个代理打开 < broker_instance_dir> /etc/broker.xml 配置文件。

2. 创建 connection-routers 元素，并创建一个 connection-route 来过滤客户端 ID 的一部分。例如：

   <configuration>
       <core>
           ...
           <connection-routers>
               <connection-route name=”regex-routing”>
                   <key>CLIENT_ID</target-key>
                   <key-filter>^.{3}</key-filter>
                   <local-target-filter>NULL|CL1</local-target-filter>
               </connection-route>
       </connection-routers>
           ...
       </core>
   </configuration>

   Copy to Clipboard Toggle word wrap

   connection-route

   对于 connection-route 名称，请为此路由配置指定一个识别字符串。您必须将此名称添加到要应用正则表达式过滤器的每个代理接受者。

   key

   将过滤器应用到的密钥。要过滤客户端 ID，请在 key 字段中指定 CLIENT_ID。

   key-filter

   应用正则表达式的客户端 ID 字符串的一部分来提取键值。在上面的第一个代理示例中，代理提取一个 key 值，它是客户端 ID 的前 3 个字符。例如，客户端 ID 字符串是 CL100.consumer，代理会提取 CL1 的键值。代理提取 key 值后，它会将它与 local-target-filter 的值进行比较。

   如果传入连接没有客户端 ID，或者代理无法使用为 key-filter 指定的正则表达式提取键值，则 key 值设为 NULL。

   local-target-filter

   代理与 key 值进行比较的值，以确定是否存在匹配项，代理是否可以接受连接。NULL|CL1 值（如上例中所示），与没有客户端 ID (NULL)的连接匹配，或者在客户端 ID 中具有 3 个字符前缀 CL1。

3. 为第二个代理打开 < broker_instance_dir> /etc/broker.xml 配置文件。

4. 创建 connection-routers 元素，并根据客户端 ID 的一部分创建连接 路由 来过滤连接。

   在以下过滤器示例中，代理使用正则表达式来提取一个 key 值，它是客户端 ID 的前 3 个字符。代理将 NULL 和 CL2 的值与 key 值进行比较，以确定是否存在匹配项，代理是否可以接受连接。

   <configuration>
       <core>
           ...
           <connection-routers>
               <connection-route name=”regex-routing”>
                   <key>CLIENT_ID</target-key>
                   <key-filter>^.{3}</key-filter>
                   <local-target-filter>NULL|CL2</local-target-filter>
               </connection-route>
           </connection-routers>
           ...
       </core>
   </configuration>

   Copy to Clipboard Toggle word wrap
5. 重复此步骤，并为集群中的每个附加代理创建适当的连接路由过滤器。