本页介绍天翼云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数据库修改存储过程名称的语法。 修改不带参数的存储过程名称 plaintext teledb CREATE OR REPLACE PROCEDURE proc1() AS $$ begin raise notice 'Hello telebdxpg'; end; $$ LANGUAGE PLPGSQL; CREATE PROCEDURE teledb alter procedure proc1() rename to proc11; ALTER PROCEDURE teledb 修改带参数的存储过程名称 plaintext teledb CREATE OR REPLACE PROCEDURE proc1(aint int) AS $$ begin raise notice '%',aint; end; $$ LANGUAGE PLPGSQL; CREATE PROCEDURE teledb alter procedure proc1 (aint int) rename to proc11; ALTER PROCEDURE

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

drop table t1; DROP TABLE teledb drop sharding in group defaultgroup; DROP SHARDING GROUP teledb drop node group defaultgroup; DROP NODE GROUP 修改存储组 修改存储组只能将存储组定义为默认存储组，语法如下 plaintext alter node group groupname set to default; 当已存在默认存储组的情况下，此语句无法生效 plaintext 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 查看存储组相关信息 plaintext teledb select oid, from pgxcgroup; oid groupname defaultgroup groupmembers +++ 57353 group2 0 16386 57352 group1 1 16385

f1 f2 + 1 1 1 2 1

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

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

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

本文为您介绍如何删除数据表。 删除当前模式下的数据表。 plaintext teledb drop table t; DROP TABLE 删除某个模式下数据表。 plaintext teledb d+ t Table "public.t" Column Type Collation Nullable Default Storage Stats target Description +++++++ id integer plain mc text extended Distribute By: SHARD(id) Location Nodes: ALL DATANODES teledb d+ tas Table "public.tas" Column Type Collation Nullable Default Storage Stats target Description +++++++ id integer plain mc text extended Distribute By: SHARD(id) Location Nodes: ALL DATANODES teledb drop table public.test; DROP TABLE 删除数据表，不存在时不执行，不报错。 plaintext teledb drop table IF EXISTS t; NOTICE: table "t" does not exist, skipping DROP TABLE 使用CASCADE无条件删除数据表。 plaintext teledb create view shardview as select from testshard; CREATE VIEW teledb drop table testshard; ERROR: cannot drop table testshard because other objects depend on it DETAIL: view shardview depends on table testshard HINT: Use DROP ... CASCADE to drop the dependent objects too. teledb drop table testshard cascade; NOTICE: drop cascades to view shardview DROP TABLE

