接口功能介绍 幂等接口，重复解绑会忽略并视为成功。 计算增强型云电脑功能请联系客户经理开通。 接口约束 无 URI POST /v3/ecs/unbindUser 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 desktopOid 是 String 云电脑ID 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK. returnObj Object 返回数据结构体。 returnObj 枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body { "desktopOid":"XXXXXXXXXXXXX6925" } 响应示例 { "statusCode":800, "message":"OK.", "returnObj":{ } } 状态码 请参考 状态码 错误码 请参考 错误码

您需要在部署天翼云TeleDB数据库之前，检查相关的机器、安装包、操作系统、端口等信息。 确保您的安装包与操作系统版本匹配。 检查机器之间是否存在通信问题或者拦截问题，确保主机之间网络互通。 确保已获取主机超级用户。 硬盘空间足够。 已安装好java运行时。 部署好ZooKeeper。

本页介绍天翼云TeleDB数据库存储过程开发的变量使用方式。 在一个块中使用的所有变量必须在该块的声明小节中事先进行声明，PL/pgSQL 变量可以是任意SQL数据类型，可以是一个简单数据类型、复合类型、RECORD、已经存在的表行类型、表字段类型、游标。

本页介绍天翼云TeleDB数据库PL/pgsql函数的返回值。 返回值可以是一个简单数据类型、复合类型、RECORD、已经存在的表行类型、表字段类型、游标、另外还可以返回一个记录集、如果不需要返回值，则可以用RETURN void。返回值的字段名及类型可以在参数OUT、INOUT模式中声明。

本页介绍天翼云TeleDB数据库存储过程开发的变量使用方式。 在一个块中使用的所有变量必须在该块的声明小节中事先进行声明，PL/pgSQL 变量可以是任意SQL数据类型，可以是一个简单数据类型、复合类型、RECORD、已经存在的表行类型、表字段类型、游标。

本页介绍天翼云TeleDB数据库PL/pgsql函数的返回值。 返回值可以是一个简单数据类型、复合类型、RECORD、已经存在的表行类型、表字段类型、游标、另外还可以返回一个记录集、如果不需要返回值，则可以用RETURN void。返回值的字段名及类型可以在参数OUT、INOUT模式中声明。

本页介绍天翼云TeleDB数据库的监控概览。 TeleDB提供全面的实例监控功能，保证用户实时了解实例的运行状态。 说明 TeleDB默认只保留一个月的监控数据，TeleDB管理员可在系统信息 > 基本信息 > 参数配置 修改相关参数（TELEDBXOSSSTATISTICSSAVEDAYS）调节。

本页介绍天翼云TeleDB数据库如何查看系统基本消息。 操作步骤 1. 切换至TeleDB控制台，单击系统信息 > 基本信息 ，进入基本信息页面。 2. 选择基本信息页签，你可查看系统名称、系统版本号、系统管理员和系统部署日期。

本节主要介绍修改实例安全组。 操作场景 GeminiDB Influx支持修改安全组。 使用须知 对于进行节点扩容中的实例，不可修改安全组。 该功能目前处于公测阶段，如需使用，请您联系客服申请开通。 操作步骤 1. 登录管理控制台。 2. 在服务列表中选择“数据库 > 云数据库 GeminiDB Influx 接口”。 3. 在“实例管理”页面，选择指定的实例，单击实例名称。 4. 在左侧导航树，单击“连接管理”。 5. 在“内网安全组”区域，单击，选择实例所属安全组。 单击，提交修改。此过程约需1～3分钟。 单击，取消修改。 6. 稍后可在“安全组”区域，查看修改结果。

本节介绍了GeminiDB Redis的查看慢日志的操作步骤及说明。 GeminiDB Redis的日志管理功能支持查看数据库级别的慢日志，执行时间的单位为ms。通过该日志，可查找出执行效率低的语句，以便优化。 查看日志明细 1、登录云数据库 GaussDB NoSQL控制台。 2、在左侧导航树，单击“慢日志”。 3、在“慢日志”页面，设置查询条件，查看日志信息。 节点类型默认“All nodes”，可查看实例下所有节点的慢日志信息，您也可以选择查看某个节点的慢日志信息。 可选择查看全部语句类型或查看以下指定类型的慢查询语句： SET GET DEL INCR INCRBY INCRBYFLOAT DECR DECRBY GETSET APPEND MGET ······ 注意 常用的Redis语句类型均支持慢日志查询。 可查看对应节点在不同时间段的慢日志。

本页介绍了文档数据库服务CRUD操作。 在文档数据库服务中，以下是一些常用的CRUD（创建、读取、更新、删除）操作以及相应的示例： 创建文档（Insert）: 插入单个文档： db.collection.insertOne({ name: "John", age: 25, city: "New York" }); 插入多个文档： db.collection.insertMany([ { name: "Alice", age: 30, city: "London" }, { name: "Bob", age: 35, city: "Paris" } ]); 读取文档（Read）: 查询集合中的所有文档： db.collection.find(); 查询并返回第一个匹配的文档： db.collection.findOne({ name: "John" }); 使用查询操作符进行高级查询： db.collection.find({ age: { $gt: 25 } }); 更新文档（Update）: 更新单个文档： db.collection.updateOne({ name: "John" }, { $set: { age: 26 } }); 更新多个文档： db.collection.updateMany({ city: "London" }, { $set: { age: 31 } }); 删除文档（Delete）: 删除单个文档： db.collection.deleteOne({ name: "John" }); 删除多个文档： db.collection.deleteMany({ city: "London" }); 这些是一些常用的CRUD操作的示例。

