本页介绍天翼云TeleDB数据库中表膨胀问题和应对建议。 由于TeleDB的MVCC实现机制原因，表数据的历史版本是保存在当前数据文件中的，通过VACUUM标识和回收一定时间之前的历史版本。对于增、删、改频率很高的表，由于VACUUM回收需要一定的时间，且回收与长事务有关，长事务会导致VACUUM不能及时标识回收历史版本，而频繁的新增、更新操作会写更多的新的页（数据块），导致表数据文件不断膨胀。 表膨胀会带来一些性能影响，如占用了更多的空间，全表扫描时需要扫描更多的的页（数据块）、更耗I/O、更耗时、索引扫描效率也会降低；VACUUM FREEZE时因需要全表扫描，同样效率更低。这和Oracle数据库频繁增、删、改导致的高水位表现一样。 应对表膨胀的建议有几点： 定期清理长事务，避免因长事务导致VACUUM回收失效。 大事务尽量拆成小事务。 设置合理的AUTOVACUUM，尽量能及时回收空间。 配置更好的硬件资源，提高SQL执行效率，提升VACUUM回收效率。 定期监测表膨胀情况，必要时在维护窗口、业务低峰期进行手动回收，或重建表。 用其它方案代替高频增删改的表，例如加入缓存层，高频操作在缓存层实时操作，然后定时同步到数据库。 评估是否可以设计为分区表，通过定期清理历史分区的方式加快数据回收。

本页介绍天翼云TeleDB数据库的加速VACUUM等维护操作。 TeleDB提供了参数maintenanceworkmem，用于为创建索引、统计信息收集、垃圾回收等操作提供维护内存；该参数默认为默认512MB1GB，在维护操作前，可以在会话级设置更大的维护内存来加快维护操作，建议调整为8GB2GB之间，不应太大，同时需要参考服务器实际剩余内存情况综合考虑： 会话级维护内存设置方法： teledb set maintenanceworkmem to '8GB';

本页介绍天翼云TeleDB数据库系统视图userconscolumns的内容。 视图的作用：提供当前用户所拥有的表中与约束相关的列的信息。 名称 类型 定义 constraintschema name 约束所在的模式（schema）名称。 constraintname name 约束的名称。 tableschema name 表所在的模式（schema）名称。 tablename name 表的名称。 columnname name 受约束的列的名称。 position smallint 列在约束中的位置。

名称 类型 定义 tableschema name 列所在的表的模式（schema）名称 tablename name 列所在的表的名称 columnname name 列的名称 datatype text 列的数据类型 datatypeowner name 数据类型的所有者名称 datalength integer 列的数据长度，对于字符类型使用pgcharmaxlength函数，对于数值类型使用pgnumericprecision函数 dataprecision integer 列的数值精度，使用pgnumericprecision函数获取 datascale integer 列的数值小数位数，使用pgnumericscale函数获取 nullable text 列是否可以为NULL columnid smallint 列的标识符，对应于attnum datadefault text 列的默认值，使用pggetexpr函数获取

分类 格式 说明 扫描方法 SeqScan(table) 强制对指定表使用序列扫描。 TidScan(table) 强制对指定表使用TID扫描。 IndexScan(table[ index...]) 强制对指定表使用索引扫描，可以指定某个索引。 IndexOnlyScan(table[ index...]) 强制对指定表仅使用索引扫描，可以指定某个索引。 BitmapScan(table[ index...]) 强制对指定表使用位图扫描，可以指定某个索引。 IndexScanRegexp(table[ POSIX Regexp...]) 强制对指定表使用索引扫描或仅索引扫描或位图扫描。使用正则匹配。 IndexOnlyScanRegexp(table[ POSIX Regexp...]) BitmapScanRegexp(table[ POSIX Regexp...]) NoSeqScan(table) 对指定表禁止使用序列扫描。 NoTidScan(table) 对指定表禁止使用TID扫描。 NoIndexScan(table) 对指定表禁止使用索引扫描（包括仅索引扫描）。 NoIndexOnlyScan(table) 对指定表禁止使用仅索引扫描。 NoBitmapScan(table) 对指定表禁止使用位图扫描。 连接方法 NestLoop(table table[ table...]) 强制对指定表使用嵌套循环连接。 HashJoin(table table[ table...]) 强制对指定表使用哈希连接。 MergeJoin(table table[ table...]) 强制对指定表使用合并连接。 NoNestLoop(table table[ table...]) 对指定表禁止使用嵌套循环连接。 NoHashJoin(table table[ table...]) 对指定表禁止使用哈希连接。 NoMergeJoin(table table[ table...]) 对指定表禁止使用合并连接 连接顺序 Leading(table table[ table...]) 强制连接顺序。 Leading() 强制连接顺序和方向， 行号校正 Rows(table table[ table...] correction) 纠正由指定表组成的联接结果的行号。可用的校正方法有绝对值（＃），加法（+ ），减法（）和乘法（ ）。是函数strtod（）可以读取的字符串。 并行查询配置 Parallel(table < of workers> [soft hard]) GUC Set(GUCparam value) 计划器运行时，设置GUC参数。

