华为云用户手册

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 - String OK 状态码： 400 表3 响应Body参数 参数 参数类型 描述 error_code String 错误码 最大长度：64 error_msg String 错误描述 最大长度：512 状态码： 500 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码 最大长度：64 error_msg String 错误描述 最大长度：512

响应示例 状态码： 400 Bad Request 示例 1 { "error_code" : "GSL.00020004", "error_msg" : "参数异常" } 示例 2 { "error_code" : "GSL.00027005", "error_msg" : "登录用户没有自定义属性的访问权限。" } 状态码： 500 Internal Server Error { "error_code" : "GSL.00020003", "error_msg" : "系统繁忙，请稍后重试。" }

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 - String OK 状态码： 400 表3 响应Body参数 参数 参数类型 描述 error_code String 错误码 最大长度：64 error_msg String 错误描述 最大长度：512 状态码： 500 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码 最大长度：64 error_msg String 错误描述 最大长度：512

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。通过调用 IAM 服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 表3 请求Body参数 参数 是否必选 参数类型 描述 down_up_switch 否 Integer 启用停用开关 最小值：0 最大值：2147483647 iccid 否 String iccid，传入的sim_card_id为0,则根据iccid进行处理 最小长度：19 最大长度：20

请求示例 创建SIM卡复机申请，将sim_card_id对应的卡片操作为复用。 POST https://{endpoint}/v1/sim-cards/{sim_card_id}/reset { "down_up_switch" : 2 } 创建SIM卡复机申请。当参数sim_card_id为最小值时，根据iccid，复用卡标识为“8986xxxxxxx”的SIM卡。 POST https://{endpoint}/v1/sim-cards/{sim_card_id}/reset { "down_up_switch" : 2, "iccid" : "8986xxxxxxx" }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 work_order_id Long 业务受理单号 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 403 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 500 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

响应示例 状态码： 200 OK { "work_order_id" : 1000001 } 状态码： 400 Parameter Invalid { "error_code" : "GSL.00010004", "error_msg" : "参数异常" } 状态码： 403 Forbidden { "error_code" : "GSL.00016010", "error_msg" : "您操作的卡仍有未完成的停机受理单，请勿重复操作。" } 状态码： 500 Internal Server Error { "error_code" : "GSL.00010003", "error_msg" : "系统繁忙，请稍后重试。" }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 work_order_id Long 业务受理单号 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 403 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 500 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

请求示例 创建SIM卡停机申请，停用sim_card_id对应的卡片。 POST https://{endpoint}/v1/sim-cards/{sim_card_id}/stop { "down_up_switch" : 1 } 创建SIM卡停机申请。当参数sim_card_id为最小值时，根据iccid，停用卡标识为“8986xxxxxxx”的SIM卡。 POST https://{endpoint}/v1/sim-cards/{sim_card_id}/stop { "down_up_switch" : 1, "iccid" : "8986xxxxxxx" }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 表3 请求Body参数 参数 是否必选 参数类型 描述 down_up_switch 否 Integer 启用停用开关 最小值：0 最大值：2147483647 iccid 否 String iccid，传入的sim_card_id为0,则根据iccid进行处理 最小长度：19 最大长度：20

响应示例 状态码： 200 OK { "work_order_id" : 1000001 } 状态码： 400 Parameter Invalid { "error_code" : "GSL.00010004", "error_msg" : "参数异常" } 状态码： 403 Forbidden { "error_code" : "GSL.00016010", "error_msg" : "您操作的卡仍有未完成的停机受理单，请勿重复操作。" } 状态码： 500 Internal Server Error { "error_code" : "GSL.00010003", "error_msg" : "系统繁忙，请稍后重试。" }

请求示例 创建激活SIM卡申请，将sim_card_id对应的SIM卡激活。 POST https://{endpoint}/v1/sim-cards/{sim_card_id}/enable 创建激活SIM卡申请。当参数sim_card_id为最小值时，将卡标识iccid为“8986xxxxxxxxxxxxxxx”的SIM卡激活。 POST https://{endpoint}/v1/sim-cards/{sim_card_id}/enable { "iccid" : "8986xxxxxxxxxxxxxxx" }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 work_order_id Long 业务受理单号 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 403 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 500 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

