华为云用户手册

系统视图 表6 系统视图 变更类型 序号 名称 变更描述 新增 1 pgxc_session_wlmstat 新增视图。 2 pg_comm_query_speed 新增视图，根据query_id查询发送信息。 3 pgxc_respool_resource_info pgxc_respool_runtime_info pgxc_respool_resource_history gs_respool_resource_info gs_respool_runtime_info 资源监控新增相关视图。 4 pgxc_wait_detail pgxc_lockwait_detail 新增pg_locks增强视图。 修改 5 DBA_PART_INDEXES DBA_PART_TABLES DBA_TAB_PARTITIONS USER_IND_PARTITIONS USER_PART_INDEXES USER_TAB_PARTITIONS 增加相关list分区描述。 6 pgxc_wlm_session_statistics 视图从所有CN查询TopSQL实时信息的逻辑由串行修改为并行，提升性能，功能不变。 7 all_indexes sys和pg_catalog下面的视图all_indexes定义存在问题，不同scheam下存在同名对象的场景下会导致结果集膨胀。

行为变更 表7 行为变更 变更类型 序号 名称 变更描述 修改 1 create index目标表为时序表时 时序表创建的任何索引都会转换为tag表上的双索引，该双索引的索引列为指定的建索引的列。 2 负载管理新增二次管控 负载管理引入二次管控，提供更精细化的管控，FUNCTION、函数和多语句中包含复杂查询的可能触发多次管控，设置enable_transaction_parctl=off可以关闭二次管控，但同时会关闭事务块语句和多语句管控。 3 负载管理autoanalyze纳管 查询触发autoanalyze管控逻辑由不管控修改为管控，设置enable_transaction_parctl=off可以关闭autoanalyze管控。 4 用户监控视图pg_total_user_resource_info CPU/内存资源使用和限制全部修改为用户在集群内的资源使用和资源限制。 CPU、IO、内存监控规格变更：由只监控复杂作业修改为监控所有作业。 CPU监控逻辑变更：由cgroup监控修改为作业CPU监控汇总。 5 审计日志 事务内语句在未设置审计事务但设置审计对应语句类型时，仍进行审计。 DECLARE CURSOR语句在guc参数audit_operation_exec设置select时也进行审计。

GUC参数 表8 GUC参数 变更类型 序号 名称 变更描述 新增 1 space_readjust_schedule 用户、schema空间是否自动校准的参数，默认值：auto，支持范围：off/auto/auto(xxxK/M/G)。 2 space_once_adjust_num 空间管控和空间统计功能中，控制慢速构建与细粒度校准操作中每次处理的文件个数阈值，默认值：300。 3 tag_cache_max_number 该参数用于设置全局哈希表tag cache缓存item的最大阈值，默认值10000000。 4 enable_tagbucket_auto_adapt 该参数用于设置是否开启tagbucket自适应调整，默认值on。 5 cache_tag_value_num 该参数用于在tag列lateread场景时，设置缓存的tag元组数量，默认值60000。 6 buffer_ring_ratio 用于控制行存Ringbuffer的阈值和开关，默认值250，即1/4(250/1000)，与以前逻辑一致。 7 enable_stream_ctescan 新增参数，升级默认关闭，新装默认打开。控制stream计划是否开启share scan功能。 8 behavior_compat_options 新增disable_including_all_mysql选项用于控制MySQL兼容模式下create table like语法是否为including all模式，默认不设置，create table like语法为including_all模式。 9 profile_logging_module 增加GUC参数profile_logging_module配置记录性能日志的类型，升级和新装均默认打开OBS、HADOOP、REMOTE_DATANODE，关闭MD。该参数方法与日志模块开关logging_module相同。 10 object_mtime_record_mode 控制pg_object记录修改时间的行为，默认保持老版本行为，新增选项可控制不记录分区/truncate/grant/revoke。 11 skew_option 控制是否使用优化策略。 12 ddl_lock_timeout 配置ddl锁超时的时间。 修改 13 rewrite_rule 新增选项orconversion，默认打开。 使用等值关联的OR条件优化规则。变更点：计划从nestloop转到hashjoin。 新增选项projection_pushdown，默认打开。 变更点：子查询/CTE/视图中未使用的列被优化删除。 14 max_process_memory 初始化安装时OM设置max_process_memory公式为：可用内存*0.7/(1+DN数)，其中系数0.7改为0.8。老集群升级、扩容等场景不变。 15 enable_bloom_filter 复用原参数，现用于控制列存BloomFilter，默认值不变（打开）。 16 retry_ecode_list 默认值新增45003，主要是处理list分区表查询和add分区并发场景下，查询分区可能错位的问题。 17 auth_iteration_count 将默认值从50000减少到10000，新装、升级均会修改。参数表示客户端和服务端密码哈希迭代次数。

