云服务器内容精选

  • 操作步骤 登录分布式数据库中间件控制台。 在实例管理列表页面,选择目标DDM实例,单击实例名称,进入实例基本信息页面。 在实例基本信息页面左侧导航栏,选择“逻辑库管理”选项卡,查看DDM实例逻辑库。 图1 逻辑库列表 如果您需要查看DDM实例逻辑库的磁盘大小,请联系客服提交申请。 仅支持查看状态为“运行中”的逻辑库。 页面显示的磁盘大小为预估值,存在误差。 查询逻辑库的磁盘大小会影响DDM实例的性能。 在逻辑库列表页面,单击目标逻辑库名称或者单击操作列的“管理”,进入逻辑库基本信息页面。 在“逻辑库表管理”页签下,查看当前逻辑库中的逻辑表的信息。 图2 逻辑表列表 您可以查看到逻辑表的表名、类型、分库键、分库算法、分库数、分表键、分表算法、分表数、自增字段、自增键起始位置、自增键步长、状态、主键、创建时间、更新时间、是否有全局二级索引等信息。 其中,自增键步长指的是全局序列自增缓存,并不是指的数据库字段每次自增的大小。 您还可以单击操作列“查看表结构”,来查看创建表的SQL。 图3 查看逻辑表结构 在“已关联实例”页签下,查看当前逻辑库中的实例信息。 在“连接地址栏”页签下,获取DDM实例的“命令行连接地址”和“jdbc连接地址”。 连接逻辑库的方法请参见连接DDM逻辑库。
  • 操作步骤 登录分布式数据库中间件控制台。 在实例管理列表页面,单击目标实例操作栏“创建逻辑库”。 图1 创建逻辑库-入口1 您也可以在实例管理列表页面,单击目标实例名称,进入基本信息页面。在左侧导航栏选择逻辑库管理页签,在页面右侧单击创建逻辑库。 图2 创建逻辑库-入口2 在创建逻辑库页面,填选逻辑库模式、逻辑库名称、需要关联的DDM账号、数据节点和逻辑库总分片数。 图3 创建逻辑库 表1 参数说明 参数名称 说明 逻辑库模式 拆分库:一个逻辑库可以关联多个数据节点,分片数均匀的分布在这些数据节点上。 单库:一个逻辑库仅关联一个数据节点,在该数据节点上仅创建一个分片。 逻辑库名称 长度为2-48个字符,以小写字母开头且仅支持小写,可以包含小写字母、数字、下划线。 选择账号 需要关联的DDM账号。 选择数据节点 仅支持和当前DDM实例处于相同VPC、且未被其他DDM实例使用的数据节点。DDM将在选择的数据节点上新建数据库,不会影响数据节点上已有的库表。 逻辑库总分片数 逻辑库总分片数是所选数据节点分片数的总和,为了确保每个数据节点上都能均匀分配到分片,逻辑库总分片数不能小于选择的数据节点数。考虑到业务会持续增长,建议每个数据节点上最小8分片,最大不超过64分片。 单击“下一步”。 在数据节点可用性检测页面,输入关联数据节点的账号及密码,单击“测试”。 数据节点账号所需权限: SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, RELOAD, PROCESS, REFERENCES, INDEX, ALTER, SHOW DATABASES, CREATE TEMPORARY TABLES, LOCK TABLES, EXECUTE, REPLICATION SLAVE, REPLICATION CLIENT, CREATE VIEW, SHOW VIEW, CREATE ROUTINE, ALTER ROUTINE, CREATE USER, EVENT, TRIGGER WITH GRANT OPTION。 建议您提前在数据节点上创建具有上述权限的账号。 图4 数据节点可用性检测 测试通过后,单击页面下方的“完成”。 完成创建后,可观察“逻辑库状态”如下: 创建中 创建失败 运行中
  • 使用须知 创建逻辑库时,仅支持关联和DDM实例处于相同VPC的数据节点,且数据节点没有被其他DDM实例使用。DDM将在关联的数据节点上新建数据库,不会影响已有的库表。 创建逻辑库时,同一个逻辑库,MySQL大版本需要相同,不可以混用。 数据节点的规格建议不小于DDM的规格,否则会影响性能。 创建逻辑库时,同一个DDM实例可以创建多个逻辑库。多个逻辑库可关联同一个数据节点,但同一个DDM实例不允许同时关联RDS for MySQL实例和GaussDB(for MySQL)实例。 一个数据节点无法被不同的DDM实例关联。 创建逻辑库时选多个分片的场合,分片名遵循“逻辑库名_xxxx”的命名规则,其中xxxx为从“0000”开始递增的数字。如逻辑库名为“db_cbb5”,总分片数为2,则分片名为“db_cbb5_0000”和“db_cbb5_0001”。 创建逻辑库时,关联的数据节点不能处于只读状态。 DDM在数据节点上创建的内部账号(DDMRW*、DDMR*、DDMREP*)请勿修改和删除,否则会影响业务。 内部账号名称组成规则:固定前缀(DDMRW、DDMR、DDMREP)+数据节点ID取HASH值。 口令规则:口令随机生成,长度最小16,最长32。
  • URI GET /v1/{project_id}/instances/{instance_id}/databases?offset={offset}&limit={limit} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 获取方法请参见获取项目ID。 instance_id 是 String DDM实例ID。 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 索引位置,偏移量。 从第一条数据偏移offset条数据后开始查询,默认为0。 取值必须为数字,且不能为负数。 limit 否 Integer 查询个数上限值。 取值范围:1~128。 不传该参数时,默认值为10。
  • 响应示例 状态码: 200 OK { "databases" : [ { "status" : "RUNNING", "created" : "1642063713625", "name" : "mytestdb170", "shard_mode" : "cluster", "shard_number" : 8, "shard_unit" : 8, "used_rds" : [ { "id" : "c6f68fed9e74478c8679479a07d7d568in01", "status" : "normal", "name" : "rds-test" } ] } ], "total" : 172 } 状态码: 400 bad request { "externalMessage" : "Parameter error.", "errCode" : "DBS.280001" } 状态码: 500 server error { "externalMessage" : "Server failure.", "errCode" : "DBS.200412" }
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 databases Array of GetDatabaseInfo objects 逻辑库相关信息的集合。 total Integer 总条数。 表5 GetDatabaseInfo 参数 参数类型 描述 name String 逻辑库名称。 shard_mode String 逻辑库的工作模式。 cluster表示逻辑库是拆分模式。 single表示逻辑库是非拆分模式。 shard_number Integer 同一种工作模式下逻辑库分片的数量。 status String 逻辑库状态。 created String 逻辑库的创建时间。 used_rds Array of GetDatabaseUsedRds objects 逻辑库关联的RDS实例信息。 shard_unit Integer 单个RDS上的逻辑库分片数。 表6 GetDatabaseUsedRds 参数 参数类型 描述 id String 关联RDS节点ID。 name String 关联RDS名称。 status String 关联RDS状态。 error_msg String 响应信息,若无异常信息则不返回该参数。 状态码: 400 表7 响应Body参数 参数 参数类型 描述 errCode String 业务错误码。 externalMessage String 错误信息。 状态码: 500 表8 响应Body参数 参数 参数类型 描述 errCode String 业务错误码。 externalMessage String 错误信息。