华为云用户手册

DDL语法 拆分表和广播表不支持外键。 不支持修改分片字段（拆分键）。 不支持ALTER DATABASE Syntax。 不支持从另一张表创建新的拆分表、广播表。 create table不支持generated column语法。 不支持ALTER命令修改拆分键和全局序列字段。 不支持创建TEMPORARY类型的拆分表、广播表。 逻辑表名只允许字母(不区分大小写)数字以及下划线。 不支持CREATE TABLE tbl_name LIKE old_tbl_name。 不支持CREATE TABLE tbl_name SELECT statement。 不支持insert into on duplicate key update 更新拆分键值。 暂不支持跨Schema的DDL, 例如， CREATE TABLE db_name.tbl_name (… )。 使用MySQL关键字或保留字做表名、列名、索引名等标识符时，需要使用反引号扩起来。

操作步骤 登录 分布式数据库 中间件控制台。 在源DDM实例所在区域创建一个新的DDM实例或者寻找一个满足使用条件的DDM实例。创建DDM实例的步骤参见购买数据库中间件实例。 新建的DDM实例或者满足使用条件的已有实例均不能挂载RDS for MySQ L实例 ，不能创建逻辑库和账号。 在云数据库 RDS控制台，创建与源DDM实例下相同数量的RDS for MySQL实例。 新创建的RDS for MySQL实例版本不得低于源DDM下RDS for MySQL实例版本号。 每个实例存储空间不得小于源DDM实例下的RDS for MySQL的存储空间。 返回分布式数据库中间件控制台，在DDM实例列表页面单击需要恢复的实例名称，进入实例基本信息页面。 在左侧导航栏选择“备份恢复”，进入恢复数据页面。 单击“恢复新实例”按钮。 图1 基本信息页 在恢复新实例页签中，设置可恢复时间段、可恢复时间点、目标DDM和目标DN实例。 图2 设置恢复信息 表1 参数说明 参数名称 说明 可恢复时间段 选择恢复时间段。 可恢复时间点 选择恢复时间点。 DDM会检测与DDM实例关联的DN实例在选中的可恢复时间点上是否存在备份。 目标DDM 选择2中创建的DDM实例作为目标实例。 DN实例映射 选择3中创建的RDS for MySQL实例作为目标DN实例。 勾选确认信息复选框，单击页面右下角“确定”，恢复时长和实例的数据量有关，平均恢复速率为100MB/s。实例如果关联了多个dn，dn之间并行恢复。

示例流程 图1 授权DDM权限流程 创建用户组并授权 在 IAM 控制台创建用户组，并授予关系型数据库只读权限“DDM ReadOnlyAccess”。 创建用户并加入用户组 在IAM控制台创建用户，并将其加入1中创建的用户组。 用户登录并验证权限 新创建的用户登录控制台，切换至授权区域，验证权限： 在“服务列表”中选择分布式数据库中间件服务，进入DDM主界面，单击右上角“购买分布式数据库中间件实例”，尝试购买分布式数据库中间件实例，如果无法购买分布式数据库中间件实例（假设当前权限仅包含DDM ReadOnlyAccess），表示“DDM ReadOnlyAccess”已生效。 在“服务列表”中选择除分布式数据库中间件服务外（假设当前策略仅包含DDM ReadOnlyAccess）的任一服务，若提示权限不足，表示“DDM ReadOnlyAccess”已生效。

批量设置读权重 登录分布式数据库中间件控制台。 在实例管理列表页面，选择目标实例。 单击实例名称，进入基本信息页面。 在左侧导航栏，选择“DN管理”页签，单击上方的“设置读权重”。 图1 DN管理 设置实例的读权重。 在批量设置的弹窗中，“同步”功能可以用来将第一个实例的读权重设置同步到其他的实例上。此操作需满足所有实例的只读实例数量一致才可以实行。 如果有实例的只读实例数量与其他实例不一致，则无法使用“同步”功能，需手动设置各个实例的读权重。 读权重可支持的设置范围为0~100。 只读实例挂载后默认承载全部可分离的只读请求，如果需要重新分配读写请求，可通过设置读权重来实现。 设置了实例的读权重后，主实例和只读实例将按照以下公式处理读请求。 主实例处理读请求：主实例读权重/主实例和只读实例读权重总数 只读实例处理读请求：只读实例读权重/主实例和只读实例读权重总数 例如：RDS for MySQL实例有1个主实例和1个只读实例，主实例和只读实例的读权重配置为20、80，则主实例和只读实例将按照1：4比例处理读请求。即主实例处理1/4的读请求，只读实例处理3/4的读请求，写请求自动发往主实例。 读权重设置成功后，在DN管理列表页面将显示最新设置的权重数。

设置单个实例的读权重 登录分布式数据库中间件控制台。 在实例管理列表页面，选择目标实例。 单击实例名称，进入基本信息页面。 在左侧导航栏，选择“DN管理”页签。 单击目标实例操作列“设置读权重”。 图2 单个设置读权重 读权重可支持的设置范围为0~100。 只读实例挂载后默认承载全部可分离的只读请求，如果需要重新分配读写请求，可通过设置读权重来实现。 设置了实例的读权重后，主实例和只读实例将按照以下公式处理读请求。 主实例处理读请求：主实例读权重/主实例和只读实例读权重总数 只读实例处理读请求：只读实例读权重/主实例和只读实例读权重总数 例如：RDS for MySQL实例有1个主实例和1个只读实例，主实例和只读实例的读权重配置为20、80，则主实例和只读实例将按照1：4比例处理读请求。即主实例处理1/4的读请求，只读实例处理3/4的读请求，写请求自动发往主实例。 读权重设置成功后，在DN管理列表页面将显示最新设置的权重数。