系统表 表4 系统表 变更类型 序号 名称 变更描述 新增 1 rb_added RoaringBitmap中增加一个值。 2 pg_partition pg_partition新增字段boundexprs。 3 pg_relfilenode_size 新增系统表。 4 pg_attribute pg_attribute新增attkvtype列，记录列的kvtype类型。 5 pg_collation 新增一条记录case_insensitive，用于支持大小写不敏感行为。

关键字 表3 关键字 变更类型 序号 名称 变更描述 新增 1 MATERIALIZED with cte as后新增[NOT] MATERIALIZED语法。作为非保留关键字，不影响其作为其他对象名，作为列别名时需要加AS。 2 time_fill 用于时间填充表达式输出time_fill列，作为关键字，不能用作函数名和自定义数据类型名。 3 fill_first/fill_last/fill_avg 用于时间填充表达式，输出填充列，作为关键字，不能用作函数名和自定义数据类型名。 4 list 用于指定分区表类型，作为非保留关键字，不影响其作为其他对象名，作为列别名时需要加AS。 5 tsfield/tstag/tstime 用于指定时序表kvtype类型，作为非保留关键字，不影响其作为其他对象名，作为列别名时需要加AS。

系统函数 表5 系统函数 变更类型 序号 名称 变更描述 新增 1 rb_build 将int数组转成一个bitmap类型。 2 rb_to_array rb_build的逆向操作，把RoaringBitmap转成int数组。 3 rb_and 两个RoaringBitmap做交集操作。 4 rb_or 两个RoaringBitmap做并集操作。 5 rb_xor 两个RoaringBitmap做异或操作。 6 rb_andnot 两个RoaringBitmap做and后取反。 7 rb_cardinality 计算一个RoaringBitmap的基数。 8 rb_and_cardinality 计算两个RoaringBitmap求and以后的基数。 9 rb_or_cardinality 计算两个RoaringBitmap求or以后的基数。 10 rb_xor_cardinality 计算两个RoaringBitmap求xor以后的基数。 11 rb_andnot_cardinality 计算两个RoaringBitmap求andnot以后的基数。 12 rb_is_empty 判断一个RoaringBitmap是否为空。 13 rb_equals 判断两个RoaringBitmap是否相等。 14 rb_intersect 判断两个RoaringBitmap是否相交。 15 rb_contain 判断第一个RoaringBitmap是否包含指定的值。 16 rb_add RoaringBitmap中增加一个值。 17 rb_remove RoaringBitmap中删除一个值。 18 rb_flip 翻转指定范围的RoaringBitmap。 19 rb_min 求一个RoaringBitmap的最小值。 20 rb_max 求一个RoaringBitmap的最大值。 21 rb_rank 返回Bitmap中小于等于指定Offset的基数。 22 rb_contain_rb 判断第一个RoaringBitmap是否包含第二个roaringbitmap。 23 rb_containedby_rb 判断第二个RoaringBitmap是否包含第一个roaringbitmap。 24 rb_containedby 判断指定的值是否被指定的roaringbitmap包含。 25 rb_iterate 返回RoaringBitmap对应的int 。 26 rb_and_agg 将RoaringBitmap列按照and逻辑做聚合。 27 rb_or_agg 将RoaringBitmap列按照or逻辑做聚合。 28 rb_xor_agg 将RoaringBitmap列按照xor逻辑做聚合。 29 rb_and_cardinality_agg 将RoaringBitmap列按照and逻辑做聚合后的基数。 30 rb_or_cardinality_agg 将RoaringBitmap列按照or逻辑做聚合后的基数。 31 rb_xor_cardinality_agg 将RoaringBitmap列按照xor逻辑做聚合后的基数。 32 rb_build_agg 将int列聚合成RoaringBitmap类型数据。 33 pgxc_wlm_readjust_relfilenode_size_table() 空间统计校准函数，不重建PG_RELFILENODE_SIZE系统表，重新校准用户和schema空间。 34 gs_table_distribution() 快速查询系统中表大小的函数。 35 pg_obs_cold_refresh_time 修改obs多温表自动切换任务时间。 36 gs_clean_tag_relation 清理tag表中无用的tagid行数据。该函数入参为时序表OID，每个分区遍历cudesc表tagid列的最小值，从而得到整个时序表tagid的最小值。 37 proc_drop_partition 用于将分区boundary时间超过TTL的分区进行drop。 38 proc_add_partition 用于为分区表创建分区。 39 pg_collation_actual_version 返回ICU排序规则的实际版本号。 40 first 分组内第一个元素。 41 last 分组内最后一个元素。 42 mode 分组内出现频率最高的值。 43 delta 相邻两行的差值。 44 percentile_of_value 近似百分位的值。 45 value_of_percentile 近似百分位。 46 spread 分组内最大值和最小值的差值。 47 pg_flush_buffers 刷出所有行存脏页。 修改 48 pg_stat_activity系列视图 pg_stat_get_activity_with_conninfo、pg_stat_activity、pgxc_stat_activity、pg_stat_get_activity视图新增stmt_type和lwtid列。 49 pg_authid系统表新增两行 新增pg_role_signal_backend，pg_role_read_all_stats预置角色。 50 vac_fileclear_relation 可以返回指定表真实清理文件的数量，不清理返回0。 51 vac_fileclear_all_relation 可以返回所有列存表真实清理文件的数量，不清理则返回0。