本页介绍了扩容集群只读节点。 文档数据库服务产品的集群规格实例，支持添加集群只读节点进行业务的只读能力扩展。 集群规格实例添加只读节点的步骤如下： 1. 进入TeleDB数据库控制台。 2. 点击“DDS”>“实例管理”进入实例列表页面。 3. 在需要进行添加只读节点的集群实例的“操作”列，点击“更多”，可见“添加只读从”。 4. 点击“添加只读从”，进入到只读从节点添加页面。 5. 在添加只读节点页面，根据指引，选择您需要的集群只读节点数量进行扩容，点击“立即购买”。 6. 支付完成后，等待数分钟，刷新该实例的详细信息，可见该集群实例的只读节点数量已完成添加。 注意 集群实例只读节点数量最多为5个。 扩容数量为集群实例每个shard的只读节点数量。

本章节主要介绍如何创建Elasticsearch集群。 场景描述 当创建的集群类型不同时，需要关注如表1所示的关键参数的配置。 表1 集群创建差异 集群类型 “安全模式” “HTTPS访问” “公网访问” “Kibana公网访问” 非安全模式的集群 关闭 不涉及 不支持启用 不支持启用 安全模式+HTTP协议的集群 开启 关闭 不支持启用 支持启用 安全模式+HTTPS协议的集群 开启 开启 支持启用 支持启用 前提条件 已经完成待创建的Elasticsearch集群规划。 创建集群 1. 登录云搜索服务管理控制台。 2. 在总览页面单击右上角的“创建集群”，进入“创建集群”页面。 或者左侧导航栏单击“集群管理> Elasticsearch”，单击右上角的“创建集群”，进入“创建集群”页面。 3. 在“基础配置”页面，完成Elasticsearch集群的基本信息和资源配置。 表2 Elasticsearch集群的基础配置 参数 说明 计费模式 集群支持包年/包月和按需计费两种模式。 l 包年/包月：根据集群购买时长，一次性支付集群费用。最短时长为1个月，最长时长为3年。如果购买时长超过9个月，建议包年购买，价格更优惠。 l 按需计费：按实际使用时长计费，计费周期为一小时，不足一小时按一小时计费。 订购周期 选择包年/包月模式后，需要选择购买时长。 您可以根据需求，选择是否需要“自动续费”。 当前区域 选择集群的所在区域。 不同区域的云服务产品之间内网互不相通。请就近选择靠近您业务的区域，可减少网络时延，提高访问速度。 可用区 选择集群工作区域下关联的可用区。 最多支持配置3个“可用区”。 集群类型 选择“Elasticsearch”。 集群版本 选择所需的集群版本，支持的版本以界面可选项为准。 集群名称 自定义集群名称，可输入的字符范围为4～32个字符，只能包含数字、字母、中划线和下划线，且必须以字母开头。 节点数量 集群中的数据节点个数。可选节点数为1~32，建议节点数为3或3以上，以提升集群可用性。 l 当集群未启用Master节点和Client节点时，数据节点将同时承担集群管理、存储数据、提供接入集群和分析数据的职责。此时，为保证集群中数据的稳定性，建议设置节点数量大于等于3个。 l 当集群启用了Master节点但未启用Client节点时，数据节点将用于存储数据并提供接入集群和分析数据的功能。 l 当集群未启用Master节点但启用了Client节点时，数据节点将用于存储数据并提供集群管理功能。 l 当集群同时启用了Master节点和Client节点时，数据节点将仅用于存储数据。 说明 当集群中数据节点的数量和可用区的数量不是整数倍关系时，集群的数据会分布可能会不均匀，从而影响数据查询或写入业务。 CPU架构 支持“X86计算”和“鲲鹏计算”两种类型。具体支持的类型由实际区域环境决定。 节点规格 集群中数据节点的规格。您可以根据需求，选择对应的规格。每个集群只能选择一个规格。 节点存储 当“节点规格”选择的是云硬盘时，需要选择集群数据节点的云硬盘类型。节点存储支持普通I/O、高I/O、超高I/O。 节点存储容量 设置数据节点的存储空间大小，其取值范围与“节点规格”关联，不同的规格允许的取值范围不同。 节点存储容量只支持配置为20的倍数。 启用Master节点 Master节点负责管理集群中所有节点任务，如元数据管理、索引创建与删除、分片分配等。在大规模集群的元数据管理、节点管理、稳定性保障和集群操作控制中发挥着至关重要的作用。 启用Master节点后，在下方选择对应的“节点规格”、“节点数量”和“节点存储”。“节点数量”必须是不小于3的奇数，最多设置9个节点。“节点存储”的存储容量为固定值，存储类型可以根据实际情况选择。 启用Client节点 Client节点负责接收并协调外部请求，如search和write请求，在处理高负载查询、复杂聚合、大量分片管理以及优化集群扩展性方面发挥着重要作用。 启用Client节点后，在下方选择对应的“节点规格”、“节点数量”和“节点存储”。“节点数量”可设置为1~32任意数值。“节点存储”的存储容量为固定值，存储类型可以根据实际情况选择。 启用冷数据节点 冷数据节点用于存储对查询时延要求不高，但数据量较大的历史数据，是管理大规模数据集和优化存储成本的有效方式。 启用冷数据节点后，在下方选择对应的“节点规格”、“节点数量”和“节点存储”。“节点数量”可设置为1~32任意数值。“节点存储”的存储类型和存储容量可以根据实际情况选择。 开启冷数据节点之后，支持切换集群的冷热数据，详情请参见2.7.9 切换Elasticsearch集群冷热数据。 说明 当集群中冷数据节点的数量和可用区的数量不是整数倍关系时，集群的数据会分布可能会不均匀，从而影响数据查询或写入业务。 企业项目 如果开通了“企业项目”，在创建集群时可以给集群绑定一个企业项目。 在下拉框中选择企业项目，单击“查看项目管理”跳转到“企业项目管理”管理控制台，查看已有的企业项目。 4. 单击“下一步：网络配置”。 5. 在“网络配置”页面，完成Elasticsearch集群的网络和安全模式配置。 表3 Elasticsearch集群的网络配置 参数 说明 虚拟私有云 指定集群节点使用的虚拟专用网络，实现不同业务的网络隔离。 单击“查看虚拟私有云”跳转到虚拟私有云列表，查看已创建的VPC名称和ID。 如果没有合适的VPC，建议联系CSS服务管理员新建VPC，具体请参见。 说明 此处选择的VPC必须包含网段（CIDR），否则集群将无法创建成功。新建的VPC默认包含网段（CIDR）。 子网 集群使用子网实现与其他网络的隔离，并独享所有网络资源，以提高网络安全。 选择当前虚拟私有云下集群需要的子网。 当选择的虚拟私有云支持IPv6，则在下拉框中选择是否分配IPv6地址。只有7.6.2和7.10.2版本的Elasticsearch集群支持分配IPv6地址。 安全组 安全组起着虚拟防火墙的作用，为集群提供安全的网络访问控制策略。 选择集群需要的安全组，单击“查看安全组”跳转到安全组列表，可以了解安全组详情。 说明 请确保安全组的“端口范围/ICMP类型”为“Any”或者包含端口9200的端口范围。 如果创建的集群为7.6.2及以上版本，则需要确保同安全组内节点之间的端口全放通。如果无法放通同安全组内节点之间的全部端口，请至少确保9300端口的通信。 放开9300端口通信后，如果集群磁盘使用率较高，可清理过期数据，释放磁盘存储空间。 安全模式 选择是否开启集群安全模式。 l默认开启，则创建的是安全模式的集群。安全模式的集群会对集群进行通讯加密和安全认证。因此必须配置集群的“管理员账户名”和“管理员密码”。 − 管理员账户名 默认为admin。 − 设置并确认管理员密码 。要记住设置的密码，后续访问集群需要输入密码。 l不开启，则创建的是非安全模式的集群。非安全模式的集群无需安全认证即可访问，并且采用HTTP明文传输数据。建议确认访问环境的安全性，勿将访问接口暴露到公网环境上。 HTTPS访问 只有开启集群的安全模式才可以启用HTTPS访问，开启HTTPS访问后，访问集群将进行通讯加密。 说明 安全集群使用HTTPS通信，相比非安全集群使用HTTP通信在读取性能上会降低，预期相对HTTP集群在大并发压力下有20%的性能劣化。如果想要读取性能快，又想要使用安全集群所提供的用户权限隔离资源（索引、文档、字段等）的功能，则可以关闭HTTPS访问。关闭HTTPS访问后，会使用HTTP协议与集群通信，无法保证数据安全性，并且无法开启公网访问功能。 公网访问 仅当集群开启了“安全模式”和“HTTPS访问”时，才可以选择是否配置“公网访问”。配置公网访问后，用户可以获得一个公网访问的IP地址，通过这个IP地址可以在公网访问该安全集群。 6. 单击“下一步：高级配置”。 7. 在“高级配置”页面，完成Elasticsearch集群的快照和其他高级配置。 a. 设置集群快照。 系统默认打开集群快照开关，如果您不需要启用自动快照，可以在“集群快照开关”右侧关闭。自动快照会创建委托访问对象存储服务OBS，快照存储在OBS标准存储中需额外计费。 表4 集群快照基础配置 参数 说明 OBS桶 在下拉框中选择存储快照的OBS桶。也可以单击右侧的“创建桶”新建OBS。 创建或者已存在的OBS桶需满足如下条件： l“存储类别”为“标准存储”。 l“区域”须与创建的集群所在区域相同。 备份路径 快照在OBS桶中的存放路径。 备份路径配置规则： l备份路径不能使用符号“:?"<>”。 l备份路径不能以“/”开头。 l备份路径不能以“.”开头或结尾。 l备份路径的总长度不能超过1023个字符。 IAM委托 指当前账号授权云搜索服务访问或维护存储在OBS中数据。如果没有合适的委托可以联系CSS服务管理员新建IAM委托。 所选的IAM委托需满足如下条件： l“委托类型”选择“云服务”。 l“云服务”选择“Elasticsearch”或者“云搜索服务 CSS”。 l必选策略：“Tenant Administrator”或“OBS Administrator” 表5 设置自动创建快照 参数 说明 快照名称前缀 快照名称前缀的长度为1～32个字符，只能包含小写字母、数字、中划线和下划线，且必须以小写字母开头。快照名称由快照名称前缀加上时间戳组成，例如自动生成的快照名称为“snapshot1566921603720”。 时区 指备份时间对应的时区，不支持修改。基于此时区选择备份开始时间。 备份开始时间 指每天自动开始备份的时间，只能指定整点时间，如00:00、01:00，取值范围为00:00～23:00。请在下拉框中选择时间。 8. 单击“下一步：确认配置”，确认完成后单击“立即创建”开始创建集群。 9. 单击“返回集群列表”，系统将跳转到“集群管理”页面。您创建的集群将展现在集群列表中，且集群状态为“创建中”，创建成功后集群状态会变为“可用”。 如果集群创建失败，请根据界面提示重新创建集群。

