华为云用户手册

OBS简介 对象存储服务 （Object Storage Service，OBS）是一个基于对象的海量存储服务，为客户提供海量、安全、高可靠、低成本的数据存储能力，包括：创建、修改、删除桶，上传、下载、删除对象等。 OBS为用户提供了超大存储容量的能力，适合存放任意类型的文件，适合普通用户、网站、企业和开发者使用。由于OBS是一项面向Internet访问的服务，提供了基于HTTP/HTTPS协议的Web服务接口，用户可以随时随地在任意可以连接至Internet的电脑上，通过OBS管理控制台、OBS客户端访问和管理存储在OBS中的数据。此外，OBS支持REST API接口，可使用户方便管理自己存储在OBS上的数据，以及开发多种类型的上层业务应用。云服务实现了在多地域部署基础设施，具备高度的可扩展性和可靠性，用户可根据自身需要指定地域使用OBS，由此获得更快的访问速度和实惠的服务价格。 有关对象存储服务的更多介绍，请参见《对象存储服务产品简介》。 父主题： 简介

操作步骤 以“root”帐号，通过密钥或密码的方式，登录到服务器。 执行以下命令，递归下载桶中的文件夹（包括文件夹自身）中的所有文件和文件夹到本地路径。 ./obsutil cp obs://obs_path/年月/日 /本地路径 -r -tempFileDir=指定路径 -f 其中： obs_path：OBS桶路径，例如：obs-sap/hana。 年月/日：指的是OBS桶中文件夹的目录，例如：201905/28。 本地路径：指的是文件下载在本地的路径，例如：src1。 tempFileDir=指定路径：分段下载时保存临时文件的文件夹，默认为配置文件中的defaultTempFileDir，用户也可以自定义指定临时文件保存路径。 由于分段下载时生成的临时文件会保存在该目录，请确保运行obsutil的用户对该路径有写权限。 该路径的可用空间需要大于待下载对象的大小。 在obs-sap桶中，以下载2019年5月28日的备份文件到本地路径src1文件夹中为例： ./obsutil cp obs://obs-sap/hana/201905/28 /src1 -r -tempFileDir=/hana/backup -f 关于更多obsutil的操作，请参见《工具指南》中的obsutil章节。

操作步骤 执行下命令对obsutil进行初始化配置。 chmod +x obsutil ./obsutil config -i=ak -k=sk -e=endpoint ak：租户的access key，即创建访问密钥（AK和SK）中的AK。 sk：租户的secert key，即创建访问密钥（AK和SK）中的SK。 endpoint：不同区域的终端节点地址不同，OBS的终端节点地址如表1所示，也可参见地区和终端节点中关于OBS的内容。 表1 终端节点 区 域名 称 区域 终端节点（Endpoint） 华北-北京一 cn-north-1 obs.cn-north-1.myhuaweicloud.com 华北-北京四 cn-north-4 obs.cn-north-4.myhuaweicloud.com 华东-上海二 cn-east-2 obs.cn-east-2.myhuaweicloud.com 华南-广州 cn-south-1 obs.cn-south-1.myhuaweicloud.com 以上命令运行后，会在运行obsutil命令的用户目录（Linux操作系统的“~”目录）下自动生成一个名为.obsutilconfig的配置文件，它包含了obsutil的所有配置信息，具体参数说明请参见配置参数说明。 .obsutilconfig文件中保存有用户的AK和SK等信息，为避免密钥泄露，.obsutilconfig默认为隐藏文件，您可以在运行obsutil命令的用户目录下，使用ls -a 命令查看该文件。 配置完成后，您可以通过执行以下命令检查连通性，确保配置无误。 ./obsutil ls -s 根据回显结果，检查配置结果： 如果返回结果中包含“Bucket number is:”，表明配置正确。 如果返回结果中包含“Http status [403]”，表明访问密钥配置有误。 如果返回结果中包含“A connection attempt failed”，表明无法连接OBS服务，请检查网络环境是否正常。

脚本简介 本脚本使用python开发，适用于Linux系统，本脚本主要作用是将本地文件上传到OBS，并且在本地保留一定时间内的副本，本脚本会调用obsutil客户端来完成上传到OBS的操作。 obsutil是一款用于访问管理华为云对象存储服务（Object Storage Service，OBS）的命令行工具，您可以使用该工具对OBS进行常用的配置管理操作，如创建桶、上传文件/文件夹、下载文件/文件夹、删除文件/文件夹等。对于熟悉命令行程序的用户，obsutil更加适合执行批量处理和自动化任务。 有关obsutil的更多介绍，请参见《工具指南》中的obsutil章节。 父主题： 简介

操作步骤 以“root”帐号，通过密钥或密码的方式，登录到服务器。 执行以下命令，修改配置文件obsutil_adapter.cfg并保存。 vi /opt/huawei/obsutil_adapter/obsutil_adapter.cfg 请参考表1，修改配置参数后保存。 表1 参数配置 参数 说明 示例 obs_path 要上传的OBS桶路径，您可以输入OBS桶名称，也可以在桶名称后指定路径，格式为“桶名称/指定路径”。请根据实际输入OBS桶路径。 obs-sap/hana retry_time 失败重传次数，例如设置为3，表示如果上传失败了还会再重试两次，如果还是上传失败则脚本会退出。 说明： 次数需为整数。 3 modified_interval 上传指定的时间，单位为分钟，在这个时间内修改的文件不上传，例如：5表示5分钟内被修改的文件不上传。 说明： 时间需为整数。 5 reserve_time 文件保留时长，单位为分钟，例如：2880表示backup_archive中的文件本地最多会保留2880分钟。 说明： 时间需为整数。 2880 backup_path 需要备份的路径，备份完成后文件会被移动到backup_archive下。 说明： 支持多路径备份，路径之间用英文半角逗号分隔，例如：/hana/backup/data, /hana/backup/log /hana/backup/data backup_archive 上传成功的文件会归档在此目录下。 本脚本执行时，会先查询backup_archive目录中的文件，如果当前时间和文件时间的差超过reserve_time的值，则文件会删除；然后再去backup_path目录上传文件，上传成功的文件会被归档到backup_archive目录中。 /hana/backup/archive backup_path和backup_archive两个目录必须是独立的，不能重复，每个目录都不能是另一个目录的子目录。请保证两个目录的磁盘空间足够存放备份文件。 为保证上传文件的完整性，同一时间段不能同时运行多个上传脚本，如果重复执行则后执行的脚本会失败。