8.2.1.220 表4 8.2.1.220新增功能/解决问题列表 类别 功能或问题描述 问题原因 问题出现版本 修复建议 新增功能 MERGE INTO支持指定分区。 支持plan management。 GDS导出外表支持容错参数compatible_illegal_chars。 窗口函数last_value支持ignore nulls功能。 - - - 解决问题 SQL执行性能不稳定，查询很慢，查询pgxc_thread_wait_status状态长时间是HashJoin - nestloop。 执行nestloop时每组partition行数有近10000，由于数据都不一样，但是仍继续执行nestloop。 8.1.3.300 升级到8.2.1.220版本。 数据库下有大量对象，普通用户查询该数据下的对象时，出现性能慢，且占用大量内存。 性能慢主要因为：列存模式下，有大量的internal_mask选项的表，导致权限校验函数被无效调用；列权限校验耗时长，导致计算量大。 8.2.1.119以前版本 表达式过多的场景，LLVM编译时间长导致CPU高。 启用LLVM时，在表达式过多的场景下，执行需要几个小时，关闭LLVM后只需十几分钟。当表达式个数多于1000时，会产生编译时间指数级递增的问题。 8.1.3.320 业务查询游标每次fetch2000笔数据，每次获取都比上次估算内存大了24MB，总数据量2000W条，查询无法执行。 PBE场景会复用之前生成的计划，导致估算内存每次递增一个固定值，估算内存不断膨胀导致CCN排队。 8.1.3.323 JSON类型查询内存泄露，导致重分布占用大量内存。 在jsonb的out函数中存在内存未释放问题，数据量大时出现堆积造成使用内存高。 8.1.3.x 执行客户业务sql，只要执行select * from with子句就会出现CN core。 ProjectionPushdown更新了rte，但是未基于新的rte更新var，导致后面处理quals的时候core。 8.1.3.323 DELETE语句WHERE条件数超过上限导致溢出。 DELETE语句WHERE条件数超过int16上限（32767）导致溢出，越界产生core。 8.1.2.x 扩容时重新拉起重分布进程，生成表清单的时候，卡住1小时以上。 生成表清单语句是查询系统表后插入pgxc_redistb，pgxc_redistb是分布式表，查询系统表都是在CN上执行，再插入分布式表时每条记录都要执行一个INSERT INTO ... VALUES语句，如果表数量非常大会非常耗时。 8.1.3.110 主键冲突事务回滚导致CN内存泄漏。 JDBC中使用PBE协议插入数据走CN轻量化，因主键冲突等原因执行报错。 一个事务内包含多个交叉CN轻量化查询，或者JDBC发送的unnamed statement，执行前会将全局的LightProxy对象保存到Portal上，事务结束场景LightProxy对象未释放造成内存堆积。 表现为CN的pv_session_memory_detail视图中查询到大量CachedPlanQuery内存上下文。 8.2.0.103 count distinct和union all场景下，实际使用内存大量超过估算内存。 多分支串行执行场景只考虑了下层算子返回数据时的内存，未考虑下层算子实际执行过程中的内存，导致内存估算偏小。 8.1.3.321 重启集群后，只有首次使用SQL调试的会话连接可以正常进行SQL调试，其他会话连接无法正常调试。DataStudio调试SQL打断点不生效。 调度入口变量在与数据库断开连接后会被释放，后续为空指针，无法进入调试逻辑。 8.1.1.x 8.1.3.x with recursive语句长时间运行未结束。 ARM环境下线程信息同步问题，导致变量更新不同步。 8.1.3.323 执行INSERT OVERWRITE指定分区，会覆盖全表。 PBE逻辑中拷贝计划信息时，没有拷贝INSERT OVERWRITE中的分区信息，导致最终对全表进行了FILENODE交换。 8.2.1.220以前版本 包含windowagg的子查询结果集异常。 生成bloomfilter过程中，没有考虑windowsagg，在join关联列非windowsagg分组列的场景下会减少分组数据，进而对窗口函数该分组的结果产生影响。 8.1.3.x 业务出现大量内存不足报错，视图显示占用内存高的SQL均为VACUUM FULL操作。 分区表在对每个分区分别进行VACUUM FULL时，漏掉了一部分内存的释放操作，导致内存不断累加和膨胀，直至报错。 8.1.3.x 逻辑集群执行重启超时。 CM内部默认使用了10个ip，需要动态适配。 8.2.1.200 更新版本后出现大量Wait poll time out错误。 LibcommCheckWaitPoll函数在传入-1时行为与预期不一致。 8.2.1.200