在执行DDL语句前，需要设置锁超时时间。本文为您介绍具体的操作。 在执行DDL语句前，一定要记得设置锁超时时间。 DDL语句会申请access exclusive锁，access exclusive锁是最强的排它锁，在获得锁前，要求该表上没有任何会话访问；同时，DDL语句会阻塞任何对表的操作。例如：drop table、truncate、reindex、vacuum full、部分alter table等等。 由于DDL语句在获得锁前，要求该表上没有任何会话访问，如果有长事务、长时间执行的SQL访问表，那么需要等待这些会话执行完成后才能获得access exclusive锁。在等锁的过程中，DDL语句会阻塞该表上所有DDL语句后面执行的SQL，包括SELECT。如果该表有高并发SQL语句，那么将会导致大量的SQL语句被阻塞，进而导致数据库连接数迅速增长、服务器CPU打满，严重影响业务。 可以通过设置锁超时解决此问题，锁超时设置一般可以使用如下3种方式，影响范围各不相同，超时时间推荐30~60s： 当前会话生效（即时生效）： teledb set locktimeout to '30s'; 用户默认锁超时（设置之后，新建的连接才会生效）： teledb alter role teledb set locktimeout to '30s'; 数据库默认锁超时（设置之后，新建的连接才会生效）： teledb alter database teledb set locktimeout to '30s'; 注意 locktimeout参数是获取锁的超时时间，不止对DDL语句生效，对DML、DQL也生效；因此用户、数据库级默认锁超时间参数不应设置过小，设置过小可能会导致正常的DML、DQL语句超时，尤其并发业务量大，业务高峰期间，可能会因为锁超时设置过小导致大面积SQL语句超时报错。

本页介绍天翼云TeleDB数据库常用的Oracle兼容相关参数说明。 以下是Oracle兼容相关参数，在创建实例后，应确认这些参数是打开状态。 enableoraclecompatibleon 兼容 oracle 语法开关 defaultwithrowidon oracle 的 rowid 语法，默认自带rowid enablelowerallobjectnameon oracle 语法中将对象转成小写

本页为您介绍修改定时任务的命令。 what(jobno bigint,what text)：第一个参数是定时任务的jodid；第二个参数是任务的命令。 plaintext select dbmsjob.what(20002, 'select pgsleep(1)'); 修改jobid为20002的定时任务的命令 期望结果，查询dbmsjob.job表发现jobid为20002的定时任务的commande字段为'select pgsleep(1)'

explain select from t1 where not exists( select 1 from t2 where t1.f2t2.f2); QUERY PLAN Remote Subquery Scan on all (dn01,dn02,dn03,dn04,dn05,dn06,dn07,dn08,dn09,dn10) (cost3865.00..4078.75 rows1 width367) > Hash Anti Join (cost3865.00..4078.75 rows1 width367) Hash Cond: (t1.f2 t2.f2) > Remote Subquery Scan on all (dn01,dn02,dn03,dn04,dn05,dn06,dn07,dn08,dn09,dn10) (cost100.00..682.00 rows1000 width367) Distribute results by S: f2 > Seq Scan on t1 (cost0.00..210.00 rows1000 width367) > Hash (cost5240.00..5240.00 rows50000 width33) > Remote Subquery Scan on all (dn01,dn02,dn03,dn04,dn05,dn06,dn07,dn08,dn09,dn10) (cost100.00..5240.00 rows50000 width33) Distribute results by S: f2 > Seq Scan on t2 (cost0.00..3240.00 rows50000 width33) (10 rows) Time: 0.974 ms teledb select from t1 where not exists( select 1 from t2 where t1.f2t2.f2); f1 f2 f3 f4 f5 f6 f7 f8 f9 f10 f11 f12 +++++++++++ (0 rows) Time: 42.944 ms 可以看到改写为not exists后效果也很好。

