7.3. SQL 语法

7.3.1. 查询和子查询

查询是指数据库中用来获取数据的方式，它可搭配条件限制子句（例如 WHERE），排列顺序子句（例如 ORDER BY）等语句来获取查询结果。子查询是指嵌套在一个上层查询中的查询。上层的查询一般被称为父查询或外部查询。子查询的结果作为输入传递回父查询或外部查询。父查询将这个值结合到计算中，以便确定最后的输出。 SQL 语言允许多层嵌套查询，即一个子查询中还可以嵌套其他子查询。同时，子查询可以出现在 SQL 语句中的各种子句中，例如 SELECT 语句、FROM 语句和 WHERE 语句等。

请参考Oracle2LightDB-Oracle：: 查询和子查询

以下是和Oracle2LightDB-Oracle有差异的部分语法：

7.3.1.1. AS作为别名

警告

OceanBase-Oracle不支持在as作为别名的进行省略写法，建议补充完整语句，参考如下示例

示例

-- 转换前Oracle SQL:
SELECT 0 as, 1 as,2 "as", 3 a, 4 as b, count(*) as FROM dual;
0AS|1AS|as|A|B|COUNT(*)AS|
---+---+--+-+-+----------+
  0|  1| 2|3|4|         1|

-- 建议使用修改上述语句为
SELECT 0 as "as", 1 as "as",2 as "as", 3 a, 4 as b, count(*) as "as" FROM dual;

7.3.2. 伪列

伪列（Pseudocolumn）的行为与表中的列相同，但并未存储具体数值。因此，伪列只具备读属性，不可以对伪列进行插入、更新、删除的等行为。本节主要介绍统一SQL 所支持的伪列及使用说明。

请参考Oracle2LightDB-Oracle：: 伪列

以下是和Oracle2LightDB-Oracle有差异的部分语法：

7.3.2.1. ROWID 伪列

ROWID 伪列提供了快速定位表中某一行的能力，ROWID 值由主键编码得到，不会进行实际的存储。

-- 转换前Oracle SQL：
SELECT ROWID,ke.* FROM unisql_employee ke;
ROWID             |EMPLOYEE_ID|NAME |SALARY|DEPARTMENT_ID|HIRE_DATE |COMMISSION_PCT|
------------------+-----------+-----+------+-------------+----------+--------------+
AAA2fQAAMAAIbD0AAA|          1|JACK |  5000|            1|2023-01-01|          0.05|
AAA2fQAAMAAIbD0AAB|          2|TOM  | 10000|            1|2023-02-01|          0.15|
AAA2fQAAMAAIbD0AAC|          3|LINDA| 15000|            1|2023-03-01|           0.2|
AAA2fQAAMAAIbD0AAD|          4|ADA  | 20000|            2|2023-04-01|           0.1|
AAA2fQAAMAAIbD0AAE|          5|TINA | 30000|            2|2023-05-01|           0.2|
AAA2fQAAMAAIbD0AAF|          6|KATE | 50000|            3|2023-06-01|           0.3|


-- 转换后OceanBase-Oracle SQL:
SELECT ROWID,ke.* FROM unisql_employee ke;
rowid|employee_id|name |salary|department_id|hire_date |commission_pct|
+-------------------+-------------+-------+--------+---------------+------------+----------------+
| ROWID             | EMPLOYEE_ID | NAME  | SALARY | DEPARTMENT_ID | HIRE_DATE  | COMMISSION_PCT |
+-------------------+-------------+-------+--------+---------------+------------+----------------+
| *AAIKAQAAAAAAAAA= |           1 | JACK  |   5000 |             1 | 2023-01-01 |            .05 |
| *AAIKAgAAAAAAAAA= |           2 | TOM   |  10000 |             1 | 2023-02-01 |            .15 |
| *AAIKAwAAAAAAAAA= |           3 | LINDA |  15000 |             1 | 2023-03-01 |             .2 |
| *AAIKBAAAAAAAAAA= |           4 | ADA   |  20000 |             2 | 2023-04-01 |             .1 |
| *AAIKBQAAAAAAAAA= |           5 | TINA  |  30000 |             2 | 2023-05-01 |             .2 |
| *AAIKBgAAAAAAAAA= |           6 | KATE  |  50000 |             3 | 2023-06-01 |             .3 |
+-------------------+-------------+-------+--------+---------------+------------+----------------+

7.3.3. 运算符

运算符一般用于连接运算数或参数等单个数据项并返回结果。从语法上讲，运算符出现在操作数之前、操作数之后或两个操作数之间均可。本节主要介绍统一SQL 所支持的常见运算符及使用说明。

当前支持常见运算符类型：

串联运算符

7.3.3.1. 串联运算符

串联运算符 || 用于连接字符串和 CLOB 数据类型的数据。使用串联运算符连接两个字符串后会得到另一个字符串。

-- 转换前Oracle SQL:
select '成交价格高于前一日收盘价;成交价格：' || 2 * 1000.00 || '元，收盘价：' || null || '' || '   '|| 'end'|| ''  FROM DUAL;
'成交价格高于前一日收盘价;成交价格：'||2*1000.00||'元，收盘价：'||NULL||''||''||'END'||''|
------------------------------------------------------------------+
成交价格高于前一日收盘价;成交价格：2000元，收盘价：   end                                |

-- 转换后OceanBase-Oracle SQL:
SELECT '成交价格高于前一日收盘价;成交价格：'||2*1000.00||'元，收盘价：'||NULL||''||'   '||'end'||'' FROM DUAL;
'成交价格高于前一日收盘价;成交价格：'||2*1000.00||'元，收盘价：'||NULL||''||''||'END'||''|
------------------------------------------------------------------+
成交价格高于前一日收盘价;成交价格：2000元，收盘价：   end                                |