操作步骤 以“root”帐号，通过密钥或密码的方式，登录到服务器。 在命令行界面，下载解压软件包obsutil_adapter.zip，并解压到/opt/huawei目录下。不同的region软件包下载地址不同，具体请参见表1，此处以华东区域为例： wget https://obs-sap.obs.myhuaweicloud.com/obsutil_adapter/obsutil_adapter.zip -P /opt/huawei 表1 获取软件包 名称 描述 获取方式 obsutil_adapter.zip 软件包。 华北-北京一：wget https://obs-sap-cn-north-1.obs.myhuaweicloud.com/obsutil_adapter/obsutil_adapter.zip -P /opt/huawei 华北-北京四：wget https://obs-sap-cn-north-4.obs.myhuaweicloud.com/obsutil_adapter/obsutil_adapter.zip -P /opt/huawei 华东-上海一：wget https://obs-sap-cn-east-3.obs.cn-east-3.myhuaweicloud.com/obsutil_adapter/obsutil_adapter.zip -P /opt/huawei 华东-上海二：wget https://obs-sap.obs.myhuaweicloud.com/obsutil_adapter/obsutil_adapter.zip -P /opt/huawei 华南-广州：wget https://obs-sap-cn-south-1.obs.myhuaweicloud.com/obsutil_adapter/obsutil_adapter.zip -P /opt/huawei cd /opt/huawei unzip obsutil_adapter.zip -d obsutil_adapter/ obsutil_adapter.py：上传脚本，需要执行的脚本文件，会调用obsutil客户端。 obsutil_adapter.cfg：脚本配置文件。 obsutil：obsutil客户端。 Log目录的路径为/var/log/huawei/obsutil_adapter。

开年采购季购买说明 “新人抢购专区，服务器38元秒杀”活动产品的购买常见问题如下（仅供参考、详情以活动规则为准）： 抢购产品说明：1核2G H ECS云服务器 限购一台，每天9:00开抢，先到先得；如今日已抢完，请次日抢购或者购买其他优惠活动产品。 活动产品买不了的可能原因如下： 未实名认证。 已经参与了一次该活动。 同一用户的其他账号已购买（具备同一证件号（比如身份证号/护照ID/海外驾照ID/企业唯一识别号等）、同一手机号、同一设备、同一IP地址等注册的华为云账号算同一用户）。 已超出产品限购台数（抢购产品1核2G限购一台；其他规则产品限购3台）。 已购买了 华为云产品 （新用户如需购买多个产品，需当天完成支付或者合并订单一起支付）。 有待支付订单（待支付订单会占用对应的购买次数）。 如应特殊原因退订后无法正常购买，请联系对应客户经理反馈，或者提交工单由客服反馈至客户经理联系用户。 售罄（由于部分规格或者部分区域的活动产品较火爆已售罄，建议您购买其他规格、区域的活动产品）。 如有特殊情况，建议您提交工单反馈您的问题。 开年采购季 -企业专区的购买说明如下（仅供参考、详情以活动规则为准。） 活动时间：2022年3月1日-2022年3月31日； 购买限制规则： 同一用户只支持一个账号购买（具备同一证件号（比如身份证号/护照ID/海外驾照ID/企业唯一识别号等）、同一手机号、同一设备、同一IP地址等注册的华为云账号算同一用户）。 父主题： 开年采购季