本章节主要介绍数据仓库服务如何使用Cloud Eye监控集群。 功能说明 用户需要查看集群的监控指标信息时，可以通过云监控（Cloud Eye）确认集群各项指标情况。通过监控集群运行时的各项指标，用户可以识别出数据库集群状态异常的时间段，然后在数据库日志中，分析可能存在问题的活动，从而优化数据库性能。本章节定义了数据仓库服务上报云监控服务的监控指标的命名空间、监控指标列表和维度定义。用户可以通过云监控服务提供的管理控制台或API接口来检索数据仓库服务产生的监控指标和告警信息，详情请参见云监控服务的《用户指南》和《API参考》。 本章节包含如下内容： 命名空间 集群监控指标 维度 查看集群监控和节点监控信息 多节点间的监控指标对比 创建告警规则 配置OBS转储 命名空间 SYS.DWS 集群监控指标 通过云监控提供的数据仓库服务相关监控指标，用户可以获取有关集群运行状况和性能的信息，并深入了解节点级别的对应信息。 数据仓库服务相关监控指标，具体请参见下表。 指标ID 指标名称 指标含义 取值范围 测量对象 监控周期（原始指标） dws001sharedbufferhitratio 缓存命中率 该指标用于表示需要访问的数据，在内存中可以直接获取的数据量比例，以百分比为单位。 0%～100% 数据仓库集群 4分钟 dws002inmemorysortratio 内存中排序比率 该指标用于表示在数据进行排序时，可以直接在内存中排序的数据量比例，以百分比为单位。 0%～100% 数据仓库集群 4分钟 dws003physicalreads 文件读取次数 该指标用于表示读取数据库文件的累计次数。 > 0 数据仓库集群 4分钟 dws004physicalwrites 文件写入次数 该指标用于表示写入数据库文件的累计次数。 > 0 数据仓库集群 4分钟 dws005physicalreadspersecond 每秒文件读取次数 该指标用于表示每秒读取数据库文件的次数。 ≥0 数据仓库集群 4分钟 dws006physicalwritespersecond 每秒文件写入次数 该指标用于表示每秒写入数据库文件的次数。 ≥0 数据仓库集群 4分钟 dws007dbsize 数据量大小 该指标用于表示数据库中所有数据总量大小。 单位：兆字节（MB） ≥0MB 数据仓库集群 4分钟 dws008activesqlcount 活跃SQL数 该指标用于表示数据库当前活动的SQL个数。 ≥0 数据仓库集群 4分钟 dws009sessioncount 会话数 该指标用于表示数据库当前访问的连接个数。 ≥0 数据仓库集群 4分钟 dws010cpuusage CPU使用率 该指标用于统计每个集群节点的CPU使用率，以百分比为单位。 0%～100% 数据仓库节点 1分钟 dws011memusage 内存使用率 该指标用于统计每个集群节点的内存使用率，以百分比为单位。 0%～100% 数据仓库节点 1分钟 dws012iops IOPS 该指标用于统计每个集群节点每秒处理的I/O请求数量。 ≥0 数据仓库节点 1分钟 dws013bytesin 网络输入吞吐量 该指标用于统计每秒从网络输入每个集群节点的数据总量。 单位：字节/秒 ≥0字节/秒 数据仓库节点 1分钟 dws014bytesout 网络输出吞吐量 该指标用于统计从每个节点每秒发送到网络的数据总量。 单位：字节/秒 ≥0字节/秒 数据仓库节点 1分钟 dws015diskusage 磁盘利用率 该指标用于统计每个集群节点的磁盘使用情况，以百分比为单位。 0%～100% 数据仓库节点 1分钟 dws016disktotalsize 磁盘总大小 该指标用于统计每个集群节点的数据磁盘总大小。 单位：吉字节（GB） 100GB～2000GB 数据仓库节点 1分钟 dws017diskusedsize 磁盘使用量 该指标用于统计每个集群节点的数据磁盘已用大小。 单位：吉字节（GB） 0GB～3600GB 数据仓库节点 1分钟 dws018diskreadthroughput 磁盘读吞吐量 该指标用于统计集群节点数据磁盘每秒读取的数据量。 单位：字节/秒 ≥0字节/秒 数据仓库节点 1分钟 dws019diskwritethroughput 磁盘写吞吐量 该指标用于统计集群节点数据磁盘每秒写入的数据量。 单位：字节/秒 ≥0字节/秒 数据仓库节点 1分钟 dws020avgdisksecperread 磁盘读耗时 该指标用于统计集群节点数据磁盘每次读取数据的平均耗时。 单位：秒 > 0秒 数据仓库节点 1分钟 dws021avgdisksecperwrite 磁盘写耗时 该指标用于统计集群节点数据磁盘每次写入数据的平均耗时。 单位：秒 > 0秒 数据仓库节点 1分钟 dws022avgdiskqueuelength 磁盘平均队列长度 该指标用于统计每个集群节点数据磁盘平均的I/O队列长度。 ≥0 数据仓库节点 1分钟