7.3.4. 字面量

字面量用于表达一个固定的数值，与常量值是同义词。许多函数和 SQL 语句都需要指定字面量，字面量也可以作为表达式和条件的一部分。

7.3.4.1. 间隔字面量

间隔字面量用来指定一段时间。统一SQL支持两种类型的间隔字面量：INTERVAL YEAR TO MONTH 和 INTERVAL DAY TO SECOND。

INTERVAL YEAR TO MONTH

语法

INTERVAL '[+|-] years-months' YEAR [(precision)] TO MONTH

描述

用来指定以年和月为单位的一段时间。

参数解释

参数	说明
years-months	years 表示年，取整数值，范围为 [0，999999999]。months 表示月，取整数值，范围为 [0 ， 11]。注意值中不允许有空格。
precision	表示 YEAR 元素的精度，默认值为 2，取值范围为 [0,9]

示例

-- 转换前Oracle SQL:
select
    INTERVAL '2-3' YEAR(1) TO MONTH,
    INTERVAL '+19-11' YEAR TO MONTH,
    INTERVAL '-21-3' YEAR(2)TO MONTH,
    INTERVAL '123456789-11' YEAR(9) TO MONTH
from dual;
INTERVAL'2-3'YEAR(1)TOMONTH|INTERVAL'19-11'YEARTOMONTH|INTERVAL'-21-3'YEAR(2)TOMONTH|INTERVAL'123456789-11'YEAR(9)TOMONTH|
---------------------------+--------------------------+-----------------------------+------------------------------------+
2-3                        |19-11                     |-21-3                        |123456789-11                        |

-- 转换后OceanBase-Oracle SQL:
select
    INTERVAL '2-3' YEAR(1) TO MONTH,
    INTERVAL '+19-11' YEAR TO MONTH,
    INTERVAL '-21-3' YEAR(2)TO MONTH,
    INTERVAL '123456789-11' YEAR(9) TO MONTH
from dual;
INTERVAL'2-3'YEAR(1)TOMONTH|INTERVAL'+19-11'YEARTOMONTH|INTERVAL'-21-3'YEAR(2)TOMONTH|INTERVAL'123456789-11'YEAR(9)TOMONTH|
---------------------------+---------------------------+-----------------------------+------------------------------------+
2-3                        |19-11                      |-21-3                        |123456789-11                        |

INTERVAL DAY TO SECOND

语法

INTERVAL '[+ | -] days hours:minutes:seconds[.frac_secs]' DAY [(precision)] TO SECOND [(fractional_seconds_precision)]

描述

用来指定以天和具体时间为单位的一段时间。

参数解释

参数	说明
days hours：minutes：seconds[.frac_secs]	SQL日期格式，依次表示天数、时、分、秒。注意值中不允许有空格。
precision	表示 DAY 元素的精度，默认值为 2，取值范围为 [0,9]
fractional_seconds_precision	表示 SECOND 元素小数部分的精度，默认值为 6，取值范围为 [0,9]

days 表示天，取整数值，范围为 [0,999999999]。
hours 表示小时，取整数值，范围为 [0,23]。
minutes 表示分钟，取整数值，范围为 [0,59]。
seconds 表示秒，取整数值，范围为 [0,59]。

示例

-- 转换前Oracle SQL:
SELECT
    INTERVAL '+123456789 12:30:15.123456789' DAY(9) TO SECOND(9),
    INTERVAL '-4 05:45:30.987654' DAY TO SECOND(6)
FROM dual;
INTERVAL'+12345678912:30:15.123456789'DAY(9)TOSECOND(9)|INTERVAL'-405:45:30.987654'DAYTOSECOND(6)|
-------------------------------------------------------+-----------------------------------------+
123456789 12:30:15.123456789                           |-4 5:45:30.987654                        |

-- 转换后OceanBase-Oracle SQL:
SELECT
    INTERVAL '+123456789 12:30:15.123456789' DAY(9) TO SECOND(9),
    INTERVAL '-4 05:45:30.987654' DAY TO SECOND(6)
FROM dual;
INTERVAL'+12345678912:30:15.123456789'DAY(9)TOSECOND(9)|INTERVAL'-405:45:30.987654'DAYTOSECOND(6)|
-------------------------------------------------------+-----------------------------------------+
123456789 12:30:15.123456789                           |-4 5:45:30.987654                        |

7.3.5. DML

DML（Data Manipulation Language，数据操作语言）语句用于操作现有 Schema 对象中的数据，如增加、修改、删除等。

请参考Oracle2LightDB-Oracle：: DML

以下是和Oracle2LightDB-Oracle有差异的部分语法：

7.3.5.1. 多表插入

CREATE TABLE unisql_multi_table_small_orders (
order_id INT,
customer_id INT,
order_total INT,
sales_rep_id INT
);

CREATE TABLE unisql_multi_table_medium_orders (
    order_id INT,
    customer_id INT,
    order_total INT,
    sales_rep_id INT
);

CREATE TABLE unisql_multi_table_large_orders (
    order_id INT,
    customer_id INT,
    order_total INT,
    sales_rep_id INT
);

-- 转换前Oracle SQL:
INSERT ALL
-- 插入到 unisql_multi_table_small_orders 表中
INTO unisql_multi_table_small_orders (order_id,customer_id,order_total,sales_rep_id )
    VALUES((order_id + customer_id + 1)*2,customer_id,order_total+1,credit_limit)
-- 插入到 unisql_multi_table_medium_orders 表中
INTO unisql_multi_table_medium_orders(order_id,customer_id,order_total,sales_rep_id )
    VALUES(order_id,customer_id,(order_total + customer_id + 1)*2+2,credit_limit)
