explain select from tmulidx where f11 or f22 or f33 ; QUERY PLAN Remote Fast Query Execution (cost0.00..0.00 rows0 width0) Node/s: dn001, dn002 > Seq Scan on tmulidx (cost0.00..12966.87 rows3 width16) Filter: ((f1 1) OR (f2 2) OR (f3 3)) (4 rows) Time: 3.153 ms 如果返回字段全部在索引文件中，则只需要扫描索引，IO 开销会更少。 teledb explain select f1,f2,f3 from tmulidx where f11 ; QUERY PLAN Remote Fast Query Execution (cost0.00..0.00 rows0 width0) Node/s: dn01 > Index Only Scan using tmulidxidx on tmulidx (cost0.42..8.44 rows1 width12) Index Cond: (f1 1) (4 rows) Time: 2.630 ms 更新性能比单字段多索引文件要好。 多字段 teledb truncate table tmulidx; TRUNCATE TABLE Time: 44.930 ms teledb insert into tmulidx select t,t,t,t from generateseries(1,1000000) as t; INSERT 0 1000000 Time: 1985.901 ms (00:01.986) 单字段 teledb create table tsimpleidx (f1 int,f2 int,f3 int,f4 int); CREATE TABLE teledb create index tsimpleidxidx on tsimpleidx(f1); CREATE INDEX teledb create index tsimpleidxidx1 on tsimpleidx(f2); CREATE INDEX teledb create index tsimpleidxidx2 on tsimpleidx(f3); CREATE INDEX teledb insert into tsimpleidx select t,t,t,t from generateseries(1,1000000) as t; INSERT 0 1000000 Time: 4186.401 ms (00:04.186) 多字段索引走非第一字段查询时性能比独立的单字段差。 多字段 teledb

本文为您介绍如何使用gist 索引。 注意 此功能需加载插件 pgtrgm。 teledb create extension pgtrgm; CREATE EXTENSION teledb create table ttrgm (id int,trgm text,notrgm text) ; ERROR: relation "ttrgm" already exists teledb create index ttrgmtrgmidx on ttrgm using gist(trgm gisttrgmops); CREATE INDEX

字段名称 说明 dbid SQL 操作的数据库 queryid SQL 语句 ID query SQL 语句内容 sourcenode 索引建议生效的节点 recmndedindex 针对该SQL 的索引建议 costwithoutindex 不采用索引建议时的执行代价 costwithindex 采用索引建议时的执行代价 percentimproved 索引建议提高的执行性能（百分比%） currentplan 原SQL 语句的查询计划 hypoplan 使用索引建议后SQL 语句的查询计划 iscreated 该索引是否已经被创建

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

本文为您介绍如何在使用SELECT语法时进行排序。 按某一列排序 teledb create table teledbpg(id int, nickname text); CREATE TABLE teledb insert into teledbpg values(1,'teledb'),(3,'pg'),(1,'hello,pgxc'); COPY 3 teledb select from teledbpg order by nickname; id nickname + 1 hello,pgxc 3 pg 1 teledb (3 rows) 按第一列排序 teledb select from teledbpg order by 1; id nickname + 1 teledb 1 hello,pgxc 3 pg 按ID 升级排序，再按 nickname 降序排序 teledb select from teledbpg order by id,nickname desc; id nickname + 1 teledb 1 hello,pgxc 3 pg (3 rows) 效果与上面的语句一样。 teledb select from teledbpg order by 1,2 desc; id nickname + 1 teledb 1 hello,pgxc 3 pg (3 rows) 随机排序 teledb select from teledbpg order by random(); id nickname + 1 teledb 3 pg 1 hello,pgxc (3 rows) teledb select from teledbpg order by random(); id nickname + 1 hello,pgxc 1 teledb 3 pg (3 rows) 计算排序 teledb select from teledbpg order by md5(nickname); id nickname + 1 hello,pgxc 3 pg 1 teledb (3 rows) 排序也能用子查询。 teledb

