本文为您介绍如何管理表达式索引。 plaintext teledb create table tupper(id int,mc text); CREATE TABLE teledb create index tuppermc on tupper(mc); CREATE INDEX teledb insert into tupper select t,md5(t::text) from generateseries(1,10000) as t; INSERT 0 10000 teledb analyze tupper; ANALYZE teledb explain select from tupper where upper(mc)md5('1'); QUERY PLAN Remote Fast Query Execution (cost0.00..0.00 rows0 width0) Node/s: dn01, dn02 > Seq Scan on tupper (cost0.00..133.58 rows25 width37) Filter: (upper(mc) 'c4ca4238a0b923820dcc509a6f75849b'::text) (4 rows) teledb create index tuppermc on tupper(upper(mc)); ERROR: relation "tuppermc" already exists teledb create index tuppermc1 on tupper(upper(mc)); CREATE INDEX teledb explain select from tupper where upper(mc)md5('1'); QUERY PLAN Remote Fast Query Execution (cost0.00..0.00 rows0 width0) Node/s: dn01, dn02 > Bitmap Heap Scan on tupper (cost4.48..50.94 rows25 width37) Recheck Cond: (upper(mc) 'c4ca4238a0b923820dcc509a6f75849b'::text) > Bitmap Index Scan on tuppermc1 (cost0.00..4.47 rows25 width0) Index Cond: (upper(mc) 'c4ca4238a0b923820dcc509a6f75849b'::text) (6 rows)

本页介绍天翼云TeleDB数据库Oracle语法中的二进制操作函数。 emptyclob 需要加载插件teledbxoraclepackagefunction plaintext create extension teledboraclepackagefunction; 初始化CLOB 字段。 plaintext teledb select emptyclob(); emptyclob (1 row) teledb create table t1 (f1 int,f2 clob); CREATE TABLE teledb insert into t1(f1,f2) values (1,emptyclob()); INSERT 0 1 teledb

本页介绍天翼云TeleDB数据库Oracle语法中的转换函数。 toclob 转换字符为clob类型。 plaintext teledb select toclob('teledb') from dual; toclob teledb (1 row) teledb ROWIDTOCHAR 转换rowid值为varchar2类型。 plaintext teledb d+ trowid Table "public.trowid" Column Type Collation Nullable Default Storage Stats target Descripti on +++++++ f1 integer plain f2 integer plain Has ROWIDs: yes Distribute By: SHARD(f1) Location Nodes: ALL DATANODES teledb SELECT ROWIDTOCHAR(rowid),rowid from trowid; rowidtochar rowid + XPK3fwAQAAAAAAAAA XPK3fwAQAAAAAAAAA (1 row) teledb CHARTOROWID CHARTOROWID(c1) 转换varchar2类型为rowid值，c1，字符串，长度为20的字符串，字符串必须符合rowid 格式。 plaintext teledb select CHARTOROWID('AAAFd1AAFAAAABSACCAA') a1 from dual; a1 AAAFdwFAAAABSACCA (1 row) teledb

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

本文为您介绍如何删除数据库。 plaintext 删除数据库teledbdbnew teledb drop database teledbdbnew; 仍有会话连接数据库时，会报错 ERROR: database "teledbdbnew" is being accessed by other users DETAIL: There is 1 other session using the database. 停止该数据库的所有连接，后重新删除数据库 teledb select pgterminatebackend(pid) from pgstatactivity where datname'teledbdbnew'; pgterminatebackend t (1 row) teledb drop database teledbdbnew; DROP DATABASE

本页介绍天翼云TeleDB数据库PL/pgsql函数的变量。 在一个块中使用的所有变量必须在该块的声明小节中事先进行声明，PL/pgSQL变量可以是任意SQL数据类型，可以是一个简单数据类型、复合类型、RECORD、已经存在的表行类型、表字段类型、游标。