-- 插入到 unisql_multi_table_large_orders 表中
INTO unisql_multi_table_large_orders(order_id,customer_id,order_total,sales_rep_id )
    VALUES(order_id,customer_id,order_total+3,credit_limit)
SELECT (order_ +1 )*2 order_id ,(customer_ +1 )*2 customer_id,order_total,credit_limit FROM unisql_special_orders;

-- 转换后OceanBase-Oracle SQL:
-- INSERT ALL INTO unisql_multi_table_small_orders (order_id,customer_id,order_total,sales_rep_id) VALUES ((order_id+customer_id+1)*2,customer_id,order_total+1,credit_limit) INTO unisql_multi_table_medium_orders (order_id,customer_id,order_total,sales_rep_id) VALUES (order_id,customer_id,(order_total+customer_id+1)*2+2,credit_limit) INTO unisql_multi_table_large_orders (order_id,customer_id,order_total,sales_rep_id) VALUES (order_id,customer_id,order_total+3,credit_limit) SELECT (order_+1)*2 AS order_id,(customer_+1)*2 AS customer_id,order_total,credit_limit FROM unisql_special_orders
INSERT ALL
INTO unisql_multi_table_small_orders (order_id,customer_id,order_total,sales_rep_id) VALUES ((order_id+customer_id+1)*2,customer_id,order_total+1,credit_limit)
INTO unisql_multi_table_medium_orders (order_id,customer_id,order_total,sales_rep_id) VALUES (order_id,customer_id,(order_total+customer_id+1)*2+2,credit_limit)
INTO unisql_multi_table_large_orders (order_id,customer_id,order_total,sales_rep_id) VALUES (order_id,customer_id,order_total+3,credit_limit)
SELECT (order_+1)*2 AS order_id,(customer_+1)*2 AS customer_id,order_total,credit_limit FROM unisql_special_orders


-- 转换前Oracle SQL:
INSERT ALL
WHEN order_id = 4 THEN
    INTO unisql_multi_table_small_orders VALUES((order_id + customer_id + 1)*2,customer_id,order_total+1,credit_limit)
WHEN order_id = 6 THEN
    INTO unisql_multi_table_medium_orders VALUES(order_id,customer_id,(order_total + customer_id + 1)*2+2,credit_limit)
ELSE
    INTO unisql_multi_table_large_orders VALUES(order_id,customer_id,order_total+3,credit_limit)
SELECT (order_ +1 )*2 order_id ,(customer_ +1 )*2 customer_id,order_total,credit_limit FROM unisql_special_orders;

-- 转换后OceanBase-Oracle SQL:
-- INSERT ALL WHEN order_id=4 THEN INTO unisql_multi_table_small_orders VALUES ((order_id+customer_id+1)*2,customer_id,order_total+1,credit_limit) WHEN order_id=6 THEN INTO unisql_multi_table_medium_orders VALUES (order_id,customer_id,(order_total+customer_id+1)*2+2,credit_limit) ELSE INTO unisql_multi_table_large_orders VALUES (order_id,customer_id,order_total+3,credit_limit) SELECT (order_+1)*2 AS order_id,(customer_+1)*2 AS customer_id,order_total,credit_limit FROM unisql_special_orders
INSERT ALL
WHEN order_id=4 THEN
    INTO unisql_multi_table_small_orders VALUES ((order_id+customer_id+1)*2,customer_id,order_total+1,credit_limit)
WHEN order_id=6 THEN
    INTO unisql_multi_table_medium_orders VALUES (order_id,customer_id,(order_total+customer_id+1)*2+2,credit_limit)
ELSE
    INTO unisql_multi_table_large_orders VALUES (order_id,customer_id,order_total+3,credit_limit)
SELECT (order_+1)*2 AS order_id,(customer_+1)*2 AS customer_id,order_total,credit_limit FROM unisql_special_orders


-- 转换前Oracle SQL:
INSERT ALL
WHEN order_id = 4 and order_id in (select order_id FROM unisql_multi_table_small_orders WHERE order_id>1) THEN
    INTO unisql_multi_table_small_orders VALUES ((order_id+customer_id+1)*2,customer_id,order_total+1,credit_limit)
ELSE
    INTO unisql_multi_table_large_orders VALUES(order_id,customer_id,order_total+3,credit_limit)
SELECT (order_ +1 )*2 order_id ,(customer_ +1 )*2 customer_id,order_total,credit_limit FROM unisql_special_orders;

-- 转换后OceanBase-Oracle SQL:
-- INSERT ALL WHEN order_id = 4 and order_id in (select order_id FROM unisql_multi_table_small_orders WHERE order_id>1) THEN INTO unisql_multi_table_small_orders VALUES ((order_id+customer_id+1)*2,customer_id,order_total+1,credit_limit) ELSE INTO unisql_multi_table_large_orders VALUES(order_id,customer_id,order_total+3,credit_limit) SELECT (order_ +1 )*2 order_id ,(customer_ +1 )*2 customer_id,order_total,credit_limit FROM unisql_special_orders;
INSERT ALL
WHEN order_id = 4 and order_id in (select order_id FROM unisql_multi_table_small_orders WHERE order_id>1) THEN
    INTO unisql_multi_table_small_orders VALUES ((order_id+customer_id+1)*2,customer_id,order_total+1,credit_limit)
ELSE
    INTO unisql_multi_table_large_orders VALUES(order_id,customer_id,order_total+3,credit_limit)
SELECT (order_ +1 )*2 order_id ,(customer_ +1 )*2 customer_id,order_total,credit_limit FROM unisql_special_orders;

7.3.6. DDL

DDL（Data Definition Language，数据定义语言）语句用来创建、修改和删除数据库对象。

备注