set preferolap to off; SET teledb explain select teledb1. from teledb1,teledb2 where teledb1.f1teledb2.f1 ; QUERY PLAN Hash Join (cost29.80..186.32 rows3872 width40) Hash Cond: (teledb1.f1 teledb2.f1) > Remote Subquery Scan on all (dn001,dn002) (cost100.00..158.40 rows880 width40) > Seq Scan on teledb1 (cost0.00..18.80 rows880 width40) > Hash (cost126.72..126.72 rows880 width4) > Remote Subquery Scan on all (dn001,dn002) (cost100.00..126.72 rows880 width4) > Seq Scan on teledb2 (cost0.00..18.80 rows880 width4) (7 rows)

本页介绍天翼云TeleDB数据库使用并行提高查询效率的最佳实践。 在大表查询时，为充分利用服务器资源，可以尝试开启并行，多进程并发查询，提升查询效率。在执行计划中，算子前增加关键字Partial，同时有关键字 Workers Planned: xx，表示SQL使用了并行。 例如下面的SQL，未开启并行。 teledb explain select count(1) from teledb1; QUERY PLAN Finalize Aggregate (cost118.81..118.83 rows1 width8) > Remote Subquery Scan on all (dn001,dn002) (cost118.80..118.81 rows1 width0) > Partial Aggregate (cost18.80..18.81 rows1 width8) > Seq Scan on teledb1 (cost0.00..18.80 rows880 width0) (4 rows) 下面是开启并行查询后的执行计划。 teledb explain select count(1) from teledb1; QUERY PLAN Parallel Finalize Aggregate (cost14728.45..14728.46 rows1 width8) > Parallel Remote Subquery Scan on all (dn001,dn002) (cost14728.33..14728.45 rows1 width0) > Gather (cost14628.33..14628.44 rows1 width8) Workers Planned: 2 > Partial Aggregate (cost13628.33..13628.34 rows1 width8) > Parallel Seq Scan on teledb1 (cost0.00..12586.67 rows416667 width0) (6 rows) 建议不要全局开启并行，仅在需要开启并行的具体SQL上开启，可通过会话级设置并行，或hint方式指定并行。 会话级设置如： set maxparallelworkerspergather2; 执行SQL; set maxparallelworkerspergather0;

本页介绍天翼云TeleDB数据库的列设计规范。 1. 建议能用数值类型的，就不用字符类型。 2. 建议能用varchar(N) 就不用char(N)、text。 3. 建议使用default NULL，而不用default ''。 4. 如果有国际业务，建议使用timestamp with time zone而不是timestamp without time zone，避免时间函数在对于不同时区的时间点返回值不同。 5. 建议使用NUMERIC(precision, scale)来存储货币金额和其它要求精确计算的数值, 而不使用real,double precision。

本页为您介绍如何创建定时任务。 submit(command text, nextdate timestamptz, schedual text, force bool)：第一个参数是定时任务的命令；第二个参数是定时任务能够被调度的时间；第三个参数是定时任务的时间间隔，每间隔多长时间执行定时作业；第四个参数是否启用定时任务。 plaintext select dbmsjob.submit('select pgsleep(5)', '20231107 15:00:00', ' '); 查询dbmsjob.job表会有刚刚创建的定时任务，其中jobid是随机分配的

名称 类型 定义 globalkeyname name 客户端加密主密钥（cmk）名称。 keynamespace oid 包含此客户端加密主密钥（cmk）的命名空间oid。 keyowner oid 客户端加密主密钥（cmk）的所有者。 keyacl aclitem[] 创建该密钥时所拥有的访问权限。 createdate timestamp 创建密钥的时间。

