本页介绍天翼云TeleDB数据库节点规格变更。 随着业务的不断增加，实例的CPU和内存资源可能会成为实例性能的瓶颈，无法满足业务要求时，TeleDB提供了规格变更功能来提升实例的CPU和内存。 操作步骤 1. 登录TeleDBDCP数据库管理平台。 2. 在左侧导航树中，选择实例管理 > 实例列表 ，右侧页面可查看实例列表。 3. 在实例列表页面，单击目标实例的更多 > 规格变更 ，弹出节点规格变更 对话框。 4. 在节点规格变更 对话框，选择节点类型 ，设置节点目标规格 或勾选自定义 ，可自定义节点规格。 说明 自定义规格要大于节点原规格。 5. 单击确定 完成节点规格变更。

本页介绍天翼云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节点，建议尝试优化为带分布键查询。

本页介绍天翼云TeleDB数据库删除实例。 操作场景 TeleDB支持手动退订实例、销毁实例来删除已创建的实例，暂停进程，清空数据。 约束与限制 需先停止实例才可以注销实例。 操作步骤 1. 登录TeleDBDCP控制台，在左侧导航树选择实例管理 > 实例列表 ，进入实例列表页面。 2. 退订实例 说明 退订成功的实例会进入实例回收站，可在实例回收站 恢复或销毁实例。 1. 在实例列表页面，单击目标实例所在行的更多 > 退订 ，出现退订确认 对话框。 2. 在退订确认 对话框，单击确定 。 3. 您可在左侧导航树实例管理 > 工单管理 页面目标实例所在行的查看流程中查看退订情况。

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

本文为您介绍实例主机手动创建了teledbx用户导致开通实例失败的问题原因和解决方案。 问题现象 创建实例开通失败。 原因分析 经过查看错误日志，发现其手动创建teledbx用户。由于在开通创建实例时，系统会自动创建teledbx用户，无需手动创建。 解决方案 1. 执行如下命令删除实例主机teledbx用户。 plaintext userdel teledbx 2. 在管控台中选择实例管理> 工单管理 ，单击所创建实例行所在的操作列的重新施工即可。

本文为您介绍创建的目录、文件权限不足的问题现象、问题原因和解决方案。 问题现象 手动执行如下命令，出现如下报错日志。 sshp 22 oConnectTimeout10oStrictHostKeyCheckingnoteledb@10.218.14.144sudoyumyinstalldos2unixexpectreadlinecreatereponettoolslsofuuid 经过排查发现目录文件权限不对，用户组不具备读写操作权限。 原因分析 执行umask命令，发现其设置的值与实际不相符，查找出位0027，实际上位022才对，导致用户创建的文件或者目录用户组权限不对。 解决方案 方式一： 1. 执行如下命令，给解压出的安装包赋予读写执行权限。 plaintext cd/app sudo chmod R 755 teledbxv2.8.6centos.x8664 sudo chown R teledb:teledb teledbxv2.8.6centos.x8664 sshp 22 oConnectTimeout10oStrictHostKeyCheckingnoteledb@10.218.14.144sudoyumy installdos2unixexpectreadlinecreatereponettoolslsofuuid 2. 重新install，当出现如下回显信息表示安装成功。 方式二： 您可以修改umask的值，您可执行chmod命令授权也可参考如下方式修改umask的值。 plaintext 1、临时修改umask的值 umask022 2、永久修改umask的值 vim/etc/profile if[ $UID gt199] &&["/usr/bin/idgn""/usr/bin/idun"];thenumask022 else umask022 fi vim/etc/bashrc if [ $UID gt199] &&["/usr/bin/idgn""/usr/bin/idun"];thenumask002 else umask022 fi source/etc/profile sourcevim/etc/bashrc 检查 umask

本文为您介绍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

