本页介绍天翼云TeleDB数据库的Constraints设计规范。 1. 建议每个table都使用shard key作为主键或者唯一索引。 2. 建议建表时一步到位把主键或者唯一索引也一起建立。 注意 非shard key不可以建立primary key或者unique index。

本页介绍天翼云TeleDB数据库的事务控制方法。 1. 开始一个事务 plaintext teledb begin; BEGIN 或者 plaintext teledb begin TRANSACTION ; BEGIN 也可以定义事务的级别。 plaintext teledb begin transaction isolation level read committed ; BEGIN 2. 提交事务 会话1访问 plaintext teledb begin; BEGIN teledb delete from bills where id 11; DELETE 1 teledb select from bills; id goodsdesc beginunit begincity pubtime amount +++++ 1 衣服 海南省 三亚市 20151005 09:32:01 3714.15 2 建筑设备 福建省 三明市 20151005 07:21:22 8195.98 5 5 0铲车，后八轮翻斗车 河南省 三门峡市 20151005 07:53:13 6252.91 6 鲜香菇2000斤 河南省 三门峡市 20151005 10:38:29 1828.83 8 旋挖附件35吨 河南省 三门峡市 20151005 10:48:38 9885.95 9 旋挖附件39吨 河南省 三门峡市 20151005 11:38:38 4971.79 3 设备 福建省 三明市 20151005 11:21:54 6351.44 4 普货 福建省 三明市 20151005 15:19:17 7626.41 7 旋挖附件38吨 河南省 三门峡市 20151005 10:48:38 9376.8 10 设备 上海市 上海市 20151005 07:59:35 1784.63 (10 rows) TeleDB也是完全支持ACID特性，没提交前开启另一个连接查询，你会看到是11条记录，这是TeleDB隔离性和多版本视图的实现，如下所示 会话2访问 plaintext teledb

insert into tupdate select t,random()::text from generateseries(1,100000) as t; INSERT 0 100000 Time: 244.021 ms teledb truncate table tupdate; TRUNCATE TABLE Time: 21.953 ms 数据表使用复合类型 plaintext teledb create table tmytype (f1 int,fmytype mytype); CREATE TABLE teledb insert into tmytype values(1,row(1,'teledb')); INSERT 0 1 teledb select from tmytype; f1 fmytype + 1 (1,teledb) (1 row)

大批量的生成数据 plaintext teledb truncate table teledbpg1; TRUNCATE TABLE teledb insert into teledbpg1 select t,md5(random()::text) from generateseries(1,10000) as t; INSERT 0 10000 teledb select count(1) from teledbpg1; count 10000 (1 row) 返回插入数据，轻松获取插入记录的serial值 plaintext teledb create table teledbserial(id serial, nickname varchar); CREATE TABLE teledb insert into teledbserial(nickname) values('hello teledb') returning ; id nickname + 1 hello teledb (1 row) INSERT 0 1 指定返回的字段。 teledb insert into teledbserial(nickname) values('hello teledb') returning id; id 2 (1 row) INSERT 0 1 insert..update更新 使用on conflict plaintext teledb create table tupdate(id int unique, name varchar); CREATE TABLE teledb d+ tupdate Table "public.tupdate" Column Type Collation Nullable Default Storage Stats target Description +++++++ id integer plain name character varying extended Indexes: "tupdateidkey" UNIQUE CONSTRAINT, btree (id) Distribute By: SHARD(id) Location Nodes: ALL DATANODES teledb insert into tupdate values(1,'teledb'); INSERT 0 1 teledb insert into tupdate values(1,'teledb') on conflict(id) do update set name 'hello'; INSERT 0 1 teledb select from tupdate ; id name + 1 hello (1 row)

xcnodeid nodename id nickname +++ 1085152094 dn01 5 test 1085152094 dn01 6 teledb, teledb1 506537247 dn02 3 pg

id nickname + 2 TELEDB 4

id nickname + 4

id nickname + 3 pg 4 2 TELEDB

本文为你介绍合并多个查询结果的方法。 不过滤重复的记录。 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)

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

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

Column Type Collation Nullable Default Storage Stats target Description +++++++ id integer plain mc text extended 这是一条字段注释 age integer plain

本文为您介绍如何创建唯一索引。 创建唯一索引 plaintext teledb create unique index tasiduidx on tas using btree(id); CREATE INDEX 非shard key 字段不能建立唯一索引 plaintext teledb create unique index tasiduidx on tas using btree(mc); ERROR: Unique index of partitioned table must contain the hash/modulo distribution column.

本文为您介绍如何添加分区子表。 plaintext 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

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

id mc + 1 teledb

本页介绍天翼云TeleDB数据库创建一个与函数同名的存储过程的错误提示和替换方案。 如创建一个与函数同名的存储过程会提示function xxx already exists with same argument types。 plaintext teledb CREATE OR REPLACE FUNCTION proc1() RETURNS void AS $$ begin raise notice 'Hello teledbpg'; end; $$ LANGUAGE PLPGSQL; CREATE FUNCTION teledb CREATE PROCEDURE proc1() AS $$ begin raise notice 'Hello teledbpg'; end; $$ LANGUAGE PLPGSQL; ERROR: function "proc1" already exists with same argument types teledb 如果要替换，则提示。 plaintext teledb CREATE OR REPLACE PROCEDURE proc1() AS $$ begin raise notice 'Hello teledbpg'; end; $$ LANGUAGE PLPGSQL; ERROR: cannot change routine kind DETAIL: "proc1" is a function. teledb