本文为您介绍如何删除数据表。 删除当前模式下的数据表。 plaintext teledb drop table t; DROP TABLE 删除某个模式下数据表。 plaintext teledb d+ t Table "public.t" Column Type Collation Nullable Default Storage Stats target Description +++++++ id integer plain mc text extended Distribute By: SHARD(id) Location Nodes: ALL DATANODES teledb d+ tas Table "public.tas" Column Type Collation Nullable Default Storage Stats target Description +++++++ id integer plain mc text extended Distribute By: SHARD(id) Location Nodes: ALL DATANODES teledb drop table public.test; DROP TABLE 删除数据表，不存在时不执行，不报错。 plaintext teledb drop table IF EXISTS t; NOTICE: table "t" does not exist, skipping DROP TABLE 使用CASCADE无条件删除数据表。 plaintext teledb create view shardview as select from testshard; CREATE VIEW teledb drop table testshard; ERROR: cannot drop table testshard because other objects depend on it DETAIL: view shardview depends on table testshard HINT: Use DROP ... CASCADE to drop the dependent objects too. teledb drop table testshard cascade; NOTICE: drop cascades to view shardview DROP TABLE

本页介绍天翼云TeleDB数据库的命名规范。 DB object：database， schema， table， column， view， index， sequence， function， trigger 等名称。 建议使用小写字母、数字、下划线的组合。 建议不使用双引号即"包围，除非必须包含大写字母或空格等特殊字符。 长度不能超过63个字符。 不建议以pg 开头或者 pgxc（避免与系统 DB object 混淆），不建议以数字开头。 禁止使用SQL 关键字，如 type， order 等。 table 能包含的 column 数目，根据字段类型的不同，数目在250到1600之间。 临时或备份的DB object：table、view 等，建议加上日期， 如 dbaops.b2cproductsummay20140712 (其中 dbaops 为 DBA 专用 schema)。 index命名规则为：普通索引为 表名列名idx，唯一索引为 表名列名uidx，如 studentnameidx，studentiduidx。

本文为您介绍如何创建shard表。 不指定shard key 建表方式 不指定shard key 建表方法，系统默认使用第一个字段作为表的 shard key。 plaintext teledb create table test(id int, name varchar, birth date); CREATE TABLE teledb d+ test Table "public.test" Column Type Collation Nullable Default Storage Stats target Description +++++++ id integer plain name character varying extended birth timestamp(0) without time zone plain Distribute By: SHARD(id) Location Nodes: ALL DATANODES 分布键选择原则： 分布键只能选择一个字段。 如果有主键，则选择主键做分布键。 如果主键是复合字段组合，则选择字段值选择性多的字段做分布键。 也可以把复合字段拼接成一个新的字段来做分布键。 没有主键的可以使用UUID 来做分布键。 总之一定要让数据尽可能的分布得足够散。 指定shard key 建表方式 plaintext teledb create table testshard(id serial not null, name text) distribute by shard(name) to group defaultgroup; CREATE TABLE teledb d+ testshard Table "public.testshard" Column Type Collation Nullable Default Storage Stats target Description +++++++ id integer not null nextval('testshardidseq'::regclass) plain name text extended Distribute By: SHARD(name) Location Nodes: ALL DATANODES distribute by shard(x) 用于指定分布键，数据分布于那个节点就是根据这个字段值来计算分片。 to group xxx 用于指定存储组（每个存储组可以有多个节点）。 分布键字段值不能修改，字段长度不能修改，字段类型不能修改

本文为您介绍使用SELECT语法查询记录所在的DN。 plaintext teledb select xcnodeid, from teledbpg1; xcnodeid id nickname ++ 1085152094 5 test 1085152094 6 teledb, teledb1 506537247 3 pg (3 rows) teledb select t1.xcnodeid, pgxcnode.nodename, t1. from teledbpg1 t1, pgxcnode where t1.xcnodeid pgxcnode.nodeid; xcnodeid nodename id nickname +++ 1085152094 dn01 5 test 1085152094 dn01 6 teledb, teledb1 506537247 dn02 3 pg (3 rows)

本文介绍如何在使用SELECT语法时进行聚集查询，例如统计记录数、不重复值的记录表，以及求和等。 统计记录数。 plaintext teledb select count(1) from teledbpg; count 5 (1 row) 统计不重复值的记录表。 plaintext teledb select count(distinct id) from teledbpg; count 4 (1 row) 求和。 plaintext teledb select sum(id) from teledbpg; sum 11 (1 row) 求最大值。 plaintext teledb select max(id) from teledbpg; max 4 (1 row) 求最小值。 plaintext teledb select min(id) from teledbpg; min 1 (1 row) 求平均值。 plaintext teledb select avg(id) from teledbpg; avg 2.2000000000000000 (1 row)

