本页介绍天翼云TeleDB数据库PL/pgsql函数的返回值类型。 没有返回值 plaintext teledb CREATE OR REPLACE FUNCTION f8() RETURNS void AS teledb $$ teledb$ BEGIN teledb$ RAISE NOTICE '不用返回值，函数体可以有或没有return语句'; teledb$ RETURN ;这一句可以有，也可以没有 teledb$ END; teledb$ $$ teledb LANGUAGE plpgsql; CREATE FUNCTION teledb select from f8(); NOTICE: 不用返回值，函数体可以有或没有return语句 f8 (1 row) 返回简单类型 plaintext teledb CREATE OR REPLACE FUNCTION f9() RETURNS TEXT AS $$ BEGIN RETURN 'teledb'; END; $$ LANGUAGE plpgsql; CREATE FUNCTION teledb SELECT FROM f9() t(axm); axm teledb (1 row) teledb CREATE OR REPLACE FUNCTION f9(OUT axm TEXT) RETURNS TEXT AS $$ BEGIN axm:'teledb'; END; $$ LANGUAGE plpgsql; CREATE FUNCTION teledb SELECT FROM f9(); axm teledb (1 row) 上面两个函数其实就是同一个函数，建立时如果不加OR REPLACE 则会提示已经存在。 plaintext teledb CREATE OR REPLACE FUNCTION f10() RETURNS TEXT[] AS $$ BEGIN RETURN ARRAY['teledb','pgxz']; END; $$ LANGUAGE plpgsql; CREATE FUNCTION teledb SELECT FROM f10(); f10 {teledb,pgxz} (1 row) 返回一个复合类型 plaintext teledb CREATE TYPE trec AS teledb ( teledb( id integer, teledb( mc text teledb( ); CREATE TYPE teledb CREATE OR REPLACE FUNCTION f11() RETURNS trec AS teledb

本页介绍天翼云TeleDB数据库开发相关的规范。 1. 建议对DB object尤其是COLUMN加COMMENT，便于后续了解业务及维护 注释前后的数据表可读性对比，有注释的一看就明白。 plaintext teledb d+ toids; Table "public.toids" Column Type Collation Nullable Default Storage Stats target Descripti on +++++++ id integer not null plain name character varying extended birth timestamp(0) without time zone plain city character varying extended Indexes: "toidspkey" PRIMARY KEY, btree (id) Has OIDs: yes Distribute By: SHARD(id) Location Nodes: ALL DATANODES ^ teledb comment on column toids.name is '姓名'; COMMENT teledb comment on column toids.city is '居住城市'; COMMENT teledb d+ toids; Table "public.toids" Column Type Collation Nullable Default Storage Stats target Descripti on +++++++ id integer not null plain name character varying extended 姓名 birth timestamp(0) without time zone plain city character varying extended 居住城市 Indexes: "toidspkey" PRIMARY KEY, btree (id) Has OIDs: yes Distribute By: SHARD(id) Location Nodes: ALL DATANODES 2. 建议非必须时避免select ，只取所需字段，以减少包括不限于网络带宽消耗。 plaintext teledb

本页介绍天翼云TeleDB数据库PL/pgsql的消息及异常输出。 RAISE NOTICE plaintext teledb CREATE OR REPLACE FUNCTION f28() RETURNS VOID AS teledb $$ teledb$ DECLARE teledb$ vint INTEGER : 1; teledb$ BEGIN teledb$ RAISE NOTICE 'vint %, 随机数 %',vint,random(); teledb$ END; teledb$ $$ teledb LANGUAGE plpgsql; CREATE FUNCTION teledb SELECT f28(); NOTICE: vint 1, 随机数 0.236714988015592 f28 (1 row) 使用raise notice向终端输出一个消息，也有可能写到日志中(需要调整日志的保存级别)。 RAISE EXCEPTION plaintext teledb CREATE OR REPLACE FUNCTION f28() RETURNS VOID AS teledb $$ teledb$ DECLARE teledb$ vint INTEGER : 1; teledb$ BEGIN teledb$ RAISE EXCEPTION '程序EXCEPTION '; teledb$ 下面的语句不会再执行 teledb$ RAISE NOTICE 'vint %, 随机数 %',vint,random(); teledb$ END; teledb$ $$ teledb LANGUAGE plpgsql; CREATE FUNCTION teledb SELECT f28(); ERROR: 程序EXCEPTION 如果在事务中执行这个函数，则事务会终止(abort)。 RAISE EXCEPTION自定义ERRCODE plaintext teledb CREATE OR REPLACE FUNCTION f28() RETURNS VOID AS teledb $$ teledb$ DECLARE teledb$ vint INTEGER : 1; teledb$ BEGIN teledb$ RAISE EXCEPTION ' 程序EXCEPTION ' USING ERRCODE '23505'; teledb$ END; teledb$ $$ teledb LANGUAGE plpgsql; CREATE FUNCTION teledb

此章节为您介绍数据库审计的辅助功能 IP别名 为方便对网络进行识别，可对网段或IP地址设置别名。 操作步骤如下： 1.在左侧菜单栏选择“系统管理 > 辅助功能”进入“辅助功能”页面，选择“IP别名”页签，单击“新增”。 2.弹出“新增IP别名”对话框，编辑相关信息，单击“保存”。 配置项 说明 名称 必须为中文字符、字母、数字、下划线“”、点“.”或短横“”，长度不超过64字符。 IP/网络 格式1：输入多个IP地址，用英文逗号分隔。 格式2：IP范围，仅支持IPv4格式，例如：10.1.1.1010.1.1.20。 数据脱敏 数据脱敏可以将银行卡号、手机号码、身份证号码等敏感数据进行脱敏处理。 操作步骤如下： 1.在左侧菜单栏选择“系统管理 > 辅助功能”进入“辅助功能”页面，选择“数据脱敏”页签，单击“新增”。 2.弹出“数据脱敏”对话框，编辑相关信息，单击“保存”。 参数 说明 名称 必须为中文字符、字母、数字、下划线“”、点“.”或短横“”，长度不超过64字符。 状态 启用或禁用该规则。 正则表达式 正则表达式用于检索、替换符合特定模式（规则）的文本，例如：([^d] 开始位置 开始替换的字符位置。 截取长度 数据串中被替换的字符长度。

本页介绍天翼云TeleDB数据库的分布键设计规范。 分布键使用约束 1. 分布键字段不支持更新，更新分布键需要先删除记录，再插入新的记录。 2. 分布键字段类型不支持修改。 3. 分布键字段的长度不支持修改。 4. 分布键数据类型支持有限制，char,varchar,varchar2,text,date,timestamp,int,bigint,float8,number,numberic。 5. 分布键只能选择一个字段。 分布键选择参考 1. 分布键关系到数据分布是否均衡，不能因为分布键值不均导致数据倾斜，出现木桶效应。 2. 如果有主键，则选择主键做分布键。 3. 如果是复合主键，则可选择数据重复率低的字段做分布键。 4. 没有主键的可以使用JAVA生成UUID做分布键（这里不是UUID类型）。 5. 如果涉及表关联,则选择关联字段做分布键。 6. 可以按业务类型，地区或者分公司做分布键。 上述分布键选择原则冲突时，按从上到下的顺序选择。 分布键对其它约束影响 1. 主键必需包含分布键字段。 2. 唯一索引必需包含分布键字段。 3. 外键必需是分布键字段。

本页介绍天翼云TeleDB数据库修改列存储表结构的语法。 列存表修改表结构和行存表语法一致，使用ALTER TABLE 语句对指定表进行操作 ALTER TABLE tablename ; 其中， 操作包括：增加字段，删除字段，修改字段名，修改表名等。 增加字段 列存表修改表名和行存表语法一致，使用ADD COLUMN 语句增加字段。 teledb alter table t1 add column c1 int; ALTER TABLE teledb d+ t1 Table "public.t1" Column Type Collation Nullable Default Storage Stats target Description +++++++ a integer plain b integer plain c text extended c1 integer plain Distribute By: HASH(a) Location Nodes: ALL DATANODES 删除字段 列存表修改表名和行存表语法一致，使用DROP COLUMN 语句删除字段。 teledb alter table t1 drop column c1; ALTER TABLE teledb d+ t1 Table "public.t1" Column Type Collation Nullable Default Storage Stats target Description +++++++ a integer plain b integer plain c text extended Distribute By: HASH(a) Location Nodes: ALL DATANODES 修改字段名 列存表修改表名和行存表语法一致，使用RENAME COLUMN TO 语句增加字段。 teledb alter table t1 rename column c1 to c2; ALTER TABLE teledb

本页介绍天翼云TeleDB数据库Oracle语法中的日期函数。 NUMTODSINTERVAL numtodsinterval(,) x是一个数字、c是一个字符串，表明x的单位，这个函数把x转为interval day to second数据类型。 teledb select sysdate,sysdate+numtodsinterval(2,'hour') as res from dual; orclsysdate res + 20230824 10:49:53.417051 20230824 12:49:53.417051 (1 row) teledb DBTIMEZONE teledb select DBTIMEZONE from dual; dbtimezone 08:00:00 (1 row) teledb MONTHSBETWEEN teledb select monthsbetween(todate('20210331', 'yyyymmdd'), todate('20200131', 'yyyymmdd')) as months from dual; months 14 (1 row) teledb LASTDAY LASTDAY函数返回指定日期对应月份的最后一天。 teledb SELECT lastday('20200501') FROM dual; lastday 20200531 00:00:00+08 (1 row) teledb ADDMONTHS ADDMONTHS(x,y) x值为日期，y值为数量，用于计算某个日期向前或者向后y个月后的时间。 teledb select addmonths(sysdate,1) from dual; addmonths 20230924 11:08:17.194487 (1 row) teledb select addmonths(sysdate,1) from dual; addmonths 20230724 11:08:21.019573 (1 row) teledb

本页介绍天翼云TeleDB数据库元数据pgauditfgaconf的内容。 存储细粒度审计相关管理和配置信息。 名称 类型 定义 auditorid Oid 编写配置用户id objectschema Oid 对象所在的模式的OID objectid Oid 要被审计的对象（表或视图）的OID policyname NameData 策略的唯一名称 auditcolumnids oidvector 需要审计的列的OID 列表 auditcolumns text 需要审计的列名 auditcondition pgnodetree 一个表示审计条件的行条件 auditconditionstr text 一个表示审计条件的行条件的字符串形式 handlerschema Oid 事件处理程序所在的模式的OID handlermodule Oid 事件处理程序的函数名 auditenable bool 如果为TRUE，则启用策略，默认值为 TRUE statementtypes NameData 适用此策略的SQL 语句类型，如 INSERT, UPDATE, DELETE, 或 SELECT auditcolumnopts bool 当查询引用了 auditcolumn 参数中指定的任何列时进行审计，还是只有当所有这些列都被引用时才进行审计。0 表示任意列，1 表示所有列

本页介绍天翼云TeleDB数据库开发相关的规范。 1. 建议对DB object尤其是COLUMN加COMMENT，便于后续了解业务及维护注释前后的数据表可读性对比，有注释的一看就明白。 teledb d+ toids; Table "public.toids" Column Type Collation Nullable Default Storage Stats target Descripti on +++++++ id integer not null plain name character varying extended birth timestamp(0) without time zone plain city character varying extended Indexes: "toidspkey" PRIMARY KEY, btree (id) Has OIDs: yes Distribute By: SHARD(id) Location Nodes: ALL DATANODES ^ teledb comment on column toids.name is '姓名'; COMMENT teledb comment on column toids.city is '居住城市'; COMMENT teledb d+ toids; Table "public.toids" Column Type Collation Nullable Default Storage Stats target Descripti on +++++++ id integer not null plain name character varying extended 姓名 birth timestamp(0) without time zone plain city character varying extended 居住城市 Indexes: "toidspkey" PRIMARY KEY, btree (id) Has OIDs: yes Distribute By: SHARD(id) Location Nodes: ALL DATANODES 2. 建议非必须时避免select ，只取所需字段，以减少包括不限于网络带宽消耗。 teledb

本页介绍天翼云TeleDB数据库PL/pgsql函数的参数数据类型。 数据类型(可以有模式修饰)，可以是基本类型，复合类型、域类型、游标、或者可以引用一个现有表类型、字段类型(建立时转换为对应的类型)、还可以是多态类型 anyelement、anyarray，也可以是各种数据类型的数组形式。 基本类型 teledb CREATE OR REPLACE FUNCTION f3 (aint integer,astr text) RETURNS VOID AS teledb $$ teledb$ BEGIN teledb$ RAISE NOTICE 'aint % ; astr %',aint,astr; teledb$ END; teledb$ $$ teledb LANGUAGE PLPGSQL; CREATE FUNCTION teledb SELECT FROM f3(1,'teledb'); NOTICE: aint 1 ; astr teledb f3 (1 row) teledb CREATE OR REPLACE FUNCTION f3 (aint integer[],astr text[]) RETURNS VOID AS teledb $$ teledb$ BEGIN teledb$ RAISE NOTICE 'aint % ; astr %',aint,astr; teledb$ END; teledb$ $$ teledb LANGUAGE PLPGSQL; CREATE FUNCTION teledb SELECT f3(ARRAY[1,2,3],ARRAY['teledb','pgxz']); NOTICE: aint {1,2,3} ; astr {teledb,pgxz} f3 (1 row) 复合类型 teledb CREATE TYPE tper AS teledb ( teledb( id integer, teledb( mc text teledb( ); CREATE TYPE teledb CREATE OR REPLACE FUNCTION f3 (arow public.tper) RETURNS VOID AS teledb $$ teledb$ BEGIN teledb$

本节介绍了申请须知。 在购买DRDS实例之前，您需要先做一系列的准备操作，包括评估实例规格，确定VPC及可用区，申请账号等。 注册账号后，如果需要对资源进行精细管理，请使用IAM服务创建IAM用户及用户组，并授权为IAM用户分配具体的操作权限。 评估实例规格 为了使所申请的DRDS服务能更好地满足应用需求，您需要先评估应用所需的计算能力和存储能力，结合业务类型及服务规模，选择合适的实例规格，主要包括：CPU、内存。 确定虚拟私有云（VPC） VPC为网络访问提供了逻辑隔离。您可以在创建VPC时，定义安全组、VPN、子网等网络特性。通过VPC方便地管理、配置内部网络，进行安全、快捷的网络变更。 DRDS实例必须与应用程序、RDS for MySQL实例处于相同的VPC，以保证网络连通。 建议DRDS实例与应用程序、RDS for MySQL实例选择相同的安全组，三者网络访问不受限制。如果选择了不同的安全组，请注意添加安全组访问规则，开通网络访问。 确定可用区 建议将应用程序和数据库服务（DRDS、RDS）配置在相同可用区，减少网络时延。

参数 参数说明 参数范围 默认值 heartbeat 心跳超时时间（秒） 0～300 300 framemax 与客户端协商的允许最大frame大小 0～1048576 131072 initialframemax 在连接之前服务器将接受的最大帧大小 0～1048576 4096 maxmessagesize 最大消息大小 1～52428800 52428800 vmmemoryhighwatermark 流程控制触发的内存阈值 0～1 0.8 vmmemoryhighwatermarkpagingratio 高水位限制的分数，当达到阈值时，队列中消息消息会转移到磁盘上以释放内存 0～1 0.5 memorymonitorinterval 执行内存检查的间隔（毫秒） 0～60000 2500 collectstatisticsinterval 统计信息收集间隔，增加此值将减少管理数据库的负载（毫秒） 5000～3600000 5000

您可以选择镜像部署或手动搭建网站。 网站搭建一般有以下两种方式： 对比项 镜像部署 手动搭建 ::: 搭建方式 选择天翼云市场镜像直接安装部署 以手动的方式安装所需软件，可定制化 特点 配套的软件版本相对比较固定 配套版本可以灵活选择 所需时间 比较短，一键部署 比较长，需自行安装相关软件 难易程度 相对比较简单 需要对软件配套版本及安装方法有一定的了解 如果您或您的团队，在建站时，有个性化的部署需求，并且有专业的维护人员，可以采用手动搭建方式。 如果您或您的团队，在建站时，对于操作系统、数据库、中间件等各类软件的选择和配置不是很了解，并且缺少专业维护人员，建议使用镜像部署，后期有镜像服务商的专业售后工程师团队支持。

本页为计费类常见问题。 数据传输服务DTS如何收费？ DTS产品已于2025年7月转商，收费说明如下： 其中数据迁移的MySQL MySQL、PostgreSQL PostgreSQL、MongoDB/DDS MongoDB/DDS为商用链路，支持1个月免费使用，若需要使用时间超出1个月，请选择订购数据同步链路；MySQL PostgreSQL、SQL Server SQL Server迁移链路为非商用链路，目前免费，支持手动续订，可按1个月周期续订。 数据同步所有链路全部商用，支持按需计费和包年包月计费两种计费模式：选择按需计费模式时，任务启动时开始计费，若目标端是云上数据库，前7天免费，从第8天开始收费；选择包年包月计费模式时，实例开通时开始计费，包年预付费有优惠。 详情请参考计费说明。

本文主要介绍如何创建环境。 概念 环境即我们常说的开发环境、生产环境，是用于应用部署和运行的计算、网络、中间件等资源的集合。 例如可以把同VPC下的云容器引擎、注册中心、数据库等实例组成一个环境。 注意 默认项目下已内置了默认环境，无法创建自定义环境。 非默认项目下，您需要先创建环境才可完成应用接入。 操作步骤 1. 登录应用性能监控控制台，进入应用管理页面。 2. 点击“接入应用”，选择对应的语言。 3. 在应用归属中，点击“新增环境”。 4. 在新增环境弹窗中，输入以下信息。 1. 环境名称：输入合法环境名称。 2. 环境编码：自定义环境编码。 5. 点击确定按钮，完成环境创建。

本节为您介绍云迁移服务CMS资源规划之资源任务查看。 云迁移服务CMS 提供资源管理功能，您可以通过左侧菜单栏选择资源规划点击【资源管理】进入[资源管理]界面。[资源管理]界面展示资源基本信息，如资源名称、资源状态、资源类型、采集方式、资源发现任务、迁移组、迁移计划名称、计划创建时间、备注、操作等信息。 资源名称 用于用户创建资源所取得名称，可修改。 资源状态 用于现实资源迁移状态分为未计划、待迁移、迁移中、迁移完成、迁移失败。 资源类型 用于评估源机资源类型可分为主机、数据库、对象存储。 采集方式 区分源端资源创建通过的采集信息方式分为离线采集和在线采集。 资源发现任务 创建资源发现任务的任务名称，用于更好识别任务的对象、用途等。

本节为您介绍云迁移服务CMS中数据库迁移工具数据订阅快速配置,包括注意事项及操作步骤。 注意事项 本文仅简单介绍数据订阅的通用配置流程，不同情况下的高级配置请阅读数据订阅。 操作步骤 1. 进入数据订阅的任务列表界面。 2. 单击“创建订阅”按钮，进入订阅任务配置界面。 3. 填写订阅任务的参数信息。 4. 填写好源库信息后，单击测试连接按钮。 5. 通过连接测试后点击“下一步：选择订阅对象”。 6. 将需要订阅的表选中，并点击“>”箭头，将表移到右侧已选对象框中。 7. 确定需要订阅的表后，点击“下一步:启动”，启动订阅任务。 8. 启动订阅任务后，即可查看订阅任务实时进度。

本页介绍天翼云TeleDB数据库导出工单列表相关操作。 1、工单查询 输入查询条件单击查询按钮，执行查询操作。 2、数据导出 单击数据导出 按钮可添加新的数据导出任务，详见提交导出任务章节。 3、执行异常查看 执行异常的工单，可以单击工单状态上的，查看异常原因。 4、工单详情 在工单列表找到目标工单，在操作列单击详情按钮，在打开的工单详情弹窗可查看目标工单的详细信息。 5、重试 针对异常的工单，可以根据异常原因，进行选择是否需要重试，单击重试按钮即可进行重试。 6、下载 工单状态是执行完成的时候，会出现下载按钮，单击即可进行下载，鼠标浮至下载中按钮时，可查看当前实时下载进度。 注意 文件导出完成后，有效期为24小时，须在有效期内进行下载。

类别 RDS for MySQL TaurusDB 架构 传统主备架构，主备通过binlog同步数据。 存算分离架构，计算节点共享一份数据，无需通过binlog同步数据。 性能 十万级QPS，高并发场景下性能提升3倍。 支持百万级QPS；对于某些业务负载，吞吐量最高可提升至开源MySQL7倍；复杂查询场景，支持将提取列、条件过滤、聚合运算等操作向下推给存储层处理，性能相比传统架构提升数十倍。 扩展性 最多添加5个只读节点，添加只读所需时间与数据量大小相关，并且需要增加一份存储。 存储自动扩容，最大支持4TB。 最多添加15只读，由于共享存储，添加只读节点所需时间与数据量大小无关，且无需增加一份存储。 存储自动扩容，最大支持128TB。 可用性 故障自动倒换，RTO通常小于30秒。 主节点和只读节点无需通过binlog进行数据同步，延时更低，故障自动切换，RTO通常小于10秒。 备份恢复 通过全量备份+binlog回放实现任意时间点回滚。 通过全量备份（快照）+redo回放实现任意时间点回滚，备份恢复速度更快。 数据库版本 MySQL 5.6、5.7和8.0。 MySQL 8.0。

本页介绍天翼云TeleDB数据库PL/pgsql函数的参数引用方法。 PL/pgsql函数的参数是以$1,$2这样标识符来进行传递，也支持命名参数，所以参数的定义可以用下面的方式。 无命名参数 plaintext teledb CREATE OR REPLACE FUNCTION f2(text) RETURNS TEXT AS teledb $$ teledb$ BEGIN teledb$ RETURN $1; teledb$ END; teledb$ $$ teledb LANGUAGE PLPGSQL; CREATE FUNCTION teledb SELECT FROM f2('teledb'); f2 teledb (1 row) 给标识符指定别名 plaintext teledb CREATE OR REPLACE FUNCTION f2(text) RETURNS TEXT AS teledb $$ teledb$ DECLARE teledb$ axm ALIAS FOR $1; axm是$1的别名 teledb$ BEGIN teledb$ RETURN axm; teledb$ END; teledb$ $$ teledb LANGUAGE PLPGSQL teledb ; CREATE FUNCTION teledb SELECT FROM f2('teledb'); f2 teledb (1 row) 命名参数 plaintext teledb CREATE OR REPLACE FUNCTION f2(axm text) RETURNS TEXT AS teledb $$ teledb$ DECLARE teledb$ vxm ALIAS FOR $1; teledb$ BEGIN teledb$ RAISE NOTICE 'axm % ; vxm % ; $1 %',axm,vxm,$1; teledb$ RETURN $1; teledb$ END; teledb$ $$ teledb LANGUAGE PLPGSQL; CREATE FUNCTION teledb SELECT FROM f2('teledb'); NOTICE: axm teledb ; vxm teledb ; $1 teledb f2 teledb (1 row)

本页介绍天翼云TeleDB数据库PL/pgsql函数的返回值类型。 没有返回值 plaintext teledb CREATE OR REPLACE FUNCTION f8() RETURNS void AS teledb $$ teledb$ BEGIN teledb$ RAISE NOTICE '不用返回值，函数体可以有或没有return语句'; teledb$ RETURN ;这一句可以有，也可以没有 teledb$ END; teledb$ $$ teledb LANGUAGE plpgsql; CREATE FUNCTION teledb select from f8(); NOTICE: 不用返回值，函数体可以有或没有return语句 f8 (1 row) 返回简单类型 plaintext teledb CREATE OR REPLACE FUNCTION f9() RETURNS TEXT AS $$ BEGIN RETURN 'teledb'; END; $$ LANGUAGE plpgsql; CREATE FUNCTION teledb SELECT FROM f9() t(axm); axm teledb (1 row) teledb CREATE OR REPLACE FUNCTION f9(OUT axm TEXT) RETURNS TEXT AS $$ BEGIN axm:'teledb'; END; $$ LANGUAGE plpgsql; CREATE FUNCTION teledb SELECT FROM f9(); axm teledb (1 row) 上面两个函数其实就是同一个函数，建立时如果不加OR REPLACE 则会提示已经存在。 plaintext teledb CREATE OR REPLACE FUNCTION f10() RETURNS TEXT[] AS $$ BEGIN RETURN ARRAY['teledb','pgxz']; END; $$ LANGUAGE plpgsql; CREATE FUNCTION teledb SELECT FROM f10(); f10 {teledb,pgxz} (1 row) 返回一个复合类型 plaintext teledb CREATE TYPE trec AS teledb ( teledb( id integer, teledb( mc text teledb( ); CREATE TYPE teledb CREATE OR REPLACE FUNCTION f11() RETURNS trec AS teledb

本页介绍天翼云TeleDB数据库开发相关的规范。 1. 建议对DB object尤其是COLUMN加COMMENT，便于后续了解业务及维护 注释前后的数据表可读性对比，有注释的一看就明白。 plaintext teledb d+ toids; Table "public.toids" Column Type Collation Nullable Default Storage Stats target Descripti on +++++++ id integer not null plain name character varying extended birth timestamp(0) without time zone plain city character varying extended Indexes: "toidspkey" PRIMARY KEY, btree (id) Has OIDs: yes Distribute By: SHARD(id) Location Nodes: ALL DATANODES ^ teledb comment on column toids.name is '姓名'; COMMENT teledb comment on column toids.city is '居住城市'; COMMENT teledb d+ toids; Table "public.toids" Column Type Collation Nullable Default Storage Stats target Descripti on +++++++ id integer not null plain name character varying extended 姓名 birth timestamp(0) without time zone plain city character varying extended 居住城市 Indexes: "toidspkey" PRIMARY KEY, btree (id) Has OIDs: yes Distribute By: SHARD(id) Location Nodes: ALL DATANODES 2. 建议非必须时避免select ，只取所需字段，以减少包括不限于网络带宽消耗。 plaintext teledb

本页介绍天翼云TeleDB数据库PL/pgsql函数的返回值类型。 没有返回值 plaintext teledb CREATE OR REPLACE FUNCTION f8() RETURNS void AS teledb $$ teledb$ BEGIN teledb$ RAISE NOTICE '不用返回值，函数体可以有或没有return语句'; teledb$ RETURN ;这一句可以有，也可以没有 teledb$ END; teledb$ $$ teledb LANGUAGE plpgsql; CREATE FUNCTION teledb select from f8(); NOTICE: 不用返回值，函数体可以有或没有return语句 f8 (1 row) 返回简单类型 plaintext teledb CREATE OR REPLACE FUNCTION f9() RETURNS TEXT AS $$ BEGIN RETURN 'teledb'; END; $$ LANGUAGE plpgsql; CREATE FUNCTION teledb SELECT FROM f9() t(axm); axm teledb (1 row) teledb CREATE OR REPLACE FUNCTION f9(OUT axm TEXT) RETURNS TEXT AS $$ BEGIN axm:'teledb'; END; $$ LANGUAGE plpgsql; CREATE FUNCTION teledb SELECT FROM f9(); axm teledb (1 row) 上面两个函数其实就是同一个函数，建立时如果不加OR REPLACE 则会提示已经存在。 plaintext teledb CREATE OR REPLACE FUNCTION f10() RETURNS TEXT[] AS $$ BEGIN RETURN ARRAY['teledb','pgxz']; END; $$ LANGUAGE plpgsql; CREATE FUNCTION teledb SELECT FROM f10(); f10 {teledb,pgxz} (1 row) 返回一个复合类型 plaintext teledb CREATE TYPE trec AS teledb ( teledb( id integer, teledb( mc text teledb( ); CREATE TYPE teledb CREATE OR REPLACE FUNCTION f11() RETURNS trec AS teledb $$ teledb$

本页介绍天翼云TeleDB数据库开发相关的规范。 1. 建议对DB object尤其是COLUMN加COMMENT，便于后续了解业务及维护 注释前后的数据表可读性对比，有注释的一看就明白。 plaintext teledb d+ toids; Table "public.toids" Column Type Collation Nullable Default Storage Stats target Descripti on +++++++ id integer not null plain name character varying extended birth timestamp(0) without time zone plain city character varying extended Indexes: "toidspkey" PRIMARY KEY, btree (id) Has OIDs: yes Distribute By: SHARD(id) Location Nodes: ALL DATANODES ^ teledb comment on column toids.name is '姓名'; COMMENT teledb comment on column toids.city is '居住城市'; COMMENT teledb d+ toids; Table "public.toids" Column Type Collation Nullable Default Storage Stats target Descripti on +++++++ id integer not null plain name character varying extended 姓名 birth timestamp(0) without time zone plain city character varying extended 居住城市 Indexes: "toidspkey" PRIMARY KEY, btree (id) Has OIDs: yes Distribute By: SHARD(id) Location Nodes: ALL DATANODES 2. 建议非必须时避免select ，只取所需字段，以减少包括不限于网络带宽消耗。 plaintext teledb

本页介绍天翼云TeleDB数据库的序列使用方法。 序列的创建与访问 创建序列 plaintext teledb create sequence tseq; CREATE SEQUENCE 建立序列，不存在时才创建 plaintext teledb create sequence if not exists tseq; NOTICE: relation "tseq" already exists, skipping CREATE SEQUENCE 查看序列当前的使用状况 plaintext teledb select from tseq; lastvalue logcnt iscalled ++ 1 0 f (1 row) 获取序列的下一个值 plaintext teledb select nextval('tseq'); nextval 1 (1 row) 获取序列的当前值，这个需要在访问nextval()后才能使用 plaintext teledb select currval('tseq'); currval 1 (1 row) 设置序列当前值 plaintext teledb select setval('tseq',2); setval 2 (1 row) 序列在DML 中使用 plaintext teledb insert into tupdate values(nextval('tseq'),'teledb'); INSERT 0 1 teledb select from tupdate; id name age ++ 3 teledb (1 row) 序列作为字段的默认值使用 plaintext teledb alter table tupdate alter column id set default nextval('tseq'); ALTER TABLE teledb insert into tupdate(name) values('seqval'); INSERT 0 1 teledb select from tupdate; id name age ++ 3 teledb 4 seqval (2 rows) 序列作为字段类型使用

本页介绍天翼云TeleDB数据库PL/pgsql函数的返回值类型。 没有返回值 plaintext teledb CREATE OR REPLACE FUNCTION f8() RETURNS void AS teledb $$ teledb$ BEGIN teledb$ RAISE NOTICE '不用返回值，函数体可以有或没有return语句'; teledb$ RETURN ;这一句可以有，也可以没有 teledb$ END; teledb$ $$ teledb LANGUAGE plpgsql; CREATE FUNCTION teledb select from f8(); NOTICE: 不用返回值，函数体可以有或没有return语句 f8 (1 row) 返回简单类型 plaintext teledb CREATE OR REPLACE FUNCTION f9() RETURNS TEXT AS $$ BEGIN RETURN 'teledb'; END; $$ LANGUAGE plpgsql; CREATE FUNCTION teledb SELECT FROM f9() t(axm); axm teledb (1 row) teledb CREATE OR REPLACE FUNCTION f9(OUT axm TEXT) RETURNS TEXT AS $$ BEGIN axm:'teledb'; END; $$ LANGUAGE plpgsql; CREATE FUNCTION teledb SELECT FROM f9(); axm teledb (1 row) 上面两个函数其实就是同一个函数，建立时如果不加OR REPLACE 则会提示已经存在。 plaintext teledb CREATE OR REPLACE FUNCTION f10() RETURNS TEXT[] AS $$ BEGIN RETURN ARRAY['teledb','pgxz']; END; $$ LANGUAGE plpgsql; CREATE FUNCTION teledb SELECT FROM f10(); f10 {teledb,pgxz} (1 row) 返回一个复合类型 plaintext teledb CREATE TYPE trec AS teledb ( teledb( id integer, teledb( mc text teledb( ); CREATE TYPE teledb CREATE OR REPLACE FUNCTION f11() RETURNS trec AS teledb

本页介绍天翼云TeleDB数据库PL/pgsql函数的参数引用方法。 PL/pgsql函数的参数是以$1,$2这样标识符来进行传递，也支持命名参数，所以参数的定义可以用下面的方式。 无命名参数 plaintext teledb CREATE OR REPLACE FUNCTION f2(text) RETURNS TEXT AS teledb $$ teledb$ BEGIN teledb$ RETURN $1; teledb$ END; teledb$ $$ teledb LANGUAGE PLPGSQL; CREATE FUNCTION teledb SELECT FROM f2('teledb'); f2 teledb (1 row) 给标识符指定别名 plaintext teledb CREATE OR REPLACE FUNCTION f2(text) RETURNS TEXT AS teledb $$ teledb$ DECLARE teledb$ axm ALIAS FOR $1; axm是$1的别名 teledb$ BEGIN teledb$ RETURN axm; teledb$ END; teledb$ $$ teledb LANGUAGE PLPGSQL teledb ; CREATE FUNCTION teledb SELECT FROM f2('teledb'); f2 teledb (1 row) 命名参数 plaintext teledb CREATE OR REPLACE FUNCTION f2(axm text) RETURNS TEXT AS teledb $$ teledb$ DECLARE teledb$ vxm ALIAS FOR $1; teledb$ BEGIN teledb$ RAISE NOTICE 'axm % ; vxm % ; $1 %',axm,vxm,$1; teledb$ RETURN $1; teledb$ END; teledb$ $$ teledb LANGUAGE PLPGSQL; CREATE FUNCTION teledb SELECT FROM f2('teledb'); NOTICE: axm teledb ; vxm teledb ; $1 teledb f2 teledb (1 row)

本页介绍天翼云TeleDB数据库的序列使用方法。 序列创建与访问 创建序列 plaintext teledb create sequence tseq; CREATE SEQUENCE 建立序列，不存在时才创建 plaintext teledb create sequence if not exists tseq; NOTICE: relation "tseq" already exists, skipping CREATE SEQUENCE 查看序列当前的使用状况 plaintext teledb select from tseq; lastvalue logcnt iscalled ++ 1 0 f (1 row) 获取序列的下一个值 plaintext teledb select nextval('tseq'); nextval 1 (1 row) 获取序列的当前值，这个需要在访问nextval()后才能使用 plaintext teledb select currval('tseq'); currval 1 (1 row) 设置序列当前值 plaintext teledb select setval('tseq',2); setval 2 (1 row) 序列在DML 中使用 plaintext teledb insert into tupdate values(nextval('tseq'),'teledb'); INSERT 0 1 teledb select from tupdate; id name age ++ 3 teledb (1 row) 序列作为字段的默认值使用 plaintext teledb alter table tupdate alter column id set default nextval('tseq'); ALTER TABLE teledb insert into tupdate(name) values('seqval'); INSERT 0 1 teledb select from tupdate; id name age ++ 3 teledb 4 seqval (2 rows)

本页介绍天翼云TeleDB数据库在批量数据变更后，手动执行vacuum analyze收集统计信息的方法。 在批量数据变更后，由于autovacuum触发机制原因，或autovacuum任务繁忙原因，统计信息收集可能会一定的延时，此时统计信息是不准确的，会导致相关SQL的执行计划生成不准确，从而导致SQL执行变慢甚至执行卡死问题。 批量数据变更包括：批量导入数据、批量更新数据、批量删除数据、truncate表、truncate表+批量导入数据。 针对此问题，应在批量数据变更后，手动执行vacuum analyze收集统计信息。 在执行vacuum analyze前，可以适当调大maintenanceworkmem来提高效率，例如： set maintenanceworkmem to '8GB'; vacuum analyze 表名; 可能会因为账号权限要求，应用账号没有对该表的vacuum analyze权限，可创建函数解决此问题： create or replace function useranalyze (schemaname text,tablename text) returns int as $$ declare vsql text; begin vsql : 'vacuum analyze ' schemaname '.' tablename; execute vsql; return 1; end; $$ language plpgsql; select useranalyze('public','teledb1');

创建客户端CMK主密钥，用于加密CEK数据密钥。 plaintext CREATE CLIENT MASTER KEY clientmasterkeyname WITH ( KEYSTORE keystorename, KEYPATH "keypathvalue", ALGORITHM algorithmtype ); 参数描述： clientmasterkeyname：密钥对象名，在同一命名空间中满足唯一性约束,长度[1, 64] KEYSTORE：指定管理CMK的密钥工具或组件，取值如下： localkms： 本地KMS netcakms：网证通KMS,数据库内核连接管控的URL来连接KMS。其中，URL通过teledbxmanagerurl GUC配置进行设置，如果更改URL需要断开原有连接重新建立连接。 KEYPATH：KEYSTORE负责管理多个CMK密钥，KEYPATH选项用于在KEYSTORE中唯一标识CMK。其支持的字符范围包括09, az, AZ, 下划线'', 圆点'.'和短横线''。 ALGORITHM：由本语法创建的用于加密CEK，该参数用于指定加密算法的类型，支持 SM2：表示采用国密SM2算法 RSA2048，表示采用RSA算法密码长度为2048位。 RSA3072，表示采用RSA算法密码长度为3072位。

本页介绍天翼云TeleDB数据库xstore存储表的创建、查看、删除等操作。 创建xstore表 要创建xstore表，需要将表的访问方式(Table Access Method) 设为 xstore，在建表时显式使用USING xstore子句指定表访问方式。 plaintext teledb create table xt(a int,b int, c text) using xstore; CREATE TABLE teledb d+ xt; Table "public.xt" Column Type Collation Nullable Default Storage Stats target Description +++++++ a integer plain b integer plain c text extended Distribute By: HASH(a) Location Nodes: ALL DATANODES 建立xbtree索引 xstore引擎使用专用的xbtree索引,建立主键和索引默认都是使用xbtree索引,指定btree索引会自动变成xbtree索引,指定其他类型索引会失败。 plaintext teledb create table xt1(a int primary key, b int ,c text) using xstore; teledb d+ xt1; Table "public.xt1" Column Type Collation Nullable Default Storage Stats target Description +++++++ a integer not null plain b integer plain c text extended Indexes: "xt1pkey" PRIMARY KEY, xbtree (a) Distribute By: HASH(a) Location Nodes: ALL DATANODES teledb create index tx1b on xt1 using btree(b); CREATE INDEX teledb create index tx1c on xt1 using hash(c); ERROR: hash index is not supported for xstore, please use xbtree instead postgres

本页介绍天翼云TeleDB数据库修改xstore存储表结构的具体操作。 xstore表修改表结构和行存表语法一致，使用ALTER TABLE 语句对指定表进行操作： plaintext ALTER TABLE tablename ; 其中， 操作包括：增加字段，删除字段，修改字段名，修改表名等。 增加字段 xstore表增加字段和行存表语法一致，使用ADD COLUMN 语句增加字段。 plaintext teledb alter table xt add column c1 int; ALTER TABLE teledb teledb d+ xt; Table "public.xt" Column Type Collation Nullable Default Storage Stats target Description +++++++ a integer not null plain b integer plain c text extended c1 integer plain Indexes: "xtpkey" PRIMARY KEY, xbtree (a) Distribute By: HASH(a) Location Nodes: ALL DATANODES 删除字段 xstore表删除字段和行存表语法一致，使用DROP COLUMN 语句删除字段。 plaintext teledb alter table xt drop column c1; ALTER TABLE teledb d+ xt; Table "public.xt" Column Type Collation Nullable Default Storage Stats target Description +++++++ a integer not null plain b integer plain c text extended Indexes: "xtpkey" PRIMARY KEY, xbtree (a) Distribute By: HASH(a) Location Nodes: ALL DATANODES 修改字段名 xstore表修改字段名和行存表语法一致，使用RENAME COLUMN TO 语句增加字段。 plaintext teledb