开年采购季活动规则 “抽奖专区”规则说明（仅供参考、详情以活动规则为准） 活动对象：华为云官网已完成注册和实名认证的用户； 活动时间：2023年3月1日年3月31日； 抽奖说明： （1）用户在活动期间完成个企业实名认证，即得1次抽奖机会；或在活动期间新购订单实付大于1元，得1次抽奖机会；同一用户最多得2次抽奖机会，每次均100%中奖 实物礼品说明： 礼品寄送时间：礼品预计在活动结束后30个工作日内寄出，请您耐心等待； 优惠券说明： 面额： 20元优惠券，均可与活动套餐叠加使用； 有效时间：优惠券仅限2022年3月1日-2022年3月31日活动期间有效 订单类型：不与活动优惠折扣叠加，可用于订购、按需转包周期、变更场景使用，优惠券限于包月、包年、一次性计费类型，订单时长限1年及以内； 数据中心：优惠券限于限用于华北-北京四、华北-北京一、华东-上海一、华东-上海二、华南-广州、西南-贵阳一、中国-香港、亚太-新加坡、亚太-曼谷、拉美-墨西哥城、拉美-圣保罗一、拉美-圣地亚哥、非洲-约翰内斯堡数据中心，其他数据中心不适用； 产品范围：优惠券不可用于以下产品或服务：云市场、内容分发网络、 域名注册服务 、云速建站、 消息通知 服务、 云桌面 、线下产品、会议、 云数据迁移 、 视频点播 、 数据复制服务 、 隐私保护通话 、语音外呼、 媒体处理 、消息&短信、语音通话、联络中心、专属企业存储服务、设备管理、 对象存储迁移 服务、云管理网络、 视频直播 、 主机迁移服务 、ModelArts、华为HiLens、企业计费、华为云 WeLink 、iTA流量、设备接入、 全球SIM联接 、训练服务、 数据湖 服务、模型服务、IoT边缘、联接与协同补录服务、企业协同生态硬件、HiLens Kit、物联网云培训服务、 边缘数据中心管理 、Camera200、IoT数据分析、云管理网络分析服务、华为交互式电子白板、企业协同独立软件，不支持按量（需）产品； 优惠券不支持和渠道折扣、折扣券、其他优惠券叠加使用，每个订单只能使用1张优惠券； 优惠券仅用于用户本账户下使用，不得转让或出售。 所有参加本活动的华为云注册用户，已认可并同意遵守《华为云用户协议》及通过援引的形式加入的附件，包括《可接受的使用政策》，《隐私政策声明》 “新购满额送”规则说明（仅供参考、详情以活动规则为准） 活动对象：华为云电销客户及产业云客户可参与新购满送活动，渠道伙伴客户不参与，其他客户参与前请咨询客户经理； 活动时间：2022年3月1日年3月31日； 参与方式：2022年3月1日-2022年3月31日期间，累计新购实付付费金额达到一定额度，可兑换相应的实物礼品，具体计入新购满额送付费金额的产品范围，详情咨询您的客户经理950808转1； 付费说明：付费金额指订单金额剔除现金券、折扣、优惠券、退订订单等，即用户该笔订单实际付现金额，新购、按需转包周期、变更订单金额可参与活动，续费订单金额不参与此活动，兑换实物奖励的订单不允许退订； 礼品申报：请您在活动结束后5个工作日内以填写工单的形式，反馈您的收货地址；如果过期没有反馈，将取消发放资格； 礼品寄送时间：礼品预计在活动结束后30个工作日内寄出，如遇到产品缺货发货日期可能延后，或发放等价值礼品； 礼品说明：付费金额将于活动结束后统一统计，并兑换相应奖品，奖励不可与主会场、分会场其他活动叠加，即同一用户仅可兑换一个礼品，颜色随机，如果同一个付费金额阶梯有多款奖品可选，默认发放第一个奖品，具体规则如下： 付费门槛 礼品名称 10,000 HUAWEI 风范双肩包 或HUAWEI WATCH FIT new 50,000 HUAWEI WATCH GT Runner 或HUAWEI Sound X 智能音箱 100,000 HUAWEI WATCH GT 2 保时捷设计款 或HUAWEI MateBook D 15 2022款15.6英寸 150,000 HUAWEI P50 Pro 4G 8GB+512GB 或HUAWEI MateBook E 2022款二合一笔记本i5 300,000 HUAWEI MateBook X Pro 2022款 14.2英寸 i7 或HUAWEI Mate 40 RS保时捷设计 “开屏礼包”规则说明（仅供参考、详情以活动规则为准） 活动对象：华为云官网已完成账号注册的用户； 活动时间：2022年3月1日-2022年3月31日； 新购优惠券说明：用户完成注册即可领取 新购通用券（满1500减450、满3500减1050、满5500减1650、满8500减2550），不可叠加页面活动套餐，可用于新购、按需转包周期、变更场景使用，订单时长限1年及以内，限于包月、包年、一次性计费类型； 新购活动券（满2000元减100、满4000减200、满6000减300、满8000减400），可叠加页面活动套餐，可用于新购、按需转包周期、变更场景使用，订单时长限1年及以内，限于包月、包年、一次性计费类型； 数据中心：优惠券限于限用于华北-北京四、华北-北京一、华东-上海一、华东-上海二、华南-广州、西南-贵阳一、中国-香港、亚太-新加坡、亚太-曼谷、拉美-墨西哥城、拉美-圣保罗一、拉美-圣地亚哥、非洲-约翰内斯堡数据中心，其他数据中心不适用； 产品类型：优惠券不可用于以下产品或服务：云市场、CDN、云速建站、域名注册、ModelArts、华为HiLens、HiLens Kit、消息通知服务、设备管理、设备接入、IOT边缘、IOT数据分析、IOT培训、专业服务等、企业协同独立软件和生态硬件、视频直播/点播/媒体处理、消息&短信、隐私保护通话、语音通话、语音外呼、Camera200、华为交互电子白板、联络中心、企业协同终端、云管理网络、云管理网络分析、iTA流量、企业计费、云桌面、专属企业存储服务、模型服务、训练服务、边缘数据中心管理、线下定制产品、H CS /HCSO、迁移类服务，不支持按量（需）产品； 优惠券不支持和渠道折扣、折扣券、其他优惠券叠加使用，每个订单只能使用1张优惠券； 优惠券仅用于用户本账户下使用，不得转让或出售。 优惠券不支持和渠道折扣、折扣券、其他优惠券叠加使用，每个订单只能使用1张优惠券； 优惠券仅用于用户本账户下使用，不得转让或出售； 所有参加本活动的华为云注册用户，已认可并同意遵守《华为云用户协议》及通过援引的形式加入的附件，包括《可接受的使用政策》，《隐私政策声明》 “新人抢购专区”规则说明（仅供参考、详情以活动规则为准）： 活动对象：华为云官网已完成注册和实名认证，限新用户套餐只有从未购买过华为云资源的用户（客户等级是V0）才可购买； 活动时间：2022年3月1日-2022年3月31日； 购买说明： 新用户专享套餐每用户限购1单，具体台数以活动页面为准； 同一用户规则：同一用户是指根据不同华为云账号在注册、登录、使用中的关联信息，华为云判断其实际为同一用户；举例说明：具备同一证件号（比如身份证号/护照ID/海外驾照ID/企业唯一识别号等）、同一手机号、同一设备、同一IP地址等； 套餐配置： 云服务器每款默认配置1个公网IP，40G高IO系统盘，C系列云服务器数据盘为SSD、高IO可选，其他系列云服务器数据盘为高IO，配置全动态独享BGP带宽（华北-北京一、贵阳一为静态BGP带宽）； 非中国大陆数据中心云服务器，重装系统不支持Linux与Windows互相切换； 续费变更：促销价仅适用于购买活动页面套餐，续订变更套餐价格（含升配降配）以当期目录价为准，促销价在该场景下不适用，用户选择升配或降配包周期产品前，具体场景或解释说明，请您浏览阅读《变更资源费用说明》。 为保证活动的公平公正，华为云有权对恶意刷 活动资源（“恶意”是指为获取资源而异常注册账号等破坏活动公平性的行为），利用资源从事违法违规行为的用户收回套餐使用资格 所有参加本活动的华为云注册用户，已认可并同意遵守《华为云用户协议》及通过援引的形式加入的附件，包括《可接受的使用政策》，《隐私政策声明》 “新老用户同享”规则说明（仅供参考、详情以活动规则为准）： 活动对象：华为云官网已完成注册和实名认证的用户； 活动时间：2022年3月1日-2022年3月31日 购买说明： 每用户购买上限为10台； 套餐配置： 云服务器每款默认配置1个公网IP，40G高IO系统盘，C系列云服务器数据盘为SSD、高IO可选，其他系列云服务器数据盘为高IO，配置全动态独享BGP带宽（华北-北京一、贵阳一为静态BGP带宽）； 境外云服务器重装系统不支持Linux与Windows互相切换； 续费变更 促销价仅适用于购买活动页面套餐，续订变更套餐价格（含升配降配）以当期目录价为准，促销价在该场景下不适用，用户选择升配或降配包周期产品前，具体场景或解释说明，请您浏览阅读《变更资源费用说明》（超链接：https://support.huaweicloud.com/usermanual-billing/renewals_topic_60000001.html） 为保证活动的公平公正，华为云有权对恶意刷活动资源（“恶意”是指为获取资源而异常注册账号等破坏活动公平性的行为），利用资源从事违法违规行为的用户收回套餐使用资格； 所有参加本活动的华为云注册用户，已认可并同意遵守《华为云用户协议》及通过援引的形式加入的附件，包括《可接受的使用政策》，《隐私政策声明》 父主题： 开年采购季

