区域配置管理

KWDB 集群中，每个数据分片都隶属于一个特定的副本区域（zone）。集群在重新平衡数据分片时，会考虑副本区域的配置，以确保遵守所有约束条件。

集群启动时，会自动生成预配置的副本区域和 default 副本区域。其中预配置的副本区域适用于内部系统数据，default 副本区域适用于集群中的其他数据。

查看区域配置

SHOW ZONE CONFIGURATIONS 语句用于查看指定数据库对象的区域配置。

前提条件

无

语法格式

• 查看指定数据分片、数据库、表或索引的区域配置

  SHOW ZONE CONFIGURATION FOR [RANGE range_name | DATABASE database_name | TABLE table_name  | INDEX table_name @ index_name];
  

• 查看所有副本区域信息

  SHOW [ALL] ZONE CONFIGURATIONS;
  

参数说明

参数	说明
range_name	数据分片的名称，包括： - default：默认副本设置 - meta：所有数据的位置信息 - liveness：给定时间活动节点的信息 - system：分配新表ID所需的信息以及追踪集群节点状态 - timeseries：集群监控数据
database_name	数据库的名称。
table_name	表的名称。
index_name	索引的名称。

语法示例

• 查看指定系统数据分片的副本信息

  以下示例查看 default 默认系统数据分片的副本区域信息。

  SHOW ZONE CONFIGURATION FOR RANGE default;
  

  执行成功后，控制台输出以下信息：

       target     |              raw_config_sql
  ----------------+-------------------------------------------
  RANGE default | ALTER RANGE default CONFIGURE ZONE USING
                 |     range_min_bytes = 268435456,
                 |     range_max_bytes = 536870912,
                 |     gc.ttlseconds = 90000,
                 |     num_replicas = 3,
                 |     constraints = '[]',
                 |     lease_preferences = '[]'
  (1 row)
  

• 查看指定数据库的副本信息

  以下示例查看 db1 数据库的副本区域信息。

  SHOW ZONE CONFIGURATION FOR DATABASE db1;
  

  执行成功后，控制台输出以下信息：

       target    |             raw_config_sql
  ---------------+------------------------------------------
  DATABASE db1   | ALTER DATABASE db1 CONFIGURE ZONE USING
                 |     range_min_bytes = 1048576,
                 |     range_max_bytes = 8388608,
                 |     gc.ttlseconds = 100000,
                 |     num_replicas = 5,
                 |     constraints = '[]',
                 |     lease_preferences = '[]'
  (1 row)
  

• 查看指定表的副本区域信息

  以下示例查看 t1 表的副本区域信息。

  SHOW ZONE CONFIGURATION FOR TABLE t1;
  

  执行成功后，控制台输出以下信息：

       target     |              raw_config_sql
  ----------------+-------------------------------------------
  RANGE default | ALTER RANGE default CONFIGURE ZONE USING
                 |     range_min_bytes = 268435456,
                 |     range_max_bytes = 536870912,
                 |     gc.ttlseconds = 90000,
                 |     num_replicas = 3,
                 |     constraints = '[]',
                 |     lease_preferences = '[]'
  (1 row)