文档中心

云数据库 MySQL 版

请输入

实例管理

有序实例名称设置规则

为方便对实例进行管理，云数据库 MySQL 版提供了为实例指定有序实例名称的能力，在控制台或调用 OpenAPI 批量创建实例时，可为批量创建的实例指定有序的实例名称。本文介绍指定有序实例名称的详细规则。

命名规则

为实现指定有序实例名称的目的，MySQL 在实例名称的命名规则基础上，为实例名称支持了特定的有序字段语法 name_prefix[begin_number,bits]name_suffix，通过该语法为实例名称增加有序字段。该语法各字段说明如下表所示。

字段	类型	是否必选	说明
name_prefix	String	是	实例名称的前缀。前缀应满足以下规则：不能以数字、中划线（-）开头。只能包含中文、字母、数字、下划线（_）和中划线（-）。
begin_number	Integer	否	有序实例名称的起始数值。取值范围：[0,9999]。默认值：0。
bits	Integer	否	指定有序字段在实例名称中所占的位数。取值范围：[1,4]。默认值：4。
name_suffix	String	否	实例名称的后缀，只能包含中文、字母、数字、下划线（_）和中划线（-）。

说明

如果 begin_number 与批量创建的实例数量之和的位数大于 bits 的值，则以 begin_number 与批量创建的实例数量之和的位数为准进行创建。但 begin_number 与批量创建的实例数量之和的位数不能超过 4 ，否则创建失败。

使用示例

说明	输入参数	实例数量	实例名称
标准格式	前缀 [1,3] 后缀	3	前缀 001 后缀、前缀 002 后缀、前缀 003 后缀
标准格式，begin_number+实例数量的位数 > 指定 bits	前缀 [99,2] 后缀	3	前缀 099 后缀、前缀 100后缀、前缀 101 后缀
标准格式，begin_number+实例数量的位数 > 4	前缀 [9999,4] 后缀	2	创建失败
未指定 begin_number 与 bits	前缀[]后缀或前缀[,]后缀	3	前缀 0000 后缀、前缀 0001 后缀、前缀 0002 后缀

最近更新时间：2026.09.11 10:27:26

这个页面对您有帮助吗？

有用

无用