类别 影响 大key 客户端查询大key时，执行命令的时长变慢。 集群规格实例，存在大key会使得某个分片的内存占用远超于其他分片，导致内存资源利用不均衡。 若存在对大key的高频率请求，会导致redis实例出方向带宽被打满，导致流控，从而影响本身业务其他使用到redis的业务。 大key占用过高，使得Redis内存使用达到上限，导致重要的Key被逐出，甚至引发内存溢出。 热key 占用cpu资源，影响其他请求，导致整体性能降低。 易造成缓存击穿，即当热Key的请求数超出Redis的承受能力时,大量请求将直接访问后端数据库，导致数据库压力激增甚至宕机，从而影响其他业务。 集群规格实例下，某个分片存在热key，会导致当前分片的请求压力增加，易产生单分片性能瓶颈。

修改库名和修改表名 对于库重命名和表重命名，TaurusDB与社区MySQL的用法是相同的。 支持修改表名：rename table a to b; 注意，该语句是可以跨库执行的，比如：rename table da.ta to db.ta;是将ta表从da库移动到db库。 不支持修改库名，如果有修改库名的需求，可以先创建新的库名，然后借助rename table的跨库执行将所有表从原库移动到新库，然后删除原库。语句示例： 进入原库 use ta; 列出原库的所有表名 Show tables; 查看原库的创建语句 Show create database ta; 使用原库的创建语句创建新库(只改库名，其他参数照抄，这样能尽量保证新库与原库的各类参数相同) create database tb； 将原库所有表移动至新库 rename table da.ta to db.ta; rename table da.tb to db.tb; rename table da.tc to db.tc; … 删除原库 Drop database ta; 字符集和字符序的默认选择方式 相关变量设置 参数组中默认charactersetserverutf8、collationserverutf8generalci，可以在界面修改参数值。 默认选择方式 在创建数据库时，如果未显式指定库的字符集和字符序，则库的字符集和字符序采用charactersetserver和collationserver参数的值；如果显式指定，则使用指定的字符集和字符序。 在创建数据表时，如果未显式指定表的字符集和字符序，则表默认字符集和字符序使用所在数据库的字符集和字符序；如果显式指定，则使用指定的字符集和字符序。 在创建数据表时，如果未显式指定字段的字符集和字符序，则字段使用所在表的字符集和字符序；如果显式指定，则使用指定的字符集和字符序。 示例1：不显式指定字符集、字符序的情况下创建数据库和数据表。 示例2：显式指定库的字符集、字符序的情况下创建数据库。 示例3：显式指定表的字符集、字符序的情况下创建数据表。 示例4：显式指定字段的字符集、字符序的情况下创建数据表。