在 DDL 开始之前和之后，数据库会发出一个隐式的 COMMIT 语句，所以 DDL 语句执行后不可以回滚，建议在 DDL 操作之前做好备份。

请参考Oracle2LightDB-Oracle：: DDL

以下是和Oracle2LightDB-Oracle有差异的部分语法：

7.3.6.1. 创建索引

语法

CREATE [UNIQUE|BITMAP] INDEX INDEX_NAME
ON TABLE_NAME ( COLUMN1, COLUMN2, ..., COLUMNN )
[{ GLOBAL  |  LOCAL}]
[tablespace tablespaceName] [local]

示例

--创建表
CREATE TABLE unisql_index_test(col1 int,col2 int,col3 int,col4 int,col5 varchar(10));

-- 删除存在的索引
DROP INDEX unisql_index_test_idx;

-- 转换前Oracle SQL:
-- 使用示例
CREATE INDEX unisql_index_test_idx ON unisql_index_test (col1);
CREATE UNIQUE INDEX unisql_index_test_idx ON unisql_index_test(col1);
CREATE BITMAP INDEX unisql_index_test_idx ON unisql_index_test (col1);
CREATE INDEX test.unisql_index_test_idx ON unisql_index_test(col1);
CREATE INDEX unisql_index_test_idx ON unisql_index_test(col1 asc);
CREATE INDEX unisql_index_test_idx ON unisql_index_test(col1 desc);
CREATE INDEX unisql_index_test_idx ON unisql_index_test(col1,col2);
CREATE INDEX unisql_index_test_idx ON unisql_index_test(col1) GLOBAL;


-- 转换后OceanBase-Oracle SQL:
CREATE INDEX unisql_index_test_idx ON unisql_index_test (col1);
CREATE UNIQUE INDEX unisql_index_test_idx ON unisql_index_test(col1);
CREATE BITMAP INDEX unisql_index_test_idx ON unisql_index_test (col1);
CREATE INDEX test.unisql_index_test_idx ON unisql_index_test(col1);
CREATE INDEX unisql_index_test_idx ON unisql_index_test(col1 asc);
CREATE INDEX unisql_index_test_idx ON unisql_index_test(col1 desc);
CREATE INDEX unisql_index_test_idx ON unisql_index_test(col1,col2);
CREATE INDEX unisql_index_test_idx ON unisql_index_test(col1) GLOBAL;


-- 创建表，LOCAL索引需要创建在分区表上
CREATE TABLE unisql_local_test_orders (
    order_id   int,
    order_num int,
    customer   varchar(50)
)
PARTITION BY RANGE (order_num)
(
    PARTITION p1 VALUES LESS THAN (100),
    PARTITION p2 VALUES LESS THAN (200),
    PARTITION p3 VALUES LESS THAN (MAXVALUE)
);

-- 删除存在的索引
DROP INDEX unisql_local_test_orders_idx;

-- 转换前Oracle SQL:
-- 使用示例
CREATE INDEX unisql_local_test_orders_idx ON unisql_local_test_orders(order_num) LOCAL;
CREATE INDEX unisql_local_test_orders_idx ON unisql_local_test_orders(order_num) tablespace test LOCAL;

-- 转换后OceanBase-Oracle SQL:
CREATE INDEX unisql_local_test_orders_idx ON unisql_local_test_orders (order_num) LOCAL
CREATE INDEX unisql_local_test_orders_idx ON unisql_local_test_orders (order_num) LOCAL TABLESPACE test

7.3.6.2. 创建分区表

分区范围支持使用函数、字符串、常数表达，统一SQL会根据表名、分区名在转化库中创建分区表，分区表名为：表名_1_prt_分区名

语法

CREATE TABLE TABLE_NAME …PARTITION BY[HASH|RANGE|LIST] (partition_list)

示例

-- 转换前Oracle SQL:
CREATE TABLE unisql_partition_by_range_test
(
product_id   NUMBER(6),
sale_time    TIMESTAMP(6),
sale_price   NUMBER(10,2)
)
PARTITION BY RANGE (sale_time)
(
PARTITION q1_2023 VALUES LESS THAN (TO_DATE('2023/04/01', 'yyyy/mm/dd')),
PARTITION q2_2023 VALUES LESS THAN (TO_DATE('2023/07/01', 'yyyy/mm/dd')),
PARTITION q3_2023 VALUES LESS THAN (TO_DATE('2023/10/01', 'yyyy/mm/dd')),
PARTITION q4_2023 VALUES LESS THAN (TO_DATE('2024/01/01', 'yyyy/mm/dd'))
);

-- 转换后OceanBase-Oracle SQL:
-- CREATE TABLE unisql_partition_by_range_test(product_id NUMBER(6),sale_time TIMESTAMP(6),sale_price NUMBER(10,2))PARTITION BY RANGE (sale_time)(PARTITION q1_2023 VALUES LESS THAN (TO_DATE('2023/04/01', 'yyyy/mm/dd')),PARTITION q2_2023 VALUES LESS THAN (TO_DATE('2023/07/01', 'yyyy/mm/dd')),PARTITION q3_2023 VALUES LESS THAN (TO_DATE('2023/10/01', 'yyyy/mm/dd')),PARTITION q4_2023 VALUES LESS THAN (TO_DATE('2024/01/01', 'yyyy/mm/dd')));
CREATE TABLE unisql_partition_by_range_test
(
product_id   NUMBER(6),
sale_time    TIMESTAMP(6),
sale_price   NUMBER(10,2)
)
PARTITION BY RANGE (sale_time)
(
PARTITION q1_2023 VALUES LESS THAN (TO_DATE('2023/04/01', 'yyyy/mm/dd')),
PARTITION q2_2023 VALUES LESS THAN (TO_DATE('2023/07/01', 'yyyy/mm/dd')),
PARTITION q3_2023 VALUES LESS THAN (TO_DATE('2023/10/01', 'yyyy/mm/dd')),
PARTITION q4_2023 VALUES LESS THAN (TO_DATE('2024/01/01', 'yyyy/mm/dd'))
);