本文介绍如何在使用SELECT语法时添加any条件。 只需要大于其中一个值即为真。 plaintext teledb select from teledbpg where id > any (select 1 union select 3); id nickname + 3 pg 4 2 TELEDB (3 rows)

本文介绍如何在使用SELECT语法时，返回两个结果的差集。 plaintext teledb select from teledbpg except select from teledbpg1; id nickname + 2 TELEDB 4 1 teledb 1 hello,pgxc (4 rows)

本文为您介绍合并多个查询结果的方法。 不过滤重复的记录。 plaintext teledb create table teledbpg1(id int, nickname varchar); CREATE TABLE teledb insert into teledbpg1 values(3, 'pg'),(5,'test'); COPY 2 teledb select from teledbpg union all select from teledbpg1; id nickname + 1 teledb 1 hello,pgxc 2 TELEDB 3 pg 4 5 test 3 pg (7 rows) 过滤重复的记录。 plaintext teledb select from teledbpg union select from teledbpg1; id nickname + 1 teledb 1 hello,pgxc 4 5 test 2 TELEDB 3 pg (6 rows) 每个子查询分布在合并结果中的使用。 plaintext teledb select from (select from teledbpg limit 2) as t union all select from (select from teledbpg1 limit 2) teledb ; id nickname + 1 teledb 1 hello,pgxc 5 test 3 pg (4 rows)

本文为您介绍创建数据库的相关操作。 要创建一个数据库，必须是一个超级用户或者具有特殊的CREATEDB特权，默认情况下，新数据库将通过克隆标准系统数据库template1被创建。可以通过写TEMPLATE name指定一个不同的模板。特别地，通过写TEMPLATE template0您可以创建一个干净的数据库，它将只包含的Teledb所预定义的标准对象。 默认参数创建数据库 plaintext teledb create database teledbdb; CREATE DATABASE 指定克隆库 plaintext teledb create database teledbdbtemplate TEMPLATE template0; CREATE DATABASE 指定所有者 plaintext teledb create role teledbuser with login; CREATE ROLE teledb create database teledbdbowner owner teledbuser; CREATE DATABASE teledb l+ teledbdbowner List of databases Name Owner Encoding Collate Ctype Access privileges Size Tablespace Description ++++++++ teledbdbowner teledbuser UTF8 zhCN.UTF8 zhCN.UTF8 19 MB pgdefault (1 row) 指定编码 plaintext teledb create database teledbdbencoding ENCODING UTF8; CREATE DATABASE teledb l+ teledbdbencoding List of databases Name Owner Encoding Collate Ctype Access privileges Size Tablespace Description ++++++++ teledbdbencoding teledb UTF8 zhCN.UTF8 zhCN.UTF8 19 MB pgdefault (1 row) 创建gbk编码 plaintext teledb CREATE DATABASE dbgbk template template0 encoding gbk LCCOLLATE 'zhCN.gbk' LCCTYPE 'zhCN.gbk'; CREATE DATABASE teledb

本文为您介绍如何通过SELECT语法访问函数。 plaintext teledb select md5(random()::text); md5 ed5b356234979a63efc6c4f6537c4853 (1 row)

本文为您介绍如何删除索引。 plaintext teledb drop index tmulidxidx; DROP INDEX

本文为您介绍如何使用查询结果创建数据表。 plaintext teledb insert into t values(1,'teledb'); INSERT 0 1 teledb create table tas as select from t; INSERT 0 1 teledb select from tas; id mc + 1 teledb (1 row)

Of Partitions: 12 Start With: 20170901 Interval Of Partition: 1 MONTH 说明 partion by range(xx) 代表范围分区， 支持timesamp,int类型，数据分布于那个子表就是根据这个字段值来计算分区。 begin(xx) 表示开始分区的初始值 partition(xx) 代表初始分区数量 step (xx) 代表分区步长

您可以参考本文，配置用户访问模式权限。 普通用户对于某个模式下的对象访问除了访问对象要授权外，模式也需要授权。 plaintext [teledb@localhost bin]$ ./telesql p 11111 U teledb d teledb Password for user teledb: telesql (TeleDB V6) Type "help" for help. 创建shema teledb create schema test; CREATE SCHEMA 创建表 teledb create table test.t1(id int); CREATE TABLE 创建用户user1 teledb create role user1 with login password 'User@184'; CREATE ROLE 授权表访问权限给用户user1 teledb grant select on test.t1 to user1; GRANT 切换到普通用户user1，尝试访问test.t1表，由于没有授权test模式，仍然无法访问 plaintext teledb c user1 Password for user user1: You are now connected to database "teledb" as user "user1". teledb> select from test.t1; ERROR: permission denied for schema test LINE 1: select from test.t1; ^ 切换到teledb用户，将test模式的访问权限授权给user1，重新用user1访问t1表 plaintext teledb> c teledb Password for user teledb: You are now connected to database "teledb" as user "teledb". 授权schema teledb grant usage on schema test to user1; GRANT teledb c user1 Password for user user1: You are now connected to database "teledb" as user "user1". teledb> select from test.t1; id (0 rows)