本章节指导如何通过周期性备份实现云主机备份。 通过创建云主机备份策略，您可以按照一定的策略要求对云主机数据进行周期性备份，以便云主机在数据丢失或损坏时快速恢复数据，保证业务正常运行。 说明 通过备份策略的方式对云主机进行周期性备份，仅当启用备份策略后，系统才会自动备份所关联的云主机，并定期删除过期的备份。 新创建的备份策略默认为“启用”状态。 周期性备份产生的备份名称为“autobkxxxx”。 每个用户最多只能创建32个备份策略。 一个备份策略中最多可以绑定64个云主机。 启用数据库服务器备份特性前，已成功安装客户端。该能力仅在部分资源池支持。 如果您想使用弹性云主机的备份创建镜像，请确保弹性云主机在备份前已完成如下操作： 注意 建议在业务量较小的时间段执行应用一致性备份。 操作步骤 1. 登录天翼云官网，注册天翼云账号。 2. 登录云主机备份管理控制台。 登录管理控制台。 选择“存储 > 云主机备份”。 3. 在界面右上角单击“创建云主机备份”。 4. 在服务器列表中勾选需要备份的主机以及或磁盘，勾选后将在已勾选服务器列表区域展示。 注意 考虑到恢复后数据的一致性问题，我们推荐您对整个服务器进行备份。若您希望选择部分磁盘备份以节省成本，请尽量确保这些磁盘的数据不受其他未备份磁盘的数据影响，否则可能会导致数据不一致问题。例如，Oracle应用的数据分散在不同磁盘上，如果只备份了部分磁盘，会导致恢复后数据不一致（已备份磁盘恢复到历史时间点数据，未备份磁盘仍保留当前数据），甚至导致应用无法启动。 所选云主机的状态必须为“运行中”或“已停止”。 5. 在下方的“备份配置”区域为已选择的云主机配置备份方式为自动备份，如下图所示。 需要在“备份策略”的下拉菜单中，选择一个已有的备份策略，或者单击右侧的“创建策略”创建一个新的备份策略。在备份创建完成后，所选云主机会绑定到该备份策略中，按照备份策略进行周期性备份。 说明 如果选择的云主机已经绑定到其他备份策略，在选择新的备份策略后，云主机会自动从原备份策略解绑，并绑定到新的备份策略。 需要输入备份的“名称”和“描述”，如下表所示。 参数 说明 备注 名称 输入待创建的备份的名称。 只能由中文字符、英文字母、数字、下划线、中划线组成，且长度小于等于255个字符。 说明：也可以采用默认的名称，默认的命名规则为“manualbkxxxx”。 备份多个云主机时，系统自动增加后缀，例如：备份0001，备份0002。 manualbkcbf0 描述 输入待创建的备份的描述。描述长度小于等于255个字符。 说明 使用数据库服务器备份前，需先更改安全组和成功安装客户端。相关操作请参见 6. 选择是否启用“数据库服务器备份”（立即备份时可选）。启用后，系统将执行数据库服务器备份（应用一致性备份）。若同时勾选“数据库服务器备份失败后继续备份”，数据库服务器备份失败后系统将执行崩溃一致性备份，若不勾选，数据库服务器备份失败后将直接产生失败备份。如下图所示。 图 数据库服务器备份 7. 单击“立即申请”。 8. 在“规格确认”页面上，查看“详情”，单击“提交申请”。 9. 根据页面提示，返回云主机备份页面。

