本页介绍天翼云TeleDB数据库的Index设计规范。 1. TeleDB提供的index类型：Btree，Hash，GiST (Generalized Search Tree)，SPGiST (spacepartitioned GiST)，GIN (Generalized Inverted Index)，BRIN (Block Range Index)，目前不建议使用Hash，通常情况下使用Btree。 2. 建议create或drop index时，加CONCURRENTLY参数，达到与写入数据并发的效果。 3. 建议对于频繁update， delete的包含于index定义中的column的table， 用create index CONCURRENTLY，drop index CONCURRENTLY的方式进行维护其对应index。 4. 建议用unique index代替unique constraints，便于后续维护。 5. 建议对where中带多个字段and条件的高频query，参考数据分布情况，建多个字段的联合index。 6. 建议对固定条件的（一般有特定业务含义）且选择时数据占比低的query，建议带 where的Partial Indexes。 plaintext select from test where status1 and col?; 其中status1为固定的条件 create index on test (col) where status1; 7. 建议对经常使用表达式作为查询条件的query，可以使用表达式或函数索引加速 query。 plaintext select from test where exp(xxx); create index on test ( exp(xxx) ); 8. 建议不要建过多index，一般不要超过6个，核心table（产品，订单）可适当增加 index个数。

本页介绍天翼云TeleDB数据库中关于NULL的判断和处理方案。 1. NULL的判断：IS NULL，IS NOT NULL。 注意 boolean 类型取值 true，false，NULL。 NOT IN 集合中带有 NULL 元素。 plaintext teledb select from toids; id name birth city +++ 1 张三 20001201 00:00:00 北京 2 李四 19970324 00:00:00 上海 3 王五 20040901 00:00:00 广州 (3 rows) teledb select from toids where id not in (null); id name birth city +++ (0 rows) 2. 建议对字符串型NULL 值处理后，再进行 操作。 plaintext teledb select id,name from toids limit 1; id name + 1 张三 (1 row) teledb select id,namenull from toids limit 1; id ?column? + 1 (1 row) teledb select id,name coalesce(null,'') from toids limit 1; id ?column? + 1 张三 (1 row) 注意 开启oracle兼容后，可无需处理。 plaintext teledb set enableoraclecompatible to on; SET teledb select id,namenull from toids limit 1; id ?column? + 1 张三 (1 row) 3. 建议使用count(1) 或 count() 来统计行数，而不建议使用 count(col) 来统计行数，因为 NULL 值不会计入。 说明 count(多列列名)时，多列列名必须使用括号，例如count( (col1，col2，col3) )，注意多列的count，即使所有列都为NULL，该行也被计数，所以效果与count()一致。 plaintext teledb

本文为您介绍如何使用gist 索引。 注意 此功能需加载插件pgtrgm。 plaintext 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

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

本页介绍天翼云TeleDB数据库存储过程执行的语法。 不带参数 plaintext teledb create or replace procedure pnopara() as $$ begin raise notice 'nopara procedure'; end; $$ language plpgsql; CREATE PROCEDURE teledb call pnopara(); NOTICE: nopara procedure CALL teledb 带参数 plaintext teledb create or replace procedure ppara(aint integer) as $$ begin raise notice 'aint %',aint; end; $$ language plpgsql; CREATE PROCEDURE teledb call ppara(1); NOTICE: aint 1 CALL teledb

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

本页介绍天翼云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语法中的表达式函数。 lnnvl 传入表达式为true返回false；传入为false返回true。 plaintext teledb create table tlnnvl(f1 integer, f2 integer); CREATE TABLE teledb insert into tlnnvl values(1,1); INSERT 0 1 teledb insert into tlnnvl values(1,2); INSERT 0 1 teledb insert into tlnnvl values(1,3); INSERT 0 1 teledb insert into tlnnvl values(1,4); INSERT 0 1 teledb insert into tlnnvl values(1,null); INSERT 0 1 teledb select from tlnnvl where lnnvl(f2>2); f1 f2 + 1 1 1 2 1 (3 rows) teledb nvl2 NVL2(E1, E2, E3) 如果E1为NULL，则函数返回E3，若E1不为null，则返回E2。 plaintext teledb select NVL2('teledb', 'teledb1'::text, 'teledb2'::text) from dual; nvl2 teledb1 (1 row) teledb select NVL2(NULL, 'teledb1'::text, 'teledb2'::text) from dual; nvl2 teledb2 (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)

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