DN管理介绍 DN管理提供数据节点管理服务，管理DDM实例关联的RDS for MySQL实例，展现实例的状态、存储、规格、读权重等信息，提供设置读权重、同步DN信息、开启读写分离的快捷操作。 表1 功能介绍 功能 使用场景 同步DN信息 主要用于数据节点相关信息变化时（如增删只读实例，变更连接地址/端口号，规格变更，删除数据节点等操作），将数据节点变化的信息同步到DDM实例上。 开启/关闭读写分离 主要应用于DDM内核版本大于等于3.1.0版本的场景。 DDM内核版本大于等于3.1.0版本时，需要手动开启读写分离，然后调整只读实例和主实例的读写权重来实现读写分离操作。您也可以根据业务场景手动关闭读写分离功能。 如果DDM内核版本小于3.1.0版本，系统默认开启读写分离，只需要调整只读实例和主实例的读写权重即可以实现读写分离操作。此场景下不能关闭读写分离功能。 设置读权重 主要用于调整主实例和只读实例的读写权重，实现读写分离操作。 支持批量设置多个实例的读写权重。 如果数据节点未挂载只读实例，该主实例无法设置权重。 父主题： DN管理

操作步骤 登录分布式数据库中间件控制台。 在实例管理列表页面，选择目标DDM实例，单击实例名称，进入实例基本信息页面。 在左侧导航栏，选择“逻辑库管理”，查看DDM实例逻辑库。 在逻辑库列表页面，单击右侧操作栏的“配置SQL黑名单”。 图1 配置SQL黑名单 在配置SQL黑名单弹窗中，单击“编辑”，按需输入前缀匹配、全量匹配、正则匹配的SQL信息，设置完成后单击“确定”即可。 前缀匹配：禁止在对应逻辑库执行带有某些关键字的SQL语句，例如带有DROP或者DELETE的SQL语句。 全量匹配：禁止在对应逻辑库执行该SQL语句，SQL语句中如果有多个空格或者换行，将不会被替换为单个空格或截断为单个空格来匹配。 正则匹配：禁止在对应逻辑库执行含有该正则表达式的SQL语句。 配置的黑名单SQL之间以英文分号隔开，前缀匹配、全量匹配、正则匹配中的SQL语句大小分别不超过1KB。 如果在配置SQL黑名单弹窗中清除之前编辑的前缀匹配与全量匹配中的SQL语句，并单击“确定”，则表示清空之前配置的SQL黑名单。

实例状态 实例状态是DDM实例的运行情况。用户可以使用管理控制台查看DDM实例状态。 表1 实例状态 分类 状态 说明 正常 运行中 DDM实例正常和可用。 异常 创建失败 DDM实例创建失败。 异常 DDM实例不可用。 部分节点异常 DDM实例部分节点不可用。 备份失败 备份实例失败。 冻结 账户余额小于或等于0元，系统对该用户下的实例进行冻结。您需前往费用中心充值成功，欠款核销后，冻结的实例才会解冻。 动作执行中 创建中 正在创建DDM实例。 备份中 正在备份实例。 恢复中 正在恢复备份到实例中。 升级中 正在进行实例内核版本升级。 回滚中 正在进行实例内核版本回滚。 切换SSL中 正在进行实例SSL切换。 端口修改中 正在修改DDM实例的服务端口。 删除中 正在删除DDM实例。 重启中 正在重启DDM实例。 节点扩容中 正在扩容该实例下的节点个数。 节点缩容中 正在缩容该实例下的节点个数。 规格变更中 正在变更实例的CPU和内存规格。 转包周期中 按需付费实例正在转为包周期实例。 正在创建组 正在为节点创建分组。 正在删除组 正在删除节点分组。 创建逻辑库中 正在创建逻辑库 删除逻辑库中 正在删除逻辑库 父主题： 实例管理

常用语法 table_references: table_reference [, table_reference] ... table_reference: table_factor | join_table table_factor: tbl_name [[AS] alias] | table_subquery [AS] alias | ( table_references ) join_table: table_reference [INNER | CROSS] JOIN table_factor [join_condition] | table_reference {LEFT|RIGHT} [OUTER] JOIN table_reference join_condition | table_reference [{LEFT|RIGHT} [OUTER]] JOIN table_factor join_condition: ON conditional_expr | USING (column_list)