本页介绍天翼云TeleDB数据库元数据pgtransparentcryptpolicyalgorithm的内容。 存储透明加密中的算法策略。 名称 类型 定义 algorithmid int16 加密算法的ID option int16 加密选项 algorithmname NameData 加密算法的名称 encryptoid Oid 加密函数的OID decryptoid Oid 解密函数的OID password text 密码 pubkey text 公钥 privatekey text 私钥 optionargs text 加密选项的参数

本页介绍天翼云TeleDB数据库存储过程开发的GOTO语句。 plaintext teledb create or replace procedure pgoto(vmaxnum integer) as $$ declare maxnum integer; begin maxnum : vmaxnum; for i in 1..maxnum loop if i3 then goto label; end if; raise notice 'i%',i; end loop; > raise notice 'goto end'; end; $$ language plpgsql; CREATE PROCEDURE teledb call pgoto(5); NOTICE: i1 NOTICE: i2 NOTICE: goto end CALL teledb go 用于跳转到某个标签下。

本页介绍天翼云TeleDB数据库存储过程开发的GOTO语句。 plaintext teledb create or replace procedure pgoto(vmaxnum integer) as $$ declare maxnum integer; begin maxnum : vmaxnum; for i in 1..maxnum loop if i3 then goto label; end if; raise notice 'i%',i; end loop; > raise notice 'goto end'; end; $$ language plpgsql; CREATE PROCEDURE teledb call pgoto(5); NOTICE: i1 NOTICE: i2 NOTICE: goto end CALL teledb go 用于跳转到某个标签下。

本页介绍天翼云TeleDB数据库节点组管理。 操作场景 将节点分组有利于对节点进行管理。 操作步骤 1. 切换至TeleDB控制台，在左侧导航单击实例列表 。 2. 单击目标实例所在行的详情，进入实例详情页面。 3. 进入实例详情页面，选择节点组管理 ，单击新增节点组 ，出现新增节点组对话框。 4. 在新增节点组对话框，输入节点组名 和选择DN节点 ，单击确定 完成节点组添加。

本页介绍天翼云TeleDB数据库元数据pgclientglobalkeys的内容。 存储管理CMK基本信息。 名称 类型 定义 globalkeyname name 客户端加密主密钥（cmk）名称。 keynamespace oid 包含此客户端加密主密钥（cmk）的命名空间oid。 keyowner oid 客户端加密主密钥（cmk）的所有者。 keyacl aclitem[] 创建该密钥时所拥有的访问权限。 createdate timestamp 创建密钥的时间。

本页介绍了如何通过数据传输服务DTS将DDS/MongoDB数据迁移到DDS/MongoDB云数据库。 前提条件 源端 账号权限要求： 全量迁移，需要具备admin库的readAnyDatabase权限、clusterMonitor权限。 增量迁移，需要具备admin库的readAnyDatabase权限、clusterMonitor权限，local库的read权限。 或者具备超级用户权限。 目标端 账号权限要求： admin库的dbAdminAnyDatabase权限、readWriteAnyDatabase权限、clusterMonitor权限。 或者具备超级用户权限。 其他要求： 已创建文档数据库服务DDS。 操作步骤 副本集到副本集迁移详细信息请参考：数据传输服务DTS​>用户指南​>数据迁移​>入云​>将DDS/MongoDB副本集迁移到DDS/MongoDB副本集。 分片集群到分片集群迁移详细信息请参考：数据传输服务DTS​>用户指南 数据迁移​>入云​>将DDS/MongoDB分片集迁移到将DDS/MongoDB分片集群。 副本集到分片集群迁移详细信息请参考：数据传输服务DTS​>用户指南 数据迁移​>入云​>将DDS/MongoDB副本集迁移到将DDS/MongoDB分片集群。

本页介绍了按需计费实例转包周期计费。 操作说明 文档数据库服务支持将按需计费实例转为包周期（包年/包月） 实例，由于按需资源较贵，需要长期使用资源的按需用户可以选择对按需资源进行转包周期，继续使用这些资源的同时，享受包周期一年85折、两年7折、三年5折的优惠政策的低资费。 约束限制 按需计费实例状态为“运行中”时才能转包周期。 操作步骤 1. 登录TeleDB数据库控制台。 2. 在“DDS”>“实例管理”页面，在需要转包周期的实例的最右边点击更多，点击“按需转包周期”。 3. 随后跳转到“按需转包周期”页面，选择续订时长，以月为单位，最小包周期时长为一个月，确定订单信息无误后，单击“支付”，完成支付。 4. 按需转包周期创建成功后，用户可以在DDS”>“实例管理”页面进行查看，在实例列表的右上角，点击刷新按钮，可查看到按需转包周期完成后，实例的“计费模式”显示为“包年/包月”。

本页面介绍了云数据库ClickHouse服务到期与欠费相关情况。 服务到期与欠费都会影响您的实例的正常使用。 服务到期 “按需计费”实例，无需担心服务到期问题。 “包年/包月”实例到期后将会被暂停，在暂停期间您无法通过数据库管理控制台对该实例进行操作，无法调用相关接口，监控告警等服务也会停止。如果您没有在暂停期内续费，那么该实例的服务将被终止，并且系统中的数据也将被永久删除。为了避免数据丢失，我们强烈建议您在暂停期内及时续费，或者提前备份数据并另行妥善保存。 欠费 “包年/包月”实例，无需担心欠费问题。 “按需计费”实例是按每小时扣费，当余额不足，无法对上一个小时的费用进行扣费，就会导致实例欠费，实例将会被暂停。您续费后暂停的实例，可继续正常使用，请注意在暂停期进行的续费，是以原到期时间作为生效时间，您应当支付从进入暂停期开始到续费时的服务费用。