本页介绍天翼云TeleDB数据库的COLUMN设计规范。 建议能用数值类型的，就不用字符类型。 建议能用varchar(N)就不用char(N)，以利于节省存储空间。 建议能用varchar(N)就不用text，varchar。 建议使用default NULL，而不用 default ''，以节省存储空间。 建议如有国际货业务的话，使用timestamp with time zone(timestamptz)，而不用 timestamp without time zone，避免时间函数在对于不同时区的时间点返回值不同，也为业务国际化扫清障碍。 建议使用NUMERIC(precision，scale)来存储货币金额和其它要求精确计算的数值， 而不建议使用real，double precision。

本文为您介绍 json和jsonb。 本产品支持非关系数据类型JSON，JSON 数据类型是用来存储JSON（JavaScript Object Notation）数据的。这种数据也可以被存储为text，但是JSON数据类型的优势在于能强制要求每个被存储的值符合JSON规则。 也有很多JSON相关的函数和操作符可以用于存储在这些数据类型中的数据。JSON数据类型有json 和jsonb。它们接受完全相同的值集合作为输入。主要的实际区别是效率。json数据类型存储输入文本的精准拷贝，处理函数必须在每次执行时必须重新解析该数据。而jsonb数据被存储在一种分解好的二进制格式中，它在输入时要稍慢一些，因为需要做附加的转换。但是jsonb在处理时要快很多，因为不需要解析。jsonb也支持索引，这也是一个令人瞩目的优势。

本文为您介绍如何增加一个复合类型。 增加一个复合类型 plaintext teledb create type mytype as (f1 int,f2 varchar(10)); CREATE TYPE

本页为您介绍如何使用使用 IF NOT EXISTS关键字。 带IF NOT EXISTS 关键字作用表示表不存在时才创建。 plaintext teledb create table t(id int,mc text); CREATE TABLE teledb create table t(id int,mc text); ERROR: relation "t" already exists teledb create table IF NOT EXISTS t(id int,mc text); NOTICE: relation "t" already exists, skipping CREATE TABLE

本页介绍天翼云TeleDB数据库的复制表功能。 复制表是所有DN 节点都存储一份相同的数据。 plaintext teledb create table trep (id int,mc text) distribute by replication; CREATE TABLE teledb d+ trep Table "public.trep" Column Type Collation Nullable Default Storage Stats target Description +++++++ id integer plain mc text extended Distribute By: REPLICATION Location Nodes: ALL DATANODES 所有节点都会保存一份数据 plaintext teledb insert into trep values(1,'teledb'),(2,'ctyun'); COPY 2 teledb EXECUTE DIRECT ON (dn01) 'select from trep'; id mc + 1 teledb 2 ctyun (2 rows) teledb EXECUTE DIRECT ON (dn02) 'select from trep'; id mc + 1 teledb 2 ctyun (2 rows)

本文为您介绍如何修改模式属性。 修改模式名 plaintext teledb alter schema teledbschema rename to teledbschemanew; ALTER SCHEMA 修改所有者 plaintext teledb dn teledbschemanew List of schemas Name Owner + teledbschemanew teledb (1 row) teledb alter schema teledbschemanew owner to teledbuser; ALTER SCHEMA teledb dn teledbschemanew List of schemas Name Owner + teledbschemanew teledbuser (1 row)

本文为您介绍创建数据库的相关操作。 要创建一个数据库，必须是一个超级用户或者具有特殊的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

本文为您介绍如何删除数据库。 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

大批量的生成数据 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)

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)

本文为您介绍如何修改数据库配置。 修改数据库名称 plaintext teledb alter database teledbdb rename to teledbdbnew; ALTER DATABASE 修改连接数 plaintext teledb alter database teledbdbnew connection limit 50; ALTER DATABASE 修改数据库所有者 plaintext teledb alter database teledbdbnew owner to teledb; ALTER DATABASE 配置数据默认searchpath plaintext teledb alter database teledbdbnew set searchpath to public, pgcatalog; ALTER DATABASE alter database不支持修改的项目 项目 备注 encoding 编码 lccollate 排序规则 lcctype 分组规则