响应示例 状态码： 200 OK { "work_order_id" : 1000001 } 状态码： 400 Parameter Invalid { "error_code" : "GSL.00010004", "error_msg" : "参数异常" } 状态码： 403 Forbidden { "error_code" : "GSL.00016015", "error_msg" : "您操作的卡仍有未完成的激活受理单，请勿重复操作。" } 状态码： 500 Internal Server Error { "error_code" : "GSL.00010003", "error_msg" : "系统繁忙，请稍后重试。" }

URI POST /v1/sim-cards/{sim_card_id}/enable 表1 路径参数 参数 是否必选 参数类型 描述 sim_card_id 是 Long SIM卡标识，如果SIM卡标识传0则表示需要根据iccid处理。可通过查询SIM卡列表接口获取 最小值：0 表2 Query参数 参数 是否必选 参数类型 描述 iccid 否 String iccid，传入的sim_card_id为0,则根据iccid进行处理 最小长度：19 最大长度：20

响应示例 状态码： 200 OK [ { "id" : 100000000000, "account_id" : "04eexxxxxxxxxxxx", "sim_card_id" : 100000000000, "status" : 2, "price_plan_id" : "100001", "partner" : 1, "cid" : "8986xxxxxxxxxx", "partner_pid" : "10001", "order_id" : null, "create_time" : "2022-09-16T03:21:22.000+00:00", "active_time" : "2022-09-16T01:14:58.000+00:00", "stop_time" : null, "flow_total" : 30, "flow_used" : 0, "flow_left" : 30, "using" : "0", "price_plan_name" : "中国联通消费级每月30M联接服务（1年）", "description" : null, "package_type" : 1, "effect_type" : 1, "silent_period_day" : 6, "silent_period_unit" : 2, "auto_renew" : 0, "location_desc" : "中国" } ] 状态码： 400 Parameter Invalid { "error_code" : "GSL.00010004", "error_msg" : "参数异常" } 状态码： 500 Internal Server Error { "error_code" : "GSL.00010003", "error_msg" : "系统繁忙，请稍后重试。" }

URI GET /v1/sim-price-plans 表1 Query参数 参数 是否必选 参数类型 描述 sim_card_id 是 Long SIM卡标识，可通过查询SIM卡列表接口获取 最小值：0 iccid 否 String iccid，传入的SIM卡标识（sim_card_id）为0,则根据iccid进行处理 最小长度：19 最大长度：20 real_time 否 Boolean 是否查实时流量 缺省值：false limit 否 Long 分页查询时每页显示的记录数，默认值为10，取值范围为10-500的整数 最小值：10 最大值：500 缺省值：10 offset 否 Long 分页查询时的页码数，默认值为1，取值范围为1-1000000的整数 最小值：1 最大值：1000000 缺省值：1

响应示例 状态码： 400 Bad Request 示例 1 { "error_code" : "GSL.00020004", "error_msg" : "参数异常" } 示例 2 { "error_code" : "GSL.00027001", "error_msg" : "自定义属性名称不合法，请检查！" } 示例 3 { "error_code" : "GSL.00027002", "error_msg" : "自定义属性名称已存在，请重新输入！" } 示例 4 { "error_code" : "GSL.00027003", "error_msg" : "自定义属性名称和SIM卡管理列字段重复，请重新输入！" } 示例 5 { "error_code" : "GSL.00027004", "error_msg" : "登录用户最多可以创建6个自定义属性。" } 状态码： 500 Internal Server Error { "error_code" : "GSL.00020003", "error_msg" : "系统繁忙，请稍后重试。" }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 - String OK 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码 最大长度：64 error_msg String 错误描述 最大长度：512 状态码： 500 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 最大长度：64 error_msg String 错误描述 最大长度：512

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 - String OK 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 500 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

响应示例 状态码： 400 Parameter Invalid 示例 1 { "error_code" : "GSL.00010004", "error_msg" : "sim_card_id:不能为null" } 示例 2 { "error_code" : "GSL.00012031", "error_msg" : "[{\"fail_reason\":\"自定义属性三未启用\",\"sim_card_id\":3552016640640009}]" } 状态码： 500 Internal Server Error { "error_code" : "GSL.00010003", "error_msg" : "系统繁忙，请稍后重试。" }

