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

本页简要介绍分布式数据库V5.1.0的版本更新说明。 V5.1.0版本说明 组件名称 版本号 发布时间 TeleDBXCore 5.1 2023年08 月 说明 该版本适配的DCP版本为3.6.1S。 新增和优化功能： 1. 新增日志管理模块。 管控侧：新增错误日志管理、慢日志管理、高频SQL管理和审计日志管理。 内核侧：不涉及。 2. 支持创建定时任务JOB。 管控侧：不涉及。 内核侧：支持通过DBMSJOB创建定时任务。 3. 支持逻辑备份恢复，包括多介质备份和恢复到不同实例。 管控侧：新增介质支持，新增恢复到不同实例功能。 内核侧：不涉及。 4. 支持闪回查询和闪回恢复。 管控侧：不涉及。 内核侧：支持一定时间内旧版本表数据的查询和支持表的恢复，应对误删表的场景。 5. 管控侧对接DCP模块，包括微服务接入和统一鉴权。通过微服务接入，用户管理、VIP管理、实例开通、扩容、注销等功能依赖的底层资源管理均交由DCP分配，控制台保留其实例管理功能和一系列高可用能力，作为DCP微服务体系一部分保障用户实例正常运行。 6. 监控告警信息由管控接入到DCP，包括支持GTM监控能力、指标监控对接DCP和事件告警。 7. 管控侧支持OpenAPI能力。 8. 管控侧对接DCP Cgroup资源隔离能力。 9. 管控侧支持开启索引优化建议定时任务，并查看慢SQL日志列表中对于SQL优化的建议。 10. 支持实例管理，包括实例开通时提供多个不同的blocksize编译包、实例开通时支持配置SSL协议和initdb的时候去设置是否要开启checksum校验。 11. 新增Analyze信息CN同步模块，包括数据计算模块、数据转换模块和数据加载模块。 12. 支持XML类型、支持包Package的修改语法。 13. 内核侧支持通过虚拟索引构建和索引建议分析提升数据库性能。 14. 支持按照如下分布方式：HASH(column) ，MODULO(column) ，ROUNDROBIN，shard，replication 设置数据分布。 15. 物化视图定期刷新数据。 16. 支持拓展MySQL和Oracle外表。 17. 支持madlib适配，扩展机器学习能力。 18. 支持全密态功能。 内核测：支持全密文，包括密文检索和计算。实现数据离开客户端时，在用户侧对数据进行加密，数据以加密形态存储在数据库服务器中，且不影响服务端的检索与计算，当数据返回至客户端时，可自动对数据进行解密，用户对加解密过程无感知。 管控侧：不涉及。 修复漏洞 无。 修复缺陷 1. 将oracle语法兼容的concat和concatws函数从stable改成immutable。 2. 安全用户提示需要修改为mls。 3. 编译配置增加withgmssl选项。 4. 超级用户无法触发慢查询SQL。 5. 创建物化视图使用using method。 6. 大量DROP、TRUNCATE操作从库回放慢导致的CPU飙升。 7. 单独编译插件teledbxoraclepackagefunction报错。 8. 当协调者分析表时，sample的时候采用目标行数需要除以n节点数。 9. 分区表创建include关键字索引报错。 10. 减小backend进程内存使用。 11. 将系统函数updateanalyzecn改成了pgupdateanalyzecn函数。 12. 解决会话处于pgxcnodereceive时无法响应cancel request的问题。 13. 解决arm环境旧版本gmssl在teledb的编译问题。 14. 解决gmssl在x86机器上编译问题。 15. 连续空字符串扩展查询commandTag为NULL coredump修复。 16. 慢SQL查询内核获取的SQL语句为空。 17. 启用“pgqualstats”插件时，在从分区表删除数据时会导致coredump。 18. 删除冗余的XLOGBTREESPLITLROOT和XLOGBTREESPLITRROOT两种xlog类型。 19. 删除EMA代码。 20. 实现alter package语法。 21. 视图增加无效优化SQL 记录。 22. 缩小使用的缓存内存，移除SMgrRelationData 中的 smgrshardtargblocks。 23. 索引支持include关键字特性。 24. 添加telesql，Makefile中添加telesql软连接(install/clean)。 25. 增加自动化DDS死锁检测算法。 26. 增加analyze同步功能。 27. 修改telesql引发make报warning的问题。 28. 修改源码以支持make world和make installworld通过。 29. 修复plpgsql 变量名定义逻辑。 30. 修复pgvisibility回归测例。 31. 修复pgunlock插件存在的编译警告。 32. 修复pgstatstatements插件bugs，创建报错。 33. 修复pgsqueeze如果没有加入sharedpreloadlibarairies参数，执行返回。 34. 修复pgdirtyread插件的Makefile文件以及make check测例。 35. 修复filefdw插件产生coredump问题。 36. 修复auditadmin只能在pghba.conf中设置trust才能使用。 37. 修复在pgxcctl.conf中关于pghba.conf采用scramsha256产生coredump。