开年采购季实物礼品说明 开年采购季-消费满额送实物奖品活动的常见问题答疑如下（仅供参考、详情以活动规则为准）： 活动对象：华为云电销客户可参与消费满送活动，其他客户参与前请咨询客户经理； 活动时间：2022年3月1日-2022年3月31日； 参与规则：开年采购季活动页面上的云服务或者使用开年采购季活动礼包优惠券在华为云官网新购的云服务，累计新购付费金额达到一定额度，可兑换相应的实物礼品。 付费说明：付费金额指订单金额剔除现金券、折扣、优惠券、退订订单等，即用户实际现金支付金额，包含新购、按需转包周期、升级订单金额，不包含续费订单金额。 奖励不可叠加，即同一用户仅可兑换一次礼品，金额对应的奖励具体规则如下： 用户付费金额 可兑换奖励 10,000 HUAWEI 风范双肩包 或HUAWEI WATCH FIT new 50,000 HUAWEI WATCH GT Runner 或HUAWEI Sound X 智能音箱 100,000 HUAWEI WATCH GT 2 保时捷设计款 钛金灰 或HUAWEI MateBook D 15 2022款 15.6英寸 150,000 HUAWEI P50 Pro 4G 8GB+512GB 或HUAWEI MateBook E 2022款二合一笔记本i5 16G 512G 300000 HUAWEI MateBook X Pro 2022款 14.2英寸 i7 16GB 1TB 或HUAWEI Mate 40 RS保时捷设计 实物礼品的资格查询（中奖查询）、信息登记（申请报备）、发放进度等问题可咨询渠道经理或客户经理。可自行线下联系渠道经理或客户经理沟通，也可提交工单反馈至客服，由客服反馈至渠道经理或者客户经理线下联系您。 实物礼品发放时间：预计在活动结束后30个工作日内发放，请您耐心等待。 特殊说明： 消费满赠实物礼品的订单不支持退订； 奖励不可叠加，即同一用户仅可兑换一次礼品； 付费金额指用户实际现金支付金额，包含新购、按需转包周期、升级订单金额，不包含续费订单金额； 仅限开年采购季活动页面上或者使用开年采购季活动礼包优惠券在华为云官网新购的云服务的订单，才能参与满赠活动。 请您在活动结束后5个工作日内以填写工单的形式，反馈您的收货地址；如果过期没有反馈，将取消发放资格。 父主题： 开年采购季

开年采购季产品注意事项说明 开年采购季-产品配置常见特殊说明如下（仅供参考、详情以活动规则为准）： 非中国大陆数据中心云服务器重装系统不支持Linux与Windows互相切换； 如有需要了解核实的资源包计费规则、产品特性、应用场景等问题，请您提交工单由专业人员解答您的疑问。 云速建站注意事项：https://support.huaweicloud.com/usermanual-cloudsite/cloudsite_ug_20190903001.html 父主题： 开年采购季

开发设计建议概述 开发设计建议约定数据库建模和数据库应用程序开发过程中，应当遵守的设计规范。依据这些规范进行建模，能够更好地契合 GaussDB 的处理架构，输出更高效的业务SQL代码。 开发设计建议中所陈述的“建议”和“关注”含义如下： 建议：用户应当遵守的设计规则。遵守这些规则，能够保证业务的高效运行；违反这些规则，将导致业务性能的大幅下降或某些业务逻辑错误。 关注：在业务开发过程中用户需要注意的细则。用于标识容易导致用户理解错误的知识点（实际上遵守SQL标准的SQL行为），或者程序中潜在的用户不易感知的默认行为。 父主题： 开发设计建议