操作步骤 登录分布式数据库中间件控制台。 在实例管理列表页面，单击目标实例操作栏“创建逻辑库”。 图1 创建逻辑库-入口1 您也可以在实例管理列表页面，单击目标实例名称，进入基本信息页面。在左侧导航栏选择逻辑库管理页签，在页面右侧单击创建逻辑库。 图2 创建逻辑库-入口2 在创建逻辑库页面，填选逻辑库模式、逻辑库名称、需要关联的DDM账号、数据节点和逻辑库总分片数。 图3 创建逻辑库 表1 参数说明 参数名称 说明 逻辑库模式 拆分库：一个逻辑库可以关联多个数据节点，分片数均匀的分布在这些数据节点上。 单库：一个逻辑库仅关联一个数据节点，在该数据节点上仅创建一个分片。 逻辑库名称 长度为2-48个字符，以小写字母开头且仅支持小写，可以包含小写字母、数字、下划线。 选择账号 需要关联的DDM账号。 选择数据节点 仅支持和当前DDM实例处于相同VPC、且未被其他DDM实例使用的数据节点。DDM将在选择的数据节点上新建数据库，不会影响数据节点上已有的库表。 逻辑库总分片数 逻辑库总分片数是所选数据节点分片数的总和，为了确保每个数据节点上都能均匀分配到分片，逻辑库总分片数不能小于选择的数据节点数。考虑到业务会持续增长，建议每个数据节点上最小8分片，最大不超过64分片。 单击“下一步”。 在数据节点可用性检测页面，输入关联数据节点的账号及密码，单击“测试”。 数据节点账号所需权限: SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, RELOAD, PRO CES S, 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实例关联。 创建逻辑库时选多个分片的场合，分片名遵循“逻辑库名_xxxx”的命名规则，其中xxxx为从“0000”开始递增的数字。如逻辑库名为“db_cbb5”，总分片数为2，则分片名为“db_cbb5_0000”和“db_cbb5_0001”。 创建逻辑库时，关联的数据节点不能处于只读状态。 DDM在数据节点上创建的内部账号（DDMRW*、DDMR*、DDMREP*）请勿修改和删除，否则会影响业务。 内部账号名称组成规则：固定前缀（DDMRW、DDMR、DDMREP）+数据节点ID取HASH值。 口令规则：口令随机生成，长度最小16，最长32。

