为方便对实例进行管理,云数据库 MySQL 版提供了为实例指定有序实例名称的能力,在控制台或调用 OpenAPI 批量创建实例时,可为批量创建的实例指定有序的实例名称。本文介绍指定有序实例名称的详细规则。
为实现指定有序实例名称的目的,MySQL 在实例名称的命名规则基础上,为实例名称支持了特定的有序字段语法 name_prefix[begin_number,bits]name_suffix
,通过该语法为实例名称增加有序字段。该语法各字段说明如下表所示。
字段 | 类型 | 是否必选 | 说明 |
---|---|---|---|
name_prefix | String | 是 | 实例名称的前缀。前缀应满足以下规则:
|
begin_number | Integer | 否 | 有序实例名称的起始数值。
|
bits | Integer | 否 | 指定有序字段在实例名称中所占的位数。
|
name_suffix | String | 否 | 实例名称的后缀,只能包含中文、字母、数字、下划线(_)和中划线(-)。 |
说明
通过name_prefix[begin_number,bits]name_suffix
语法指定的实例名称,长度需要在 1~128 个字符之间。
[begin_number,bits] 之间的分隔符只能为英文逗号(,),且英文逗号(,)前后不能有空格。
如果指定了[]
或者[,]
,则 begin_number 从 0 开始取值,bits 默认为 4。
如果 begin_number 与批量创建的实例数量之和的位数大于 bits 的值,则以 begin_number 与批量创建的实例数量之和的位数为准进行创建。但 begin_number 与批量创建的实例数量之和的位数不能超过 4 ,否则创建失败。
说明 | 输入参数 | 实例数量 | 实例名称 |
---|---|---|---|
标准格式 | 前缀[1,3]后缀 | 3 | 前缀001后缀、name002后缀、name003后缀 |
标准格式,begin_number+实例数量 的位数 > 指定 bits | 前缀[99,2]后缀 | 3 | 前缀099后缀、前缀100后缀、前缀101后缀 |
标准格式,begin_number+实例数量的位数 > 4 | 前缀[9999,4]后缀 | 2 | 创建失败 |
未指定 begin_number 与 bits | 前缀[]后缀 或 前缀[,]后缀 | 3 | 前缀0000后缀、前缀0001后缀、前缀0002后缀 |