选择分区方案 当表中的数据量很大时，应当对表进行分区，一般需要遵循以下原则： 使用具有明显区间性的字段进行分区，比如日期、区域等字段上建立分区。 分区名称应当体现分区的数据特征。例如，关键字+区间特征。 将分区上边界的分区值定义为MAXVALUE，以防止可能出现的数据溢出。 表1 表的分区方式及使用场景 分区方式 描述 Range 表数据通过范围进行分区。 Interval 表数据通过范围进行分区，超出范围的会自动根据间隔创建新的分区。 List 表数据通过指定列按照具体值进行分区。 Hash 表数据通过Hash散列方式进行分区。 典型的分区表定义如下： 1 2 3 4 5 6 7 8 910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455 --创建Range分区表CREATE TABLE staffS_p1( staff_ID NUMBER(6) not null, FIRST_NAME VARCHAR2(20), LAST_NAME VARCHAR2(25), EMAIL VARCHAR2(25), PHONE_NUMBER VARCHAR2(20), HIRE_DATE DATE, employment_ID VARCHAR2(10), SALARY NUMBER(8,2), COMMISSION_PCT NUMBER(4,2), MANAGER_ID NUMBER(6), section_ID NUMBER(4))PARTITION BY RANGE (HIRE_DATE)( PARTITION HIRE_19950501 VALUES LESS THAN ('1995-05-01 00:00:00'), PARTITION HIRE_19950502 VALUES LESS THAN ('1995-05-02 00:00:00'), PARTITION HIRE_maxvalue VALUES LESS THAN (MAXVALUE));--创建Interval分区表，初始两个分区，插入分区范围外的数据会自动新增分区CREATE TABLE sales(prod_id NUMBER(6), cust_id NUMBER, time_id DATE, channel_id CHAR(1), promo_id NUMBER(6), quantity_sold NUMBER(3), amount_sold NUMBER(10,2))PARTITION BY RANGE (time_id)INTERVAL('1 day')( PARTITION p1 VALUES LESS THAN ('2019-02-01 00:00:00'), PARTITION p2 VALUES LESS THAN ('2019-02-02 00:00:00'));--创建List分区表CREATE TABLE test_list (col1 int, col2 int)partition by list(col1)(partition p1 values (2000),partition p2 values (3000),partition p3 values (4000),partition p4 values (5000));--创建Hash分区表CREATE TABLE test_hash (col1 int, col2 int)partition by hash(col1)(partition p1,partition p2); 更多的表分区语法信息请参见CREATE TABLE PARTITION。

连接参数 第三方工具通过JDBC连接GaussDB时，JDBC向GaussDB发起连接请求，会默认添加以下配置参数，详见JDBC代码ConnectionFactoryImpl类的实现。 params = { { "user", user }, { "database", database }, { "client_encoding", "UTF8" }, { "DateStyle", "ISO" }, { "extra_float_digits", "3" }, { "TimeZone", createPostgresTimeZone() }, }; 这些参数可能会导致JDBC客户端的行为与gsql客户端的行为不一致，例如，Date数据显示方式、浮点数精度表示、timezone显示。 如果实际期望和这些配置不符，建议在java连接设置代码中显式设定这些参数。 通过JDBC连接数据库时，会设置extra_float_digits=3，gsql中设置为extra_float_digits=0，可能会造成同一条数据在JDBC显示和gsql显示的精度不同。 对于精度敏感的场景，建议使用numeric类型。 通过JDBC连接数据库时，应该保证以下三个时区设置一致： JDBC客户端所在主机的时区。 GaussDB数据库 实例所在主机的时区。 GaussDB数据库实例配置过程中时区。 时区设置相关的操作，请联系管理员。

释放连接 推荐使用连接池限制应用程序的连接数。每执行一条SQL就连接一次数据库，是一种不好的SQL编写习惯。 在应用程序完成作业任务之后，应当及时断开和GaussDB的连接，释放资源。建议在任务中设置session超时时间参数。 使用JDBC连接池，在将连接释放给连接池前，需要执行以下操作，重置会话环境。否则，可能会因为历史会话信息导致的对象冲突。 如果在连接中设置了GUC参数，那么在将连接归还连接池之前，必须使用“SET SESSION AUTHORIZATION DEFAULT;RESET ALL;”将连接的状态清空。 如果使用了临时表，那么在将连接归还连接池之前，必须将临时表删除。

数据库对象命名 数据库对象命名需要满足约束： 表标识符长度不超过63个字节。 标识符以字母或下划线开头，中间字符可以是字母、数字、下划线、$、#。 若标识符被双引号（""）包含，则可以使用合法字符的任意组合，如"123gs_column"。 标识符不区分大小写，只有被双引号包含才区分大小写。 避免使用保留或者非保留关键字命名数据库对象。 可以使用select * from pg_get_keywords()查询GaussDB的关键字，或者在关键字章节中查看。 避免使用双引号括起来的字符串来定义数据库对象名称，除非需要限制数据库对象名称的大小写。数据库对象名称大小写敏感会使定位问题难度增加。 数据库对象命名风格务必保持统一。 增量开发的业务系统或进行业务迁移的系统，建议遵守历史的命名风格。 建议使用多个单词组成，以下划线分割。 数据库对象名称建议能够望文知意，尽量避免使用自定义缩写（可以使用通用的术语缩写进行命名）。例如，在命名中可以使用具有实际业务含义的英文词汇或汉语拼音，但规则应该在数据库实例范围内保持一致。 变量名的关键是要具有描述性，即变量名要有一定的意义，变量名要有前缀标明该变量的类型。 表对象的命名应该可以表征该表的重要特征。例如，在表对象命名时区分该表是普通表、临时表还是非日志表： 普通表名按照数据集的业务含义命名。 临时表以“tmp_+后缀”命名。 非日志表以“ul_+后缀”命名。 外表以“f_+后缀”命名。 不创建以redis_为前缀的数据库对象。 不创建以mlog_和以matviewmap_为前缀的数据库对象。 不创建以gs_role_为前缀的数据库对象。 表对象命名建议不要超过63字节。如果超过该长度内核会对表名进行截断，从而造成和设置值不一致的现象，且在不同字符集下，可能造成字符被截断，出现预期外的字符。 父主题： 开发设计建议

Schema设计建议 实际用户环境中Schema数量不建议超过100个。当数据库中存在大量Schema时，会导致gs_dump等依赖Schema数量的操作性能变慢。 如果该用户不具有sysadmin权限或者不是该Schema的owner，要访问Schema下的对象，需要同时给用户授予Schema的usage权限和对象的相应权限。 如果要在Schema下创建对象，需要授予操作用户该Schema的CREATE权限。 Schema的owner默认拥有该Schema下对象的所有权限，包括删除权限。删除权限影响较大，请谨慎使用。