8.2.1.223 表3 8.2.1.223新增功能/解决问题列表 类别 功能或问题描述 问题原因 问题出现版本 修复建议 新增功能 无 - - - 解决问题 集群hang检测触发集群切换。 信号重构前线程之前主要使用SIGUSR2这个不可靠信号用于IPC，重构后使用了可靠信号34、35两个信号。 在信号发送数量巨大的情况下，可靠信号的使用加大了timer创建失败的概率。 8.2.1.220 升级到8.2.1.223版本。 业务并发pgxc_cgroup_reload_conf出现core：GsCgroupIsClass。 指针访问未加锁，当reload函数重新加载该访问变量后，指针被修改，导致访问到野指针，导致core问题。 8.2.1.220 gs_table_distribution函数获取的表大小与真实值差距较大。 在分批读取pg_refilenode_size系统表的数据后进行计算时，当前批次计算得到的表大小会重复累加前面几批计算得到的表大小，导致gs_table_distribution函数获取的表大小与真实值差距较大。 8.2.1.220 执行SQL语句报错：Could not open file "pg_clog/000000000075"。 列存表进行VACUUM FULL后可能提前回收clog，导致主备切换后进行ANALYZE时无法访问clog文件。 8.2.1.119 修复临时变量未初始化导致的freememory大负数问题。 临时变量声明后，未赋值导致参数值非预期，后续再去扣减内存，出现大负数。 8.2.1.220 智能运维配置VACUUM FULL后，VACUUM FULL实际执行时间超过配置的时间区间。 调度器kill VACUUM FULL任务时插入了新的running任务，导致kill没有执行干净。 8.1.3.x

8.2.1.119 表5 8.2.1.119新增功能/解决问题列表 类别 功能或问题描述 问题原因 问题出现版本 修复建议 新增功能 窗口函数last_value支持ignore nulls功能，兼容Redshift。 - - - 解决问题 列存表使用try_cast函数报错。 try_cast函数未适配向量化执行引擎，导致列存表执行时报错。 8.2.1.100及以下版本 升级到8.2.1.119。 重启集群后，insert过慢长时间无法结束。 重启集群后，insert时需要使用索引扫描全量数据而影响性能。 8.2.1.100及以下版本 CCN计数异常时，未触发校准机制，导致CCN排队加剧。 CCN计数异常时，由于代码处理bug，未触发校准机制。 8.2.1.100及以下版本 JDBC中使用PBE协议插入数据，因主键冲突报错导致CN内存泄漏。 此场景下使用CN轻量化流程进行处理，事务结束后轻量化对象未释放造成内存堆积。 8.2.1.100及以下版本 SQL语句中设置了enable_stream_ctescan的GUC HINT，生成计划时CTE估算内存超阈值后，生成计划有误导致执行失败。 SQL语句中设置了enable_stream_ctescan的GUC HINT后，生成计划时CTE估算内存超阈值后，回退成非share scan的计划，但由于包含Hint回退不彻底，生成的计划包含错误节点，导致后续执行失败。 8.2.1.100及以下版本 备份metadata元数据到OBS上超过64MB时，恢复时概率性解压元数据报错，导致恢复失败。 备份metadata元数据超过64MB时，从OBS下载需要分段下载，下载最后一段buffers由于代码漏洞导致被丢弃，下载的metadata损坏，导致无法解压。 8.2.1.100及以下版本 hstore delta表analyze采样占用内存高。 hstore delta表analyze采样时，delta合并I记录占用内存较多，需要即时释放toast数据及delta数据反序列化占用的空间。 8.2.1.100及以下版本 CTE查询中有volatile函数，且只被引用一次时，不能下推，导致查询性能差。 821版本增加CTE查询中有volatile函数时不能下推的约束，但针对CTE只被引用一次的场景，需要放开约束，支持其下推。 8.2.1.100及以下版本 复杂查询的临时文件下盘，xfs系统预占空间过大，下盘文件多时导致集群只读。 复杂查询的临时文件下盘，xfs系统每个下盘文件预占16MB，下盘文件多时导致集群只读，需要减少下盘文件预占磁盘量。 8.2.1.100及以下版本