本页介绍天翼云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数据库应急方案的目标和组织。 目标 服务连续性： 通过人员、资源等的及时调配和安排，确保TeleDB服务的连续性和服务质量。 降低风险： 应急方案必须采取各种措施，尽快解决发生的问题，将由故障产生的影响降到最低。 减少损失： 对于可能产生的影响，提出技术和管理方面的改进建议，尽量将各种损失减少到最低。 应急保障小组 为保障节点及重大活动顺利开展，应提前成立应急保障小组，随时待命： 1. 项目经理：负责整个项目协调和管理工作。 2. 网络工程师：负责网络巡检和相关问题处理。 3. 数据库工程师：负责TeleDB数据库巡检和相关问题处理。 4. 操作系统工程师：负责操作系统巡检和相关问题处理。 同时安排后端相关专家人员，随时待命，有问题可随时介入。 相关人员A/B角配置 1. 应急小组成员，都需要按AB角色配置，互相补位，当工程师A某种原因无法及时提供服务时，由项目经理，在区域范围内安排合适的备份工程师B进行相关的服务； 2. 如果区域人员无法满足要求，由项目经理向技术支持中心经理申请专家技术支持。 3. 专家参与事件不能按时完成情况，则由项目经理申请更高级别技术支持。 下文是TeleDB服务出现故障时的常见应急处理方案，更多故障处理参数故障处理手册。

本页介绍天翼云TeleDB数据库统计监控相关参数。 logstatementstats (boolean) logparserstats (boolean) logplannerstats (boolean) logexecutorstats (boolean) 对每个查询，向服务器日志里输出相应模块的性能统计。这是一种粗糙的分析工具。类似于Unix 的getrusage()系统功能。logstatementstats报告总的语句统计，而其它的报告针每个模块的统计。logstatementstats不能和其它任何针对每个模块统计的选项一起启用。所有这些选项都是默认禁用的。只有超级用户可以更改这个设置。

本页介绍天翼云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数据库年龄回收类问题。 事务回卷问题 问题描述 当事务未能正常回收持续一段时间，库年龄达到上限后。 报错如下，此时数据库还可以访问，但不允许写入： ERROR: database is not accepting commands to avoid wraparound data loss in database "xxx" HINT: Stop the postmaster and vacuum that database in singleuser mode 可能影响 如果CN主节点年龄回卷，那么这个CN主节点会变成只读状态； 如果某个DN主节点年龄回卷，那么写入到这个DN主节点数据SQL会报错。 解决步骤 1. 执行SQL，检查引起年龄回收问题的库： > SELECT datname, age(datfrozenxid) FROM pgdatabase where age(datfrozenxid)>200000000; 2. 连接年龄回卷的库，执行SQL，检查引起年龄回收问题的表； SELECT pgnamespace.nspname as schemaname,relname, age(relfrozenxid) as xidage, pgsizepretty(pgtablesize(pgclass.oid)) as tablesize FROM pgclass,pgnamespace WHERE pgnamespace.oidpgclass.relnamespace and age(relfrozenxid)>200000000 and relfrozenxid ! 0 order by age(relfrozenxid) desc; 3. 控制台停止该节点； 4. 手动启动节点（指定报错提示中的数据库）进入单用户模式 > postgres single D ./ xxx(database) 5. 手动执行vacuum或vacuum full回收问题表，如遇到报错，需要先解决相应报错； 6. ctrl+d退出单用户模式，控制台启动该节点。 年龄回收冲突问题 问题描述 年龄回收时，报冲突错误，如： ERROR: tuple cannot be frozen now, please try later xid 802439820 cutoff xid 958123080 committs 25144982436271 RecentDataTs 25144852436271 RecentGlobalXmin 1058123080 RecentGlobalDataXmin 1058123080k

问题描述 客户端IP地址不在pghba.conf规则的白名单中，导致报错： FATAL: no pghba.conf entry for host"xx.xx.xx.xx", user "xxx", database "xxx",SSL off 可能影响 客户端无法连接数据库。 解决步骤 1. 评估客户IP是否在预期可访问范围内，如有需要，可在控制台手动添加访问规则，加入该IP地址或地址段，访问策略应为md5。 > 以下是针对具体ip的访问策略规则 > > host all all xx.xx.xx.xx/32 md5 连接池获取连接失败问题 问题描述 客户端连接报错： Failed to get pooled connections 可能影响 SQL执行报错； 解决步骤 此报错为CN节点与DN节点、DN节点之间建立连接失败导致，可能是网络异常或节点异常导致 解决办法： 1. 检查节点间网络是否正常，是否有丢包；如有网络问题，修复网络问题； 2. 检查所有节点状态是否正常，修复状态异常的节点； 3. 检查所有节点是否有连接数据打满的情况，清理会话或调大最大连接数maxconnections； 4. 清理空闲会话、清理长时间执行未结束的SQL语句。 是否有core产生，如有，连接运维工程师分析处理。 连接证书获取失败问题 问题描述 客户端连接报错： root certificate file "/xxx/xxx/.postgresql/root.crt" does not exist 可能影响 无法连接数据库； 解决步骤 此报错开启ssl认证，但证书文件不存在； 解决办法： 上传证书到报错提示的指定目录；并确认数据库用户有访问权限； 连接证书无效问题 问题描述 客户端连接报错： FATAL: connection requires a validclient certificate