本文为您介绍在线创建索引避免阻塞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'

本页介绍透明加密功能的使用示例。 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 '

本页为您介绍如何修改定时任务首次调度时间。 modifynextdate(jobno bigint, nextdate timestamptz)：第一个参数是定时任务的jodid；第二个参数是任务的调度时间。只有在这个时间之后，定时任务才有可能被调度。 plaintext select dbmsjob.modifynextdate(20002,'20241107 15:00:00'); 修改定时任务的调度时间，在这个时间之前不会调度定时任务。 期望结果：查询dbmsjob.job表中的jobid为20002的定时任务的nextdate字段为20241107 15:00:00

本页介绍透明数据加密的实现原理和使用方法。 透明数据加密（Transparent Data Encryption）通过在磁盘上存储的数据进行加密和解密来实现数据的保护。 透明：当使用者在打开或编辑指定文件时，系统将自动对未加密的文件进行加密，对已加密的文件自动解密。文件在硬盘上是密文，在内存中是明文。一旦离开使用环境，由于应用程序无法得到自动解密的服务而无法打开，从而起到保护文件内容的效果。 加密：透明加密使用加密算法来加密数据，并将密钥存储在数据库服务器的受信任位置，以确保安全性。 用户可以通过函数创建加密算法，之后可以通过函数将创建的算法绑定到schema，表和列上，实现加密算法和数据库对象建立关联。同时支持将已经绑定的算法从schema，表和列上解绑，从而取消加密算法和数据库对象之间的关联关系。 透明加密通过teledbxmls插件，需要创建插件： plaintext 创建插件 create extension teledbxmls;

本页介绍全密态的使用示例。 plaintext 创建CMK主秘钥 CREATE CLIENT MASTER KEY cmk12 WITH ( KEYSTORE localkms, KEYPATH "localkms1" , ALGORITHM SM2); CREATE CLIENT MASTER KEY cmk2 WITH ( KEYSTORE localkms, KEYPATH "localkms1" , ALGORITHM SM2); 创建CEK数据秘钥 CREATE COLUMN ENCRYPTION KEY cek1 WITH VALUES ( CLIENTMASTERKEY cmk1, ALGORITHM SM4SM3); CREATE COLUMN ENCRYPTION KEY cek2 WITH VALUES ( CLIENTMASTERKEY cmk2, ALGORITHM SM4SM3); DROP CLIENT MASTER KEY cmk1 CASCADE; 创建加密表，col1未加密，col2使用cek1加密，col3和col4使用cek2加密 CREATE TABLE IF NOT EXISTS tbl1 ( col1 INT, col2 INT ENCRYPTED WITH ( COLUMNSENCRYPTIONKEY cek1, ENCRYPTIONTYPE DETERMINISTIC), col3 TEXT ENCRYPTED WITH ( COLUMNSENCRYPTIONKEY cek2, ENCRYPTIONTYPE DETERMINISTIC), col4 VARCHAR(20) ENCRYPTED WITH ( COLUMNSENCRYPTIONKEY cek2, ENCRYPTIONTYPE DETERMINISTIC) );

本页为您介绍如何禁用或启用定时任务。 broken(jobno bigint,broken bool)：第一个参数是定时任务的jodid；第二个参数是启用、禁用定时任务，true表示启用，false表示禁用。具体表现在job表的active字段。active为false表示禁用。 plaintext select dbmsjob.broken(20002,false); 禁用jobid为20002的定时任务 select dbmsjob.broken(20002, true); 启用jobid为20002的定时任务 期望结果，查询dbmsjob.job表中的jobid为20002的定时任务的active字段为falsetrue 启用定时任务 run(jobno bigint)：第一个参数是定时任务的jodid；具体表现在job表的active字段。 plaintext select dbmsjob.run(25002); 启用jobid为25002的定时任务。

创建客户端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位。

本页为您介绍如何删除定时任务。 unschedule(jobno bigint)：第一个参数是定时任务的jodid。 plaintext select dbmsjob.unschedule(20002); 删除jobid为20002的定时任务 期望结果，查询dbmsjob.job表发现jobid为20002的定时任务不存在

本页为您介绍如何查询定时任务以及执行记录。 plaintext select from dbmsjob.job; 查询定时任务 select from dbmsjob.joblog; 查询定时任务的执行记录