8.2.1.230 表1 8.2.1.230新增功能/解决问题列表 类别 功能或问题描述 问题原因 问题出现版本 修复建议 新增功能 细粒度备份恢复支持在线DDL：支持在细粒度备份过程期间对表进行DDL操作。 - - - 细粒度表级恢复支持恢复至异构集群：细粒度表级恢复不再受目标集群必须与恢复集群的拓扑结构一致的约束。 - - - 细粒度备份恢复支持跨版本恢复。 - - - 集群级物理细粒度备份以及schema级物理细粒度备份支持备份权限与注释。 - - - 在线扩容重分布阶段支持动态调整优先级。 - - - 解决问题 Catchup与DDL业务锁冲突，Catchup持续长时间不结束。 存储过程中如果存在DDL操作，在事务提交前，存在几率导致Catchup无法结束，报锁超时。 8.0.x 升级到8.2.1.230版本。 With recursive语句长时间运行未结束。 ARM环境中线程信息同步问题，导致变量更新不同步。 8.1.3.322 gs_wlm_readjust_relfilenode_size_table内存占用大 pg_relfilenode_size表完全加载到内存中，占用内存过大。 8.1.3.323 集群长时间运行TopMemoryContext内存不断累积增大。 stream线程在返回线程池时并不会立即释放内存，导致长时间运行时TopMemoryContext内存不断累积增大。 8.2.1.22 SQL语句执行异常终止，报错：canceling statement due to coordinator request. 带有stream算子语句执行时报错，向子stream线程发出cancel，此时stream线程已经回到了stream线程池。下一条query语句复用了该stream线程，因为缺少对query id的强一致校验，响应了上一条语句残留的信号，导致语句被异常终止。 8.1.3.110 schema空间查询，usedspace大于permspace。 在判断schema空间上限时，采用已用空间对比空间上限，导致实际使用会超出上限。 8.2.1.230以前版本 参数max_files_per_node设置为-1业务执行失败。 SQL执行过程中在创建stream线程阶段，会先读取配置参数max_files_per_node值，默认值为50000， 然后报错句柄超上限。 因此即使设置了guc的值为-1，但是guc的值未生效。 8.1.3.321 SQL执行报错：Stream plan check failed. Execution datanodes list of stream node mismatch in parent node. 生成计划时下层的计划节点复用了上层的计划节点，导致修改一个计划节点时修改了所有的节点。 8.2.1.230以前版本 扩容重分布阶段，不开启xc_maintenance_mode无法终止业务语句 扩容重分布阶段，限制为xc_maintenance_mode开启才能执行pg_cancel_query/ pg_cancel_backend等函数，导致重分布阶段，用户业务语句无法成功杀语句。 8.2.1.230以前版本

8.2.1.225 表2 8.2.1.225新增功能/解决问题列表 类别 功能或问题描述 问题原因 问题出现版本 修复建议 新增功能 无 - - - 解决问题 GDS非法字符替换异常 GDS非法字符替换为特殊字符（�）时出现异常，替换过程中由于字符串长度发生变化，在后续处理时仍使用原长度，导致部分字符被截断，无法正确替换。 8.2.1.225以前版本 升级到8.2.1.225版本。 并发压测过程中，概率性出现gather性能劣化 当语句中存在stream算子时，在DN上会根据计划生成多个stream线程，其中最顶层的父线程为topConsumer线程，负责将子stream线程的数据整合并发送往CN。当语句执行结束时，topConsumer线程必须等待所有的子stream线程退出后才可以执行stream线程组的清理动作。 8.2.1.225以前版本

8.3.0集群版本数据库接口删除表 表1 日落系统函数和视图 类型 名称 说明 函数 pg_sync_cstore_delta(text) 列存merge delta表数据至主表，已废弃。由VACUUM DELTAMERGE xxx语法替代。 pg_sync_cstore_delta 列存merge delta表数据至主表，已废弃。由VACUUM DELTAMERGE xxx语法替代。 pgxc_pool_check 检查连接池中缓存的连接数据是否与pgxc_node一致，已废弃。 pg_delete_audit 删除审计日志函数，已废弃。不允许手动删除审计日志。 pg_log_comm_status 当前节点SCTP通信层内部结构的日志记录状态，已废弃。 pgxc_log_comm_status 所有节点SCTP通信层内部结构的日志记录状态，已废弃 signal_backend 已废弃。 pg_stat_get_realtime_info_internal 获取query级别的实时topsql信息，已废弃。由PGXC_WLM_SESSION_STATIS TICS 视图代替。 pg_stat_get_wlm_session_info_internal 获取query级别的topsql信息，已废弃。由pg_stat_get_wlm_realtime_session_info函数代替。 pg_stat_get_wlm_session_info 获取session信息，已废弃。由PGXC_WLM_SESSION_INFO视图代替。 pg_stat_get_wlm_statistics 获取session信息，已废弃。由PGXC_WLM_SESSION_INFO视图代替。 pg_user_iostat 获取用户的io信息，已废弃。由PGXC_TOTAL_USER_RESOURCE_INFO视图代替。 pg_stat_get_wlm_session_iostat_info 获取query的io信息，已废弃。由PGXC_WLM_SESSION_STATISTI CS 视图或PGXC_WLM_SESSION_INFO视图替代。 系统视图 gs_wlm_session_info_all 获取session信息，已废弃。由PGXC_WLM_SESSION_INFO代替。 pg_wlm_statistics 显示作业结束后或已被处理异常后的负载管理相关信息，已废弃。由PGXC_WLM_SESSION_INFO视图替代。 pg_session_iostat 获取session的io信息，已废弃。由PGXC_WLM_SESSION_STATISTICS视图替代。