建表语法 create table test_dd_tb ( id int, name varchar(30) DEFAULT NULL, create_time datetime DEFAULT NULL, primary key(id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8 dbpartition by MOD_HASH(id) tbpartition by DD(create_time) tbpartitions 31;

操作步骤 登录分布式数据库中间件控制台。 在实例管理列表页面，单击目标实例名称，进入实例基本信息页面。 在左侧导航栏选择“账号管理”，进入账号管理页面。 在账号管理页面单击“创建DDM账号”，在弹窗中填选账号参数信息。 图1 创建DDM账号 表1 创建DDM账号配置参数 参数 说明 账号名称 DDM账号的名称，命名规则如下。 长度为1-32个字符，必须以字母开头，不区分大小写，可以包含字母，数字、下划线，不能包含其它特殊字符。 密码 DDM账号的密码，密码复杂度要求如下。 大小写敏感。 长度为8~32个字符。 至少包含三种字符组合：小写字母、大写字母、数字、特殊字符 ~ ! @ # % ^ * - _ + ? 不能使用简单、强度不够、容易被猜测的密码。 不能与账号名称或者倒序的账号名称相同。 确认密码 确认密码必须和输入的密码保持一致。 密码有效期 设置密码有效期，取值范围为0-65535的整数，单位为天。如果DDM的账号状态为“已过期”，账号将无法登录，已有连接会断开，需要重置密码后重新登录。 0表示密码永不过期。 如果不设置密码有效期则默认密码永不过期。 说明： 内核版本需大于或者等于3.0.4。 关联逻辑库 DDM账号与逻辑库关联绑定，下拉列表中显示可关联的逻辑库。 DDM账号只对已关联的逻辑库有访问权限。 账号权限 选择需要的基础权限，包括CREATE、DROP、ALTER、INDEX、INSERT、DELETE、UPDATE、SELECT。 描述 对DDM账号的详细描述信息，长度不能超过256个字符。 确认填写无误后，单击“确定”。

约束限制 目标DDM实例、RDS for MySQL实例所在E CS 必须保证网络互通。 为了保持数据完整性，需要先停止业务后再进行数据迁移。 DDM不支持以自动新建库或者新建拆分表、广播表的方式导入数据。因此导入数据前需要先创建好相同名称的逻辑库，相同拆分表、广播表结构的逻辑表，然后再进行数据导入。各类逻辑表创建方式请参见表2。 目标DDM使用的RDS for MySQL实例与自建MySQL的MySQL版本需要保持一致。

支持审计的关键操作列表 通过 云审计 服务，您可以记录与华为云分布式数据库中间件实例相关的操作事件，便于日后的查询、审计和回溯。 表1 云审计服务支持的DDM操作列表 操作名称 资源类型 事件名称 参数模板应用 parameterGroup applyParameterGroup 租户进行包周期云服务续费、包周期转按需、按需转包周期 all bssArrearage 更新云服务metadata信息 all bssUpdateMetadata 清理逻辑库扩容后的元数据 logicDB cleanMigrateLogicDB 清理用户资源 all cleanupUserAllResources 复制参数模板 parameterGroup copyParameterGroup 创建实例 instance createInstance 创建逻辑库 logicDB createLogicDB 创建参数模板 parameterGroup createParameterGroup 创建账号 user createUser 删除实例 instance deleteInstance 删除逻辑库 logicDB deleteLogicDB 删除参数模板 parameterGroup deleteParameterGroup 删除账号 user deleteUser 节点扩容 instance enlargeNode 重启实例 instance instanceRestart 导入逻辑库信息 instance loadMetadata 扩容路由切换 logicDB manualSwitchRoute 逻辑库扩容 logicDB migrateLogicDB 修改参数模板 parameterGroup modifyParameterGroup 修改路由切换时间 logicDB modifyRouteSwitchTime 修改账号信息 user modifyUser 节点缩容 instance reduceNode 重置参数模板 parameterGroup resetParameterGroup 重置账号密码 user resetUserPassword 规格变更 instance resizeFlavor 恢复实例 instance restoreInstance 重试逻辑库扩容 logicDB retryMigrateLogicDB 回滚DDM实例版本 instance rollback 回滚逻辑库扩容 logicDB rollbackMigrateLogicDB 访问控制 instance switchIpGroup 同步DN信息 instance synRdsinfo 升级DDM实例版本 instance upgrade 添加标签 instance addTag 删除标签 instance deleteTag 修改标签 instance modifyTag 创建组 group createGroup 删除组 group deleteGroup 修改内网地址 instance modifyIp 修改实例名称 instance modifyName 节点重启 node nodeRestart 导出实例列表 instance exportInstance 元数据重载 instance reloadInstanceConfig 修改实例端口 instance modifyInstancePort 查询规格变更列表 instance queryFlavor2Resize 查询慢SQL instance listSlowLogs 获取实例版本 instance listDatabaseVersions 查询慢日志统计分析 instance querySlowLogAnalysis 绑定EIP instance bindEIP 解绑EIP instance unbindEIP 获取实例绑定的EIP信息 instance queryEIP 查询CN会话 instance queryLogicalProcessList kill CN会话 instance killLogicalProcess 查询DN会话 instance queryPhysicalProcessList kill DN会话 instance killPhysicalProcess 查询kill会话历史 instance queryKillProcessesAuditLog 查询访问控制 instance queryIpGroup 获取标签列表 tag listTags 获取实例标签列表 instance listInstanceTags 切换实例内核的ssl开关 instance switchSsl 获取实例的ssl证书下载地址 instance getSslCerts 查询逻辑库列表 instance listDatabases 导出逻辑库信息 instance dumpMetadata 查询逻辑库大小 instance queryLogicDbSize 分片变更预校验 logicDB preCheckMigrateLogicDb 查询分片变更预校验结果 instance queryPreCheckMigrateLogicDb 查询分片变更任务详情 instance queryMigrateTaskDetail 更新实例SQL黑名单 logicDB configSqlBlackList 获取SQL黑名单 logicDB querySqlBlacklist 修改实例读写比重 instance updateReadAndWriteStrategy 批量修改实例读写比重 instance batchModifyReadAndWriteStrategy 查询是否开启读写分离 instance queryReadWriteSeparationSwitch 开启或关闭读写分离 instance updateReadAndWriteStrategySwitch 查询实例可用数据节点 instance ListAvailableRds 查询实例关联数据节点 instance queryRelatedRdsList 查询分片变更可用数据节点 logicDB queryAvailableMigrateRdsList 查询逻辑库分片变更动作 instance queryMigrateAction 查询内核任务执行日志 instance listTaskLogs 数据节点连通性检查 instance checkRdsConnection 查询逻辑库下的逻辑表列表 logicDB listLogicTables 查询逻辑表详情 table showLogicTable 查询备份列表 backup listBackups 删除备份 backup deleteBackup 查询备份详情 backup showBackup 元数据恢复 instance restoreMetaData 查询某时刻关联数据节点 instance showBackupRelatedDn 查询可恢复时间 instance queryRestoreTime 查询可恢复RDS列表 instance queryRds4Restore 查询可恢复实例列表 instance queryDDM4Restore 校验参数组名是否存在 parameterGroup checkConfigurationName 查询参数组列表 parameterGroup listConfiguration 查询参数组详情 parameterGroup showConfiguration 查询可应用该模板参数组的实例列表 parameterGroup queryApplicableInstances 查询参数组的修改历史 parameterGroup queryModifyHistory 查询模板参数组的应用历史 parameterGroup queryApplyHistory 查询实例参数组 instance showInstanceConfiguration 查询逻辑表大小 logicDB queryLogicTableSize 弱密码校验 project isWeakPassword 查询只读数据节点 dn queryReadOnlyDBInstance 查询实例列表 instance listInstances 查询指定实例的详细信息 instance showInstance 查询指定逻辑库的详细信息 logicDB showDatabase 查询实例节点列表 instance listNodes 查询实例节点详情 node showNode 查询帐号列表 instance listUsers 修改实例安全组 instance modifyInstanceSecurityGroup 父主题： 审计

为什么找不到已创建的标签？ 客户在“成本分析”页找不到标签键的可能原因如下： 标签未激活，具体操作请参见激活成本标签。 标签已激活，但应用到成本数据上的成本标签存在最多48小时的延迟。 标签键中携带英文冒号，建议您去掉标签键中的冒号。 客户在“成本分析”找不到标签值的可能原因如下： 标签延迟，应用到成本数据上的成本标签存在最多48小时的延迟。 标签值中携带英文冒号，建议您去掉标签值中的冒号。 父主题： 成本分析

操作（Action） 操作（Action）即为SCP中支持的授权项。 “访问级别”列描述如何对操作进行分类（list、read和write等）。此分类可帮助您了解在SCP中相应操作对应的访问级别。 “资源类型”列指每个操作是否支持资源级权限。 资源类型支持通配符号*表示所有。如果此列没有值（-），则必须在SCP语句的Resource元素中指定所有资源类型（“*”）。 如果该列包含资源类型，则必须在具有该操作的语句中指定该资源的URN。 资源类型列中必需资源在表中用星号（*）标识，表示使用此操作必须指定该资源类型。 关于CodeArts PerfTest定义的资源类型的详细信息请参见资源类型（Resource）。 “条件键”列包括了可以在SCP语句的Condition元素中支持指定的键值。 如果该授权项资源类型列存在值，则表示条件键仅对列举的资源类型生效。 如果该授权项资源类型列没有值（-），则表示条件键对整个授权项生效。 如果此列条件键没有值（-），表示此操作不支持指定条件键。 关于CodeArts PerfTest定义的条件键的详细信息请参见条件（Condition）。 您可以在SCP语句的Action元素中指定以下CodeArts PerfTest的相关操作。 表1 CodeArts PerfTest支持的授权项 授权项 描述 访问级别 资源类型（*为必须） 条件键 codeartsperftest:privateResourceGroup:update 授予权限修改私有资源组。 write privateResourceGroup - codeartsperftest:privateResourceGroup:list 授予权限查看私有资源组列表。 list privateResourceGroup - codeartsperftest:privateResourceGroup:get 授予权限查看私有资源组。 read privateResourceGroup - codeartsperftest:privateResourceGroup:delete 授予权限删除私有资源组。 write privateResourceGroup - codeartsperftest:privateResourceGroup:create 授予权限创建私有资源组。 write privateResourceGroup - codeartsperftest:jmeter:updateJmeterTask 授予权限修改JMeter任务。 write jmeter g:ResourceTag codeartsperftest:jmeter:updateJmeterProject 授予权限修改JMeter工程。 write jmeter g:ResourceTag codeartsperftest:jmeter:listJmeterTask 授予权限查看JMeter任务列表。 list jmeter g:ResourceTag codeartsperftest:jmeter:listJmeterProject 授予权限查看JMeter工程列表。 list jmeter - codeartsperftest:jmeter:getJmeterTask 授予权限查看JMeter任务。 read jmeter g:ResourceTag codeartsperftest:jmeter:getJmeterProject 授予权限查看JMeter工程。 get jmeter g:ResourceTag codeartsperftest:jmeter:executeJmeterTask 授予权限执行或停止JMeter任务。 write jmeter g:ResourceTag codeartsperftest:jmeter:deleteJmeterTask 授予权限删除JMeter任务。 write jmeter g:ResourceTag codeartsperftest:jmeter:deleteJmeterProject 授予权限删除JMeter工程。 write jmeter g:ResourceTag codeartsperftest:jmeter:createJmeterTask 授予权限创建JMeter任务。 write jmeter g:ResourceTag codeartsperftest:jmeter:createJmeterResource 授予权限创建JMeter变量、jar包等。 write jmeter g:ResourceTag codeartsperftest:jmeter:createJmeterProject 授予权限创建JMeter工程。 write jmeter - codeartsperftest:cpts:updatePerfTestTask 授予权限修改PerfTest任务。 write cpts g:ResourceTag codeartsperftest:cpts:updatePerfTestProject 授予权限修改PerfTest工程、用例、目录等。 write cpts g:ResourceTag codeartsperftest:cpts:listPerfTestTask 授予权限查看PerfTest任务列表。 list cpts g:ResourceTag codeartsperftest:cpts:listPerfTestProject 授予权限查看PerfTest工程列表。 list cpts - codeartsperftest:cpts:getPerfTestTask 授予权限查看PerfTest任务。 read cpts g:ResourceTag codeartsperftest:cpts:getPerfTestProject 授予权限查看PerfTest工程。 read cpts g:ResourceTag codeartsperftest:cpts:executePerfTestTask 授予权限执行或停止PerfTest任务。 write cpts g:ResourceTag codeartsperftest:cpts:deletePerfTestTask 授予权限删除PerfTest任务。 write cpts g:ResourceTag codeartsperftest:cpts:deletePerfTestProject 授予权限删除PerfTest工程、用例、目录等。 write cpts g:ResourceTag codeartsperftest:cpts:createPerfTestTask 授予权限创建PerfTest任务。 write cpts g:ResourceTag codeartsperftest:cpts:createPerfTestResource 授予权限创建PerfTest用例、目录、变量等。 write cpts g:ResourceTag codeartsperftest:cpts:createPerfTestProject 授予权限创建PerfTest工程。 write cpts - codeartsperftest::uploadFile 授予权限上传文件。 write - - codeartsperftest::updateSlaTemplate 授予权限更新SLA模板。 write - - codeartsperftest::updateCronTask 授予权限修改定时压测任务。 write - g:ResourceTag codeartsperftest::orderPackage 授予权限订购套餐包。 write - - codeartsperftest::listTag 授予权限查看标签列表。 list - - codeartsperftest::listSlaTemplate 授予权限展示SLA模板集。 list - - codeartsperftest::listPackage 授予权限查看已订购的套餐包。 list - - codeartsperftest::listCronTask 授予权限查看定时压测任务列表。 list - - codeartsperftest::getTag 授予权限查看工程对应的标签。 read - - codeartsperftest::getSlaTemplate 授予权限查看SLA模板。 read - - codeartsperftest::getCronTask 授予权限查看定时压测任务。 read - g:ResourceTag codeartsperftest::deleteTag 授予权限删除工程对应的标签。 tagging - g:ResourceTag g:TagKeys codeartsperftest::deleteSlaTemplate 授予权限删除SLA模板。 write - - codeartsperftest::deleteCronTask 授予权限删除定时压测任务。 write - g:ResourceTag codeartsperftest::createTag 授予权限创建工程对应的标签。 tagging - g:ResourceTag g:RequestTag g:TagKeys codeartsperftest::createSlaTemplate 授予权限创建SLA模板。 write - - codeartsperftest::createCronTask 授予权限创建定时压测任务。 write - g:ResourceTag

原因分析 在xDM-F中，系统界面实例的“创建时间”和“最后更新日期”等时间属性显示的是所在时区的当地时间，而xDM-F数据库显示时间类型属性值时使用的时区默认为“UTC”。 在LinkX-F中，根据目标端图数据库中实例数据与源端原始数据保持一致的原则，xDM-F来源的实例数据显示的“最后更新时间”，是直接从xDM-F数据库执行SQL查询获得，显示时间类型属性值时使用的时区默认为“UTC”。 综上，如果操作系统时间所设置的时区不是UTC时区，就会出现xDM-F来源的实例数据的“最后更新时间”显示与xDM-F中不一致的现象。

在工业数字模型驱动引擎中，IAM和OrgID的区别 基于 统一身份认证 服务（Identity and Access Management，简称IAM）和组织成员账号（OrgID）的能力，工业数字模型驱动引擎（Industrial Digital Model Engine，简称iDME）实现了对不同iDME商品的访问控制。您可以通过下表对比项，了解这两个服务的具体区别： 表1 IAM与OrgID的差异对比 对比项 IAM OrgID 定义 是华为云提供权限管理的基础服务，可以帮助用户安全地控制云服务和资源的访问权限。 是面向企业提供组织管理、企业成员账号管理以及SaaS应用授权管理能力的云服务，将Huawei ID账号体系延伸到企业用户，统一华为云面向生态SaaS服务的组织、账号，面向生态伙伴推出SaaS服务账号集成规范。 OrgID开通的相关权限受IAM控制。 账号类型 IAM账号，一般指IAM用户，由开通华为云业务的华为账号创建，完全归属于创建该IAM用户的华为账号。 OrgID使用账号分为个人华为账号、管理式华为账号和第三方认证源账号。 个人华为账号：本身拥有华为账号身份，被邀请作为当前华为账号在OrgID下某组织的成员。 管理式华为账号：由开通华为云业务的华为账号通过OrgID的成员管理创建，完全归属于创建该管理式华为账号的组织。 第三方认证源账号：由第三方认证源提供，组织管理员通过OrgID的认证源管理添加，鉴权认证通过后，可登录OrgID进行后续业务操作。 账号作用 IAM用户会根据华为账号赋予的有限权限范围操作iDME资源，属于资源账号。 可直接访问某个注册在OrgID的iDME应用，或者在OrgID的用户中心免登录访问应用列表中的iDME应用或iDME商品实例。 适用场景 希望对iDME资源进行精细化访问控制。 企业A存在多种iDME资源，希望将部分iDME资源授权给企业B使用。 企业内存在多个应用账号独立，希望企业用户使用一个账号就可以登录所有授权的iDME应用。 允许用户通过三方身份访问iDME商品实例，例如 WeLink 、oAuth、CAS、OIDC等。 希望应用内跳转其他应用或者 域名 匹配时，可以直接访问，无需二次登录。 希望统一业务平台和华为云的账号访问。 父主题： 一般性相关问题

工业数字模型驱动引擎可以做什么？ 工业数字模型驱动引擎（Industrial Digital Model Engine，简称iDME），是基于数字化变革和数据管理优秀实践开发的创新型工业软件开发与运营平台，打造“基于模型+数据驱动”的公共底座，为协同打造新一代全栈自主可控工业软件体系提供根技术服务，助力快速构建和运营云化SaaS化工业软件，汇聚企业全场景数据，构建企业级数据图谱，提供万数互联的数据索引、追溯、交互服务。 iDME产品形态包含iDME设计服务和iDME运行服务两部分。 iDME设计服务：是iDME数据模型开发平台，提供应用管理和数据模型管理能力，支持应用创建、修改、开发和发布等功能，基于数据建模能力创建和设计数据模型，定义数据模型元数据。 iDME运行服务：包括数据建模引擎和数字主线引擎两种运行服务。 数据建模引擎：是用于应用部署和运行的计算、存储、网络等基础设施资源的集合。您可以按运行服务的维度管理数据建模引擎资源和部署应用。例如，对应用进行部署、升级、卸载等操作，在应用运行态使用更丰富的数据管理能力。 数字主线引擎：采用数字化技术，可同步数据建模引擎应用模型，也可自定义产品全量数据模型，打通数据孤岛联接业务数据，全关联海量业务实例数据构建全价值网络，并为各领域提供高效数据索引、追溯、交互服务。 父主题： 一般性相关问题

JPQL/SQL语句相关约束与限制 使用JPQL（Java Persistence Query Language）进行更新或查询操作时，不允许使用可选的“from”关键字。 例如，存在一个数据模型“MyEntity”，您想将所有属性“attr”设置为“null”。 在JDK 8版本的应用运行态中，您可以使用以下SQL语句。 update from MyEntity e set e.attr=null 使用JDK 17版本后，调用update语句时，需要将update后面的from删除。即： update MyEntity e set e.attr=null 使用JPQL进行查询时，不支持使用列名来构建查询。如果存在实体属性的字段名与列名不一致，需要使用字段名进行查询。 JPQL不支持直接比较对象与ID，包括根对象（如where myentity=:param）和关联对象（如where myentity.association=:param）。 如需使用真正的参考对象ID进行比较，可以直接在JPQL查询中使用这个字段，例如where myentity.id = :param。 在执行原生SQL查询并返回count()函数的结果时，返回类型为Long，而不是BigInteger。 JPQL不再支持集合伪属性，例如.size、.elements、.indices、.index、.maxindex、.minindex、.max element、.minelement。如果您希望在JPQL中使用集合伪属性，需要参考如下示例进行修改。 mycollection.size ⇒ size(mycollection) mycollection.elements ⇒ value(mycollection) mycollection.indices ⇒ index(mycollection) (for lists) 或者 key(mycollection) (for maps) mycollection.maxindex ⇒ maxindex(mycollection) mycollection.minindex ⇒ minindex(mycollection) mycollection.maxelement ⇒ maxelement(mycollection) mycollection.minelement ⇒ minelement(mycollection)

iDME常见错误提示及解决方法 本章节主要介绍iDME控制台常见错误提示信息及对应的解决方法。 表1 常见错误提示及解决方法 错误提示信息 报错场景 原因及解决方法 配额不足 购买服务（如基础版数据建模引擎、节点、增量包、用户、MCU）或创建应用时失败 原因：剩余配额不足。 解决方法：可通过申请扩大配额来解决，详细请参见配额管理。 只能购买一个数字主线引擎 购买数字主线引擎时不成功 原因：已购买数字主线引擎，一个华为账号下只能购买一个基础版/基础版-Lite数字主线引擎。 解决方法：根据已有数字主线引擎的实际计费模式执行删除或退订操作后再重新购买，详细请参见管理数字主线引擎资源。 该运行环境状态异常或不支持变更 变更基础版数据建模引擎时不成功 原因：资源状态不正常。 解决方法：参考资源异常状态说明及处理方案解决，详情请参见服务状态说明。 该应用当前为已部署状态，如需删除请先卸载应用 删除应用时不成功 原因：已部署的应用无法直接删除。 解决方法：卸载应用后重新删除，详情请参见卸载应用。 该应用已部署在其他运行服务，请先将该应用卸载后再进行部署 部署应用时不成功 原因：一个应用只能部署在一个数据建模引擎上。 解决方法：卸载应用后重新部署，详情请参见卸载应用。 该运行服务已部署其他应用，请先卸载旧应用后再部署新应用 部署应用时不成功 原因：一个数据建模引擎上只能部署一个应用，应用部署的数量超过限制。 解决方法：卸载应用后重新部署，详情请参见卸载应用。 应用环境和APP数据库未匹配 部署应用时不成功 原因：数据建模引擎的数据库类型与待部署应用的数据库类型必须一致，才能保证应用顺利部署。 解决方法：重新购买与应用数据库类型一致的数据建模引擎再次部署，或者新建与数据建模引擎数据库类型一致的应用，详情请参见开通数据建模引擎或创建应用。 无可部署的应用版本，请先到业务面设计态发布应用 部署应用时选不到应用版本 原因：未发布过应用或应用发布失败，所以无可选的应用版本。 解决方法：进行应用发布后重新部署，详情请参见应用发布。 仅当资源状态与应用状态为运行中时可登录 登录运行态时按钮置灰 原因：资源状态或应用状态不正常。 解决方法：参考资源或应用异常状态说明及处理方案解决，详情请参见服务状态说明。 无效Key值 添加标签键时失败 原因：输入的标签键不符合规范。 解决方法：参考标签键填写规范重新输入，详情请参见管理服务标签。 输入的账号ID无效，请检查 分享组织时不成功 原因：未填写正确的账号ID。 解决方法：重新分享时确保输入正确的账号ID，详细请参见分享组织。 父主题： 一般性相关问题

自建 GaussDB 内核版本号与UGO界面显示GaussDB版本号对应关系 登录自建 GaussDB数据库 ，执行以下命令，查询版本号。 select version (); 查询出的版本号，与UGO界面上显示的GaussDB版本号对应关系如表1所示。 表1 版本号对应关系 GaussDB内核版本号 UGO显示GaussDB版本号 V500R002C10 GaussDB V2.0-2.7 企业版 503.0.x GaussDB V2.0-3.1 企业版 503.1.x GaussDB V2.0-3.2 企业版 503.2.x GaussDB V2.0-3.3 企业版 505.0 GaussDB V2.0-8.0 企业版 505.1 GaussDB V2.0-8.100 企业版 505.2 GaussDB V2.0-8.200 企业版 506.0 GaussDB V2.0-9.0 企业版 父主题： 产品咨询

数据分片与扩展 随着日志数量的激增，日志数据量呈指数级增长，单一数据库节点往往难以应对海量数据的存储和查询需求。DDS（Document Database Service）通过数据分片（Sharding）技术，提供了水平扩展能力，能够有效分担数据存储和查询压力，确保系统的高可用性和高性能。 数据分片原理 数据分片是将数据集分割成多个部分，分别存储在不同的数据库节点（Shard）上。每个Shard存储数据集的一部分，通过Shard Key来确定数据的分布。Shard Key的选择至关重要，它决定了数据的分布模式，影响着写入和查询的性能。

日志数据的存储策略 在物联网（Internet of Things，简称IoT）领域，设备的日志数据扮演着至关重要的角色，不仅能帮助监控设备的运行状态，还提供了设备使用模式和故障预测的宝贵信息。例如，一个智能家庭安全系统的日志记录，可以包含设备ID、时间戳、事件类型（如“门锁开启”、“运动检测”）、设备状态、以及可能的错误代码等信息。 日志数据示例 一个典型的IoT设备日志条目如下所示： DeviceID: 001, Timestamp: 2023-04-05T14:30:00Z, Event: DoorLockOpened, DeviceStatus: Active, Error: None

自动删除过期数据 TTL索引：自动删除过期文档，如设置30天后自动删除。 db.eventlog.createIndex( { "timestamp": 1 }, { expireAfterSeconds: 30 * 24 * 60 * 60 } ) Capped集合：限制集合大小，自动删除最旧文档。固定大小集合是大小固定的集合，根据插入顺序插入和检索文档。固定大小集合的工作方式与循环缓冲区类似：一旦一个集合填满了分配的空间，它就会通过覆盖集合中最旧的文档来为新文档腾出空间。 // 创建固定集合需要在创建集合的时候指定 db.getSiblingDB("iot_logs").dropDatabase() db.getSiblingDB("iot_logs").createCollection( "events", { capped: true, size: 5242880 } ) 定期归档：按月归档日志数据，便于历史数据管理和查询。 db.getSiblingDB("iot_logs").events.renameCollection("events202301") 单个实例中，数据库的总的个数不要超过200个，总的集合个数不要超过500个。集合数量过多会导致内存压力变高，并且集合数量多会导致重启以及主备倒换性能变差，影响紧急情况下的高可用性能。建议定期删除不需要的集合。

数据探索概述 通过数据探索，可探索实例间的关系，包括实例图谱探索和模型路径探索两种方式。请注意，在进行数据探索前，请确保实体模型对应的实例数据已入图。创建数据入图任务的具体操作请参考数据入图。 实例图谱探索：指基于实例及实例之间的关系进行扩展探索。即根据已知实例数据节点但不知节点间的关系时，可通过一层一层扩展查询出节点之间的关系。 模型路径探索：基于固化下来的业务模型及路径，对该模型路径下的实例及实例关系进行探索。 父主题： 探索数据

管理调度任务 在数据入图调度页面，开发人员及以上权限的用户可以管理调度任务，包括暂停或恢复Reader、取消挂起调度任务和重试或终止等操作。 表1 管理调度任务 操作 说明 暂停/恢复Reader 暂停Reader：勾选执行中的调度任务，单击“暂停Reader”。 如需暂停全部执行中的调度任务，单击“暂停全部Reader”。 恢复Reader：勾选已暂停的调度任务，单击“恢复Reader”。 如需恢复已暂停的全部的调度任务，单击“恢复全部Reader”。 挂起/取消挂起 挂起：周期任务无须手动挂起，当设置默认入图调度数据量阈值后，如果超过阈值则调度Reader挂起不再执行。 挂起阈值为500万。 只针对数据入图类型为数据库映射的定时任务，不支持源系统API映射和CSV文件导入类型的任务。 受Reader算子挂起以及放行规则的影响，规则暂不支持用户自定义。 定时任务触发时，存在挂起的任务不允许生成调度。 Reader算子调度执行失败时不重复执行规则。 取消挂起：单击任务操作列处的“取消挂起状态”或勾选一个或多个任务后单击“取消挂起状态”。 终止/重试 终止调度：单击任务“操作”列处的。 说明： 仅支持终止“调度执行状态”为“待执行”、“执行中”或“挂起”的调度任务。 重试调度：单击任务“操作”列处的。 说明： 仅支持重试“数据入图类型”为“数据库映射”且执行失败或终止的调度任务。 批量重试或终止：勾选多个调度任务，单击“批量重试”或“批量终止”。

查看数字化场景详情 在“数字化场景”页面，单击数字化场景的“编码”链接，查看目标数字化场景的详情信息，包括“基本信息”、“业务对象流”、“数据实体流”、“关联的数据服务”和“修订记录”等。 表1 数字化场景详情页签介绍 详情页签 说明 基本信息 展示当前数字化场景的基本信息，包括“基本信息”、“URL地址”（如业务对象流URL、数据实体流URL等）和“版本信息”。 业务对象流 展示当前数字化场景相关的业务流程阶段及业务对象组成的图结构（业务对象流更多操作请参考配置业务对象流）。 查看业务对象信息：在画布中单击业务对象，右侧弹出业务对象卡片信息，包含基本信息和包含的数据实体。 搜索业务对象：在画布中右上方的搜索框中输入关键词单击。 数据实体流 展示当前数字化场景业务流程中关联的数据实体流向（数据实体流更多操作请参考配置数据实体流）。 查看实体信息：在画布中单击实体节点或关系，右侧弹出对应的基本信息。单击查看更多详细内容。 搜索数据实体流：在画布中右上方选择搜索类型（如数据实体、关系实体、业务对象、源系统等），在搜索框中输入关键词单击。 数据探索：在画布中选中实体节点单击或按鼠标右键在调出的快捷菜单中选择“数据探索”，快速跳转至模型路径探索页面进行数据探索。更多内容请参考模型路径探索。 关联的数据服务 展示数字化场景已关联的数据服务（关联数据服务的更多操作请参考配置关联的数据服务）。 修订记录 展示当前数字化场景的所有版本修订记录。修订记录不可创建和编辑，每次有版本修订此处会自动增加修订内容。

处理实体调度异常数据 单击实体“操作”列处的，根据需要维护实体的“异常类型”、“异常原因类型”、“原因分析”、“建议解决方案”和“计划完成时间”等信息。 表2 参数说明 参数 说明 异常类型 必填。选择异常类型。 IGNORE ：代表可忽略，表示源端更新频率低，数据不常更新的实体。 WARNING ：代表警告，表示数据入图范围异常但暂未发现数据入图任务同步异常的实体。 ERROR ：代表错误，表示数据入图任务运行异常导致入图范围异常的实体。 异常原因类型 必填，手动输入原因类型。 原因分析 必填，手动输入原因。 建议解决方案 必填，手动输入建议解决方案。 计划完成时间 必填，选择当天及以后的日期。 解决进展 非必填，手动输入解决进展。