CREATE TABLE tnativelistdefault PARTITION OF tnativelist DEFAULT; CREATE TABLE teledb insert into tnativelist values(1,'上海',1,currentdate); INSERT 0 1 多级分区表 创建主表 plaintext teledb create table tnativemullist(f1 bigserial not null,f2 integer,f3 text,f4 text, f5 date) partition by list ( f3 ) distribute by shard(f1); CREATE TABLE 创建二级表 plaintext teledb create table tnativemullistgd partition of tnativemullist for values in ('广东') partition by range(f5); CREATE TABLE teledb create table tnativemullistbj partition of tnativemullist for values in ('北京') partition by range(f5); CREATE TABLE teledb create table tnativemullistsh partition of tnativemullist for values in ('上海'); 创建三级表 plaintext teledb create table tnativemullistgd201701 partition of tnativemullistgd(f1,f2,f3,f4,f5) for values from ('20170101') to ('20170201'); CREATE TABLE teledb create table tnativemullistgd201702 partition of tnativemullistgd(f1,f2,f3,f4,f5) for values from ('20170201') to ('20170301'); CREATE TABLE teledb create table tnativemullistbj201701 partition of tnativemullistbj(f1,f2,f3,f4,f5) for values from ('20170101') to ('20170201'); CREATE TABLE teledb create table tnativemullistbj201702 partition of tnativemullistbj(f1,f2,f3,f4,f5) for values from ('20170201') to ('20170301'); CREATE TABLE 查看表结构 plaintext teledb d+ tnativemullist Table "public.tnativemullist" Column Type Collation Nullable Default Storage Stats target Description +++++++ f1 bigint not null nextval('tnativemullistf1seq'::regclass) plain f2 integer plain f3 text extended f4 text extended f5timestamp(0) without time zone plain Partition key: LIST (f3) Partitions: tnativemullistbj FOR VALUES IN ('北京'), PARTITIONED, tnativemullistgd FOR VALUES IN ('广东'), PARTITIONED, tnativemullistsh FOR VALUES IN ('上海') Distribute By: SHARD(f1) Location Nodes: ALL DATANODES teledb

本页介绍天翼云TeleDB数据库中定期清理长事务、长时间未结束的SQL的原因和操作。 长事务、长时间未结束的SQL，对数据库危害极大，会导致表膨胀严重，垃圾回收不成功，XID回收异常，甚至会让XID耗尽而导致数据库进入只读状态。 特别注意：长事务会导致VACUUM FULL也没有办法回收空间，即使长事务的表和VACUUM FULL的表没有关系。 应定期检查并清理长事务、长时间未结束的SQL： 连接所有CN、DN主节点，执行以下SQL，查询超过1小时的会话： select pid,clientaddr,statechange,querystart,statechange,EXTRACT(EPOCH FROM (now()querystart)),query,state,usename,applicationname from pgstatactivity where EXTRACT(EPOCH FROM (now()querystart))> 3600 and state!'idle';

本文为您介绍如何配置访问模式的顺序。 TeleDB有一个运行变量叫searchpath，其值为模式名列表，用于配置访问数据对象的顺序，如下所示。 当前连接用户。 plaintext teledb select currentuser; currentuser teledb (1 row) 显示当前searchpath，搜索路径只配置为$user , public，其中 $user 为当前用户名，即上面的currentuser 值teledb 。 plaintext teledb show searchpath; searchpath "$user", public (1 row) 不指定模式创建数据表，则该表存放于第一个搜索模式下面。第一个模式找不到的情况下选择第二个，依次顺序查找。 plaintext teledb create table t2(id int, content text); CREATE TABLE teledb dt t2 List of relations Schema Name Type Owner +++ public t2 table teledb (1 row) 由于没有teledb模式，所以表默认放到了public模式下 创建teledb模式后再次建表，表建到了teledb模式下 teledb create schema teledb; CREATE SCHEMA teledb create table t3(id int, content text); CREATE TABLE teledb dt t3 List of relations Schema Name Type Owner +++ teledb t3 table teledb (1 row) 指定表位于某个模式下，不同模式下表名可以相同。在public模式下创建t3表 plaintext teledb create table public.t3(id int, content text); CREATE TABLE teledb dt public.t3 List of relations Schema Name Type Owner +++ public t3 table teledb (1 row) 同名的表查询时，没有指定shema时，始终只会查到前面模式的表数据。 plaintext 插入数据到public.t3表 teledb