本页介绍天翼云TeleDB数据库中表结构变更的影响和表现。 表结构变更时，可能会有数据重写的情况，如果表较大，会有长时间锁表问题，需要梳理各种表结构变更场景下的表现： 注意 前提：表结构变更属于DDL语句，需要独占锁，要求表上没有会话访问。在操作前建议设置锁超时时间，避免因表上有会话存在，DDL语句被阻塞，导致DDL语句阻塞更多的DML、DQL语句。 新增列，秒级，与数据量无关。 新增列+设置默认值，秒级，与数据量无关。 删除列，秒级，与数据量无关。 修改列默认值，秒级，与数据量无关。 修改列类型，时间与数据量有关，需要重写数据。 修改列长度，时间与数据量有关，以及扩展方式有关。 由长变短，例如varchar(64)更改为varchar(32)，时间与数据量有关，需要重写数据，可能会报错。 由短变长，例如varchar(32)更改为varchar(64)，秒级，与数据量无关。

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

本页介绍天翼云TeleDB数据库批量数据导入或导出的最佳实践。 推荐使用copy命令导出导入文本文件，文件分割建议采用csv格式。 推荐使用telesql工具导出导入表结构和SQL语句。 批量数据导入 如果是单表数据导入，推荐使用copy 命令，例如： copy 表名 from '/data/.../表名.txt'; 如果是SQL 文件导入，推荐使用 psql –f 文件.sql 导入，例如： telesql h ip p 端口 U 用户 d 数据库 f /data/xxx/导入文件.sql 批量数据导出 如果是单表数据导出，推荐使用copy 命令，例如： copy 表名 to '/data/.../表名.txt'; 如果是要导出表结构、或者多个表、或者整库，则推荐使用pgdump 工具，例如： 导出全库ddl 和数据 pgdump h ip p 端口 U 用户 d 数据库 >/data/.../导出文件.sql 导出某个表的ddl 和数据 pgdump h ip p 端口 U 用户 d 数据库 t 表 >/data/.../导出文件.sql 导出某个表结构 pgdump h ip p 端口 U 用户 d 数据库 t 表 s >/data/.../导出文件.sql 导出某个表数据 pgdump h ip p 端口 U 用户 d 数据库 t 表 a >/data/.../导出文件.sql

本页介绍天翼云TeleDB数据库的分区表设计规范。 1. 对于数据量巨大的表，考虑使用分区表，通常建议当单DN数据量超过32G时，使用分区表。 2. 控制分区表数量，不建议有过多的分区，会影响性能，尤其高频SQL，没有用到分区剪枝的场景；建议分区保持在100以内。 3. 分区表层级不要超过2层。 4. 分区表访问时，应带分区键条件，且分区字段条件值与字段类型匹配，没有发生隐式类型转换。

本文为您介绍在线创建索引避免阻塞DML语句的具体操作。 1. 新建索引 推荐使用加关键字concurrently的方式在线创建索引，此方式不阻塞DML、DQL语，不影响表的增、删、改、查操作。 例如，在teledb1表的id字段上创建索引语句如下： teledb create index concurrently teledb1ididx on teledb1(id); 2. 重建索引 TeleDB支持在相同字段上创建多个索引，重建索引推荐使用替换的方式，过程如下： 1. 使用concurrently方式在线创建新的索引。 2. 删除原索引（记得设置locktimeout）。 3. analyze表更新统计信息。 3. 更改主键 更改主键，推荐使用替换的方式，过程如下： 1. 在线创建新的包含主键列的唯一索引。 2. 执行以下SQL替换主键： ALTER TABLE teledb1 DROP CONSTRAINT teledb1pkey, ADD CONSTRAINT teledb1newpkey PRIMARY KEY USING INDEX teledb1iduidx; 3. analyze表更新统计信息。