请求示例 批量设置SIM卡自定义属性。例如：批量设置sim_card_id为“4710200000”和“4710300000”的卡片自定义属性值，自定义属性1为“attr1”。 POST https://{endpoint}/v1/sim-cards/attributes/batch-set { "attributes" : [ { "sim_card_id" : 4710200000, "customer_attribute1" : "attr1", "customer_attribute2" : "attr2", "customer_attribute3" : "attr3", "customer_attribute4" : "attr4", "customer_attribute5" : "attr5", "customer_attribute6" : "attr6" }, { "sim_card_id" : 4710300000, "customer_attribute1" : "attr1", "customer_attribute2" : "attr2", "customer_attribute3" : "attr3", "customer_attribute4" : "attr4", "customer_attribute5" : "attr5", "customer_attribute6" : "attr6" } ] } 批量设置SIM卡自定义属性。当参数sim_card_id为最小值时，批量设置卡标识iccid为“8986xxxxxxxxxxxxxxx”和“8987xxxxxxxxxxxxxxx”的卡片自定义属性值，自定义属性1为“attr1”。 POST https://{endpoint}/v1/sim-cards/attributes/batch-set { "attributes" : [ { "sim_card_id" : 0, "iccid" : "8986xxxxxxxxxxxxxxx", "customer_attribute1" : "attr1", "customer_attribute2" : "attr2", "customer_attribute3" : "attr3", "customer_attribute4" : "attr4", "customer_attribute5" : "attr5", "customer_attribute6" : "attr6" }, { "sim_card_id" : 0, "iccid" : "8987xxxxxxxxxxxxxxx", "customer_attribute1" : "attr1", "customer_attribute2" : "attr2", "customer_attribute3" : "attr3", "customer_attribute4" : "attr4", "customer_attribute5" : "attr5", "customer_attribute6" : "attr6" } ] }

请求参数 表1 请求Body参数 参数 是否必选 参数类型 描述 file_temp_id 否 Long 临时文件ID，如果通过接口调用，此字段为空 attributes 否 Array of AttributeReq objects 自定义属性集合 数组长度：1 - 500 表2 AttributeReq 参数 是否必选 参数类型 描述 sim_card_id 是 Long SIM卡标识，如果SIM卡标识传0则表示需要根据iccid处理。 iccid 否 String iccid，如果SIM卡标识传0则表示需要根据iccid处理。 最小长度：19 最大长度：20 customer_attribute1 否 String 自定义属性一 最大长度：100 customer_attribute2 否 String 自定义属性二 最大长度：100 customer_attribute3 否 String 自定义属性三 最大长度：100 customer_attribute4 否 String 自定义属性四 最大长度：100 customer_attribute5 否 String 自定义属性五 最大长度：100 customer_attribute6 否 String 自定义属性六 最大长度：100

如何选择公有云 GaussDB (DWS)或者公有云RDS？ 公有云GaussDB(DWS)和公有云RDS都让您能够在云中运行传统的关系数据库，同时转移数据库管理负载。您可将RDS数据库用于联机事务处理 (OLTP) ，报告和分析，对于大量数据的读（一般是复杂的只读类型查询）支持不足。GaussDB(DWS)利用多节点的规模和资源并使用各种优化法（列存，向量引擎，分布式框架等），专注于联机分析处理（OLAP），为传统数据库对大型数据集的分析及报告工作负荷提供了数量级改善。 当您的数据及查询的复杂性增加时，或者在您要防止报告和分析处理对OLTP工作负荷造成干扰时，GaussDB(DWS)可提供横向扩展能力。 您可以根据下表简单判断什么场景更适合用GaussDB(DWS)或RDS。 表1 OLTP和OLAP特性比较 特性 OLTP OLAP 用户 操作人员，低层管理人员 决策人员，高级管理人员 功能 日常操作处理 分析决策 设计 面向应用 面向主题 数据 最新的，细节的，二维的，分立的 历史的，集成的，多维的，统一的 存取 读/写数十条记录 读上百万条记录 工作范围 简单的读写 复杂的查询 数据库大小 百GB TB-PB级别 父主题： 产品咨询