本文为您介绍如何使用条件索引。 plaintext 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数据库删除存储过程的语法。 删除不带参数的存储过程 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数据库使用[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数据库建立存储的语法。 plaintext CREATE [OR REPLACE] PROCEDURE [模式名.]存储过程 ([参数模式 [参数名] 数据类型 [default 默认值] [,…]]) AS [标签] [DECLARE 变量定义] BEGIN 注释 /注释/ 语句执行 END; [标签] LANGUAGE PLPGSQL;

本页介绍天翼云TeleDB数据库Oracle语法中的二进制操作函数。 emptyclob 需要加载插件teledbxoraclepackagefunction plaintext create extension teledboraclepackagefunction; 初始化CLOB 字段。 plaintext teledb select emptyclob(); emptyclob (1 row) teledb create table t1 (f1 int,f2 clob); CREATE TABLE teledb insert into t1(f1,f2) values (1,emptyclob()); INSERT 0 1 teledb

deptno listagg + 20 aaa,bbb,ccc 21 ddd,eee

rowidtochar rowid + XPK3fwAQAAAAAAAAA XPK3fwAQAAAAAAAAA

本页介绍天翼云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数据库PL/pgsql控制结构中的错误俘获处理和相关信息。 错误俘获处理 plaintext teledb CREATE TABLE texception (id integer not null,nc text); CREATE TABLE teledb create unique index texceptioniduidx on texception using btree(id); CREATE INDEX teledb CREATE OR REPLACE FUNCTION f27(aid integer,anc text) RETURNS TEXT AS teledb $$ teledb$ BEGIN teledb$ INSERT INTO texception VALUES(aid,anc); teledb$ RETURN ''; teledb$ EXCEPTION WHEN OTHERS THEN teledb$ RETURN '执行出错'; teledb$ END; teledb$ $$ teledb LANGUAGE plpgsql; CREATE FUNCTION teledb SELECT f27(1,'teledbpg'); f27 (1 row) teledb SELECT f27(1,'teledbpg'); f27 执行出错 (1 row) 获取错误相关信息 plaintext teledb CREATE OR REPLACE FUNCTION f27(aid integer,anc text) RETURNS TEXT AS teledb $$ teledb$ DECLARE teledb$ vsqlstate text; teledb$ vcontext text; teledb$ vmessagetext text; teledb$ BEGIN teledb$ INSERT INTO texception VALUES(aid,anc); teledb$ RETURN ''; teledb$ EXCEPTION WHEN OTHERS THEN teledb$ GET STACKED DIAGNOSTICS vsqlstate RETURNEDSQLSTATE, teledb$ vmessagetext MESSAGETEXT, teledb$ vcontext PGEXCEPTIONCONTEXT; teledb$ RAISE NOTICE '错误代码 : %',vsqlstate; teledb$ RAISE NOTICE '出错信息 : %',vmessagetext; teledb$ RAISE NOTICE '发生异常语句 : %',vcontext; teledb$ RETURN '错误代码 : 'vsqlstate 'n出错信息 : 'vmessagetext '发生异常语句 : 'vcontext; teledb$

本页介绍天翼云TeleDB数据库的Oracle GUC参数配置。 session中生效 plaintext SET enableoraclecompatible to ON; 配置某个库默认生效 plaintext alter database teledb set enableoraclecompatible to on; 配置某个用户默认生效 plaintext alter role admin set enableoraclecompatible to on;

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

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

本页介绍天翼云TeleDB数据库的命名规范。 1. DB object：database， schema， table， column， view， index， sequence， function， trigger 等名称。 建议使用小写字母、数字、下划线的组合。 建议不使用双引号即"包围，除非必须包含大写字母或空格等特殊字符。 长度不能超过63个字符。 不建议以pg 开头或者 pgxc（避免与系统 DB object 混淆），不建议以数字开头。 禁止使用SQL 关键字，如 type， order 等。 2. table 能包含的 column 数目，根据字段类型的不同，数目在250到1600之间。 3. 临时或备份的DB object：table、view 等，建议加上日期， 如 dbaops.b2cproductsummay20140712 (其中 dbaops 为 DBA 专用 schema)。 4. index命名规则为：普通索引为 表名列名idx，唯一索引为 表名列名uidx，如 studentnameidx，studentiduidx。

本文介绍只查询某个DN数据的操作。 plaintext teledb execute direct on (dn01) 'select from teledbpg'; id nickname + 1 teledb 1 hello,pgxc 2 TELEDB (3 rows) teledb execute direct on (dn02) 'select from teledbpg'; id nickname + 3 pg 4 (2 rows)

本文为您介绍SELECT语法的特殊应用场景，例如多行变成单行和一列变成多行。 多行变成单行 plaintext teledb select arraytostring(array(select nickname from teledbpg1),','); arraytostring test,pg (1 row) 一列变成多行 plaintext teledb insert into teledbpg1 values(6, 'teledb, teledb1'); INSERT 0 1 teledb select regexpsplittotable((select nickname from teledbpg1 where id6 limit 1), ','); regexpsplittotable teledb teledb1 (2 rows)

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

本文介绍如何在使用SELECT语法时进行聚合函数并发计算。 plaintext teledb set maxparallelworkerspergather to 0; SET Time: 0.214 ms teledb select count(1) from tcount; count 20000000 (1 row) Time: 2700.569 ms (00:02.701) teledb set maxparallelworkerspergather to 2; SET Time: 0.269 ms teledb select count(1) from tcount; count 20000000 (1 row) Time: 1867.719 ms (00:01.868)

本文介绍如何在使用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)

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