本章节介绍，当不需要启用数据库服务器备份功能时，如何卸载已经完成安装的Agent。 操作场景 该任务指导用户在不需要启用数据库服务器备份功能时，卸载Agent。 前提条件 已获取弹性云主机的登录帐号和密码。 卸载Linux版本Agent 步骤1、登录需要卸载Agent的弹性云主机，并执行su root 命令切换到root用户。 步骤2、在/home/rdadmin/Agent/bin目录下执行以下命令，卸载Agent。如下图所示。若出现绿色卸载成功字样，表示Agent卸载成功。 sh agentuninstallebk.sh 卸载Linux Agent成功 卸载Windows版本Agent 步骤1、登录需要卸载Agent的弹性云主机。 步骤2、在安装目录的bin目录下选中agentuninstallebk.bat双击打开，卸载Agent。 系统卸载Agent完成后，弹窗自动关闭，卸载成功。如下图所示。 卸载Windows Agent成功

本节主要介绍恢复方案 DDS支持多种数据恢复方案，您可以根据业务需要选择合适的恢复方法。 表 恢复方案 恢复类型 支持的实例类型 使用场景 恢复备份到新实例 集群、副本集 使用已有的自动备份文件或手动备份文件恢复实例数据到新建实例。 恢复备份到当前实例 集群、副本集 使用已有的自动备份文件或手动备份文件恢复实例数据到当前实例。 恢复实例备份到指定时间点 集群、副本集 适用于实例级数据恢复场景，将数据还原至某个指定的时间点。 恢复库表到指定时间点 副本集 适用于库表级数据恢复场景，将数据还原至某个指定的时间点。 恢复备份数据到本地自建数据库 集群、副本集 您可以将DDS的备份文件下载到本地，将数据恢复至本地自建数据库。 通过mongorestore工具恢复数据 集群、副本集 您可以通过MongoDB客户端自带的备份恢复工具恢复数据。 通过mongoimport工具恢复数据 集群、副本集 您可以通过MongoDB客户端自带的备份恢复工具恢复数据。

接口功能介绍 快照策略功能请联系客户经理开通。 幂等接口，重复取消会忽略并视为取消成功。 注意！若云电脑与快照策略不存在分配关系，取消时会直接忽略。 接口约束 无 URI POST /v3/snapshotPolicy/cancelFromDesktops 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 snapshotPolicyOid 是 String 快照策略ID。 sspgg7576hc59fkph1b3xe4y desktopOidList 是 Array of Strings 云电脑ID列表。长度限制[1,10]。 D0023092201180710 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 ok returnObj Object 返回数据结构体。 returnObj 枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body {"snapshotPolicyOid":"sspxxx","desktopOidList":["XXXXXXXXXXXXX6925"]}

参数 说明 名称 （必填）填入自定义主机资源名。 IP地址/域名 （必填）填入主机的IP地址或域名。 协议类型 （必填）选择主机资源的协议类型，仅能填写一种类型。 端口 （必填）填入主机端口。 系统类型 填入主机的系统类型。 所属部门 （必填）填入资源所归属的部门，需完整填写部门结构。 仅可填入一组部门层级，一个资源只能分属一个部门。 默认可填入部门为总部，部门上下级之间用“，”隔开。 请务必确保填入系统内已创建的查询部门配置。 标签 填入主机资源标签。 可填入多个标签，标签之间用“，”隔开。 主机描述 填入对主机资源的简要描述。 主机帐户 填入主机资源账户名称。 不填写，也不会生成Empty帐户。 登录方式 选择主机资源登录方式。 可选择自动登录、手动登录、提权登录。 特权帐户 选择是否设置资源账户为特权帐户。 可选择是或否。 密码 填入资源账户的登录密码。 SSH Key 针对SSH协议类型主机，可填入登录SSH Key验证。 配置后优先使用SSH Key登录资源。 passphrase 填入SSH Key对应私钥序列。 若您已生成私钥密码，每次登录主机需手动输入私钥密码。 Oracle参数 针对Oracle协议类型主机，必须填入参数。 可选择SERVICENAME或SID 可填入多个参数，参数之间用“，”隔开。 SERVICENAME或SID 针对Oracle协议类型主机，必须填入参数值。 可填入多个参数值，参数值之间用“，”隔开。 登录角色 针对Oracle协议类型主机，必须填入参数。 可选择normal、sysdba、sysoper 可填入多个参数，参数之间用“，”隔开。 数据库名 针对DB2数据库，必须填入参数。 可选择数据库名、实例名。 可填入多个参数，参数之间用“，”隔开。 实例名 针对DB2数据库，必须填入参数。 可选择数据库名、实例名。 可填入多个参数，参数之间用“，”隔开。 切换自 针对SSH协议类型主机，填入SSH主机资源账户名称，将该帐户提权为特权帐户。 切换命令 填入切换帐户的执行命令。 帐户描述 填入对资源账户的简要描述。 帐户组 填入资源账户所属的帐户组。 资源账户可同时存在于同部门多个帐户组，不同帐户组之间用“，”隔开。 请务必确保填入系统内已创建的帐户组。