节点启动超时问题 问题描述 控制台页面上显示节点为停止/异常状态，手动或自动启动失败。 为避免因系统卡顿、节点异常等原因，导致节点长时间处理启动等待状态问题，系统新增了全局参数NODEMAXSTARTWAITTIMES控制节点启动超时时间，默认为60秒。当节点重启、重做备机、添加备节点等操作时，如果启动时需要应用的WAL日志较多，启动时间可能会超过60秒，此时节点会收到Center Master下发的停止命令，节点启动60秒后日志会打印 received fast shutdown request，节点启动失败。 可能影响 DN主节点启动失败，会导致访问到该DN的节点SQL报错，实例部分不可用； CN主节点启动失败，会导致流入该节点的SQL语句报错，流入其它CN主节点的DDL语句报错； CN/DN备节点失败失败，如果开启同步复制，同步复制节点数量不足且未启用退化策略时，会导致DDL、DML语句卡住； CN/DN备节点失败失败，可能会导致无可用备节点，主节点再次异常会导致实例不可用，有数据丢失风险。 解决步骤 1. 控制台页面进入“系统信息”“基本信息”页面，切换至“参数配置”TAB页，查找并修改参数NODEMAXSTARTWAITTIMES； 2. 重新发起节点启动任务，或等待节点自动拉起。 pghba.conf文件内容错误导致启动失败问题 问题描述 节点启动失败，日志显示报错could not load pghba.conf，如： CST,"YB171020",,,17102,coord(0,0),,65a34d68.42ce,coord(0,0),3,,20240114 10:56:40 CST,,0,FATAL,XX000,"could not load pghba.conf",,,,,,,,,,"" 20240114 10:56:43.566 CST,"YB171020",,,17102,coord(0,0),,65a34d68.42ce,coord(0,0),4,,20240114 10:56:40 CST,,0,LOG,00000,"database system is shut down",,,,,,,,,,"" 而前一行会提示错误位置和错误原因，如： LOG,F0000,"invalid IP mask ""md5"": 未知的名称或服务",,,,,"line 24 of configuration file ""/data/xxx/....../pghba.conf""",,,,,"" 或 LOG,F0000,"invalid connection type""host1""",,,,,"line 11 of configuration file""/data/xxx/......./pghba.conf""",,,,"" 这里第一个错误显示第24行ip地址后的mask格式错误；第二个错误显示第11行连接类型host1错误，枚举类型中不包含host1。

问题描述 节点启动时，报错信号量不足，报错信息示例如下： 20240112 16:35:10 CST 39520FATAL: could not create semaphores: No space left on device 20240112 16:35:10 CST 39520DETAIL: Failed system call was semget(1978133, 17, 03600). 20240112 16:35:10 CST 39520HINT: This error does not mean that you have run out of disk space. It occurs when either the system limit forthe maximum number of semaphore sets (SEMMNI), or the system wide maximumnumber of semaphores (SEMMNS), would be exceeded. You need to raise the respective kernelparameter. Alternatively, reducePostgreSQL's consumption of semaphores by reducing its maxconnectionsparameter. 可能影响 节点启动失败 解决步骤 1. 查看当前信号量资源 > sysctl a grep sem > 或 > cat /etc/sysctl.confgrep sem > 默认推荐设置为： > kernel.sem 50100 64128000 50100 1280 > 其中第2个数字为最大信号量 2. 节点的连接数是否符合预期，maxconnections是否设置过大，可适当调小调小maxconnections。需要在控制台页面上修改参数，重启节点生效。 3. 调大可用信号量 > 调整方法： > 修改配置文件 > vi /etc/sysctl.conf > 修改kernel.sem值，主要调大其中第2个数字。 > 配置参数生效 > sysctl p

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