本文为您介绍如何创建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 用于指定存储组（每个存储组可以有多个节点）。 分布键字段值不能修改，字段长度不能修改，字段类型不能修改。

本页介绍天翼云TeleDB数据库指定或不指定存储过程名的语法。 建立存储过程，模式名可以指定，也可以不指定，不指定则存放在当前模式下，如上面例子就没有指定模式名，则就存放在当前模式下，如下所示。 plaintext teledb select from pgnamespace; nspname nspowner nspacl ++ pgtoast 10 pgtemp1 10 pgtoasttemp1 10 pgcatalog 10 {teledbUC/teledb,U/teledb} public 10 {teledbUC/teledb,UC/teledb} informationschema 10 {teledbUC/teledb,U/teledb} (6 行记录) teledb show searchpath; searchpath "$user",public (1 行记录) teledb select pgnamespace.nspname,pgproc.prosrc from pgproc,pgnamespace where pgproc.pronamespacepgnamespace.oid and pgproc.proname'proc1'; nspname prosrc + public + begin + raise notice 'Hello，teledbpg';+ end; + (1 row) 因为$user模式不存在，所以存在public模式下。

oid groupname defaultgroup groupmembers +++ 57353 group2 0 16386 57352 group1 1 16385

本页介绍天翼云TeleDB数据库使用[OR REPLACE] 更新存储的语法。 带OR REPLACE的作用，在建立存储过程时若存在则替换，建立存储时不带 OR REPLACE关键字，则遇到函数已经存系统则会报错，如下所示。 plaintext teledb select prosrc from pgproc where proname'proc1'; prosrc begin + raise notice 'Hello teledbpg';+ end; + (1 row) teledb CREATE OR REPLACE PROCEDURE proc1() AS $$ begin raise notice 'Hello，teledbpg'; end; $$ LANGUAGE PLPGSQL; CREATE PROCEDURE teledb select prosrc from pgproc where proname'proc1'; prosrc begin + raise notice 'Hello，teledbpg';+ end; + (1 row) teledb teledb call proc1(); NOTICE: Hello，teledbpg CALL teledb

本页展示天翼云TeleDB数据库与Oracle、MySQL和SQL Server的对照信息。 与Oracle对照表 注意 需开启oracle兼容配置。 Oracle TeleDB Number 对应smallint, integer, bigint, numeric(p,s) 等多种数据类型。由于 smallint，Integer，bigint的算术运算效率比numeric高得多，所以要视业务需要转换成对应的smallint, integer, bigint，无法转换时才转换成numeric(p,s) float float（实际按照double precision 或 real存储） binaryfloat binaryfloat（实际按照real存储） binarydouble binarydouble（实际按照double precision存储） char char nchar char varchar2 varchar2 nvarchar2 nvarchar2 rowid rowid urowid urowid（teledb不支持） long long（teledb不支持） clob clob nclob nclob（teledb不支持） blob blob bfile bfile（teledb不支持） long raw long raw（teledb不支持） raw raw（teledb不支持） date date timestamp timestamp interval interval 与MySQL 对照表 MySQL TeleDB int int smallint smallint bigint bigint int AUTOINCREMENT serial smallint AUTOINCREMENT smallserial bigint AUTOINCREMENT bigserial bit bit tinyint smallint float real double double precision decimal numeric char varchar varchar blob text text date date time time datetime timestamp longblob bytea Longtext text ENUM类型 CREATE TABLE TYPE022(COL1 ENUM('S','M','L','XL','XXL','XXXL') ,COL2 INT PRIMARY KEY); 自定义类型CREATE TYPE mood AS ENUM ('S','M','L','XL','XXL','XXXL');CREATE TABLE TYPE022(COL1 mood ,COL2 INT PRIMARY KEY) SET类型 CREATE TABLE TYPE023(COL1 SET('A','B', 'C','D') ,COL2 INT PRIMARY KEY) CREATE TABLE TYPE023(COL1 VARCHAR check(regexpsplittoarray(col1,',') <@ array['A','B','C','D']) ,COL2 INT PRIMARY KEY);

本文为您介绍创建数据库、修改数据库配置和删除数据库。 创建数据库 要创建一个数据库，必须是一个超级用户或者具有特殊的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

Column Type Collation Nullable Default Storage Stats target Description +++++++ id integer plain mc text extended 这是一条字段注释 age double precision plain

