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

id nickname + 4

本文为您介绍SELECT语法中多表关联的使用方法。 内连接 plaintext teledb select from teledbpg inner join teledbpg1 on teledbpg.id teledbpg1.id; id nickname id nickname +++ 3 pg 3 pg (1 row) 左外连接 plaintext teledb select from teledbpg left join teledbpg1 on teledbpg.id teledbpg1.id; id nickname id nickname +++ 1 teledb 1 hello,pgxc 2 TELEDB 3 pg 3 pg 4 (5 rows) 右外连接 plaintext teledb select from teledbpg right join teledbpg1 on teledbpg.id teledbpg1.id; id nickname id nickname +++ 5 test 3 pg 3 pg (2 rows) 全连接 plaintext teledb select from teledbpg full join teledbpg1 on teledbpg.id teledbpg1.id; id nickname id nickname +++ 1 teledb 3 pg 3 pg 4 1 hello,pgxc 2 TELEDB 5 test (6 rows)

本页介绍天翼云TeleDB数据库PL/pgsql函数的参数模式。 参数模式总共有三种，分别是IN(传入参数，这个是默认方式)、OUT(返回值参数)、INOUT(传入返回值参数)，下面介绍这几个参数模式的用法。 IN 模式 IN 模式指的是执行函数时需要输入参数值，如下所示。 plaintext teledb CREATE OR REPLACE FUNCTION f1(IN axm text) RETURNS TEXT AS teledb $$ teledb$ BEGIN teledb$ RETURN axm; teledb$ END; teledb$ $$ teledb LANGUAGE PLPGSQL; CREATE FUNCTION teledb SELECT f1('teledb'); f1 teledb (1 row) teledb CREATE OR REPLACE FUNCTION f1(axm text) RETURNS TEXT AS $$ BEGIN RETURN axm; END; $$ LANGUAGE PLPGSQL; CREATE FUNCTION teledb SELECT from f1('teledb'); f1 teledb (1 row) 上面两种方式定义的参数效果是一样的。 OUT 模式 OUT 模式参数是指定了函数执行时返回的字段名及类型。 plaintext teledb CREATE OR REPLACE FUNCTION f1(OUT axm text) RETURNS TEXT AS teledb $$ teledb$ BEGIN teledb$ axm: 'teledb'; teledb$ END; teledb$ $$ teledb LANGUAGE PLPGSQL; CREATE FUNCTION teledb teledb SELECT from f1(); axm teledb (1 row) 采用OUT模式参数不能用 RETURN 返回，而是要对返回的OUT参数直接赋值。返回值类型与参数的数据类型必需一致。参数名就是返回的字段名。 INOUT 模式 INOUT模式是指参数即传入，同时又指定了返回值的字段名和类型。 plaintext teledb

与SQL Server对照表 SQL Server TeleDB int int smallint smallint bigint bigint tinyint smallint real real float double precision numeric numeric bit bit char char nchar char varchar varchar nvarchar varchar text text ntext text date date time time datetime timestamp datetime2 timestamp smalldatetime timestamp datetimeoffset timestamp uniqueidentifier uuid image bytea binary bytea varbinary bytea

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

本文为您介绍如何创建shard表。 不指定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 分布键选择原则： 分布键只能选择一个字段。 如果有主键，则选择主键做分布键。 如果主键是复合字段组合，则选择字段值选择性多的字段做分布键。 也可以把复合字段拼接成一个新的字段来做分布键。 没有主键的可以使用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 用于指定存储组（每个存储组可以有多个节点）。 分布键字段值不能修改，字段长度不能修改，字段类型不能修改。

Schema Name Type Owner +++ public t2 table teledb

本文介绍使用SELECT语法时，not in中包含了null，结果全为真的场景。 plaintext teledb select from teledbpg where id not in (1,3); id nickname + 2 TELEDB 4 (2 rows) teledb select from teledbpg where id not in (1,3,null); id nickname + (0 rows)

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

limit x offset 1 如果参数enableoraclecompatible配置为on，则offset 1表示从第一条提取记录。 plaintext teledb select from test1; id name + 1 test1 2 test2 3 test2 4 test2 5 test2 (5 rows) teledb select from test1 limit 5 offset 1; id name + 1 test1 2 test2 3 test2 4 test2 5 test2 teledb dml 操作加强 select支持别名不用as修饰 plaintext teledb create table student(f1 int,f2 int); CREATE TABLE teledb insert into student values(1,1); INSERT 0 1 teledb select from student as st where st.f11; f1 f2 + 1 2 (1 row) teledb select from student st where st.f11; f1 f2 + 1 2 update支持别名 需要打开enableoraclecompatible plaintext teledb set enableoraclecompatible to on; SET teledb create table student(f1 int,f2 int); CREATE TABLE teledb insert into student values(1,1); INSERT 0 1 teledb update student st set st.f22 where f11; UPDATE 1 teledb select from student ; f1 f2 + 1 2 实际 teledb UPDATE student st SET st.f2 2 WHERE st.f1 1; ERROR: column "st" of relation "student" does not exist LINE 2: SET st.f2 2

select from teledbpg where exists(select from person where person.id teledbpg.id); id nickname + 1 teledb 1 hello,pgxc 2 TELEDB 3 pg (4 rows) exists 等价写法 plaintext teledb select teledbpg. from teledbpg, (select distinct id from person) as t where t.id teledbpg.id; id nickname + 1 teledb 1 hello,pgxc 2 TELEDB 3 pg (4 rows)