使用delimiter指定列与列之间的分隔符 teledb copy t to '/home/teledb/t.txt' with delimiter '@'; COPY 3 teledb ! cat /home/teledb/t.txt 1@张三@20001201 00:00:00@北京 2@李四@19970324 00:00:00@上海 3@王五@20040901 00:00:00@广州 teledb copy t to '/home/teledb/t.txt' with csv delimiter '@'; COPY 3 teledb ! cat /home/teledb/t.txt 1@张三@20001201 00:00:00@北京 2@李四@19970324 00:00:00@上海 3@王五@20040901 00:00:00@广州 teledb copy t to '/home/teledb/t.txt' with csv delimiter '@@'; ERROR: COPY delimiter must be a single onebyte character teledb copy t to '/home/teledb/t.txt' with binary delimiter '@'; ERROR: cannot specify DELIMITER in BINARY mode 指定分隔文件各列的字符。文本格式中默认是一个制表符， 而CSV格式中默认是一个逗号。分隔符必须是一个单一的单字节字符，即汉字是不支持的。使用binary格式时不允许这个选项。 NULL 值的处理 teledb insert into t(name, birth, city) values('赵六','20001201', null); INSERT 0 1 teledb copy t to '/home/teledb/t.txt' with csv null 'NULL'; COPY 4 teledb ! cat /home/teledb/t.txt 1,张三,20001201 00:00:00,北京 2,李四,19970324 00:00:00,上海 3,王五,20040901 00:00:00,广州 4,赵六,20001201 00:00:00,NULL 记录值为NULL时导出为NULL字符。使用binary格式时不允许这个选项。

drop node group defaultgroup; DROP NODE GROUP 修改存储组 修改存储组只能将存储组定义为默认存储组，语法如下： alter node group groupname set to default; 当已存在默认存储组的情况下，此语句无法生效。 teledb create node group group1 with (dn01); CREATE NODE GROUP teledb create node group group2 with (dn02); CREATE NODE GROUP teledb alter node group group1 set to default; ALTER NODE GROUP teledb alter node group group2 set to default; ERROR: default group already exists, groupoid:57352 查看存储组相关信息 teledb select oid, from pgxcgroup; oid groupname defaultgroup groupmembers +++ 57353 group2 0 16386 57352 group1 1 16385

本文为您介绍如何创建分区表。 创建范围分区表 teledb create table trange (f1 bigint,f2 timestamp default now(), f3 integer) partition by range (f3) begin (1) step (50) partitions (3) distribute by shard(f1); CREATE TABLE teledb insert into trange(f1,f3) values(1,1),(2,50),(3,100),(2,110); COPY 4 teledb insert into trange(f1,f3) values(1,1),(2,50),(3,100),(2,110); COPY 4 teledb d+ trange; Table "public.trange" Column Type Collation Nullable Default Storage Stats target Description +++++++ f1 bigint plain f2 timestamp without time zone now() plain f3 integer plain Distribute By: SHARD(f1) Location Nodes: ALL DATANODES Partition By: RANGE(f3) Of Partitions: 3 Start With: 1 Interval Of Partition: 50 创建时间范围分区表 teledb create table ttimerange (f1 bigint, f2 timestamp ,f3 bigint) partition by range (f2) begin (timestamp without time zone '20170901 0:0:0') step (interval '1 month') partitions (12) distribute by shard(f1); CREATE TABLE teledb d+ ttimerange Table "public.ttimerange" Column Type Collation Nullable Default Storage Stats target Description +++++++ f1 bigint plain f2 timestamp without time zone plain f3 bigint plain Distribute By: SHARD(f1) Location Nodes: ALL DATANODES Partition By: RANGE(f2)

项目 备注 encoding 编码 lccollate 排序规则 lcctype 分组规则

本文为您介绍如何在使用SELECT语法时进行分页查询。 默认从第一条开始，返回一条记录。 teledb select from teledbpg limit 1; id nickname + 1 teledb (1 row) 使用offset指定从第几条开始，0表示第一条开始，返回1条记录。 teledb select from teledbpg limit 1 offset 0; id nickname + 1 teledb (1 row) 从第3条开始，返回二条记录。 teledb select from teledbpg limit 2 offset 2; id nickname + 2 TELEDB 3 pg (2 rows) 上面的语句没有使用排序，返回结果不可预知，使用order by 可以获得一个有序的结果。 teledb select from teledbpg order by nickname; id nickname + 1 hello,pgxc 3 pg 1 teledb 2 TELEDB 4 (5 rows) teledb select from teledbpg order by nickname limit 2 offset 2; id nickname + 1 teledb 2 TELEDB (2 rows)

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