9.1.0集群版本数据库接口删除表 表2 日落数据库接口 类型 名称 说明 扩展 file_fdw 本地文件访问，已废弃。 外部服务器 gsmpp_errorinfo_server 读取导入错误表数据，已废弃。访问导入错误表已不再需要gsmpp_errorinfo_server。 逻辑复制 pg_create_logical_replication_slot 创建逻辑复制槽，9.1.0.200已废弃。逻辑复制特性已废弃。 逻辑复制 pg_logical_slot_peek_changes 解码并不推进流复制槽，9.1.0.200已废弃。逻辑复制特性已废弃。 逻辑复制 pg_logical_slot_get_changes 解码并推进流复制槽，9.1.0.200已废弃。逻辑复制特性已废弃。

响应示例 状态码： 200 OK { "instanceId" : "1f5c9fd6cd984056ba89c8c87cc03278in09", "jobId" : "6f1334ca-faa6-479e-837f-f3219192675e"} 状态码： 400 bad request { "externalMessage" : "Parameter error.", "errCode" : "DBS.280001"} 状态码： 500 server error { "externalMessage" : "Server failure.", "errCode" : "DBS.200412"}

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 instanceId String DDM实例ID。 jobId String 任务ID。 状态码： 400 表4 响应Body参数 参数 参数类型 描述 errCode String 业务错误码。 externalMessage String 错误信息。 状态码： 500 表5 响应Body参数 参数 参数类型 描述 errCode String 业务错误码。 externalMessage String 错误信息。

请求示例 创建DDM实例组，组类型：读写，节点数为1个。 POST https://{endpoint}/v3/{project_id}/instances/{instance_id}/groups{ "name": "group-1", "type": "rw", "flavor_id": "a615922f-0ed8-3691-aad4-a595185febba", "nodes": [ { "available_zone": "az1", "subnet_id": "ead1e945-ca89-45dd-bcce-4a30b2054c22" } ]}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用 IAM 服务的“获取用户Token”接口来获取。 表3 请求Body参数 参数 是否必选 参数类型 描述 name 是 String DDM实例组名称，命名要求如下。 长度为4-64个字符。 必须以字母开头。 可以包含字母、数字、中划线、下划线、不能包含其它特殊字符。 最小长度：4 最大长度：64 type 是 String 实例组的类型。 rw：读写组 r：只读组 flavor_id 是 String 规格ID。 nodes 是 Array of 表 NodeInfo objects 节点信息列表。 最小：1 最大：32 表4 NodeInfo 参数 是否必选 参数类型 描述 available_zone 是 String 节点可用区。取值非空，请参见地区和终端节点。 subnet_id 是 String 子网ID。

响应消息 正常响应参数说明 表5 响应Body参数 参数 参数类型 描述 job_id String 创建组的任务ID。 仅创建按需实例时会返回该参数。 order_id String 订单号，创建包年包月时返回该参数。 group_id String 组ID。 仅创建按需实例时会返回该参数。 正常响应示例 按需： { "job_id": "3ae783f3-844e-4051-abd5-b9cc65899785", "group_id": "b4153b807b1a4f83870bf868fcc4f4ea****" } 包周期： { "order_id" : "CS1810251738L8VVD"} 异常响应 请参见异常请求结果。

响应消息 正常响应参数说明 表3 响应Body参数 参数 参数类型 描述 total_count Integer 总条数。 physical_processes Array of 表4 objects 实例的物理会话列表。 表4 PhysicalProcessInfo 参数 参数类型 描述 id Long 物理会话ID。 user String 当前连接的用户。 host String 所属的IP和端口。 db String 数据库名。 command String 连接状态，一般是休眠或空闲（sleep），查询（query），连接（connect）。 time Long 连接状态持续的时间，单位是秒（s）。 state String 当前SQL语句的状态。 info String 当前所执行的SQL语句。 trx_executed_time Long 事务持续时间，单位是秒（s）。 正常响应示例 { "physical_processes": [ { "id": 1973, "user": "DDMRW1613058863", "host": "172.16.241.84:58908", "db": "ddm_db_test_0001", "state": "", "command": "Sleep", "info": null, "time": 13977, "trx_executed_time": 0 } ], "total_count": 1} 异常响应 请参见异常请求结果。

URI URL格式 GET /v3/{project_id}/instances/{instance_id}/physical-processes?offset={offset}&limit={limit} 参数说明 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户在某一region下的project ID。 获取方法请参见获取项目ID。 instance_id 是 String 关联RDS实例ID。 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 索引位置，偏移量。 从第一条数据偏移offset条数据后开始查询，默认为0。 取值必须为数字，且不能为负数。 limit 否 Integer 查询个数上限值。 取值范围：1~128。 不传该参数时，默认值为10。 keyword 否 String 会话结果筛选关键字，支持返回结果全字段模糊匹配，长度最大255。