create table tnlssort(f1 integer,f2 varchar2(10)); CREATE TABLE teledb insert into tnlssort values(1,'天翼云'); INSERT 0 1 teledb insert into tnlssort values(2,'广州'); INSERT 0 1 teledb insert into tnlssort values(3,'中国'); INSERT 0 1 teledb SELECT FROM tnlssort ORDER BY NLSSORT(f2,'NLSSORT SCHINESEPINYINM'); f1 f2 + 1 天翼云 3 中国 2 广州 (3 rows) teledb 目前TeleDB只能支持按拼音。 nlsupper 将字符转换为大写。 plaintext teledb select NLSUPPER('teledb','nlssort SCHINESEPINYINM') from dual; nlsupper TELEDB (1 row) teledb nchr 给出一个数字代码，返回其对应字符。 plaintext teledb select NCHR(116) from dual; nchr t (1 row) teledb length 获取字符长度。 plaintext teledb select length(1); length 1 (1 row) teledb select length('teledb'); length 7 (1 row) teledb select length('阿弟'); length 2 (1 row) teledb select length(12.12::numeric(10,2)); length 5 (1 row) teledb LENGTHB 返回字符的长度。 plaintext teledb select LENGTHB('测试') from dual; lengthb 6 (1 row) teledb select LENGTH('测试') from dual; length 2 (1 row) teledb

nspname prosrc + public +

本页介绍天翼云TeleDB数据库PL/pgsql控制结构中的其他控制语句。 动态执行 plaintext teledb CREATE OR REPLACE FUNCTION f27(aid INTEGER) RETURNS text AS teledb $$ teledb$ DECLARE teledb$ vsql TEXT; teledb$ vmc TEXT; teledb$ BEGIN teledb$ vsql : 'SELECT mc FROM t WHERE id'aid::TEXT; teledb$ EXECUTE vsql INTO vmc; teledb$ RETURN vmc; teledb$ END; teledb$ $$ teledb LANGUAGE plpgsql; CREATE FUNCTION teledb SELECT f27(1); f27 teledbpg (1 row) 动态执行就是拼SQL语句，然后使用EXECUTE命令执行。 执行一个没有结果的命令 plaintext teledb CREATE OR REPLACE FUNCTION f27() RETURNS void AS teledb $$ teledb$ BEGIN teledb$ perform f27(1); teledb$ END; teledb$ $$ teledb LANGUAGE plpgsql; CREATE FUNCTION teledb SELECT f27(); f27 (1 row) teledb 获取执行结果 plaintext teledb DROP FUNCTION f27(INTEGER); DROP FUNCTION teledb CREATE OR REPLACE FUNCTION f27(aid INTEGER) RETURNS VOID AS teledb $$ teledb$ DECLARE teledb$ vmc TEXT; teledb$ BEGIN teledb$ SELECT mc INTO vmc FROM t WHERE idaid; teledb$ IF FOUND THEN teledb$ RAISE NOTICE '查询到记录，值为%',vmc; teledb$ ELSE teledb$ RAISE NOTICE '查不到记录' ; teledb$ END IF; teledb$ END; teledb$ $$ teledb LANGUAGE plpgsql; CREATE FUNCTION teledb

END; teledb$ $$ teledb LANGUAGE plpgsql; CREATE FUNCTION teledb SELECT f27(1,'teledbpg'); NOTICE: 错误代码 : 23505 NOTICE: 出错信息 : node:16385, error duplicate key value violates unique constraint "texceptioniduidx" NOTICE: 发生异常语句 : SQL statement "INSERT INTO texception VALUES(aid,anc)" PL/pgSQL function f27(integer,text) line 7 at SQL statement f27 错误代码: 23505n出错信息 : node:16385, error duplicate key value violates unique constraint "texceptioniduidx"发生异常语句 : SQL statement "INSERT INTO texception VALUES(aid,anc)"+ PL/pgSQL function f27(integer,text) line 7 at SQL statement (1 row)

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

aid anc + 1 teledb

SELECT FROM F6('a'); f6 a 多态类型 plaintext teledb CREATE OR REPLACE FUNCTION fany(aarg anyelement) RETURNS VOID AS $$ BEGIN RAISE NOTICE '%',aarg; END; $$ LANGUAGE PLPGSQL; CREATE FUNCTION teledb SELECT fany(1::integer); NOTICE: 1 fany (1 row) teledb SELECT fany('teledb'::TEXT); NOTICE: teledb fany (1 row) teledb SELECT fany(ROW(1,'teledb')::public.tper); NOTICE: (1,teledb) fany (1 row) teledb SELECT fany(ARRAY[1,2]::INTEGER[]); NOTICE: {1,2} fany (1 row) teledb SELECT fany(ARRAY[[1,2],[3,4],[5,6]]::INTEGER[][][]); NOTICE: {{1,2},{3,4},{5,6}} fany (1 row) 注意 多态类型参数函数调用时最好直接声明参数类型，否则有可能出错。 plaintext teledb CREATE OR REPLACE FUNCTION fany(aarg anyarray) RETURNS VOID AS $$ BEGIN RAISE NOTICE '%',aarg; END; $$ LANGUAGE PLPGSQL; CREATE FUNCTION teledb SELECT fany(ARRAY['teledb','pgxz']::TEXT[]); ERROR: function fany(text[]) is not unique LINE 1: SELECT fany(ARRAY['teledb','pgxz']::TEXT[]); ^ HINT: Could not choose a best candidate function. You might need to add explicit type casts. Anyelement参数如果写成数组，其意义就跟anyarray参数一致，所以fany(aarg anyelement)与fany(aarg anyarray)在调用fany(ARRAY[1,2])时就会出现函数不是唯一化的错误(ERROR: function fany(…) is not unique)提示。 参数默认值 PL/pgsql扩展语言函数支持给参数设置默认值。 plaintext teledb