VACUUM和VACUUM FULL 在GaussDB(DWS)中，VACUUM的本质就是一个“吸尘器”，用于吸收“尘埃”。而尘埃其实就是旧数据，如果这些数据没有及时清理，那么将会导致数据库空间膨胀，性能下降，更严重的情况会导致异常退出。 VACUUM的作用： 空间膨胀问题：清除废旧元组以及相应的索引。包括提交的事务delete的元组（以及索引）、update的旧版本（以及索引），回滚的事务insert的元组（以及索引）、update的新版本（以及索引）、copy导入的元组（以及索引）。 FREEZE：防止因事务ID回卷问题（Transaction ID wraparound）而导致的异常退出，将小于OldestXmin的事务号转化为freeze xid，更新表的relfrozenxid，更新库的relfrozenxid、truncate clog。 更新统计信息：VACUUM ANALYZE时，会更新统计信息，使得优化器能够选择更好的方案执行SQL语句。 VACUUM命令存在两种形式，VACUUM和VACUUM FULL，目前VACUUM对行存表有作用，对列存表无显著的作用，列存表只能依靠VACUUM FULL释放空间。具体区别见下表： 表1 VACUUM和VACUUM FULL 差异项 VACUUM VACUUM FULL 空间清理 如果删除的记录位于表的末端，其所占用的空间将会被物理释放并归还操作系统。而如果不是末端数据，会将表中或索引中dead tuple（死亡元组）所占用的空间置为可用状态，从而复用这些空间。 不论被清理的数据处于何处，这些数据所占用的空间都将被物理释放并归还于操作系统。当再有数据插入后，分配新的磁盘页面使用。 锁类型 共享锁，可以与其他操作并行。 排他锁，执行期间基于该表的操作全部挂起。 物理空间 不会释放。 会释放。 事务ID 不回收。 回收。 执行开销 开销较小，可以定期执行。 开销很大，建议确认数据库所占磁盘页面空间接近临界值再执行操作，且最好选择数据量操作较少的时段完成。 执行效果 执行后基于该表的操作效率有一定提升。 执行完后，基于该表的操作效率大大提升。

语法格式 指定某张表进行分析。 ANALYZE table_name; 对数据库中的所有表（非外部表）进行分析。 ANALYZE; 指定某张表进行VACUUM。 VACUUM table_name; 指定某张表进行VACUUM FULL。 VACUUM FULL table_name; 更多语法参见VACUUM和ANALYZE | ANALYSE。 如果执行VACUUM FULL命令后所占用物理空间无变化（未减少），请确认是否有其他活跃事务（删除数据事务开始之前开始的事务，并在VACUUM FULL执行前未结束）存在，如果有，需等其他活跃事务退出后进行重试。 8.1.3及以上版本中Vacuum/Vacuum Full可在管控面操作调用，详情可参见智能运维。

什么是湖仓一体？ 虽然 数据仓库 和 数据湖 的应用场景和架构不同，但它们并不是对立关系。数据仓库存储结构化的数据，适用于快速的BI和决策支撑，而数据湖可以存储任何格式的数据，往往通过挖掘能够发挥出数据的更大作为，因此在一些场景上二者的并存可以给企业带来更多收益。 湖仓一体，又被称为Lake House，其出发点是通过数据仓库和数据湖的打通和融合，让数据流动起来，减少重复建设。Lake House架构最重要的一点，是实现数据仓库和数据湖的数据/元数据无缝打通和自由流动。湖里的“显性价值”数据可以流到仓里，甚至可以直接被数仓使用；而仓里的“隐性价值”数据，也可以流到湖里，低成本长久保存，供未来的数据挖掘使用。