select from ttimerange; f1 f2 f3 ++ 1 20171001 00:00:00 100 1 20171101 00:00:00 100 (2 rows) truncate 一个数字分区表。 teledb select from trange; f1 f2 f3 ++ 1 20230823 10:29:46.263768 1 2 20230823 10:29:46.263768 50 2 20230823 10:29:46.263768 110 3 20230823 10:29:46.263768 100 (4 rows) teledb d+ trange Table "public.trange" Column Type Collation Nullable Default Storage Stats target Description +++++++ f1 bigint plain f2 timestamp without time zone now() plain f3 integer plain Distribute By: SHARD(f1) Location Nodes: ALL DATANODES Partition By: RANGE(f3) Of Partitions: 3 Start With: 1 Interval Of Partition: 50 teledb truncate trange partition for (1); TRUNCATE TABLE teledb truncate trange partition for (2); TRUNCATE TABLE teledb select from trange; f1 f2 f3 ++ 2 20230823 10:29:46.263768 110 3 20230823 10:29:46.263768 100 (2 rows)

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

本文为您介绍如何使用条件索引。 teledb create table tsex(id int,sex text) ; CREATE TABLE teledb teledb create index tsexsexidx on tsex (sex); CREATE INDEX teledb insert into tsex select t,'男' from generateseries(1,1000000) as t; INSERT 0 1000000 teledb insert into tsex select t,'女' from generateseries(1,100) as t; INSERT 0 100 teledb analyze tsex ; ANALYZE teledb explain select from tsex where sex '女'; QUERY PLAN Remote Fast Query Execution (cost0.00..0.00 rows0 width0) Node/s: dn01, dn02 > Index Scan using tsexsexidx on tsex (cost0.42..9.30 rows50 width8) Index Cond: (sex '女'::text) (4 rows) 索引对于条件在性别为男的情况下无效。 teledb explain select from tsex where sex '男'; QUERY PLAN Remote Fast Query Execution (cost0.00..0.00 rows0 width0) Node/s: dn01, dn02 > Seq Scan on tsex (cost0.00..9966.58 rows500556 width8) Filter: (sex '男'::text) (4 rows) 连接DN 节点查看索引占用空间大，而且度数也高。 teledb di+ tsexsexidx List of relations Schema Name Type Owner Table Size Allocated Size Description +++++++ public tsexsexidx index teledb tsex 14 MB 14 MB (1 row) teledb q [teledb@localhost bin]$ ./telesql p 11111 U teledb d teledb Password for user teledb: telesql (TeleDB V6) Type "help" for help. teledb

本文为您介绍如何添加分区子表。 teledb d+ trange Table "public.trange" Column Type Collation Nullable Default Storage Stats target Description +++++++ f1 bigint plain f2 timestamp without time zone now() plain f3 integer plain Distribute By: SHARD(f1) Location Nodes: ALL DATANODES Partition By: RANGE(f3) Of Partitions: 3 Start With: 1 Interval Of Partition: 50 teledb alter table trange add partitions 2; ALTER TABLE teledb d+ trange Table "public.trange" Column Type Collation Nullable Default Storage Stats target Description +++++++ f1 bigint plain f2 timestamp without time zone now() plain f3 integer plain Distribute By: SHARD(f1) Location Nodes: ALL DATANODES Partition By: RANGE(f3) Of Partitions: 5 Start With: 1 Interval Of Partition: 50

本文为您介绍如何管理普通索引。 teledb create index tididx on t1 using btree(id); CREATE INDEX

本文为您介绍如何使用查询结果创建数据表。 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)

本文为您介绍如何指定模式创建表。 teledb create table public.t1(id int,mc text); CREATE TABLE

本文为您介绍如何创建shard表。 不指定shard key 建表方式 不指定shard key 建表方法，系统默认使用第一个字段作为表的 shard key。 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 建表方式 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 用于指定存储组（每个存储组可以有多个节点）。 分布键字段值不能修改，字段长度不能修改，字段类型不能修改。