本文为您介绍如何创建模式。 模式本质上是一个名字空间，Oracle里一般叫用户，SQL Server中叫框架，MySQL 中叫数据库，模式里面包含表、数据类型、函数以及操作符，对象名称可以与在其他模式中存在的对象重名，访问某个模式中的对象时可以使用模式名.对象名 。 您可参考如下操作创建模式。 标准语法 plaintext teledb create schema teledbschema; CREATE SCHEMA 扩展语法，不存在时才创建 plaintext teledb create schema if not exists teledbschema; NOTICE: schema "teledbschema" already exists, skipping CREATE SCHEMA 指定所属用户 plaintext teledb create schema teledbschemaowner AUTHORIZATION teledbuser; CREATE SCHEMA teledb dn teledbschemaowner List of schemas Name Owner + teledbschemaowner teledbuser (1 row)

本页介绍天翼云TeleDB数据库的count(distinct xx)优化案例。 count(distinct xxx)发生在CN节点，对于TP类业务，需要操作的数据量少的情况下，性能开销是没有问题的，而且往往比下推执行的性能开销还要小。但如果一次要操作的数据量比较大的AP类业务，则网络传输就会成功瓶颈。 针对distinct，可以改写为group by写法，将数据去重操作下推到DN上执行，提高效率。 下面是针对count(distinct xx)写法的SQL优化案例： 1. 测试数据准备： teledb CREATE TABLE t1(f1 serial not null unique,f2 text,f3 text,f4 text,f5 text,f6 text,f7 text,f8 text,f9 text,f10 text,f11 text,f12 text) distribute by shard(f1); NOTICE: Replica identity is needed for shard table, please add to this table through "alter table" command. CREATE TABLE Time: 89.938 ms teledb insert into t1 select t,md5(t::text),md5(t::text),md5(t::text),md5(t::text),md5(t::text),md5(t::text),md5(t::text),md5(t::text),md5(t::text),md5(t::text),md5(t::text) from generateseries(1,1000000) as t; INSERT 0 1000000 Time: 14849.045 ms (00:14.849) teledb analyze t1; ANALYZE Time: 1340.387 ms (00:01.340) 2. 改写前的SQL执行计划和耗时： teledb explain (verbose) select count(distinct f2) from t1; QUERY PLAN Aggregate (cost103320.00..103320.01 rows1 width8) Output: count(DISTINCT f2) > Remote Subquery Scan on all (dn01,dn02,dn03,dn04,dn05,dn06,dn07,dn08,dn09,dn10) (cost100.00..100820.00 rows1000000 width33) Output: f2 > Seq Scan on public.t1 (cost0.00..62720.00 rows1000000 width33) Output: f2 (6 rows) Time: 0.748 ms postgres

本页介绍天翼云TeleDB数据库使用索引提高查询效率的最佳实践。 通过explain查看执行计划，查看SQL语句是否使用到了索引，Seq Scan表示对表进行了全表扫描，而如Index Scan，Index Only Scan则表示使用了索引扫描。 通常情况下，使用索引可以加速查询速度，但索引也会增加数据更新的开销，在数据量较小时，优化器也可能会使用全表扫描代替索引扫描。 例如，下面的SQL语句，使用了Parallel Seq Scan并行全表扫描。 teledb explain select from teledb2 where f3'1'; QUERY PLAN Remote Fast Query Execution (cost0.00..0.00 rows0 width0) Node/s: dn001, dn002 > Gather (cost1000.00..7827.20 rows1 width14) Workers Planned: 2 > Parallel Seq Scan on teledb2 (cost0.00..6827.10 rows1 width14) Filter: (f3 '1'::text) (6 rows) 在f2字段上创建索引后，下面的SQL语句，使用了Index Scan索引扫描。 teledb create index teledb2f2idx on teledb2(f2); CREATE INDEX postgres explain select from teledb2 where f21; QUERY PLAN Remote Fast Query Execution (cost0.00..0.00 rows0 width0) Node/s: dn001, dn002 > Index Scan using teledb2f2idx on teledb2 (cost0.42..4.44 rows1 width14) Index Cond: (f2 1) (4 rows) 当然，按SQL优化原则，上述SQL语句where条件都没有带分布键，导致SQL下发到了所有DN节点，建议尝试优化为带分布键查询。