Database设计建议 在实际业务中，根据需要创建新的Database，不建议直接使用数据库实例默认的postgres数据库。 一个数据库实例内，用户自定义的Database数量推荐值为3个，不建议超过10个。用户自定义的Database数量过多会导致升级、备份等运维操作的效率降低。 为了适应全球化的需求，使数据库编码能够存储与表示绝大多数的字符，建议创建Database的时候使用UTF-8编码。 创建Database时，需要重点关注字符集编码（ENCODING）和兼容性（DBCOMPATIBILITY）两个配置项。GaussDB支持A、B、C和PG四种兼容模式，分别表示兼容O语法、MY语法、TD语法和POSTGRES语法，不同兼容模式下的语法行为存在一定差异，默认为A兼容模式。 Database的owner默认拥有该Database下所有对象的所有权限，包括删除权限。删除权限影响较大，请谨慎使用。

选择数据类型 在字段设计时，基于查询效率的考虑，一般需要遵循以下原则： 尽量使用高效数据类型。 选择数值类型时，在满足业务精度的情况下，选择数据类型的优先级从高到低依次为整数、浮点数、NUMERIC。 当多个表存在逻辑关系时，表示同一含义的字段应该使用相同的数据类型。 对于字符串数据，建议使用变长字符串数据类型，并指定最大长度。请务必确保指定的最大长度大于需要存储的最大字符数，避免出现超出字段定义最大长度的异常报错而导致业务中断现象。除非明确知道数据类型为固定长度字符串，否则，不建议使用CHAR(n)、BPCHAR(n)、NCHAR(n)、CHARACTER(n)。 关于字符串类型的详细说明，请参见常用字符串类型介绍。

选择分区方案 当表中的数据量很大时，应当对表进行分区，一般需要遵循以下原则： 【建议】使用具有明显区间性的字段进行分区，比如日期、区域等字段上建立分区。 【建议】分区名称应当体现分区的数据特征。例如，关键字+区间特征。 【建议】将分区上边界的分区值定义为MAXVALUE，以防止可能出现的数据溢出。 典型的分区表定义如下： 1 2 3 4 5 6 7 8 91011121314151617181920 CREATE TABLE staffS_p1( staff_ID NUMBER(6) not null, FIRST_NAME VARCHAR2(20), LAST_NAME VARCHAR2(25), EMAIL VARCHAR2(25), PHONE_NUMBER VARCHAR2(20), HIRE_DATE DATE, employment_ID VARCHAR2(10), SALARY NUMBER(8,2), COMMISSION_PCT NUMBER(4,2), MANAGER_ID NUMBER(6), section_ID NUMBER(4))PARTITION BY RANGE (HIRE_DATE)( PARTITION HIRE_19950501 VALUES LESS THAN ('1995-05-01 00:00:00'), PARTITION HIRE_19950502 VALUES LESS THAN ('1995-05-02 00:00:00'), PARTITION HIRE_maxvalue VALUES LESS THAN (MAXVALUE));

选择分布方案 【建议】表的分布方式的选择一般遵循以下原则： 表2 表的分布方式及使用场景 分布方式 描述 适用场景 Hash 表数据通过Hash方式散列到集群中的所有DN上。 数据量较大的事实表。 Replication 集群中每一个DN都有一份全量表数据。 维度表、数据量较小的事实表。 Range 表数据对指定列按照范围进行映射，分布到对应DN。 用户需要自定义分布规则的场景。 List 表数据对指定列按照具体值进行映射，分布到对应DN。 用户需要自定义分布规则的场景。 当指定Hash、Range或List分布时，创建主键和唯一索引必须包含分布列。 典型的分布表定义如下： 1 2 3 4 5 6 7 8 910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788 --定义一个表，表中每行存在所有DN中。CREATE TABLE warehouse_d1( W_WAREHOUSE_SK INTEGER NOT NULL, W_WAREHOUSE_ID CHAR(16) NOT NULL, W_WAREHOUSE_NAME VARCHAR(20) , W_WAREHOUSE_SQ_FT INTEGER , W_STREET_NUMBER CHAR(10) , W_STREET_NAME VARCHAR(60) , W_STREET_TYPE CHAR(15) , W_SUITE_NUMBER CHAR(10) , W_CITY VARCHAR(60) , W_COUNTY VARCHAR(30) , W_STATE CHAR(2) , W_ZIP CHAR(10) , W_COUNTRY VARCHAR(20) , W_GMT_OFFSET DECIMAL(5,2))DISTRIBUTE BY REPLICATION;--定义一个表，使用HASH分布。CREATE TABLE warehouse_d2( W_WAREHOUSE_SK INTEGER NOT NULL, W_WAREHOUSE_ID CHAR(16) NOT NULL, W_WAREHOUSE_NAME VARCHAR(20) , W_WAREHOUSE_SQ_FT INTEGER , W_STREET_NUMBER CHAR(10) , W_STREET_NAME VARCHAR(60) , W_STREET_TYPE CHAR(15) , W_SUITE_NUMBER CHAR(10) , W_CITY VARCHAR(60) , W_COUNTY VARCHAR(30) , W_STATE CHAR(2) , W_ZIP CHAR(10) , W_COUNTRY VARCHAR(20) , W_GMT_OFFSET DECIMAL(5,2), CONSTRAINT W_CONSTR_KEY3 UNIQUE(W_WAREHOUSE_SK))DISTRIBUTE BY HASH(W_WAREHOUSE_SK);--定义一个表，使用RANGE分布CREATE TABLE warehouse_d3(W_WAREHOUSE_SK INTEGER NOT NULL,W_WAREHOUSE_ID CHAR(16) NOT NULL,W_WAREHOUSE_NAME VARCHAR(20) ,W_WAREHOUSE_SQ_FT INTEGER ,W_STREET_NUMBER CHAR(10) ,W_STREET_NAME VARCHAR(60) ,W_STREET_TYPE CHAR(15) ,W_SUITE_NUMBER CHAR(10) ,W_CITY VARCHAR(60) ,W_COUNTY VARCHAR(30) ,W_STATE CHAR(2) ,W_ZIP CHAR(10) ,W_COUNTRY VARCHAR(20) ,W_GMT_OFFSET DECIMAL(5,2))DISTRIBUTE BY RANGE(W_WAREHOUSE_ID)( SLICE s1 VALUES LESS THAN (10) DATANODE dn1, SLICE s2 VALUES LESS THAN (20) DATANODE dn2, SLICE s3 VALUES LESS THAN (30) DATANODE dn3, SLICE s4 VALUES LESS THAN (MAXVALUE) DATANODE dn4); --定义一个表，使用LIST分布CREATE TABLE warehouse_d4(W_WAREHOUSE_SK INTEGER NOT NULL,W_WAREHOUSE_ID CHAR(16) NOT NULL,W_WAREHOUSE_NAME VARCHAR(20) ,W_WAREHOUSE_SQ_FT INTEGER ,W_STREET_NUMBER CHAR(10) ,W_STREET_NAME VARCHAR(60) ,W_STREET_TYPE CHAR(15) ,W_SUITE_NUMBER CHAR(10) ,W_CITY VARCHAR(60) ,W_COUNTY VARCHAR(30) ,W_STATE CHAR(2) ,W_ZIP CHAR(10) ,W_COUNTRY VARCHAR(20) ,W_GMT_OFFSET DECIMAL(5,2))DISTRIBUTE BY LIST(W_COUNTRY)( SLICE s1 VALUES ('USA') DATANODE dn1, SLICE s2 VALUES ('CANADA') DATANODE dn2, SLICE s3 VALUES ('UK') DATANODE dn3, SLICE s4 VALUES (DEFAULT) DATANODE dn4);