d dbgbk Did not find any relation named "dbgbk". teledb l+ dbgbk List of databases Name Owner Encoding Collate Ctype Access privileges Size Tablespace Description ++++++++ dbgbk teledb GBK zhCN.gbk zhCN.gbk 19 MB pgdefault (1 row) 指定排序规则 teledb create database teledbdblccollate lccollate 'C' template template0; CREATE DATABASE 指定分组规则 teledb create database teledblcctype LCCTYPE 'C' template template0; CREATE DATABASE 配置数据可连接 teledb create database teledballowconnections ALLOWCONNECTIONS true; CREATE DATABASE teledb select datallowconn from pgdatabase where datname 'teledballowconnections'; datallowconn t (1 row) teledb c teledballowconnections You are now connected to database "teledballowconnections" as user "teledb". 配置连接数 teledb create database teledbconnlimit CONNECTION LIMIT 100; CREATE DATABASE teledb select datconnlimit from pgdatabase where datname'teledbconnlimit'; datconnlimit 100 (1 row) 配置数据库可以被复制（是否模板数据库） teledb create database teledbistemplate istemplate true; CREATE DATABASE teledb select datconnlimit from pgdatabase where datname'teledbconnlimit'; datconnlimit 100 (1 row) 同时配置多个参数 teledb create database teledbmul owner teledbuser CONNECTION LIMIT 50 template template0 encoding 'utf8' lccollate 'C'; CREATE DATABASE

本文为您介绍如何创建模式。 您可参考如下操作创建模式。 标准语法 teledb create schema teledbschema; CREATE SCHEMA 注意 当标准语法不存在时，才创建扩展语法。 扩展语法 teledb create schema if not exists teledbschema; NOTICE: schema "teledbschema" already exists, skipping CREATE SCHEMA 指定所属用户 teledb create schema teledbschemaowner AUTHORIZATION teledbuser; CREATE SCHEMA teledb dn teledbschemaowner List of schemas Name Owner + teledbschemaowner teledbuser (1 row)

相比于传统的集中式数据库，分布式数据被分散存储在多个物理位置（多台服务器或数据中心）上，并将这些分散的存储资源构成一个虚拟的存储设备。这种存储方式不仅实现在线扩容能力，同时也提升了数据的检索能力。而且分布式数据库利用SQL语言进行分布式查询和处理，使其性能和扩展性得到显著提升。 分布式数据存储原理 分布式存储架构通常由三个部分组成：客户端、元数据服务器（协调节点）和数据服务器（数据节点）。其主要流程是：客户端负责发送读写请求，缓存文件元数据和文件数据。元数据服务器（协调节点）管理元数据和处理客户端的请求。数据服务器（数据节点）存放文件数据，保证数据的可用性和完整性。分布式存储主要通过以下几种方式实现： 数据分片‌：在分布式存储系统中，数据被分成多个部分，每个部分存储在不同的数据节点上，以实现数据的分布式存储和管理。这种分片通常使用哈希函数或一致性哈希算法来实现。 主备复制‌：为了提高数据的可靠性和可用性，分布式存储系统通常分为主备节点。每个数据都存储在不同的数据节点上，以确保即使某些节点出现故障，仍然可以从其他节点中恢复数据。 数据一致性‌：确保数据在不同节点之间的一致性是分布式存储系统的关键。为了实现数据同步和管理，分布式存储系统使用数据同步和管理机制，如Paxos算法、Raft算法或ZooKeeper等分布式协调服务。 数据访问‌：在分布式存储系统中，数据可以并行地从多个节点中读取和写入，以提高读写性能和吞吐量。数据访问使用负载均衡机制实现，如分布式哈希表、分布式缓存或分布式文件系统等技术。 通过这种存储方式可实现TeleDB在线扩容能力，在业务无感知的情况下，在线弹性伸缩，提升系统容量和处理能力，以便满足大规模存储应用的需求。

填写机器的IP PUSHGATEWAYUSERNAMEadmin PUSHGATEWAYPASSWORD[ENCRYPTIONencryption]XhGs6BZulfxSto9l ENABLEEVENTALARMfalse ALARMPUSHURL 填写机器的IP ALARMTYPEID18 执行如下命令修改配置文件ossinit.conf vim ossinit.conf 这文件就改控制台安装目录这一个地方，其他不用动 cat ossinit.conf PGXZOSUSERteledbx PGXZOSPSWD'4MPhD%gKeNMy' PGXZOSHOME/app/teledbx 只修改这里的安装目录 if [ $(cat /etc/systemrelease grep i centos wc l) "1" ]; then PGXZOSNAMEcentos else PGXZOSNAMEctyunos fi PGXZOSBINDIR${PGXZOSHOME}/install PGXZOSDATADIR${PGXZOSHOME}/data CONFDBOSDATADIR${PGXZOSHOME}/confdb PGXZOSETHeth${PGXZOSUSER} PGXZYUMDIR$(cd ../teledbxmirror; pwd) PGXZYUMPORT8018 5. 安装控制台 执行如下命令安装控制台。 su teledb cd /app/teledbconsole centos.x8664/teledbxmgr/ sh teledbxmgr.sh install 安装过程中出现选项，输入Y即可。 当出现如下回显信息，表示安装成功。 安装后验证 1. 打开浏览器访问dcp地址： 2. 能访问，并登录表示安装成功。 卸载服务 执行forceclean.sh脚本，可卸载服务。