-- 转换前Oracle SQL:
create table unisql_partition_by_list_test
(
id varchar2(15) not null,
city varchar2(20)
)
partition by list (city)
(
partition p1 values ('beijing'),
partition p2 values ('shanghai'),
partition p3 values ('changsha'),
partition p4 values (default)
);

-- 转换后OceanBase-Oracle SQL:
-- create table unisql_partition_by_list_test(id varchar2(15) not null,city varchar2(20))partition by list (city)(partition p1 values ('beijing'),partition p2 values ('shanghai'),partition p3 values ('changsha'),partition p4 values (default));
create table unisql_partition_by_list_test
(
id varchar2(15) not null,
city varchar2(20)
)
partition by list (city)
(
partition p1 values ('beijing'),
partition p2 values ('shanghai'),
partition p3 values ('changsha'),
partition p4 values (default)
);

-- 转换前Oracle SQL:
CREATE TABLE unisql_partition_by_hash_test (col1 INT, col2 VARCHAR(50), col3 TIMESTAMP )
PARTITION BY HASH (col1) PARTITIONS 4;

-- 转换后OceanBase-Oracle SQL:
CREATE TABLE unisql_partition_by_hash_test (col1 INT, col2 VARCHAR(50), col3 TIMESTAMP ) PARTITION BY HASH (col1) PARTITIONS 4;

7.3.6.3. 清空、删除分区表

语法

ALTER TABLE TABLE_NAME [TRUNCATE|DROP] PARTITION PARTITION_NAMES

示例

-- 转换前Oracle SQL:
ALTER TABLE unisql_partition_by_range_test TRUNCATE  PARTITION q1_2023;
ALTER TABLE unisql_partition TRUNCATE PARTITION unisql_partition_p1,unisql_partition_p2;

-- 转换后OceanBase-Oracle SQL:
ALTER TABLE unisql_partition_by_range_test TRUNCATE  PARTITION q1_2023;
ALTER TABLE unisql_partition TRUNCATE PARTITION unisql_partition_p1,unisql_partition_p2;

-- 转换前Oracle SQL:
ALTER TABLE unisql_partition_by_range_test DROP  PARTITION q1_2023;
ALTER TABLE unisql_partition DROP PARTITION unisql_partition_p1,unisql_partition_p2;

-- 转换后OceanBase-Oracle SQL:
ALTER TABLE unisql_partition_by_range_test DROP  PARTITION q1_2023;
ALTER TABLE unisql_partition DROP PARTITION unisql_partition_p1,unisql_partition_p2;

7.3.6.4. 新增表约束

警告

OceanBase-Oracle 3.2.4以及之前版本不支持通过alter table语法添加PRIMARY KEY约束

语法

ALTER TABLE table_name alter_table_action_list;

alter_table_action_list:
    alter_table_action [, alter_table_action ...]

alter_table_action:
    ADD [CONSTRAINT [constraint_name]] UNIQUE (column_name [, column_name ]...)
    | ADD [CONSTRAINT [constraint_name]] FOREIGN KEY (column_name_list) references_clause
    | ADD [CONSTRAINT [constraint_name]] CHECK (expr)
    | ADD CONSTRAINT constraint_name FOREIGN KEY(foreign_col_name) REFERENCES
        reference_tbl_name(column_name)

示例

-- 注意下面的示例中，因为约束名都相同，所以在测试时，注意在执行时出现冲突错误，请先删除存在的约束。再进行后续测试

-- 创建表
CREATE TABLE unisql_cn_test(a int,b int,c int,d varchar2(10),e varchar2(10));

-- 删除约束
ALTER TABLE unisql_cn_test DROP CONSTRAINT cn_name_a;

-- 测试主键或者唯一约束
-- 转换前Oracle SQL:
ALTER TABLE unisql_cn_test ADD CONSTRAINT cn_name_a UNIQUE (a);
ALTER TABLE unisql_cn_test ADD CONSTRAINT cn_name_a UNIQUE (a,b);
ALTER TABLE unisql_cn_test ADD CONSTRAINT cn_name_a CHECK (LENGTH(d) <= 5);

-- 转换后OceanBase-Oracle SQL:
ALTER TABLE unisql_cn_test ADD CONSTRAINT cn_name_a UNIQUE(a)
ALTER TABLE unisql_cn_test ADD CONSTRAINT cn_name_a UNIQUE(a, b)
ALTER TABLE unisql_cn_test ADD CONSTRAINT cn_name_a CHECK (LENGTH(d) <= 5)


-- 测试reference约束
-- 创建一张关联表
CREATE TABLE unisql_cn_ref_tab(col1 int,col2 int,col3 int,col4 varchar2(10),col5 varchar2(10));


-- 删除约束
ALTER TABLE unisql_cn_ref_tab DROP CONSTRAINT ref_tab_col1;
ALTER TABLE unisql_cn_ref_tab DROP CONSTRAINT ref_tab_col1_col2;

-- 添加一个外键约束(指定一个列)
ALTER TABLE unisql_cn_ref_tab ADD CONSTRAINT ref_tab_col1 UNIQUE (col1);

-- 转换前Oracle SQL:
ALTER TABLE unisql_cn_test ADD CONSTRAINT cn_name_a FOREIGN KEY (a) REFERENCES unisql_cn_ref_tab(col1);

-- 转换后OceanBase-Oracle SQL:
ALTER TABLE unisql_cn_test ADD CONSTRAINT cn_name_a FOREIGN KEY (a) REFERENCES unisql_cn_ref_tab(col1)