URI URL格式 POST /v3/{project_id}/instances/{instance_id}/database-version/rollback-version 参数说明 表1 参数说明 参数 是否必选 参数类型 描述 project_id 是 String 租户在某一region下的project ID。 获取方法请参见获取项目ID。 instance_id 是 String DDM实例ID。

响应消息 正常响应参数说明 表3 响应Body参数 参数 参数类型 描述 instance_id String DDM实例ID。 job_id String 回滚内核版本的任务ID。 正常响应示例 { "instance_id" : "28e8841d0b9c4f6a9a30742ee60e1055****", "job_id" : "1eb697c0-1842-43a3-8671-f562d038****"} 异常响应 请参见异常请求结果。

响应示例 状态码： 200 OK { "database" : { "name" : "db_7567", "created" : "1604631243234", "status" : "RUNNING", "updated" : "1604631243234", "databases" : [ { "id" : "e70a82534a364492b795c5080e3a1591in01", "name" : "db_7567_0000", "idName" : "db_7567_0000", "dbslot" : 0, "status" : "RUNNING", "created" : 1604631243234, "updated" : 1604631243234 }, { "id" : "e70a82534a364492b795c5080e3a1591in01", "name" : "db_7567_0001", "idName" : "db_7567_0001", "dbslot" : 1, "status" : "RUNNING", "created" : 1604631243234, "updated" : 1604631243234 }, { "id" : "e70a82534a364492b795c5080e3a1591in01", "name" : "db_7567_0002", "idName" : "db_7567_0002", "dbslot" : 2, "status" : "RUNNING", "created" : 1604631243234, "updated" : 1604631243234 }, { "id" : "e70a82534a364492b795c5080e3a1591in01", "name" : "db_7567_0003", "idName" : "db_7567_0003", "dbslot" : 3, "status" : "RUNNING", "created" : 1604631243234, "updated" : 1604631243234 }, { "id" : "e70a82534a364492b795c5080e3a1591in01", "name" : "db_7567_0004", "idName" : "db_7567_0004", "dbslot" : 4, "status" : "RUNNING", "created" : 1604631243234, "updated" : 1604631243234 }, { "id" : "e70a82534a364492b795c5080e3a1591in01", "name" : "db_7567_0005", "idName" : "db_7567_0005", "dbslot" : 5, "status" : "RUNNING", "created" : 1604631243234, "updated" : 1604631243234 }, { "id" : "e70a82534a364492b795c5080e3a1591in01", "name" : "db_7567_0006", "idName" : "db_7567_0006", "dbslot" : 6, "status" : "RUNNING", "created" : 1604631243234, "updated" : 1604631243234 }, { "id" : "e70a82534a364492b795c5080e3a1591in01", "name" : "db_7567_0007", "idName" : "db_7567_0007", "dbslot" : 7, "status" : "RUNNING", "created" : 1604631243234, "updated" : 1604631243234 } ], "shard_mode" : "cluster", "shard_number" : 8, "shard_unit" : 8, "dataVips" : [ "192.168.185.97:5066" ], "used_rds" : [ { "id" : "e70a82534a364492b795c5080e3a1591in01", "name" : "rds-5338", "status" : "normal" } ] }} 状态码： 400 bad request { "externalMessage" : "Parameter error.", "errCode" : "DBS.280001"} 状态码： 500 server error { "externalMessage" : "Server failure.", "errCode" : "DBS.200412"}

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 database GetDatabaseResponseBean object 逻辑库信息。 表4 GetDatabaseResponseBean 参数 参数类型 描述 name String 逻辑库名称。 created Long 逻辑库的创建时间。 status String 状态。 updated Long 逻辑库最后更新时间。 databases Array of GetDatabases objects 逻辑库分片的详细信息。 shard_mode String 逻辑库的工作模式。 cluster表示逻辑库是拆分模式。 single表示逻辑库是非拆分模式。 shard_number Integer 同一种工作模式下逻辑库分片的数量。 shard_unit Integer 单个RDS上的逻辑库分片数。 dataVips Array of strings 连接逻辑库使用的IP:端口。 used_rds Array of GetDatabaseUsedRds objects 关联RDS。 表5 GetDatabases 参数 参数类型 描述 dbslot Integer 分片数。 name String 分片名称。 status String 逻辑库状态。 created Long 创建时间。 updated Long 最近更新时间。 id String 所在RDS的ID。 idName String 物理库的名称。 表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 错误信息。

URI GET /v1/{project_id}/instances/{instance_id}/databases/{ddm_dbname} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 获取方法请参见获取项目ID。 instance_id 是 String DDM实例ID。 ddm_dbname 是 String 需要查询的逻辑库名称，不区分大小写。