什么是数据湖？ 在企业内部，数据是一类重要资产已经成为了共识。随着企业的持续发展，数据不断堆积，企业希望把生产经营中的所有相关数据都完整保存下来，进行有效管理与集中治理，挖掘和探索数据价值。 数据湖就是在这种背景下产生的。数据湖是一个集中存储各类结构化和非结构化数据的大型数据仓库，它可以存储来自多个数据源、多种数据类型的原始数据，数据无需经过结构化处理，就可以进行存取、处理、分析和传输。数据湖能帮助企业快速完成异构数据源的联邦分析、挖掘和探索数据价值。 数据湖的本质，是由“数据存储架构+数据处理工具”组成的解决方案。 数据存储架构：要有足够的扩展性和可靠性，可以存储海量的任意类型的数据，包括结构化、半结构化和非结构化数据。 数据处理工具，则分为两大类： 第一类工具，聚焦如何把数据“搬到”湖里。包括定义数据源、制定数据同步策略、移动数据、编制数据目录等。 第二类工具，关注如何对湖中的数据进行分析、挖掘、利用。数据湖需要具备完善的数据管理能力、多样化的数据分析能力、全面的数据生命周期管理能力、安全的数据获取和数据发布能力。如果没有这些 数据治理 工具，元数据缺失，湖里的数据质量就没法保障，最终会由数据湖变质为数据沼泽。 随着大数据和AI的发展，数据湖中数据的价值逐渐水涨船高，价值被重新定义。数据湖能给企业带来多种能力，例如实现数据的集中式管理，帮助企业构建更多优化后的运营模型，也能为企业提供其他能力，如预测分析、推荐模型等，这些模型能刺激企业能力的后续增长。 对于数据仓库与数据湖的不同之处，可以类比为仓库和湖泊的区别：仓库存储着来自特定来源的货物；而湖泊的水来自河流、溪流和其他来源，并且是原始数据。 表2 数据湖与数据仓库的对比 维度 数据湖 数据仓库 应用场景 可以探索性分析所有类型的数据，包括机器学习、数据发现、特征分析、预测等。 通过历史的结构化数据进行数据分析。 使用成本 起步成本低，后期成本较高。 起步成本高，后期成本较低。 数据质量 包含大量原始数据，使用前需要清洗和标准化处理。 质量高，可作为事实依据。 适用对象 数据科学家、数据开发人员为主。 业务分析师为主。

数据智能方案 数据治理中心 DataArts Studio为大型政企客户量身定制跨越孤立系统、感知业务的数据资源智能管理解决方案，实现全域数据入湖，帮助政企客户从多角度、多层次、多粒度挖掘数据价值，实现数据驱动的数字化转型。 数据治理中心 DataArts Studio 的核心主要是 智能数据湖 FusionInsight，包含数据库、数据仓库、数据湖等各计算引擎平台，提供了数据使能的全套能力，支持数据的采集、汇聚、计算、资产管理、数据开放服务的全生命周期管理。 拥有强大的湖、仓、库引擎技术，比如数据湖敏捷构建、 GaussDB数据库 快速迁移，数仓的实时分析等，对应服务如下： 数据库： 关系型数据库包括：云数据库RDS、云数据库GaussDB(for MySQL)、云数据库GaussDB、云数据库PostgreSQL、云数据库 SQL Server等。 非关系型数据库包括：文档数据库服务DDS、云数据库GeminiDB等。 数据仓库：云数据仓库GaussDB(DWS)。 数据湖\湖仓一体： MapReduce服务 MRS， 数据湖探索 DLI等。 数据治理中心：数据治理中心DataArts Studio。

什么是数据库？ 数据库是“按照数据结构来组织、存储和管理数据的仓库”。 广义上的数据库，在20世纪60年代已经在计算机中应用了。但这个阶段的数据库结构主要是层次或网状的，且数据和程序之间具备非常强的依赖性，应用较为有限。 现在通常所说的数据库指的是关系型数据库。关系数据库是指采用了关系模型来组织数据的数据库，其以行和列的形式存储数据，具有结构化程度高、独立性强、冗余度低等优点。1970年关系型数据库的诞生，真正彻底把软件中的数据和程序分开来，成为主流计算机系统不可或缺的组成部分。关系型数据库已经成为目前数据库产品中最重要的一员，几乎所有的数据库厂商新出的数据库产品都支持关系型数据库，即使一些非关系数据库产品也几乎都有支持关系数据库的接口。 关系型数据库的主要用于联机事务处理OLTP（On-Line Transaction Processing）主要进行基本的、日常的事务处理，例如银行交易等场景。