select from tmulidx where f11; f1 f2 f3 f4 +++ 1 1 1 1 (1 row) Time: 1.034 ms teledb select from tmulidx where f21; f1 f2 f3 f4 +++ 1 1 1 1 (1 row) Time: 37.072 ms teledb select from tmulidx where f31; f1 f2 f3 f4 +++ 1 1 1 1 (1 row) Time: 36.229 ms 单字段 plaintext teledb select from tsimpleidx where f11; f1 f2 f3 f4 +++ 1 1 1 1 (1 row) Time: 2.610 ms teledb select from tsimpleidx where f21; f1 f2 f3 f4 +++ 1 1 1 1 (1 row) Time: 3.266 ms teledb select from tsimpleidx where f31; f1 f2 f3 f4 +++ 1 1 1 1 (1 row) Time: 1.316 ms

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

本页介绍天翼云TeleDB数据库Oracle语法中的系统函数。 extract plaintext extract(xmltype类型,节点)。 create table xmlexample(ID varchar(100),name varchar(20),data xmltype); insert into xmlexample(id,name,data) values('xxxxxxxxxxxxxxx','my document',' nam022^^^450 抗震救灾 奥运会 经济学 计算机 10001 20050709 计算机 笔记本 '::xmltype); teledb select id,name, extract(x.data,'/collection/record/datafield/subfield') as A from xmlexample x; id name a ++ xxxxxxxxxxxxxxx my document 抗震救灾 奥运会 经济学 计算机 10001 20050709 计算机 笔记本 (1 row)

Column Type Collation Nullable Default ++++ f1 numeric f2 numeric(10,0) f3 numeric(10,2)

f1 f2 + 1 1 1 2 1

本页介绍天翼云TeleDB数据库PL/pgsql的消息及异常输出。 RAISE NOTICE plaintext teledb CREATE OR REPLACE FUNCTION f28() RETURNS VOID AS teledb $$ teledb$ DECLARE teledb$ vint INTEGER : 1; teledb$ BEGIN teledb$ RAISE NOTICE 'vint %, 随机数 %',vint,random(); teledb$ END; teledb$ $$ teledb LANGUAGE plpgsql; CREATE FUNCTION teledb SELECT f28(); NOTICE: vint 1, 随机数 0.236714988015592 f28 (1 row) 使用raise notice向终端输出一个消息，也有可能写到日志中(需要调整日志的保存级别)。 RAISE EXCEPTION plaintext teledb CREATE OR REPLACE FUNCTION f28() RETURNS VOID AS teledb $$ teledb$ DECLARE teledb$ vint INTEGER : 1; teledb$ BEGIN teledb$ RAISE EXCEPTION '程序EXCEPTION '; teledb$ 下面的语句不会再执行 teledb$ RAISE NOTICE 'vint %, 随机数 %',vint,random(); teledb$ END; teledb$ $$ teledb LANGUAGE plpgsql; CREATE FUNCTION teledb SELECT f28(); ERROR: 程序EXCEPTION 如果在事务中执行这个函数，则事务会终止(abort)。 RAISE EXCEPTION自定义ERRCODE plaintext teledb CREATE OR REPLACE FUNCTION f28() RETURNS VOID AS teledb $$ teledb$ DECLARE teledb$ vint INTEGER : 1; teledb$ BEGIN teledb$ RAISE EXCEPTION ' 程序EXCEPTION ' USING ERRCODE '23505'; teledb$ END; teledb$ $$ teledb LANGUAGE plpgsql; CREATE FUNCTION teledb

$$ teledb$ DECLARE teledb$ vtxt1 TEXT COLLATE "C" : '天'; teledb$ vtxt2 TEXT COLLATE "C" : '翼'; teledb$ BEGIN teledb$ IF vtxt1 > vtxt2 THEN teledb$ RAISE NOTICE ' % > % ',vtxt1,vtxt2; teledb$ ELSE teledb$ RAISE NOTICE ' % > % ',vtxt2,vtxt1; teledb$ END IF; teledb$ END; teledb$ $$ teledb LANGUAGE plpgsql; CREATE FUNCTION teledb SELECT f25(); NOTICE: 翼 > 天 f25 (1 row) teledb select '天'::bytea; bytea xe5a4a9 (1 row) teledb select '翼'::bytea; bytea xe7bfbc (1 row) teledb 按汉字的拼音对比大小。 plaintext teledb CREATE OR REPLACE FUNCTION f25() RETURNS VOID AS teledb $$ teledb$ DECLARE teledb$ vtxt1 TEXT COLLATE "zhCN.utf8" : '天'; teledb$ vtxt2 TEXT COLLATE "zhCN.utf8" : '翼'; teledb$ BEGIN teledb$ IF vtxt1 > vtxt2 THEN teledb$ RAISE NOTICE ' % > % ',vtxt1,vtxt2; teledb$ ELSE teledb$ RAISE NOTICE ' % > % ',vtxt2,vtxt1; teledb$ END IF; teledb$ END; teledb$ $$ teledb LANGUAGE plpgsql; CREATE FUNCTION teledb SELECT f25(); NOTICE: 翼 > 天 f25 (1 row) 变量赋值 plaintext teledb CREATE OR REPLACE FUNCTION f25() RETURNS VOID AS teledb

Schema Name Type Owner Table Size Allocated Size Description +++++++ public tsexsexidx index teledb tsex 14 MB 14 MB