exists子句在数据量比较大的情况下，优化器选择走Hash Semi Join，而在调大workmem后，优化器执行走Hash Join，性能会更好。本文为您介绍该场景下的详细测试情况。 以下是关于该场景的测试情况： 1. workmem默认4MB时，SQL执行计划和耗时情况如下： 可以看到，优化器选择走了Hash Semi Join，耗时3.7秒。 teledb explain select count(1) from t1 where exists(select 1 from t2 where t2.t1f1t1.f1); QUERY PLAN Finalize Aggregate (cost242218.32..242218.33 rows1 width8) > Remote Subquery Scan on all (dn001,dn002) (cost242218.30..242218.32 rows1 width0) > Partial Aggregate (cost242118.30..242118.31 rows1 width8) > Hash Semi Join (cost110248.00..242118.30 rows505421 width0) Hash Cond: (t1.f1 t2.t1f1) > Seq Scan on t1 (cost0.00..17420.00 rows1000000 width4) > Hash (cost79340.00..79340.00 rows3000000 width4) > Remote Subquery Scan on all (dn001,dn002) (cost100.00..79340.00 rows3000000 width4) Distribute results by S: t1f1 > Seq Scan on t2 (cost0.00..52240.00 rows3000000 width4) (10 rows) Time: 1.091 ms teledb select count(1) from t1 where exists(select 1 from t2 where t2.t1f1t1.f1); count 500000 (1 row) Time: 3779.401 ms (00:03.779) 2. workmem调整为128MB后，SQL执行计划和耗时情况如下： 可以看到，优化器选择走了Hash Join，耗时1.9秒。 teledb