选择分布键 分布表的分布键选取至关重要，如果分布键选择不当，可能会导致数据倾斜，从而导致查询时，I/O负载集中在部分DN上，影响整体查询性能。因此，在确定分布表的分布策略之后，需要对表数据进行倾斜性检查，以确保数据的均匀分布。分布键的选择一般需要遵循以下原则： 【建议】选作分布键的字段取值应该比较离散，以便数据能在各个DN上均匀分布。当单个字段无法满足离散条件时，可以考虑使用多个字段一起作为分布键。一般情况下，可以考虑选择表的主键作为分布键。例如，在人员信息表中选择证件号码作为分布键。 【建议】在满足第一条原则的情况下，尽量不要选取在查询中存在常量过滤条件的字段作为分布键。例如，在表dwcjk相关的查询中，字段zqdh存在常量过滤条件“zqdh='000001'”，那么就应当尽量不选择zqdh字段作为分布键。 【建议】在满足前两条原则的情况，尽量选择查询中的关联条件为分布键。当关联条件作为分布键时，join任务的相关数据都分布在DN本地，将极大减少DN之间的数据流动代价。

数据库对象命名 数据库对象命名需要满足约束： 表标识符长度不超过63个字节。 标识符以字母或下划线开头，中间字符可以是字母、数字、下划线、$、#。 若标识符被双引号（""）包含，则可以使用合法字符的任意组合，如"123gs_column"。 标识符不区分大小写，只有被双引号包含才区分大小写。 【建议】避免使用保留或者非保留关键字命名数据库对象。 可以使用select * from pg_get_keywords()查询GaussDB的关键字，或者在关键字章节中查看。 【建议】避免使用双引号括起来的字符串来定义数据库对象名称，除非需要限制数据库对象名称的大小写。数据库对象名称大小写敏感会使定位问题难度增加。 【建议】数据库对象命名风格务必保持统一。 增量开发的业务系统或进行业务迁移的系统，建议遵守历史的命名风格。 建议使用多个单词组成，以下划线分割。 数据库对象名称建议能够望文知意，尽量避免使用自定义缩写（可以使用通用的术语缩写进行命名）。例如，在命名中可以使用具有实际业务含义的英文词汇或汉语拼音，但规则应该在集群范围内保持一致。 变量名的关键是要具有描述性，即变量名称要有一定的意义，变量名要有前缀标明该变量的类型。 【建议】表对象的命名应该可以表征该表的重要特征。例如，在表对象命名时区分该表是普通表、临时表还是非日志表： 普通表名按照数据集的业务含义命名。 临时表以“tmp_+后缀”命名。 非日志表以“ul_+后缀”命名。 不创建以redis_为前缀的数据库对象。 不创建以mlog_和以matviewmap_为前缀的数据库对象。 【建议】表对象命名建议不要超过63字节。如果超过该长度内核会对表名进行截断，从而出现实际名称和设置值不一致的现象；且在不同字符集下，可能造成字符被截断，出现预期外的字符。 父主题： 开发设计建议

开发设计建议概述 本开发设计建议约定数据库建模和数据库应用程序开发过程中，应当遵守的设计规范。依据这些规范进行建模，能够更好的契合GaussDB的分布式处理架构，输出更高效的业务SQL代码。 本开发设计建议中所陈述的“建议”和“关注”含义如下： 建议：用户应当遵守的设计规则。遵守这些规则，能够保证业务的高效运行；违反这些规则，将导致业务性能的大幅下降或某些业务逻辑错误。 关注：在业务开发过程中客户需要注意的细则。用于标识容易导致客户理解错误的知识点（实际上遵守SQL标准的SQL行为），或者程序中潜在的客户不易感知的默认行为。 父主题： 开发设计建议

Database设计建议 【规则】在实际业务中，根据需要创建新的Database，不建议直接使用集群默认的postgres数据库。 【建议】一个集群内，用户自定义的Database数量推荐值为3个，不建议超过10个。用户自定义的Database数量过多会导致升级、备份等运维操作的效率降低。 【建议】为了适应全球化的需求，使数据库编码能够存储与表示绝大多数的字符，建议创建Database的时候使用UTF-8编码。 【关注】创建Database时，需要重点关注字符集编码(ENCODING)和兼容性(DBCOMPATIBILITY)两个配置项。GaussDB支持TD、ORA、MYSQL和PG四种兼容模式，分别部分兼容Teradata语法、Oracle语法、MySQL语法和PostgreSQL语法，不同兼容模式下的语法行为存在一定差异，默认为MYSQL兼容模式。 【关注】Database的owner默认拥有该Database下所有对象的所有权限，包括删除权限。删除权限影响较大，请谨慎使用。