ip nginxDir"/usr/local" 路径 rontHttpsPort9083 端口 prometheusVersion"prometheus2.31.1.linuxamd64" pushgatewayVersion"pushgateway1.4.2.linuxamd64" alertManagerVersion"alertmanager0.23.0.linuxamd64" opengateway openGatewayAdminPort9014 端口 openGatewayCorePort9013 端口 openApiHttpPort7084 端口 openGatewayCoreHost"" 部署 IP 地址 openapiTenantId11 openapiUserId11 openapiCloudTypeprivatecloud mysql init initMysqlUserroot 控制台公共库 root 用户 initMysqlBin"/teledb/teledb8801/bin/mysql" 控制台公共库路径 initMysqlUserPwd"" root 的密码 3. 执行deploy.sh脚本 执行如下命令。 cd /app/teledbdcpdeploy/deploy/mysql vi inituser.sql 修改inituser.sql文件中创建数据库用户密码，使其与dcp密码一致。 输入 :wq!保存退出。 vi deploy.sh 单节点公共库填写ps efgrep mysql查询sock路径，高可用公共库需要填写VIPIP和端口，通过该命令查询：h VIPIP p端口 执行如下命令，执行deploy.sh脚本 sh deploy.sh 4. 执行控制台服务脚本deploydcp.sh 执行如下命令 sudo sh deploydcp.sh 启动web和gateway服务 sudo systemctl start teledbdcpweb sudo systemctl start teledbdcpapigateway 执行如下命令，检查是否启动。 sudo systemctl status teledbdcpweb sudo systemctl status teledbdcpapigateway 5. 验证前端是否部署完成 curl k 如果是服务器重启，nginx 需要手动启动： /usr/local/nginx/sbin/nginx c /usr/local/nginx/conf/nginx.conf 6. 启动相关服务 执行如下命令，运行prometheus 的脚本 deploypromethues.sh sudo sh deploypromethues.sh 执行如下命令，启动prometheus 相关服务 sudo systemctl start prometheus sudo systemctl start alertmanager sudo systemctl start pushgateway 执行如下命令查看服务情况 sudo systemctl status prometheus sudo systemctl status alertmanager sudo systemctl status pushgateway

安装后验证 服务器上架成功，实例开通成功，确认部署完成。 卸载服务 1. 删除实例： 在控制台停止实例、删除实例，具体步骤参见用户手册。 2. 如需卸载环境 1. 下架服务器，下架前确保没有实例部署在服务器上。 2. 停止服务器上的Agent服务。 3. 清空数据目录。 4. 删除teledb账号。 5. 回收服务器。

该任务用于指导软件工程师安装部署teledb公共配置库。 前提条件 已初始化环境。 操作步骤 请您参照如下步骤安装teledb公共库。 1. 上传部署包 上传monitor 控制台安装包：teledbtelemonitor . tar到/app 目录下的teledb目录。 2. 解压部署包执行如下命令解压monitor控制台部署包 tar zxvf teledbtelemonitor .tar.gz C /app/teledb 3. 手动安装部署依赖（单节点只需初始化部署主机，高可用需要初始化每一台主机） 执行如下命令，进入package/envinit/x86目录。 cd package/envinit/x86 执行如下命令，解压部署包。 tar zxvf envInitx86.tar.gz 得到如下目录： envInit/ envInit/installjdk.sh envInit/jdk/ envInit/jdk/jdk8u201linuxx64.tar.gz envInit/sshpass1.062.el7.x8664.rpm envInit/pv1.4.61.el7.x8664.rpm envInit/lz41.7.53.el7.x8664.rpm envInit/libaio0.3.10913.el7.x8664.rpm 执行如下命令，安装jdk。 cd envInit/ sh installjdk.sh 出现如下回显信息，表示安装成功。 install and config java success. 安装成功后，执行如下命令更新环境变量。 source /etc/profile 执行如下命令安装部署依赖。 rpm ivh force nodeps nosignature libaio0.3.10913.el7.x8664.rpm rpm ivh force nodeps nosignature lz41.7.53.el7.x8664.rpm rpm ivh force nodeps nosignature pv1.4.61.el7.x8664.rpm rpm ivh force nodeps nosignature sshpass1.062.el7.x8664.rpm （可选）执行如下命令，检查perl是否安装。 yum install y perl 4. 部署monitor控制台 执行如下命令，进入目录 cd /app/teledb cd consoledeploy/conf/ Vi tele.ini 参考如下内容，修改tele.ini配置文件 ;package and directory info [package] ;cputype 填写范围 ,指预置区的芯片类型 x86、arm CPUTYPEx86 PACKAGEMAINDIR/app