本文为您介绍now()导致分区不能剪枝问题优化案例。 now()函数是获取当前时间，当SQL语句中分区表时间传入now()时，由于SQL下推DN节点执行，优化器在CN节点生成执行计划时，无法进行分区剪枝，导致扫描了所有分区，导致SQL性能下降，SQL并行执行时会引起严重的分区表锁冲突。 针对此问题，建议传入具体值代替now()，或定义一个稳定函数代替now()。 以下是关于该场景的测试情况： 1. 准备测试数据： teledb create table ttimerange (f1 bigint, f2 timestamp ,f3 bigint) partition by range (f2) begin (timestamp without time zone '20210601 0:0:0') step (interval '1 month') partitions (12) distribute by shard(f1) to group defaultgroup; CREATE TABLE 2. 使用now()时SQL执行计划： 可以看到，SQL被下推到DN节点执行，优化器没有剪枝，扫了所有分区。 teledb explain select from ttimerange where f2 Append (cost0.00..0.00 rows0 width0) > Seq Scan on ttimerange (partition sequence: 0, name: ttimerangepart0) (cost0.00..2.17 rows30 width24) Filter: (f2 Seq Scan on ttimerange (partition sequence: 1, name: ttimerangepart1) (cost0.00..2.17 rows30 width24) Filter: (f2 Seq Scan on ttimerange (partition sequence: 2, name: ttimerangepart2) (cost0.00..2.17 rows30 width24) Filter: (f2 Seq Scan on ttimerange (partition sequence: 3, name: ttimerangepart3) (cost0.00..2.17 rows30 width24) Filter: (f2 Seq Scan on ttimerange (partition sequence: 4, name: ttimerangepart4) (cost0.00..2.17 rows30 width24) Filter: (f2 Seq Scan on ttimerange (partition sequence: 5, name: ttimerangepart5) (cost0.00..2.17 rows30 width24) Filter: (f2 Seq Scan on ttimerange (partition sequence: 6, name: ttimerangepart6) (cost0.00..2.17 rows30 width24) Filter: (f2 Seq Scan on ttimerange (partition sequence: 7, name: ttimerangepart7) (cost0.00..2.17 rows30 width24) Filter: (f2 Seq Scan on ttimerange (partition sequence: 8, name: ttimerangepart8) (cost0.00..2.17 rows30 width24) Filter: (f2 Seq Scan on ttimerange (partition sequence: 9, name: ttimerangepart9) (cost0.00..2.17 rows30 width24) Filter: (f2 Seq Scan on ttimerange (partition sequence: 10, name: ttimerangepart10) (cost0.00..2.17 rows30 width24) Filter: (f2 Seq Scan on ttimerange (partition sequence: 11, name: ttimerangepart11) (cost0.00..2.17 rows30 width24) Filter: (f2 < now()) (27 rows) 3. 自定义一个稳定函数 teledb

查询优化相关GUC参数 参数 类型 用途 默认值/最大值 生效方式 preferolap bool 关闭时复杂查询不走重分布，直接拉到cn计算 true userset olapoptimizer bool 关掉，会把数据拉到cn再count；打开，会在dn先聚集一遍，再在cn聚集一遍 on userset enablepullupsubquery bool 是否将not in(select xxx)转换成hash join,注意，如果子查询存在null，则返回结果是不一致的 off userset replicationlevel integer 执行计划走复制方式的最大层数 1/INTMAX userset restrictquery bool 尽可能将查询只发给相关的节点 true userset enablesubqueryshipping bool 子查询只包含常量的情况将子查询下推 true userset sharedqueues integer 最大支持数据交换并发个数 256/INTMAX restart usedatapump bool 使用datapump去做数据交换 true reload debugdatapump bool 数据交换优化debug开关 false reload senderthreadnum integer 数据交换发送线程个数 8/512 reload senderthreadbuffersize integer 数据交换发送缓冲区 16/1048576k restart senderthreadbatchsize integer 数据交换缓冲区发送阈值 8/524288k reload persistentdatanodeconnections bool 是否保持CN和DN之间的会话。高并发业务场景要保持on，否则每次CN和DN之间的连接都需要从连接池获取。 on restart poolerscalefactor integer CN和DN之间的连接池中一次连接扩展个数。高并发场景，用户连接一次增长太快，可能导致pooler扩展不及时，导致应用报错获取连接失败，需要调大该参数。 8 restart

本页介绍天翼云TeleDB数据库的索引设计规范。 1. 索引类型支持多种，通常情况下使用默认Btree索引即可。 2. 建议创建或删除索引时，加CONCURRENTLY关键字在线创建，不阻塞写入。 3. 对于频繁更新/删除的列，如果这些列上有索引, 建表时设置合适的填充因子。 4. 重建索引时，建议先在线创建一个同字段索引，再删除原索引，避免在索引重建过程中因索引缺失导致查询性能陡降。 5. 建议用唯一索引unique index 代替唯一约束unique constraints，便于后续维护。 6. 建议对where条件中有多个字段and的高频SQL，建多个字段的联合索引，选择率高的字段放在前面。 7. 建议对有固定条件，且选择率高（数据占比低）的SQL，建带where条件的部分索引。 8. 建议对经常使用表达式作为查询条件的SQL，创建表达式索引或函数索引提升效率。 9. 建议单个表不要创建太多索引，一般不建议超过6个。

explain analyze select t1. from t1,t2 where t1.f1t2.f1 limit 10; QUERY PLAN Limit (cost100.25..101.70 rows10 width367) (actual time1.527..3.899 rows10 loops1) > Remote Subquery Scan on all (dn01,dn02,dn03,dn04,dn05,dn06,dn07,dn08,dn09,dn10) (cost100.25..101.70 rows10 width367) (actual time1.525..1.529 rows10 loops1) Planning time: 0.360 ms Execution time: 18.193 ms (4 rows) Time: 19.921 ms 可以看到，preferolap设置为on后，计算、排序和limit过滤在DN上完成，返回CN的数量是每个DN节点limit之后的数据，解决了上面SQL优化前大量数据上拉CN节点的问题，性能提升了150倍。 这里也说明，preferolap参数使用也和SQL特点有关，如果将preferolap设置off，SQL需要拉大量数据到CN计算的话，性能会明显下降，我们在设置preferolap参数前一定要做好评估。

select from t1 where f2 not in (select f2 from t2); f1 f2 f3 f4 f5 f6 f7 f8 f9 f10 f11 f12 +++++++++++ (0 rows) Time: 105.249 ms 可以看到，调整大workmem前发生了Materialize物化动作，即将结果集存储在了内存或磁盘上；而调大workmem后，workmem足够放下filter的数据，不需要再做 Materialize物化，filter 由原来的subplan变成了hash subplan，直接在内存 hash表中filter； 优化后SQL性能提高了40倍，效果明显。

本页介绍天翼云TeleDB数据库关联查询使用分布键关联的最佳实践。 多表关联时，通过explain查看执行计划，查看SQL语句是否使用到分布键（前面已介绍），查看SQL关联是否使用到了分布键。 如果两表关联都使用到了分布键，那么两表关联可以在dn节点内完成，不需要在dn节点之间交互数据；如果其中一张表没有用分布键，那么两表关联不能在dn节点内完成，该表需要在dn节点之间交互数据；如果两张表都没有使用分布键，那么两张表都需要在dn节点之间交互数据。 两表关联时，应优先使用两表的分布键关联，尽量保证高频并发的SQL都用到了分布键关联；其次至少有一张表用到了分布键，也可以减少一次数据重分布；两张表都没有用到分布键的场景应尽量避免。同时，两表关联时如果只能有一个表带分布键，那么更大的表、或查询结果集更大的表优先使用到分布键，让小一点的表去重分布数据。 在执行计划中，如果DN之间有数据重分布，那么执行计划中会有这样的关键字Distribute results by S: f1，这里表示按f1进行数据重分布。 例如，teledb1的分布键为f2，teledb2的分布键为f1，下面的SQL，两表关联时teledb1没有用到分布键，两表关联不能在dn节点内完成，需要dn节点之间发起数据交互（重分布），teledb1在完成表扫描后发起了按f1字段重分布的动作，对应执行计划中的Distribute results by S: f1。 teledb explain select teledb1. from teledb1,teledb2 where teledb1.f1teledb2.f1 ; QUERY PLAN Remote Subquery Scan on all (dn001,dn002) (cost29.80..186.32 rows3872 width40) > 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) Distribute results by S: f1 > Seq Scan on teledb1 (cost0.00..18.80 rows880 width40) > Hash (cost18.80..18.80 rows880 width4) > Seq Scan on teledb2 (cost0.00..18.80 rows880 width4) (8 rows) 例如下面的SQL，teledb1和teledb2关联时都用到了分布键，那么两表关联可以在dn节点内完成，不需要在dn节点之间交互数据。 teledb

本页介绍天翼云TeleDB数据库的复制表设计规范。 1. 复制表在所有DN节点都有一份完整的数据，主要用于解决多表关联时，由于关联条件没有使用到分布键，而导致的数据在DN节点之间交互问题（即数据重分布）。 2. 由于复制表需要在每个DN节点存储一份完整的数据，复制表在新增、更新、删除时需更新所有DN节点的数据，DN节点数据越多，性能越差。 3. 复制表不适合高并发更新、删除的业务场景，因为更新、删除是所有DN节点上操作的一个大事务，高并发更新、删除的业务场景，很容易产生死锁。 4. 复制表适合经常需要与其它表做非分布键关联的的小表，为多表关联而生，更适合业务中的一些配置表、枚举表。 5. 复制表不支持主主复制。 6. 复制表不能在插入更新时使用结果不确定性的函数，例如now()，以免DN之间产生不同数据。

本页介绍天翼云TeleDB数据库的对象命名规范。 这里的对象，指的是数据库对象，如：数据库、模式、表、视图、索引、约束、序列、函数、过程、触发器、规则、包、同义词等。 1. 对象名称建议使用小写字母、数字、下划线的组合，不要使用大写、大小写混合、中文、特殊字符等。 2. 建议不使用双引号即"包围，除非必须包含大写字母或空格等特殊字符。 3. 长度不能超过63个字符。 4. 不建议以pg开头或者pgxc（避免与系统表/视图混淆），不建议以数字开头。 5. 禁止使用SQL 关键字例如 type、order等。 6. 临时或备份的表、视图，建议加上日期时间, 如xxx20240112。 索引命名规则：普通索引命名：表名列名idx；唯一索引命名：表名列名uidx。

本页介绍天翼云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数据库中表膨胀问题和应对建议。 由于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 长名称