本页介绍天翼云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

本页介绍天翼云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函数的参数引用方法。 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的消息及异常输出。 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

本页介绍天翼云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$

本章节主要介绍数据治理中心DataArts Studio的实例退订操作。 退订DataArts Studio实例 当用户不需要使用某个DataArts Studio实例时，可以参考如下操作退订该实例。 1.登录天翼云控制中心； 2.在“数据分析”项目下，单击【数据治理中心 DataArts Studio】； 3.找到创建成功的DataArts Studio实例，核实实例信息，点击“退订”即可。 详见下图：选择退订 删除作业 当用户不需要使用某个作业时，可以参考如下操作删除该作业，以减少作业的配额占用。 普通删除 1.登录数据治理中心控制台。选择实例，点击“进入控制台”，选择对应工作空间的“数据开发”模块，进入数据开发页面。 详见下图：选择数据开发 2.在数据开发主界面的左侧导航栏，选择“数据开发>作业开发”。 3.在作业目录中，右键单击作业名称，选择“删除”。 4.在弹出的“删除作业”页面，单击“确定”，删除作业。 批量删除 1.登录数据治理中心控制台。选择实例，点击“进入控制台”，选择对应工作空间的“数据开发”模块，进入数据开发页面。 详见下图：选择数据开发 2.在数据开发主界面的左侧导航栏，选择“数据开发 > 作业开发”。 3.在作业目录顶部，单击，选择“显示复选框”，在作业目录前出现复选框。 4.选择需要删除的作业，再次单击，选择“删除作业”。 5.在弹出的“删除作业”页面，单击“确定”，批量删除作业。

本文介绍控制台（或API）用量分析里的流量与日志统计的流量有差异的原因。 客户控制台上可查询带宽、流量等统计数据，该数据同时也应用于生成计费账单，其流量会比基于访问日志统计的流量偏多。原因是全站日志中记录的流量数据是基于应用层日志中响应消息头+响应body体统计出的流量，而在实际网络请求中产生的网络流量，由于存在TCP/IP包头消耗和TCP重传，要比应用层统计到的流量数据高出7%~15%。因此按照业界标准，应用于账单的计费值会比基于访问日志计算得出的计费值上浮10%。 TCP/IP包头的消耗 HTTP请求是基于TCP/IP协议的，数据包是TCP/IP协议通信传输中的数据单位，我们在使用基于TCP/IP协议的网络时，网络中传递的其实就是数据包。每个数据包的大小最大是1500字节，这1500字节中包括了TCP和IP协议组成的40个字节的包头，这两个协议包头其实也会产生流量，但是却无法被应用层统计到，因此这40个字节的流量就不会被统计到日志里，这部分的流量会占到我们通过日志计算出流量的2.74%（40/1460）以上，即3%左右。 TCP重传 根据互联网中网络的负载情况，通常情况下，会有接近3%~10%的数据包会因为网络堵塞、设备故障等各种异常情况被丢弃。发生丢包后，服务器会对丢弃的数据包进行重传，这部分的具体操作是由内核层的协议栈处理完成的，通常无法被应用层统计到的，因此在一定程度上也会造成日志统计与实际网络响应流量的差异。 综上所述，天翼云全站加速产品取平均值10%作为网络层额外消耗的流量比例，即应用于账单的计费值会比基于访问日志计算得出的计费值上浮10%。

本页介绍天翼云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

本页介绍天翼云TeleDB数据库元数据pgprofile的内容。 存储系统管理资源限制的配置信息。 名称 类型 定义 profname NameData 配置文件的名称 profsessions float4 允许的并发会话数 profsessioncpu float4 会话的CPU 时间限制 profquerycpu float4 查询的CPU 时间限制 profcontime float4 会话的总持续时间限制 profidletime float4 会话中允许的连续非活动时间 profsessionblks float4 会话中允许读取的数据块数（包括从内存和磁盘读取的块） profqueryblks float4 查询中允许读取的数据块数（包括从内存和磁盘读取的块） profprivatesga float4 会话在共享缓冲区中可以分配的空间 profcompositelimit float4 会话的总资源成本限制 proffailedlogtimes float4 连续失败登录尝试次数后锁定账户的时间 profpasslocktime float4 账户在指定连续失败登录尝试后锁定时间 profpasslifetime float4 密码可用于身份验证的时间 profpassgracetime float4 密码过期后允许警告并允许登录的时间 profpassreusetime float4 密码在重新使用前的时间 profpassreusemax float4 密码在重新使用前必须更改的次数 profcontainer float4 当前未使用 profpassverifyfunc text 密码复杂性验证函数的OID