区域配置

KWDB 将所有用户数据和几乎所有系统数据存储在排序的键值对映射中。这个键空间被划分为多个键空间中的连续块，即数据分片（range）。每个键始终可以在单个数据分片内找到。从 SQL 的角度来看，时序表最初会映射到单个数据分片，数据分片中的每个键值对对应表中的一行。数据分片的大小达到 512 MiB后，系统会自动将其拆分为两个数据分片。随着表的增长，新生成的数据分片也会继续进行类似的拆分操作。当用户数据减少时，数据分片会自动合并。注意：由于 KWDB 采用标记删除的方式处理数据删除，数据分片不会立即合并，只有在垃圾回收过程中实际删除数据后，数据分片才会合并。

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

集群启动时，会自动生成预配置的副本区域和 default 副本区域。其中预配置的副本区域适用于内部系统数据，default 副本区域适用于集群中的其他数据。用户可以直接使用或调整上述副本区域，也可以为指定时序库或时序表单独设置副本区域。

表数据适用的副本区域分为以下级别：

集群：预配置的default副本区域，适用于未受指定数据库、表或行约束的数据。此区域可以调整但不能删除。
数据库：为指定时序库单独设置副本区域。
表：为指定时序表单独设置副本区域。

数据复制过程中，副本区域的优先级排序为表 > 数据库 > 集群。

内部系统数据存储在系统数据分片内，适用于以下级别的副本区域：

集群级：预配置的default副本区域，适用于未受具体副本区域约束的系统数据。
系统数据分片：KWDB 为meta 和 liveness等关键系统数据分片预先设置了副本区域。KWDB 还为内部系统数据库和 system.jobs 表配置了预设的副本区域。

用户可以使用SHOW ZONE CONFIGURATION 语句查看指定对象及集群内的所有副本区域设置。

查看区域配置

SHOW ZONE CONFIGURATION 语句用于查看指定对象的副本区域信息。
SHOW ZONE CONFIGURATIONS 和 SHOW ALL ZONE CONFIGURATIONS 用于查看集群所有系统数据分片、system 数据库和系统表的副本信息。

所需权限

无

语法格式

参数说明

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

# 区域配置

# 查看区域配置

# 所需权限

# 语法格式

# 参数说明

# 语法示例

区域配置

查看区域配置

所需权限

语法格式

参数说明

语法示例