名称 类型 定义 auditor name 审计策略的创建者或所有者的用户名，通过pgcatalog.pggetuserbyid函数根据S.auditorid获取。 objectschema name 被审计对象（通常是表）所在的模式（schema）的名称，通过连接pgclass表和pgnamespace表获取。 objectname name 被审计对象的名称，直接从pgclass表中获取。 policyname name 审计策略的名称，直接从pgauditfgaconf表中获取。 auditcolumns text 被包含在审计策略中的列的列表，直接从pgauditfgaconf表中获取。

本页介绍天翼云TeleDB数据库元数据pgclsgroup的内容。 存储行列级安全访问策略的分组信息。 名称 类型 定义 polid int16 策略ID groupid int16 组ID parentid int16 父组ID shortname NameData 简称 longname text 长名称

本页介绍天翼云TeleDB数据库元数据pgclslabel的内容。 存储行列级安全访问策略的标签信息。 名称 类型 定义 polid int16 策略ID labelid int16 标签ID levelid int16 层级ID compartmentid int16[1] 组别ID 数组（长度为 1） groupid int16[1] 组ID 数组（长度为 1）

名称 类型 定义 schemaname name 列所在的表的模式（schema）名称。 tablename name 列所在的表的名称。 columnname name 列的名称。 comments text 列的注释信息。

名称 类型 定义 auditor name 创建或所有审计配置的用户的名称，通过pgcatalog.pggetuserbyid函数根据S.auditorid获取。 username name 被审计的用户的名称，通过pgcatalog.pggetuserbyid函数根据S.userid获取。这个字段表示哪个用户的操作将被审计。 actionname text 与审计配置相关联的审计动作的名称，通过pgcatalog.pggetauditactionname函数根据S.actionid获取。 actionmode text 审计动作的模式或类型，通过pgcatalog.pggetauditactionmode函数根据S.actionmode获取。这个模式描述了在什么情况下触发审计动作。 actionison boolean 表示审计动作是否启用的状态。如果审计动作启用，这个字段将返回一个表示真值的指示（可能是true、1或其他表示启用的值）。

名称 类型 定义 polid int16 策略ID levelid int16 层级ID shortname NameData 简称 longname text 长名称

名称 类型 定义 pkgname NameData 包的名称 pkgnamespace Oid 包所属的命名空间的OID pkgcrrspndingns Oid 包成员所在的命名空间的OID pkgowner Oid 包的所有者ID pkglang Oid 包语言的OID（pglanguage 表中的条目） pkgcost float4 估计的执行成本 pkgrows float4 估计的输出行数（如果返回结果集） pkgeditionable bool 包是否可编辑 pkgseriallyreuseable bool 包是否可串行重用 pkgcollation NameData 包的排序规则 pkgaccesstype int16 包的访问类型（pkgaccesstype 的值） pkgaccessobject Oid 包的访问对象（如果未指定pkgaccesstype，则设置为无效 OID） pkgissystem bool 包是否是系统包 pkgheadersrc text 包头（BKIFORCENOTNULL） pkgbodysrc text 包体（BKIFORCENOTNULL） pkgvarsrc text 包变量上下文（如果没有变量则为NULL） pkgconfig text[1] 包本地GUC 设置 pkgacl aclitem[1] 访问权限

名称 类型 定义 username NameData 用户名 iscurrent bool 是否为当前用户和密码 failedlogattempts int32 失败的登录尝试次数 failedlogtime timestamptz 最后一次失败登录的时间 passwdstarttime timestamptz 密码开始使用的时间 passwddiscardtime timestamptz 密码被废弃的时间 passwdchangetimes int32 自从密码被废弃以来的密码更改次数 password text 密码

本页介绍天翼云TeleDB数据库元数据pgsubscriptiontable的内容。 存储发布订阅中的表信息。 名称 类型 定义 srsubid Oid 订阅（subscription）的 OID srrelid Oid 表（table）的 OID pubname NameData 发布（publication）的名称

本页介绍如何删除用户指定的主密钥。 plaintext DROP CLIENT MASTER KEY clientmasterkeyname [CASCADE RESTRICT] 参数描述： clientmasterkeyname ：想要删除的主密钥对象名 CASCADE 和 RESTRICT 控制对依赖对象的影响： CASCADE：表示级联删除。不仅会删除指定的客户端主密钥，还会自动删除所有依赖于该主密钥的对象。 RESTRICT：只有在没有任何依赖对象的情况下，才会允许删除客户端主密钥。