本页介绍天翼云TeleDB数据库参数说明。 allowsequencedisorder (enum) 如果打开则从GTM得到的值将会无序，这取决于请求速度，可以减轻GTM的压力。有效值：on、off、true、false、yes、no、1、0，或这些值的无歧义前缀，大小写不敏感，默认on。范围 ：GLOBAL。参数类型 ：布尔。是否动态生效：是。 basebackuplimit (integer) basebackup操作限流，单位MB，范围1～10240。默认为50。 dblinktypes (enum) 使用dblink访问Oracle、PostgreSQL、TeleDB数据库的方式。有效值： oraclex86、oraclearm、postgresql或teledbxpg，默认oraclex86。范围： Oracle兼容。类型 ：枚举。参数值： oraclex86、oraclearm、postgresql、teledbxpg。是否动态生效 ：是。 debughandleresponse (boolean) 允许在报错时打印错误节点、PID等信息到用户终端。有效值：on、off、true、false、yes、no、1、0，或这些值的无歧义前缀，大小写不敏感，默认为off，即只打印在日志里。 defaultwithrowid (enum) Oracle兼容模式下，是否默认使用rowid创建新表。有效值：on、off、true、false、yes、no、1、0，或这些值的无歧义前缀，大小写不敏感，默认off。范围 ：Oracle兼容。是否动态生效：是。 enableaudit (boolean) 允许对数据库对象上的用户操作进行审计操作。有效值：on、off、true、false、yes、no、1、0，或这些值的无歧义前缀，大小写不敏感，默认是off。参数类型：布尔。是否动态生效 ：是。 enableconcurrentlyindex (enum) 开启或禁用在对表insert、update或delete时并行创建索引。有效值：on、off、true、false、yes、no、1、0，或这些值的无歧义前缀，大小写不敏感，默认on。范围 ：GLOBAL。参数类型：布尔。是否动态生效：是。

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

waldebug (boolean) 如果被打开，WAL相关的调试输出将被发出。只有在编译时定义了WALDEBUG宏的情况下，这个参数才可用。 zerodamagedpages (boolean) 检测到一个损坏的页面头部通常会导致数据库报告一个错误，并且中止当前事务。把zerodamagedpages设置为打开会让系统报告一个警告、把损坏的页面填充零，然后继续处理。这种行为会毁掉数据，即被损坏页面上的所有行。但是它允许你绕开错误并且从可能存在表中的任何未损坏页面中检索行。如果由于一次硬件或软件错误而发生毁坏，这种方法可用于恢复数据。通常你不应该把它设置为打开，除非你已经彻底放弃从表的损坏页面中恢复数据。被填充零的页面不会被强制到磁盘上，因此我们推荐在再次关闭这个参数之前先重建表或索引。默认的设置是off，并且只有超级用户可以改变它。

在执行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数据库预置选项相关参数。 下列“参数”是只读的，它们是在编译或安装TeleDB时决定的。同样，它们被排除在postgresql.conf文件例子之外。 blocksize (integer) 磁盘块的大小。它由编译服务器时BLCKSZ的值确定。默认值是 8192 字节。有些配置变量的含义（例如sharedbuffers）会被blocksize影响。 datachecksums (boolean) 是否启用了数据校验码。 debugassertions (boolean) 是否启用断言编译TeleDB。 例如configure时加选项 enablecassert， 如果是这样的话，定义宏USEASSERTCHECKING。 默认情况下编译没有断言。 integerdatetimes (boolean) 是否在编译时打开了64 位整数日期和时间。该值总是on。 lccollate (string) 文本数据排序使用的区域。该值是在数据库被创建时确定的。 lcctype (string) 决定字符分类的区域。该值是在数据库被创建时决定的。通常它和lccollate一样，但是可以为特殊应用设置成不同的值。 maxfunctionargs (integer) 函数参数的最大数量。它由编译服务器时的FUNCMAXARGS值决定的。默认值是 100 个参数。 maxidentifierlength (integer) 标识符的最大长度。它由编译服务器时的NAMEDATALEN值减一决定。NAMEDATALEN的默认值是 64 ；因此maxidentifierlength的默认值是 63，但是在使用多字节编码时可以少于 63 个字符。 maxindexkeys (integer) 索引键的最大数目。它由编译服务器时的INDEXMAXKEYS值决定。默认值是 32个键。 segmentsize (integer) 一个文件段中可以存储的块（页）的数量。由编译服务器时的RELSEGSIZE值决定。一个段文件的最大尺寸（以字节计）等于segmentsize乘以blocksize，默认是 1GB。

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