本页介绍天翼云TeleDB数据库删除存储过程的语法。 删除不带参数的存储过程 plaintext teledb CREATE OR REPLACE PROCEDURE proc1() AS $$ begin raise notice 'Hello teledbpg'; end; $$ LANGUAGE PLPGSQL; CREATE PROCEDURE teledb drop procedure proc1 ( ); DROP PROCEDURE teledb 删除带参数的存储过程 plaintext teledb CREATE OR REPLACE PROCEDURE proc1(aint int) AS $$ begin raise notice '%',aint; end; $$ LANGUAGE PLPGSQL; CREATE PROCEDURE teledb drop procedure proc1 ( aint int); DROP PROCEDURE teledb 也可以只指定参数的类型即可。 plaintext teledb drop procedure proc1 (int); DROP PROCEDURE teledb

本页介绍天翼云TeleDB数据库修改存储过程所属schema的语法。 修改不带参数的存储过程schema plaintext teledb CREATE OR REPLACE PROCEDURE public.proc1() AS $$ begin raise notice 'Hello teledbpg'; end; $$ LANGUAGE PLPGSQL; CREATE PROCEDURE teledb teledb alter procedure public.proc1() set schema myche; ALTER PROCEDURE teledb 修改带参数的存储过程schema plaintext teledb CREATE OR REPLACE PROCEDURE public.proc1(aint int) AS $$ begin raise notice '%',aint; end; $$ LANGUAGE PLPGSQL; CREATE PROCEDURE teledb alter procedure public.proc1 (int) set schema myche; ALTER PROCEDURE teledb

FOREACH vrandom SLICE 0 IN ARRAY vrandomarr LOOP teledb$ RAISE NOTICE '%',vrandom ; teledb$ END LOOP; teledb$ END; teledb$ $$ teledb LANGUAGE plpgsql; CREATE FUNCTION teledb SELECT f27(); NOTICE: 0.0588191924616694 NOTICE: 0.368828620761633 NOTICE: 0.813376842066646 NOTICE: 0.415377039927989 f27 (1 row) 循环会通过计算expression得到的数组的个体元素进行迭代。 plaintext teledb CREATE OR REPLACE FUNCTION f27() RETURNS VOID AS teledb $$ teledb$ DECLARE teledb$ vrandomarr float8[][]:ARRAY[ARRAY[random(),random()],ARRAY[random(),random()]]; teledb$ vrandom float8[]; teledb$ BEGIN teledb$ FOREACH vrandom SLICE 1 IN ARRAY vrandomarr LOOP teledb$ RAISE NOTICE '%',vrandom ; teledb$ END LOOP; teledb$ END; teledb$ $$ teledb LANGUAGE plpgsql; CREATE FUNCTION teledb SELECT f27(); NOTICE: {0.578366641886532,0.78098024148494} NOTICE: {0.783956411294639,0.450278480071574} f27 (1 row) 通过一个正SLICE值，FOREACH通过数组的切片而不是单一元素迭代。

本页介绍天翼云TeleDB数据库的复制表功能。 复制表是所有DN 节点都存储一份相同的数据。 plaintext teledb create table trep (id int,mc text) distribute by replication; CREATE TABLE teledb d+ trep Table "public.trep" Column Type Collation Nullable Default Storage Stats target Description +++++++ id integer plain mc text extended Distribute By: REPLICATION Location Nodes: ALL DATANODES 所有节点都会保存一份数据 plaintext teledb insert into trep values(1,'teledb'),(2,'ctyun'); COPY 2 teledb EXECUTE DIRECT ON (dn01) 'select from trep'; id mc + 1 teledb 2 ctyun (2 rows) teledb EXECUTE DIRECT ON (dn02) 'select from trep'; id mc + 1 teledb 2 ctyun (2 rows)

本页介绍天翼云TeleDB数据库PL/pgsql函数的参数引用方法。 PL/pgsql函数的参数是以$1,$2这样标识符来进行传递，也支持命名参数，所以参数的定义可以用下面的方式。 无命名参数 plaintext teledb CREATE OR REPLACE FUNCTION f2(text) RETURNS TEXT AS teledb $$ teledb$ BEGIN teledb$ RETURN $1; teledb$ END; teledb$ $$ teledb LANGUAGE PLPGSQL; CREATE FUNCTION teledb SELECT FROM f2('teledb'); f2 teledb (1 row) 给标识符指定别名 plaintext teledb CREATE OR REPLACE FUNCTION f2(text) RETURNS TEXT AS teledb $$ teledb$ DECLARE teledb$ axm ALIAS FOR $1; axm是$1的别名 teledb$ BEGIN teledb$ RETURN axm; teledb$ END; teledb$ $$ teledb LANGUAGE PLPGSQL teledb ; CREATE FUNCTION teledb SELECT FROM f2('teledb'); f2 teledb (1 row) 命名参数 plaintext teledb CREATE OR REPLACE FUNCTION f2(axm text) RETURNS TEXT AS teledb $$ teledb$ DECLARE teledb$ vxm ALIAS FOR $1; teledb$ BEGIN teledb$ RAISE NOTICE 'axm % ; vxm % ; $1 %',axm,vxm,$1; teledb$ RETURN $1; teledb$ END; teledb$ $$ teledb LANGUAGE PLPGSQL; CREATE FUNCTION teledb SELECT FROM f2('teledb'); NOTICE: axm teledb ; vxm teledb ; $1 teledb f2 teledb (1 row)