参数 是否必选 说明 数据连接名称 是 数据连接的名称，只能包含英文字母、数字、下划线和中划线，且长度为1~50个字符。 标签 否 标识数据连接的属性。设置标签后，便于统一管理。 说明 标签的名称，只能包含中文、英文字母、数字和下划线，不能以下划线开头。且长度不能超过100个字符。 手动 是 通过单击或来关闭或开启手动开关： 当“手动”关闭时候，“IP”和“端口”不需要填写。 当“手动”打开时候，“IP”和“端口”需要填写。 IP 否 “手动”打开时需要填写该项，表示通过内部网络访问集群数据库的IP地址。内网访问IP地址在创建集群时自动生成。 端口 否 “手动”打开时需要填写该项，表示创建DWS集群时指定的数据库端口号。请确保您已在安全组规则中开放此端口，以便DataArts Studio实例可以通过该端口连接DWS集群数据库。 SSL连接 是 DWS支持SSL通道加密和证书认证两种方式进行客户端与服务器端的通信。您可以通过服务器端是否强制使用SSL连接进行设置。开关打开，即只能通过SSL方式连接。开关关闭，即两种方式均可。默认关闭。 集群名 是 选择DWS集群。 用户名 是 数据库的用户名，创建DWS集群时指定的用户名。 密码 是 数据库的访问密码，创建DWS集群时指定的密码。 KMS密钥 是 KMS密钥名称。 连接方式 是 选择所需的连接方式，推荐使用“通过代理连接”。 通过代理连接：通过Agent（即CDM集群）进行代理连接访问DWS集群。 直接连接：直接访问DWS集群。 绑定Agent 否 通过代理连接的时候，是必选项。 DWS为非全托管服务，DataArts Studio无法直接与非全托管服务进行连接。CDM集群提供了DataArts Studio与非全托管服务通信的代理，所以创建DWS的数据连接时，请选择一个CDM集群。如果没有可用的CDM集群，请先通过数据集成增量包进行创建。 CDM集群作为网络代理，必须和DWS集群网络互通才可以成功创建MRS连接，为确保两者网络互通，CDM集群必须和DWS集群处于相同的区域、可用区、VPC和子网，安全组规则需允许两者网络互通。

本文主要介绍添加副本集实例节点 文档数据库服务的三节点副本集实例，支持新增节点至五节点和七节点架构，新增节点均为Secondary节点，且可以参与到主备切换中，提高数据高可靠性。 说明 目前此功能仅支持白名单用户使用，需要提交工单申请才能使用。 使用须知 实例状态为正常、删除备份中和恢复检查中时可以添加节点。 实例进行添加节点时，该实例不可被删除。 新添加的备节点，需要重新配置高可用连接地址，且为保证实例性能，会有12个小时的冻结期，冻结期内的备节点不参与主备切换。 暂不支持手动删除添加的节点。 计费说明 对于按需计费的实例，添加节点后，依旧按使用时长实时计费。 对于包年/包月的实例，添加节点后，差价需补交。 计费详情请参见产品价格详情。 操作步骤 步骤 1 登录管理控制台。 步骤 2 单击管理控制台左上方的，选择区域和项目。 步骤 3 在页面左上角单击，选择“数据库 > 文档数据库服务 DDS”，进入文档数据库服务信息页面。 步骤 4 在“实例管理”页面，选择指定的副本集实例，单击实例名称。 步骤 5 在“基本信息”页面的“节点信息”区域，单击“变更备节点”。 基本信息 步骤 6 在“变更备节点”页面，选择节点数，单击“下一步”。 选择节点数 副本集实例支持增加至五节点或七节点。 步骤 7 在确认页面，确认节点信息。 包年/包月 如需重新选择，单击“上一步”，修改相关配置。 核对无误后，单击“提交订单”，进入付款页面，选择支付方式，完成支付。 按需计费 如需重新选择，单击“上一步”，修改相关配置。 核对无误后，单击“提交”，开始添加节点。 步骤 8 查看添加节点结果。 添加节点过程中，实例运行状态显示为“节点扩容中”，整个添加节点的过程持续15分钟左右。 在实例“基本信息”页面的“节点信息”区域，可查看新增节点信息。 节点信息

检查DBService服务 4.在FusionInsight Manager界面，选择“集群 > 待操作集群的名称 > 服务”，检查DBService服务当前状态是否正常。 是，执行步骤6。 否，执行步骤5。 5.参考DBService服务的相关告警帮助进行处理，然后查看本告警是否恢复。 是，处理完毕。 否，执行步骤18。 6.登录Oozie数据库检查数据是否完整。 a.以root用户登录DBService主节点。 在FusionInsight Manager界面，选择“集群 > 待操作集群的名称 > 服务 > DBService > 实例”，即可查看DBService主节点IP地址信息。 b.执行以下命令登录Oozie数据库。 su omm source ${BIGDATAHOME}/FusionInsightBASE8.1.0.1/install/FusionInsightdbservice2.7.0/.dbserviceprofile gsql U 用户名W Oozie数据库密码p 20051 d 数据库名称 c.登录成功后，输入 d ，检查数据表是否共有15张。 Oozie服务默认有15张数据表，如果这些数据表被删除或者表结构被修改都可能导致Oozie服务不可用，请联系运维人员备份相关数据后进行恢复。 检查HDFS服务。 7.在FusionInsight Manager界面，选择“集群 > 待操作集群的名称 > 服务”，检查HDFS服务当前状态是否正常。 是，执行步骤9。 否，执行步骤8。 8.参考HDFS服务的相关告警帮助进行处理，然后查看本告警是否恢复。 是，处理完毕。 否，执行步骤18。 9.登录HDFS检查Oozie文件目录是否完整。 a.下载并安装HDFS客户端。 b.以root用户登录客户端所在节点，执行以下命令，检查“/user/oozie/share”路径是否存在。 如果集群采用安全版本，要进行安全认证。 kinit admin hdfs dfs ls /user/oozie/share 是，执行步骤18。 否，执行步骤10。 10.在Oozie客户端安装目录中手动将share目录上传至HDFS的“/user/oozie”路径下，检查告警是否恢复。 是，处理完毕。 否，执行步骤18。