explain select from ginmul where f12 and f3'20190218 16:59:52.872523'; QUERY PLAN Remote Fast Query Execution (cost0.00..0.00 rows0 width0) Node/s: dn01 > Bitmap Heap Scan on ginmul (cost36.00..40.02 rows1 width90) Recheck Cond: ((f1 2) AND (f3 '20190218 16:59:52.872523'::timestamp without time zone)) > Bitmap Index Scan on ginmulginidx (cost0.00..36.00 rows1 width0) Index Cond: ((f1 2) AND (f3 '20190218 16:59:52.872523'::timestamp without time zone)) (6 rows) 三字段组合索引 plaintext teledb explain select from ginmul where f12 and f3'20190218 16:59:52.872523' and f6'fa627dc16c2bd026150afa0453a0991d'; QUERY PLAN Remote Fast Query Execution (cost0.00..0.00 rows0 width0) Node/s: dn01 > Bitmap Heap Scan on ginmul (cost52.00..56.02 rows1 width90) Recheck Cond: ((f1 2) AND (f3 '20190218 16:59:52.872523'::timestamp without time zone) AND (f6 'fa627dc16c2bd026150afa0453a0991d'::text)) > Bitmap Index Scan on ginmulginidx (cost0.00..52.00 rows1 width0) Index Cond: ((f1 2) AND (f3 '20190218 16:59:52.872523'::timestamp without time zone) AND (f6 'fa627dc16c2bd026150afa0453a0991d'::text)) (6 rows)

本文为您介绍如何管理表达式索引。 plaintext teledb create table tupper(id int,mc text); CREATE TABLE teledb create index tuppermc on tupper(mc); CREATE INDEX teledb insert into tupper select t,md5(t::text) from generateseries(1,10000) as t; INSERT 0 10000 teledb analyze tupper; ANALYZE teledb explain select from tupper where upper(mc)md5('1'); QUERY PLAN Remote Fast Query Execution (cost0.00..0.00 rows0 width0) Node/s: dn01, dn02 > Seq Scan on tupper (cost0.00..133.58 rows25 width37) Filter: (upper(mc) 'c4ca4238a0b923820dcc509a6f75849b'::text) (4 rows) teledb create index tuppermc on tupper(upper(mc)); ERROR: relation "tuppermc" already exists teledb create index tuppermc1 on tupper(upper(mc)); CREATE INDEX teledb explain select from tupper where upper(mc)md5('1'); QUERY PLAN Remote Fast Query Execution (cost0.00..0.00 rows0 width0) Node/s: dn01, dn02 > Bitmap Heap Scan on tupper (cost4.48..50.94 rows25 width37) Recheck Cond: (upper(mc) 'c4ca4238a0b923820dcc509a6f75849b'::text) > Bitmap Index Scan on tuppermc1 (cost0.00..4.47 rows25 width0) Index Cond: (upper(mc) 'c4ca4238a0b923820dcc509a6f75849b'::text) (6 rows)

本页介绍天翼云TeleDB数据库的命名规范。 1. DB object：database， schema， table， column， view， index， sequence， function， trigger 等名称。 建议使用小写字母、数字、下划线的组合。 建议不使用双引号即"包围，除非必须包含大写字母或空格等特殊字符。 长度不能超过63个字符。 不建议以pg 开头或者 pgxc（避免与系统 DB object 混淆），不建议以数字开头。 禁止使用SQL 关键字，如 type， order 等。 2. table 能包含的 column 数目，根据字段类型的不同，数目在250到1600之间。 3. 临时或备份的DB object：table、view 等，建议加上日期， 如 dbaops.b2cproductsummay20140712 (其中 dbaops 为 DBA 专用 schema)。 4. index命名规则为：普通索引为 表名列名idx，唯一索引为 表名列名uidx，如 studentnameidx，studentiduidx。

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