检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API说明 可用区 集群管理 快照管理 事件管理 数据源 审计日志 资源管理 告警管理 连接管理 标签管理 配额管理 容灾管理 任务管理 主机监控 数据库权限管理 日志管理 升级管理
API概述 数据仓库服务所提供的接口为自研接口。通过配合使用数据仓库服务自研接口，您可以使用数据仓库服务的如下功能。 表1 API接口 类型 API 说明 集群管理接口 创建集群前检查 创建集群前预检查。 创建集群 创建集群。 查询集群列表 查询并显示集群列表。 查询集群详情 查询集群详情。
云商店开放接口指南 接口使用方法 公共参数 接口列表 公共错误码 APIGW网关错误码 开放接口示例代码 父主题： 联营License客户端软件对接指南
GaussDB(DWS)数据库对象设计规则 GaussDB(DWS) Database和Schema设计规则 GaussDB(DWS)表设计规则 GaussDB(DWS)字段设计规则 GaussDB(DWS)约束设计规则 GaussDB(DWS)视图和关联表设计规则 父主题： GaussDB(DWS)各对象设计详细规则
对外API规范 API规范示例 为了对外API在调用时有用户信息，API调用时需要在header中传递Modifier、Creator字段。 值格式为：用户名+空格+用户id，如图1所示。
utile接口 GS_226100023 错误码： could not determine which collation to use for %s function. 解决方案：使用COLLATE子句显式设置排序规则。 level： ERROR GS_226100025 错误码：
使用Postman调用创建快照接口 场景描述 本章节指导用户使用Postman调用创建快照接口。API的调用方法请参考如何调用API。 涉及接口 调用该接口时，需要进行认证鉴权，涉及的接口如下： 认证鉴权：经过身份认证，获得操作API的权限。 创建快照：通过该接口创建集群的快照。 操作步骤
USER对象设计规范 规则2.5 禁止使用特殊权限用户运行业务，需遵循权限最小分配原则 违反规则的影响： 特殊权限用户如管理员用户，均具有特殊用途，使用此类用户运行业务有安全和管控风险。 方案建议： 使用普通用户运行业务，特殊权限类用户仅用于管理类操作。 规则2.6 禁止使用一个数据库用户运行所有业务
GaussDB(DWS)字段设计规则 选择数据类型 在字段设计时，基于查询效率的考虑，一般遵循以下原则： 【建议】尽量使用高效数据类型。 选择数值类型时，在满足业务精度的情况下，选择数据类型的优先级从高到低依次为整数、浮点数、NUMERIC。 【建议】当多个表存在逻辑关系时，表示同一含义的字段应该使用相同的数据类型。
GaussDB(DWS)表设计规则 GaussDB(DWS)是分布式架构。数据分布在各个DN上。总体上讲，良好的表设计需要遵循以下原则： 【关注】将表数据均匀分布在各个DN上。数据均匀分布，可以防止数据在部分DN上集中分布，从而导致因存储倾斜造成集群有效容量下降。通过选择合适的分布列，可以避免数据倾斜。
循以下原则： 【关注】一张表上只能建立一个PCK，一个PCK可以包含多列，但是一般不建议超过2列。 【建议】针对表达式过滤条件列创建PCK（形如col op const，op为操作符 =、>、>=、<=、<，const为常量值）。 父主题： GaussDB(DWS)对象设计规范
使用Postman调用创建集群接口 场景介绍 本章节指导用户使用Postman创建GaussDB(DWS)集群。该接口为异步接口，创建集群需要10～15分钟。API的调用方法请参考如何调用API。 准备工作 已注册华为云账号并开通华为云，完成实名认证，请参见注册华为账号并开通华为云。
JDBC接口参考 JDBC接口是一套提供给用户的API方法，本节将对部分常用接口做具体描述，若涉及其他接口可参考JDK1.6（软件包）/JDBC4.0中相关内容。 java.sql.Connection java.sql.Connection是数据库连接接口。 表1 对java.sql
GaussDB(DWS)约束设计规则 DEFAULT和NULL约束 【建议】如果能够从业务层面补全字段值，则不建议使用DEFAULT约束，避免数据加载时产生不符合预期的结果。 【建议】给明确不存在NULL值的字段加上NOT NULL约束，优化器会在特定场景下对其进行自动优化。 【
ODBC接口参考 ODBC接口是一套提供给用户的API函数，本节将对部分常用接口做具体描述，若涉及其他接口可参考msdn（网址：https://msdn.microsoft.com/en-us/library/windows/desktop/ms714177(v=vs.85).aspx）中ODBC
GaussDB(DWS)字段设计规则 选择数据类型 在字段设计时，基于查询效率的考虑，一般遵循以下原则： 【建议】尽量使用高效数据类型。 选择数值类型时，在满足业务精度的情况下，选择数据类型的优先级从高到低依次为整数、浮点数、NUMERIC。 【建议】当多个表存在逻辑关系时，表示同一含义的字段应该使用相同的数据类型。
USER对象设计规范 规则2.5 禁止使用特殊权限用户运行业务，需遵循权限最小分配原则 违反规则的影响： 特殊权限用户如管理员用户，均具有特殊用途，使用此类用户运行业务有安全和管控风险。 方案建议： 使用普通用户运行业务，特殊权限类用户仅用于管理类操作。 规则2.6 禁止使用一个数据库用户运行所有业务
BY显式指定分布方式和分布列，分布列选择原则如下表所示。 表1 分布列选择原则 分布方式 描述 适用场景 Hash 表数据按照分布列生成的hash值与DN实例的映射关系，将数据分布到各DN实例。 优点：每个DN仅包含部分数据，占用整体空间小。 缺点：数据分布的均匀程度强依赖分布列的选择；JOIN关联条件不包含各自分布列的场景存在节点间数据通信的消耗。
JDBC接口参考 JDBC接口是一套提供给用户的API方法，本节将对部分常用接口做具体描述，若涉及其他接口可参考JDK1.6（软件包）/JDBC4.0中相关内容。 java.sql.Connection java.sql.Connection是数据库连接接口。 表1 对java.sql
BY显式指定分布方式和分布列，分布列选择原则如下表所示。 表1 分布列选择原则 分布方式 描述 适用场景 Hash 表数据按照分布列生成的hash值与DN实例的映射关系，将数据分布到各DN实例。 优点：每个DN仅包含部分数据，占用整体空间小。 缺点：数据分布的均匀程度强依赖分布列的选择；JOIN关联条件不包含各自分布列的场景存在节点间数据通信的消耗。
ODBC接口参考 ODBC接口是一套提供给用户的API函数，本节将对部分常用接口做具体描述，若涉及其他接口可参考msdn（网址：https://msdn.microsoft.com/en-us/library/windows/desktop/ms714177(v=vs.85).aspx）中ODBC
GaussDB(DWS)表设计规则 GaussDB(DWS)是分布式架构。数据分布在各个DN上。总体上讲，良好的表设计需要遵循以下原则： 【关注】将表数据均匀分布在各个DN上。数据均匀分布，可以防止数据在部分DN上集中分布，从而导致因存储倾斜造成集群有效容量下降。通过选择合适的分布列，可以避免数据倾斜。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