Schema设计建议 【建议】实际用户环境中Schema数量不建议超过100个。当数据库中存在大量Schema时，会导致gs_dump等依赖Schema数量的操作性能变慢。 【关注】如果该用户不具有sysadmin权限或者不是该Schema的owner，要访问Schema下的对象，需要同时给用户赋予Schema的usage权限和对象的相应权限。 【关注】如果要在Schema下创建对象，需要授予操作用户该Schema的CREATE权限。 【关注】Schema的owner默认拥有该Schema下对象的所有权限，包括删除权限。删除权限影响较大，请谨慎使用。

连接参数 【关注】第三方工具通过JDBC连接GaussDB时，JDBC向GaussDB发起连接请求，会默认添加以下配置参数，详见JDBC代码ConnectionFactoryImpl类的实现。 params = {{ "user", user },{ "database", database },{ "client_encoding", "UTF8" },{ "DateStyle", "ISO" },{ "extra_float_digits", "3" },{ "TimeZone", createPostgresTimeZone() },}; 这些参数可能会导致JDBC客户端的行为与gsql客户端的行为不一致，例如，Date数据显示方式、浮点数精度表示、timezone显示。 如果实际期望和这些配置不符，建议在java连接设置代码中显式设定这些参数。 【建议】通过JDBC连接数据库时，会设置extra_float_digits=3，gsql中设置为extra_float_digits=0，可能会使同一条数据在JDBC显示和gsql显示的精度不同。 【建议】对于精度敏感的场景，建议使用numeric类型。 【建议】通过JDBC连接数据库时，应该保证下面三个时区设置一致： JDBC客户端所在主机的时区。 GaussDB集群所在主机的时区。 GaussDB集群配置过程中时区。 时区设置相关的操作请联系管理员处理。

释放连接 【建议】推荐使用连接池限制应用程序的连接数。每执行一条SQL就连接一次数据库，是一种不好的SQL编写习惯。 【建议】在应用程序完成作业任务之后，应当及时断开和GaussDB的连接，释放资源。建议在任务中设置session超时时间参数。 【建议】使用JDBC连接池，在将连接释放给连接池前，需要执行以下操作，重置会话环境。否则，可能会因为历史会话信息导致的对象冲突。 如果在连接中设置了GUC参数，那么在将连接归还连接池之前，必须使用“SET SESSION AUTHORIZATION DEFAULT;RESET ALL;”将连接的状态清空。 如果使用了临时表，那么在将连接归还连接池之前，必须将临时表删除。

选择数据类型 在字段设计时，基于查询效率的考虑，一般遵循以下原则： 【建议】尽量使用高效数据类型。 选择数值类型时，在满足业务精度的情况下，选择数据类型的优先级从高到低依次为整数、浮点数、NUMERIC。 【建议】当多个表存在逻辑关系时，表示同一含义的字段应该使用相同的数据类型。 【建议】对于字符串数据，建议使用变长字符串数据类型，并指定最大长度。请务必确保指定的最大长度大于需要存储的最大字符数，避免超出最大长度时出现字符截断现象。除非明确知道数据类型为固定长度字符串，否则，不建议使用CHAR(n)、BPCHAR(n)、NCHAR(n)、CHARACTER(n)。 关于字符串类型的详细说明，请参见常用字符串类型介绍。

数据库对象命名 数据库对象命名需要满足约束： 表标识符长度不超过63个字节。 标识符以字母或下划线开头，中间字符可以是字母、数字、下划线、$、#。 若标识符被双引号（""）包含，则可以使用合法字符的任意组合，如"123gs_column"。 标识符不区分大小写，只有被双引号包含才区分大小写。 【建议】避免使用保留或者非保留关键字命名数据库对象。 可以使用select * from pg_get_keywords()查询GaussDB的关键字，或者在关键字章节中查看。 【建议】避免使用双引号括起来的字符串来定义数据库对象名称，除非需要限制数据库对象名称的大小写。数据库对象名称大小写敏感会使定位问题难度增加。 【建议】数据库对象命名风格务必保持统一。 增量开发的业务系统或进行业务迁移的系统，建议遵守历史的命名风格。 建议使用多个单词组成，以下划线分割。 数据库对象名称建议能够望文知意，尽量避免使用自定义缩写（可以使用通用的术语缩写进行命名）。例如，在命名中可以使用具有实际业务含义的英文词汇或汉语拼音，但规则应该在数据库实例范围内保持一致。 变量名的关键是要具有描述性，即变量名称要有一定的意义，变量名要有前缀标明该变量的类型。 【建议】表对象的命名应该可以表征该表的重要特征。例如，在表对象命名时区分该表是普通表、临时表还是非日志表： 普通表名按照数据集的业务含义命名。 临时表以“tmp_+后缀”命名。 非日志表以“ul_+后缀”命名。 不创建以redis_为前缀的数据库对象。 不创建以mlog_和以matviewmap_为前缀的数据库对象。 【建议】非时序表对象命名建议不要超过63字节。如果过该长度内核会对表名进行截断，从而造成和设置值不一致的现象。且在不同字符集下，可能造成字符被截断，出现预期外的字符。 父主题： 开发设计建议

选择数据类型 在字段设计时，基于查询效率的考虑，一般遵循以下原则： 【建议】尽量使用高效数据类型。 选择数值类型时，在满足业务精度的情况下，选择数据类型的优先级从高到低依次为整数、浮点数、NUMERIC。 【建议】当多个表存在逻辑关系时，表示同一含义的字段应该使用相同的数据类型。 【建议】对于字符串数据，建议使用变长字符串数据类型，并指定最大长度。请务必确保指定的最大长度大于需要存储的最大字符数，避免超出最大长度时出现字符截断现象。除非明确知道数据类型为固定长度字符串，否则，不建议使用CHAR(n)、BPCHAR(n)、NCHAR(n)、CHARACTER(n)。 关于字符串类型的详细说明，请参见常用字符串类型介绍。