DDM实例管理 表1 DDM实例管理 权限 对应API接口 授权项 IAM项目（Project） 企业项目 （Enterprise Rroject） 购买DDM 实例（按需） 购买DDM 实例（包周期） POST /v1/{project_id}/instances ddm:instance:create 购买实例操作依赖以下权限，即要配置购买实例权限，必须配置以下依赖的权限，否则购买失败。 ecs:*:get* ecs:*:list* vpc:vpcs:list vpc:securityGroups:get vpc:subnets:get ecs:cloudServerNics:update ecs:serverInterfaces:use 全局/区域级指定vpc:ports:* BSS Finance、BSS Operator系统策略 只有购买实例（包周期）操作才依赖这个权限，购买实例（按需）不需要。 √ √ 查询DDM实例列表 GET /v1/{project_id}/instances?offset={offset}&limit={limit} ddm:instance:list √ √ 查询DDM实例详细信息 GET /v1/{project_id}/instances/{instance_id} ddm:instance:get vpc:*:get* vpc:*:list* √ √ 修改DDM实例 PUT /v1/{project_id}/instances/{instance_id} ddm:instance:modify 修改安全组操作依赖以下权限，即要修改安全组权限，必须配置以上依赖的权限，否则修改失败。 vpc:*:get* vpc:*:list* vpc:ports:update vpc:securityGroups:get √ √ 重启DDM实例 POST /v1/{project_id}/instances/{instance_id}/action ddm:instance:reboot √ √ 删除DDM实例 DELETE /v1/{project_id}/instances/{instance_id}?delete_rds_data=true ddm:instance:delete vpc:ports:delete √ √ “√”表示支持，“×”表示暂不支持。 父主题： 授权策略及授权项

响应示例 状态码： 200 ok { } 状态码： 400 bad request { "externalMessage" : "Parameter error.", "errCode" : "DBS.280001"} 状态码： 500 server error { "externalMessage" : "Server failure.", "errCode" : "DBS.200412"}

规格列表 DDM实例规格，详见如下列表，具体规格请以实际环境为准。 表1 实例规格列表 规格码 CPU 内存 架构 ddm.c6.2xlarge.2 8 16 X86 ddm.c6.4xlarge.2 16 32 X86 ddm.c6.8xlarge.2 32 64 X86 ddm.kc1.2xlarge.2 8 16 ARM ddm.kc1.4xlarge.2 16 32 ARM ddm.kc1.8xlarge.2 32 64 ARM 父主题： 附录

操作步骤 指定limit与offset查询DDM实例列表。 接口相关信息 URI格式： GET /v1/{project_id}/instances 详情请参见查询DDM实例列表。 请求示例 GET: https://{endpoint}/v1/743b4c0428d945316666666666666666/instances?offset=0&limit=1 {endpoint}信息请从地区和终端节点获取。 limit值可根据DDM实例数据调整。 响应示例 {"instance_num":10,"instances":[{"id":"cab932b426ed4215a8d76b9d71322661in09","status":"RUNNING","name":"ddm-20-single-2u4g-1-202010231552401522260","created":"2020-10-23T07:52:46+0000","updated":"2020-10-23T07:59:56+0000","available_zone":"az1xahz","vpc_id":"9cf0f8f5-9748-4ebb-9905-bbe429182bd6","subnet_id":"b35a4be7-65a5-4176-bec9-7a437493c498","security_group_id":"9d10da6d-38cc-4cf0-8f96-c34940a3fd15","node_count":1,"access_ip":"192.168.60.13","access_port":"5066","core_count":"2","ram_capacity":"4","node_status":"RUNNING","enterprise_project_id":"0","project_id":"070c071d8e80d58c2f42c0121b10cf9f","engine_version":"2.5.10.10222119"}],"page_no":1,"page_size":1,"total_record":10,"total_page":10} 汇总查询结果。 参考1持续调用，如果查询的DDM实例列表为空，或者返回的body体中不存在instances字段，表明所有DDM实例查询完成。 汇总所有查询到的DDM实例即当前查询条件下的所有DDM实例。

DDM账号管理 表1 DDM账号管理 权限 对应API接口 授权项 IAM项目（Project） 企业项目 （Enterprise Rroject） 创建DDM账号 POST /v1/{project_id}/instances/{instance_id}/users ddm:user:create √ √ 查询DDM账号列表 GET /v1/{project_id}/instances/{instance_id}/users?offset={offset}&limit={limit} ddm:user:list √ √ 修改DDM账号 PUT /v1/{project_id}/instances/{instance_id}/users/{username} ddm:user:modify √ √ 删除DDM账号 DELETE /v1/{project_id}/instances/{instance_id}/users/{username} ddm:user:delete √ √ 父主题： 授权策略及授权项