本页为您介绍如何注册加密算法。 plaintext SELECT MLSTRANSPARENTCRYPTCREATEALGORITHM(algoname, password); 参数描述： algoname采用的加密算法，其中加密算法支持 AES128：采用AES算法加密口令长度128。 AES192：采用AES算法加密口令长度192。 AES256：采用AES算法加密口令长度256。 SM4：采用国密SM4算法加密 password:密钥口令 SM4，密钥口令长度必须为16。 AES128，AES192，AES256，密钥口令长度不可超过64。 返回值：算法ID

本页为您介绍如何修改定时任务的ip和端口。 modifyhostport(jobno bigint,hostname text,port int)：第一个参数是定时任务的jodid；第二个参数是任务的ip；第三个参数是任务的端口。 plaintext select dbmsjob.modifyhostport(20002, 'localhost', 20001); 修改jobid为20002的定时任务连接的ip和端口 期望结果，查询dbmsjob.job表发现jobid为20002的定时任务的nodename字段为'localhost'

本页介绍天翼云TeleDB数据库查询带分布键条件的最佳实践。 通过explain查看执行计划，查看SQL语句是否使用到分布键，DN下发DN情况可通过Node/s: 关键字来查看。 如果使用到了分布键，那么SQL只会下发到分布键对应的某个DN节点；如果没有用到分布键，那么SQL会下发到所有DN节点；没有带分布键的SQL，因为下发到了所有DN节点，消耗了更多的连接资源、计算资源，应尽量避免。 某个表的SQL语句可能有不同的where条件，在SQL优化时，应尽量确保高频并发的SQL语句是带了分布键条件。 例如，teledb1表的分布键f2，下面的SQL where条件为f11，没有带分布键条件，那么SQL将下发到所有DN节点执行。 teledb explain select from teledb1 where f11; 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 teledb1 (cost0.00..6827.10 rows1 width14) Filter: (f1 1) (6 rows) 下面的SQL，where条件为f21，带了分布键条件，SQL只下发到了f21所在的DN节点dn001。 teledb explain select from teledb1 where f21; QUERY PLAN Remote Fast Query Execution (cost0.00..0.00 rows0 width0) Node/s: dn001 > Gather (cost1000.00..7827.20 rows1 width14) Workers Planned: 2 > Parallel Seq Scan on teledb1 (cost0.00..6827.10 rows1 width14) Filter: (f2 1) (6 rows)

本页介绍天翼云TeleDB数据库的表填充因子设计规范。 对于更新（update/delete）频繁的表，要设置合适的填充因子，通常建议50～70%（默认100%），预留一部分页空间用于数据更新，这样可以减少或避免因部分字段更新而导致的索引更新问题（索引字段没有更新，但如果没有预留页空间，索引仍需要更新），而且并发性能更好。 可以设置表的填充因子，例如： alter table teledb1 set (fillfactor70); ALTER方式设置的填充因子，对于存量数据不会重新调整填充率，新写入的数据会按填充因子预留页空间；可以通过数据导出导入的方式更新存量数据填充率。 也可以在创建表时，指定填充因子，例如： create table teledb1(id int) with (fillfactor70);

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

本页介绍透明加密功能的使用示例。 plaintext 创建插件 CREATE EXTENSION teledbxmls; 切换为安全管理员用户 c mlsadmin 注册内置的加密算法和对应密钥 使用国测sm4加密算法进行注册，获得对应的算法ID select MLSTRANSPARENTCRYPTCREATEALGORITHM('SM4','0123456789012345'); Select MLSTRANSPARENTCRYPTCREATEALGORITHM('AES128','0123456789012345'); c root create table t1(id int,content int); c mlsadmin 将加密算法绑定到表上,其中1是上面创建的算法ID select MLSTRANSPARENTCRYPTALGORITHMBINDTABLE('public','t1',1); insert into t1 values(1,0), (2,0), (3,0); insert into t1 values(7, 0), (8,0), (9,0);

本页为您介绍如何修改定时任务的间隔时间。 "interval"(jobno bigint,"interval" text)：第一个参数是定时任务的jodid；第二个参数是任务的时间间隔。 plaintext select dbmsjob.interval(20002, '13 '); 每个小时的第13分钟执行作业 期望结果，查询dbmsjob.job表发现jobid为20002的定时任务的schedule字段为'13 '