数据库安全保障是指通过一系列安全措施加强对数据库安全进行防护。数据库安全配置核心在对数据库进行访问控制、数据加密、审计、数据脱敏和数据库备份与恢复等安全管理策略，确保数据的完整性、机密性、可用性、可控性和可审查性。 访问控制 TeleDB支持通过设有用户权限控制和强制访问控制，对不同对象有不同的访问来控制权限，确保数据安全。它主要包括自主访问权限控制和强制访问控制。 自主访问控制 ：TeleDB支持自主赋予不同用户角色操作控制权限和提供对数据库资源（实例、表、视图等）细粒度权限控制能力。 强制访问控制： 提供更细粒度的访问控制，即行级的访问控制。 自主访问控制具体实施方案请参考《TeleDB安全配置手册》中“自主访问控制”章节。 强制访问控制具体实施方案请参考《TeleDB安全配置手册》中“强制访问控制”章节。 数据加密 TeleDB支持通过数据加密来确保只有授权的用户才能访问敏感信息，防止个人信息泄露。数据加密是一种将原始数据转换成不可读格式的过程。通过数据加密可以确保只有授权的用户才能访问存储在设备或数据库中的敏感信息，防止个人信息泄露。TeleDB支持三种数据加密方式，分别为透明存储加密、通信加密和全密态加密。 透明存储加密方式（Transparent Data Encryption, TDE）是一种保护数据库中静态数据的加密技术，使数据在存储时自动加密，有助于防止未授权访问和数据泄露。透明存储加密的特点是数据在加密和解密过程对应用程序透明，该过程中应用程序无需进行任何修改，从而简化了实施流程。加密操作（函数调用）与业务侧解耦合，业务只负责传递原始数据到数据库内核，后续的加密计算在数据库内部完成，从而业务侧操作上无感知。具体实施方案请参考《TeleDB安全配置手册》中“透明存储加密”章节。 通信加密是指基于传输层SSL（Secure Sockets Layer）协议加密的加密方式。SSL加密是一种安全协议，用于在互联网上建立一个加密的链接，来确保数据传输的安全性。具体实施方案请参考《TeleDB安全配置手册》中“通信加密”章节。 全密态加密是一种数据加密技术，‌旨在确保数据在整个生命周期（‌包括传输、‌运算和存储）‌中始终保持加密状态，‌从而保护数据隐私。‌这种加密技术不仅涉及到数据的存储加密，‌还包括数据在处理过程中的加密，‌确保即使在数据传输和计算过程中，‌攻击者也无法获取有效的数据信息。‌全密态加密技术的实现依赖于特定的密钥管理机制，‌包括客户端主密钥（‌CMK）‌和数据加密密钥（‌CEK）‌的使用，‌其中CMK用于加密CEK，‌而CEK则用于加密用户数据，‌从而形成一个完整的数据加密体系。具体实施方案请参考《TeleDB安全配置手册》中“全密态加密”章节。