-- 添加一个外键约束(指定两个列)
ALTER TABLE unisql_cn_ref_tab ADD CONSTRAINT ref_tab_col1_col2 UNIQUE (col1,col2);

-- 添加两个列约束
-- 转换前Oracle SQL:
ALTER TABLE unisql_cn_test ADD CONSTRAINT cn_name_a FOREIGN KEY (a,b) REFERENCES unisql_cn_ref_tab(col1,col2);

-- 转换后OceanBase-Oracle SQL:
ALTER TABLE unisql_cn_test ADD CONSTRAINT cn_name_a FOREIGN KEY (a) REFERENCES unisql_cn_ref_tab(col1)

7.3.6.5. 修改列的属性

警告

OceanBase-Oracle通过alter table 语法修改列属性时，对于修改成的目标类型有更精细的控制。比如int类型无法转换成number，varchar类型，number之间进行转换时，精度不能小于原始精度等。你会发现在Oracle中执行成功，但是在OceanBase-Oracle中执行报错的情况: ORA-00600: internal error code, arguments: -4007, Decrease precision or scale not supported

语法

alter_table_stmt:
  ALTER TABLE table_name alter_table_action_list;


alter_table_action_list:
    alter_table_action [, alter_table_action ...]

alter_table_action:
    MODIFY [COLUMN] column_definition

示例

DROP TABLE unisql_modify_column_test;
CREATE TABLE unisql_modify_column_test(a int,d number);
SELECT * FROM unisql_modify_column_test;

-- 转换前Oracle SQL:
ALTER TABLE unisql_modify_column_test MODIFY (a smallint);
ALTER TABLE unisql_modify_column_test MODIFY (b number(10,2));
ALTER TABLE unisql_modify_column_test MODIFY b number(10,5);
ALTER TABLE unisql_modify_column_test MODIFY (c varchar(20),d date);

-- 转换后OceanBase-Oracle SQL:
ALTER TABLE unisql_modify_column_test MODIFY (a smallint);
ALTER TABLE unisql_modify_column_test MODIFY (b number(10,2));
ALTER TABLE unisql_modify_column_test MODIFY b number(10,5);
ALTER TABLE unisql_modify_column_test MODIFY (c varchar(20),d date);

7.3.6.6. 修改表

将普通表修改为分区表的转换。

警告

OceanBase-Oracle不支持将普通表转换为分区表，建议根据需要自行创建分区表。在OceanBase-Oracle中执行下面语法的相关语句，将报错：ORA-00600: internal error code, arguments: -4179, partitioned table not allowed

语法

alter_table_stmt:
  ALTER TABLE table_name alter_table_action_list;


alter_table_action_list:
    alter_table_action [, alter_table_action ...]

alter_table_action:
    MODIFY PARTITION (range_partition_list)
    | MODIFY PARTITION (list_partition_list)

range_partition_list:
range_partition [, range_partition ...]

range_partition:
    PARTITION [partition_name]
    VALUES LESS THAN {(expression_list) | (MAXVALUE)}

list_partition_list:
list_partition [, list_partition] ...

list_partition:
    PARTITION [partition_name]
    VALUES (DEFAULT|expression_list)

hash_partition_list:
hash_partition [, hash_partition, ...]

hash_partition:
    partition [partition_name]

7.3.6.7. 创建视图

语法

CREATE [OR REPLACE] [ FORCE] VIEW view_name [(column_name_list)] AS select_stmt;

 column_name_list:
     column_name [, column_name ...]

描述: 该语句用于创建视图语句，如果指定了 OR REPLACE 子句，该语句能够替换已有的视图

示例

-- 创建表
CREATE TABLE unisql_view_test(a int,b int,c varchar(10));

-- 创建视图示例
-- 转换前Oracle SQL:
CREATE VIEW unisql_view_1 AS SELECT * FROM unisql_view_test;
CREATE VIEW unisql_view_2 AS SELECT a,b FROM unisql_view_test;
CREATE VIEW unisql_view_4 AS SELECT a,b FROM unisql_view_test;
CREATE VIEW unisql_view_5 AS SELECT ' ' a, ' ' b FROM dual;
CREATE VIEW unisql_view_6 AS SELECT 1 a, 2 b FROM dual;
CREATE OR REPLACE VIEW unisql_view_7 AS SELECT 1 a, 2 b FROM dual;
CREATE OR REPLACE VIEW unisql_view_8 AS SELECT 1 a, 2 b, '3' c FROM dual;
CREATE FORCE VIEW unisql_view_9 AS SELECT 1 a, 2 b, '3' c FROM dual;
CREATE VIEW unisql_view_11(a1,b1) AS SELECT a,b FROM unisql_view_test;

-- 转换后OceanBase-Oracle SQL:
CREATE VIEW unisql_view_1 AS SELECT * FROM unisql_view_test;
CREATE VIEW unisql_view_2 AS SELECT a,b FROM unisql_view_test;
CREATE VIEW unisql_view_4 AS SELECT a,b FROM unisql_view_test;
CREATE VIEW unisql_view_5 AS SELECT ' ' a, ' ' b FROM dual;
CREATE VIEW unisql_view_6 AS SELECT 1 a, 2 b FROM dual;
CREATE OR REPLACE VIEW unisql_view_7 AS SELECT 1 a, 2 b FROM dual;
CREATE OR REPLACE VIEW unisql_view_8 AS SELECT 1 a, 2 b, '3' c FROM dual;
CREATE FORCE VIEW unisql_view_9 AS SELECT 1 a, 2 b, '3' c FROM dual;
CREATE VIEW unisql_view_11(a1,b1) AS SELECT a,b FROM unisql_view_test;