本页介绍天翼云TeleDB数据库PL/pgsql函数的返回值。 返回值可以是一个简单数据类型、复合类型、RECORD、已经存在的表行类型、表字段类型、游标、另外还可以返回一个记录集、如果不需要返回值，则可以用RETURN void。返回值的字段名及类型可以在参数OUT、INOUT模式中声明。

本页介绍天翼云TeleDB数据库中关于NULL的判断和处理方案。 1. NULL的判断：IS NULL，IS NOT NULL。 注意 boolean 类型取值 true，false，NULL。 NOT IN 集合中带有 NULL 元素。 plaintext teledb select from toids; id name birth city +++ 1 张三 20001201 00:00:00 北京 2 李四 19970324 00:00:00 上海 3 王五 20040901 00:00:00 广州 (3 rows) teledb select from toids where id not in (null); id name birth city +++ (0 rows) 2. 建议对字符串型NULL 值处理后，再进行 操作。 plaintext teledb select id,name from toids limit 1; id name + 1 张三 (1 row) teledb select id,namenull from toids limit 1; id ?column? + 1 (1 row) teledb select id,name coalesce(null,'') from toids limit 1; id ?column? + 1 张三 (1 row) 注意 开启oracle兼容后，可无需处理。 plaintext teledb set enableoraclecompatible to on; SET teledb select id,namenull from toids limit 1; id ?column? + 1 张三 (1 row) 3. 建议使用count(1) 或 count() 来统计行数，而不建议使用 count(col) 来统计行数，因为 NULL 值不会计入。 说明 count(多列列名)时，多列列名必须使用括号，例如count( (col1，col2，col3) )，注意多列的count，即使所有列都为NULL，该行也被计数，所以效果与count()一致。 plaintext teledb

本页介绍天翼云TeleDB数据库的COLUMN设计规范。 建议能用数值类型的，就不用字符类型。 建议能用varchar(N)就不用char(N)，以利于节省存储空间。 建议能用varchar(N)就不用text，varchar。 建议使用default NULL，而不用 default ''，以节省存储空间。 建议如有国际货业务的话，使用timestamp with time zone(timestamptz)，而不用 timestamp without time zone，避免时间函数在对于不同时区的时间点返回值不同，也为业务国际化扫清障碍。 建议使用NUMERIC(precision，scale)来存储货币金额和其它要求精确计算的数值， 而不建议使用real，double precision。

本文为您介绍如何修改模式属性。 修改模式名 plaintext teledb alter schema teledbschema rename to teledbschemanew; ALTER SCHEMA 修改所有者 plaintext teledb dn teledbschemanew List of schemas Name Owner + teledbschemanew teledb (1 row) teledb alter schema teledbschemanew owner to teledbuser; ALTER SCHEMA teledb dn teledbschemanew List of schemas Name Owner + teledbschemanew teledbuser (1 row)

本文为您介绍如何删除模式。 plaintext teledb drop schema teledbschemaowner; DROP SCHEMA 当模式中存在对象时，则会删除失败，提示如下。 plaintext teledb create table teledbschemanew.test(id int); CREATE TABLE teledb drop schema teledbschemanew; ERROR: cannot drop schema teledbschemanew because other objects depend on it DETAIL: table teledbschemanew.test depends on schema teledbschemanew HINT: Use DROP ... CASCADE to drop the dependent objects too. 参考如下强制删除，会将模式中的对象也级联删除掉。 plaintext teledb drop schema teledbschemanew cascade; NOTICE: drop cascades to table teledbschemanew.test DROP SCHEMA

本文为您介绍如何创建唯一索引。 创建唯一索引 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.