双中心容灾部署是指在同一个城市内建立两个数据中心，其中一个作为主数据中心，负责日常的生产运行，而另一个作为灾备中心，用于在主数据库中心出现故障时接管业务，保证业务的连续性和数据完整性。 同城双中心容灾部署方案 同城双中心部署方案建议采用至少一主两从的三节点的方式，它包括两个物理机房，分别是同城IDC1机房和同城IDC2机房。同城IDC1机房为主中心采用一主一从两组节点，同城IDC2机房至少部署1个一组从节点为同城中心，其中主中心负责主要的业务处理，而同城中心则作为备份，提供数据冗余和故障恢复能力。三组节点分布在同城两个IDC机房里，机房之间使用专线互通，通过这种方式，即使主中心发生故障，同城中心也可以接管部分或全部业务，保证业务的连续性和数据的完整性。 若业务需要使用TeleDB的HTAP能力，那么必须开启TeleDB的读写多平面特性。考虑到跨机房的时延，同城IDC2机房建议只开启只读平面。在TeleDB集群中，同一平面的CN节点是对等的，由于LVS等负载均衡的组件，具备故障节点自动剔除的能力，可以保证在任意平面的CN故障时，业务请求不会失败；GTM节点以及DN节点均有同步备机存在，TeleDB在运维管理系统的辅助下，会在1分钟以内发现故障，并发起自动切换，数据保证0丢失。

分布式数据库通过在不同物理位置的多个节点上存储数据来提高系统的可用性和可扩展性。而分布式事务则需要确保这些节点上数据的一致和完整。 分布式事务全局一致性面临挑战 为实现分布式事务全局数据一致性，我们将面临如下挑战： 数据分散 分布式事务需要满足事务的ACID的特性，而业务数据分散存储在网络中的多个节点上。因此，分布式数据库在进行事务的分发，协同多节点完成业务请求过程中，如何确保所有节点上数据同步更新将是一大挑战。 网络延迟与故障 跨网络多节点需要协调配合，协调能否正常、顺利作业是关键，这决定了业务数据的一致性和请求响应的及时性。网络时延、异常、主机故障和操作系统调度异常等不确定因素，都会给分布式事务一致性带来诸多挑战。而数据库需要在异常发生后，能够快速自愈，并能保证异常期间事务的完整性（不出现数据丢失、错乱）和一致性将又是另一大挑战。 并发控制 在多个事务并发执行时，如何避免数据冲突和死锁也是一大难题。 分布式事务全局一致性实现策略 TeleDB引入全局事务管理节点（GTM），专门处理分布式事务一致性工作。它通过全局时钟（Global Timestamp）和两阶段提交（Two Phase Commit）两种策略，使分布式环境下的事务保持一致成为可能。

连接池 应用侧可以通过 maximumPoolSize配置连接池最大连接数，可以通过minimumIdle配置连接池最小空闲连接数，需要根据自身情况配置合适的连接池大小。 分布式数据库HTAP 默认不会主动关闭客户端连接（除非报错），但是也需要探活连接，可以在每次使用连接前检查连接是否可用，或者定期发送 test query 保活连接等方式进行探活。 数据库访问框架 可以使用目前比较流行MyBatis数据访问框架管理 SQL 并完成结果集和 Java 对象的来回映射工作。 如果希望从MyBatis中读取超大结果集合时可以使用带 ResultHandler的查询接口来避免一次获取整个结果集，或者使用Cursor 类来进行流式读取等。

响应示例 请求成功示例： { "statusCode": 200, "message": "success", "returnObj": { "orderNo": "20221018153152727265" } } 验签失败示例： { "statusCode": 500, "error": "EMR401000", "message": "OpenAPI认证失败", "returnObj": {} } 实名认证失败示例： { "statusCode": 500, "error": "EMR401009", "message": "账号未进行实名认证", "returnObj": {} } 非法操作示例： { "statusCode": 500, "error": "EMR401004", "message": "非法操作", "returnObj": {} } 请求参数类型错误示例： { "statusCode": 500, "error": "EMR401001", "message": "请求参数类型错误", "returnObj": "{"clusterName": "应为字符串"}" } 请求参数值无效示例1： { "statusCode": 500, "error": "EMR401002", "message": "请求参数值无效", "returnObj": "{"clusterName": "不能为空"}" } 请求参数值无效示例2： { "statusCode": 500, "error": "EMR401002", "message": "请求参数值无效", "returnObj": "{"clustertype": "集群类型不存在：xxx"}" } 规格不足示例： { "statusCode": 500, "error": "EMR401012", "message": "规格已售罄", "returnObj": {} } IP不足示例： { "statusCode": 500, "error": "EMR401013", "message": "子网下IP余量不足", "returnObj": {} } 状态码 请参考 状态码 错误码 请参考 错误码

参数 是否必填 参数类型 说明 示例 下级对象 clusterId 是 String 集群id da595eb1d81503b323fdc01d9bf786b7 timestamp 是 Long 要查询的时间点，以 Unix 时间戳表示（单位：秒） 1700000000