7.3.6.8. 删除视图

语法

DROP VIEW [schema.] view_name [CASCADE CONSTRAINTS];

警告

暂不支持CASCADE CONSTRAINTS参数。

描述: 该语句用于删除视图语句，该视图必须在您自己的 Schema 中，或者您必须有 DROP ANY VIEW 权限。

示例

-- 创建表
CREATE TABLE unisql_view_employees_test (
employee_id NUMBER PRIMARY KEY,
first_name VARCHAR2(50),
last_name VARCHAR2(50),
salary NUMBER
);

-- 创建视图
CREATE VIEW unisql_view_employee_names_salaries AS
SELECT first_name, salary
FROM unisql_view_employees_test;

-- 删除视图
-- 转换前Oracle SQL:
DROP VIEW unisql_view_employee_names_salaries;

-- 转换后LightDB-Oracle SQL:
DROP VIEW unisql_view_employee_names_salaries

7.3.6.9. 创建序列

语法

CREATE SEQUENCE [ schema. ] sequence_name
 { START WITH int_value
 |[ INCREMENT BY int_value ]
 |[ MINVALUE int_value | NOMINVALUE ]
 |[ MAXVALUE int_value | NOMAXVALUE ]
 |[ CACHE int_value | NOCACHE ]
 |[ ORDER | NOORDER ]
 |[ CYCLE | NOCYCLE ]
 }
 ;

描述: 该语句用来创建序列。序列属于数据库对象，用户可以从序列中生成唯一整数。

参数解释

字段	描述
schema.	指定包含序列的 Schema。如果省略 Schema，则数据库会在用户当前所在的 Schema 中创建序列。
sequence_name	要创建的序列名称。
MINVALUE int_value	指定序列的最小值，int_value 的取值范围是 [-9223372036854775808，9223372036854775807]。
NOMINVALUE	NOMINVALUE 为默认值。如果指定为 NOMINVALUE，则升序时最小值为 1，降序时最小值为 -9223372036854775808。
MAXVALUE int_value	指定序列的最大值，int_value 的取值范围是 [-9223372036854775808，9223372036854775807]。注意:同时指定 MINVALUE 和 MAXVALUE 时，MINVALUE 必须小于 MAXVALUE。MAXVALUE 和 MINVALUE 之差必须大于等于 INCREMENT BY 中的 int_value。
NOMAXVALUE	NOMAXVALUE 为默认值。如果指定为 NOMAXVALUE，则升序时最大值为9223372036854775807，降序时最大值为 -1。
START WITH int_value	指定序列的起始值。int_value 必须小于等于 MAXVALUE，且大于等于 MINVALUE。如果不指定，则升序时默认取值为最小值，降序时默认取值为最大值。
INCREMENT BY int_value	指定序列的自增步数。int_value 不可以为 0。如果指定为正数，则序列为升序；如果指定为负数，则序列为降序。不指定时缺省值为 1。
CACHE int_value	指定在内存中预分配的自增值个数，int_value 默认为 20。CACHE int_value 的值必须大于 1，如果 CACHE INT_VALUE 的值为 1，则等价于 NOCACHE。
NOCACHE	指定序列的值为未预先分配。如果同时省略 CACHE 和 NOCACHE，则数据库默认缓存 20 个序列号。
ORDER	指定序列的值按顺序生成。
NOORDER	NOORDER 为默认值，即不保证序列的值按顺序生成。
CYCLE	指定序列的值循环生成，即序列在达到其最大值或最小值后继续生成值。在升序达到最大值后，它会生成最小值。在降序序列达到其最小值后，它会生成其最大值。注意: 如果指定了 CYCLE，而且 INCREMENT BY int_value 小于 0 时，必须指定 MINVALUE。如果指定了 CYCLE，CACHE 的数量不能超过一个 CYCLE。
NOCYCLE	NOCYCLE 为默认值，指定序列在达到其最大值或最小值后无法生成更多值。

警告

不支持Oracle中的KEEP和NOKEEP语法词。

示例

-- 创建序列示例
-- 转换前Oracle SQL:
CREATE SEQUENCE SE_NAME MAXVALUE 100000 CYCLE;
CREATE SEQUENCE SE_NAME_1 NOCYCLE;
CREATE SEQUENCE SE_NAME_2 CACHE 20;
CREATE SEQUENCE SE_NAME_3 START WITH 1 NOCACHE;
CREATE SEQUENCE SE_NAME_4 START WITH 1 ORDER;
CREATE SEQUENCE SE_NAME_5 START WITH 1 NOORDER;
CREATE SEQUENCE SE_NAME_8 NOMINVALUE MAXVALUE 9223372036854775808;
CREATE SEQUENCE SE_NAME_9 MAXVALUE 9223372036854775806;
CREATE SEQUENCE SE_NAME_10 MINVALUE -9223372036854775808 NOMAXVALUE;
CREATE SEQUENCE SE_NAME_11 MINVALUE -9223372036854775809;
CREATE SEQUENCE SE_NAME_12 MINVALUE -9999999999999999999999999999;
CREATE SEQUENCE SE_NAME_13 INCREMENT BY 9223372036854775808;
CREATE SEQUENCE SE_NAME_14 INCREMENT BY -9223372036854775809;
CREATE SEQUENCE SE_NAME_15 MINVALUE -9999999999999999999999999999;
CREATE SEQUENCE SE_NAME_16 INCREMENT BY 9223372036854775808;
CREATE SEQUENCE SE_NAME_17 INCREMENT BY -9223372036854775809;
CREATE SEQUENCE SE_NAME_18 START WITH 9223372036854775808;