将创建的算法绑定到schema，表和列上，实现加密算法和数据库对象建立关联。 加密算法绑定到Schema 将创建的算法绑定到schema，实现加密算法和数据库对象建立关联。 plaintext SELECT MLSTRANSPARENTCRYPTALGORITHMBINDSCHEMA( schemaname, algoid) 参数描述： schemaname：要绑定的schema名称 algoid：要绑定的算法ID 加密算法绑定到表 将创建的算法绑定到表上，实现加密算法和数据库对象建立关联。 plaintext SELECT MLSTRANSPARENTCRYPTALGORITHMBINDTABLE( schemaname, tablename, algoid) 参数描述： schemaname：表所属的schema名称 tablename：表名称 algoid：要绑定的算法ID 加密算法绑定到列 将创建的算法绑定到列上，实现加密算法和数据库对象建立关联。 plaintext SELECT MLSTRANSPARENTCRYPTALGORITHMBINDTABLE( schemaname, tablename, attrname, algoid) 参数描述： schemaname：表所属的schema名称 tablename：表名称 attrname：列名称 algoid：要绑定的算法ID

本页为您介绍初始化实例的操作步骤。 1. 通过pgxcctl新建一个双CN、双DN的实例，并开启服务。 2. 通过telesql连接到CN节点。 3. 执行sql “create default node group defaultgroup with(dn01, dn02); create sharding group to group defaultgroup;”。

本页为您介绍创建插件的操作步骤。 1. 通过telesql连接到CN节点。 2. 执行sql “create extension pgtrashcan;” 3. 执行telesql命令dx，查看插件pgtrashcan是否存在。

建立数据密钥对象和数据库数据对象的关联关系，建立完关联关系，数据库在插入和更新数据自动对数据加密，在数据查询时主动对数据解密。 plaintext CREATE TABLE tablename ( 非加密列 noencryptcolumn datatype, 加密列 encryptcolumn1 datatype ENCRYPTED WITH ( COLUMNSENCRYPTIONKEY columnencryptionkeyname1, ENCRYPTIONTYPE DETERMINISTIC ), ...... ); 参数描述： ENCRYPTED WITH列约束： columnencryptionkey：指定加密该列的CEK名称。 encryptiontype：ENCRYPTED WITH约束中的加密类型，可能取 DETERMINISTIC：确定性加密，iv基于明文生成。 RANDOMIZED：随机性加密，iv随机生成。

本页为您介绍全密态的使用和开启说明。 全密态基于数据库不可信，数据库后端是密文，在前端进行数据的加解密操作。Teledb支持psql开启全密态，psql添加C开启全密态可信环境，例如： plaintext psql使用C开启全密态 psql p xxxx d postgres U root C 查询GUC参数验证开启情况 SHOW enablefullencrypt; 查询执行结果为开启： enablefullencrypt on (1 row)

本页为您介绍创建表并插入数据的方法。 plaintext teledb CREATE TABLE foo (bar bigint, baz text); CREATE TABLE teledb ALTER TABLE foo SET (autovacuumenabled false, toast.autovacuumenabled false); ALTER TABLE teledb INSERT INTO foo VALUES (1, 'aaa'), (2, 'bbb'),(3,'ccc'); INSERT 0 3

本页为您介绍初始化实例的操作步骤。 1. 通过pgxcctl新建一个双CN、双DN的实例，并开启服务。 2. 通过telesql连接到CN节点。 3. 执行sql “create default node group defaultgroup with(dn01, dn02); create sharding group to group defaultgroup;”。

本文为您介绍如何使用gin索引。 pgtrgm索引 注意 此功能需加载插件 pgtrgm。 teledb drop index ttrgmtrgmidx; DROP INDEX teledb create index ttrgmtrgmidx on ttrgm using gin(trgm gintrgmops); CREATE INDEX jsonb索引 teledb create table tjsonb(id int,fjsonb jsonb); CREATE TABLE teledb create index tjsonbfjsonbidx on tjsonb using gin(fjsonb); CREATE INDEX 数组索引 teledb create table tarray(id int, mc text[]); CREATE TABLE teledb insert into tarray select t,('{'md5(t::text)'}')::text[] from generateseries(1,1000000) as t; INSERT 0 1000000 teledb analyze; ANALYZE teledb timing Timing is on. teledb explain select from tarray where mc @> ('{'md5('1')'}')::text[]; QUERY PLAN Remote Fast Query Execution (cost0.00..0.00 rows0 width0) Node/s: dn01, dn02 > Gather (cost1000.00..13094.09 rows2503 width61) Workers Planned: 2 > Parallel Seq Scan on tarray (cost0.00..11843.79 rows1043 width61) Filter: (mc @> ((('{'::text 'c4ca4238a0b923820dcc509a6f75849b'::text) '}'::text))::text[]) (6 rows) Time: 21.368 ms teledb select from tarray where mc @> ('{'md5('1')'}')::text[]; id mc + 1 {c4ca4238a0b923820dcc509a6f75849b} (1 row) Time: 431.788 ms teledb