本页介绍天翼云TeleDB数据库元数据pgclsuser的内容。 存储行列级安全访问策略的用户信息。 名称 类型 定义 polid int16 策略ID privilege int16 权限值 userid Oid 用户的OID maxreadlabel int16 最大读取标签ID maxwritelabel int16 最大写入标签ID minwritelabel int16 最小写入标签ID defaultreadlabel int16 默认读取标签ID defaultwritelabel int16 默认写入标签ID defaultrowlabel int16 默认行标签ID username NameData 用户名

本页介绍天翼云TeleDB数据库元数据pgxcnode的内容。 存储分布节点信息。 名称 类型 定义 nodename NameData 节点的名称 nodetype char 节点类型 nodeport int32 节点连接的端口号 nodehost NameData 节点连接的主机名或IP 地址 nodeisprimary bool 是否是主节点 nodeispreferred bool 是否是首选节点 nodeid int32 节点标识符 nodeclustername NameData 节点所属的集群名称 fwdserverport int32 Forword进程端口号

本页介绍天翼云TeleDB数据库元数据pgsynonym的内容。 存储同义词的管理和配置。 名称 类型 定义 synname NameData 同义词的名称 synnamespace Oid 同义词所属的命名空间（schema）的 OID objnamespace NameData 对象所属的模式的名称，如果为null，则在搜索路径中查找对象 objname NameData 对象的名称 objdblink NameData 对象所在的数据库链接名称（如果适用） synowner Oid 同义词的所有者的OID

名称 类型 定义 srsubid Oid 订阅（subscription）的 OID srshardid int32 分片（shard）的 ID pubname NameData 发布（publication）的名称

本页介绍天翼云TeleDB数据库元数据pgpartitioninterval的内容。 存储管理和配置分区表的区间信息。 名称 类型 定义 partrelid Oid 分区表的OID partpartkey int16 分区键 partintervaltype int16 分区间隔类型 partdatatype Oid 分区数据类型的OID partnparts int32 分区数量 partstartvalueint int64 分区起始值（整数类型） partstartvaluets timestamptz 分区起始值（时间戳类型） partintervalint int32 分区间隔（整数类型）

本页介绍天翼云TeleDB数据库修改存储过程所属用户的语法。 修改不带参数的存储过程所属用户 teledb CREATE OR REPLACE PROCEDURE public.proc1() AS $$ begin raise notice 'Hello teledbpg'; end; $$ LANGUAGE PLPGSQL; CREATE PROCEDURE teledb alter procedure proc1() owner to teledbadmin; ALTER PROCEDURE teledb 修改带参数的存储过程所属用户 teledb CREATE OR REPLACE PROCEDURE proc1(aint int) AS $$ begin raise notice '%',aint; end; $$ LANGUAGE PLPGSQL; CREATE PROCEDURE teledb alter procedure proc1 (int) owner to teledbadmin; ALTER PROCEDURE teledb

名称 类型 定义 relid Oid 表的OID userid Oid 用户的OID attnum int16 列号 enable bool 是否启用数据掩码 username NameData 用户名 nspname NameData 模式的名称 tblname NameData 表的名称

SELECT pgxactcommittimestamp(xmin) as xmintime, pgxactcommittimestamp(case xmax when 0 then null else xmax end) as xmaxtime, FROM pgdirtyread('foo') AS t(tableoid oid, ctid tid, xmin xid, xmax xid, cmin cid, cmax cid, dead boolean,bar bigint, dropped2 text, info text) where (pgxactcommittimestamp(xmin) < ' 20231102 16:43:02' and (pgxactcommittimestamp(case xmax when 0 then null else xmax end) < '20231102 16:43:02') is distinct from true ) ; xmintime xmaxtime tableoid ctid xmin xmax cmin cmax dead bar dropped2 info +++++++++++ 20231102 16:42:47.230036+08 16432 (0,3) 680 0 0 0 f 5 eee 20231102 16:42:41.46109+08 16432 (0,3) 659 0 0 0 f 3 cccnew2 (2 rows)