-- 转换后OceanBase-Oracle SQL:
CREATE SEQUENCE SE_NAME MAXVALUE 100000 CYCLE;
CREATE SEQUENCE SE_NAME_1 NOCYCLE;
CREATE SEQUENCE SE_NAME_2 CACHE 20;
CREATE SEQUENCE SE_NAME_3 START WITH 1 NOCACHE;
CREATE SEQUENCE SE_NAME_4 START WITH 1 ORDER;
CREATE SEQUENCE SE_NAME_5 START WITH 1 NOORDER;
CREATE SEQUENCE SE_NAME_8 NOMINVALUE MAXVALUE 9223372036854775808;
CREATE SEQUENCE SE_NAME_9 MAXVALUE 9223372036854775806;
CREATE SEQUENCE SE_NAME_10 MINVALUE -9223372036854775808 NOMAXVALUE;
CREATE SEQUENCE SE_NAME_11 MINVALUE -9223372036854775809;
CREATE SEQUENCE SE_NAME_12 MINVALUE -9999999999999999999999999999;
CREATE SEQUENCE SE_NAME_13 INCREMENT BY 9223372036854775808;
CREATE SEQUENCE SE_NAME_14 INCREMENT BY -9223372036854775809;
CREATE SEQUENCE SE_NAME_15 MINVALUE -9999999999999999999999999999;
CREATE SEQUENCE SE_NAME_16 INCREMENT BY 9223372036854775808;
CREATE SEQUENCE SE_NAME_17 INCREMENT BY -9223372036854775809;
CREATE SEQUENCE SE_NAME_18 START WITH 9223372036854775808;

7.3.6.10. 同义词

描述

同义词（Synonym）是 Oracle 租户中表、视图、物化视图、序列、存储过程、函数、包、类型、用户自定义类型，或是其他的同义词的别名。由于其只是一个别名，所以除了在数据字典中的定义不占任何空间。本文主要介绍同义词的分类、基本特性和权限要求。

分类

同义词有两种类型，Public 同义词和 Private 同义词。
Public 同义词属于 PUBLIC 组，每个用户都可以访问。Private 同义词属于对象所有者，只有其显式授权后其他用户才可访问。
公有同义词一般由 DBA 创建，普通用户如果希望创建公有同义词，则需要 CREATE PUBLIC SYNONYM 系统权限。

基本特性

同义词扩展了数据库的使用范围，能够在不同的数据库用户之间实现无缝交互。经常用于简化对象访问和提高对象访问的安全性。

7.3.6.10.1. 创建同义词

语法

CREATE [ OR REPLACE ] [ EDITIONABLE | NONEDITIONABLE ]
[ PUBLIC ] SYNONYM
[ schema. ] synonym
[ SHARING = { METADATA | NONE } ]
FOR [ schema. ] object [ @ dblink ] ;

备注

[ EDITIONABLE | NONEDITIONABLE ]和[ SHARING = { METADATA | NONE } ] 在OceanBase-Oracle中将被作为语法糖处理，[ @ dblink ]暂不支持！

参数解释

参数	说明
OR REPLACE	表示如果要创建的同义词名称已存在，则使用新的定义替换同义词。
EDITIONABLE/NONEDITIONABLE	如果在模式中为模式对象类型SYNONYM启用了编辑，请使用这些子句来指定同义词是已编辑对象还是非版本对象。对于私人同义词，默认是EDITABLE。对于公共同义词，默认值为NONEDITIONAL。
PUBLIC	指定 PUBLIC 来创建公共同义词，所有用户都可以使用。用户必须对基础对象具有相应的权限才能使用该同义词。在解析对象的引用时，仅当对象没有指定 Schema 时，才会使用公共同义词。如果不指定 PUBLIC，则同义词是私有的，只能由当前 Schema 访问，并且同义词名称在当前 Schema 中必须唯一。
[schema. ]synonym	Schema 指定当前同义词属于哪个用户。如果指定了 PUBLIC，则对同义词不能指定用户。 synonym 表示同义词的名称。
[ SHARING = { METADATA/NONE } ]	此子句仅在应用程序根目录中创建同义词时适用。这种类型的同义词称为应用程序公共对象，它可以与属于应用程序根的应用程序 PDB 共享。要确定同义词的共享方式，请指定以下共享属性之一：METADATA - 元数据链接共享同义词的元数据，但其数据对于每个容器都是唯一的。这种类型的同义词被称为元数据链接的应用程序公共对象。NONE - 不共享同义词。如果省略此子句，则数据库将使用 DEFAULT_SHARING 初始化参数的值来确定同义词的共享属性。如果 DEFAULT_SHARING 初始化参数没有值，则默认值为 METADATA。
[schema. ]object	表示同义词对应对象的名称。
[ @ dblink ]	暂不支持

示例

-- 转换前Oracle SQL：
CREATE OR REPLACE EDITIONABLE SYNONYM employee SHARING = METADATA FOR user2.emp;


-- 转换后OceanBase-Oracle SQL：
CREATE OR REPLACE SYNONYM employee FOR user2.emp;

7.3.6.10.2. 删除同义词

语法

DROP [PUBLIC] SYNONYM [ schema. ] synonym [FORCE] ;

参数解释

参数	说明
PUBLIC	指定 PUBLIC 来删除公共同义词。如果不指定 PUBLIC，则删除私有同义词。
[schema. ]synonym	Schema 指定当前同义词属于哪个用户。如果指定了 PUBLIC，则对同义词不能指定用户。 synonym 表示同义词的名称。
FORCE	指定 FORCE 来删除同义词，即使它具有依赖表或用户定义类型。

示例

-- 转换前Oracle SQL：
DROP PUBLIC SYNONYM user1.employee FORCE;


-- 转换后OceanBase-Oracle SQL：
DROP PUBLIC SYNONYM user1.employee FORCE;