diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/1.sql-overview.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/1.sql-overview.md deleted file mode 100644 index b01feb9cb..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/1.sql-overview.md +++ /dev/null @@ -1,120 +0,0 @@ -SQL 概述 -=========================== - - - -结构化查询语言(Structured Query Language)简称 SQL,是一种有特殊目的的编程语言。和当下流行的其他关系数据库一样,所有程序和用户都可以使用 SQL 来访问 OceanBase 数据库中的数据。即便有一些平台、工具允许用户直接通过接口或界面的方式访问数据库,但这些平台、工具底层实际上依旧是使用 SQL 来访问数据库。 - -SQL 的历史 -------------------- - -1970 年 6 月,IBM 公司 San Jose,California 实验室的 E. F. Codd 博士在 ACM(Association for Computing Machinery)期刊上发表了论文《大型共享数据银行的关系模型》(A Relational Model of Data for Large Shared Data Banks)并首次提出了关系模型的概念。 - -1974 年,同实验室的 D.D.Chamberlin 和 R.F.Boyce 在 IBM 公司研制的关系数据库系统 SystemR 中,研制出了一套规范语言 SEQUEL(Structured English QUEry Language),并在 1976 年 11 月的 IBM Journal of R\&D 上公布了新版本的 SQL(称为 SEQUEL/2,1980年改名为 SQL)。 - -1979 年,Oracle 公司首先提供商用的 SQL,同时 IBM 公司在 DB2 和 SQL/DS 数据库系统中也实现了 SQL。 - -时至今日,SQL 已经成为了关系数据库管理系统(Relational Database Management System:RDBMS)的标准语言。 - -SQL 的标准 -------------------- - -1986 年 10 月,美国国家标准协会 ANSI 采用 SQL 作为关系数据库管理系统的标准语言,并命名为 ANSI X3. 135-1986,后来国际标准化组织(ISO)也采纳 SQL 作为国际标准。 - -1989 年,ANSI 采纳并使用了在 ANSI X3.135-1989 报告中定义的 SQL 标准语言,并称之为 ANSI SQL 89,该标准替代了之前的 ANSI X3.135-1986 版本。 - -下面是 SQL 发展的简要历史: - -* 1986年,ANSI X3.135-1986,ISO/IEC 9075:1986,SQL-86。 - - - -* 1989年,ANSI X3.135-1989,ISO/IEC 9075:1989,SQL-89。 - - - -* 1992年,ANSI X3.135-1992,ISO/IEC 9075:1992,SQL-92(SQL2)。 - - - -* 1999年,ISO/IEC 9075:1999,SQL:1999(SQL3)。 - - - -* 2003年,ISO/IEC 9075:2003,SQL:2003。 - - - -* 2008年,ISO/IEC 9075:2008,SQL:2008。 - - - -* 2011年,ISO/IEC 9075:2011,SQL:2011。 - - - - - - -现在,绝大多数被提及的 SQL 标准,其中涉及的内容其实都是 SQL 92 里最基本、最核心的一部分。OceanBase 目前也遵循的是 SQL 92 标准。 - -SQL 的运行 -------------------- - -SQL 是用来访问关系数据库,如 OceanBase、Oracle 和 MySQL 的接口,所有的 SQL 语句都是对数据库的指令。 - -通常,SQL 可以分为 5 个部分: - -1. 数据查询语言 DQL(Data Query Language):也称为数据检索语言,用以从表中获得数据,并描述怎样将数据返回给程序输出。DQL 并不改变数据库中存储的数据内容。 - - - -2. 数据操作语言 DML(Data Manipulation Language):用以改变数据库中存储的数据内容,即增加、修改和删除数据。 - - - -3. 事务控制语言 TCL(Transaction Control Language):保证数据库的完整性、一致性,在同一个事务中的 DML 语句要么同时成功,要么同时失败。 - - - -4. 数据控制语句 DCL(Data Control Language):对数据访问权限控制的命令。可以控制特定账号对特定数据库资源的访问权限。 - - - -5. 数据定义语言 DDL(Data Definition Language):对数据库中资源进行定义、修改和删除,如新建表和删除表等。 - - - - - - -SQL 的移植性 --------------------- - -SQL 是访问数据库的标准语言,所有的主要关系数据库都支持 SQL,因此所有用 SQL 编写的程序都是可移植的。通常进行少量的修改就可以从一个关系数据库移植到另一个关系数据库上。 - -词汇惯例 ----------------- - -* **粗体** 表示与操作或以文本或词汇表定义的术语相关联的图形用户界面元素。 - -* 保留字、关键字、标识符和参数中的大小写不敏感。为方便阅读与识别,这些字会以大写形式书写。 - - - -* 在不同的编程环境中,SQL 语句终止方式不同。本文档中以分号 ";" 来标识一个 SQL 的结尾。 - - - -* `行内代码` 表示文档中引用的代码。 - -* 为了突出重要信息,本文档会加粗"说明"、"注意"和"重要"等文字。 - - - -* 本文档中可选参数文本用方括号括起,如 \[-n, -quiet\]。 - - - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/2.pseudo-column.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/2.pseudo-column.md deleted file mode 100644 index 9933a966a..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/2.pseudo-column.md +++ /dev/null @@ -1,225 +0,0 @@ -伪列 -======================= - - - -伪列(Pseudocolumn)的行为与表中的列相同,但并未存储具体数值。因此,伪列只具备读属性,您不可以对伪列进行插入、更新、删除的等行为。 - -层次查询伪列 ------------------- - -层次查询伪列仅在层次查询中有效,要在查询中定义层次结构关系,必须使用 `CONNECT BY` 子句。 - -### CONNECT_BY_ISCYCLE 伪列 - -`CONNECT_BY_ISCYCLE` 伪列用来协助标记循环是从哪一行开始的。如当前行的子节点同时也是其祖先节点之一,则`CONNECT_BY_ISCYCLE` 返回 1,否则返回 0。 - -`CONNECT_BY_ISCYCLE` 需要配合 `CONNECT BY` 子句的 `NOCYCLE` 使用,否则查询结果会因树状结果存在循环而报错。 - -### CONNECT_BY_ISLEAF 伪列 - -`CONNECT_BY_ISLEAF` 伪列用来协助标记层次结构的叶子节点。如当前行无子节点即为树的叶子节点时,返回 1,否则返回 0。 - -### LEVEL 伪列 - -`LEVEL` 伪列用来协助标记节点的层次。层次结构中,根为第 1 层,根的子结点为第 2 层,之后以此类推。例如,根节点的 `LEVEL` 值会返回 1,根节点的子节点的 `LEVEL` 值会返回 2,之后以此类推。 - -序列伪列 ----------------- - -序列(Sequence)伪列是数据库按照一定规则生成的自增数字序列。因其自增的特性,通常被用作主键和唯一键。序列伪列有两种取值方法: - -* `CURRVAL`:返回序列的当前值。 - -* `NEXTVAL`:返回序列的下一个自增值。 - - - - -使用序列伪列时,必须在 `CURRVAL`、`NEXTVAL` 前带上序列的名称,并用句点(.)引用。例如,序列的名称为 **SEQ_FOO** ,则可以通过 `SEQ_FOO.CURRVAL` 获取 **SEQ_FOO** 序列的当前值。同样,可以通过 `SEQ_FOO.NEXTVAL` 获取 **SEQ_FOO** 序列的下一个自增值。 - -### 序列伪列的应用场景 - -序列伪列 `CURRVAL` 和 `NEXTVAL` 的值可以用于以下位置: - -* 非子查询、物化视图或者视图中的 `SELECT` 语句的选择列表中。 - - - -* `INSERT` 语句中子查询的选择列表中。 - -* `INSERT` 语句中的 `VALUE` 子句中。 - -* `UPDATE` 语句中的 `SET` 子句中。 - - - - -序列伪列 `CURRVAL` 和 `NEXTVAL` 的值不能用于以下位置: - -* `DELETE`、`SELECT` 或者 `UPDATE` 语句的子查询中。 - -* 视图或者物化视图的查询中。 - - - -* 带 `DISTINCT` 运算符的 `SELECT` 语句中。 - - - -* 带 `GROUP BY` 子句或者 `ORDER BY` 子句的 `SELECT` 语句中。 - - - -* 与另一个 `SELECT` 语句通过 `UNION`、`INTERSECT` 或者 `MINUS` 集合运算符进行联合的 `SELECT` 语句中。 - - - -* `SELECT` 语句的 `WHERE` 子句中。 - -* `CREATE TABLE` 或者 `ALTER TABLE` 语句中列的 `DEFAULT` 值。 - -* `CHECK` 约束的条件中。 - - - - -### 如何使用序列伪列 - -创建序列时,需要明确其初始值和步长。第一次引用 `NEXTVAL` 将返回序列的初始值,后续对 `NEXTVAL` 的引用将按照上一次序列的返回值加上序列定义的步长后返回一个新值。任何时候对 `CURRVAL` 的引用,都将返回当前序列的值,即最后一次对 `NEXTVAL` 引用时返回的值。 - -在会话中引用序列的 `CURRVAL` 伪列前,都应首先应用序列的 `NEXTVAL` 伪列来初始化本次会话的序列值。 - -创建序列时,可以定义其初始值以及其值之间的增量。对 `NEXTVAL` 的第一次引用将返回序列的初始值。对 `NEXTVAL` 的后续引用将会使序列值按照定义的增量递增,并返回新值。任何对 `CURRVAL` 的引用总是返回该序列的当前值,即最后一次对 `NEXTVAL` 引用时返回的值。对序列的创建的相关内容,请参考文档 [CREATE SEQUENCE](../11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/12.create-sequence.md) 章节。 - -在单条 SQL 语句中引用 `NEXTVAL` 时,OceanBase 数据库按照以下方式递增序列: - -* `SELECT` 语句的外部查询块每返回一行递增一次。这类查询块可以出现在以下地方: - - - - - - - - - - -* `UPDATE` 语句每更新一行序列就递增一次。 - -* 每有一条包含 `VALUES` 子句的 `INSERT` 语句就递增一次。 - - - -* `MERGE` 语句每合并一行序列递增一次。`NEXTVAL` 可以出现在 `merge_insert_clause` 或者`merge_update_clause` 子句中,也可两者同时出现。`NEXTVAL` 会随着每一行的更新和插入而递增,即使序列数值没有用于更新或者插入操作。如果 `NEXTVAL` 在这些位置中被指定了多次,那么对应每一行都递增一次序列,而且该行中出现的所有 `NEXTVAL` 都返回相同的值。 - - - - -当这些位置多次引用一个序列的 `NEXTVAL` 伪列时,该序列都只递增一次,即为所有被引用的 `NEXTVAL` 伪列返回当前序列的下一个序列值。 - -当这些位置同时引用一个序列的 `CURRVAL` 和 `NEXTVAL` 伪列时,OceanBase 将递增该序列,即为被引用的 `CURRVAL` 和 `NEXTVAL` 伪列都返回当前序列的下一个序列值。 - -序列可以同时被许多用户访问,不存在等待和锁定。 - -ROWSCN 伪列 ---------------------- - -`ORA_ROWSCN` 伪列将最新更改的系统更改号(SCN:System Change Number)反映到一行,该更改号表示这一行数据修改所在事务的提交时间。 - -ROWNUM 伪列 ---------------------- - -`ROWNUM` 伪列会对查询结果中的每一行进行编号,其值为该行在查询结果集中的具体位置。第一行返回值 1,第二行返回值 2,之后以此类推。 - -ROWNUM 的用法说明 ------------------------- - -`ROWNUM` 可以限制返回的行数,例如以下示例,将返回 **employees** 表中的 5 条数据: - -```sql -SELECT * FROM employees WHERE rownum <=5; -``` - - - -如果在 `ROWNUM` 后有 `ORDER BY` 子句,则将对满足 `WHERE` 条件句的结果进行重排序。如果将 `ORDER BY` 子句嵌入子查询中,并将 `ROWNUM` 伪列作为条件放置在顶级查询中,则可以强制 `ROWNUM` 条件在行排序之后执行。例如,使用以下语句查询年龄最大的 5 名员工信息是得不到预期结果的,该语句只是将查询结果中的前 5 条员工信息进行年龄排序: - -```sql -SELECT * FROM employees WHERE rownum <=5 ORDER BY age DESC; -``` - - - -正确的用法应该如下: - -```javascript -SELECT * FROM (SELECT * FROM employees ORDER BY age DESC) WHERE rownum <= 5; -``` - - - -在 `WHERE` 子句中,指定 `ROWNUM` 大于任何一个正整数时总是返回 **FALSE** ,例如以下 SQL 语句将不返回任何信息: - -```javascript -SELECT * FROM employees WHERE rownum > 1; -``` - - - -因为在获得表的第一行结果时,改行的 `ROWNUM` 伪列值将被赋值为 1,此时在 `WHERE` 条件判断时结果为 **FALSE** ,则此行被舍去。在获得第二行结果时,该行的 `ROWNUM` 伪列值任然被赋值为 1,`WHERE` 条件判断的结果依旧为 **FALSE** ,此行再次被舍去。以此类推,所以所有行都不满足条件,因此不返回任何数据。 - -也可以通过 `UPDATE` 语句将`ROWNUM` 数值赋值给表中的某一列,例如: - -```javascript -UPDATE employees SET id = rownum; -``` - - - -此语句将对表 **employees** 的 **id** 列进行 `ROWNUM` 赋值,即依次对 **id** 列赋值 1、2、... 直至该表总行数。 -**注意** - - - -在查询中使用 `ROWNUM` 可能会影响视图优化。 - -ROWID 伪列 ------------------------------ - -ROWID 伪列提供了快速定位表中某一行的能力,ROWID 值由主键编码得到,不会进行实际的存储,类型是 UROWID。使用方法如下: - -1. 从 employees 表中查询到 ROWID 值 - - ```sql - obclient> SELECT ROWID, last_name FROM employees WHERE department_id = 20; - +-------------------+-----------+ - | ROWID | LAST_NAME | - +-------------------+-----------+ - | *AAIKAQAAAAAAAAA= | xxx | - +-------------------+-----------+ - 1 row in set (0.01 sec) - ``` - - - -2. 使用 ROWID 值进行 update 操作 - - ```sql - obclient> UPDATE employees SET last_name = 'yyy' WHERE ROWID = '*AAIKAQAAAAAAAAA='; - Query OK, 1 row affected (0.01 sec) - Rows matched: 1 Changed: 1 Warnings: 0 - - obclient> select last_name, department_id from employees; - +-----------+---------------+ - | LAST_NAME | DEPARTMENT_ID | - +-----------+---------------+ - | yyy | 20 | - +-----------+---------------+ - 1 row in set (0.01 sec) - ``` - - - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/1.overview-of-built-in-data-types.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/1.overview-of-built-in-data-types.md deleted file mode 100644 index 106186a17..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/1.overview-of-built-in-data-types.md +++ /dev/null @@ -1,41 +0,0 @@ -内建数据类型概述 -============================= - - - -OceanBase 数据库操作的每个值都有一个数据类型。值的数据类型将一组固定的属性与值相关联,这些属性使 OceanBase 将一种数据类型的值与另一种数据类型的值区别对待。OceanBase 数据库提供了许多内建数据类型, 这些内建数据类型也称 OceanBase 基本数据类型。 - -数据类型 -------------------------- - -OceanBase 支持如下数据类型,与 Oracle 数据类型保持一致: - -* 字符数据类型 - - - -* 数值数据类型 - - - -* 日期时间类型 - - - -* RAW 数据类型 - - - -* 大对象数据类型 - - - - - - - - - - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/2.character-data-type/1.overview-of-character-data-types.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/2.character-data-type/1.overview-of-character-data-types.md deleted file mode 100644 index 715900980..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/2.character-data-type/1.overview-of-character-data-types.md +++ /dev/null @@ -1,27 +0,0 @@ -字符数据类型概述 -============================= - - - -字符数据类型在数据库字符集或国家字符集中存储字符(字母数字)数据,即单词和自由格式的文本。字符数据类型与其他数据类型相比具有限制性,因此属性较少。 - -字符数据存储在字符串中,其字节值与创建数据库时指定的字符集之一相对应。OceanBase 支持单字节和多字节字符集。 -**说明** - - - -字符数据类型的列可以存储所有字母数字值,但是 `NUMBER` 数据类型的列只能存储数字值。 - - - - -| **数据类型** | **长度** | **使用说明** | **长度说明** | -|---------------------------------|--------|------------------------------------------|--------------------------------------------------------------------| -| CHAR(size \[BYTE \| CHAR\]) | 定长 | 索引效率高,程序里面使用 `trim` 去除多余的空白。 | 参数 `size` 必须是一个介于 1\~2000 之间的数值,存储大小为 `size` 个字节。 | -| NCHAR\[(size)\] | 定长 | 使用 UNICODE 字符集(所有的字符使用两个字节表示) 。 | 参数 `size` 必须是一个介于 1\~2000 之间的数值,存储大小为 `size` 字节的两倍。 | -| NVARCHAR2(size) | 变长 | 使用 UNICODE 字符集(所有的字符使用两个字节表示)。 | 参数 `size` 的值必须介于 1\~32767 之间,字节的存储大小是所输入字符个数的两倍。 | -| VARCHAR2(size \[BYTE \| CHAR\]) | 变长 | 使用 UNICODE 字符集(所有的字符使用两个字节表示)。 | 参数 `size` 必须是一个介于 1\~32767 之间的数值,存储大小为输入数据的字节的实际长度,而不是 `size` 个字节。 | -| VARCHAR(size \[BYTE \| CHAR\]) | 变长 | OceanBase 中 `VARCHAR` 和 `VARCHAR2` 没有区别。 | 参数 `size` 必须是一个介于 1\~32767 之间的数值,存储大小为输入数据的字节的实际长度,而不是 `size` 个字节。 | - - -其中,`CHAR` 和 `VARCHAR2` 数据类型需要指定 `length` 语义,其默认值由系统变量 `NLS_LENGTH_SEMANTICS` 控制。 diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/2.character-data-type/2.char-data-type.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/2.character-data-type/2.char-data-type.md deleted file mode 100644 index f20001839..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/2.character-data-type/2.char-data-type.md +++ /dev/null @@ -1,54 +0,0 @@ -CHAR 数据类型 -============================== - - - -`CHAR` 数据类型指定了固定长度的字符串。OceanBase 确保存储在 `CHAR` 数据类型列中的所有值的长度等于 `size` 指定的固定长度。如果您插入的值短于指定长度,则 OceanBase 将用空格填充剩余长度。如果您插入的值超过列长度,则 OceanBase 会返回错误。 - -`BYTE` 和 `CHAR` 限定符会覆盖由 `NLS_LENGTH_SEMANTICS` 参数指定的语义,而该参数默认字节语义。为了确保具有不同字符集的数据库之间,能够进行正确的数据转换,`CHAR` 数据必须由格式正确的字符串组成。 - -语法 --------------- - -```javascript -CHAR [(size [BYTE | CHAR])] -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|------|----------------------| -| size | 表示指定的固定长度 | -| BYTE | 表示以字节(BYTE)为单位提供列的长度 | -| CHAR | 表示以字符(CHAR)为单位提供列的长度 | - - -`CHAR` 数据类型的列的默认长度为 1 个字节,允许的最大长度为 2000 个字节。 - -示例 --------------- - -当创建带有 `CHAR` 数据类型列的表时,默认情况下,您以字节为单位提供列的长度。`BYTE` 与默认值相同。 - -如果使用 `CHAR` 限定符。则以字符为单位提供列长。 - -* **示例 1** - - - - - - -将一个 1 字节的字符串插入 `CHAR(10)` 类型的列中,在存储该字符串之前,将为其空白填充为 10 个字节。 - -* **示例 2** - - - - -`CHAR(10 CHAR)`,表示以字符为单位提供列长。 diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/2.character-data-type/3.nchar-data-type.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/2.character-data-type/3.nchar-data-type.md deleted file mode 100644 index fdd0adca5..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/2.character-data-type/3.nchar-data-type.md +++ /dev/null @@ -1,83 +0,0 @@ -NCHAR 数据类型 -=============================== - - - -`NCHAR` 是 `UNICODE` 字符数据类型,长度固定。您在创建数据库时,列的最大长度由国家字符集定义确定。创建包含 `NCHAR` 数据类型列的表时,以字符定义列长度。字符数据类型 `NCHAR` 的宽度规范是指字符数。允许的最大列大小为 2000 字节。 - -如果希望用较少的空间来存储中文,可以选择 `NCHAR` 类型。 - -使用 `NCHAR` 来存储数据时,如果存储的数据没有达到指定长度,那么数据库将自动补足空格。指定长度时,采用 `CHAR` 为计量单位,不可以手动指定其他单位。 -**注意** - - - -您不能将 `CHAR` 值插入 `NCHAR` 列,也不能将 `NCHAR` 值插入 `CHAR` 列。 - -语法 --------------- - -```javascript -NCHAR[(size)] -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|--------|-----------------------------------------------------------------| -| `size` | 表示定长字符数据的长度大小,最大大小由国家字符集定义确定,上限为 2000 个字节。默认定长字符数据的长度最小为 1 个字符。 | - - - -更多信息 ----------------- - -### UNICODE 字符集 - -UNICODE 字符集是对字符的一种编码,具体的编码方式有 UTF-8、UTF-16、UTF-32 和压缩转换等,编码方式决定了一个字符的存储大小,中英文在不同的存储方式上使用的空间是不一样的。 - -**三种编码方式的对比** - - -| **编码方式** | **编码字节数** | **BOM** | **优点** | **缺点** | -|------------|-----------------------------------------------------------|-------------------------------------------------------|------------------------------------------------------------------------------|--------------------------------------------------| -| **UTF-8** | 不定长编码方式,单字节(ASCII 字符)或多字节(非 ASCII 字符);最小 Code Unit 是 8 位。 | 无字节序:如果一个文本的开头有字节流 EF BB BF,表示是 UTF-8 编码。 | 较为理想的 UNICODE 编码方式:与 ASCII 编码完全兼容;无字节序;自同步和纠错能力强,适合网络传输和通信;扩展性好。 | 变长编码方式不利于程序内部处理。 | -| **UTF-16** | 双字节或者四字节;最小 Code Unit 是 16 位。 | 有字节序:UTF-16LE(小端序)以 FF FE 代表,UTF-16BE(大端序)以 FE FF 代表。 | 最早的 Unicode 编码方式,已被应用于大量环境中;适合内存中 Unicode 处理;很多编程语言的 API 中作为 string 类型的编码方式。 | 无法兼容于 ASCII 编码;增补平面码点编码使用代理对,编码复杂;扩展性差。 | -| **UTF-32** | 固定四字节;最小 Code Unit 是 16 位。 | 有字节序:UTF-16LE(小端序)以 FF FE 代表,UTF-16BE(大端序)以 FE FF 代表。 | 固定字节编码读取简单,编译程序内部处理;Unicode 码点和 Code Unit 一一对应关系。 | 所有字符以固定四字节编码,浪费存储空间和带宽;与 ASCII 编码不兼容;扩展性差;实际使用少。 | - - - -### 数据库字符集 - -* 用来存储 `CHAR`、`VARCHAR2`、`CLOB` 等类型数据。 - - - -* 用来标示诸如表名、列名以及 PL 变量等。 - - - -* 用来存储 SQL 和 PL 程序单元等。 - - - - - - -### 国家字符集 - -* 用来存储 `NCHAR`、`NVARCHAR2`、`NCLOB` 等类型数据。 - - - -* 国家字符集实质上是为 OceanBase 数据库选择的附加字符集,主要作用是为了增强 OceanBase 数据库的字符处理能力,`NCHAR` 数据类型使用国家字符集,在使用 `CHAR` 数据类型提供的数据库字符集的同时,`NCHAR` 类型提供了除了数据库字符集之外的另一种字符集选择。 - - - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/2.character-data-type/4.nvarchar2-data-type.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/2.character-data-type/4.nvarchar2-data-type.md deleted file mode 100644 index a63e9a109..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/2.character-data-type/4.nvarchar2-data-type.md +++ /dev/null @@ -1,29 +0,0 @@ -NVARCHAR2 数据类型 -=================================== - - - -`NVARCHAR2` 是 `UNICODE` 字符数据类型。列的长度可变,最大存储长度为 32767 个字节,最小值为 1 个字节。创建包含 `NVARCHAR2` 数据类型列的表时,您必须为 `NVARCHAR2` 指定可以容纳的最大字符数,默认采用 `CHAR` 为计量单位,不可以手动指定其他单位。 - -如果不确定存储的数据长度,而且有可能包含中文,可以选择 `NVARCHAR2` 类型。 - -格式 --------------- - -```javascript -NVARCHAR2(size) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|------|---------------------------------------------------------------------------------------------------------------| -| size | 表示列的长度,可变长度。您必须为 `NVARCHAR2` 指定大小,对于 AL16UTF16 编码,字节数最大为两倍,对于 UTF8 编码,字节数最大为三倍。字节数大小由国家字符集定义确定,上限为 32767 个字节。 | - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/2.character-data-type/5.varchar2-data-type.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/2.character-data-type/5.varchar2-data-type.md deleted file mode 100644 index 1096e4b6e..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/2.character-data-type/5.varchar2-data-type.md +++ /dev/null @@ -1,70 +0,0 @@ -VARCHAR2 数据类型 -================================== - - - -`VARCHAR2` 数据类型存储一个可变长度的字符串,最大长度为 32767。当您创建 `VARCHAR2` 列时,您必须为 `VARCHAR2` 列指定最大长度。尽管允许存储的实际字符串为零长度字符串(''),但该最大值必须至少为 1 个字节。OceanBase 会将每个值完全按照您指定的方式存储在列中。 -**注意** - - - -* 从技术上讲,字符是数据库字符集的代码点。 - - - -* 创建具有该列或属性,且在列或属性定义中未包含任何明确限定词的数据库对象时,长度语义由会话的 `NLS_LENGTH_SEMANTICS` 参数的值决定。 - - - -* OceanBase 使用未填充的比较语义比较 `VARCHAR2` 值。 - - - -* 具有不同字符集的数据库之间进行正确的数据转换时,必须确保 `VARCHAR2` 数据由格式正确的字符串组成。 - - - - - - -语法 --------------- - -```javascript -VARCHAR2(size [BYTE | CHAR]) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|------|--------------------| -| size | 表示存储的字节数或字符数的长度大小。 | -| BYTE | 表示该列将具有字节长度的语义。 | -| CHAR | 指示该列将具有字符语义。 | - - - -示例 --------------- - -您可以使用 `CHAR` 限定符,以字符为单位提供最大长度。 - -```javascript -VARCHAR2(10 CHAR) -``` - - - -您可以使用 `BYTE` 限定符,以字节为单位明确给出最大长度。 - -```javascript -VARCHAR2(10 BYTE) -``` - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/2.character-data-type/6.varchar-data-type.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/2.character-data-type/6.varchar-data-type.md deleted file mode 100644 index ceb84de53..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/2.character-data-type/6.varchar-data-type.md +++ /dev/null @@ -1,31 +0,0 @@ -VARCHAR 数据类型 -================================= - - - -`VARCHAR` 数据类型用于存储可变长度的字符串。当您创建 `VARCHAR` 数据类型的列时,您必须为 `VARCHAR` 列指定最大长度。尽管允许存储的实际字符串为零长度字符串(''),但该最大值必须至少为 1 个字节。OceanBase 会将每个值完全按照您指定的方式存储在列中。如果插入值超过指定长度,OceanBase 会返回错误。 - -在 OceanBase 中 `VARCHAR` 数据类型和 `VARCHAR2` 数据类型没有区别,一般会用 `VARCHAR2`。 - -语法 --------------- - -```javascript -VARCHAR(size [BYTE | CHAR]) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|------|--------------------| -| size | 表示存储的字节数或字符数的长度大小。 | -| BYTE | 表示该列将具有字节长度的语义。 | -| CHAR | 指示该列将具有字符语义。 | - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/3.numeric-data-type/1.overview-of-numeric-data-types.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/3.numeric-data-type/1.overview-of-numeric-data-types.md deleted file mode 100644 index f97c7a5fb..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/3.numeric-data-type/1.overview-of-numeric-data-types.md +++ /dev/null @@ -1,16 +0,0 @@ -数值数据类型概述 -============================= - - - -OceanBase 为我们提供了四种存储数值的数据类型,它们分别是 `NUMBER`、`FLOAT`、`BINARY_FLOAT` 和 `BINARY_DOUBLE`。您可以通过这四种数值类型存储定点数、浮点数和零。在数值计算时,数值类型具有不同的优先级,具体信息请查阅 [数值类型的优先级](../../../../11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/3.numeric-data-type/5.numeric-priority.md)。 - - -| **数据类** | **长度(字节)** | **说明** | -|---------------|------------|-----------------------------------------------------------------| -| NUMBER | 4\~40 | `NUMBER(p,s)` 存储变长、十进制精度的定点数;也可以存储浮点数,此时 `NUMBER` 没有 `p` 和 `s`。 | -| FLOAT | 4\~40 | `FLOAT(p)` 是 `NUMBER` 数据类型的子类型。二进制精度范围为 1\~126。`FLOAT` 不是浮点数。 | -| BINARY_FLOAT | 4 | 二进制精度浮点数,是一种 32 位单精度浮点数数据类型。 | -| BINARY_DOUBLE | 8 | 二进制精度浮点数,是一种 64 位双精度浮点数数据类型。 | - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/3.numeric-data-type/2.number-data-type.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/3.numeric-data-type/2.number-data-type.md deleted file mode 100644 index 292389c04..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/3.numeric-data-type/2.number-data-type.md +++ /dev/null @@ -1,99 +0,0 @@ -NUMBER 数据类型 -================================ - - - -`NUMBER` 是变长、精确的数值类型,占 4\~40 字节存储空间,其中 4 字节存放 `NUMBER` 的元数据信息, 36 字节存放 `NUMBER` 的具体数值。可以存储零、浮点数、正的定点数和负的定点数,其绝对值范围 1.0 × 10^-130^ \~ 1.0 × 10^126^(不包括 1.0 × 10^126^)。如果您指定的算术表达式的绝对值大于或等于 1.0 × 10^-130^,OceanBase 会返回错误。 - -`NUMBER` 数据类型具有较好的数据精确度、通用性强、可移植性强,运算效率相对浮点类型偏低。 - -语法 --------------- - -```javascript -NUMBER [(p[s])] -``` - - - -参数 --------------- - - - -| 参数 | 取址范围 | 说明 | -|----|----------|---------------------------------------------------| -| p | 1\~38 | 表示精度,最大有效十进制数字,其中最高有效数字是最左边的非零数字,最低有效数字是最右边的已知数字。 | -| s | -84\~127 | 表示小数位数,从小数点到最低有效数字的位数。比例尺范围是 -84\~127。 | - - -**说明** - - - -* 若 s\>0,精确到小数点右边 `s` 位,四舍五入。然后检验有效位是否小于等于 `p`。 - - - -* 若 s\<0,精确到小数点左边 `s` 位,四舍五入。然后检验有效位是否小于等于 `p + |s|`。 - - - -* 若 s=0, 表示整数。 - - - - - -**注意** - - - -* 小数位数正标度是小数点右边到最低有效位数(包括最低有效位数)的有效位数。精度和小数位都用十进制数字表示。 - - - -* 小数位数负数标度是小数点左边的有效位数,但不包括最低有效位数。对于负比例,最低有效数字在小数点的左侧,因为实际数据四舍五入到小数点左侧的指定位数。 - - - - - - -示例 --------------- - -* **示例 1:** 使用以下格式指定整数。 - - - - -`NUMBER(p)` 表示精度为 `p` 且标度为 0 的定点数,等效于 `NUMBER(p,0)`。 - -`NUMBER` 表示浮点数,缺少精度和小数位数指示符。 - -* **示例 2:** 使用不同的精度和小数位数存储数据。为了避免 OceanBase 存储的数据超过精度,我们需要为定点数字列指定小数位数和精度,对输入进行额外的完整性检查。但这不会强制固定定点数字列的长度。若实际存储的数据超过精度,则 OceanBase 会返回错误。如果存储的数据超过小数位数,则 OceanBase 对其进行四舍五入。 - - - - - -| 实际数据 | 指定为 | 存储为 | -|----------|----------------|---------| -| 123.89 | `NUMBER` | 123.89 | -| 123.89 | `NUMBER(3)` | 124 | -| 123.89 | `NUMBER(3,2)` | 超过精度 | -| 123.89 | `NUMBER(4,2)` | 超过精度 | -| 123.89 | `NUMBER(5,2)` | 123.89 | -| 123.89 | `NUMBER(6,1)` | 123.9 | -| 123.89 | `NUMBER(6,-2)` | 100 | -| .01234 | `NUMBER(4,5)` | .01234 | -| .00012 | `NUMBER(4,5)` | .00012 | -| .000127 | `NUMBER(4,5)` | .00013 | -| .000012 | `NUMBER(2,7)` | .000012 | -| .0000123 | `NUMBER(2,7)` | .000012 | -| 1.2e-4 | `NUMBER(2,5)` | .00012 | -| 1.2e-5 | `NUMBER(2,5)` | .00001 | - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/3.numeric-data-type/3.float-data-type.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/3.numeric-data-type/3.float-data-type.md deleted file mode 100644 index 98fe7649b..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/3.numeric-data-type/3.float-data-type.md +++ /dev/null @@ -1,96 +0,0 @@ -FLOAT 数据类型 -=============================== - - - -`FLOAT` 数据类型是具有精度(precision)的 `NUMBER` 数据类型的子类型,需要占 4\~40 字节存储空间。它的精度是按二进制有效位数计算的,范围为 1\~126,小数位数不可自定义。`FLOAT` 类型为变长、非精确数值类型。 - -语法 --------------- - -```javascript -FLOAT [(p)] -``` - - - -参数 --------------- - - - -| 参数 | 定义 | 范围 | 说明 | -|----|----|--------|----------------------------------------| -| p | 精度 | 1\~126 | 定义数值精度,按二进制有效位数计算,转换为十进制精度要乘以 0.30103。 | - - -**说明** - - - -* 二进制精度转换为十进制精度的换算关系: `十进制精度 = int(二进制精度 x 0.30103)`。 - - - -* 十进制精度转换为二进制精度的换算关系: `二进制精度 = int(十进制精度 x 3.32193)`。 - - - - - - -示例 --------------- - -* **示例 1:** 使用 `FLOAT` 设置二进制精度为 2,转换为十进制精度 int(2 x 0.30103) = 0.6,结果向下取整,则 `FLOAT(2)` 的十进制精度为 0。 - - - - - - -```javascript -FLOAT(2) -``` - - - -* **示例 2:** 创建 **test** 表,并向里面插入数据。其中 **col1** 列是 `NUMBER` 类型, **col2** 列是 `FLOAT` 类型。`NUMBER(5,2)` 表示十进制精度的定点数,有效位数为 5,结果保留小数点后 2 位。`FLOAT(5)` 的二进制精度为 5,转换为十进制精度为`int(5 x 0.30103) = 1.50515`,向下取整后十进制精度为 1。如 123.45 用科学计数法表示为 1.2345 x 10^2^,1.2345 小数点后保留 1 位,四舍五入变为 1.2,最后显示为 1.2 x 10^2^ = 120。执行以下语句: - - - - - - -```javascript -CREATE TABLE test (col1 NUMBER(5,2), col2 FLOAT(5)); -INSERT INTO test VALUES (1.23, 1.23); -INSERT INTO test VALUES (7.89, 7.89); -INSERT INTO test VALUES (12.79, 12.79); -INSERT INTO test VALUES (123.45, 123.45); -``` - - - -执行 SELECT 语句查看 **test** 表,返回结果如下: - -```javascript -obclient> SELECT * FROM test; -+--------+------+ -| COL1 | COL2 | -+--------+------+ -| 1.23 | 1.2 | -| 7.89 | 7.9 | -| 12.79 | 13 | -| 123.45 | 120 | -+--------+------+ -4 rows in set (0.00 sec) -``` - - -**说明** - - - -当转换 `ANSI FLOAT` 数据时,您可以使用 OceanBase 数据库内部使用的 `FLOAT` 数据类型。但是建议您改用 `BINARY_FLOAT` 和 `BINARY_DOUBLE` 浮点数字。 - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/3.numeric-data-type/4.floating-point-number.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/3.numeric-data-type/4.floating-point-number.md deleted file mode 100644 index 7dd3625d5..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/3.numeric-data-type/4.floating-point-number.md +++ /dev/null @@ -1,28 +0,0 @@ -浮点数字 -========================= - - - -浮点数字(FLOAT-Point Numbers)可以有小数点,从第一位到最后一位,或者根本没有小数点。您可以选择在数字后使用指数来增加范围,例如 1.666 e^-20^。小数位数不适用于浮点数,因为小数点后可以出现的位数不受限制。 -**注意** - - - -二进制浮点数与 `NUMBER` 的区别,在于值是由 OceanBase 数据库内部存储的。`NUMBER` 数据类型使用十进制精度存储,所存储的数据都会精确存储。二进制浮点数(FLOAT-Point Numbers)是使用二进制精度(数字 0 和 1)存储的,这种存储值的方式不能精确地表达使用十进制精度的所有值。 - -语法 --------------- - -OceanBase 数据库为浮点数提供了两种数字数据类型: - -* `BINARY_FLOAT`,是一种 32 位单精度浮点数数据类型。每个 `BINARY_FLOAT` 值需要 4 个字节。 - - - -* `BINARY_DOUBLE`,是一种 64 位双精度浮点数数据类型。每个 `BINARY_DOUBLE` 值需要 8 个字节。 - -* 您可以根据值域范围指定浮点数。 - -* OceanBase 浮点数据类型的实现基本上符合电气和电子工程师协会(IEEE)的二进制浮点算法标准。 - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/3.numeric-data-type/5.numeric-priority.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/3.numeric-data-type/5.numeric-priority.md deleted file mode 100644 index 1b62b2c27..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/3.numeric-data-type/5.numeric-priority.md +++ /dev/null @@ -1,31 +0,0 @@ -数值类型的优先级 -============================= - - - -不同的数值数据类型在操作时有不同的优先级。在 OceanBase 中,`BINARY_DOUBLE` 的优先级最高,其次是 `BINARY_FLOAT`,最后是 `NUMBER` 。 - -在对多个数值进行操作时: - -* 若有一个操作数为 `BINARY_DOUBLE`,OceanBase 会在执行该操作之前将所有操作数转换为 - - `BINARY_DOUBLE`。 - -* 若有一个操作数为 `BINARY_FLOAT`,OceanBase 会在执行该操作之前将所有操作数转换为 `BINARY_FLOAT`。 - - - -* 若有一个操作数都不是 `BINARY_DOUBLE` 和 `BINARY_FLOAT`,OceanBase 会在执行该操作之前将所有操作数转换为 `NUMBER`。 - - - -* 若所需要的转换失败,则该操作将失败。 - - - -* 与其他数据类型相比,数值数据类型的优先级低于日期时间与间隔数据类型,高于字符和所有其他数据类型。 - - - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/4.date-time-and-interval-data-types/1.overview-of-date-time-and-interval-data-types.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/4.date-time-and-interval-data-types/1.overview-of-date-time-and-interval-data-types.md deleted file mode 100644 index a5e661769..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/4.date-time-and-interval-data-types/1.overview-of-date-time-and-interval-data-types.md +++ /dev/null @@ -1,48 +0,0 @@ -日期时间和间隔数据类型概述 -================================== - - - -与 Oracle 中的数据类型一致,OceanBase 也支持日期时间和间隔数据类型。 - -日期时间数据类型 --------------------- - -日期时间数据类型被用来在数据库中保存日期和时间,此类别中有以下数据类型: - - -| 数据类型 | 说明 | -|--------------------------------|------------------------------| -| DATE | 存储日期和时间信息,精确到秒,不带时区。 | -| TIMESTAMP | `DATE` 数据类型的扩展,精确到纳秒,不带时区。 | -| TIMESTAMP WITH TIME ZONE | `DATE` 数据类型的扩展,精确到纳秒,带时区信息。 | -| TIMESTAMP WITH LOCAL TIME ZONE | 带有本地时区的 `TIMESTAMP`,存储数据库时区。 | - - - -间隔数据类型 ------------------- - -与日期时间数据类型存储特定的一个时间点不同,间隔数据类型用来存储一段时间。间隔数据类型有效的存储了两个日期时间值之间的差异,此类别中有以下数据类型: - - -| **数据类型** | **说明** | -|------------------------|----------------------| -| INTERVAL YEAR TO MONTH | 存储以年和月为单位的时间段。 | -| INTERVAL DAY TO SECOND | 存储以天、小时、分钟和秒为单位的时间段。 | - - - -更多信息 ----------------- - -* [夏令时](../../../../11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/4.date-time-and-interval-data-types/4.timestamp-with-time-zone-data-type.md) - - - -* [日期时间 DATE 和间隔 INTERVAL 的计算](../../../../11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/4.date-time-and-interval-data-types/8.calculation-of-date-time-and-interval.md) - - - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/4.date-time-and-interval-data-types/2.date-data-type.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/4.date-time-and-interval-data-types/2.date-data-type.md deleted file mode 100644 index cad9dc14f..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/4.date-time-and-interval-data-types/2.date-data-type.md +++ /dev/null @@ -1,96 +0,0 @@ -DATE 数据类型 -============================== - - - -`DATE` 数据类型存储日期和时间信息。尽管日期和时间信息可以用字符和数字数据类型表示,但 `DATE` 数据类型具有特殊的关联属性。对于每个 `DATE` 值,OceaBase 存储以下信息:年、月、日、小时、分钟和秒,但是并不包含时区信息。 - -格式 --------------- - -`DATE` 数据类型的默认输入输出格式由 `NLS_DATE_FORMAT` 决定,运行以下 SQL 语句查看默认格式: - -```javascript -SELECT @@NLS_DATE_FORMAT FROM DUAL; -``` - - - -返回结果: - -```javascript -DD-MON-RR -``` - - - -如果您需要自定义数据的格式,可以使用转换函数。在插入数据时,您可以通过函数 TO_DATE (char,fmt) 指定数据的输入格式。查询数据时,您可以通过函数 TO_CHAR (datetime,fmt) 指定数据的输出格式。这两个转换函数会将字符串转化为参数 `fmt` 中定义的格式。在 `fmt` 未指明的情况下,使用默认格式。 -**注意** - - - -`DATE` 数据类型储存小时、分钟和秒等时间信息,但是默认格式中并不包含时间信息。 - -取值范围 ----------------- - -`0001-01-01 00:00:00`\~`9999-12-31 23:59:59` - -示例 --------------- - -* **示例1:** 返回当前的系统日期,由于未指定参数 `fmt`,所以 `TO_CHAR` 按数据类型的默认格式返回数据。 - - - - -```javascript -SELECT TO_CHAR(sysdate) FROM DUAL; -``` - - - -返回结果: - -```javascript -+------------------+ -| TO_CHAR(SYSDATE) | -+------------------+ -| 24-FEB-20 | -+------------------+ -``` - - - - - -* **示例2:** 在未指定 `DATE` 字面量的情况下,数据库将返回系统默认值: - - - - - - - - -本示例将使用 `TO_DATE(string, format)` 插入日期数据。`TO_DATE` 会将 `string` 中的字符串转化为`format` 中定义的格式。 - -例如当前查询是 2020 年 2 月发出的: - -```javascript -SELECT TO_CHAR(TO_DATE('2020', 'YYYY'),'YYYY-MM-DD HH24:MI:SS') FROM DUAL; -``` - - - -返回结果: - -```javascript -+----------------------------------------------------------+ -| TO_CHAR(TO_DATE('2020', 'YYYY'),'YYYY-MM-DD HH24:MI:SS') | -+----------------------------------------------------------+ -| 2020-02-01 00:00:00| -+----------------------------------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/4.date-time-and-interval-data-types/3.timestamp-data-type.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/4.date-time-and-interval-data-types/3.timestamp-data-type.md deleted file mode 100644 index 57b010811..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/4.date-time-and-interval-data-types/3.timestamp-data-type.md +++ /dev/null @@ -1,110 +0,0 @@ -TIMESTAMP 数据类型 -=================================== - - - -日期时间数据类型中除了 `DATE` 数据类型以外还有 `TIMESTAMP[(scale)]` 时间戳数据类型。它是 `DATE` 数据类型的扩展,跟 `DATE` 数据类型一样,它存储了年、月、日、时、分和秒等信息,但是不存储时区信息,它的时间最大可以精确到纳秒。所以它常用于存储时间精确度高和不需要考虑时区变换的数据。 - -语法 --------------- - -```javascript -TIMESTAMP [(scale)] -``` - - - -参数 --------------- - - - -| 参数 | 取值范围 | 说明 | -|-------|------|-----------------------------------------------------------------------------------------------------| -| scale | 0\~9 | `TIMESTAMP[(scale)]` 的范围和精确度取决于 `scale` 的值,最大值为 9(纳秒,即秒数精确至小数点 9 位),最小值为 0(秒,即秒数精确至小数点 0 位),默认值为 6。 | - - - -格式 --------------- - -`TIMESTAMP` 数据类型的默认输入输出格式由 `NLS_TIMESTAMP_FORMAT` 决定,运行以下 SQL 语句查看默认格式: - -```javascript -SELECT @@NLS_TIMESTAMP_FORMAT FROM DUAL; -``` - - - -返回结果: - -```javascript -DD-MON-RR HH.MI.SSXFF AM -``` - - - -如果您需要自定义数据的格式,可以使用转换函数。在插入数据时,您可以通过函数 TO_TIMESTAMP (char,fmt) 指定数据的输入格式。查询数据时,您可以通过函数 TO_CHAR (datetime,fmt) 指定数据的输出格式。这两个转换函数会将字符串转化为参数 `fmt` 中定义的格式。在 `fmt` 未指明的情况下,使用默认格式。 - -取值范围 ----------------- - -`0001-01-01 00:00:00.000000000` \~ `9999-12-31 23:59:59.999999999` - -示例 --------------- - -* **示例1** :如下代码所示,在表 **Timestamp_Sample** 中创建了数据类型为 `TIMESTAMP` 的两列 **timestp1** 和 **timestp2** , 并且为 **timestp2** 指定了时间的精度为 3。向两列同时使用 `TO_TIMESTAMP(string, format)` 插入日期值 **2020-01-01 11:00:00** 。 - - - - - - -```javascript -CREATE TABLE Timestamp_Sample(timestp1 TIMESTAMP, timestp2 TIMESTAMP(3)); -INSERT INTO Timestamp_Sample(timestp1,timestp2) VALUES(TO_TIMESTAMP('2020-01-01 11:00:00','YYYY-MM-DD HH24:MI:SS'),TO_TIMESTAMP('2020-01-01 11:00:00','YYYY-MM-DD HH24:MI:SS')); -SELECT * FROM Timestamp_Sample; -``` - - - -结果如下,可以看到 **timestp1** 由于没有指定 `scale` 的值,所以结果时间精度默认为 6 位, **timestp2** 在指定后精度为 3 位: - -```javascript -+------------------------------+---------------------------+ -| timestamp1 | timestamp2 | -+------------------------------+---------------------------+ -| 01-JAN-20 11.00.00.000000 AM | 01-JAN-20 11.00.00.000 AM | -+------------------------------+---------------------------+ -``` - - - - - -* **示例2** :以下语句使用函数 `TO_CHAR (datetime,fmt)` 指定输出格式。 - - - - - - -```javascript -SELECT TO_CHAR(TO_TIMESTAMP_TZ('25-FEB-20 11:00:00 AM America/Los_Angeles','DD-MON-RR HH:MI:SSXFF PM TZR'),'YYYY-MM-DD HH:MI:SSXFF PM TZR') Timestamp -FROM DUAL; -``` - - - -返回结果: - -```javascript -+------------------------------------------------------+ -| Timestamp | -+------------------------------------------------------+ -| 2020-02-25 11:00:00.000000000 AM America/Los_Angeles | -+------------------------------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/4.date-time-and-interval-data-types/4.timestamp-with-time-zone-data-type.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/4.date-time-and-interval-data-types/4.timestamp-with-time-zone-data-type.md deleted file mode 100644 index dd8f88d82..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/4.date-time-and-interval-data-types/4.timestamp-with-time-zone-data-type.md +++ /dev/null @@ -1,129 +0,0 @@ -TIMESTAMP WITH TIME ZONE 数据类型 -================================================== - - - -`TIMESTAMP [(scale)] WITH TIME ZONE` 是 `TIMASTAMP [(scale)]` 的变体,与 `TIMASTAMP [(scale)]` 一样,它存储了年、月、日、时、分和秒等信息,阈值和精确度取决于 `scale` 的值。但是与 `TIMASTAMP [(scale)]` 不同的是它还可以存储时区信息,所以常用于存储跨地理区域的日期时间信息。 - -语法 --------------- - -```javascript -TIMESTAMP [(scale)] WITH TIME ZONE -``` - - - -参数 --------------- - - - -| 参数 | 取值范围 | 说明 | -|-------|------|----------------------------------------------------------------------------------------------------------------------| -| scale | 0\~9 | `TIMESTAMP [(scale)] WITH TIME ZONE` 的阈值和精确度取决于 `scale` 的值,最大值为 9 (纳秒,即秒数精确至小数点 9 位),最小值为 0(秒,即秒数精确至小数点 0 位),默认值为 6。 | - - - -格式 --------------- - -`TIMESTAMP WITH TIME ZONE` 数据类型的默认输入输出格式由 `NLS_TIMESTAMP_TZ_FORMAT` 决定,运行以下 SQL 语句查看默认格式: - -```javascript -SELECT @@NLS_TIMESTAMP_TZ_FORMAT FROM DUAL; -``` - - - -返回结果: - -```javascript -DD-MON-RR HH.MI.SSXFF AM TZR -``` - - - -如果您需要自定义数据的格式,可以使用转换函数。在插入数据时,您可以通过函数 TO_TIMESTAMP_TZ (char,fmt) 指定数据的输入格式。查询数据时,您可以通过函数 TO_CHAR (datetime,fmt) 指定数据的输出格式。这两个转换函数会将字符串转化为参数 `fmt` 中定义的格式。在 `fmt` 未指明的情况下,使用默认格式。 - -取值范围 ----------------- - -`0001-01-01 00:00:00.000000000` \~ `9999-12-31 23:59:59.999999999` - -示例 --------------- - -以下示例都使用 `TO_TIMESTAMP_TZ (char,fmt)` 输入时间戳值。 - -在插入时区时, OceanBase 支持使用时区偏移量和时区区域名称: - -* 时区偏移量:与格林尼治标准时间 GMT 的差(小时和分钟) - - - -* 时区区域名称(TZR)及时区缩写(TZD):国家/城市 时区缩写 - - - - - - -### 使用时区偏移量 - -执行以下语句,使用时区偏移量插入数值: - -```javascript -SELECT TO_TIMESTAMP_TZ('2020-01-01 11:00:00 -05:00','YYYY-MM-DD HH:MI:SS TZH:TZM') FROM DUAL; -``` - - - -返回结果: - -```javascript -01-JUN-20 11.00.00.000000000 AM AMERICA/LOS_ANGELES -``` - - - -### 使用时区区域名称及时区缩写 - -执行以下语句,使用时区区域名称及缩写插入数值: - -```javascript -SELECT TO_TIMESTAMP_TZ('2020-01-01 11:00:00 America/Los_Angeles PST','YYYY-MM-DD HH:MI:SS TZR TZD') FROM DUAL; -``` - - - -返回结果: - -```javascript -01-JUN-20 11.00.00.000000000 AM America/Los_Angeles PST -``` - - - -夏令时 ---------------- - -OceanBase 支持夏令时且用时区缩写表示夏令时信息,以 America/Los_Angeles 为例,夏令时 PDT 从每年的 3 月的第二个星期日到 11 月的第一个星期日执行,其余时间为 PST。当插入的值中只包含时区区域名称时,OceanBase 会根据插入的时间信息判断当前插入的时区区域是否在夏令时时段,并在返回的结果中会包含时区缩写,以此指明当前时间是夏令时。 - -您可以执行以下示例代码: - -```javascript -SELECT TO_TIMESTAMP_TZ('2020-02-01 11:00:00 America/Los_Angeles','YYYY-MM-DD HH:MI:SS TZR') FROM DUAL; -SELECT TO_TIMESTAMP_TZ('2020-06-01 11:00:00 America/Los_Angeles','YYYY-MM-DD HH:MI:SS TZR') FROM DUAL; -``` - - - -返回结果: - -```javascript -01-JUN-20 11.00.00.000000000 AM America/Los_Angeles PST -01-JUN-20 11.00.00.000000000 AM America/Los_Angeles PDT -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/4.date-time-and-interval-data-types/5.timestamp-with-local-time-zone-data-type.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/4.date-time-and-interval-data-types/5.timestamp-with-local-time-zone-data-type.md deleted file mode 100644 index c166e3475..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/4.date-time-and-interval-data-types/5.timestamp-with-local-time-zone-data-type.md +++ /dev/null @@ -1,99 +0,0 @@ -TIMESTAMP WITH LOCAL TIME ZONE 数据类型 -======================================================== - - - -`TIMESTAMP [(scale)] WITH LOCAL TIME ZONE` 数据类型的时区信息是当前会话发生的时区。与 `TIMASTAMP [(scale)] WITH TIME ZONE` 的区别在于用户不需要自己输入时区信息,OceanBase 直接存储默认的数据库时区 +00:00 (不可更改)。当用户检索数据时,OceanBase 会返回本地会话时区(可更改)。此数据类型常用于始终在两层应用程序中的客户端系统的时区中显示的日期信息。 - -语法 --------------- - -```javascript -TIMASTAMP [(scale)] WITH TIME ZONE -``` - - - -参数 --------------- - - - -| 参数 | 取值范围 | 说明 | -|-------|------|--------------------------------------------------------------------------| -| scale | 0\~9 | `TIMESTAMP [(scale)]` 的阈值和精确度取决于 `scale` 的值,最大值为 9(纳秒),最小值为 0(秒),默认值为 6。 | - - - -格式 --------------- - -`TIMESTAMP WITH LOCAL TIME ZONE` 数据类型的默认输入输出格式由 `NLS_TIMESTAMP_FORMAT` 决定,运行以下 SQL 语句查看日期时间格式: - -```javascript -SELECT @@NLS_TIMESTAMP_FORMAT FROM DUAL; -``` - - - -返回结果: - -```javascript -DD-MON-RR HH.MI.SSXFF AM -``` - - - -如果您需要自定义数据的格式,可以使用转换函数。您可以通过函数 TO_CHAR (datetime,fmt) 指定数据的输出格式。这个转换函数会将字符串转化为参数 fmt 中定义的格式。在 `fmt` 未指明的情况下 `TO_CHAR` 按数据类型的默认格式返回数据。关于 `TIMESTAMP WITH TIME ZONE` 数据类型值的输入格式,您可以参阅文档 [时间戳字面量](../../../../11.sql-reference-oracle-mode/3.basic-elements-1/3.literal-1/4.date-and-time-literal/2.timestamp-literal.md)。 - -取值范围 ----------------- - -`0001-01-01 00:00:00.000000000` \~ `9999-12-31 23:59:59.999999999` - -示例 --------------- - -`TIMESTAMP WITH TIME ZONE` 数据类型没有专门的字面量为其赋值,时区信息由 **SESSIONTIMEZONE** 返回本地对话时区。 **SESSIONTIMEZONE** 的值取自自定义参数 **TIME_ZONE** 。 - -```javascript -CREATE TABLE LocalTZ ( ltzcol TIMESTAMP WITH LOCAL TIME ZONE); -INSERT INTO LocalTZ VALUES (TIMESTAMP '2020-02-25 11:10:08.123'); -ALTER SESSION SET TIME_ZONE='+08:00'; -SELECT SESSIONTIMEZONE, ltzcol FROM LocalTZ; -``` - - - -返回结果: - -```javascript -+-----------------+------------------------------+ -| SESSIONTIMEZONE | ltzcol | -+-----------------+------------------------------+ -| +08:00 | 25-FEB-20 11:10:08.123000 AM | -+-----------------+------------------------------+ -``` - - - -可通过更改自定义参数 **TIME_ZONE** 的值而改变 **SESSIONTIMEZONE** : - -```javascript -ALTER SESSION SET TIME_ZONE='+00:00'; -SELECT SESSIONTIMEZONE, ltzcol FROM LocalTZ; -``` - - - -返回结果: - -```javascript -+-----------------+------------------------------+ -| SESSIONTIMEZONE | ltzcol | -+-----------------+------------------------------+ -| +00:00 | 25-FEB-20 03:10:08.123000 AM | -+-----------------+------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/4.date-time-and-interval-data-types/6.interval-year-to-month-data-type.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/4.date-time-and-interval-data-types/6.interval-year-to-month-data-type.md deleted file mode 100644 index 6802b4d31..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/4.date-time-and-interval-data-types/6.interval-year-to-month-data-type.md +++ /dev/null @@ -1,152 +0,0 @@ -INTERVAL YEAR TO MONTH 数据类型 -================================================ - - - -与 `DATE` 和 `TIMESTAMP` 数据类型储存特定的时间点日期不同,`INTERVAL YEAR TO MONTH` 使用日期元素 `YEAR` 和 `MONTH` 来储存一段时间,此数据类型对于表示两个日期时间值之间的差异很有用。 - -语法 --------------- - -```javascript -INTERVAL YEAR [(percision)] TO MONTH -``` - - - -参数 --------------- - - - -| 参数 | 值 | 说明 | -|-----------|------|------------------------------------------------------------------------------------------------------------------------| -| percision | 0\~9 | 代表了 `YEAR` 元素的精度,默认值为 2。也就是说在不指定该参数的情况下,最大可以存储 99 年 11 个月的间隔日期 (最大不能超过 100 年)。如果存储的参数超过了默认精度 2 位,那么这个参数的值不能为空,必须被明确指定。 | - - - -日期格式 ----------------- - -在插入 `INTERVAL YEAR TO MONTH` 数据类型的值时,有以下几种格式,更多关于间隔数据类型值的指定请参阅 [间隔字面量](../../../../11.sql-reference-oracle-mode/3.basic-elements-1/3.literal-1/5.interval-literal.md): - - -| **语法** | **示例** | **说明** | -|-------------------------------------------------|------------------------------------|--------------------------------------------------------------| -| INTERVAL 'year-month' YEAR(percision) TO MONTH | INTERVAL '120-3' YEAR(3) TO MONTH | 间隔 120 年 3 个月。由于 `YEAR` 元素的值大于默认精度 2,所以必须指定 `YEAR` 元素的精度为 3. | -| INTERVAL 'year' YEAR(percision) | INTERVAL '50' YEAR | 间隔 50 年。 | -| INTERVAL 'month' MONTH | INTERVAL '500' MONTH | 间隔 500 个月或者间隔 41 年 8 个月。 | - - - -示例 --------------- - -如下代码所示,在表 **Interval_Sample** 中创建了数据类型为 `INTERVAL YEAR TO MONTH` 的三列 **interval1** 、 **interval2** 和 **interval3** ,并向其中插入数值: - -```javascript -CREATE TABLE Interval_Sample ( - interval1 INTERVAL YEAR TO MONTH, - interval2 INTERVAL YEAR(3) TO MONTH, - interval3 INTERVAL YEAR TO MONTH -); -INSERT INTO Interval_Sample (interval1, interval2, interval3) -VALUES (INTERVAL '12-3' YEAR TO MONTH, INTERVAL '120-3' YEAR(3) TO MONTH, INTERVAL '40' MONTH); -SELECT * FROM Interval_Sample; -``` - - - -返回结果: - -```javascript -+-----------+-----------+-----------+ -| interval1 | interval2 | interval3 | -+-----------+-----------+-----------+ -| +12-03 | +120-03 | +03-04 | -+-----------+-----------+-----------+ -``` - - - -间隔与其他日期类型的计算 ------------------------- - -OceanBase 支持数据类型间的转换,所以间隔数据类型的值可以与其他日期值进行数学运算,但是数据库并不支持数据类型间任意的进行加、减、乘、除运算。请参阅文档 [日期时间 DATE 和间隔 INTERVAL 的计算](../../../../11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/4.date-time-and-interval-data-types/8.calculation-of-date-time-and-interval.md) 中查看目前支持的日期类型计算矩阵图和 [数据类型转换](../../../../11.sql-reference-oracle-mode/3.basic-elements-1/2.data-type-comparison-rules/6.data-type-conversion.md) 了解数更多数据类型转换的信息。 - -* **示例 1** :间隔与间隔的计算,返回的值仍为间隔数据类型。 - - - - -```javascript -SELECT INTERVAL '2-2' YEAR TO MONTH -INTERVAL '1-1' YEAR TO MONTH calculate1, INTERVAL '2-2' YEAR TO MONTH + INTERVAL '1-1' YEAR TO MONTH calculate2 FROM DUAL; -``` - - - -返回结果: - -```javascript -+---------------+----------------+ -| calculate1 | calculate2 | -+--------------------------------+ -| +000000001-01 | +000000003-03 | -+---------------+----------------+ -``` - - - - - -* **示例 2** :间隔与日期时间的计算,返回的值为日期数据类型。`SYSDATE` 返回当前的时间 **2020-02-27 16:13:50** ,以下示例会返回从现在起两个月后的日期值。数据库只支持间隔+日期时间,而间隔-日期时间是无效运算。但是日期时间+间隔和日期时间-间隔都是有效运算。 - - - - -```javascript -SELECT TO_CHAR(INTERVAL '2' MONTH +SYSDATE,'YYYY-MM-DD HH24:MI:SS') calculate3 FROM DUAL; -``` - - - -返回结果: - -```javascript -+---------------------+ -| calculate3 | -+---------------------+ -| 2020-04-27 16:13:50 | -+---------------------+ -``` - - - -* **示例 3** :间隔和数字的运算,返回的值仍为间隔数据类型。 - - - - - - -间隔可以与数字进行乘除运算。以下示例展示了间隔 2 月乘以 2 的计算和间隔 2 天除以 3 的计算。 - -```javascript -SELECT INTERVAL '2' MONTH*2 calculate4, INTERVAL '2' DAY/3 calculate5 FROM DUAL; -``` - - - -返回结果为间隔 4 月和间隔 16 小时: - -```javascript -+---------------+-------------------------------+ -| calculate4 | calculate5 | -+---------------+-------------------------------+ -| +000000000-04 | +000000000 16:00:00.000000000 | -+---------------+-------------------------------+ -``` - - - -[](qqvecg) diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/4.date-time-and-interval-data-types/7.interval-day-to-second-data-type.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/4.date-time-and-interval-data-types/7.interval-day-to-second-data-type.md deleted file mode 100644 index b7896733f..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/4.date-time-and-interval-data-types/7.interval-day-to-second-data-type.md +++ /dev/null @@ -1,76 +0,0 @@ -INTERVAL DAY TO SECOND 数据类型 -================================================ - - - -`INTERVAL DAY TO SECOND` 可存储以天、小时、分钟和秒为单位的时间段。此数据类型对于表示两个日期时间值之间的精确差异很有用。 - -语法 --------------- - -```javascript -INTERVAL DAY [(precision)] TO SECOND [(fractional_seconds_precision)] -``` - - - -参数 --------------- - - - -| 参数 | 值 | 说明 | -|------------------------------|------|--------------------------------| -| precision | 0\~9 | 代表了 `DAY` 元素的精度,默认值为 2。 | -| fractional_seconds_precision | 0\~9 | 代表了 `SECOND` 元素小数部分的精度,默认值为 6。 | - - - -示例 --------------- - -在插入 `INTERVAL DAY TO SECOND` 数据类型的值时,有以下几种格式,更多关于间隔数据类型值的指定请参阅 [间隔字面量](../../../../11.sql-reference-oracle-mode/3.basic-elements-1/3.literal-1/5.interval-literal.md): - - -| 语法 | 示例 | 说明 | -|--------------------------------------------------------------------------------|----------------------------------------------------|-----------------------------------| -| INTERVAL 'dd hh:mm:ss' DAY(precision) TO SECOND(fractional_seconds_precision) | INTERVAL '140 5:12:10.2222222' DAY(3) TO SECOND(7) | 间隔 140 天 5 小时 12 分钟 10.2222222 秒。 | -| INTERVAL 'dd hh'DAY(precision) TO HOUR | INTERVAL '400 5' DAY(3) TO HOUR | 间隔 400 天 5 小时。 | -| INTERVAL 'dd hh:mm'DAY(precision) TO MINUTE | INTERVAL '4 5:12' DAY TO MINUTE | 间隔 4 天 5 小时 12 分钟。 | -| INTERVAL 'hh:mm' HOUR TO MINUTE | INTERVAL '11:20' HOUR TO MINUTE | 间隔 11 小时 20 分钟。 | -| INTERVAL 'hh:mm:ss' HOUR TO SECOND(fractional_seconds_precision) | INTERVAL '11:12:10.2222222' HOUR TO SECOND(7) | 间隔 11 小时 12 分钟 10.2222222 秒。 | -| INTERVAL 'dd' DAY(precision) | INTERVAL '14' DAY | 间隔 14 天。 | -| INTERVAL 'hh' HOUR | INTERVAL '160' HOUR | 间隔 160 小时。 | -| INTERVAL 'mm' MINUTE | INTERVAL '14' MINUTE | 间隔 14 分钟。 | -| INTERVAL 'ss' SECOND(fractional_seconds_precision) | INTERVAL '14.666' SECOND(2, 3) | 间隔 14.666 秒。 | - - - -如下代码所示,在表 **Interval_Sample** 中创建了数据类型为 `INTERVAL DAY TO SECOND` 的两列 **interval1** 、 **interval2** 并向这两列中插入数值: - -```javascript -CREATE TABLE Interval_Sample (interval1 INTERVAL DAY TO SECOND, interval2 INTERVAL DAY(3) TO SECOND(3)); -INSERT INTO Interval_Sample (interval1, interval2) VALUES ( INTERVAL '15 06:10:08' DAY TO SECOND, INTERVAL '150 06:10:08' DAY(3) TO SECOND(3)); -SELECT * FROM Interval_Sample; -``` - - - -返回结果: - -```javascript -+---------------------+-------------------+ -| interval1 | interval2 | -+---------------------+-------------------+ -| +15 06:10:08.000000 | +150 06:10:08.000 | -+---------------------+-------------------+ -``` - - - -间隔与其他日期类型的计算 ------------------------- - -OceanBase 支持数据类型间的转换,所以间隔数据类型的值可以与其他日期值进行数学运算。但是数据库并不支持数据类型间任意的进行加、减、乘、除运算。请参阅文档 [日期时间 DATE 和间隔 INTERVAL 的计算](../../../../11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/4.date-time-and-interval-data-types/8.calculation-of-date-time-and-interval.md) 中查看目前支持的日期类型计算矩阵图和参阅文档 [数据类型转换](../../../../11.sql-reference-oracle-mode/3.basic-elements-1/2.data-type-comparison-rules/6.data-type-conversion.md) 了解数更多数据类型转换的信息。 - -关于间隔与其他数据类型计算的示例,请参阅文档 [INTERVAL YEAR TO MONTH 数据类型](../../../../11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/4.date-time-and-interval-data-types/6.interval-year-to-month-data-type.md) 。 diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/4.date-time-and-interval-data-types/8.calculation-of-date-time-and-interval.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/4.date-time-and-interval-data-types/8.calculation-of-date-time-and-interval.md deleted file mode 100644 index d79eff228..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/4.date-time-and-interval-data-types/8.calculation-of-date-time-and-interval.md +++ /dev/null @@ -1,73 +0,0 @@ -日期时间 DATE 和间隔 INTERVAL 的计算 -=============================================== - - - -您可以在日期(`DATE`)、时间戳(`TIMESTAMP`、`TIMESTAMP WITH TIME ZONE` 和 `TIMESTAMP WITH LOCAL TIME ZONE`)和间隔(`INTERVAL YEAR TO MONTH` 和 `INTERVAL DAY TO SECOND`)上执行许多算术运算。 - -OceanBase 根据以下规则计算结果: - -* 您可以在日期和时间戳值(而非间隔值)的算术运算中使用 `NUMBER` 常数。OceanBase 在内部将时间戳值转换为日期值,并将算术日期时间和间隔表达式中的 `NUMBER` 常量解释为天数。例如,`SYSDATE` +1 是明天。`SYSDATE`-7 是一周前。`SYSDATE` +(10/1440)是十分钟之后。 - - **注意** - - - - 您不能乘以或除以日期或时间戳值。 - - -* OceanBase 将 `BINARY_FLOAT` 和 `BINARY_DOUBLE` 操作数转换为 `NUMBER`。 - - - -* 每个 `DATE` 值都包含一个时间成分,许多日期运算的结果都包含一个分数。此分数表示一天的一部分。例如,1.5 天是 36 个小时。OceanBase 内置函数还返回这些分数,以对 `DATE` 数据执行常见操作。例如,`MONTHS_BETWEEN` 函数返回两个日期之间的月数。结果的小数部分代表一个 31 天月份的那部分。 - - - -* 如果一个操作数是 `DATE` 值或数字值,但都不包含时区或小数秒部分,则: - - - - - - - - - - - - -* 当您将时间戳,时间间隔或数字值传递给仅限于 `DATE` 数据类型使用的内置函数时,OceanBase 将把非 `DATE` 值转换为 `DATE` 值。 - - - -* 当间隔计算返回日期时间值时,结果必须是实际的日期时间值,否则数据库将返回错误。例如,以下两个语句返回错误: - - - - - - -```javascript -SELECT TO_DATE("31-AUG-2004','DD-MON-YYYY") + TO_YMINTERVAL("0-1") FROM DUAL; -SELECT TO_DATE("29-FEB-2004','DD-MON-YYYY") + TO_YMINTERVAL("1-0") FROM DUAL; -``` - - - -第一条语句失败,因为在一个有31天的月份上增加一个月,导致计算结果为 9 月 31 日,这不是有效的日期。第二条语句失败,因为在仅每四年存在的日期上增加一年是无效的。但是,在 2 月 29 日之前加上四年是有效的,计算结果为2008年2月29日: - -```javascript -SELECT TO_DATE("29-FEB-2004", "DD-MON-YYYY") + TO_YMINTERVAL("4-0") FROM DUAL; -``` - - - -* 下表是日期时间算术运算的矩阵。"---"表示不支持的操作。 - - - - - - -![1582879347833-8be1cad5-b40b-4671-ab9a-f13cdbd939a8 (1).png](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/9055055061/p179242.png "1582879347833-8be1cad5-b40b-4671-ab9a-f13cdbd939a8 (1).png") diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/5.raw-data-type.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/5.raw-data-type.md deleted file mode 100644 index e70e4f6a0..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/5.raw-data-type.md +++ /dev/null @@ -1,139 +0,0 @@ -RAW 数据类型 -============================= - - - -`RAW` 是一种可变长度的数据类型,在不同平台上传输时,传送的都是二进制信息,即使字符集不同也不需要转换。OceanBase 数据库中用于保存二进制数据或字节字符串。 - -`RAW` 类似于 `VARCHAR2`,声明方式是 `RAW(length)`,`length` 为长度,以字节为单位,作为数据库列最大存储 2000 个字节,作为变量最大存储 2000 字节。 - -语法 --------------- - -```javascript -RAW(length) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|--------|--------------------------------------------------------| -| length | 表示长度,以字节为单位,作为数据库列最大存储 2000 字节的数据,作为变量最大存储 2000 字节的数据。 | - - - -示例 --------------- - -* **示例 1:** 在 **test_raw** 表中声明 `RAW` 型数据,并向表中插入一条数据。 - - - - - - -```javascript -CREATE TABLE test_raw (c1 RAW(10)); -INSERT INTO test_raw VALUES (utl_raw.cast_to_raw('1234567890')); -``` - - - -执行以下语句: - -```javascript -SELECT utl_raw.cast_to_varchar2(c1) FROM test_raw; -``` - - - -查询结果如下: - -```javascript -+-------------------------------+ -| UTL_RAW.CAST_TO_RAW(C1) | -+-------------------------------+ -| 1234567890 | -+-------------------------------+ -``` - - - -* **示例 2:** 向 **raw_test** 表中插入 2 条数据。 - - - - - - -```javascript -CREATE TABLE raw_test (id number, raw_date raw(10)); -INSERT INTO raw_test VALUES (1, hextoraw('ff')); -INSERT INTO raw_test VALUES (2, utl_raw.cast_to_raw('051')); -``` - - - -执行以下语句: - -```javascript -SELECT * FROM raw_test; -``` - - - -查询结果如下: - -```javascript -+------+----------+ -| ID | RAW_DATE | -+------+----------+ -| 1 | FF | -| 2 | 303531 | -+------+----------+ -``` - - - -SQL 函数 `HEXTORAW()` 会把字符串中数据转换为 16 进制数。SQL 函数 `UTL_RAW.CAST_TO_RAW([VARCHAR2])` 会把字符串中每个字符的 ASCII 码存放到 `RAW` 类型的字段中。例如, **051** 转换为 **303531** 。 - -* **示例 3:** OceanBase 数据库将 `RAW` 数据转换为字符数据,每个字符代表 `RAW` 数据的四个连续位的十六进制数(0\~9 和 A\~F 或 a\~f)。 - - - - -如:二进制位数 11001011,其 `RAW` 数据转换后为字符 **CB** 。 - -OceanBase 数据库将字符数据转换为 `RAW`,它是把每个连续的输入字符解释为二进制数据的四个连续位,通过把这些位进行级联,来构建结果 `RAW` 值。 -**注意** - - - -如果任一输入字符不是十六进制数(0\~9 和 A\~F 或 a\~f),则将报告错误。如果字符数为奇数,则结果不确定。 - -更多信息 ----------------- - -### 字符转换 - -在数据库之间传输数据,或者在数据之间传输数据库字符集和客户端字符集时,OceanBase 数据库会自动在不同数据库字符集之间转换 `CHAR` 和 `VARCHAR2` 数据。而传输 `RAW` 数据时 OceanBase 数据库不执行字符转换。 - -### RAW 的函数 - - - -| 函数 | 说明 | -|------------------------------------------------------|----------------------------------------------------------------------------------------------| -| HEXTORAW() | 当使用 `hextoraw` 时,会把字符串中数据转换成 16 进制串,字符串中的每两个字符表示了结果 `RAW` 中的一个字节。 | -| RAWTOHEX(rawvalue) | 将 `RAW` 类数值 `rawvalue` 转换为一个相应的十六进制表示的字符串。 `rawvalue` 中的每个字节都被转换为一个双字节的字符串。 | -| UTL_RAW_CAST_TO_RAW(\[VARCHAR2\]) | 保持数据的存储内容不变,仅改变数据类型,将 `VARCHAR2` 转换为 `RAW` 类型。 | -| UTL_RAW_CAST_TO_VARCHAR2(\[RAW\]) | 保持数据的存储内容不变,仅改变数据类型,将 `RAW` 类型转换为 `VARCHAR2` 类型。 | -| UTL_RAW.BIT_OR()、UTL_RAW.BIT_AND()、UTL_RAW.BIT_XOR() | 位操作。 | - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/6.large-object-data-type/1.data-types-of-large-objects.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/6.large-object-data-type/1.data-types-of-large-objects.md deleted file mode 100644 index 679fe3c4d..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/6.large-object-data-type/1.data-types-of-large-objects.md +++ /dev/null @@ -1,19 +0,0 @@ -大对象数据类型概述 -============================== - - - -大对象数据类型(Large Object),简称 LOB,用来存储大型和非结构化数据,例如文本、图像、视频和空间数据等。包括 `BLOB` 和 `CLOB` 。 - -您在创建表时,可以选择为 LOB 列或 LOB 对象属性指定与表中指定的不同的表空间和存储特征。 - -OceanBase 支持以下大对象数据类型: - - -| 类型 | 长度 | **定义长度上限(字符)** | 字符集 | -|------|----|----------------|---------| -| BLOB | 变长 | 48M | BINARY | -| CLOB | 变长 | 48M | UTF8MB4 | - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/6.large-object-data-type/2.blob-data-type.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/6.large-object-data-type/2.blob-data-type.md deleted file mode 100644 index c107e9f69..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/6.large-object-data-type/2.blob-data-type.md +++ /dev/null @@ -1,23 +0,0 @@ -BLOB 数据类型 -============================== - - - -`BLOB` 全称为二进制大型对象(Binary Large Object)。它用于存储数据库中的大型二进制对象,可以将 `BLOB` 对象视为没有字符集语义的位流。`BLOB` 存储的二进制数据,其字节的长度上限为 48M,字符集是 `BINARY`。 - -`BLOB` 对象具有完整的事务支持。通过 `SQL`、`DBMS_ LOB` 软件包进行的更改将完全参与事务。可以提交和回滚 `BLOB` 值操作。但是,您不能在一个事务中将 `BLOB` 定位器保存在 PL 中,然后在另一事务或会话中使用它。 -**注意** - - - -存储的二进制文件过大,会使数据库的性能下降。 - -在数据库中,通常像图片、文件、音乐等大文件信息就用 `BLOB` 字段来存储,它先将大文件转为二进制再存储进去。 - -如下,创建表 **blob_table** ,并设置 **blob_cl** 列为 `BLOB` 数据类型。 - -```javascript -CREATE TABLE blob_table (blob_cl BLOB); -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/6.large-object-data-type/3.clob-data-type.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/6.large-object-data-type/3.clob-data-type.md deleted file mode 100644 index 6d823c693..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/6.large-object-data-type/3.clob-data-type.md +++ /dev/null @@ -1,19 +0,0 @@ -CLOB 数据类型 -============================== - - - -`CLOB` 全称为字符大型对象(Character Large Object)。它用于存储单字节和多字节字符数据。支持固定宽度和可变宽度字符集,且都使用数据库字符集。`CLOB` 不支持宽度不等的字符集。可存储字节的长度上限(字符)是 48 M,字符集是 `UTF8MB4`。 - -`CLOB` 对象具有完整的事务支持。通过 `SQL`、`DBMS_ LOB` 软件包进行的更改将完全参与事务。可以提交和回滚 `CLOB` 值操作。但是,您不能在一个事务中将 `CLOB` 定位器保存在 PL 中,然后在另一事务或会话中使用它。 - -由于 `VARCHAR2` 类型字段长度最大 32767,若需要保存的字段长度大于 32767,可以使用 `CLOB` 类型。另外,可以使用 `CLOB` 来保存 `CHAR` 数据,如 XML 文档就是用 `CLOB` 数据保存内容。 - -例如,创建表 **temp** ,设置 **temp_clob** 列为 `CLOB` 数据类型。 - -```javascript -CREATE TABLE temp (temp_clob CLOB); -``` - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/2.data-type-comparison-rules/1.overview-of-data-type-comparison-rules.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/2.data-type-comparison-rules/1.overview-of-data-type-comparison-rules.md deleted file mode 100644 index c866c9f06..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/2.data-type-comparison-rules/1.overview-of-data-type-comparison-rules.md +++ /dev/null @@ -1,41 +0,0 @@ -数据类型比较规则概述 -=============================== - - - -数据类型比较规则规定了 OceanBase 数据库如何比较每种数据类型的值。 - -OceanBase 数据类型比较规则支持以下数据值: - -* 数值 - - - -* 日期值 - - - -* 字符值 - - - - - - -更多信息 ----------------- - -* [数据类型优先级](../../../11.sql-reference-oracle-mode/3.basic-elements-1/2.data-type-comparison-rules/5.data-type-priority.md) - - - -* [数据类型转换](../../../11.sql-reference-oracle-mode/3.basic-elements-1/2.data-type-comparison-rules/6.data-type-conversion.md) - - - -* [数据转换的安全注意事项](../../../11.sql-reference-oracle-mode/3.basic-elements-1/2.data-type-comparison-rules/7.security-considerations-for-data-conversion.md) - - - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/2.data-type-comparison-rules/2.numeric-value.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/2.data-type-comparison-rules/2.numeric-value.md deleted file mode 100644 index fcfdd323f..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/2.data-type-comparison-rules/2.numeric-value.md +++ /dev/null @@ -1,11 +0,0 @@ -数值 -=== - -数值数据有定点数、浮点数和零。 - -数值数据比较规则如下: - -* 较大的值大于较小的值,如:5.5 \> 2.1。 -* 负数均小于零,如 -3 \< 0, -200 \< -1。 -* 正数均大于零,如 20 \> 0, 100 \> 1。 - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/2.data-type-comparison-rules/3.date-value.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/2.data-type-comparison-rules/3.date-value.md deleted file mode 100644 index 4d384ca73..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/2.data-type-comparison-rules/3.date-value.md +++ /dev/null @@ -1,23 +0,0 @@ -日期值 -======================== - - - -`DATE` 数据类型存储日期和时间信息。每个 `DATE` 值,OceanBase 存储以下信息:年、月、日、小时、分钟和秒,但是并不包含时区信息。 - -日期数据比较规则如下: - -* 现在的时间大于过去的时间,如 2018 年 5 月 1 日的日期值大于 2012 年 5 月 1 日的日期值。 - - - -* 下午的时间大于早上的时间,如 2019 年 2 月 2 日下午 3:30 的日期时间值大于 2019 年 2 月 2 日 上午 10:30 的日期时间值。 - - - -* 早上的时间大于昨天的时间,如 2019 年 3 月 5 日上午 2:30 的日期时间值大于 2019 年 3 月 4 日下午 23:30 的日期时间值。 - - - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/2.data-type-comparison-rules/4.character-value.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/2.data-type-comparison-rules/4.character-value.md deleted file mode 100644 index ce3b6be38..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/2.data-type-comparison-rules/4.character-value.md +++ /dev/null @@ -1,67 +0,0 @@ -字符值 -======================== - - - -字符数据是根据字符值大小比较的,而字符值则根据以下两种度量进行比较: - -* 二进制和语言比较 - - - -* 空白填充或非填充比较语义 - - - - - - -二进制和语言比较 --------------------- - -### 二进制比较 - -在默认的二进制比较中,OceanBase 根据数据库字符集中字符的数字代码的级联值比较字符串。如果一个字符在字符集中的数值大于另一个,则该字符更大。OceanBase 不支持 ASCII 字符集和 EBCDIC 字符集。 - -### 语言比较 - -在语言排序中,SQL 排序和比较都按照 `NLS_SORT` 指定的语言规则。若字符编码的二进制序列与字符集要求的语言序列不匹配,则使用语言比较。若 `NLS_SORT` 参数的设置不是 `BINARY`,且 `NLS_COMP` 参数设置为 `LINGUISTIC`,则使用语言比较。 - -空白填充和非填充比较语义 ------------------------- - -### 空白填充比较语义 - -使用空白填充语义,若两个值的长度不同,则 OceanBase 首先将空格添加到较短的空格的末尾,以便它们的长度相等。然后,OceanBase 逐个字符地比较值,直到第一个不同的字符为止。在第一个不同位置具有较大字符的值被认为较大。如果两个值没有不同的字符,则认为它们相等。此规则意味着两个值仅在尾随空白数上不同时相等。 -**注意** - - - -只有当比较中的两个值都是数据类型 `CHAR`、`NCHAR`、文本文字或 `USER` 函数返回的值时,OceanBase 就会使用空白填充的比较语义。 - -### 非填充比较语义 - -使用非填充语义,OceanBase 逐个字符地比较两个值,直到第一个不同的字符为止。该位置上具有较大字符的值被认为较大。如果两个不同长度的值在较短的值之前一直相同,则较长的值被认为较大。如果两个长度相等的值没有不同的字符,则认为这些值相等。 -**注意** - - - -只要比较中的一个或两个值的数据类型为 `VARCHAR2` 或 `NVARCHAR2`,OceanBase 就会使用非填充比较语义。 - -### 示例 - -使用不同的比较语义比较两个字符值的结果不同。本示例显示了使用空白填充语义和非填充语义比较。 - - -| 空白填充 | 非填充 | -|-----------------|-----------------| -| 'ac' \> 'ab' | 'ac' \> 'ab' | -| 'ab' \> 'a ' | 'ab' \> 'a ' | -| 'ab' \> 'a' | 'ab' \> 'a' | -| 'ab' = 'ab' | 'ab' = 'ab' | -| 'ac' \> 'ab' | 'ac' \> 'ab' | -| 'a ' = 'a' | 'a ' \> 'a' | - - - -通常,空白填充和非填充比较的结果是相同的。而最后一行的比较示例说明了空白填充和非填充比较语义之间的区别。 diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/2.data-type-comparison-rules/5.data-type-priority.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/2.data-type-comparison-rules/5.data-type-priority.md deleted file mode 100644 index 2175a2ac8..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/2.data-type-comparison-rules/5.data-type-priority.md +++ /dev/null @@ -1,29 +0,0 @@ -数据类型优先级 -============================ - - - -OceanBase 使用数据类型优先级来确定隐式数据类型转换顺序。 - -OceanBase 数据类型的转换优先级如下(由高到低): - -1. 日期时间和间隔数据类型 - - - -2. `BINARY_DOUBLE` 数据类型 - -3. `BINARY_FLOAT` 数据类型 - -4. `NUMBER` 数据类型 - -5. 字符数据类型 - - - -6. 所有其他内置数据类型 - - - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/2.data-type-comparison-rules/6.data-type-conversion.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/2.data-type-comparison-rules/6.data-type-conversion.md deleted file mode 100644 index 63aa776bf..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/2.data-type-comparison-rules/6.data-type-conversion.md +++ /dev/null @@ -1,181 +0,0 @@ -数据类型转换 -=========================== - - - -通常,表达式不能包含不同数据类型的值。但是为了使表达式能够进行计算,OceanBase 支持从一个数据类型到另一个数据类型的值的隐式转换和显式转换。 - -隐式数据类型转换 --------------------- - -当转换有意义时,OceanBase 数据库会自动将一个值从一种数据类型转换为另一种数据类型。隐式数据类型的转换规则: - -* `INSERT` 和 `UPDATE` 操作时,OceanBase 把变量值转换成列类型。 - -* `SELECT FROM` 操作时,OceanBase 把列数据类型转换成目标变量类型。 - -* 字符值和数字值比较时,OceanBase 把字符值转换成数字值。 - - - -* 在处理数值时,OceanBase 会调整精度和小数位数。由此产生的数字数据类型与基础表中找到的数字数据类型不同。 - - - -* 字符值或数值和浮点数值之间的转换可以是不精确的,因为字符类型和数量使用十进制精度来表示数值,浮点数使用二进制精度。 - - - -* 当一个 `CLOB` 值转换为一个字符类型如 `VARCHAR2`,或 `BLOB` 转换为 `RAW` 时。如果要转换的数据大于目标数据类型,那么数据库会返回一个错误。 - - - -* 在从时间戳值转换为 `DATE` 值的过程中,时间戳值的小数秒部分被截断,且时间戳值的小数秒部分进行四舍五入。 - - - -* 从 `BINARY_FLOAT` 转换为 `BINARY_DOUBLE` 是准确的。 - - - -* 如果 `BINARY_DOUBLE` 的精度位数超出了 `BINARY_FLOAT` 支持的位数,`BINARY_DOUBLE` 转换为 `BINARY_FLOAT` 是不精确的。 - - - -* 当将字符值与 `DATE` 值进行比较时,OceanBase 将字符数据转换为 `DATE`。 - - - -* 赋值操作时,OceanBase 把等号右边的值转换成左边赋值目标数据类型。 - - - -* 连接操作时,OceanBase 把非字符类型转换成字符类型或国家字符类型。 - - - - - - -**隐式数据类型转换矩阵** - -下表显示了所有的隐式数据类型转换,您不需要考虑转换的方向或转换的上下文。"-"表示不支持转换。 - - -| **数据类型** | **CHAR** | **VARCHAR2** | **NCHAR** | **NVARCHAR2** | **DATE** | **DATETIME / INTERVAL** | **NUMBER** | **BINARY_FLOAT** | **BINARY_DOUBLE** | **RAW** | **CLOB** | **BLOB** | -|---------------------|----------|--------------|-----------|---------------|----------|------------------------------------|------------|------------------|-------------------|---------|----------|----------| -| CHAR | - | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | -| VARCHAR2 | Yes | - | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | - | -| NCHAR | Yes | Yes | - | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | - | -| NVARCHAR2 | Yes | Yes | Yes | - | Yes | Yes | Yes | Yes | Yes | Yes | Yes | - | -| DATE | Yes | Yes | Yes | Yes | - | - | - | - | - | - | - | - | -| DATETIME / INTERVAL | Yes | Yes | Yes | Yes | - | - | - | - | - | - | - | - | -| NUMBER | Yes | Yes | Yes | Yes | - | - | - | Yes | Yes | - | - | - | -| BINARY_FLOAT | Yes | Yes | Yes | Yes | - | - | Yes | - | Yes | - | - | - | -| BINARY_DOUBLE | Yes | Yes | Yes | Yes | - | - | Yes | Yes | - | - | - | - | -| RAW | Yes | Yes | Yes | Yes | - | Yes ^[1](#note-1)^ | - | - | - | - | Yes | - | -| CLOB | Yes | Yes | Yes | Yes | - | - | - | - | - | - | - | Yes | -| BLOB | - | - | - | - | - | - | - | - | - | Yes | - | - | - - - -^[1]()^ 您不能直接将 `RAW` 转换为 `INTERVAL`,但是可以使用 `UTL_RAW.CAST_TO_VARCHAR2([RAW])` 将`RAW` 转换为 `VARCHAR2`,然后将所得的 `VARCHAR2` 值转换为 `INTERVAL`。 - -**不同字符类型之间隐式转换的方向** - - -| **数据类型** | **TO_CHAR** | **TO_VARCHAR2** | **TO_NCHAR** | **TO_NVARCHAR2** | -|----------------|-------------|-----------------|--------------|------------------| -| from CHAR | - | VARCHAR2 | NCHAR | NVARCHAR2 | -| from VARCHAR2 | VARCHAR2 | - | NVARCHAR2 | NVARCHAR2 | -| from NCHAR | NCHAR | NCHAR | - | NCHAR2 | -| from NVARCHAR2 | NVARCHAR2 | NVARCHAR2 | NVARCHAR2 | - | - - - -**隐式数据类型转换示例** - -执行以下语句: - -```javascript -SELECT 5 * 10 + 'james' FROM DUAL; -``` - - - -语句执行失败,且您收到以下报错: - -```javascript -invalid number -``` - - - -这是由于 OceanBase 使用了隐式数据类型转换,将 `'james'` 转换为数字类型,但是转换失败。 - -本示例将字符串 **'2'** 从 `CHAR` 数据类型隐式转换为了数字数据类型 **2** ,计算结果为 **52** 。 - -执行以下语句: - -```javascript -SELECT 5 * 10 + '2' FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+---------------------+ -| 5 * 10 + '2' | -+---------------------+ -| 52 | -+---------------------+ -``` - - - -显式数据类型转换 --------------------- - -您可以使用 SQL 转换函数转换数据类型,SQL 函数显式转换一个数据类型为另一个数据类型。 - -**显示类型转换矩阵** - - -| **数据类型** | **To CHAR、VARCHAR2、NCHAR、NVARCHAR2** | **To NUMBER** | **To Datetime/ Interval** | **To RAW** | **To CLOB、BLOB** | **To_BINARY_FLOAT** | **To_BINARY_DOUBLE** | -|----------------------------------------|--------------------------------------|---------------|------------------------------------------------------------------|------------|------------------|---------------------|----------------------| -| **From CHAR、VARCHAR2、NCHAR、NVARCHAR2** | TO_CHAR(char . ) 、TO_NCHAR(char . ) | TO_NUMBER | TO_DATE、TO_TIMESTAMP、TO_TIMESTAMP_TZ、TO_YMINTERVAL、TO_DSINTERVAL | HEXTORAW | TO_CLOB | TO_BINARY_FLOAT | TO_BINARY_DOUBLE | -| **From NUMBER** | TO_CHAR(number) 、TO_NCHAR(number) | -- | TO_DATE、NUMTOYM_INTERVAL、NUMTOOLS_INTERVAL | -- | -- | TO_BINARY_FLOAT | TO_BINARY_DOUBLE | -| **From Datetime/Interval** | TO_CHAR(date ) 、TO_NCHAR(date) | -- | -- | -- | -- | -- | -- | -| **From RAW** | RAWTOHEX、RAWTONHEX | -- | -- | -- | TO_BLOB | -- | -- | -| **From CLOB、BLOB** | TO_CHAR、TO_NCHAR | -- | -- | -- | TO_CLOB | -- | -- | -| **From BINARY_FLOAT** | TO_CHAR(char . ) 、TO_NCHAR(char . ) | TO_NUMBER | -- | -- | -- | TO_BINARY_FLOAT | TO_BINARY_DOUBLE | -| **From BINARY_DOUBLE** | TO_CHAR(char . ) 、TO_NCHAR(char . ) | TO_NUMBER | -- | -- | -- | TO_BINARY_FLOAT | TO_BINARY_DOUBLE | - - - -**显式数据类型转换示例** - -当前的时间通过 `TO_CHAR` 函数显式转换为想要的格式输出。 - -执行以下语句: - -```javascript -SELECT TO_CHAR(SYSDATE, 'YYYY_MM_DD') FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+-------------------------------+ -| TO_CHAR(SYSDATE,'YYYY_MM_DD') | -+-------------------------------+ -| 2020_02_27 | -+-------------------------------+ -``` - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/2.data-type-comparison-rules/7.security-considerations-for-data-conversion.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/2.data-type-comparison-rules/7.security-considerations-for-data-conversion.md deleted file mode 100644 index 14a6844df..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/2.data-type-comparison-rules/7.security-considerations-for-data-conversion.md +++ /dev/null @@ -1,26 +0,0 @@ -数据转换的安全注意事项 -================================ - - - -通过隐式转换或不指定格式模型的显式转换将日期时间值转换为文本时,格式模型由一个全局会话参数定义。根据源数据类型,这些参数名称为 `NLS_DATE_FORMAT`、`NLS_TIMESTAMP_FORMAT` 或 `NLS_TIMESTAMP_TZ_ FORMAT`。这些参数的值可以在客户端环境或 `ALTER SESSION` 语句中指定。 - -当不指定格式模型的显式转换对动态构造的 SQL 语句中的日期时间值进行显式转换时,格式模型对会话参数的选择过程会对数据库安全性产生负面影响。 - -动态构造的 SQL 语句是指由程序或者存储过程生成的 SQL 语句。执行动态构造的 SQL 语句,需要 OceanBase 内置的 PL 包 `DBMS_SQL` 或与 PL 语句 `EXECUTE IMMEDIATE` 相关,但这些并不是唯一执行动态构造的 SQL 文本的方式。 - -如下所示,`start_date` 的数据类型为 `DATE`,使用会话参数 `NLS_DATE_FORMAT` 中指定的格式模型将 `start_date` 的值转换为文本,再将结果传递到 SQL 文本中。日期时间格式模型可以简单地由双引号所包含的文本组成。 - -```javascript -SELECT last_name FROM employees WHERE hire_date > '' || start_date || ''; -``` - - -**说明** - - - -为显式转换的格式模型设置全球化参数的用户可以决定上述转换产生了什么文本。 - -若 SQL 语句由过程执行,则该过程的执行可能会由于session变量的修改而被SQL注入。当某些过程具有更高权限(例如Definer's Rights Procedure)时,造成的安全方面的影响可能更大。 - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/3.literal-1/1.literal-overview.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/3.literal-1/1.literal-overview.md deleted file mode 100644 index 415ea81c7..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/3.literal-1/1.literal-overview.md +++ /dev/null @@ -1,26 +0,0 @@ -字面量概述 -========================== - - - -字面量(Literals)是用于表达一个固定值的表示法。许多函数和 SQL 语句都需要指定字面量,字面量也可以作为表达式和条件的一部分。OceanBase 支持以下字面量: - -* 文本字面量 - - - -* 数值字面量 - - - -* 日期时间字面量 - - - -* 间隔字面量 - - - - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/3.literal-1/2.literal-value-of-text.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/3.literal-1/2.literal-value-of-text.md deleted file mode 100644 index f477a33ac..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/3.literal-1/2.literal-value-of-text.md +++ /dev/null @@ -1,30 +0,0 @@ -文本字面量 -========================== - - - -文本字面量(Text Literals)是使用单引号 `' '` 引起来的字符串,用来在表达式、条件、SQL 函数、SQL 语句中指定字符串的值。 - -文本字面量本身具有 `CHAR` 和 `VARCHAR2` 数据类型的属性: - -* 在表达式和条件中,OceanBase 通过使用空白填充的比较语义进行比较,将文本字面量视为数据类型为 `CHAR`。 - - - -* 指定文本字面量时,`CHAR` 数据类型的值的长度最大是 2000,`VARCHAR2` 数据类型的值的长度最大是 32767。 - - - - - - -以下是一些有效的文本字面量,若要在字符串中表现一个单引号,需要在字符串中的单引号前再插入一个单引号: - -```javascript -'Jackie''s raincoat' -'Hello' -'09-MAR-98' -'今天天气很好' -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/3.literal-1/3.numeric-literal.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/3.literal-1/3.numeric-literal.md deleted file mode 100644 index 33e5516cd..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/3.literal-1/3.numeric-literal.md +++ /dev/null @@ -1,77 +0,0 @@ -数值字面量 -========================== - - - -数值字面量(Numberic Literals)使用数值字面量指定固定数和浮点数的值。 - -整数字面量 ------------------ - -当表达式、条件、SQL 函数和 SQL 语句中出现整数时,需要用整数(Integer)字面量来指定值。 - -下面是一些有效的整数字面量: - -```javascript -8 -+186 --15 -``` - - - -数字和浮点数字面量 ---------------------- - -当表达式、条件、SQL 函数和 SQL 语句中出现数字时,需要用数字(Number)或浮点字(Floating-Point)面量来指定值。 - -以下是一些有效的数字 NUMBER 字面量: - -```javascript -12 -+6.87 -0.5 -25e-03 --9 -``` - - - -以下是一些有效的浮点数 Floating-Point 字面量: - -```javascript -25f -+6.34F -0.5d --1D -``` - - - -数字字面量最大可以储存精度为 38 位的数字。如果字面量要求的精度比 `NUMBER`、`BINARY_FLOAT` 或 `BINARY_DOUBLE` 所提供的精度更高,则 OceanBase 将截断该值。如果字面量的范围超出 `NUMBER`、`BINARY_FLOAT` 或 `BINARY_DOUBLE` 支持的范围,则 OceanBase 会抛出错误。 - -示例 --------------- - -数值字面量中的小数点分隔符始终是点(.)。在期望数值字面量的地方指定了文本字面量,则该文本字面量被转换为数值字面量。 - -在下面的示例中,计算了 **2** 乘以数值字面量 **2.2** 和 **2** 乘以文本字面量 **'3.3'** : - -```javascript -SELECT 2*2.2, 2*'3.3' FROM DUAL; -``` - - - -返回结果: - -```javascript -+-------+---------+ -| 2*2.2 | 2*'3.3' | -+-------+---------+ -| 4.4 | 6.6 | -+-------+---------+ -``` - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/3.literal-1/4.date-and-time-literal/1.date-literal.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/3.literal-1/4.date-and-time-literal/1.date-literal.md deleted file mode 100644 index 202f3f54d..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/3.literal-1/4.date-and-time-literal/1.date-literal.md +++ /dev/null @@ -1,122 +0,0 @@ -日期字面量 -========================== - - - -日期(DATE)字面量可以通过字符串指定,或者可以使用 `TO_DATE` 函数将字符或数字值转换为日期值。日期字面量是唯一接受用 `TO_DATE` 表达式代替字符串指定值的: - -```javascript -TO_DATE('2020-03-25 11:05:00', 'YYYY-MM-DD HH24:MI:SS') -``` - - - -使用日期值指定日期字面量时,必须使用公历的日期值。同时也可以如下所示,使用 ANSI 来指定日期字面量,ANSI 日期字面量不包含时间信息,而且必须使用 **YYYY-MM-DD** 的格式: - -```javascript -DATE '2020-03-25' -``` - - - -此外,还可以使用数据库默认日期值来指定日期字面量,当在日期表达式中使用默认值时,OceanBase 会自动将默认日期格式的字符值转换为日期值。数据库的默认日期值由初始化参数 `NLS_DATE_FORMAT` 指定,此示例中默认格式为 **DD-MON-RR** : - -```javascript -TO_DATE('25-FEB-20', 'DD-MON-RR') -``` - - - -如果您指定不带时间成分的日期值,则默认时间为午夜(24 小时制 00:00:00 和 12 小时制 12:00:00)。如果指定的日期值不带日期成分,则默认日期为当前月份的第一天。 - -OceanBase 数据库中默认的日期格式为 **DD-MON-RR** ,如果需要同时显示时间值,可以通过执行` alter session set NLS_DATE_FORMAT = 'DD-MON-RR HH24:MI:SS';` 命令修改变量 `NLS_DATE_FORMAT` 的值。因此,如果查询 `DATE` 列,则必须在查询中指定时间字段,或确保 `DATE` 列中的时间字段设置为午夜。否则,数据库可能不会返回您期望的查询结果。比如创建一张具有 **id** 列和 **datecol** 日期列的表 **Date_Literals** : - -```javascript -CREATE TABLE Date_Literals (id NUMBER, datecol DATE); -``` - - - -在表中插入当前会话的系统日期时间 **SYSDATE** ,此示例使用了 TRUNC 函数将时间字段设置为午夜,`TRUNC` 函数会截取 **SYSDATE** 的日期部分,这样 **datecol** 列中的时间会自动填充默认的午夜时间: - -```javascript -INSERT INTO Date_Literals VALUES (1,SYSDATE); -INSERT INTO Date_Literals VALUES (2,TRUNC(SYSDATE)); -``` - - - -此时表中数据为: - -```javascript -+------+---------------------+ -| id | datecol | -+------+---------------------+ -| 1 | 25-FEB-20 11:28:16 | -| 2 | 25-FEB-20 00:00:00 | -+------+---------------------+ -``` - - - -当查询中不包含时间信息时,可以在查询中使用大于或小于条件,而不是等于或不等于条件: - -```javascript -SELECT * FROM Date_Literals WHERE datecol > TO_DATE('2020-02-24', 'YYYY-MM-DD'); -``` - - - -返回结果: - -```javascript -+------+---------------------+ -| id | datecol | -+------+---------------------+ -| 1 | 25-FEB-20 11:28:16 | -| 2 | 25-FEB-20 00:00:00 | -+------+---------------------+ -``` - - - -当使用等于条件时,由于查询中不包含时间信息,所以结果只返回了时间信息为午夜值的日期: - -```javascript -SELECT * FROM Date_Literals WHERE datecol = TO_DATE('2020-02-25', 'YYYY-MM-DD'); -``` - - - -返回结果: - -```javascript -+------+---------------------+ -| id | datecol | -+------+---------------------+ -| 2 | 25-FEB-20 00:00:00 | -+------+---------------------+ -``` - - - -反过来,可以过滤掉 **datecol** 列中的时间字段,只查询日期字段: - -```javascript -SELECT * FROM Date_Literals WHERE TRUNC(datecol) = DATE '2020-02-25'; -``` - - - -返回结果: - -```javascript -+------+---------------------+ -| id | detacol | -+------+---------------------+ -| 1 | 25-FEB-20 11:28:16 | -| 2 | 25-FEB-20 00:00:00 | -+------+---------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/3.literal-1/4.date-and-time-literal/2.timestamp-literal.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/3.literal-1/4.date-and-time-literal/2.timestamp-literal.md deleted file mode 100644 index 0eef3db86..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/3.literal-1/4.date-and-time-literal/2.timestamp-literal.md +++ /dev/null @@ -1,88 +0,0 @@ -时间戳字面量 -=========================== - - - -OceanBase 支持以下三种时间戳字面量: - -* TIMESTAMP - - - -* TIMESTAMP WITH TIME ZONE - - - -* TIMESTAMP WITH LOCAL TIME ZONE - - - - - - -TIMESTAMP 字面量 -------------------------- - -`TIMESTAMP[(scale)]` 数据类型存储了年、月、日、时、分、秒和小数秒值的值。当指定 TIMESTAMP 字面量时,秒字段最大可以指定精度到第9位的纳秒: - -```javascript -TIMESTAMP '2020-02-25 11:26:18.316' -``` - - - -TIMESTAMP WITH TIME ZONE 字面量 ----------------------------------------- - -TIMESTAMP WITH TIME ZONE 字面量是包含时区信息的时间戳字面量。 - -`TIMESTAMP [(scale)] WITH TIME ZONE` 数据类型是 `TIMESTAMP[(scale)]` 数据类型的一种变体,它在`TIMESTAMP[(scale)]` 数据类型的基础上还存储时区偏移量或者时区区域名称等信息。在指定 TIMESTAMP WITH TIME ZONE 字面量时,需要指定时区信息并且秒字段最大可以指定精度到第9位的纳秒,以下示例使用时区偏移量指定了时区字段的值: - -```javascript -TIMESTAMP '2020-02-25 11:26:18.316 +08:00' -``` - - - -当两个 TIMESTAMP WITH TIME ZONE 字面量中的值表示 GMT 时区的同一时刻,那么尽管它们的时区字段的值不同,它们也被视为相同的字面量。如以下示例所示,GMT-8 时区的早上 8 点和 GMT-5 时区的早上11点其实是同一时刻: - -```javascript -TIMESTAMP '2020-04-25 08:26:18.316 -08:00' -TIMESTAMP '2020-04-25 11:26:18.316 -05:00' -``` - - - -同样的,在字面量中我们可以使用时区区域名称替换时区偏移量,如下所示的示例中将 **-08:00** 替换为了 **America/Los_Angeles** : - -```javascript -TIMESTAMP '2020-02-01 11:00:00 America/Los_Angeles' -``` - - - -由于一些地区有夏令时的转换,为了消除夏令时转换时时间的歧义,在指点字面量的值时可以同时使用 时区区域名称(TZR)和相应的缩写 (TZD)以确保字面量的值为夏令时: - -```javascript -TIMESTAMP '2020-06-01 11:00:00 America/Los_Angeles PDT' -``` - - - -TIMESTAMP WITH LOCAL TIME ZONE 字面量 ----------------------------------------------- - -`TIMESTAMP [(scale)] WITH LOCAL TIME ZONE` 数据类型是包含本地时区信息的数据类型。OceanBase 中并没有专门的 TIMESTAMP WITH LOCAL TIME ZONE 字面量,是通过其他有效的日期时间字面量来为`TIMESTAMP [(scale)] WITH LOCAL TIME ZONE` 数据类型赋值的。下表显示了一些可用于将值插入 TIMESTAMP WITH LOCAL TIME ZONE 列的格式,以及查询返回的相应值: - - -| **INSERT 语句中指定的值** | **查询返回的值** | -|----------------------------------------------------|------------------------------| -| '25-FEB-20' | 25-FEB-20 00.00.000000 | -| SYSTIMESTAMP | 25-FEB-20 14:28:41.264258 | -| TO_TIMESTAMP('25-FEB-2020', 'DD-MON-YYYY') | 25-FEB-20 00.00.000000 | -| SYSDATE | 25-FEB-20 02.55.29.000000 PM | -| TO_DATE('25-FEB-20', 'DD-MON-YYYY') | 25-FEB-20 12.00.00.000000 AM | -| TIMESTAMP'2020-02-25 8:00:00 America/Los_Angeles' | 25-FEB-20 08.00.00.000000 AM | - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/3.literal-1/5.interval-literal.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/3.literal-1/5.interval-literal.md deleted file mode 100644 index bd1780782..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/3.literal-1/5.interval-literal.md +++ /dev/null @@ -1,75 +0,0 @@ -间隔字面量 -========================== - - - -间隔字面量用来指定一段时间的值。OceanBase 支持两种类型的间隔字面量: - -* INTERVAL YEAR TO MONTH - - - -* INTERVA DAY TO SECOND - - - - - - -前导字段和尾随字段 ---------------------- - -每种间隔字面量都包含一个前导字段和一个可选的尾随字段。前导字段定义了要测量的日期或时间的基本单位,尾随字段定义了所考虑的基本单位的最小增量。例如,DAY TO MINUTE 用来指定最小单位到月份的间隔字面量,其中前导字段是 `YEAR`,尾随字段是 `MINUTE`。尾随字段是可选的,在指定间隔字面量时可以省去。 - -在间隔字面量中有以下字段:`YEAR`、`MONTH`、`DAY`、`HOUR`、`MINUTE` 和 `SECOND`。它们的权重从 `YEAR` 开始按顺序递减。当需要指定尾随字段时,字面量中尾随字段的权重一定要低于前导字段,否则是无效的指定。例如,`INTERVAL '1-2' DAY TO YEAR` 是个无效的字面量。 - -前导字段值的位数范围为 0\~9,默认值为 2。`SECOND` 字段指定了秒数,该字段最大可以精确到小数点后 9 位,最小是小数点 0 位,默认值精度是小数点 6 位。字段的值超出指定的范围后,数据库会返回错误。`SECOND` 字段的小数位数如果超出指定精度,会四舍五入到符合指定精度的值。 - -INTERVAL YEAR TO MONTH 字面量 --------------------------------------- - -`INTERVAL YEAR TO MONTH` 字面量用来指定以年和月为单位的一段时间。 - -以下是一些 `INTERVAL YEAR TO MONTH` 字面量的示例: - - -| 示例 | 说明 | -|-----------------------------------|-------------------------------------------------------| -| INTERVAL '265-2' YEAR(3) TO MONTH | 间隔 265 年 2 个月。前导字段 `YEAR` 的精度大于默认的 2 位,需要指定与值位数相符的精度值 | -| INTERVAL '265' YEAR(3) | 表示间隔 265 年。 | -| INTERVAL '500' MONTH(3) | 表示间隔 500 个月或 41 年 8 个月。 | -| INTERVAL '10' MONTH | 表示隔 10 个月。 | -| INTERVAL '123' YEAR | 返回错误,值 123 超出了默认精度 2 位。 | - - - -可以在一个 `INTERVAL YEAR TO MONTH` 字面量之间添加或减去另一个 `INTERVAL YEAR TO MONTH` 字面量。例如:`INTERVAL '6-2' YEAR TO MONTH` + `INTERVAL'21' MONTH` = `INTERVAL '7-11' YEAR TO MONTH`。 - -INTERVAL DAY TO SECOND 字面量 --------------------------------------- - -`INTERVAL DAY TO SECOND` 字面量用来指定以天和具体时间为单位的一段时间。 - -以下是一些 `INTERVAL DAY TO SECOND` 字面量的示例: - - -| 示例 | 说明 | -|-----------------------------------------------|-----------------------------------------------------------------------------------------------------| -| INTERVAL '4 5:12:10.222' DAY TO SECOND(3) | 表示间隔 4 天 5 小时 12 分钟 10.222 秒。 `SECOND` 字段小数点默认精度是 6,这里如果不手动指定精度为 3,返回的结果中会用 0 补齐位数。 | -| INTERVAL '4 5:12' DAY TO MINUTE | 表示间隔 4 天 5 小时 12 分钟 | -| INTERVAL '400 5' DAY(3) TO HOUR | 表示间隔 400 天 5 小时。前导字段 `DAY` 超出默认精度 2 位,这里手动指定精度为 3。 | -| INTERVAL '400' DAY(3) | 表示间隔 400 天。 | -| INTERVAL '11:12:10.2222222' HOUR TO SECOND(7) | 表示间隔 11 小时 12 分钟 10.2222222 秒。 `SECOND` 字段的值超出默认精度 6 位,这里手动指定了和值相符的精度。 | -| INTERVAL '11:20' HOUR TO MINUTE | 表示间隔 11 小时 20 分钟。 | -| INTERVAL '10' HOUR | 表示间隔 10 小时 | -| INTERVAL '10:22' MINUTE TO SECOND | 表示间隔 10 分钟 22 秒。 | -| INTERVAL '10' MINUTE | 表示间隔 10 分钟。 | -| INTERVAL '4' DAY | 表示间隔 4 天。 | -| INTERVAL '25' HOUR | 表示间隔 25 小时。 | -| INTERVAL '40' MINUTE | 表示间隔 40 分钟。 | -| INTERVAL '120' HOUR(3) | 表示间隔 120 小时。 | -| INTERVAL '30.12345' SECOND(2,4) | 表示间隔 30.1235 秒。秒的小数点位数超出指定精度,所以四舍五入到小数点第 4 位。 | - - - -可以在一个 `INTERVAL DAY TO SECOND` 字面量之间添加或减去另一个 `INTERVAL DAY TO SECOND` 字面量。例如:`INTERVAL'20' DAY` - `INTERVAL'239' HOUR` = `INTERVAL'10-1' DAY TO SECOND`。 diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/4.format/1.formatting-overview.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/4.format/1.formatting-overview.md deleted file mode 100644 index 415bfc0e5..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/4.format/1.formatting-overview.md +++ /dev/null @@ -1,33 +0,0 @@ -格式化概述 -========================== - - - -格式化指定了存储在数据库中的日期时间数据或数值数据的格式。当您将字符串转换为日期时间或数字时,格式化会告诉 OceanBase 数据库如何转换并存储该字符串。在 SQL 语句中,您可以通过 `TO_CHAR` 、`TO_NUMBER` 和 `TO_DATE` 等函数的参数来指定: - -* OceanBase 数据库返回值的格式 - - - -* 存储在数据库中值的格式 - - - - - - -OceanBase 支持以下几种数据格式化: - -**数值格式化** - -数值格式化指定了存储在数据库中的定点数和浮点数的格式。当您需要将 SQL 语句中出现 `NUMBER`,`BINARY_FLOAT` 或 `BINARY_ DOUBLE` 值转换为 `VARCHAR2` 数据类型时,您可以使用函数中的数值格式化。数值格式化是由一个或多个数值格式化元素组成,具体信息请查阅 [数值格式化](../../../11.sql-reference-oracle-mode/3.basic-elements-1/4.format/2.format-1.md)。 - -**日期时间格式化** - -日期时间格式化指定了存储在数据库中日期时间数据的格式。日期时间格式化的总长度不能超过 22 个字符。当您需要将非默认格式的字符值转换为日期时间格式的值时,您可以使用函数中的日期时间格式化。日期时间格式化是由一个或多个日期时间格式化元素组成,具体信息请查阅 [日期时间格式化](../../../11.sql-reference-oracle-mode/3.basic-elements-1/4.format/3.date-and-time-formatting.md)。将字符串值转换为日期值,是有一些转换规则,关于规则请查阅 [字符串到日期的转换规则](../../../11.sql-reference-oracle-mode/3.basic-elements-1/4.format/5.conversion-rules-from-string-to-date.md)。 - -`RR` 日期时间格式化元素类似于 `YY` 日期时间格式化元素,但它为跨世纪日期值存储提供了额外的灵活性,关于 RR 日式格式化元素,请查阅 [RR 日期时间格式化元素](../../../11.sql-reference-oracle-mode/3.basic-elements-1/4.format/4.rr-date-and-time-format-element.md)。 - -**格式化修饰符** - -OceanBase 数据库暂不支持格式化修饰符 `FX` 和 `FM`。 diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/4.format/2.format-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/4.format/2.format-1.md deleted file mode 100644 index 28923e8fa..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/4.format/2.format-1.md +++ /dev/null @@ -1,129 +0,0 @@ -数值格式化 -========================== - - - -数值格式化指定了存储在数据库中的定点数和浮点数的格式。 - -函数中的数值格式化 ---------------------- - -以下数值数据类型转换函数使用了数值格式化: - -* 当表达式、条件、SQL 函数和 SQL 语句中出现 `NUMBER`,`BINARY_FLOAT` 或 `BINARY_ DOUBLE` 时,且您需要它们的值转换为 `VARCHAR2` 数据类型时,需要用 `TO_CHAR` 函数的参数指定这些数值的格式。 - - - -* 当表达式、条件、SQL 函数和 SQL 语句中出现 `CHAR` 或 `VARCHAR2` 时,如果您需要将他们的值转换为 `NUMBER` 数据类型时,需要用 `TO_NUMBER` 函数的参数(暂不支持 `NLS_NUMERIC_CHARACTERS`)指定这些数值的格式。如果您需要将他们的值转换为 `BINARY_FLOAT` 或 `BINARY_DOUBLE` 时,需要用 `TO_BINARY_FLOAT` 和 `TO_BINARY_DOUBLE` 函数的参数指定数值格式。 - - - - - - -数值格式化会将数值四舍五入,并取有效数字位数。如果某个值的小数位数,左边的有效位数比格式中指定的位数高,则用 `#` 代替该值。如果 `NUMBER` 的正值非常大且无法以指定的格式表示,则使用无穷大符号(〜)替换该值。如果负 `NUMBER` 值非常小且无法用指定的格式表示,则使用负无穷大符号(-〜)替换该值。 - -数值格式化的元素 --------------------- - -与 Oracle 不同,OceanBase 数据库数值格式化元素仅支持标准的数值格式。下表为 OceanBase 数据库支持的数值格式化元素: - - -| 元素 | 示例 | 说明 | -|--------|-----------|---------------------------------------------------------------------| -| .(小数点) | 99.99 | 返回一个小数,且小数点在指定位置。 **限制条件** :在数字格式化中,您只能指定一个小数点。 | -| 0 | 0999 9990 | 0999 返回前导零。9990 返回尾随零。 | -| 9 | 9999 | 返回具有指定位数的值。如果为正,则返回带有有前导空格的数;如果为负,则返回前导负数。前导零返回 0,除了零值,定点数的小数部分返回零。 | - - - -如果省略格式参数,会将数值转为足够长的 `VARCHAR2` 以保留其所有的有效数字。 - -示例 --------------- - -执行以下语句: - -```javascript -SELECT TO_CHAR(0, '99.99') FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+--------------------+ -| TO_CHAR(0,'99.99') | -+--------------------+ -| .00 | -+--------------------+ -``` - - - -下表显示了对不同数值的 **number** 按照格式化元素 'fmt' 查询得到的结果。 - -```javascript -SELECT TO_CHAR(number, 'fmt') FROM DUAL; -``` - - - - -| number | 'fmt' | Result | -|----------|---------|------------| -| 0 | 99.99 | '.00' | -| +0.1 | 99.99 | '.10' | -| -0.2 | 99.99 | '-.20' | -| 0 | 90.99 | '0.00' | -| +0.1 | 90.99 | '0.10' | -| -0.2 | 90.99 | '-0.20' | -| 0 | 9999 | '0' | -| 1 | 9999 | '1' | -| +123.456 | 999.999 | '123.456' | -| -123.456 | 999.999 | '-123.456' | - - - -当省略'fmt'参数的时候: - -```javascript -SELECT TO_CHAR(123.456) FROM DUAL; -``` - - - -显示结果如下: - -```javascript -+------------------+ -| TO_CHAR(123.456) | -+------------------+ -| 123.456 | -+------------------+ -``` - - - -当 `TO_CHAR` 结果超过40字节,或者传入参数为 binary_double/binary_float 类型时,结果将被转为科学计数法。 - -例如: - -```javascript -SELECT TO_CHAR(12355555555555555555555555555555555555555555555555) FROM DUAL; -``` - - - -显示结果如下: - -```javascript -+-------------------------------------------------------------+ -| TO_CHAR(12355555555555555555555555555555555555555555555555) | -+-------------------------------------------------------------+ -| 1.2355555555555555555555555555555556E+49 | -+-------------------------------------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/4.format/3.date-and-time-formatting.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/4.format/3.date-and-time-formatting.md deleted file mode 100644 index 24d128e39..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/4.format/3.date-and-time-formatting.md +++ /dev/null @@ -1,264 +0,0 @@ -日期时间格式化 -============================ - - - -日期时间格式化指定了存储在数据库中日期时间数据的格式。日期时间格式化的总长度不能超过 22 个字符。 - -函数中的日期时间格式化 ------------------------ - -日期时间格式化出现在下面的数据类型转换中: - -* 将非默认格式的字符值转换为日期时间值时,需要 `TO_DATE`、`TO_TIMESTAMP` 和 `TO_TIMESTAMP_TZ` 函数的参数指定日期时间的格式。 - - - -* 将日期时间值转换为非默认格式的字符值时,需要指定 `TO_CHAR` 函数的参数。 - - - - - - -您可以通过以下方式指定日期时间格式。 - -* 通过会话参数 `NLS_DATE_FORMAT`、`NLS_TIMESTAMP_FORMAT` 或 `NLS_TIMESTAMP_TZ_FORMAT` 显式指定。 - - - -* 通过会话参数 `NLS_TERRITORY` 隐式指定。 - - - -* `ALTER SESSION` 语句更改会话的默认日期时间格式。 - - - - -日期时间格式化 -------------------- - -日期时间格式化由一个或多个日期时间格式化元素组成。OceanBase 数据库支持的格式化元素请查阅 **日期时间格式化元素表** 。 - -* 在格式化字符串中,相同的格式化元素不能出现两次,表示类似信息的格式化元素不能组合。例如,您不能在一个格式化字符串中同时使用 `SYYYY` 和 `BC` 元素。 - - - -* 所有格式化元素都可以在 `TO_CHAR`、`TO_DATE`、`TO_TIMESTAMP` 和 `TO_TIMESTAMP_TZ` 函数中使用。 - - - -* 日期时间格式化元素 `FF`、`TZD`、`TZH`、`TZM` 和 `TZR` 可以出现在时间戳和间隔格式化中,但不能出现在 `DATE` 格式中。 - - - -* 许多日期时间格式元素被空白填充或用零填充至指定的长度。 - - - - - -**注意** - - - -建议您使用 4 位数的年份元素(`YYYY`),较短的年份元素会影响查询优化,因为年份只能在运行时确定。 - -### 日期时间格式化元素表 - - - -| 元素 | 日期时间函数是否支持? | 说明 | -|---------------------|-------------|------------------------------------------------------------------------------| -| - / , 。 ; : "文字" | 是 | 标点和引用的文本会在结果中复制。 | -| AD A.D. | 是 | 表示公元纪年法,带有或不带有点号。 | -| AM A.M. | 是 | 表示上午,带有或不带有点号。 | -| BC B.C. | 是 | 表示公元前的年份,带有或不带有点号。 | -| D | 是 | 星期几(1-7)。 | -| DAY | 是 | 一天的名称。 | -| DD | 是 | 每月的一天(1-31)。 | -| DDD | 是 | 一年中的某天(1-366)。 | -| DL | 是 | 只能打印类似 "Monday, January, 01, 1996" 的固定格式。 | -| DS | 是 | 只能打印类似 "10-10-1996" 的固定格式。 | -| DY | 是 | 日期的缩写,返回星期值。 | -| FF \[1..9\] | 是 | 小数秒。使用数字 1\~9 来指定返回值的小数秒部分的位数。默认为日期时间数据类型指定的精度。在时间戳和间隔格式中有效,但在 `DATE` 格式中无效。 | -| FX | 是 | 需要字符数据和格式模型之间的精确匹配。 | -| HHHH12 | 是 | 小时(1-12)。12 小时制 | -| HH24 | 是 | 小时(0-23)。24 小时制 | -| YYYY | 是 | 包含4位数字的年份。 | -| MI | 是 | 分钟(0-59)。 | -| MM | 是 | 月(01-12;一月份表示为 01 )。 | -| MON | 是 | 月份的缩写。 | -| MONTH | 是 | 月份名称。 | -| PM P.M. | 是 | 表示下午,带有或不带有点号。 | -| Q | 是 | 季度(1、2、3、4; 1月-3月是第 1 季度)。 | -| RR | 是 | RR 匹配两位数的年份。 | -| RRRR | 是 | 年。接受4位或2位输入。 | -| SS | 是 | 秒(0-59)。 | -| SSSSS | 是 | 午夜后的秒(0-86400)。 | -| TZD | 是 | 夏令时信息。TZD 值是带有夏令时信息的缩写时区字符串。在时间戳和间隔格式中有效,但在 `DATE` 格式中无效。 | -| TZH | 是 | 时区小时。在时间戳和间隔格式中有效,但在 `DATE` 格式中无效。 | -| TZM | 是 | 时区分钟。在时间戳和间隔格式中有效,但在 `DATE` 格式中无效。 | -| TZR | 是 | 时区区域信息。在时间戳和间隔格式中有效,但在 `DATE` 格式中无效。 | -| X | 是 | 小数点,永远是 '.' 。 | -| Y,YYY | 是 | 带逗号的年。 | -| YYYYSYYYY | 是 | 4位数字的年份。 S 代表用一个负号表示公元前的日期。 | -| YYYYYY | 是 | 年份的后 3、2 或 1 位数字。 | - - -**说明** - - - -日期时间函数指的是 `TO_CHAR`、`TO_DATE`、`TO_TIMESTAMP` 和 `TO_TIMESTAMP_TZ` 。 - -注意,以上转化要求输入的字符串日期能够与格式元素相匹配,否则会报错,例如: - -```javascript -obclient> SELECT TO_DATE( '31 Aug 2020', 'DD MON YYYY' ) FROM DUAL; -+----------------------------------+ -| TO_DATE('31AUG2020','DDMONYYYY') | -+----------------------------------+ -| 2020-08-31 00:00:00 | -+----------------------------------+ -1 row in set (0.00 sec) -``` - - -**注意** - - - -OceanBase 数据库中默认的日期格式为 **DD-MON-RR** ,如果要显示为上面的格式,可以通过执行 `alter session set NLS_DATE_FORMAT = 'YYYY-MM-DD HH24:MI:SS';` 修改当前会话的日期时间格式。 - -当您的格式串漏掉了一些元素时,会得到系统的报错信息: - -```javascript -obclient> SELECT TO_DATE( '31 Aug 2020', 'DD MON YYY' ) FROM DUAL; -ORA-01830: date format picture ends before converting entire input string -``` - - - -### 日期格式化元素中的大写字母 - -拼写出来的单词、缩写词或罗马数字中的大写字母在相应的格式元素中也跟着大写。例如,日期格式元素 `DAY` 产生的 `MONDAY` 也大写,`Day` 和 `Monday` 格式一样,`day` 和 `monday` 格式一样。 - -```javascript -obclient> SELECT TO_CHAR(sysdate,'mon') AS nowMonth FROM DUAL; -+----------+ -| NOWMONTH | -+----------+ -| mar | -+----------+ -1 row in set (0.00 sec) - -obclient> SELECT TO_CHAR(sysdate,'MON') AS nowMonth FROM DUAL; -+----------+ -| NOWMONTH | -+----------+ -| MAR | -+----------+ -1 row in set (0.00 sec) -``` - - - -### 日期时间格式化中的标点符号和字符字面量 - -以下字符需要日期格式化,这些字符出现在返回值中的位置与格式化中字符的位置相同: - -* 标点符号,例如连字符,斜杠,逗号,句号和冒号。 - - - -* 字符字面量,用双引号引起来。 - - - - - - -OceanBase 数据库可以灵活的将字符串转换为日期。当您使用 `TO_DATE` 函数时,若输入字符串中的每个数字元素都包含格式化允许的最大位数,则格式字符串将与输入的字符串匹配。 - -* **示例 1** :格式元素 **MM/YY** ,其中 **02** 对应 **MM** , **07** 对应 **YY** 。 - - - - -执行以下语句: - -```javascript -SELECT TO_CHAR(TO_DATE('0207','MM/YY'),'MM/YY') FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+------------------------------------------+ -| TO_CHAR(TO_DATE('0207','MM/YY'),'MM/YY') | -+------------------------------------------+ -| 02/07 | -+------------------------------------------+ -``` - - - -* **示例 2** :OceanBase 数据库允许非字母数字字符与格式化中的标点字符匹配, **#** 对应 **/** 。 - - - - -执行以下语句: - -```javascript - SELECT TO_CHAR (TO_DATE('02#07','MM/YY'), 'MM/YY') FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+-------------------------------------------+ -| TO_CHAR(TO_DATE('02#07','MM/YY'),'MM/YY') | -+-------------------------------------------+ -| 02/07 | -+-------------------------------------------+ -``` - - - -日期格式化元素与全球化支持 -------------------------- - -在 OceanBase 数据库中,日期时间格式化元素的语言可以通过参数 `NLS_DATE_LANGUAGE` 和 `NLS_LANGUAGE` 指定。默认值是 `AMERICAN`,不支持修改,所以不支持全球化。 - -**示例** :日期时间格式化的语言参数默认是 `American`,不支持其他语言。 - -```javascript -SELECT TO_CHAR (SYSDATE, 'DD/MON/YYYY', 'nls_date_language=''Traditional Chinese'' ') FROM DUAL; -``` - - - -查询结果报错,语言参数不支持。 - -```javascript -ORA-12702: invalid NLS parameter string used in SQL function -``` - - - -更多信息 ----------------- - -* [字符串到日期的转换规则](bq7tvb) - - - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/4.format/4.rr-date-and-time-format-element.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/4.format/4.rr-date-and-time-format-element.md deleted file mode 100644 index 16d427d54..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/4.format/4.rr-date-and-time-format-element.md +++ /dev/null @@ -1,56 +0,0 @@ -RR 日期时间格式化元素 -================================= - - - -`RR` 日期时间格式化元素类似于 `YY` 日期时间格式化元素,但它为跨世纪日期值存储提供了额外的灵活性。在 `YY` 日期时间格式化元素里,您需要指定年份的全部数字。而在 `RR` 日期时间格式化元素里,您只需指定年份数字的最后两位数,便可以存储日期值。 - -`RR` 日期时间格式化元素与 `TO_DATE` 函数一起使用,返回值的世纪根据指定的两位数字年份和当前年份的最后两位数字而变化。如果 `YY` 日期时间格式化元素与 `TO_DATE` 函数一起使用,则返回的年份始终与当前年份具有相同的世纪。 - -如果指定的两位数字年份是 00\~49,当前年份的最后两位数字是 00\~49,则返回的年份与当前年份具有相同的世纪。当前年份的后两位数字是 50\~99,则返回年份的前两位数字为下一个世纪。 - -如果指定的两位数字年份是 50\~99,当前年份的后两位数字为 00 到 49,则返回年份的前两位数字为当前年份 的上一个世纪。当前年份的最后两位数字是 50\~99,则返回的年份与当前年份处于同一个世纪。 - -如下所示,`RR` 日期时间格式化元素根据前两位数字不同的年份返回相同的值。假设这些查询是在 1950\~1999 年期间发出的,执行以下语句: - -```javascript -SELECT TO_CHAR(TO_DATE('27-OCT-98', 'DD-MON-RR'), 'YYYY') "Year1" , -TO_CHAR(TO_DATE('27-OCT-17', 'DD-MON-RR'), 'YYYY') "Year2" FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+-------+-------+ -| Year1 | Year2 | -+-------+-------+ -| 1998 | 2017 | -+-------+-------+ -``` - - - -假设这些查询是在 2000\~2049 年期间发出的,执行以下语句: - -```javascript -SELECT TO_CHAR(TO_DATE('27-OCT-98', 'DD-MON-RR'), 'YYYY') "Year1" , -TO_CHAR(TO_DATE('27-OCT-17', 'DD-MON-RR'), 'YYYY') "Year2" FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+-------+-------+ -| Year1 | Year2 | -+-------+-------+ -| 1998 | 2017 | -+-------+-------+ -``` - - - -通过上面 2 个示例的查询结果可见,无论是在 2000 年之前还是之后查询,都将返回相同的值。 diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/4.format/5.conversion-rules-from-string-to-date.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/4.format/5.conversion-rules-from-string-to-date.md deleted file mode 100644 index cc5f1d742..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/4.format/5.conversion-rules-from-string-to-date.md +++ /dev/null @@ -1,21 +0,0 @@ -字符串到日期的转换规则 -================================ - - - -将字符串值转换为日期值时,会有下列转换规则: - -* 如果指定了数值格式化元素的所有数值(包括前导零点),则可以从日期字符串中省略格式化字符串中包含的标点符号。为两位数格式化元素(如 `MM`、`DD` 和 `YY`)指定 02 而不是 2。 - - - -* 您可以从日期字符串中省略在格式化字符串末尾找到的时间字段。 - - - -* 您可以在日期字符串中使用任何非字母数值字符来匹配格式化字符串中的标点符号。 - - - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/5.null/1.empty-value-overview.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/5.null/1.empty-value-overview.md deleted file mode 100644 index 79c115866..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/5.null/1.empty-value-overview.md +++ /dev/null @@ -1,28 +0,0 @@ -空值概述 -========================= - - - -空值(Null)指数据库表中无效的、未指定的、未知的或不可预知的值。空值的出现不受 `NOT NULL` 或 `PRIMARY KEY` 主键约束。任何包含 `NULL` 的算术表达式结果都为 `NULL` 。 - -OceanBase 支持以下 3 种空值类型。 - -**SQL 函数中的空值** - -SQL 函数中的空值 指的是 SQL 函数的参数为空值,当 SQL 函数的参数为空值时,大多数标量函数都返回 `NULL`,分析函数会忽略空值。此类别中有以下两种 SQL 函数: - - -| 空值 | 说明 | -|------------|-----------------------------------------------------------------------| -| NVL 函数中的空值 | 在表达式中 `NVL(expr1,expr2)`中,如果 `expr1` 不是 NULL,返回 `expr1`,否则返回 `expr2`。 | -| 分析函数中的空值 | 使用 `AVG`、`MAX`、`SUM` 或 `COUNT` 等分析函数时,为 NULL 的纪录会被忽略。 | - - - -**比较条件中的空值** - -比较条件中的空值 指与任何其他条件做比较的 `NULL` 。测试空值只能用比较运算符 `IS NULL` 和 `IS NOT NULL` 。因为 `NULL` 表示缺少数据,所以 `NULL` 和其它值没有可比性,即不能用等于、不等于、大于或小于和其它数值比较,当然也包括空值本身。 - -**条件判断表达式中的空值** - -条件判断表达式中的空值 指的是条件 `= NULL`、`!= NULL`、 `NULL =`、`NULL !=` 中的 `NULL`,作逻辑判断使用,判断结果不返回任何行,即 `UNKNOWN`。 diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/5.null/2.null-values-in-sql-functions.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/5.null/2.null-values-in-sql-functions.md deleted file mode 100644 index 79d48bee5..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/5.null/2.null-values-in-sql-functions.md +++ /dev/null @@ -1,88 +0,0 @@ -SQL 函数中的空值 -=============================== - - - -SQL 函数中的空值指的是 SQL 函数的参数存在空值,当 SQL 函数的参数为空值时,大多数标量函数都返回 `NULL`,分析函数会忽略空值。您可以通过 `NVL` 函数的返回值确定空值。 - -NVL 函数中的空值 ----------------------- - -`NVL` 函数的表达式为 `NVL(expr1,expr2)`,如果 `expr1` 不是 `NULL`,返回 `expr1`,否则返回 `expr2`。 - -如下所示,给定 `expr1` 参数为 `NULL`,查询 `NVL(expr1,0)` 表达式的返回值。 - -执行以下语句: - -```javascript -SELECT NVL(NULL,0) FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+-------------+ -| NVL(NULL,0) | -+-------------+ -| 0 | -+-------------+ -``` - - - -`expr1` 是 `NULL`,则表达式 `NVL(expr1,0)` 的返回值为 0;`expr1` 不是 `NULL`,则表达式的返回值为 `expr1`。 - -分析函数中的空值 --------------------- - -在使用 `AVG`,`MAX`,`SUM`,`COUNT` 等分析函数时,为 `NULL` 的纪录会被忽略。 - -如下所示,向 **tbl_a** 表中插入数据并执行以下语句: - -```javascript -CREATE TABLE tbl_a (col_a varchar2(1), col_b int ); -INSERT INTO tbl_a VALUES (NULL, 3); -INSERT INTO tbl_a VALUES (NULL, NULL); -INSERT INTO tbl_a VALUES (NULL, 1); -``` - - - -执行以下语句: - -```javascript -SELECT * FROM tbl_a; -``` - - - -查询结果如下: - -```javascript -+-------+-------+ -| COL_A | COL_B | -+-------+-------+ -| NULL | 3 | -| NULL | NULL | -| NULL | 1 | -+-------+-------+ -``` - - - -查询的结果如下: - -```javascript -SELECT AVG(col_b) FROM tbl_a; -- 结果为 2 , -SELECT MAX(col_b) FROM tbl_a; -- 结果为 3 -SELECT SUM(col_b) FROM tbl_a; -- 结果为 4 -SELECT COUNT(col_b) FROM tbl_a; -- 结果为 2 -SELECT COUNT(col_a) FROM tbl_a; -- 结果为 0 -SELECT COUNT(*) FROM tbl_a; -- 结果为 3 -``` - - - -`NULL` 的纪录被忽略了。 diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/5.null/3.null-values-in-comparison-conditions.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/5.null/3.null-values-in-comparison-conditions.md deleted file mode 100644 index d13053c2f..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/5.null/3.null-values-in-comparison-conditions.md +++ /dev/null @@ -1,21 +0,0 @@ -比较条件中的空值 -============================= - - - -比较条件中的空值指与任何其他条件做比较的 `NULL`。测试空值只能用比较运算符 `IS NULL` 和 `IS NOT NULL` 。因为 `NULL` 表示缺少数据,所以 `NULL` 和其它值没有可比性,即不能用等于、不等于、大于或小于和其它数值比较,当然也包括空值本身。 - -另外,OceanBase 数据库在计算 `DECODE` 函数时认为两个空值是相等的。若两个空值出现在复合键中,则它们也相等。 - -如下所示,根据 A 值判断比较条件的结果。 - - -| 条件 | A 值 | 结果 | -|---------------|------|-------| -| A IS NULL | 10 | FALSE | -| A IS NOT NULL | 10 | TRUE | -| A IS NULL | NULL | TRUE | -| A IS NOT NULL | NULL | FALSE | - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/5.null/4.null-values-in-conditional-expressions.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/5.null/4.null-values-in-conditional-expressions.md deleted file mode 100644 index b1b5509fb..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/5.null/4.null-values-in-conditional-expressions.md +++ /dev/null @@ -1,24 +0,0 @@ -条件判断表达式中的空值 -================================ - - - -条件判断表达式中的空值指的是条件 `= NULL`、`!= NULL`、 `NULL =`、`NULL !=` 中的 `NULL`,作逻辑判断使用,判断结果不返回任何行,即 `UNKNOWN`。 - -在 OceanBase 中,测试空值要用比较运算符 `IS NULL` ,返回结果为 `TRUE` 或 `FALSE` 。但是条件判断表达式中空值的判断结果 `UNKNOWN` 与 `FALSE` 不同,`NOT FALSE` 判断结果为 `TRUE`, `NOT UNKNOWN` 判断结果仍然为 `UNKNOWN`。 - -如下所示,根据 A 值判断条件判断表达式的结果。 - - -| 条件 | A 值 | 结果 | -|-----------|------|---------| -| A = NULL | 10 | UNKNOWN | -| A != NULL | 10 | UNKNOWN | -| A = NULL | NULL | UNKNOWN | -| A != NULL | NULL | UNKNOWN | -| A = 10 | NULL | UNKNOWN | -| A != 10 | NULL | UNKNOWN | - - - -如果在 `SELECT` 语句的 `WHERE` 子句中使用了判断结果为 `UNKNOWN` 的条件,则该查询将不返回任何行。 diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/1.annotation-overview.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/1.annotation-overview.md deleted file mode 100644 index 1d1e54a7f..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/1.annotation-overview.md +++ /dev/null @@ -1,21 +0,0 @@ -注释概述 -========================= - - - -OceanBase 中用户可以创建三种注释: - -* [SQL 语句的注释](../../../11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/2.comments-on-the-sql-statement.md):被存储为执行 SQL 语句的应用程序代码的一部分。 - - - -* [Schema 与非 Schema 对象的注释](../../../11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/3.comment-on-schema-and-non-schema-objects.md):与对象本身的元数据一起存储在数据字典中。 - - - -* [Hint](../../../11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/4.Hint/1.hint-overview.md):一种在 SQL 语句中将指令传递给 OceanBase 数据库优化器的注释。 - - - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/2.comments-on-the-sql-statement.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/2.comments-on-the-sql-statement.md deleted file mode 100644 index a509ada18..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/2.comments-on-the-sql-statement.md +++ /dev/null @@ -1,64 +0,0 @@ -SQL 语句的注释 -============================== - - - -注释可以使应用程序更易于阅读和维护。例如,您可以在语句中用注释以描述该语句在应用程序中的用途。除 Hint 外,SQL 语句中的注释不会影响语句的执行。 - -注释可以出现在语句中的任何关键字、参数或标点符号之间。您可以通过两种方式在语句中添加注释: - -* 以斜杠和星号(/\*)为开头的注释。斜杠和星号后跟着注释的文本。此文本可以跨越多行,并用星号和斜杠(\*/)结束注释。开头和结尾的符号不必与文本用空格或换行符进行分隔。 - - - -* 以两个连字符(--)为开头的注释。符号后跟着注释的文本。此文本不能扩展到新行,并以换行符结束注释。 - - - - - - -一个 SQL 语句可以同时包含这两种风格的多个注释。注释的文本可以包含数据库字符集中的任何可打印字符。 - -以下示例展示了多种形式的以斜杠和星号(/\*)为开头的注释: - -```javascript -SELECT last_name, employee_id, salary + NVL(commission_pct, 0), - job_id, e.department_id - /* Select all employees whose compensation is - greater than that of Pataballa.*/ - FROM employees e, departments d - /*The DEPARTMENTS table is used to get the department name.*/ - WHERE e.department_id = d.department_id - AND salary + NVL(commission_pct,0) > /* Subquery: */ - (SELECT salary + NVL(commission_pct,0) - /* total compensation is salary + commission_pct */ - FROM employees - WHERE last_name = 'Pataballa') - ORDER BY last_name, employee_id; -``` - - - -以下示例中的语句包含多种形式的以两个连字符(- -)为开头的注释: - -```javascript -SELECT last_name, -- select the name - employee_id -- employee id - salary + NVL(commission_pct, 0), -- total compensation - job_id, -- job - e.department_id -- and department - FROM employees e, -- of all employees - departments d - WHERE e.department_id = d.department_id - AND salary + NVL(commission_pct, 0) > -- whose compensation - -- is greater than - (SELECT salary + NVL(commission_pct,0) -- the compensation - FROM employees - WHERE last_name = 'Pataballa') -- of Pataballa - ORDER BY last_name -- and order by last name - employee_id -- and employee id. -; -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/3.comment-on-schema-and-non-schema-objects.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/3.comment-on-schema-and-non-schema-objects.md deleted file mode 100644 index f6a326e80..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/3.comment-on-schema-and-non-schema-objects.md +++ /dev/null @@ -1,43 +0,0 @@ -Schema 与非 Schema 对象的注释 -=========================================== - - - -可以使用 `COMMENT` 语句将注释与 Schema 对象(表、视图、物化视图、运算符、索引类型)或非 Schema 对象(Edition)关联起来。还可以在表模式对象的列上创建注释。与 Schema 和非 Schema 对象关联的注释存储在数据字典中。 - -语法格式 -------------------------- - -```javascript -COMMENT ON {TABLE table | COLUMN column | INDEXTYPE indextype -| OPERATOR operator | VIEW view} IS string -``` - - - -示例 ------------------------ - -* 对 user 表注释 - - ```unknow - COMMENT ON TABLE test.user is "这是记录用户信息的表"; - ``` - - - -* 对 user_name 列注释 - - ```unknow - COMMENT ON COLUMN test.user.user_name is "这里记录了用户的姓名"; - ``` - - - - - - - - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/4.Hint/1.hint-overview.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/4.Hint/1.hint-overview.md deleted file mode 100644 index 15480ef9a..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/4.Hint/1.hint-overview.md +++ /dev/null @@ -1,102 +0,0 @@ -Hint 概述 -============================ - - - -Hint 是 SQL 语句中将指令传递给 OceanBase 数据库优化器或服务器的一种注释。通过 Hint 可以使优化器或服务器生成某种特定的计划。 一般情况下,优化器会为用户查询选择最佳的执行计划,不需要用户主动使用 Hint 指定,但在某些场景下,优化器生成的执行计划可能不满足用户的要求,这时就需要用户使用 Hint 来主动指定并生成特殊的执行计划。 - -Hint 应该少用,仅在您收集了相关表的统计信息并且使用 `EXPLAIN PLAN` 语句在没有 Hint 的情况下评估了优化器计划之后,才谨慎考虑使用。更改数据库条件以及在后续版本中增强查询性能可能会导致您代码中的 Hint 对性能产生重大影响。 - -Hint 的使用 --------------------- - -一个语句块只能有一个注释包含 Hint,并且该注释必须跟随 `SELECT`、`UPDATE`、`INSERT`、`MERGE` 或 `DELETE` 关键字。 - -以下是 Hint 在语句块注释中的语法格式: - -```javascript -/*+[hint text]*/ -``` - - - -Hint 从语法上看是一种特殊的 SQL 注释, 所不同的是在注释的左标记后增加了一个加号(+)。 如果服务器端无法识别 SQL 语句中的 Hint,那么优化器会选择忽略用户指定的 Hint 而使用默认计划所生成逻辑。另外需要指明的是,Hint 只影响优化器所生成的计划的逻辑,而不影响 SQL 语句的语义。 - -以下是定义 Hint 时需要注意的一些规则: - -* 加号(+)使数据库将注释解释为 Hint 列表。加号必须紧跟在注释左标记符后,不允许有空格。 - - - -* 加号(+)和 Hint 文本之间的空格是可选的。如果注释中包含多个 Hint,则 Hint 间至少用一个空格进行分隔。 - - - -* Hint 包含拼写错误或语法错误时会被忽略。但是,数据库会考虑在同一注释中其他正确指定的 Hint。 - - - -* 不跟随 `DELETE`、`INSERT`、`MERGE`、`SELECT` 或 `UPDATE` 关键字的 Hint 无效。 - - - -* Hint 的组合相互冲突时 Hint 无效。但是,数据库会在同一注释中考虑其他不冲突的 Hint。 - - - -* 数据库环境使用 PL/SQL 版本 1 时 Hint 无效,例如 Forms 版本 3 触发器。 - - - - - - -在 Hint 中定义查询块 -------------------------- - -您可以通过在许多 Hint 中定义一个可选的查询块名称,以此来指定该 Hint 适用的查询块。使用此语法,允许您在外部查询中指定一个应用于嵌入式视图的 Hint。 - -查询块参数的语法格式为 `@queryblock`,其中 `queryblock` 是在查询中被指定的查询块的标识符。`queryblock` 标识符可以是系统生成的,也可以是用户自己指定的。当您在查询块中直接指定要应用的 Hint 时,将忽略 `@queryblock`。 - -* 系统生成的标识符可以通过对查询使用 `EXPLAIN PLAN` 生成,预转换查询块的名称可以通过对使用了 `NO_QUERY_TRANSFORMATION` Hint 的查询运行 `EXPLAIN PLAN` 生成。 - - - -* 可以使用 QB_NAME 来指定用户自定义的名称。 - - - - - - -定义全局 Hint ---------------------- - -许多 Hint 既可以应用于特定的表或索引,也可以更全局地应用于视图中的表或一部分索引的列。语法元素 `tablespec` 和 `indexspec` 定义了这些全局 Hint。 - -以下是 `tablespec` 的语法: - -```javascript -[ view.[ view. ]... ]table -``` - - - -您必须完全按照在语句中显示的方式来指定要访问的表。如果该语句使用表的别名,则在 Hint 中使用也使用别名而不是表名。但是,即使 Schema 名称出现在语句中,也不要在 Hint 中使用的表名中包含 Schema 名称。 -**注意** - - - -使用 `tablespec` 子句指定全局 Hint 对于使用 ANSI 连接的查询不起作用,因为优化器在解析期间会生成额外的视图。相反,可以通过 `@queryblock` 来指定该提示所应用到的查询块。 - -以下是 `indexspec` 的语法: - -```javascript -{ index -| ( [ table. ]column [ [ table. ]column ]...) -} -``` - - - -在 Hint 的说明部分,当 `tablespec` 后跟着 `indexspec` 时,允许但不要求使用逗号来分隔表名和索引名。也允许(但不是必需)使用逗号分隔多次出现的 `indexspec`。 diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/4.Hint/2.hint-list/1.the-hint-related-to-the-access-path.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/4.Hint/2.hint-list/1.the-hint-related-to-the-access-path.md deleted file mode 100644 index 7ba527072..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/4.Hint/2.hint-list/1.the-hint-related-to-the-access-path.md +++ /dev/null @@ -1,71 +0,0 @@ -与访问路径相关的 Hint -================================== - - - -INDEX Hint ----------------------- - -`INDEX` Hint 指示优化器对指定的表使用索引扫描。您可以将 `INDEX` Hint 用于基于函数、域、B - 树、位图和位图连接的索引。 - -以下是 `INDEX` Hint 的语法: - -```javascript -/*+ INDEX ( [ @ queryblock ] tablespec [ indexspec [ indexspec ]... ] ) */ -``` - - - -Hint 的行为取决于 `indexspec` 规范: - -* 如果 `INDEX` Hint 指定了一个单个可用索引,则数据库将对该索引执行扫描。优化器不考虑全表扫描或表上另一个索引的扫描。 - - - -* 如果 `INDEX` Hint 指定了可用索引的列表,那么优化器将考虑扫描列表中每个索引的成本,然后以最低的成本执行索引扫描。如果数据库从这个列表中扫描多个索引并合的访问路径成本最低,数据库将选用这种扫描方案。数据库不考虑对没有在列表中的索引进行全表扫描或扫描。 - - - -* 如果 `INDEX` Hint 没有指定具体的索引,那么优化器将考虑表上每个可用索引的扫描成本,然后以最低的成本执行索引扫描。如果数据库扫描多个索引并合的访问路径成本最低,数据库将选用这种扫描方案。优化器不考虑全表扫描。 - - - - - - -示例如下: - -```javascript -SELECT /*+ INDEX (employees emp_department_ix)*/ employee_id, department_id -FROM employees -WHERE department_id > 50; -``` - - - -FULL Hint ---------------------- - -`FULL` Hint 指示优化器对指定的表执行全表扫描。 - -以下是 `FULL` Hint 的语法: - -```javascript -/*+ FULL ( [ @ queryblock ] tablespec ) */ -``` - - - -示例如下: - -```javascript -SELECT /*+ FULL(e) */ employee_id, last_name -FROM hr.employees e -WHERE last_name LIKE :b1; -``` - - - -数据库对表 **employees** 执行一次完整的表扫描来执行这条语句,即使有一个由 `WHERE` 子句中的条件提供的索引在列 **last_name** 上。 - -在 `FROM` 子句中,表 **employees** 有个别名 **e** ,因此 Hint 必须根据表的别名而不是名称来引用该表。即使在 `FROM` 子句中指定了 Schema 名,也不要在 Hint 中引用它们。 diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/4.Hint/2.hint-list/2.hint-related-to-the-join-order.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/4.Hint/2.hint-list/2.hint-related-to-the-join-order.md deleted file mode 100644 index 352194e74..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/4.Hint/2.hint-list/2.hint-related-to-the-join-order.md +++ /dev/null @@ -1,46 +0,0 @@ -与联接顺序相关的 Hint -================================== - - - -LEADING Hint ---------------------- - -`LEADING` Hint 指示优化器在执行计划中使用指定的表集作为前缀,它可以用来指定表的联接顺序。这个 Hint 比 `ORDERED` Hint 更通用。 - -以下是 `LEADING` Hint 的语法: - -```javascript -/*+ LEADING ( [ @ queryblock ] tablespec [ tablespec ]... ) */ -``` - - - -`LEADING` Hint 为确保按照用户指定的顺序联接表,所以会进行严格的检查。如果发现 Hint 指定的 `table_name` 不存在,则 `LEADING` Hint 失效。如果发现 Hint 中存在重复表,则 `LEADING` Hint 失效。如果在优化器联接期间,无法找到对应的表,那么该表及后面的表指定的联接顺序失效,该表前面指定的顺序依然有效。如果由于联接图中的依赖关系,无法首先按照指定的顺序联接指定的表,则 `LEADING` Hint 失效。如果指定两个或多个相互冲突的 `LEADING` Hint,则 `LEADING` Hint 失效。如果您指定了 `ORDERED` Hint,它将覆盖所有的 `LEADING` Hint。 - -示例如下: - -```javascript -SELECT /*+ LEADING(e j) */ * - FROM employees e, departments d, job_history j - WHERE e.department_id = d.department_id - AND e.hire_date = j.start_date; -``` - - - -ORDERED Hint ------------------------- - -`ORDERED` Hint 指示数据库按照表在 `FROM` 子句中出现的顺序联接表。建议使用 `LEADING` Hint,它比 `ORDERED` Hint 更通用。 - -以下是 `ORDERED` Hint 的语法: - -```javascript -/*+ ORDERED */ -``` - - - -当您从需要联接的SQL语句中省略 `ORDERED` Hint 时,将由优化器将选择联接表的顺序。但是优化器不知道从每个表中要选择的行数,此时您可以使用 `ORDERED` Hint 来指定联接顺序。这样使您能够比优化器更好地选择内部表和外部表。如果在指定该 `ORDERED` Hint 后发生了改写,那么就按照改写后的语句中的 `FROM` 子句的顺序联接表。 - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/4.Hint/2.hint-list/3.hints-related-to-join-operations.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/4.Hint/2.hint-list/3.hints-related-to-join-operations.md deleted file mode 100644 index 36275a1e3..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/4.Hint/2.hint-list/3.hints-related-to-join-operations.md +++ /dev/null @@ -1,191 +0,0 @@ -与联接操作相关的 Hint -================================== - - - -USE_MERGE Hint --------------------------- - -`USE_MERGE` Hint 指示优化器使用一个 `sort-merge` 联接将每个指定的表与另一个行资源联接起来。建议在使用 `USE_NL` 和 `USE_MERG` Hint 时和 `LEADING` 与 `ORDERED` Hint 一起使用。当被引用的表是联接的内部表时,优化器将使用这些提示。如果被引用的表是外部表,则忽略 Hint。 - -以下是 `USE_MERGE` Hint 的语法: - -```javascript -/*+ USE_MERGE ( [ @ queryblock ] tablespec [ tablespec ]... ) */ -``` - - - -`USE_MERGE` 指定表作为内部表时候使用 MERGE-JOIN 算法。OceanBase 中使用 MERGE-JOIN 算法时必须有等值条件的 `join-condition`,因此无等值条件的两个表做联结时,`USE_MERGE` 失效。 - -以下是 `USE_MERGE` 的示例: - -```javascript -SELECT /*+ USE_MERGE(employees departments) */ * -FROM employees, departments -WHERE employees.department_id = departments.department_id; -``` - - - -NO_USE_MERGE Hint ------------------------------ - -`NO_USE_MERGE` Hint 指示优化器在使用指定表作为内部表并联接到另一个行资源时排除 `USE_MERGE` Hint 使用的联接。 - -以下是 `NO_USE_MERGE` Hint 的语法: - -```javascript -/*+ NO_USE_MERGE ( [ @ queryblock ] tablespec [ tablespec ]... ) */ -``` - - - -以下是 `NO_USE_MERGE` Hint 的示例: - -```javascript -SELECT /*+ NO_USE_MERGE(e d) */ * -FROM employees e, departments d -WHERE e.department_id = d.department_id; -``` - - - -USE_HASH Hint -------------------------- - -`USE_HASH` Hint 指示优化器使用 HASH-JOIN 算法将每个指定的表与另一个行资源联接起来。 - -以下是 `USE_HASH` Hint 的语法: - -```javascript -/*+ USE_HASH ( [ @ queryblock ] tablespec [ tablespec ]... ) */ -``` - - - -以下是 `USE_HASH` Hint 的示例: - -```javascript -SELECT /*+ USE_HASH(l h) */ * - FROM orders h, order_items l - WHERE l.order_id = h.order_id - AND l.order_id > 2400; -``` - - - -NO_USE_HASH Hint ----------------------------- - -`NO_USE_HASH` Hint 指示优化器在使用指定表作为内部表并联接到另一个行资源时排除 `USE_HASH` Hint 使用的联接。 - -以下是 `NO_USE_HASH` Hint 的语法: - -```javascript -/*+ NO_USE_HASH ( [ @ queryblock ] tablespec [ tablespec ]... ) */ -``` - - - -以下是 `NO_USE_HASH` Hint 的示例: - -```javascript -SELECT /*+ NO_USE_HASH(e d) */ * -FROM employees e, departments d -WHERE e.department_id = d.department_id; -``` - - - -USE_NL Hint ------------------------ - -`USE_NL` Hint 指示优化器使用嵌套循环联接将每个指定的表连接到另一个行资源,并使用指定的表作为内部表,指定表作为内部表时使用 NL-JOIN 算法。建议在使用 `USE_NL` 和 `USE_MERG` Hint 时和 `LEADING` 与 `ORDERED` Hint 一起使用。当被引用的表是联接的内部表时,优化器将使用这些提示。如果被引用的表是外部表,则忽略 Hint。 - -以下是 `USE_NL` Hint 的语法: - -```javascript -/*+ USE_NL ( [ @ queryblock ] tablespec [ tablespec ]... ) */ -``` - - - -在下面的示例中,Hint 强制执行了嵌套循环,通过全表扫描访问了 **orders** 并且筛选条件 `l.order_id = h.order_id` 应用在了每一行。对于满足筛选条件的每一行,通过索引 **order_id** 访问 **order_items** : - -```javascript -SELECT /*+ USE_NL(l h) */ h.customer_id, l.unit_price * l.quantity -FROM orders h, order_items l -WHERE l.order_id = h.order_id; -``` - - - -NO_USE_NL Hint --------------------------- - -`NO_USE_NL` Hint 指示优化器在使用指定表作为内部表并联接到另一个行资源时排除 Nest-Loop 联接。 - -以下是 `NO_USE_NL` Hint 的语法: - -```javascript -/*+ NO_USE_NL ( [ @ queryblock ] tablespec [ tablespec ]... ) */ -``` - - - -以下是 `NO_USE_NL` Hint 的示例: - -```javascript -SELECT /*+ NO_USE_NL(e d) */ * -FROM employees e, departments d -WHERE e.department_id = d.department_id; -``` - - - -USE_BNL Hint ------------------------- - -`USE_BNL` Hint 指示优化器使用块嵌套循环联接将每个指定的表连接到另一个行资源,并使用指定的表作为内部表,指定表作为内部表时使用 BNL-JOIN 算法。建议在使用 `USE_BN` Hint 时和 `LEADING` 与 `ORDERED` Hint 一起使用。当被引用的表是联接的内部表时,优化器将使用这些提示。如果被引用的表是外部表,则忽略 Hint。 - -以下是 `USE_BNL` Hint 的语法: - -```javascript -/*+ USE_BNL ( [ @ queryblock ] tablespec [ tablespec ]... ) */ -``` - - - -在下面的示例中,Hint 强制执行了块嵌套循环,通过全表扫描访问了 **orders** 并且筛选条件 `l.order_id = h.order_id` 应用在了每一行。对于满足筛选条件的每一行,通过索引 **order_id** 访问 **order_items** : - -```javascript -SELECT /*+ USE_BNL(l h) */ h.customer_id, l.unit_price * l.quantity -FROM orders h, order_items l -WHERE l.order_id = h.order_id; -``` - - - -NO_USE_BNL Hint ---------------------------- - -`NO_USE_BNL` Hint 指示优化器在使用指定表作为内部表并联接到另一个行资源时排除 `USE_BNL` Hint 使用的联接。 - -以下是 `NO_USE_BNL` Hint 的语法: - -```javascript -/*+ NO_USE_BNL ( [ @ queryblock ] tablespec [ tablespec ]... ) */ -``` - - - -以下是 `NO_USE_BNL` Hint 的示例: - -```javascript -SELECT /*+ NO_USE_BNL(e d) */ * -FROM employees e, departments d -WHERE e.department_id = d.department_id; -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/4.Hint/2.hint-list/4.hints-related-to-parallel-execution.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/4.Hint/2.hint-list/4.hints-related-to-parallel-execution.md deleted file mode 100644 index cce0e3e41..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/4.Hint/2.hint-list/4.hints-related-to-parallel-execution.md +++ /dev/null @@ -1,207 +0,0 @@ -与并行执行相关的 Hint -================================== - - - -PARALLEL Hint -------------------------- - -`PARALLEL` Hint 是语句级的 Hint,用来指示优化器指定并行操作可使用的并行服务器的数量。此 Hint 将覆盖初始化参数 `PARALLEL_DEGREE_ POLICY` 的值。该 Hint 适用于语句的 `SELECT`、`INSERT`、`MERGE`、`UPDATE` 和 `DELETE` 部分,以及表扫描的部分。如果违反了任何的并行限制,则 `PARALLEL` Hint 被忽略。 - -以下是 `PARALLEL` Hint 的语法: - -```javascript -/*+ PARALLEL [ ( DEFAULT | AUTO | MANUAL | integer ) ] */ -``` - - -**注意** - - - -如果还进行了排序或分组操作,那么可以使用的服务器数量是 `PARALLEL` Hint 中的值的两倍。 - -`PARALLE` Hint 中指定参数的值时: - -* `PARALLEL`:数据库计算并行度,可以为 2 或更大。语句一直并行执行。 - -* `PARALLEL(DEFAULT)` :优化器计算的并行度等于所有参与实例上可用的 CPU 数量乘以初始化参数 `PARALLEL_THREADS_PER_CPU` 的值。 - -* `PARALLEL(AUTO)` :数据库计算并行度,结果可以大于等于 1,如果计算出的并行度为 1,则该语句按顺序运行。 - -* `PARALLEL(MANUAL)`:优化器被强制使用语句中设置的对象的并行度。 - -* `PARALLEL(integer)`:优化器使用参数 `integer` 指定的整数值为并行度。 - - - - -以下示例中数据库计算并行度,并且语句一直并行执行: - -```javascript -SELECT /*+ PARALLEL */ last_name -FROM employees; -``` - - - -以下示例中数据库计算并行度,但是并行度为 1,所以该语句串行执行: - -```javascript -SELECT /*+ PARALLEL (AUTO) */ last_name -FROM employees; -``` - - - -在以下示例中,`PARALLEL` Hint 建议优化器使用语句中设定的,当前对表本身有效的并行度 5: - -```javascript -CREATE TABLE parallel_table (col1 number, col2 VARCHAR2(10)) PARALLEL 5; -SELECT /*+ PARALLEL (MANUAL) */ col2 - FROM parallel_table; -``` - - - -USE_PX Hint ------------------------ - -`USE_PX` Hint 强制指示服务器在执行 SQL 语句时使用 PX 模式,PX 模式允许在执行语句时采用多线程方式。一般 `USE_PX` Hint 和 `PARALLEL` Hint 配合使用。 - -以下是 `USE_PX` Hint 的语法: - -```javascript -/*+ USE_PX */ -``` - - - -示例如下: - -```javascript -SELECT /*+ USE_PX PARALLEL(4)*/ e.department_id, sum(e.salary) -FROM employees e -WHERE e.department_id = 1001; -GROUP BY e.department_id; -``` - - - -NO_USE_PX Hint --------------------------- - -`NO_USE_PX` Hint 强制指示服务器在执行 SQL 语句时避免使用 PX 模式。 - -以下是 `NO_USE_PX` Hint 的语法: - -```javascript -/*+ NO_USE_PX */ -``` - - - -示例如下: - -```javascript -SELECT /*+ NO_USE_PX*/ e.department_id, sum(e.salary) -FROM employees e -WHERE e.department_id = 1001; -GROUP BY e.department_id; -``` - - - -PQ_DISTRIBUTE Hint ------------------------------- - -`PQ_DISTRIBUTE` Hint 指示优化器怎样在程序(查询)服务器和消耗(负载)查询服务器之间分配行。您可以通过该 Hint 控制联接或负载的行分布`PQ_DISTRIBUTE` Hint 的语法: - -```javascript -/*+ PQ_DISTRIBUTE - ( [ @ queryblock ] tablespec - { distribution | outer_distribution inner_distribution } - ) */ -``` - - - -### 控制负载的分配 - -您可以控制并行语句 `INSERT ... SELECT` 和并行语句 `CREATE TABLE ... AS SELECT` 的行分布,以此来确定如何在程序(查询)服务器和消耗(负载)服务器之间进行行分配。使用语法的上分支来指定分发方法。分布方法的值及其语义如下表所示: - - -| 分布方法 | 说明 | -|--------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| NONE | 没有分配。即将查询和负载操作组合到每个查询服务器中。所有服务器将加载所有分区。这种分配方法的缺失有助于避免在没有偏离的情况下行分配的开销。由于空段或语句中的谓词会过滤掉查询评估的所有行,因此可能会发生偏离。如果由于使用此方法而发生偏斜,则请改用 `RANDOM` 或 `RANDOM_ LOCAL` 分布。 **注意** 请谨慎使用此分配方法。每个进程加载的 PGA 内存最少需要 512 KB。如果还使用压缩,则每台服务器消耗大约 1.5 MB 的 PGA 内存。 | -| PARTITION | 此方法使用 `tablespec` 的分区信息将行从查询服务器分发到消耗服务器。当不可能或不希望将查询和加载操作组合在一起时和当正在加载的分区数量大于或等于加载服务器的数量并且输入数据将均匀地分布在正在加载的分区之间(即没有偏离)时,请使用此分步方法。 | -| RANDOM | 此方法以循环方式将来自程序的行分发给消耗。当输入数据高度倾斜时,使用这种分布方法。 | -| RANDOM_LOCAL | 此方法将来自程序的行分布到一组服务器,这些服务器负责维护给定的一组服务器。两个或多个服务器可以加载同一分区,但是没有服务器加载所有分区。当输入数据发生偏移并且由于内存限制而无法合并查询和加载操作时,请使用此分布方法。 | - - - -例如,在以下直接装入插入操作中,该操作的查询和负载部分被组合到每个查询服务器中: - -```javascript -INSERT /*+ APPEND PARALLEL(target_table, 16) PQ_DISTRIBUTE(target_table, NONE) */ -INTO target_table -SELECT * FROM source_table; -``` - - - -在下面的示例中,创建表时优化器使用表 **target_table** 的分区来分配行: - -```javascript -CREATE /*+ PQ_DISTRIBUTE(target_table, PARTITION) */ TABLE target_table -NOLOGGING PARALLEL 16 -PARTITION BY HASH (l_orderkey) PARTITIONS 512 -AS SELECT * FROM source_table; -``` - - - -### 控制联接的分配 - -您可以通过指定两种分配方法来控制联接的分配方法,如语法中的下部分支所示,一种外部表的分布方法,一种内部表的分布方法: - -* `outside_distribution` 是外部表的分布方法。 - -* `inner_distribution` 是内部表的分布方法。 - - - - -分布方法的值是 `HASH`、`BROADCAST`、`PARTITION` 和 `NONE`。只有下表中的 6 种分布方法组合是有效的: - - -| 分布方法 | 说明 | -|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| HASH, HASH | 使用联接键上的哈希函数,将每个表的行映射到消耗查询服务器。映射完成后,每个查询服务器都会在一对结果分区之间执行联接。当表的大小可比较并且联接操作是通过哈希联接或排序合并联接实现时,建议使用此分布方法。 | -| BROADCAST, NONE | 外部表的所有行都广播到每个程序查询服务器。内部表行是随机分区的。当外部表与内部表相比非常小时,建议使用此分布方法。通常,当内部表大小乘以查询服务器的数量大于外部表大小时,也建议使用此分布方法。 | -| NONE, BROADCAST | 内部表的所有行都广播给每个消耗查询服务器。外部表行是随机分区的。当内部表与外部表相比非常小时,建议使用此分布方法。通常,当内部表大小乘以查询服务器的数量小于外部表大小时,也建议使用此分布方法。 | -| PARTITION, NONE | 外部表的行使用以内部表的分区进行映射。内部表必须在联接键上进行分区。当外部表的分区数等于或几乎等于查询服务器数的倍数时,建议使用此分布方法。例如,有 14 个分区和 15 个查询服务器。 **注意** 如果内部表未分区或未在分区键上等分联接时,则优化器将忽略此 Hint。 | -| NONE, PARTITION | 内部表的行使用外部表的分区进行映射。外部表必须在联接键上进行分区。当外部表的分区数等于或几乎等于查询服务器数的倍数时,建议使用此分布方法。例如,有 14 个分区和 15 个查询服务器。 **注意** 如果外部表未在分区键上进行分区或未等分联时接,则优化器将忽略此 Hint | -| NONE, NONE | 每个查询服务器在一对匹配的分区之间执行联接操作,每个表中都有一个。两个表必须在连接键上等分。 | - - - -例如,给定两个使用哈希联接来联接表 **r** 和 **s** ,以下查询包含使用哈希分配的 Hint: - -```javascript -SELECT /*+ORDERED PQ_DISTRIBUTE(s HASH, HASH) USE_HASH (s)*/ column_list -FROM r,s -WHERE r.c=s.c; -``` - - - -要广播外部表 **r** ,查询语句为: - -```javascript -SELECT /*+ORDERED PQ_DISTRIBUTE(s BROADCAST, NONE) USE_HASH (s) */ column_list -FROM r,s -WHERE r.c=s.c; -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/4.Hint/2.hint-list/5.hints-related-to-the-query-policy.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/4.Hint/2.hint-list/5.hints-related-to-the-query-policy.md deleted file mode 100644 index ffefaa4dc..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/4.Hint/2.hint-list/5.hints-related-to-the-query-policy.md +++ /dev/null @@ -1,194 +0,0 @@ -与查询策略相关的 Hint -================================== - - - -USE_JIT Hint ------------------------- - -`USE_JIT` Hint 指示服务器在执行 SQL 语句时强制使用 JIT 模式编译执行表达式。 - -以下是 `USE_JIT` Hint 的语法: - -```javascript -/*+ USE_JIT */ -``` - - - -示例如下: - -```javascript -SELECT /*+ USE_JIT*/ e.department_id, sum(e.salary) -FROM employees e -WHERE e.department_id = 1001; -GROUP BY e.department_id; -``` - - - -NO_USE_JIT Hint ---------------------------- - -`NO_USE_JIT` Hint 指示服务器在执行 SQL 语句时避免使用 JIT 模式编译执行表达式。 - -以下是 `NO_USE_JIT` Hint 的语法: - -```javascript -/*+ NO_USE_JIT*/ -``` - - - -示例如下: - -```javascript -SELECT /*+NO_USE_JIT*/ e.department_id, sum(e.salary) -FROM employees e -WHERE e.department_id = 1001; -GROUP BY e.department_id; -``` - - - -USE_HASH_AGGREGATION Hint -------------------------------------- - -`USE_HASH_AGGREGATION` Hint 指示优化器在生成计划时强制使用 HASH 聚合算法运行该 SQL 语句。 - -以下是 `USE_HASH_AGGREGATION` Hint 的语法: - -```javascript -/*+ USE_HASH_AGGREGATION */ -``` - - - -示例如下: - -```javascript -SELECT /*+ USE_HASH_AGGREGATION */ e.department_id, sum(e.salary) -FROM employees e -WHERE e.department_id = 1001; -GROUP BY e.department_id; -``` - - - -NO_USE_HASH_AGGREGATION Hint ----------------------------------------- - -`NO_USE_HASH_AGGREGATION` Hint 指示优化器在执行 SQL 语句时避免使用 HASH 聚合算法运行该语句。 - -以下是 `NO_USE_HASH_AGGREGATION` Hint 的语法: - -```javascript -/*+ NO_USE_HASH_AGGREGATION */ -``` - - - -示例如下: - -```javascript -SELECT /*+ NO_USE_HASH_AGGREGATION */ e.department_id, sum(e.salary) -FROM employees e -WHERE e.department_id = 1001; -GROUP BY e.department_id; -``` - - - -USE_LATE_MATERIALIZATION Hint ------------------------------------------ - -`USE_LATE_MATERIALIZATION` Hint 指示优化器延迟物化视图。 - -以下是 `USE_LATE_MATERIALIZATION` Hint 的语法: - -```javascript -/*+ USE_LATE_MATERIALIZATION */ -``` - - - -示例如下: - -```javascript -SELECT /*+ USE_LATE_MATERIALIZATION*/ e.department_id, sum(e.salary) -FROM employees e -WHERE e.department_id = 1001; -GROUP BY e.department_id; -``` - - - -NO_USE_LATE_MATERIALIZATION Hint --------------------------------------------- - -`NO_USE_LATE_MATERIALIZATION` Hint 指示优化器禁止延迟物化视图。 - -以下是 `NO_USE_LATE_MATERIALIZATION` Hint 的语法: - -```javascript -/*+ NO_USE_LATE_MATERIALIZATION */ -``` - - - -示例如下: - -```javascript -SELECT /*+ NO_USE_LATE_MATERIALIZATION*/ e.department_id, sum(e.salary) -FROM employees e -WHERE e.department_id = 1001; -GROUP BY e.department_id; -``` - - - -USE_NL_MATERIALIZATION Hint ---------------------------------------- - -`USE_NL_MATERIALIZATION` Hint 强制指示优化器指定表为内部表(子树)时生成一个物化算子来缓存数据。 - -以下是 `USE_NL_MATERIALIZATION` Hint 的语法: - -```javascript -/*+ USE_NL_MATERIALIZATION ( [ @ queryblock ] tablespec [ tablespec ]... ) */ -``` - - - -示例如下: - -```javascript -SELECT /*+ USE_NL_MATERIALIZATION(departments) */ * -FROM employees, departments -WHERE employees.department_id = departments.department_id; -``` - - - -NO_USE_NL_MATERIALIZATION Hint ------------------------------------------- - -`NO_USE_NL_MATERIALIZATION` Hint 强制指示优化器在指定表为内部表(子树)时避免生成一个物化算子来缓存数据。 - -以下是 `NO_USE_NL_MATERIALIZATION` Hint 的语法: - -```javascript -/*+ NO_USE_NL_MATERIALIZATION ( [ @ queryblock ] tablespec [ tablespec ]... ) */ -``` - - - -示例如下: - -```javascript -SELECT /*+ NO_USE_NL_MATERIALIZATION(departments) */ * -FROM employees, departments -WHERE employees.department_id = departments.department_id; -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/4.Hint/2.hint-list/6.hints-related-to-query-transformation.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/4.Hint/2.hint-list/6.hints-related-to-query-transformation.md deleted file mode 100644 index 742061404..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/4.Hint/2.hint-list/6.hints-related-to-query-transformation.md +++ /dev/null @@ -1,262 +0,0 @@ -与查询转换相关的 Hint -================================== - - - -NO_REWRITE Hint ---------------------------- - -`NO_REWRITE` Hint 指示优化器为禁用查询去重写查询块,并覆盖了参数 `QUERY_REWRITE_ENABLED` 的设置。 - -以下是 `NO_REWRITE` 的语法: - -```javascript -/*+ NO_REWRITE [ ( @ queryblock ) ] */ -``` - - - -示例如下: - -```javascript -SELECT /*+ NO_REWRITE */ sum(s.amount_sold) AS dollars -FROM sales s, times t -WHERE s.time_id = t.time_id -GROUP BY t.calendar_month_desc; -``` - - - -NO_EXPAND Hint --------------------------- - -`NO_EXPAND` Hint 指示优化器不要对 `WHERE` 子句中具有 `OR` 条件或 `IN` 列表的查询考虑 `OR` 扩展。 通常,优化器会使用 `OR` 扩展,当确定使用 `OR` 扩展的成本低于不使用它时。 - -以下是 `NO_EXPAND` Hint 的语法: - -```javascript -/*+ NO_EXPAND [ ( @ queryblock ) ] */ -``` - - - -示例如下: - -```javascript -SELECT /*+ NO_EXPAND */ * - FROM employees e, departments d - WHERE e.manager_id = 108 - OR d.department_id = 110; -``` - - - -USE_CONCAT Hint ---------------------------- - -`USE_CONCAT` Hint 指示优化器使用 `UNION ALL` 运算符将查询 `WHERE`子句中的组合 `OR` 条件转换为复合查询。 如果没有这个 Hint,则仅当使用串联查询的成本低于比没有串联查询的成本时,才会发生此转换。`USE_CONCAT` Hint 将覆盖成本注意事项。 - -以下是 `USE_CONCAT` Hint 的语法: - -```javascript -/*+ USE_CONCAT [ ( @ queryblock ) ] */ -``` - - - -示例如下: - -```javascript -SELECT /*+ USE_CONCAT */ * - FROM employees e - WHERE manager_id = 108 - OR department_id = 110; -``` - - - -MERGE Hint ----------------------- - -`MERGE` Hint 使您可以在查询中合并视图。 - -以下是 `MERGE` Hint 的语法: - -```javascript -/*+ MERGE [ ( @ queryblock ) | ( [ @ queryblock ] tablespec ) ] */ -``` - - - -如果视图的查询块在 `SELECT` 列表中包含 `GROUP BY` 子句或 `DISTINCT` 运算符时,只有启用了复杂的视图合并后,优化器才能将视图合并到正在访问的语句中。 如果子查询不相关,则也可以使用复杂合并将 `IN` 子查询合并到访问语句中。 - -示例如下: - -```javascript -SELECT /*+ MERGE(v) */ e1.last_name, e1.salary, v.avg_salary - FROM employees e1, - (SELECT department_id, avg(salary) avg_salary - FROM employees e2 - GROUP BY department_id) v - WHERE e1.department_id = v.department_id - AND e1.salary > v.avg_salary - ORDER BY e1.last_name; -``` - - - -当不带参数使用 `MERGE` Hint 时,应将其放在视图查询块中。 当视图名称作为参数使用 - -`MERGE` Hint 时,应将其放在周边查询中。 - -NO_MERGE Hint -------------------------- - -`NO_MERGE` Hint 指示优化器不要将外部查询和任何内联视图查询合并到单个查询中。 - -以下是 `NO_MERGE` Hint 的语法: - -```javascript -/*+ NO_MERGE [ ( @ queryblock ) | ( [ @ queryblock ] tablespec ) ] */ -``` - - - -此 Hint 会影响您访问视图的方式。 例如,以下语句导致视图 **seattle_dept** 不被合并: - -```javascript -SELECT /*+ NO_MERGE(seattle_dept) */ e1.last_name, seattle_dept.department_name - FROM employees e1, - (SELECT location_id, department_id, department_name - FROM departments - WHERE location_id = 1700) seattle_dept - WHERE e1.department_id = seattle_dept.department_id; -``` - - - -在视图查询块中使用 `NO_MERGE` Hint 时,不需要为它指定参数。 在周围的查询中使用 `NO_MERGE` Hint 时,需要将视图名称指定为它的参数。 - -UNNEST Hint ------------------------ - -`UNNEST` Hint 指示优化器不要嵌套而是并将子查询的主体合并到包含该 Hint 的查询块的主体中,从而使优化器在评估访问路径和联接时将它们一起考虑在内。 - -以下是 `UNNEST` Hint 的语法: - -```javascript -/*+ UNNEST [ ( @ queryblock ) ] */ -``` - - - -在取消嵌套子查询之前,优化器首先验证子查询是否有效,并且必须通过探索和查询优化测试。 使用 `UNNEST` Hint 时优化器仅检查子查询块的有效性。 如果子查询块有效,那么将直接取消嵌套子查询,而无需通过探索和查询优化测试。 - -示例如下: - -```javascript -SELECT AVG(t1.c) FROM t1 -WHERE t1.b >= - (SELECT /*+unnest*/AVG(t2.b) - FROM t2 - WHERE t1.a = t2.a); -``` - - - -NO_UNNEST Hint --------------------------- - -`NO_UNNEST` Hint 用来关闭取消嵌套的操作。 - -以下是 `NO_UNNEST` Hint 的语法: - -```javascript -/*+ NO_UNNEST [ ( @ queryblock ) ] */ -``` - - - -示例如下: - -```javascript -SELECT /*+no_unnest(@qb1)*/AVG(t1.c) -FROM t1 WHERE t1.b >= - (SELECT /*+qb_name(qb1)*/AVG(t2.b) - FROM t2) - WHERE t1.a = t2.a); -``` - - - -PLACE_GROUP_BY Hint -------------------------------- - -`PLACE_GROUP_BY` Hint指示优化器采用 GROUP BY 位置替换规则,此时优化器不考虑转换之后的代价增大。 - -以下是`PLACE_GROUP_BY` Hint的语法: - -```javascript -/*+ PLACE_GROUP_BY [ ( @ queryblock ) ] */ -``` - - - -示例如下: - -```javascript -SELECT /*+place_group_by*/SUM(t1.c),SUM(t2.c) FROM t1, t2 -WHERE t1.a = t2.a AND t1.b > 10 AND t2.b > 10 -GROUP BY t1.a; -``` - - - -NO_PLACE_GROUP_BY Hint ----------------------------------- - -`NO_PLACE_GROUP_BY` Hint 用来关闭 GROUP BY 位置替换转换。 - -以下是`NO_PLACE_GROUP_BY` Hint的语法: - -```javascript -/*+ NO_PLACE_GROUP_BY [ ( @ queryblock ) ] */ -``` - - - -示例如下: - -```javascript -SELECT /*+no_place_group_by*/SUM(t1.c),SUM(t2.c) FROM t1, t2 -WHERE t1.a = t2.a AND t1.b > 10 AND t2.b > 10 -GROUP BY t1.a; -``` - - - -NO_PRED_DEDUCE Hint -------------------------------- - -`NO_PRED_DEDUCE` Hint 用来指示优化器不是用谓词推导转换规则。 - -以下是`NO_PRED_DEDUCE` Hint的语法: - -```javascript -/*+ NO_PRED_DEDUCE [ ( @ queryblock ) ] */ -``` - - - -示例如下: - -```javascript -SELECT /*+no_pred_deduce(@qb1)*/ * -FROM ( - SELECT /*+no_merge qb_name(qb1)*/ t1.a, t2.b - FROM t1, t2 - WHERE t1.a = t2.a) v, t3 -WHERE t3.a = 1 AND t3.a = v.a; -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/4.Hint/2.hint-list/7.other-hints.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/4.Hint/2.hint-list/7.other-hints.md deleted file mode 100644 index c5e7c8dfd..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/4.Hint/2.hint-list/7.other-hints.md +++ /dev/null @@ -1,261 +0,0 @@ -其他 Hint -============================ - - - -QB_NAME Hint ------------------------- - -使用 `QB_NAME` Hint 来定义查询块的名称。然后,可以在外部查询的 Hint 中使用这个名称,也可以在内联视图的 Hint 中使用这个名称,从而影响查询在被命名查询块中的表上的执行。更多关于查询块名称的信息,请参阅文档 [Hint 概述](../../../../../11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/4.Hint/1.hint-overview.md) 中的在 Hint 中定义查询块。 - -以下是 `QB_NAME` Hint 的语法: - -```javascript -/*+ QB_NAME ( queryblock ) */ -``` - - - -如果两个或多个查询块具有相同的名称,或者同一个查询块两次被 Hint 指定了不同的名称,那么优化器将忽略所有引用该查询块的名称和 Hint。未使用 `QB_NAME` Hint 命名的查询块具有由系统生成的惟一名称。这些名称可以显示在计划表中,也可以在查询块中的其他 Hint 中使用。 - -以下是 `QB_NAME` Hint 的示例: - -```javascript -SELECT /*+ QB_NAME(qb) FULL(@qb e) */ employee_id, last_name -FROM employees e -WHERE last_name = 'Smith'; -``` - - - -READ_CONSISTENCY Hint ---------------------------------- - -`READ_CONSISTENCY` Hint 指示服务器去指定某条 SQL 所读取的表模式为弱一致(指定参数 - -`WEAK`)或强一致性(指定参数 `STRONG`)。 - -以下是 `READ_CONSISTENCY` Hint 的语法: - -```javascript -/*+ READ_CONSISTENCY(WEAK[STRONG]) */ -``` - - - -示例如下: - -```javascript -SELECT /*+ READ_CONSISTENCY(WEAK) */ * -FROM employees -WHERE employees.department_id = 1001; -``` - - - -FROZEN_VERSION Hint -------------------------------- - -`FROZEN_VERSION` Hint 指示服务器读取某个基线数据的版本。 - -以下是 `FROZEN_VERSION` Hint 的语法: - -```javascript -/*+ FROZEN_VERSION (intnum) */ -``` - - - -示例如下: - -```javascript -SELECT /*+ FROZEN_VERSION(1000) */ * -FROM employees e -WHERE e.department_id = 1001; -``` - - - -QUERY_TIMEOUT Hint ------------------------------- - -`QUERY_TIMEOUT` Hint 指示服务器设定某条 SQL 执行时的超时时间,单位为微妙。 - -以下是 `QUERY_TIMEOUT` Hint 的语法: - -```javascript -/*+ QUERY_TIMEOUT (intnum) */ -``` - - - -示例如下,当该查询 1 秒之内未执行完该语句即返回超时错误: - -```javascript -SELECT /*+ QUERY_TIMEOUT(1000000) */ * -FROM employees e -WHERE e.department_id = 1001; -``` - - - -LOG_LEVEL Hint --------------------------- - -`LOG_LEVEL` Hint 指示服务器运行某句 SQL 时采用何种日志级别来执行。 - -以下是 `LOG_LEVEL` Hint 的语法: - -```javascript -/*+ LOG_LEVEL ([']log_level[']) */ -``` - - - -以下示例采用 `DEBUG` 日志级别来执行该 SQL 语句: - -```javascript -SELECT /*+ LOG_LEVEL(DEBUG) */ * -FROM employees e -WHERE e.department_id = 1001; -``` - - - -USE_PLAN_CACHE Hint -------------------------------- - -`USE_PLAN_CACHE` Hint 指示服务器执行某条 SQL 时是否要在计划缓存机制下运行,参数 `NONE` 为不执行计划缓存机制,参数 `DEFAULT` 表示按照服务器本身的设置来决定是否执行计划缓存机制。 - -以下是 `USE_PLAN_CACHE` Hint 的语法: - -```javascript -/*+ USE_PLAN_CACHE (NONE[DEFAULT]) */ -``` - - - -示例如下,以下语句不执行计划缓存机制: - -```javascript -SELECT /*+ USE_PLAN_CACHE(NONE) */ * -FROM employees e -WHERE e.department_id = 1001; -``` - - - -TRANS_PARAM Hint ----------------------------- - -`TRANS_PARAM` Hint 指示服务器执行事务时是否要按照参数 `param` 指定的参数来执行,现在支持的参数只有事务层面的提前解行锁 `FORCE_EARLY_LOCK_FREE` 参数,`FORCE_EARLY_LOCK_FREE` 的值为 **TRUE** 时表示支持, **FALSE** 表示不支持。注意这里的参数名和参数值要用单引号(' ')引起来,当参数的值为数值型时可以不用引号引起来。 - -以下是 `TRANS_PARAM` Hint 的语法: - -```javascript -/*+ TRANS_PARAM ['param' , 'param_value'] */ -``` - - - -示例如下: - -```javascript -SELECT /*+ TRANS_PARAM('FORCE_EARLY_LOCK_FREE' 'TRUE') */ * -FROM employees e -WHERE e.department_id = 1001; -``` - - - -TRACING Hint ------------------------- - -`TRACING` Hint 指示服务器对某些执行计划中的算子采用 `TRACING` 跟踪。 - -以下是 `TRACING` Hint 的语法: - -```javascript -/*+ TRACING(TRACING_NUM_LIST)*/ -``` - - - -示例如下: - -```javascript -SELECT /*+ TRACING(1) */ * -FROM employees e -WHERE e.department_id = 1001; -``` - - - -STAT Hint ---------------------- - -`STAT` Hint 指示对某些执行计划中的算子采用 `STAT` 显示信息。 - -以下是 `STAT` Hint 的语法: - -```javascript -/*+ STAT(TRACING_NUM_LIST) */ -``` - - - -示例如下: - -```javascript -SELECT /*+ STAT(1) */ * -FROM employees e -WHERE e.department_id = 1001; -``` - - - -TOPK Hint ---------------------- - -`TOPK` Hint 指示服务器设置模糊查询的精度和最小行数。其中参数 `PRECSION` 的值为整型,取值范围为 0\~100,表示执行模糊查询时的行数百分比,参数 `MINIMUM_ROWS` 用来指定最小的返回行数。 - -以下是 `TOPK` Hint 的语法: - -```javascript -/*+ TOPK(PRECISION MINIMUM_ROWS) */ -``` - - - -示例如下: - -```javascript -SELECT /*+ TOPK(1,10) */ * -FROM employees e -WHERE e.department_id = 1001; -``` - - - -TRACE_LOG Hint --------------------------- - -`TRACE_LOG` Hint 指示服务器收集跟踪日志(Trace log),收集的跟踪日志(Trace log)在运行 `SHOW TRACE` 命令时展示。 - -以下是 `TRACE_LOG` Hint 的语法: - -```javascript -/*+ TRACE_LOG */ -``` - - - -示例如下: - -```javascript -SELECT /*+ TRACE_LOG */ * -FROM employees e -WHERE e.department_id = 1001; -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/7.database-objects/1.schema-object.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/7.database-objects/1.schema-object.md deleted file mode 100644 index a1f8a03ce..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/7.database-objects/1.schema-object.md +++ /dev/null @@ -1,22 +0,0 @@ -Schema 对象 -========= - -Schema 是数据的逻辑结构和 Schema 对象的集合。每个 OceanBase 数据库的使用者都拥有一个 Schema,并且Schema 拥有和使用者相同的名字。 - -可以使用 SQL 来创建和处理用户数据库对象,并且 Schema 对象有以下类型: - -* 约束 Constraints -* 数据库链接 Database links -* 数据库触发器 Database triggers -* 索引 Indexes -* 对象表 Object tables -* 对象类型 Object types -* 对象视图 Object views -* 包 Packages -* 序列 Sequences -* 存储函数 Stored functions -* 存储过程 Stored procedures -* 同义词 Synonyms -* 表 Tables -* 视图 Views - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/8.database-naming-convention/1.overview-of-database-object-naming-conventions.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/8.database-naming-convention/1.overview-of-database-object-naming-conventions.md deleted file mode 100644 index 8d53a99ba..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/8.database-naming-convention/1.overview-of-database-object-naming-conventions.md +++ /dev/null @@ -1,12 +0,0 @@ -数据库对象命名规范概述 -================================ - - - -一些数据库对象由用户可以命名的部分和用户必须命名的部分组成。例如,表或视图中的列,索引、表分区和表的子分区,表的完整性约束以及存储在包中的对象(包括程序和存储函数)。本章将讨论: - -• 数据库对象命名规则 - -• Schema 对象命名示例 - -• Schema 对象命名准则 diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/8.database-naming-convention/2.database-object-naming-rules.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/8.database-naming-convention/2.database-object-naming-rules.md deleted file mode 100644 index 360d52515..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/8.database-naming-convention/2.database-object-naming-rules.md +++ /dev/null @@ -1,117 +0,0 @@ -数据库对象命名规则 -============================== - - - -数据库对象标识符 --------------------- - -每个数据库对象都有名字。在 SQL 语句中您可以使用引用标识符和非引用标识符来命名任何数据库对象: - -* 引用标识符:以双引号 `" "` 为开头和结尾的标识符。如果使用引用标识符命名 Schema 对象,则在引用该对象时必须使用双引号。 - - - -* 非引用标识符:标识符中不包含任何标点符号。 - - - - - - -但是,数据库名称、全局数据库名称、数据库链接名称、磁盘组名称和可插入数据库(PDB)始终不区分大小写,并以大写形式存储。如果使用引用标识符为它们命名,那么引号将被忽略。 -**注意** - - - -OceanBase 并不建议您使用引用标识符来命名数据库对象。这些引用标识符在 SQL PLUS 中兼容,但是在其他数据库对象管理工具中可能不被识别。 - -标识符使用规则 -------------------- - -以下是一些适用于引用标识符和非引用标识符的规则,除非另有说明,否则以下规则对引用标识符和非引用标识符同时适用。 - -### 标识符的长度 - -标识符的长度为 1\~128 字节。 - -如果标识符包含由句点分隔的多个部分,则每个部分最长都可达 128 字节。每个句点分隔符以及旁边的引号都算作一个字节。例如以下字符串: - -```javascript -"schema"."table"."column" -``` - - - -示例名称中的三部分 **schema** 、 **table** 和 **column** 各自最长可以是 128 字节,每个引号和句点都是单字节字符,所以示例中标识符的总长度为 392 字节。 - -### 保留字做标识符 - -非引用标识符不能是 OceanBase SQL 保留字。引用标识符可以是保留字,但不建议这样做。根据您计划用于访问数据库对象的工具不同,名称可能进一步受到其他产品特定的保留字限制。 -**注意** - - - -保留字 `ROWID` 是这个规则的一个例外。不能使用大写单词 `ROWID` 作为列的名称,无论是带引号的还是不带引号的。但是,引用标识符作为列名时,不可以使用全大写单词,但是可以包含一个或多个小写字母(例如,"Rowid"或"Rowid")。 - -### 特殊含义单词做标识符 - -OceanBase 中的 SQL 语言包含了其他具有特殊含义的单词。这些词包括数据类型、Schema 名、函数名、虚拟系统表 `DUAL` 和关键字(SQL 语句中的大写单词,如 `DIMENSION`、`SEGMENT`、`ALLOCATE`、`DISABLE` 等)。这些词不是保留字,但是,OceanBase 在内部以特定的方式使用它们。因此,如果您使用这些词作为对象和对象部件的名称,SQL 语句可能会难以阅读,并可能导致不可预测的结果。尤其是不要使用 SQL 内置函数的名称作为 Schema 对象和用户自定义函数的名称。 - -### ASCII 字符做标识符 - -在数据库名称、全局数据库名称和数据库链接名称中您应该使用 ASCII 字符集中的字符,因为这些字符拥有跨不同平台和操作系统的最佳兼容性。多租户容器数据库(CDB)中的通用用户和通用角色的名称只能使用 ASCII 字符集中的字符。 - -### 密码中的字符 - -密码中可以包含多位字节的字符,如汉字或中文标点等。 - -### 标识符的开头 - -非引用标识符必须以数据库字符集中的字母字符开头。引用标识符可以以任何字符开头。 - -### 标识符中的符号 - -非引用标识符只能包含来自数据库字符集的字母数字字符和下划线(_)。但是用于数据库链接名称时可以包含句点(.)和符号 @。引用标识符可以包含任何字符、标点符号和空格。但是,引用标识符和非引用标识符都不能包含双引号或空字符(\\0)。 - -### 对象名称在名称空间中的限制 - -在同一个名称空间中,表、视图、私有同义词不能拥有相同的名称。 - -### 标识符的大小写 - -非引用标识符不区分大小写,OceanBase 将他们存储为大写。引用标识符区分大小写,所以通过将名称括在双引号里,在同一命名空间的不同对象可以拥有以下类型的名称: - -```javascript -"employees" -"Employees" -"EMPLOYEES" -``` - - - -由于非引用标识符不区分大小写,所以 OceanBase 认为以下名称是相同的,他们不能作为同一名称空间下不同对象的名字: - -```javascript -employees -EMPLOYEES -"EMPLOYEES" -``` - - - -### 大写标识符 - -存储或比较大写的标识符时,每个字符的大写形式是通过应用数据库字符集的大写规则来确定的。由对话设置 `NLS_SORT` 所设定的特定语言规则不在考虑的范围内。此行为是将 SQL 函数 `UPPER` 应用于标识符,而不是将函数 `NLS_UPPER` 应用于标识符。 - -数据库字符集的大写规则被应用到自然语言时可能产生不正确的结果。例如,德国小写字母 `ß`,它在数据库字符集大写规则中并没有对应的大写形式, 所以当含有它的标识符被转换为大写形式时它并不会被转变。 - -数据库字符集大写规则确保标识符在任何语言配置的会话中的样式是相同的。如果希望标识符在某种自然语言中看起来正确,那么可以通过引号来保留它的小写形式,或者在使用该标识符时使用对应语言上正确的大写形式。 - -### 列的名称 - -同一表或视图中的列不能具有相同的名称。但是,不同表或视图中的列可以具有相同的名称。 - -### 程序和函数的名称 - -如果同一包中的程序或函数所包含的参数的数量和数据类型不同,则它们可以具有相同的名称。在同一个包中使用不同的参数创建具有相同名称的多个过程或函数称为重载过程或函数。 diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/8.database-naming-convention/3.schema-object-naming-example.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/8.database-naming-convention/3.schema-object-naming-example.md deleted file mode 100644 index c53f55283..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/8.database-naming-convention/3.schema-object-naming-example.md +++ /dev/null @@ -1,21 +0,0 @@ -Schema 对象命名示例 -================================== - - - -以下是一些有效的 Schema 对象命名示例: - -* `last_name` - -* `horse` - -* `hr.hire_date` - -* `"EVEN THIS & THAT!"` - -* `a_very_long_and_valid_name` - - - - -这些示例都遵循了 [数据库对象命名规则](../../../11.sql-reference-oracle-mode/3.basic-elements-1/8.database-naming-convention/2.database-object-naming-rules.md) 中列出的规则。 diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/8.database-naming-convention/4.schema-object-naming-guidelines.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/8.database-naming-convention/4.schema-object-naming-guidelines.md deleted file mode 100644 index 1af960adb..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/8.database-naming-convention/4.schema-object-naming-guidelines.md +++ /dev/null @@ -1,27 +0,0 @@ -Schema 对象命名准则 -================================== - - - -以下是一些有用的用来命名对象及其部分的准则: - -* 使用完整的、描述性的、可发音的名称或众所周知的缩写。 - - - -* 使用一致的命名规则。 - - - -* 使用相同的名称来描述跨表的相同实体或属性。 - - - - - - -在命名对象时,要在简单易用和名称具有描述性的目标之间取得平衡。如果无法平衡,请选择更具描述性的名称,因为数据库中的对象可能会在很长一段时间内被使用,从现在开始十年后的用户可能难以理解名称为 **pmdd** 的表列是用来存储什么信息的,但是 **payment_due_date** 却更清楚明了。 - -使用一致的命名规则可以帮助用户理解每个表在应用程序中扮演的角色。例如,以 **fin_** 为开头命名所有属于 **FINANCE** 应用程序的表的名称。 - -使用相同的名称描述表中的相同内容。例如,雇员和部门表的部门号列其实存储的是一样的值,那么在雇员表和部门表中这一列均被命名为 **department_id** 。 diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/9.database-object-reference-method/1.overview-of-database-object-references.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/9.database-object-reference-method/1.overview-of-database-object-references.md deleted file mode 100644 index 70d7a2e00..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/9.database-object-reference-method/1.overview-of-database-object-references.md +++ /dev/null @@ -1,21 +0,0 @@ -数据库对象引用概述 -============================== - - - -本章将讨论如何在 SQL 语句的上下文中引用 Schema 对象。本章包括: - -* 引用 Schema 对象 - - - -* 引用分区表和索引 - - - -* 引用对象类型属性和方法 - - - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/9.database-object-reference-method/2.reference-a-schema-object.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/9.database-object-reference-method/2.reference-a-schema-object.md deleted file mode 100644 index ce3e35e90..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/9.database-object-reference-method/2.reference-a-schema-object.md +++ /dev/null @@ -1,81 +0,0 @@ -引用 Schema 对象 -================================= - - - -当在 SQL 语句中引用对象时,OceanBase 会考虑 SQL 语句的上下文并在适当的名称空间中找到该对象。找到对象后,OceanBase 执行 SQL 语句对该对象指定的操作。如果在适当的名称空间中找不到命名的对象,则返回错误。 - -引用用户的 Schema 中的对象 ------------------------------ - -以下示例说明了 OceanBase 如何解析 SQL 语句中对象的引用。 - -执行以下语句,向名为 **departments** 的表中添加了一行数据: - -```javascript -INSERT INTO departments -VALUES (280, 'ENTERTAINMENT_CLERK', 206, 1700); -``` - - - -根据 SQL 语句的上下文, **departments** 在数据库中可能是: - -* 一张在您自己 Schema 中的表 - - - -* 一个在您自己 Schema 中的视图 - - - -* 一个表或视图的专有同义词 - - - -* 一个公共同义词 - - - - - - -OceanBase 始终会先尝试在您自己的 Schema 中的名称空间里解析被引用对象,然后再考虑该 Schema 之外的名称空间。在此示例中,OceanBase 尝试解析如下: - -1. 首先,OceanBase 尝试在您自己的包含了表、视图和专用同义词的 Schema 中的名称空间里去定位对象。如果对象是专用同义词,则 OceanBase 会找到该同义词所代表的对象。该对象可以在您自己的 Schema 中,也可以在其他 Schema 中或者在另一个数据库中。该对象也可以是其他的同义词,在这种情况下,OceanBase 会找到同义词所代表的对象。 - - - -2. 如果对象在名称空间中被找到,则 OceanBase 尝试对该对象执行 SQL 语句。在此示例中,OceanBase 尝试将一行数据添加到 **departments** 中。如果此对象的类型不是该 SQL 语句所需要的类型,则 OceanBase 返回错误。在此示例中, **departments** 必须是表、视图或者可以是可以解析为表或视图的专用同义词。如果 **departments** 是序列,则 OceanBase 返回错误。 - - - -3. 如果该对象到目前为止没有在任何名称空间中被搜索到,则 OceanBase 将搜索包含公共同义词的名称空间。如果对象在包含公共同义词的名称空间中,则 OceanBase 尝试对该对象执行该语句。如果此对象的类型不是该 SQL 语句所需要的类型,则 OceanBase 返回错误,例如在此示例中,如果 **departments** 是一个代表了序列的公共同义词,那么 OceanBase 将返回错误。 - - - - - - -如果公共同义词包含任何依赖表或用户定义类型,则不能在与依赖对象相同的 Schema 中创建与同义词同名的对象。 - -反之,如果同义词没有任何依赖表或用户定义的类型,则可以在与依赖对象相同的 Schema 中创建具有相同名称的对象。OceanBase 会使所有依赖对象无效,并在下一次访问它们时重新验证它们。 - -引用其他 Schema 中的对象 ----------------------------- - -要引用您的 Schema 之外的 Schema 中的对象,需要在对象名称前添加 Schema 名称: - -```javascript -schema.object -``` - - - -例如,以下示例展示了在名为 **hr** 的 Schema 中删除表 **employees** : - -```javascript -DROP TABLE hr.employees; -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/9.database-object-reference-method/3.reference-objects-in-a-remote-database/1.create-database-link.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/9.database-object-reference-method/3.reference-objects-in-a-remote-database/1.create-database-link.md deleted file mode 100644 index 2f97fc9cb..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/9.database-object-reference-method/3.reference-objects-in-a-remote-database/1.create-database-link.md +++ /dev/null @@ -1,66 +0,0 @@ -创建数据库链接 -============================ - - - -要引用除本地数据库以外的其他数据库中的对象,需要在对象名称后加上指向该数据库的数据库链接的名称。数据库链接是一个 Schema 对象,它使 OceanBase 连接到远程数据库以访问里面的对象。 - -可以使用语句 CREATE DATABASE LINK 创建数据库链接,使用该语句时需要指定以下数据库链接的信息: - -* 租户名、用户名和密码。 - - - -* 网络地址、端口号。 - - - - - - -OceanBase 将上述信息存储在数据字典中。 - -创建链接限制 ------------------- - -1. 只支持创建 OceanBase 中的 Oracle 模式租户连接到另一个 Oracle 模式租户的数据库链接,OceanBase 目前不支持创建连接到外部 Oracle 数据库的数据库链接。 - - - -2. 一个租户可以反复创建、删除数据库链接,但最多只能同时存在 15 个数据库链接。 - - - - - - -数据库连接串格式 --------------------- - -```javascript -user_name@tenant_name IDENTIFIED BY password HOST 'ip:port' -``` - - - -* **user_name** :用户名。 - -* **tenant_name** :租户名。 - -* **password** :密码。 - -* **ip** :网络地址。 - -* **port** :端口号。 - - - - -以下是创建数据库链接的示例: - -```javascript -CREATE DATABASE LINK my_link CONNECT TO -root@oracle IDENTIFIED BY abcdef HOST '192.168.0.0:1521'; -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/9.database-object-reference-method/3.reference-objects-in-a-remote-database/2.reference-database-links.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/9.database-object-reference-method/3.reference-objects-in-a-remote-database/2.reference-database-links.md deleted file mode 100644 index 3f0477d40..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/9.database-object-reference-method/3.reference-objects-in-a-remote-database/2.reference-database-links.md +++ /dev/null @@ -1,29 +0,0 @@ -引用数据库链接 -============================ - - - -当您发出包含数据库链接的 SQL 语句时,需要使用存储在数据字典中的完整数据库链接名,更多关于数据库链接名称的信息请查看文档 [创建数据库链接](../../../../11.sql-reference-oracle-mode/3.basic-elements-1/9.database-object-reference-method/3.reference-objects-in-a-remote-database/1.create-database-link.md)。 - -OceanBase 在连接远程数据库时,将使用数据库连接字符串访问远程数据库。使用数据库字符串、用户名和密码后连接成功,则 OceanBase 使用文档 [引用 Schema 对象](../../../../11.sql-reference-oracle-mode/3.basic-elements-1/9.database-object-reference-method/2.reference-a-schema-object.md) 中的规则来访问远程数据库上的指定对象,但请注意相关限制: - -1. 只能执行只读语句。 - - - -2. 只能访问表对象,不支持访问其它对象,如视图、序列等。 - - - -3. 访问表对象时必须显式指定数据库名,如:`test.t1@my_link`。 - - - -4. 不支持部分计划和算子: - - - - - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/9.database-object-reference-method/4.reference-partition-table-and-indexes.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/9.database-object-reference-method/4.reference-partition-table-and-indexes.md deleted file mode 100644 index bd1860c97..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/9.database-object-reference-method/4.reference-partition-table-and-indexes.md +++ /dev/null @@ -1,79 +0,0 @@ -引用分区表和索引 -============================= - - - -表和索引可以分区。进行分区时,这些 Schema 对象由许多称为分区的部分组成,所有这些部分都具有相同的逻辑属性。例如,表中的所有分区共享相同的列和约束定义,而索引中的所有分区共享相同的索引列。 - -分区扩展名和子分区扩展名使用户可以执行某些分区级和子分区级操作,例如,仅在一个分区或子分区上删除其中的所有行。没有扩展名称时,此类操作将要求您使用判断语句定义范围(`WHERE` 子句)。对于范围分区表和列表分区表,尝试用判断语句描述分区级操作可能会很麻烦,尤其是当范围分区键使用多个列时。对于哈希分区和子分区,使用判断语句更加困难,因为这些分区和子分区是基于系统定义的哈希函数。 - -分区扩展名使您可以像使用表一样使用分区。此方法的一个优点(对范围分区的表最有用)是,您可以通过对其他用户或角色授予(或撤消)这些视图的特权来构建分区级别的访问控制机制。要将分区用作表,需要通过从单个分区中选择数据来创建视图,然后将该视图用作表。 - -语法 --------------- - -当在 SQL 语句的语法或轨道图中出现 `partition_extended_name` 或者 `subpartition_extended_name` 元素时,用户可以通过这两个元素指定分区扩展表名和子分区扩展表名。`partition_extended_name` 的语法: - -```javascript -PARTITION partition -| -PARTITION FOR ( partition_key_value [, partition_key_value]... ) -``` - - - -`subpartition_extended_name` 的语法: - -```javascript -SUBPARTITION subpartition -| -SUBPARTITION FOR ( subpartition_key_value [, subpartition_key_value]... ) -``` - - - -DML 语句 `INSERT`、`UPDATE` 、 `DELETE` 和 `ANALYZE` 语句需要在分区或子分区名称的周围加上括号。这个小的区别体现在 `partition_extension_clause` 元素中。在 `partition_extended_name`,`subpartition_extended_name` 和 `partition_ extension_clause` 中,可以使用 `PARTITION FOR` 和 `SUBPARTITION FOR` 子句在不使用名称的情况下引用分区。它们对任何类型的分区均有效,尤其是间隔分区。将数据插入表中时,间隔分区会根据需要被自动创建。 - -对于上述元素中各自的 `partition_key_value` 或 `subpartition_key_value` 部分,它们为每个分区键列指定一个值。对于多列分区键,需要为每个分区键指定一个值。对于复合分区,对每个分区键指定一个值后,需要继续为每个子分区键指定一个值。所有分区键值均以逗号分隔。对于间隔分区,您只能指定一个 `partition_key_value`,并且它必须是有效的 `NUMBER` 数据类型或日期时间数据类型的值。用户的 SQL 语句将在包含用户指定了值的分区或子分区上运行。 - -扩展名称的限制 -------------------- - -使用分区扩展表名和子分区扩展表名时有以下限制: - -* 名称中没有远程表:扩展分区表名和子分区扩展表名不能包含数据库链接或能转换为具有数据库链接的表的同义词。要使用远程分区和远程子分区,需要在远程站点上使用扩展表名语法创建一个视图,然后引用该远程视图。 - - - -* 名称中没有同义词:必须使用基表指定分区或子分区扩展名,不能使用同义词,视图或任何其他对象。 - - - -* 在 `PARTITION FOR` 和 `SUBPARTITION FOR` 子句中,不能指定关键字 `DEFAULT` 、`MAXVALUE` 或绑定变量为 `partition_key_value` 或 `subpartition_key_value` 的值。 - - - -* 在 `PARTITION` 和 `SUBPARTITION` 子句中,不能为分区或子分区名称指定绑定变量。 - - - - - - -示例 --------------- - -在以下示例中, **sales** 是具有分区 **sales_q1_2000** 的分区表。以下语句创建了单个分区 **sales_q1_2000** 的视图,然后像使用表一样使用它。本示例从分区中删除了一些行: - -```javascript -/*为分区 sales_q1_2000 创建视图 Q1_2000_sales*/ -CREATE VIEW Q1_2000_sales -AS -SELECT * -FROM sales PARTITION (SALES_Q1_2000); -/*删除视图 Q1_2000_sales 中符合条件 amount_sold < 0 的值*/ -DELETE FROM Q1_2000_sales -WHERE amount_sold < 0; -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/9.database-object-reference-method/5.attributes-and-methods-of-referencing-object-types.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/9.database-object-reference-method/5.attributes-and-methods-of-referencing-object-types.md deleted file mode 100644 index 16ca063e0..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/3.basic-elements-1/9.database-object-reference-method/5.attributes-and-methods-of-referencing-object-types.md +++ /dev/null @@ -1,62 +0,0 @@ -引用对象类型的属性和方法 -================================= - - - -要在 SQL 语句中引用对象类型属性或方法,必须使用表别名完全限定该引用。以下示例中样本 Schema **ob** 包含类 **cust_address_typ** 和表 **customers** , **customers** 拥有一个 **cust_address_typ** 类型的列 **cust_address** : - -```javascript -CREATE TYPE cust_address_typ - OID '82A4AF6A4CD1656DE034080020E0EE3D' -AS OBJECT - (street_address VARCHAR2(40), - postal_code VARCHAR2(10), - city VARCHAR2(30), - state_province VARCHAR2(10), - country_id CHAR(2)); -/ -CREATE TABLE customers - (customer_id NUMBER(6), - cust_first_name VARCHAR2(20) CONSTRAINT cust_fname_nn NOT NULL, - cust_last_name VARCHAR2(20) CONSTRAINT cust_lname_nn NOT NULL, - cust_address cust_address_typ, -. . . -``` - - - -在 SQL 语句中,对 **postal_code** 属性的引用必须使用表别名进行完全限定,如下所示: - -```javascript -SELECT c.cust_address.postal_code -FROM customers c; - -UPDATE customers c -SET c.cust_address.postal_code = '610000' -WHERE c.cust_address.city = 'chengdu' -AND c.cust_address.state_province = 'SICHUAN'; -``` - - - -要引用不接受参数的成员方法,必须提供空括号。例如,样本 Schema **ob** 包含一个基于 **catalog_typ** 的对象表 **category_tab** ,该表包含成员函数 `getCatalogName`。为了在 SQL 语句中调用此方法,必须提供空括号,如下所示: - -```javascript -SELECT TREAT(VALUE(c) AS catalog_typ).getCatalogName() "Catalog Type" -FROM categories_tab c -WHERE category_id = 10; -``` - - - -返回结果: - -```javascript -+----------------+ -| Catalog Type | -+----------------+ -| online catalog | -+----------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/4.operator-1/1.operator-overview.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/4.operator-1/1.operator-overview.md deleted file mode 100644 index 7b48adac7..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/4.operator-1/1.operator-overview.md +++ /dev/null @@ -1,89 +0,0 @@ -运算符概述 -========================== - - - -运算符一般用于连接运算数或参数之类的单个数据项且返回结果。从语法上讲,运算符出现在运算数之前、之后或两个运算数之间均可。一般用特殊字符或关键字表示运算符,例如,除法运算符用斜杠(/)表示。本章讨论非逻辑(非布尔)运算符,这些运算符本身不能用作查询或子查询的 `WHERE` 或 `HAVING` 条件。 - -本章将详细介绍以下运算符: - -* 算术运算符 - - - -* 串联运算符 - - - -* 层次查询运算符 - - - -* 集合运算符 - - - - - - -一元和二元运算符 --------------------- - -运算符可分为两大类: - -* 一元运算符:一元运算符仅对一个运算数进行运算。一元运算符常用格式: - - - - - - -```javascript -运算符 运算数 -``` - - - -* 二元运算符:二元运算符顾名思义是对两个运算数进行运算。二元运算符常用格式: - - - - - - -```javascript -运算数1 运算符 运算数2 -``` - - - -其他具有特殊格式的运算符可接受两个以上的运算数。如果为运算符提供了空运算数(NULL), 则结果始终为空。唯一不遵循此规则的是串联(\|\|)运算符。 - -运算符优先级 ------------------- - -优先级会影响 OceanBase 数据库在同一表达式中计算不同运算符的顺序。在计算包含多个运算符的表达式时,OceanBase 会先计算优先级更高的运算符,然后再计算优先级较低的运算符,优先级相等时,在表达式中从左到右对相等的运算符求值。 - -下表列出了 SQL 运算符中从高到低的优先级。同一行上列出的运算符具有相同的优先级。 - - -| 运算符 | 运算方式 | -|------------------------------------|------------------------------------------------------------------| -| +、-(作为一元运算符)、PRIOR、CONNECT_BY_ROOT | 正号、负号、层次结构中的位置。 | -| \*、/ | 乘法、除法。 | -| +、-(作为二元运算符)、\|\| | 加、减、串联。 | -| 条件表达式在数据库评估完运算符后再进行评估 | 详情请参阅文档 [SQL 条件概述](../../11.sql-reference-oracle-mode/7.condition/1.overview-of-sql-conditions.md)。 | - - - -在以下示例中,由于乘法的优先级高于加法,因此数据库首先将 2 乘以 3,然后再将结果加到 1。 - -```javascript -1+2*3 -``` - - - -您也可以在表达式中使用括号来限制运算符优先级。OceanBase 数据库将先对括号内的表达式求值,再对括号外部的表达式求值。 - -SQL 还支持集合运算符(`UNION`、`UNION ALL`、`INTERSECT` 和 `MINUS`),集合运算符会合并查询返回的行集,而不是单个数据项。所有集合运算符都具有相同的优先级。 diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/4.operator-1/2.arithmetic-operators-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/4.operator-1/2.arithmetic-operators-1.md deleted file mode 100644 index 6ea43a90b..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/4.operator-1/2.arithmetic-operators-1.md +++ /dev/null @@ -1,47 +0,0 @@ -算术运算符 -========================== - - - -算术运算符用来对一个或两个参数进行求反、加、减、乘和除等操作。其中一些算术运算符还可用于计算日期时间和间隔值。算术运算符的参数必须解析为数字数据类型或任何可以被数据库直接转换为数字数据类型的数据类型。 - -一元算术运算符返回的数据类型与参数的数据类型相同。对于二进制算术运算符,OceanBase 先确定表达式中数值优先级最高的参数,再将其余参数转换为该参数的数据类型。 - -下表列出了算术运算符: - - -| 运算符 | 说明 | -|------|---------------------| -| +、- | 用于表示正、负时,它们是一元运算符。 | -| +、- | 用于表示加、减时,它们是二进制运算符。 | -| \*、/ | 二进制运算符,用于表示乘、除。 | - - - -算术表达式中不能使用两个连续的负号(--)来表示双重求反或减去一个负值,因为字符 -- 在 SQL 语句中用于指定注释。可以用空格或括号分隔连续的减号。有关 SQL 语句中的注释,详细信息请参阅章节 [注释](../../11.sql-reference-oracle-mode/3.basic-elements-1/6.annotation-1/1.annotation-overview.md)。 - -以下示例展示了运算符 +、- 用于表示正、负的 SQL 查询: - -```javascript -SELECT * FROM order_items WHERE quantity = -1 ORDER BY order_id, line_item_id, product_id; -SELECT * FROM employees WHERE -salary < 0 ORDER BY employee_id; -``` - - - -以下示例展示了运算符 +、- 用于表示加、减的 SQL 查询: - -```javascript -SELECT hire_date FROM employees WHERE SYSDATE - hire_date > 365 ORDER BY hire_date; -``` - - - -以下示例展示了 \*、/ 运算符表示乘、除的 SQL 查询: - -```javascript -UPDATE employees SET salary = salary * 1.1; -UPDATE employees SET salary = salary / 2; -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/4.operator-1/3.concatenate-operators.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/4.operator-1/3.concatenate-operators.md deleted file mode 100644 index ec955becc..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/4.operator-1/3.concatenate-operators.md +++ /dev/null @@ -1,32 +0,0 @@ -串联运算符 -========================== - - - -串联运算符 \|\| 用于连接字符串和 `CLOB` 数据类型的数据。 - -连接两个字符串后会得到另一个字符串。如果两个字符串的数据类型均为 `CHAR`,则返回结果的数据类型也为 `CHAR`,并且限制为 2000 个字符。如果被合并的任一字符串的数据类型为 `VARCHAR2`,则返回结果的数据类型也为 `VARCHAR2`,并且限制为 4000 个字符。如果串联运算符两边的参数中任何一个是 `CLOB` 数据类型的值,则返回结果的数据类型为临时 `CLOB`。无论两边参数的数据类型是什么,字符串中的尾部空格都是通过串联保存的。 - -尽管 OceanBase 将长度为 0 的字符串视为空值(NULL),但是将一个带有值的操作数和另一个 0 长度字符串连接得到的结果是一个带值的操作数,因此 NULL 只能由两个值为 NULL 的字符串串联产生。但是,在将来的 OceanBase 数据库版本中,情况可能不会继续如此。要连接可能为空的表达式,请使用 NVL 函数将表达式直接转换为长度为 0 的字符串。 - -此示例创建了一个同时包含 `CHAR` 和 `VARCHAR2` 类型列的表,然后插入带有和不带有尾部空格的值,并将它们连接起来。 - -```javascript -CREATE TABLE tab1 (col1 VARCHAR2(6), col2 CHAR(10), col3 VARCHAR2(10), col4 CHAR(6)); -INSERT INTO tab1 (col1, col2, col3, col4) VALUES ('abc', 'def ', 'ghi ', 'jkl'); -SELECT col1 || col2 || col3 || col4 "Concatenation" FROM tab1; -``` - - - -返回结果: - -```javascript -+----------------------------+ -| Concatenation | -+----------------------------+ -| abcdef ghi jkl | -+----------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/4.operator-1/4.hierarchical-query-operators-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/4.operator-1/4.hierarchical-query-operators-1.md deleted file mode 100644 index ca04933f6..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/4.operator-1/4.hierarchical-query-operators-1.md +++ /dev/null @@ -1,20 +0,0 @@ -层次查询运算符 -============================ - - - -`PRIOR` 和 `CONNECT_BY_ROOT` 运算符仅在 [层次查询](../../11.sql-reference-oracle-mode/8.queries-and-subqueries-1/3.hierarchical-query.md) 中有效。 - -PRIOR 运算符 ---------------------- - -在层次查询中,`CONNECT BY` 条件中应该包含至少一个由 `PRIOR` 运算符限定的表达式。`PRIOR` 运算符的结果,通过使用当前行的父行计算紧随后的表达式来得到。 - -`PRIOR` 最常用在列的等值比较场景中(`PRIOR` 可以在比较符的任意一侧)。理论上,在 `CONNECT BY` 子句中也可以使用等号(=)以外的其他运算符。但是,由这些其他运算符创建的条件可能会导致循环,在这种情况下,OceanBase 在运行时会检测循环并返回错误。 - -CONNECT_BY_ROOT 运算符 ----------------------------- - -`CONNECT_BY_ROOT` 是一元运算符,仅在层次查询中有效。`CONNECT_BY_ROOT` 的参数可以是列和大部分的表达式,`CONNECT_BY_ROOT` 运算符的结果,等于使用根行的数据计算参数的值。 - -您不能在 `START WITH` 条件或 `CONNECT BY` 条件中指定此运算符。 diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/4.operator-1/5.set-operators.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/4.operator-1/5.set-operators.md deleted file mode 100644 index a5fb604ca..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/4.operator-1/5.set-operators.md +++ /dev/null @@ -1,18 +0,0 @@ -集合运算符 -========================== - - - -集合运算符将两个查询结果合并为一个结果。包含集合运算符的查询称为复合查询。 - - -| 运算符 | 返回值 | -|-----------|------------------------------------| -| UNION | 返回任意查询选择的所有不同行。 | -| UNION ALL | 返回任意查询选择的所有行,并包括所有重复项。 | -| INTERSECT | 返回两个查询都选择的所有不同行。 | -| MINUS | 返回第一个查询选择的所有不同行,但其中不包括出现在第二个查询中的行。 | - - - -关于集合运算符的更多信息和示例,请参阅查询和子查询章节中关于 UNION ALL,INTERSECT,MINUS 运算符的介绍。 diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/4.operator-1/6.collation-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/4.operator-1/6.collation-1.md deleted file mode 100644 index 5742b6201..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/4.operator-1/6.collation-1.md +++ /dev/null @@ -1,49 +0,0 @@ -排序规则 -==== - -排序规则(即 COLLATE 运算符)用于指定字符序,可以用于重新设定字符类型的字符序或为单个表达式指定字符序。 - -COLLATE 是后缀一元运算符,与其它一元运算符优先级相同,但是在所有前缀一元运算符之后执行。COLLATE 运算符可以应用于 VARCHAR2,CHAR,LONG,NVARCHAR 或 NCHAR 类型的表达式。 - -COLLATE 运算符后跟一个参数 collation_name,表示需要设置或使用的字符序,字符序名称包含空格时必须在名称外加双引号。 - -举例如下: - -```javascript -obclient> create table t1(c1 varchar(20)); -obclient> insert into t1 values('a'); -obclient> insert into t1 values('b'); -obclient> insert into t1 values(1); -obclient> select * from t1 order by c1 collate utf8mb4_general_ci; -+------+ -| C1 | -+------+ -| 1 | -| a | -| b | -+------+ -3 rows in set (0.00 sec) -``` - -目前支持如下排序规则: - -```javascript -obclient> show collation; -+--------------------+---------+-----+---------+----------+---------+ -| COLLATION | CHARSET | ID | DEFAULT | COMPILED | SORTLEN | -+--------------------+---------+-----+---------+----------+---------+ -| utf8mb4_general_ci | utf8mb4 | 45 | Yes | Yes | 1 | -| utf8mb4_bin | utf8mb4 | 46 | NULL | Yes | 1 | -| binary | binary | 63 | Yes | Yes | 1 | -| gbk_chinese_ci | gbk | 28 | Yes | Yes | 1 | -| gbk_bin | gbk | 87 | NULL | Yes | 1 | -| utf16_general_ci | utf16 | 54 | Yes | Yes | 1 | -| utf16_bin | utf16 | 55 | NULL | Yes | 1 | -| utf8mb4_unicode_ci | utf8mb4 | 224 | NULL | Yes | 1 | -| utf16_unicode_ci | utf16 | 101 | NULL | Yes | 1 | -| gb18030_chinese_ci | gb18030 | 248 | Yes | Yes | 1 | -| gb18030_bin | gb18030 | 249 | NULL | Yes | 1 | -+--------------------+---------+-----+---------+----------+---------+ -11 rows in set (0.01 sec) -``` - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/1.function-overview.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/1.function-overview.md deleted file mode 100644 index 4e49e97b7..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/1.function-overview.md +++ /dev/null @@ -1,363 +0,0 @@ -函数概述 -========================= - - - -函数与运算符相似,即给定一些数据元素作为参数的输入并返回结果。然而函数在入参形式上与运算符有比较大的区别。函数允许包含的参数数量不定,一个函数里可以有一到两个,甚至更多的参数。 - -```javascript -函数名(参数,参数,...) -``` - - - -没有任何参数的函数类似于 [伪列](../../11.sql-reference-oracle-mode/2.pseudo-column.md)。但是,伪列通常为结果集中的每一行返回不同的值,而没有任何变量的函数通常为每一行返回相同的值。 - -关于函数 ----------------- - -OceanBase 内嵌的函数可以直接在 SQL 语句中使用。每个函数的入参传入值均有期望的数据类型,如果传入的数据类型不是期望的数据类型,则 OceanBase 会在实际执行 SQL 函数之前尝试将参数传入的数值转换为期望的数据类型。 - -函数中的空值 ------------------- - -对于绝大多数的函数当入参为空值 NULL 的时候,其返回的结果也为 NULL。这种情况下,您可以使用 `NVL` 函数返回一个非空值。例如,一张记录佣金的表的佣金列 **commission_pct** 为空值 NULL ,则表达式`NVL(commission_pct,0)` 返回 0;如果 **commission_pct** 的值不为 NULL,则返回实际的佣金值。 - -函数分类与列表 -------------------- - -在如下的函数分类列表中,每一类函数的参数和最终的函数返回值都有其特定的数据类型。 -**注意** - - - -在 SQL 语句中对 `LOB` 列使用函数时,OceanBase 数据库将在 SQL 和 PL/SQL 处理期间创建临时 `LOB` 列,并有一定的使用限制。 - -本章中函数分成了两大类: - -* **单行函数** :包括 数字函数、返回字符串的字符串函数、返回数字的字符串函数、 时间日期函数、通用比较函数、转换函数、编码解码函数和空值相关函数。 - -* **统计函数** :包括聚合函数和分析函数。 - - - - -单行函数对于被查询的表或者视图每一行均返回一个结果值,这些函数可以使用在 SQL 语句的 `SELECT`、`WHERE`、`START WITH`、`CONNECT BY`、`HAVING` 等子句当中。 - -分析函数与聚合函数,都是对行集组(一组行的集合)进行聚合计算,不同的是,聚合函数每组只能返回一个值(一行),而分析函数每组可以返回多个值(多行)。行集组又称为窗口(Window)。聚合函数通常和 `SELECT` 语句中的 `GROUP BY` 子句一起使用,使用时数据库将查询表或视图的行分为几组,并将聚合函数应用于每组行,同时为每组返回一个结果行。 - -使用分析函数时需要用特殊的关键字 `OVER` 来指定窗口。更多关于窗后函数的信息,请参阅文档 [窗口函数说明](../../11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/1.window-function-description.md)。 - -### 数字函数 - -数字函数的变量输入与函数输出结果均为数字类型,绝大部分的数字函数的返回值的数据类型为 `NUMBER`,可以精确到小数点后 38 位。一些高等代数相关函数 `COS`,`COSH`,`EXP`,`LN`,`LOG`,`SIN`,`SINH`,`SQRT`,`TAN`,`TANH` 等函数的结果精确到小数点后 36 位,其他代数相关函数 `ACOS`,`ASIN`,`ATAN` 和 `ATAN2`。其结果返回值精确到小数点后 30 位。 - - -| 函数分类 | 函数子分类 | 函数名 | 功能描述 | -|------|-------|--------------|---------------------------------------------------------| -| 单行函数 | 数字函数 | ABS | 返回指定数值表达式的绝对值(正值)的数学函数。 | -| 单行函数 | 数字函数 | ACOS | 返回以弧度表示的角,其余弦为指定的 `NUMBER` 表达式,也称为反余弦。 | -| 单行函数 | 数字函数 | ASIN | OceanBase 暂不支持。 | -| 单行函数 | 数字函数 | ATAN | OceanBase 暂不支持。 | -| 单行函数 | 数字函数 | ATAN2 | OceanBase 暂不支持。 | -| 单行函数 | 数字函数 | BITAND | 运算符按位进行"与"操作。输入和输出类型均为 `INT` 整型,且类型一致。 | -| 单行函数 | 数字函数 | CEIL | 返回值大于等于数值 `numeric_expression` 的最小整数。 | -| 单行函数 | 数字函数 | COS | OceanBase 暂不支持。 | -| 单行函数 | 数字函数 | COSH | OceanBase 暂不支持。 | -| 单行函数 | 数字函数 | EXP | 返回 e 的 numeric_expression 次幂。 | -| 单行函数 | 数字函数 | FLOOR | 返回小于等于数值 `numeric_expression` 的最大整数。 | -| 单行函数 | 数字函数 | LN | 返回以 e 为底的 `numeric_expression` 的对数。 | -| 单行函数 | 数字函数 | LOG | 返回以 `x` 为底的 `y` 的对数。 | -| 单行函数 | 数字函数 | MOD | 返回 `x` 除以 `y` 的余数。 | -| 单行函数 | 数字函数 | POWER | 返回 `x` 的 `y` 次幂。 | -| 单行函数 | 数字函数 | REMAINDER | 返回 `x` 除以 `y` 的余数。 | -| 单行函数 | 数字函数 | ROUND | 返回 `numberic` 四舍五入后的值。 | -| 单行函数 | 数字函数 | SIGN | 返回数字 `n` 的符号,大于 0 返回 1,小于 0 返回 -1 ,等于 0 返回 0。 | -| 单行函数 | 数字函数 | SIN | OceanBase 暂不支持。 | -| 单行函数 | 数字函数 | SINH | OceanBase 暂不支持。 | -| 单行函数 | 数字函数 | SQRT | 返回 `n` 的平方根。 | -| 单行函数 | 数字函数 | TAN | OceanBase 暂不支持。 | -| 单行函数 | 数字函数 | TANH | OceanBase 暂不支持。 | -| 单行函数 | 数字函数 | TRUNC | 返回 `numeric` 按精度 `precision` 截取后的值。 | -| 单行函数 | 数字函数 | WIDTH_BUCKET | OceanBase 暂不支持。 | - - - -### 返回字符串的字符串函数 - -函数的返回值的最大长度受数据类型的影响,比如:函数的返回值的数据类型是 `VARCHAR2`,但是返回值实际的大小超过了 `VARCHAR2` 数据类型的最大限制,此时 OceanBase 数据库会对结果进行截断处理并返回,但是在客户端上并不会显示提示。 -**注意** - - - -如果返回值的数据类型是 `CLOB`,当返回值长度超过了最大限制时,OceanBase 不会返回数据且显示错误提示。 - - -| **函数分类** | **函数子分类** | **函数名** | **功能描述** | -|----------|-------------|----------------|----------------------------------------------| -| 单行函数 | 返回字符串的字符串函数 | CHR | 将 `n` 转换为等价的一个或多个字符返回,且返回值与当前系统的字符集相关。 | -| 单行函数 | 返回字符串的字符串函数 | CONCAT | 连接两个字符串。 | -| 单行函数 | 返回字符串的字符串函数 | INITCAP | 返回字符串并将字符串中每个单词的首字母大写,其他字母小写。 | -| 单行函数 | 返回字符串的字符串函数 | LOWER | 将字符串全部转为小写。 | -| 单行函数 | 返回字符串的字符串函数 | LPAD | 在字符串 `c1` 的左边用字符串 `c2` 填充,直到长度为 `n` 时为止。 | -| 单行函数 | 返回字符串的字符串函数 | LTRIM | 删除左边出现的字符串。 | -| 单行函数 | 返回字符串的字符串函数 | REGEXP_REPLACE | 用于正则表达式替换。 | -| 单行函数 | 返回字符串的字符串函数 | REGEXP_SUBSTR | OceanBase 暂不支持。 | -| 单行函数 | 返回字符串的字符串函数 | REPLACE | 将字符表达式值中,部分相同字符串,替换成新的字符串。 | -| 单行函数 | 返回字符串的字符串函数 | RPAD | 在字符串 `c1` 的右边用字符串 `c2` 填充,直到长度为 `n` 时为止。 | -| 单行函数 | 返回字符串的字符串函数 | RTRIM | 删除右边出现的字符串,此函数对于格式化查询的输出非常有用。 | -| 单行函数 | 返回字符串的字符串函数 | SUBSTR | 截取子字符串。其中多字节符(汉字、全角符等)按 1 个字符计算。 | -| 单行函数 | 返回字符串的字符串函数 | TRANSLATE | 将字符表达式值中,指定字符替换为新字符。多字节符(汉字、全角符等),按 1 个字符计算。 | -| 单行函数 | 返回字符串的字符串函数 | TRIM | 删除一个字符串的开头或结尾(或两者)的字符。 | -| 单行函数 | 返回字符串的字符串函数 | UPPER | 将字符串全部转为大写。 | - - - -### 返回数字的字符串函数 - - - -| **函数分类** | **函数子分类** | **函数名** | **功能描述** | -|----------|------------|--------------|------------------------------| -| 单行函数 | 返回数字的字符串函数 | ASCII | 返回字符表达式最左端字符的 ASCII 码值。 | -| 单行函数 | 返回数字的字符串函数 | INSTR | 在一个字符串中搜索指定的字符,返回发现指定的字符的位置。 | -| 单行函数 | 返回数字的字符串函数 | LENGTH | 返回字符串的长度。 | -| 单行函数 | 返回数字的字符串函数 | REGEXP_COUNT | OceanBase 暂不支持。 | -| 单行函数 | 返回数字的字符串函数 | REGEXP_INSTR | OceanBase 暂不支持。 | - - - -### 时间日期函数 - -时间日期函数支持的入参数据类型有三类:日期时间 (`DATE`)、时间戳 (`TIMESTAMP`、`TIMESTAMP WITH TIME ZONE`、`TIMESTAMP WITH LOCAL TIME ZONE`),以及间隔 (`INTERVAL DAY TO SECOND`、`INTERVAL YEAR TO MONTH`) - -仅支持 `DATE` 数据类型入参的函数列表:`ADD_MONTHS`、`CURRENT_DATE, LAST_DAY`、`NEW_TIME` 和 `NEXT_DAY`。 - -如果对于以上函数,您尝试给入的是 `TIMESTAMP` 类型的数据,OceanBase 内部会先进行隐式数据类型转换后带入函数进行运算,并返回 `DATE` 类型的返回值。 - -在使用时间函数前,建议执行 `SELECT * FROM NLS_DATABASE_PARAMETERS` 查看当前的 NLS 格式: - -```unknow -obclient> SELECT * FROM NLS_DATABASE_PARAMETERS; -+-------------------------+------------------------------+ -| PARAMETER | VALUE | -+-------------------------+------------------------------+ -| NLS_DATE_FORMAT | DD-MON-RR | -| NLS_TIMESTAMP_FORMAT | YYYY-MM-DD HH24:MI:SS | -| NLS_TIMESTAMP_TZ_FORMAT | DD-MON-RR HH.MI.SSXFF AM TZR | -| NLS_TERRITORY | AMERICA | -| NLS_SORT | BINARY | -| NLS_COMP | BINARY | -| NLS_CHARACTERSET | AL32UTF8 | -| NLS_NCHAR_CHARACTERSET | AL16UTF16 | -| NLS_DATE_LANGUAGE | AMERICAN | -| NLS_LENGTH_SEMANTICS | BYTE | -| NLS_NCHAR_CONV_EXCP | FALSE | -| NLS_CALENDAR | GREGORIAN | -| NLS_NUMERIC_CHARACTERS | ., | -+-------------------------+------------------------------+ -13 rows in set (0.05 sec) -``` - - - -如果与文中示例的显示格式不一致,可以执行如下命令更改格式: - -```unknow -obclient>ALTER SESSION SET NLS_DATE_FORMAT = 'YYYY-MM-DD HH24:MI:SS'; -Query OK, 0 rows affected (0.00 sec) - -obclient>ALTER SESSION SET NLS_TIMESTAMP_FORMAT = 'YYYY-MM-DD HH24:MI:SS.FF'; -Query OK, 0 rows affected (0.00 sec) -/*将返回值中秒的小数位设置为 9 位*/ - -obclient> ALTER SESSION SET NLS_TIMESTAMP_TZ_FORMAT = 'YYYY-MM-DD HH24:MI:SS.FF TZR TZD'; -Query OK, 0 rows affected (0.00 sec) -``` - - -**注意** - - - -* `MONTHS_BETWEEN` 返回值为 1 个数字。 - - - -* `ROUND` 和 `TRUNC` 并不能进行隐式转换,必须传输 `DATE` 类型的数值,否则会报错。 - - - - - - -剩余的函数对于三种参数数据类型均可以支持,且返回和入参同样的数据类型。 - - -| **函数分类** | **函数子分类** | **函数名** | **功能描述** | -|----------|-----------|--------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 单行函数 | 时间日期函数 | ADD_MONTHS | 返回在日期 `date` 基础上 `n` 个月后的日期值,如果 `n` 的值为负数则返回日期 `date` 基础上 `n` 个月前的日期值(`date` 减去 `n` 个月)。 | -| 单行函数 | 时间日期函数 | CURRENT_DATE | 返回当前会话时区中的当前日期。 | -| 单行函数 | 时间日期函数 | CURRENT_TIMESTAMP | 返回 `TIMESTAMP WITH TIME ZONE` 数据类型的当前会话时区中的当前日期,返回值中包含当前的时区信息。 | -| 单行函数 | 时间日期函数 | DBTIMEZONE | 返回当前数据库实例的时区,在 OceanBase 中数据库时区恒为+00:00,且不支持修改。 | -| 单行函数 | 时间日期函数 | EXTRACT (datetime) | 从指定的时间字段或表达式中抽取年、月、日、时、分、秒等元素。 | -| 单行函数 | 时间日期函数 | FROM_TZ | 将一个 `TIMSTAMP` 数据类型的值和时区信息拼成一个 `TIMESTAMP WITH TIME ZONE` 数据类型的时间值。 | -| 单行函数 | 时间日期函数 | LAST_DAY | 返回日期 `date` 所在月份的最后一天的日期。 | -| 单行函数 | 时间日期函数 | LOCALTIMESTAMP | 返回当前会话时区中的当前日期,返回 `TIMESTAMP` 数据类型的值。 | -| 单行函数 | 时间日期函数 | MONTHS_BETWEEN | 返回返回参数 `date1` 到 `date2` 之间的月数。 | -| 单行函数 | 时间日期函数 | NEW_TIME | OceanBase 暂不支持。 | -| 单行函数 | 时间日期函数 | NEXT_DAY | 返回日期 `d1` 的下一周中 `c1`(星期值)所在的日期值。 | -| 单行函数 | 时间日期函数 | NUMTODSINTERVAL | 把参数 `n` 转为以参数 `interval_unit` 为单位的 `INTERVAL DAY TO SECOND` 数据类型的值。 | -| 单行函数 | 时间日期函数 | NUMTOYMINTERVAL | 把参数 `n` 转为以 `interval_unit` 为单位的 `INTERVAL YEAR TO MONTH` 数据类型的值。 | -| 单行函数 | 时间日期函数 | ROUND (date) | 返回以参数 `fmt` 为单位距离的离指定日期 `date` 最近的日期时间值。 | -| 单行函数 | 时间日期函数 | SESSIONTIMEZONE | 返回当前会话时区。 | -| 单行函数 | 时间日期函数 | SYS_EXTRACT_UTC | 返回与指定时间相对应的的标准 UTC 时间。 | -| 单行函数 | 时间日期函数 | SYSDATE | 返回当前日期。 | -| 单行函数 | 时间日期函数 | SYSTIMESTAMP | 返回系统当前日期,返回值的秒的小数位包含 6 位精度,且包含当前时区信息。 | -| 单行函数 | 时间日期函数 | TO_CHAR (datetime) | 将 `DATE`、`TIMESTAMP`、`TIMESTAMP WITH TIME ZONE`、`TIMESTAMP WITH LOCAL TIME ZONE`、`INTERVAL DAY TO SECOND` 和 `INTERVAL YEAR TO MONTH` 等数据类型的值按照参数 `fmt` 指定的格式转换为 `VARCHAR2` 数据类型的值。 | -| 单行函数 | 时间日期函数 | TO_DSINTERVAL | 将一个 `CHAR`、`VARCHAR2`、`NCHAR` 或 `NVARCHAR2` 数据类型的字符串转换为一个 `INTERVAL DAY TO SECOND` 数据类型的值,该函数可以用来对一个日期时间值进行加减计算。 | -| 单行函数 | 时间日期函数 | TO_TIMESTAMP | 将字符串转换为 `TIMESTAMP` 数据类型。 | -| 单行函数 | 时间日期函数 | TO_TIMESTAMP_TZ | 将字符串转换为 `TIMESTAMP WITH TIME ZONE` 数据类型,包含时区信息。 | -| 单行函数 | 时间日期函数 | TO_YMINTERVAL | 将一个 `CHAR`、`VARCHAR2`、`NCHAR` 或`NVARCHAR2` 数据类型的字符串转换为一个 `INTERVAL YEAR TO MONTH` 数据类型的值,该函数可以用来对一个日期时间值进行加减计算。 | -| 单行函数 | 时间日期函数 | TRUNC (date) | 返回以参数 `fmt` 为单位距离的离指定日期 `date` 最近的日期时间值,并且返回的日期值在 `date` 之前。 | -| 单行函数 | 时间日期函数 | TZ_OFFSET | 返回时区 `n` 的时区偏移量。时区偏移量是指与格林尼治标准时间 GMT 的差(小时和分钟)。 | - - - -### 通用比较函数 - -可以通过本类别函数快速的在集合中寻找到最大值和最小值。 - - -| **函数分类** | **函数子分类** | **函数名** | **功能描述** | -|----------|-----------|----------|--------------------| -| 单行函数 | 通用比较函数 | GREATEST | 返回一个或多个表达式列表中的最大值。 | -| 单行函数 | 通用比较函数 | LEAST | 返回一个或多个表达式列表中的最小值。 | - - - -### 转换函数 - -可以通过本类型的函数将原本的数据类型转换为另外一种数据类型。 - - -| **函数分类** | **函数子分类** | **函数名** | **功能描述** | -|----------|-----------|---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| **函数分类** | **函数子分类** | **函数名** | **功能描述** | -| 单行函数 | 转换函数 | ASCIISTR | OceanBase 暂不支持。 | -| 单行函数 | 转换函数 | BIN_TO_NUM | OceanBase 暂不支持。 | -| 单行函数 | 转换函数 | CHARTOROWID | OceanBase 暂不支持。 | -| 单行函数 | 转换函数 | HEXTORAW | 将 `CHAR`、`VARCHAR2`、`NCHAR` 或 `NVARCHAR2` 数据类型中包含十六进制数字的字符转换为 RAW 数据类型。 | -| 单行函数 | 转换函数 | RAWTOHEX | 将二进制数转换为一个相应的十六进制表示的字符串。 | -| 单行函数 | 转换函数 | TO_BINARY_DOUBLE | 返回一个双精度的 64 位浮点数. | -| 单行函数 | 转换函数 | TO_BINARY_FLOAT | 返回一个单精度的 32 位浮点数。 | -| 单行函数 | 转换函数 | TO_CHAR (character) | 将 `NCHAR`、`NVARCHAR2` 或 `CLOB` 数据转换为数据库字符集。 | -| 单行函数 | 转换函数 | TO_CHAR (datetime) | 将 `DATE`、`TIMESTAMP`、`TIMESTAMP WITH TIME ZONE`、`TIMESTAMP WITH LOCAL TIME ZONE`、`INTERVAL DAY TO SECOND` 和 `INTERVAL YEAR TO MONTH` 等数据类型的值按照参数 `fmt` 指定的格式转换为 `VARCHAR2` 数据类型的值。 | -| 单行函数 | 转换函数 | TO_CHAR (number) | 将 `NUMBER`、`BINARY_FLOAT` 或 `BINARY_DOUBLE` 类型的数值 `n` 按照指定数值格式 `fmt` 转换为 `varchar2` 数据类型的值。 | -| 单行函数 | 转换函数 | TO_DATE | 将 `CHAR`、`VARCHAR`、`NCHAR` 或 `NVARCHAR2` 数据类型的字符转换为日期数据类型的值。 | -| 单行函数 | 转换函数 | TO_DSINTERVAL | 将一个 `CHAR`、`VARCHAR2`、`NCHAR` 或 `NVARCHAR2` 数据类型的字符串转换为一个 `INTERVAL DAY TO SECOND` 数据类型的值,该函数可以用来对一个日期时间值进行加减计算。 | -| 单行函数 | 转换函数 | TO_NUMBER | 将 `expr` 转换为数值数据类型的值。 | -| 单行函数 | 转换函数 | TO_TIMESTAMP | 将字符串转换为 `TIMESTAMP` 数据类型。 | -| 单行函数 | 转换函数 | TO_TIMESTAMP_TZ | 将字符串转换为 `TIMESTAMP WITH TIME ZONE` 数据类型,包含时区信息。 | -| 单行函数 | 转换函数 | TO_YMINTERVAL | 将一个 `CHAR`、`VARCHAR2`、`NCHAR` 或 `NVARCHAR2` 数据类型的字符串转换为一个 `INTERVAL YEAR TO MONTH` 数据类型的值,该函数可以用来对一个日期时间值进行加减计算。 | - - - -### 编码解码函数 - -可以通过本类型的函数在 OceanBase 数据库中实现数据的编码解密需求。 - - -| **函数分类** | **函数子分类** | **函数名** | **功能描述** | -|----------|-----------|----------|------------------| -| 单行函数 | 编码解码函数 | DECODE | 会根据条件返回相应值。 | -| 单行函数 | 编码解码函数 | ORA_HASH | 获取对应表达式的 HASH 值。 | -| 单行函数 | 编码解码函数 | VSIZE | 返回 `X` 的字节大小数。 | - - - -### 空值相关函数 - - - -| **函数分类** | **函数子分类** | **函数名** | **功能描述** | -|----------|-----------|----------|--------------------------------------------------------------------------------------------------------------------------------| -| 单行函数 | 空值相关函数 | COALESCE | 返回参数列表中第一个非空表达式,必须指定最少两个参数。 | -| 单行函数 | 空值相关函数 | LNNVL | 判断条件中的一个或者两个操作数是否为 `NULL`。 | -| 单行函数 | 空值相关函数 | NULLIF | OceanBase 暂不支持。 | -| 单行函数 | 空值相关函数 | NVL | 从两个表达式返回一个非 NULL 值。如果 `expr1` 与 `expr2` 的结果皆为 NULL 值,则 NVL 函数返回 NULL。 | -| 单行函数 | 空值相关函数 | NVL2 | 根据表达式是否为空,返回不同的值。如果 `expr1` 不为空,则返回 `expr2` 的值,如果 `expr1` 为空,则返回 `expr3` 的值。`expr2` 和 `expr3` 类型不同的话,`expr3` 会转换为 `expr1` 的类型。 | - - - -### 环境相关函数 - -本分类的函数主要提供会话或者租户实例相关的环境信息。 - - -| **函数分类** | **函数子分类** | **函数名** | **功能描述** | -|----------|-----------|-------------|-----------------| -| 单行函数 | 环境相关函数 | SYS_CONTEXT | OceanBase 暂不支持。 | -| 单行函数 | 环境相关函数 | UID | OceanBase 暂不支持。 | -| 单行函数 | 环境相关函数 | USER | OceanBase 暂不支持。 | - - - -### 聚合函数 - - - -| **函数分类** | **函数子分类** | **函数名** | **功能描述** | -|----------|-----------|-----------------------|-----------------------------------------------------------| -| 统计函数 | 聚合函数 | AVG | 返回数值列的平均值。 | -| 统计函数 | 聚合函数 | COUNT | 用于查询参数 `expr` 的行数。 | -| 统计函数 | 聚合函数 | SUM | 返回参数中指定列的和。 | -| 统计函数 | 聚合函数 | GROUPING | OceanBase 暂不支持。 | -| 统计函数 | 聚合函数 | MAX | 返回参数中指定的列中的最大值。 | -| 统计函数 | 聚合函数 | MIN | 返回参数中指定列的最小值。 | -| 统计函数 | 聚合函数 | LISTAGG | 用于列转行,`LISTAGG` 对 `ORDER BY` 子句中指定的每个组内的数据进行排序,然后合并度量列的值。 | -| 统计函数 | 聚合函数 | ROLLUP | 在数据统计和报表生成过程中,它可以为每个分组返回一个小计,同时为所有分组返回总计。 | -| 统计函数 | 聚合函数 | STDDEV | 用于计算总体标准差。 | -| 统计函数 | 聚合函数 | STDDEV_POP | 计算总体标准差。 | -| 统计函数 | 聚合函数 | STDDEV_SAMP | 计算样本标准差。 | -| 统计函数 | 聚合函数 | VARIANCE | 返回参数指定列的方差。 | -| 统计函数 | 聚合函数 | APPROX_COUNT_DISTINCT | 计算某一列去重后的行数,返回的值是一个近似值,该函数可以进一步用于计算被引用的列的选择性。 | - - - -### 分析函数 - - - -| **函数分类** | **函数子分类** | **函数名** | **功能描述** | -|----------|-----------|-----------------|------------------------------------------------------------------------------------| -| 统计函数 | 分析函数 | AVG | 返回数值列的平均值。 | -| 统计函数 | 分析函数 | COUNT | 用于查询参数 `expr` 的行数。 | -| 统计函数 | 分析函数 | CUME_DIST | 计算一个值在一组值中的累积分布。 | -| 统计函数 | 分析函数 | DENSE_RANK | 计算有序行组中行的秩,并将秩作为 `NUMBER` 返回。 | -| 统计函数 | 分析函数 | MAX | 返回参数中指定的列中的最大值。 | -| 统计函数 | 分析函数 | MIN | 返回参数中指定列的最小值。 | -| 统计函数 | 分析函数 | SUM | 返回参数中指定列的和。 | -| 统计函数 | 分析函数 | FIRST_VALUE | 返回有序值中的第一个值。 | -| 统计函数 | 分析函数 | LAG | 提供对多行表的访问,而不需要自连接。 | -| 统计函数 | 分析函数 | LAST_VALUE | 返回一组有序值中的最后一个值。 | -| 统计函数 | 分析函数 | LEAD | 它提供了对表多行的访问,而无需进行自我连接。给定从查询返回的一些列行和光标的位置,`LEAD` 提供超出该位置的物理偏移量的行的访问。 | -| 统计函数 | 分析函数 | LISTAGG | 用于列转行。 | -| 统计函数 | 分析函数 | NTH_VALUE | 返回 `analytic_clause` 定义的窗口中第 `n` 行的 `measure_expr` 值。 | -| 统计函数 | 分析函数 | NTILE | 将有序数据集划分为 `expr` 指示的若干桶,并为每一行分配适当的桶号。 | -| 统计函数 | 分析函数 | PERCENT_RANK | 类似于 `CUME_DIST`(累积分布)函数。 它的返回值范围为 0\~1。任何集合中的第一行的`PERCENT_RANK` 函数为 0,返回值为 NUMBER。 | -| 统计函数 | 分析函数 | SUM | 返回参数中指定列的和。 | -| 统计函数 | 分析函数 | RANK | 基于 `OVER` 子句中的 `ORDER BY` 表达式确定一组值的排名。 | -| 统计函数 | 分析函数 | RATIO_TO_REPORT | 计算一个值与一组值之和的比率。 | -| 统计函数 | 分析函数 | ROW_NUMBER | 为应用它的每一行分配一个唯一的数字。 | -| 统计函数 | 分析函数 | STDDEV | 用于计算总体标准差。 | -| 统计函数 | 分析函数 | STDDEV_POP | 计算总体标准差。 | -| 统计函数 | 分析函数 | STDDEV_SAMP | 计算样本标准差。 | -| 统计函数 | 分析函数 | VARIANCE | 返回参数指定列的方差。 | - - - -更多信息 ----------------- - -分析函数中的关键字 `OVER`,请参阅 [窗口函数说明](../../11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/1.window-function-description.md)。 diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/1.ABS.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/1.ABS.md deleted file mode 100644 index 3b43216a9..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/1.ABS.md +++ /dev/null @@ -1,56 +0,0 @@ -ABS -======================== - - - -`ABS` 函数是返回指定数值表达式的绝对值(正值)的数学函数。`ABS` 将负值更改为正值,对零或正值没有影响。 - -语法 --------------- - -```javascript -ABS (numeric_expression) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|--------------------|-----------------------------------------------------------------------| -| numeric_expression | 精确数值或近似数值数据类型(`NUMBER`、`FLOAT`、`BINARY_FLOAT` 和 `BINARY_DOUBLE`)的表达式。 | - - - -返回类型 ----------------- - -返回与 `numeric_expression` 相同的类型。 - -示例 --------------- - -本示例显示了对三个不同数字使用 `ABS` 函数所得的结果。 - -执行以下语句: - -```javascript -SELECT ABS(-1.0), ABS(0.0), ABS(1.0), ABS(1.666) FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+-----------+----------+----------+------------+ -| ABS(-1.0) | ABS(0.0) | ABS(1.0) | ABS(1.666) | -+-----------+----------+----------+------------+ -| 1 | 0 | 1 | 1.666 | -+-----------+----------+----------+------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/10.POWER.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/10.POWER.md deleted file mode 100644 index 59b0b35e4..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/10.POWER.md +++ /dev/null @@ -1,56 +0,0 @@ -POWER -========================== - - - -`POWER` 函数返回 `x` 的 `y` 次幂。 - -语法 --------------- - -```javascript -POWER (x, y) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|-----|-----------------------------------------------------------------------| -| x,y | `x` 和 `y` 为数值型(`NUMBER`、`FLOAT`、`BINARY_FLOAT` 和 `BINARY_DOUBLE`)表达式。 | - - - -返回类型 ----------------- - -当参数为 `BINARY_FLOAT` 和 `BINARY_DOUBLE` 数据类型时,返回类型为 `BINARY_DOUBLE`,其他情况下返回类型为 `NUMBER`。 - -示例 --------------- - -此示例显示了对三组不同数字使用 `POWER` 函数所得的结果。 - -执行以下语句: - -```javascript -SELECT POWER(2,2), POWER(1.5,0), POWER(20, -1) FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+------------+--------------+--------------+ -| POWER(2,2) | POWER(1.5,0) | POWER(20,-1) | -+------------+--------------+--------------+ -| 4 | 1 | .05 | -+------------+--------------+--------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/11.REMAINDER.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/11.REMAINDER.md deleted file mode 100644 index 9b3550a17..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/11.REMAINDER.md +++ /dev/null @@ -1,63 +0,0 @@ -REMAINDER -============================== - - - -`REMAINDER` 函数返回 `x` 除以 `y` 的余数。 -**注意** - - - -与 MOD 函数的区别为: - -在用 `REMAINDER (x,y)` 和 `MOD (x,y)` 函数在进行运算时,都用了一个公式 result=x-y\*(x/y),区别在于计算 x/y 时的处理方式不同。在 `REMAINDER (x,y)` 函数中,采用 `ROUND(x/y)`,而在 `MOD (x,y)` 函数中采用 `FLOOR(x/y)`。在`REMAINDER` 函数中,当 `ROUND(x/y)` 的参数 x/y 的值的小数部分恰好为 0.5 时,如果 x/y 的值的整数部分为偶数,不向前一位进位,当 x/y 的值的整数部分为奇数,向前一位进位。例如,`ROUND(1.5)`=2、`ROUND(2.5)`=2、`ROUND(3.5)`=4、`ROUND(4.5)`=4。 - -语法 --------------- - -```javascript -REMAINDER (x, y) -``` - - - -参数 --------------- - - - -| **参数** | **说明** | -|--------|-----------------------------------------------------------------------| -| x,y | `x` 和 `y` 为数值型(`NUMBER`、`FLOAT`、`BINARY_FLOAT` 和 `BINARY_DOUBLE`)表达式。 | - - - -返回类型 ----------------- - -返回类型与数值优先级高的参数的数据类型相同。 - -示例 --------------- - -此示例显示了使用 `MOD` 以及 `REMAINDER` 函数计算 1.5/1 的余数的结果,请注意两个函数的区别。 - -执行以下语句: - -```javascript -SELECT MOD(1.5,1), REMAINDER(1.5,1) FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+------------+------------------+ -| MOD(1.5,1) | REMAINDER(1.5,1) | -+------------+------------------+ -| .5 | -.5 | -+------------+------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/12.ROUND.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/12.ROUND.md deleted file mode 100644 index bb62ddb7e..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/12.ROUND.md +++ /dev/null @@ -1,57 +0,0 @@ -ROUND -========================== - - - -`ROUND` 函数返回参数 `numeric` 四舍五入后的值。 - -语法 --------------- - -```javascript -ROUND (numeric[,decimal]) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|---------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| numeric | 数值型(`NUMBER`、`FLOAT`、`BINARY_FLOAT` 和 `BINARY_DOUBLE`)表达式。 | -| decimal | 如果 `decimal` 大于等于 0 则将 `numeric` 四舍五入到 `decimal` 位小数,如果 `decimal` 小于 0 则四舍五入到小数点向左第 `decimal` 位。当 `decimal` 不为整数时,截取 `decimal` 的整数部分。不指定 `decimal` 时,将 `numeric` 四舍五入到整数位。 | - - - -返回类型 ----------------- - -不指定 `decimal` 时返回类型与参数 `numeric` 的类型相同,指定 `decimal` 时,返回类型为 `NUMBER` 数据类型。 - -示例 --------------- - -此示例显示了在 `decimal` 的不同值下四舍五入 5555.6666 的结果。 - -执行以下语句: - -```javascript -SELECT ROUND(5555.6666, 2.1), ROUND(5555.6666, -2.6), ROUND(5555.6666) FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+----------------------+-----------------------+------------------+ -| ROUND(5555.6666,2.1) | ROUND(5555.6666,-2.6) | ROUND(5555.6666) | -+----------------------+-----------------------+------------------+ -| 5555.67 | 5600 | 5556 | -+----------------------+-----------------------+------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/13.SIGN.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/13.SIGN.md deleted file mode 100644 index bc9207990..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/13.SIGN.md +++ /dev/null @@ -1,56 +0,0 @@ -SIGN -========================= - - - -`SIGN` 函数返回数字 `n` 的符号,大于 0 返回 1,小于 0 返回 -1 ,等于 0 返回 0。 - -语法 --------------- - -```javascript -SIGN (n) -``` - - - -参数 --------------- - - - -| **参数** | **说明** | -|--------|-----------------------------------------------------------------------| -| n | 精确数值或近似数值数据类型(`NUMBER`、`FLOAT`、`BINARY_FLOAT` 和 `BINARY_DOUBLE`)的表达式。 | - - - -返回类型 ----------------- - -返回数值 0,1 和 -1。 - -示例 --------------- - -此示例显示了对三个不同数字使用 `SIGN` 函数所得的结果。 - -执行以下语句: - -```javascript -SELECT SIGN(100), SIGN(-100), SIGN(0) FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+-----------+------------+---------+ -| SIGN(100) | SIGN(-100) | SIGN(0) | -+-----------+------------+---------+ -| 1 | -1 | 0 | -+-----------+------------+---------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/14.SQRT.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/14.SQRT.md deleted file mode 100644 index d295520cd..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/14.SQRT.md +++ /dev/null @@ -1,56 +0,0 @@ -SQRT -========================= - - - -`SQRT` 函数返回 `n` 的平方根。 - -语法 --------------- - -```javascript -SQRT (n) -``` - - - -参数 --------------- - - - -| **参数** | **说明** | -|--------|---------------------------------------------------------------------------------------| -| n | 数值型(`NUMBER`、`FLOAT`、`BINARY_FLOAT` 和 `BINARY_DOUBLE`)表达式。 `n` 不能为负数。 | - - - -返回类型 ----------------- - -返回类型与参数 `n` 的数据类型相同。 - -示例 --------------- - -此示例显示了对两个不同数字使用 `SQRT` 函数求平方根的结果。 - -执行以下语句: - -```javascript -SELECT SQRT(64), SQRT(10) FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+----------+------------------------------------------+ -| SQRT(64) | SQRT(10) | -+----------+------------------------------------------+ -| 8 | 3.16227766016837933199889354443271853372 | -+----------+------------------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/15.TRUNC.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/15.TRUNC.md deleted file mode 100644 index c548eaa83..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/15.TRUNC.md +++ /dev/null @@ -1,56 +0,0 @@ -TRUNC -========================== - - - -`TRUNC` 函数返回 `numberic` 按精度 `precision` 截取后的值。 - -语法 ------------ - -```javascript -TRUNC (numberic[,precision]) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| numberic,precision | 数值型(`NUMBER`、`FLOAT`、`BINARY_FLOAT` 和 `BINARY_DOUBLE`)表达式。如果 `precision` 不为整数则截取 `precision` 的整数部分。`precision` 大于等于 0 时截取 `numeric` 到 `precision` 位小数, `precision` 小于 0 时截取到 `numeric` 小数点向左第 `precision` 位,小数前其它数据用 0 表示。 `precision` 的默认值为 0。 | - - - -返回类型 ----------------- - -不指定 `precision` 时,返回类型与参数 `numberic` 的数据类型相同。指定 `precision` 时,返回类型为 `NUMBER`。 - -示例 --------------- - -此示例显示了在 `precision` 的不同值下 5555.66666的计算结果。 - -执行以下语句: - -```javascript -SELECT TRUNC(5555.66666, 2.1), TRUNC(5555.66666, -2.6), TRUNC(5555.66666) FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+-----------------------+------------------------+--------------------+ -| TRUNC(5555.66666,2.1) | TRUNC(5555.66666,-2.6) | TRUNC(5555.033333) | -+-----------------------+------------------------+--------------------+ -| 5555.66 | 5500 | 5555 | -+-----------------------+------------------------+--------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/2.ACOS.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/2.ACOS.md deleted file mode 100644 index e5d0e6e63..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/2.ACOS.md +++ /dev/null @@ -1,56 +0,0 @@ -ACOS -========================= - - - -`ACOS` 函数返回以弧度表示的角,其余弦为指定的 `NUMBER` 表达式,也称为反余弦。 - -语法 --------------- - -```javascript -ACOS (num_expression) -``` - - - -参数 --------------- - - - -| 参数 | 值 | 说明 | -|----------------|-------------|--------------------------------------------------------------------------------------------| -| num_expression | -1.00\~1.00 | `NUMBER` 类型或可隐式转换为 `NUMBER` 类型的表达式 。 仅介于 -1.00 到 1.00 之间的值有效。 对于超出此范围的值,将返回 `NULL` 且报告域错误。 | - - - -返回类型 ----------------- - -`NUMBER` 数据类型。 - -示例 --------------- - -此示例返回指定数量的 `ACOS` 的值。 - -执行以下语句: - -```javascript -SELECT ACOS(0.3)"acos_test" FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+-----------+ -| acos_test | -+-----------+ -|1.26610367 | -+-----------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/3.BITAND.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/3.BITAND.md deleted file mode 100644 index 17b04d037..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/3.BITAND.md +++ /dev/null @@ -1,60 +0,0 @@ -BITAND -=========================== - - - -运算符按位进行"与"操作。输入和输出类型均为 `NUMBER` 数据类型。 - -语法 --------------- - -```javascript -BITAND (nExpression1, nExpression2) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|----------------------------|------------------------------------------------------------------------------------------| -| nExpression1, nExpression2 | 指定按位进行 `AND` 运算的两个数值。如果 `nExpression1` 和 `nExpression2` 为非整数型,那么它们在按位进行 `AND` 运算之前转换为整数。 | - - - -返回类型 ----------------- - -`NUMBER` 数据类型。 - -示例 --------------- - -a 的二进制为 0100; - -b 的二进制为 0110; - -比较该二进制,若相对应的位置都为 1,则该位的值为 1,否则值为 0。所以 BITAND(2 , 3) = 0100 = 2。 - -执行以下语句: - -```javascript -SELECT BITAND(2,3) FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+-------------+ -| BITAND(2,3) | -+-------------+ -| 2 | -+-------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/4.CEIL.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/4.CEIL.md deleted file mode 100644 index 521c5389d..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/4.CEIL.md +++ /dev/null @@ -1,56 +0,0 @@ -CEIL -========================= - - - -`CEIL` 函数返回值大于等于数值 `numeric_expression` 的最小整数。 - -语法 --------------- - -```javascript -CEIL (numeric_expression) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|--------------------|-----------------------------------------------------------------------| -| numeric_expression | 精确数值或近似数值数据类型(`NUMBER`、`FLOAT`、`BINARY_FLOAT` 和 `BINARY_DOUBLE`)的表达式。 | - - - -返回类型 ----------------- - -返回类型与参数 `numeric_expression` 的数据类型相同。 - -示例 --------------- - -此示例显示了对三个不同数字使用 `CEIL` 函数所得的结果。 - -执行以下语句: - -```javascript -SELECT CEIL(1.2), CEIL(2), CEIL(-12.1) FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+-----------+---------+-------------+ -| CEIL(1.2) | CEIL(2) | CEIL(-12.1) | -+-----------+---------+-------------+ -| 2 | 2 | -12 | -+-----------+---------+-------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/5.EXP.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/5.EXP.md deleted file mode 100644 index ef855ca9a..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/5.EXP.md +++ /dev/null @@ -1,57 +0,0 @@ -EXP -======================== - - - -`EXP` 函数返回 e 的 `numeric_expression` 次幂(e 为数学常量,e = 2.71828183... )。 - -语法 --------------- - -```javascript -EXP (numeric_expression) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|--------------------|-----------------------------------------------------------------------| -| numeric_expression | 精确数值或近似数值数据类型(`NUMBER`、`FLOAT`、`BINARY_FLOAT` 和 `BINARY_DOUBLE`)的表达式。 | - - - -返回类型 ----------------- - -返回类型与参数 `numeric_expression` 的数据类型相同。 - -示例 --------------- - -此示例显示了查询 e 的 4 次幂结果。 - -执行以下语句: - -```javascript -SELECT EXP(4) "e to the 4th power" FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+-------------------------------------------+ -| e to the 4th power | -+-------------------------------------------+ -| 54.59815003314423907811026120286087840279 | -+-------------------------------------------+ -``` - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/6.FLOOR.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/6.FLOOR.md deleted file mode 100644 index f29409547..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/6.FLOOR.md +++ /dev/null @@ -1,56 +0,0 @@ -FLOOR -========================== - - - -`FLOOR` 函数返回小于等于数值 `numeric_expression` 的最大整数。 - -语法 --------------- - -```javascript -FLOOR (numeric_expression) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|--------------------|-----------------------------------------------------------------------| -| numeric_expression | 精确数值或近似数值数据类型(`NUMBER`、`FLOAT`、`BINARY_FLOAT` 和 `BINARY_DOUBLE`)的表达式。 | - - - -返回类型 ----------------- - -返回类型与参数 `numeric_expression` 的数据类型相同。 - -示例 --------------- - -此示例显示了对三个不同数字使用 `FLOOR` 函数所得的结果。 - -执行以下语句: - -```javascript -SELECT FLOOR(1.2), FLOOR(2), FLOOR(-12.1) FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+------------+----------+--------------+ -| FLOOR(1.2) | FLOOR(2) | FLOOR(-12.1) | -+------------+----------+--------------+ -| 1 | 2 | -13 | -+------------+----------+--------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/7.LN.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/7.LN.md deleted file mode 100644 index d1cc9516e..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/7.LN.md +++ /dev/null @@ -1,56 +0,0 @@ -LN -======================= - - - -`LN` 函数返回以 e 为底的 `numeric_expression` 的对数(e 为数学常量 e = 2.71828183...)。 - -语法 --------------- - -```javascript -LN (numeric_expression) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|--------------------|-----------------------------------------------------------------------| -| numeric_expression | 精确数值或近似数值数据类型(`NUMBER`、`FLOAT`、`BINARY_FLOAT` 和 `BINARY_DOUBLE`)的表达式。 | - - - -返回类型 ----------------- - -当参数为 `BINARY_FLOAT` 数据类型时,返回类型为 `BINARY_DOUBLE`,其他情况下返回类型与参数 `numeric_expression` 的数据类型相同。 - -示例 --------------- - -此示例显示了计算以 e 为底的 4 次对数的结果。 - -执行以下语句: - -```javascript -SELECT LN(4) "Natural log of 4" FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+------------------------------------------+ -| Natural log of 4 | -+------------------------------------------+ -| 1.38629436111989061883446424291635313615 | -+------------------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/8.LOG.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/8.LOG.md deleted file mode 100644 index 73d90df67..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/8.LOG.md +++ /dev/null @@ -1,54 +0,0 @@ -LOG -======================== - - - -`LOG` 函数返回以 `x` 为底的 `y` 的对数。 - -语法 --------------- - -```javascript -LOG (x,y) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|-----|-----------------------------------------------------------------------------------------------| -| x,y | 数值型(`NUMBER`、`FLOAT`、`BINARY_FLOAT` 和 `BINARY_DOUBLE`)表达式。 `x` 和 `y` 都必须大于 0。 | - - - -返回类型 ----------------- - -当参数为 `BINARY_FLOAT` 和 `BINARY_DOUBLE` 数据类型时,返回类型为 `BINARY_DOUBLE`,其他情况下返回类型为 `NUMBER`。 - -示例 --------------- - -此示例显示了查询了以 2 为底的 8 的对数。 - -```javascript -SELECT LOG(2,8) FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+----------+ -| LOG(2,8) | -+----------+ -| 3 | -+----------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/9.MOD.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/9.MOD.md deleted file mode 100644 index 1e49784da..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/1.numeric-functions/9.MOD.md +++ /dev/null @@ -1,61 +0,0 @@ -MOD -======================== - - - -`MOD` 函数返回 `x` 除以 `y` 的余数。 -**注意** - - - -与 REMAINDER 函数的区别为,在用 `REMAINDER (x,y)` 和 `MOD (x,y)` 函数在进行运算时,都用了一个公式 result=x-y\*(x/y),区别在于计算 x/y 时的处理方式不同。在 `REMAINDER (x,y)` 函数中,采用 `ROUND(x/y)`,而在 `MOD (x,y)` 函数中采用 `FLOOR(x/y)`。 - -语法 --------------- - -```javascript -MOD (x,y) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|-----|-----------------------------------------------------------------------| -| x,y | `x` 和 `y` 为数值型(`NUMBER`、`FLOAT`、`BINARY_FLOAT` 和 `BINARY_DOUBLE`)表达式。 | - - - -返回类型 ----------------- - -返回类型与数值优先级高的参数的数据类型相同。 - -示例 --------------- - -此示例显示了计算 23/8 以及 24/8 的余数的结果。 - -执行以下语句: - -```javascript -SELECT MOD(23,8), MOD(24,8) FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+-----------+-----------+ -| MOD(23,8) | MOD(24,8) | -+-----------+-----------+ -| 7 | 0 | -+-----------+-----------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/1.CHR.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/1.CHR.md deleted file mode 100644 index cfb8ec1b8..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/1.CHR.md +++ /dev/null @@ -1,98 +0,0 @@ -CHR -======================== - - - -`CHR` 函数将 `n` 转换为等价的一个或多个字符返回,且返回值与当前系统的字符集相关。 - -语法 --------------- - -```javascript -CHR ( n ) -``` - - - -参数 --------------- - - - -| **参数** | **取值范围** | -|--------|---------------| -| n | 0\~4294967295 | - - - -返回类型 ----------------- - -返回值与当前系统的字符集相关。而 OceanBase 支持的字符集是 `UTF-8`、`UTF-16`、`GBK` 和 `GB18030`。 - -示例 --------------- - -十进制(25700)-\> 十六进制(0x6464)-\>`UTF-8` 编码(dd) - -执行以下语句: - -```javascript -SELECT CHR(25700) AS str FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+------+ -| STR | -+------+ -| dd | -+------+ -``` - - - -十进制(50318)-\> 十六进制(0xC48E)-\> `UTF-8` 编码(Ď) - -执行以下语句: - -```javascript -SELECT CHR(50318) AS str FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+------+ -| STR | -+------+ -| Ď | -+------+ -``` - - - -十进制 -\> `UTF-8` 编码 - -```javascript -SELECT CHR(67)||CHR(65)||CHR(84) "Dog" FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+------+ -| Dog | -+------+ -| CAT | -+------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/10.RTRIM.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/10.RTRIM.md deleted file mode 100644 index 1c24cda02..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/10.RTRIM.md +++ /dev/null @@ -1,63 +0,0 @@ -RTRIM -========================== - - - -`RTRIM` 函数删除右边出现的字符串,此函数对于格式化查询的输出非常有用。 - -语法 --------------- - -```javascript -RTRIM(c1 [,c2]) -``` - - - -`RTRIM` 从 `c1` 中出现的所有字符的右端删除 `c2`。如果未指定 `c2`,则默认为单个空格。 - -参数 --------------- - - - -| 参数 | 说明 | -|----|-----------------| -| c1 | 表示字符串 | -| c2 | 表示要删除的字符串,默认为空格 | - - - -`c1`、`c2` 可以是 `CHAR`、`VARCHAR2`、`NCHAR`、`NVARCHAR2` 和 `CLOB` 数据类型。 - -返回类型 ----------------- - -如果 `c1` 是 `CHAR`、`VARCHAR2` 数据类型,则函数返回 `VARCHAR2` 数据类型。 - -如果 `c1` 是 `NCHAR`、`NVARCHAR2` 数据类型,则函数返回 `NVARCHAR2` 数据类型。 - -如果 `c1` 是 `LOB` 数据类型,则返回的字符串为 `LOB` 数据类型。 - -示例 --------------- - -执行以下语句: - -```javascript -SELECT RTRIM('gao qian jingXXXX','X') text FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+------------------+ -| TEXT | -+------------------+ -| gao qian jing | -+------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/11.SUBSTR.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/11.SUBSTR.md deleted file mode 100644 index b09856dd0..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/11.SUBSTR.md +++ /dev/null @@ -1,56 +0,0 @@ -SUBSTR -=========================== - - - -`SUBSTR` 函数截取子字符串。其中多字节符(汉字、全角符等)按 1 个字符计算。 - -语法 --------------- - -```javascript -SUBSTR(c1,n1[,n2]) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|----|------------------------------------------------------------------| -| c1 | 需要截取的字符串。字符串类型可为:`CHAR`、`VARCHAR2`、`NCHAR`、`NVARCHAR2` 或 `CLOB`。 | -| n1 | 截取字符串的开始位置,当 n1 等于 0 或 1 时,都是从第一位开始截取。 | -| n2 | 要截取的字符串的长度,若不指定 `n2`,则从第 `n1` 个字符直到结束的字串。 | - - - -返回类型 ----------------- - -返回与 `c1` 类型相同的数据。如果 `n2` 为 0,则将其视为 1。如果 `n2` 为正,则 OceanBase 从开始算起,从 `c1` 开始查找第一个字符。如果 `n2` 为负,则 OceanBase 从 `c1` 的末尾开始倒数 `c1`。如果 `n3` 省略,则 OceanBase 将 `c1` 的所有字符返回。如果 `n3` 小于 1,则 OceanBase 返回 `NULL`。 - -示例 --------------- - -执行以下语句: - -```javascript -SELECT SUBSTR('13088888888',3,8) test FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+----------+ -| TEST | -+----------+ -| 08888888 | -+----------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/12.TRANSLATE.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/12.TRANSLATE.md deleted file mode 100644 index 71e1f6ae8..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/12.TRANSLATE.md +++ /dev/null @@ -1,82 +0,0 @@ -TRANSLATE -============================== - - - -`TRANSLATE` 函数将字符表达式值中,指定字符替换为新字符。多字节符(汉字、全角符等),按 1 个字符计算。 - -语法 --------------- - -```javascript -TRANSLATE(c1,c2,c3) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|----|-----------------------------------------| -| c1 | 希望被替换的字符或变量。 | -| c2 | 查询原始的字符集。 | -| c3 | 替换新的字符集,将 `c2` 对应顺序字符,替换为 `c3` 对应顺序字符 。 | - - -**说明** - - - -* `c1`、`c2` 和 `c3` 的数据类型可以是 `CHAR`、`VARCHAR2`、`NCHAR`、`NVARCHAR2` 或 `CLOB`。 - - - -* 如果 `c3` 长度大于 `c2`,则 `c3` 长出后面的字符无效; - - - -* 如果 `c3` 长度小于 `c2`,则 `c2` 长出后面的字符均替换为空(删除); - - - -* 如果 `c3` 长度为 0,则返回空字符串; - - - -* 如果 `c2` 里字符重复,按首次位置为替换依据。 - - - - - - -返回类型 ----------------- - -返回 `CHAR`、`VARCHAR2`、`NCHAR`、`NVARCHAR2` 或 `CLOB` 类型字符。 - -示例 --------------- - -执行以下语句: - -```javascript -SELECT TRANSLATE('he miss you','he','i') FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+---------------------------------+ -| TRANSLATE('HEMISSYOU','HE','I') | -+---------------------------------+ -| i miss you | -+---------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/13.TRIM.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/13.TRIM.md deleted file mode 100644 index bae7f5f83..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/13.TRIM.md +++ /dev/null @@ -1,66 +0,0 @@ -TRIM -========================= - - - -`TRIM` 函数用来删除一个字符串的开头或结尾(或两者)的字符。 - -语法 --------------- - -```javascript -TRIM([ { { LEADING | TRAILING | BOTH } [ trim_character ] | trim_character } FROM ] trim_source) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|----------------|----------| -| LEADING | 开头字符。 | -| TRAILING | 结尾字符。 | -| BOTH | 开头和结尾字符。 | -| trim_character | 删除的字符。 | -| trim_source | 修剪源。 | - - - -`trim_char` 和 `trim_source` 都可以是 `VARCHAR2` 或任何可以隐式转换为 `VARCHAR2` 的数据类型。如果指定 `LEADING`,则 OceanBase 将删除所有与前导字符相等的 `trim_character`。如果指定 `TRAILING`,则 OceanBase 将删除所有与结尾字符相等的 `trim_character`。如果您指定 `BOTH` 或三个都不指定,则 OceanBase 删除与前导和结尾字符相等的 `trim_character`。如果未指定 `trim_character`,则默认值为空白。如果仅指定 `trim_source`,则 OceanBase 删除前导和尾随空格。如果函数返回的值数据类型为 `VARCHAR2`,则该值的最大长度为 `trim_source`。 - -返回类型 ----------------- - -如果 `trim_source` 为 `CHAR`、`VARCHAR2` 数据类型,则函数返回 `VARCHAR2` 数据类型。 - -如果 `trim_source` 为 `NCHAR`、`NVARCHAR2` 数据类型,则函数返回 `NVARCHAR2` 数据类型。 - -如果 `trim_source` 为 `CLOB` 数据类型,则函数返回 `CLOB` 数据类型。 - -如果 `trim_source` 或 `trim_character` 为 `NULL`,则 `TRIM` 函数返回 `NULL`。 - -示例 --------------- - -执行以下语句: - -```javascript -SELECT TRIM('X' from 'XXXgao qian jingXXXX'),TRIM('X' from 'XXXgaoXXjingXXXX') text FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+-----------------------------------+-----------+ -| TRIM('X'FROM'XXXGAOQIANJINGXXXX') | TEXT | -+-----------------------------------+-----------+ -| gao qian jing | gaoXXjing | -+-----------------------------------+-----------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/14.UPPER.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/14.UPPER.md deleted file mode 100644 index 349a51520..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/14.UPPER.md +++ /dev/null @@ -1,54 +0,0 @@ -UPPER -========================== - - - -`UPPER` 函数将字符串全部转为大写。 - -语法 --------------- - -```javascript -UPPER(c1) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|----|-------------------------------------------------------------| -| c1 | 字符串。字符串类型可为:`CHAR`、`VARCHAR2`、`NCHAR`、`NVARCHAR2` 或 `CLOB`。 | - - - -返回类型 ----------------- - -返回 `CHAR`、`VARCHAR2`、`NCHAR`、`NVARCHAR2` 或 `CLOB` 类型的字符。 - -示例 --------------- - -执行以下语句: - -```javascript -SELECT UPPER('AaBbCcDd') upper FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+----------+ -| UPPER | -+----------+ -| AABBCCDD | -+----------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/2.CONCAT.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/2.CONCAT.md deleted file mode 100644 index ec575c868..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/2.CONCAT.md +++ /dev/null @@ -1,57 +0,0 @@ -CONCAT -=========================== - - - -`CONCAT` 函数可以连接两个字符串。 - -语法 --------------- - -```javascript -CONCAT(c1,c2) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|----|-------------------------------------------------------------| -| c1 | 字符串,字符串类型可为:`CHAR`、`VARCHAR2`、`NCHAR`、`NVARCHAR2` 或 `CLOB`。 | -| c1 | 字符串,字符串类型可为:`CHAR`、`VARCHAR2`、`NCHAR`、`NVARCHAR2` 或 `CLOB`。 | - - - -返回类型 ----------------- - -返回与 `c1` 相同的数据类型。 - -示例 --------------- - -本示例 `CONCAT` 函数用来连接字符 `'010-'` 和字符 `'88888888'`。 - -执行以下语句 - -```javascript -SELECT concat('010-','88888888')||'转23'XXXX的电话 FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+-------------------+ -| XXXX的电话 | -+-------------------+ -| 010-88888888转23 | -+-------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/3.INITCAP.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/3.INITCAP.md deleted file mode 100644 index 5086f5a8c..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/3.INITCAP.md +++ /dev/null @@ -1,54 +0,0 @@ -INITCAP -============================ - - - -`INITCAP` 函数返回字符串并将字符串中每个单词的首字母大写,其他字母小写。 - -语法 --------------- - -```javascript -INITCAP(c1) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|----|------------------------------------------------------| -| c1 | 字符串。字符串类型可为:`CHAR`、`VARCHAR2`、`NCHAR` 或 `NVARCHAR2`。 | - - - -返回类型 ----------------- - -返回 `CHAR` 类型数据。 - -示例 --------------- - -执行以下语句: - -```javascript -SELECT initcap('smith abc aBC') upp FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+------------------+ -| UPP | -+------------------+ -| Smith Abc Abc | -+------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/4.LOWER.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/4.LOWER.md deleted file mode 100644 index 263f91cf2..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/4.LOWER.md +++ /dev/null @@ -1,54 +0,0 @@ -LOWER -========================== - - - -`LOWER` 函数将字符串全部转为小写。 - -语法 --------------- - -```javascript -LOWER(c1) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|----|---------------------------------------------------------------| -| c1 | 表示字符串。字符串类型可为:`CHAR`、`VARCHAR2`、`NCHAR`、`NVARCHAR2` 或 `CLOB`。 | - - - -返回类型 ----------------- - -返回与 `c1` 相同的数据类型 。 - -示例 --------------- - -执行以下语句: - -```javascript -SELECT lower('AaBbCcDd')AaBbCcDd FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+----------+ -| AABBCCDD | -+----------+ -| aabbccdd | -+----------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/5.LPAD.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/5.LPAD.md deleted file mode 100644 index 9a852d3bf..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/5.LPAD.md +++ /dev/null @@ -1,61 +0,0 @@ -LPAD -========================= - - - -`LPAD` 函数的功能是在字符串 `c1` 的左边用字符串 `c2` 填充,直到长度为 `n` 时为止。 - -语法 --------------- - -```javascript -LPAD(c1,n[,c2]) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|----|-------------------------------------------------------------------------| -| c1 | 表示字符串。字符串类型可为:`CHAR`、`VARCHAR2`、`NCHAR`、`NVARCHAR2` 或 `CLOB` 。 | -| n | 追加后字符总长度,必须是 `NUMBER` 整数类型或可以隐式转换为 `NUMBER` 整数类型的类型。 | -| c2 | 表示追加的字符串,默认为空格。字符串类型可为:`CHAR`、`VARCHAR2`、`NCHAR`、`NVARCHAR2` 或 `CLOB` 。 | - - - -返回类型 ----------------- - -如果 `c1` 是字符型数据,则返回 `VARCHAR2` 类型;如果 `c1` 是国家字符数据类型,则返回 `NVARCHAR2` 类型;如果 `c1` 是 `LOB` 数据类型,,则返回 `LOB` 类型。 -**注意** - - - -如果 `c1` 长度大于 `n`,则返回 `c1` 左边 `n` 个字符。如果 `c1` 长度小于 `n`,`c2` 和 `c1` 连接后大于 `n`,则返回连接后的右边 `n` 个字符。 - -示例 --------------- - -执行以下语句: - -```javascript -SELECT lpad('gao',10,'*') FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+--------------------+ -| LPAD('GAO',10,'*') | -+--------------------+ -| *******gao | -+--------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/6.LTRIM.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/6.LTRIM.md deleted file mode 100644 index 35d128b8d..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/6.LTRIM.md +++ /dev/null @@ -1,57 +0,0 @@ -LTRIM -========================== - - - -`LTRIM` 函数功能是删除左边出现的字符串。 - -语法 --------------- - -```javascript -LTRIM(c1 [,c2]) -``` - - - -`LTRIM` 函数从左端删除 `c1` 中包含的所有字符 `c2`。如果未指定 `c2`,则默认为单个空格。 - -参数 --------------- - - - -| 参数 | 说明 | -|----|---------------------------------------------------------------------------| -| c1 | 表示字符串。字符串类型可为: `CHAR`、`VARCHAR2`、`NCHAR`、`NVARCHAR2` 或 `CLOB` 。 | -| c2 | 表示要删除的字符串,默认为空格。字符串类型可为: `CHAR`、`VARCHAR2`、`NCHAR`、`NVARCHAR2` 或 `CLOB` 。 | - - - -返回类型 ----------------- - -如果 `c1` 是 `CHAR`、`VARCHAR2` 数据类型,则函数返回 `VARCHAR2` 数据类型。如果 `c1` 是 `NCHAR`、`NVARCHAR2` 数据类型,则函数返回 `NVARCHAR2` 数据类型。如果 `c1` 是 `LOB` 数据类型,则返回的字符串为 `LOB` 数据类型。 - -示例 --------------- - -执行以下语句: - -```javascript -SELECT LTRIM(' gao qian jing',' ') text FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+------------------+ -| TEXT | -+------------------+ -| gao qian jing | -+------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/7.REGEXP_REPLACE.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/7.REGEXP_REPLACE.md deleted file mode 100644 index 0b57191de..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/7.REGEXP_REPLACE.md +++ /dev/null @@ -1,58 +0,0 @@ -REGEXP_REPLACE -=================================== - - - -`REGEXP_REPLACE` 函数用于正则表达式替换。 - -语法 --------------- - -```javascript -REGEXP_REPLACE (source_char, pattern [,replace_string [, position [, occurrence [, match_param ] ] ] ]) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------| -| source_char | 用作搜索值的字符表达式。它通常是一种字符列,数据类型可以是 `CHAR`、`VARCHAR2`、`NCHAR`、`NVARCHAR2` 或 `CLOB` 。 | -| pattern | 是正则表达式 ,它通常是一个文本文字,数据类型可以是 `CHAR`、`VARCHAR2`、`NCHAR` 或 `NVARCHAR2`。 | -| replace_string | 表示替换的字符,可以是 `CHAR`、`VARCHAR2`、`NCHAR`、`NVARCHAR2` 或 `CLOB` 类型。 | -| position | 是一个正整数类型,指示 OceanBase 从第几个字符开始搜索 `source_char` 的字符,默认为 1,表示从第一个字符开始搜索`source_char`。 | -| occurrence | 是一个非负整数,指示替换操作的发生,如果指定 0,则 OceanBase 替换所有匹配项;如果指定正整数 n,则 OceanBase 将替换第 n 次出现,默认为全部都替换掉,如果指定参数 0 也是全部匹配。 | -| match_param | 是数据类型 `VARCHAR2` 或 `CHAR` 的字符表达式,它允许您更改函数的默认匹配行为。 `i` 表示大小写不敏感;`c` 表示大小写敏感;`n` 表示点号;`.` 表示不匹配换行符号;`m` 表示多行模式;`x` 表示忽略空格字符,默认情况下,空格字符会相互匹配。 | - - - -返回类型 ----------------- - -返回结果与 `source_char` 的数据类型相同。 - -示例 --------------- - -下面的示例检查字符串,查找两个或多个空格。OceanBase 用一个空间替换两个或多个空间的每一次出现。执行以下语句: - -```javascript -SELECT REGEXP_REPLACE('500 OceanBase Parkway, Redwood Shores, CA', '( ){2,}', ' ') "REGEXP_REPLACE" -FROM DUAL; -``` - - - -查询结果如下: - -```javascript -REGEXP_REPLACE --------------------------------------- -500 OceanBase Parkway, Redwood Shores, CA -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/8.REPLACE-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/8.REPLACE-1.md deleted file mode 100644 index 0036d7e81..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/8.REPLACE-1.md +++ /dev/null @@ -1,58 +0,0 @@ -REPLACE -============================ - - - -`REPLAC` 函数将字符表达式值中,部分相同字符串,替换成新的字符串。 - -语法 --------------- - -```javascript -REPLACE(c1,c2[,c3]) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|----|------------------------| -| c1 | 等待替换的字符串 `CHAR` | -| c2 | 搜索需要替换的字符串 | -| c3 | 替换字符串,默认为空(即删除之意,不是空格) | - - - -`c1`、`c2` 和 `c3` 的数据类型可以是 `CHAR` 、`VARCHAR2`、`NCHAR`、`NVARCHAR2` 和 `CLOB`。 - -返回类型 ----------------- - -返回的字符串与 `c1` 的字符集相同。如果 `c3` 缺省或者为 `NULL`,那么所有 c1 中出现的 c2 都将被移除。如果 `c2` 为 `NULL`,那么结果就是 `c1` 。如果 `c1` 是 `LOB` 数据类型,则函数返回 `CLOB` 数据类型。如果 `c1` 不是 `LOB` 数据类型,则函数返回 `VARCHA2` 数据类型。 - -示例 --------------- - -执行以下语句: - -```javascript -SELECT replace('he love you','he','i') test FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+------------+ -| TEST | -+------------+ -| i love you | -+------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/9.RPAD.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/9.RPAD.md deleted file mode 100644 index 09b7d618b..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/2.string-functions-that-return-a-string/9.RPAD.md +++ /dev/null @@ -1,74 +0,0 @@ -RPAD -========================= - - - -`RPAD` 函数在字符串 `c1` 的右边用字符串 `c2` 填充,直到长度为 `n` 时为止。 - -语法 --------------- - -```javascript -RPAD(c1,n[,c2]) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|----|------------------------------------------------------------------------| -| c1 | 表示字符串。字符串类型可为:`CHAR`、`VARCHAR2`、`NCHAR`、`NVARCHAR2` 或 `CLOB`。 | -| n | 追加后字符总长度,必须是 `NUMBER` 整数类型或可以隐式转换为 `NUMBER` 整数类型的类型。 | -| c2 | 表示追加的字符串,默认为空格。字符串类型可为:`CHAR`、`VARCHAR2`、`NCHAR`、`NVARCHAR2` 或 `CLOB`。 | - - - -返回类型 ----------------- - -如果 `c1` 是字符型数据,则返回 `VARCHAR2` 类型;如果 `c1` 是国家字符数据类型,则返回 `NVARCHAR2` 类型;如果 `c1` 是 `LOB` 数据类型,,则返回 `LOB` 类型。 -**说明** - - - -* 如果 `c1` 长度大于 `n`,则返回 `c1` 左边 `n` 个字符; - - - -* 如果 `c1` 长度小于 `n`,`c1` 和 `c2` 连接后大于 `n`,则返回连接后的左边 `n` 个字符; - - - -* 如果 `c1` 长度小于n,`c1` 和 `c2` 连接后小于 `n`,则返回 `c1` 与多个重复 `c2` 连接(总长度\>= `n`)后的左边 `n` 个字符。 - - - - - - -示例 --------------- - -执行以下语句: - -```javascript -SELECT rpad('gao',10,'*a') FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+---------------------+ -| RPAD('GAO',10,'*A') | -+---------------------+ -| gao*a*a*a* | -+---------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/3.string-functions-that-return-numbers/1.ASCII.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/3.string-functions-that-return-numbers/1.ASCII.md deleted file mode 100644 index e2855b8f9..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/3.string-functions-that-return-numbers/1.ASCII.md +++ /dev/null @@ -1,76 +0,0 @@ -ASCII -========================== - - - -`ASCII` 函数返回字符表达式最左端字符的 ASCII 码值。 - -语法 --------------- - -```javascript -ASCII(x) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|----|---------------------------------------------------| -| x | `CHAR`、`VARCHAR2`、`NCHAR` 或 `NVARCHAR2` 数据类型的表达式。 | - - - - - -返回类型 ----------------- - -`NUMBER` 数据类型。 - -示例 --------------- - -此示例使用 `ASCII` 函数返回 **A** 、 **a** 、 **中** 和空格的 ASCII 码值。 - -```unknow -SELECT ASCII('A') A, ASCII('a') a, ASCII(' ') space FROM DUAL; -``` - - - -此示例使用 `ASCII` 函数返回 **A** 、 **a** 和空格的 ASCII 码值。 - -```javascript -SELECT ASCII('A') A, ASCII('a') a, ASCII(' ') space,ASCII('中') hz FROM DUAL; -``` - - - -结果返回: - -```unknow -+----+----+-------+----------+ -| A | A | SPACE | -+----+----+-------+----------+ -| 65 | 97 | 32 | -+----+----+-------+----------+ -1 row in set (0.00 sec) -``` - - - -```javascript -+----+----+-------+----------+ -| A | A | SPACE | HZ | -+----+----+-------+----------+ -| 65 | 97 | 32 | 14989485 | -+----+----+-------+----------+ -1 row in set (0.00 sec) -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/3.string-functions-that-return-numbers/2.INSTR.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/3.string-functions-that-return-numbers/2.INSTR.md deleted file mode 100644 index 2fbe5a45c..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/3.string-functions-that-return-numbers/2.INSTR.md +++ /dev/null @@ -1,82 +0,0 @@ -INSTR -========================== - - - -`INSTR` 函数在一个字符串中搜索指定的字符,返回发现指定的字符的位置。 -**注意** - - - -多字节符(汉字、全角符等),按 1 个字符计算。 - -语法 --------------- - -```javascript -INSTR(c1,c2[,i[,j]]) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|----|------------------------------------------------------------------| -| c1 | 被搜索的字符串。字符串类型可为:`CHAR`、`VARCHAR2`、`NCHAR`、`NVARCHAR2` 或 `CLOB`。 | -| c2 | 希望搜索的字符串。字符串类型可为:`CHAR`、`VARCHAR2`、`NCHAR`、`NVARCHAR2` 或 `CLOB`。 | -| i | 搜索的开始位置,默认值为 1。当值小于 0 时,搜索从反方向开始,但是仍返回被搜索到的字符的正序位置。 | -| j | 第 `j` 次出现的位置,默认值为 1。 | - - - -返回类型 ----------------- - -`NUMBER` 数据类型。 - -示例 --------------- - -此示例展示了字符 **某** 在字符串 **重庆某软** **件公司** 中第一次出现的位置。 - -```javascript -SELECT INSTR ('重庆某软件公司','某',1,1) instring FROM DUAL; -``` - - - -返回结果: - -```javascript -+----------+ -| instring | -+----------+ -| 3 | -+----------+ -``` - - - -此示例中, **instring1** 应返回正向搜索 **ce** 时在字符串中第二次出现的位置, **instring2** 应返回反向搜索 **ce** 时在字符串中第二次出现的位置: - -```javascript -SELECT INSTR('oceanbase pratice','ce',1,2) instring1,INSTR('oceanbase pratice','ce',-1,2) instring2 FROM DUAL; -``` - - - -返回结果,正向搜索时 **ce** 第二次出现在第 16 位,反向搜索时 **ce** 第二次出现在第二位: - -```javascript -+----------+------------+ -| instring1 | instring2 | -+----------+------------+ -| 16 | 2 | -+----------+------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/3.string-functions-that-return-numbers/3.LENGTH.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/3.string-functions-that-return-numbers/3.LENGTH.md deleted file mode 100644 index b42404ed0..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/3.string-functions-that-return-numbers/3.LENGTH.md +++ /dev/null @@ -1,59 +0,0 @@ -LENGTH -=========================== - - - -`LENGTH` 函数返回字符串的长度。 -**注意** - - - -多字节符(汉字、全角符等),按 1 个字符计算。 - -语法 --------------- - -```javascript -LENGTH(c1) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|----|----------------------------------------------------------| -| c1 | `CHAR`、`VARCHAR2`、`NCHAR`、`NVARCHAR2` 或 `CLOB` 数据类型的字符串。 | - - - -返回类型 ----------------- - -`NUMBER` 数据类型。 - -示例 --------------- - -此示例展示了字符串 **测试** 、 **北京市海淀区** 和 **北京TO_CHAR** 的长度。 - -```javascript -SELECT LENGTH ('测试'), LENGTH('北京市海锭区'), LENGTH('北京TO_CHAR') FROM DUAL; -``` - - - -返回结果: - -```javascript -+------------------+------------------------------+-------------------------+ -| LENGTH('测试')| LENGTH('北京市海锭区') | LENGTH('北京TO_CHAR') | -+------------------+------------------------------+-------------------------+ -| 2 | 6 | 9 | -+------------------+------------------------------+-------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/1.ADD_MONTHS.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/1.ADD_MONTHS.md deleted file mode 100644 index 78dfb14fc..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/1.ADD_MONTHS.md +++ /dev/null @@ -1,84 +0,0 @@ -ADD_MONTHS -=============================== - - - -`ADD_MONTHS` 函数返回在日期 `date` 基础上 `n` 个月后的日期值,如果 `n` 的值为负数则返回日期 `date` 基础上 `n` 个月前的日期值(`date` 减去 `n` 个月)。 -**注意** - - - -由于每个月的天数不同,当 `date` 是一个月中的最后一天时,函数返回计算后该月的最后一天。例如,用`ADD_MONTHS` 计算 2020 年 3 月 31 日一个月前的日期,返回 2020 年 2 月 29 日。 - -语法 --------------- - -```javascript -ADD_MONTHS (date,n) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|------|----------------| -| date | `DATE` 数据类型。 | -| n | `NUMBER` 数据类型。 | - - - -返回类型 ----------------- - -`DATE` 数据类型。 - -示例 --------------- - -**示例 1** : 以下示例查询了 3 个月后的日期。 - -执行以下语句: - -```javascript -SELECT SYSDATE, ADD_MONTHS(SYSDATE,3) FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+---------------------+-----------------------+ -| SYSDATE | ADD_MONTHS(SYSDATE,3) | -+---------------------+-----------------------+ -| 2020-03-26 12:21:40 | 2020-06-26 12:21:40 | -+---------------------+-----------------------+ -``` - - - -**示例 2** : 以下示例查询了 3 个月前的日期。 - -执行以下语句: - -```javascript -SELECT SYSDATE, ADD_MONTHS(SYSDATE,-3) FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+---------------------+------------------------+ -| SYSDATE | ADD_MONTHS(SYSDATE,-3) | -+---------------------+------------------------+ -| 2020-03-26 12:21:04 | 2019-12-26 12:21:04 | -+---------------------+------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/10.NEXT_DAY.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/10.NEXT_DAY.md deleted file mode 100644 index ad9f639ff..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/10.NEXT_DAY.md +++ /dev/null @@ -1,63 +0,0 @@ -NEXT_DAY -============================= - - - -`NEXT_DAY` 函数是返回日期 `d1` 的下一周中 `c1`(星期值)所在的日期值。 - -语法 --------------- - -```javascript -NEXT_DAY (d1[,c1]) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|----|-------------------------------------------------------------------------------| -| d1 | `DATE` 数据类型的值。 | -| c1 | 星期值:`MONDAY`、`TUESDAY`、`WEDNESDAY`、`THURSDAY`、`FRIDAY`、`SATURDAY` 和 `SUNDAY`。 | - - - -返回类型 ----------------- - -`DATE` 数据类型。 - -示例 --------------- - -以下示例展示了下周每个星期值对应的日期值: - -```javascript -SELECT SYSDATE 当时日期, -NEXT_DAY(SYSDATE,'MONDAY') 下周星期一, -NEXT_DAY(SYSDATE,'TUESDAY') 下周星期二, -NEXT_DAY(SYSDATE,'WEDNESDAY') 下周星期三, -NEXT_DAY(SYSDATE,'THURSDAY') 下周星期四, -NEXT_DAY(SYSDATE,'FRIDAY') 下周星期五, -NEXT_DAY(SYSDATE,'SATURDAY') 下周星期六, -NEXT_DAY(SYSDATE,'SUNDAY') 下周星期日 -FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+---------------------+---------------------+---------------------+---------------------+---------------------+---------------------+---------------------+---------------------+ -| 当时日期 | 下周星期一 | 下周星期二 | 下周星期三 | 下周星期四 | 下周星期五 | 下周星期六 | 下周星期日 | -+---------------------+---------------------+---------------------+---------------------+---------------------+---------------------+---------------------+---------------------+ -| 2020-03-08 15:47:57 | 2020-03-09 15:47:57 | 2020-03-10 15:47:57 | 2020-03-11 15:47:57 | 2020-03-12 15:47:57 | 2020-03-13 15:47:57 | 2020-03-14 15:47:57 | 2020-03-15 15:47:57 | -+---------------------+---------------------+---------------------+---------------------+---------------------+---------------------+---------------------+---------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/11.NUMTODSINTERVAL.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/11.NUMTODSINTERVAL.md deleted file mode 100644 index 49d08406d..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/11.NUMTODSINTERVAL.md +++ /dev/null @@ -1,55 +0,0 @@ -NUMTODSINTERVAL -==================================== - - - -`NUMTODSINTERVAL` 函数是把参数 `n` 转为以参数 `interval_unit` 为单位的 `INTERVAL DAY TO SECOND` 数据类型的值。 - -语法 --------------- - -```javascript -NUMTODSINTERVAL (n,interval_unit) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|---------------|-------------------------------------| -| n | `NUMBER` 数据类型的值。 | -| interval_unit | 单位值:`DAY`、`HOUR`、`MINUTE`、`MINUTE`。 | - - - -返回类型 ----------------- - -`INTERVAL DAY TO SECOND` 数据类型。 - -示例 --------------- - -以下示例展示了当前日期 3 小时后的日期时间值: - -```javascript -SELECT SYSDATE,SYSDATE+NUMTODSINTERVAL(3,'HOUR') AS RES FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+---------------------+---------------------+ -| SYSDATE | RES | -+---------------------+---------------------+ -| 2020-03-08 16:01:40 | 2020-03-08 19:01:40 | -+---------------------+---------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/12.NUMTOYMINTERVAL.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/12.NUMTOYMINTERVAL.md deleted file mode 100644 index 9f1914b05..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/12.NUMTOYMINTERVAL.md +++ /dev/null @@ -1,55 +0,0 @@ -NUMTOYMINTERVAL -==================================== - - - -`NUMTOYMINTERVAL` 函数是把参数 `n` 转为以 `interval_unit` 为单位的 `INTERVAL YEAR TO MONTH` 数据类型的值。 - -语法 --------------- - -```javascript -NUMTOYMINTERVAL (n,interval_unit) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|---------------|---------------------| -| n | `NUMBER` 数据类型的值。 | -| interval_unit | 单位值:`YEAR`、`MONTH`。 | - - - -返回类型 ----------------- - -`INTERVAL YEAR TO MONTH` 数据类型。 - -示例 --------------- - -以下示例展示了当前日期 3 年后的日期时间值: - -```javascript -SELECT SYSDATE,SYSDATE+NUMTOYMINTERVAL(3,'YEAR') AS RES FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+---------------------+---------------------+ -| SYSDATE | RES | -+---------------------+---------------------+ -| 2020-03-08 16:03:58 | 2023-03-08 16:03:58 | -+---------------------+---------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/13.round-date.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/13.round-date.md deleted file mode 100644 index c99492a16..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/13.round-date.md +++ /dev/null @@ -1,73 +0,0 @@ -ROUND (date) -================================= - - - -`ROUND(date)` 函数返回以参数 `fmt` 为单位距离的离指定日期 `date` 最近的日期时间值。 - -语法 --------------- - -```javascript -ROUND (date,[fmt]) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|------|-----------------------------------------------------------------------------------------------| -| date | 所有包含日期的数据类型的值:`DATE`、`TIMESTAMP`、`TIMESTAMP WITH TIME ZONE`、`TIMESTAMP WITH LOCAL TIME ZONE`。 | -| fmt | 指定了函数返回值与 `date` 的距离单位,以下表格列举了该参数的可取值,大小写不敏感。 | - - - - -| **fmt参数表** | **说明** | -|--------------------------|---------------------------------| -| j | 默认值,最近0点日期。 | -| day、dy、d | 返回离指定日期最近的星期日。 | -| month、mon、mm、rm | 返回离指定日期最近的月的第一天日期。 | -| q | 返回离指定日期最近的季的日期。 | -| syear、year、yyyy、yyy、yy、y | 多个 y 表示不同的精度,返回离指定日期最近的年的第一个日期。 | -| cc、scc | 返回离指定日期最近的世纪的初日期。 | - - - -返回类型 ----------------- - -`DATE` 数据类型。 - -示例 --------------- - -执行以下语句: - -```javascript -SELECT SYSDATE 当时日期, -ROUND(SYSDATE) 最近0点日期, -ROUND(SYSDATE,'DAY') 最近星期日, -ROUND(SYSDATE,'MONTH') 最近月初, -ROUND(SYSDATE,'Q') 最近季初日期, -ROUND(SYSDATE,'YEAR') 最近年初日期 -FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+---------------------+---------------------+---------------------+---------------------+---------------------+---------------------+ -| 当时日期 | 最近0点日期 | 最近星期日 | 最近月初 | 最近季初日期 | 最近年初日期 | -+---------------------+---------------------+---------------------+---------------------+---------------------+---------------------+ -| 2020-03-08 20:24:53 | 2020-03-09 00:00:00 | 2020-03-08 00:00:00 | 2020-03-01 00:00:00 | 2020-04-01 00:00:00 | 2020-01-01 00:00:00 | -+---------------------+---------------------+---------------------+---------------------+---------------------+---------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/14.SESSIONTIMEZONE.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/14.SESSIONTIMEZONE.md deleted file mode 100644 index 7a27d5840..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/14.SESSIONTIMEZONE.md +++ /dev/null @@ -1,76 +0,0 @@ -SESSIONTIMEZONE -==================================== - - - -`SESSIONTIMEZONE` 函数是返回当前会话时区。 - -语法 --------------- - -```javascript -SESSIONTIMEZONE -``` - - - -参数 --------------- - -无参数。 - -返回类型 ----------------- - -`VARCHAR2` 数据类型。 - -示例 --------------- - -以下示例展示了数据库时区和当前会话时区: - -```javascript -SELECT DBTIMEZONE,SESSIONTIMEZONE FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+------------+-----------------+ -| DBTIMEZONE | SESSIONTIMEZONE | -+------------+-----------------+ -| +00:00 | +08:00 | -+------------+-----------------+ -``` - - - -可以通过 `ALTER SESSION` 语句修改当前会话时区,数据库时区不可修改: - -```javascript -ALTER SESSION SET TIME_ZONE = '+05:00'; -``` - - - -执行以下语句查询修改后的当前会话时区: - -```javascript -SELECT DBTIMEZONE,SESSIONTIMEZONE FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+------------+-----------------+ -| DBTIMEZONE | SESSIONTIMEZONE | -+------------+-----------------+ -| +00:00 | +05:00 | -+------------+-----------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/15.SYS_EXTRACT_UTC.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/15.SYS_EXTRACT_UTC.md deleted file mode 100644 index 1b899f3e2..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/15.SYS_EXTRACT_UTC.md +++ /dev/null @@ -1,60 +0,0 @@ -SYS_EXTRACT_UTC -==================================== - - - -`SYS_EXTRACT_UTC` 函数是返回与指定时间相对应的标准 UTC 时间。 - -语法 --------------- - -```javascript -SYS_EXTRACT_UTC (datetime_with_timezone) -``` - - -**注意** - - - -UTC(Universal Time Coordinated)是通用协调时间。UTC 与格林尼治平均时(GMT, Greenwich Mean Time)一样,都与英国伦敦的本地时相同。 - -参数 --------------- - - - -| 参数 | 说明 | -|------------------------|-----------------------------------------------------------------------| -| datetime_with_timezone | `TIMESTAMP WITH TIME ZONE` 和 `TIMESTAMP WITH LOCAL TIME ZONE` 数据类型的值。 | - - - -返回类型 ----------------- - -`TIMESTAMP` 数据类型。 - -示例 --------------- - -执行以下语句: - -```javascript -SELECT SYS_EXTRACT_UTC(TIMESTAMP '2020-03-28 11:30:00.00 -08:00') -FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+---------------------------------------------------------+ -| SYS_EXTRACT_UTC(TIMESTAMP'2020-03-2811:30:00.00-08:00') | -+---------------------------------------------------------+ -| 2020-03-28 19:30:00.000000000 | -+---------------------------------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/16.SYSDATE.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/16.SYSDATE.md deleted file mode 100644 index f95c1d65b..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/16.SYSDATE.md +++ /dev/null @@ -1,55 +0,0 @@ -SYSDATE -============================ - - - -`SYSDATE` 函数返回当前日期。 -**注意** - - - -该函数不依赖于当前会话时区,而是依赖于数据库宿主机的 Linux 操作系统的时区。 - -语法 --------------- - -```javascript -SYSDATE -``` - - - -参数 --------------- - -无参数。 - -返回类型 ----------------- - -`DATE` 数据类型。 - -示例 --------------- - -以下示例将当前时间按指定格式输出: - -```javascript -SELECT TO_CHAR -(SYSDATE, 'MM-DD-YYYY HH24:MI:SS') "NOW" -FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+---------------------+ -| NOW | -+---------------------+ -| 03-08-2020 20:44:04 | -+---------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/17.SYSTIMESTAMP.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/17.SYSTIMESTAMP.md deleted file mode 100644 index cc44f57a5..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/17.SYSTIMESTAMP.md +++ /dev/null @@ -1,53 +0,0 @@ -SYSTIMESTAMP -================================= - - - -`SYSTIMESTAMP` 函数返回系统当前日期,返回值的秒的小数位包含 6 位精度,且包含当前时区信息。 -**注意** - - - -该函数不依赖于当前会话时区,而是依赖于数据库宿主机的 Linux 操作系统的时区。 - -语法 --------------- - -```javascript -SYSTIMESTAMP -``` - - - -参数 --------------- - -无参数。 - -返回类型 ----------------- - -`TIMESTAMP WITH TIME ZONE` 数据类型。 - -示例 --------------- - -执行以下语句: - -```javascript -SELECT SYSTIMESTAMP FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+------------------------------------+ -| SYSTIMESTAMP | -+------------------------------------+ -| 2020-03-08 20:47:08.254086 +08:00 | -+------------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/18.to_char-datetime.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/18.to_char-datetime.md deleted file mode 100644 index b197187c5..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/18.to_char-datetime.md +++ /dev/null @@ -1,87 +0,0 @@ -TO_CHAR (datetime) -======================================= - - - -`TO_CHAR` 函数将 `DATE`、`TIMESTAMP`、`TIMESTAMP WITH TIME ZONE`、`TIMESTAMP WITH LOCAL TIME ZONE`、`INTERVAL DAY TO SECOND` 和 `INTERVAL YEAR TO MONTH` 等数据类型的值按照参数 `fmt` 指定的格式转换为 `VARCHAR2` 数据类型的值。 如果不指定参数 `fmt`,则参数 `datetime` 的值将按如下格式转换为 `VARCHAR2` 数据类型: - -* `DATE`、`TIMESTAMP`、`TIMESTAMP WITH TIME ZONE` 和 `TIMESTAMP WITH LOCAL TIME ZONE` 的值被转换为数据库中日期时间值的默认格式。您可在数据类型章节中查看各日期时间类型的默认格式。 - - - -* `INTERVAL DAY TO SECOND` 和 `INTERVAL YEAR TO MONTH` 数据类型的值转换为数字格式的间隔值。 - - - - - - -语法 --------------- - -```javascript -TO_CHAR({ datetime | interval } [, fmt [, 'nlsparam' ] ]) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|----------|---------------------------------------------------------------------------------------------------------------------------------------------| -| datetime | `DATE`、`TIMESTAMP`、`TIMESTAMP WITH TIME ZONE`、`TIMESTAMP WITH LOCAL TIME ZONE`、`INTERVAL DAY TO SECOND` 和 `INTERVAL YEAR TO MONTH` 等数据类型的值。 | -| fmt | 输出格式参数。 | -| nlsparam | 用来控制返回的月份和日份所使用的语言。 | - - - -返回类型 ----------------- - -`VARCHAR2` 数据类型 - -示例 --------------- - -**示例 1** : 以下语句通过 TO_CHAR 函数返回系统当前日期,并且将日期时间值转换为了 **DS DL** 格式: - -```javascript -SELECT TO_CHAR(SYSDATE,'DS DL') FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+-----------------------------------+ -| TO_CHAR(SYSDATE,'DSDL') | -+-----------------------------------+ -| 03/08/2020 Sunday, March 08, 2020 | -+-----------------------------------+ -``` - - - -**示例 2** :以下语句将间隔值转化为指定格式,并且设置了返回语言为 **AMERICAN** : - -```javascript -SELECT TO_CHAR(interval'1' year, 'SS-MI-HH', 'nls_language = AMERICAN') FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+-------------------------------------------------------------+ -| TO_CHAR(INTERVAL'1'YEAR,'SS-MI-HH','NLS_LANGUAGE=AMERICAN') | -+-------------------------------------------------------------+ -| +01-00 | -+-------------------------------------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/19.TO_DSINTERVAL.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/19.TO_DSINTERVAL.md deleted file mode 100644 index ba969f9b9..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/19.TO_DSINTERVAL.md +++ /dev/null @@ -1,54 +0,0 @@ -TO_DSINTERVAL -================================== - - - -`TO_DSINTERVAL` 函数将一个 `CHAR`、`VARCHAR2`、`NCHAR` 或 `NVARCHAR2` 数据类型的字符串转换为一个 `INTERVAL DAY TO SECOND` 数据类型的值,该函数可以用来对一个日期时间值进行加减计算。 - -语法 --------------- - -```javascript -TO_DSINTERVAL (days hours:minutes:seconds[.frac_secs]) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|------------------------------------------|------------------------------------------------------------| -| days hours:minutes:seconds\[.frac_secs\] | 符合该参数格式的 `CHAR`、`VARCHAR2`、`NCHAR` 或 `NVARCHAR2` 数据类型的字符串。 | - - - -返回类型 ----------------- - -`INTERVAL DAY TO SECOND` 数据类型。 - -示例 --------------- - -以下示例返回了当前时间 100 天后的日期时间值: - -```javascript -SELECT SYSDATE, SYSDATE+TO_DSINTERVAL('100 00:00:00') FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+---------------------+--------------------------------------+ -| SYSDATE | SYSDATE+TO_DSINTERVAL('10000:00:00') | -+---------------------+--------------------------------------+ -| 2020-03-26 12:40:39 | 2020-07-04 12:40:39 | -+---------------------+--------------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/2.CURRENT_DATE.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/2.CURRENT_DATE.md deleted file mode 100644 index 45e8879d0..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/2.CURRENT_DATE.md +++ /dev/null @@ -1,86 +0,0 @@ -CURRENT_DATE -================================= - - - -`CURRENT_DATE` 函数返回当前会话时区中的当前日期。 - -语法 --------------- - -```javascript -CURRENT_DATE -``` - - - -参数 --------------- - -无参数。 - -返回类型 ----------------- - -`DATE` 数据类型。 - -示例 --------------- - -此示例显示了不同会话时区使用 `CURRENT_DATE` 函数所得的结果。 - -设置当前时区至 GMT-5 时区: - -```javascript -ALTER SESSION SET TIME_ZONE = '-05:00'; -``` - - - -执行以下语句调用函数: - -```javascript -SELECT CURRENT_DATE FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+---------------------+ -| CURRENT_DATE | -+---------------------+ -| 2020-03-08 01:40:11 | -+---------------------+ -``` - - - -切换当前时区至 GMT+8 时区 - -```javascript -ALTER SESSION SET TIME_ZONE = '+08:00'; -``` - - - -执行以下语句调用函数: - -```javascript -SELECT CURRENT_DATE FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+---------------------+ -| CURRENT_DATE | -+---------------------+ -| 2020-03-08 14:40:11 | -+---------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/20.TO_TIMESTAMP.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/20.TO_TIMESTAMP.md deleted file mode 100644 index 6484be9e8..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/20.TO_TIMESTAMP.md +++ /dev/null @@ -1,57 +0,0 @@ -TO_TIMESTAMP -================================= - - - -`TO_TIMESTAMP` 函数将字符串转换为 `TIMESTAMP` 数据类型。 - -语法 --------------- - -```javascript -TO_TIMESTAMP (char,[fmt],['nlsparam']) -``` - - - -参数 --------------- - - - -| | 说明 | -|----------|---------------------------------------------------| -| char | `CHAR`、`VARCHAR2`、`NCHAR` 或 `NVARCHAR2` 数据类型的字符串。 | -| fmt | 指定返回值的格式。 | -| nlsparam | 用来控制返回的月份和日份所使用的语言。 | - - - -返回类型 ----------------- - -`TIMESTAMP` 数据类型。 - -示例 --------------- - -执行以下语句: - -```javascript -SELECT TO_TIMESTAMP ('10-Sep-02 14:10:10.123000', 'DD-Mon-RR HH24:MI:SS.FF') -FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+-------------------------------------------------------------------+ -| TO_TIMESTAMP('10-SEP-0214:10:10.123000','DD-MON-RRHH24:MI:SS.FF') | -+-------------------------------------------------------------------+ -| 2002-09-10 14:10:10.123000000 | -+-------------------------------------------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/21.TO_TIMESTAMP_TZ.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/21.TO_TIMESTAMP_TZ.md deleted file mode 100644 index 2f1185cef..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/21.TO_TIMESTAMP_TZ.md +++ /dev/null @@ -1,56 +0,0 @@ -TO_TIMESTAMP_TZ -==================================== - - - -`TO_TIMESTAMP_TZ` 函数将字符串转换为 `TIMESTAMP WITH TIME ZONE` 数据类型,包含时区信息。 - -语法 --------------- - -```javascript -TO_TIMESTAMP_TZ (char,[fmt],['nlsparam']) -``` - - - -参数 --------------- - - - -| **参数** | **说明** | -|----------|---------------------------------------------------| -| char | `CHAR`、`VARCHAR2`、`NCHAR` 或 `NVARCHAR2` 数据类型的字符串。 | -| fmt | 指定输出格式。 | -| nlsparam | 用来控制返回的月份和日份所使用的语言。 | - - - -返回类型 ----------------- - -`TIMESTAMP WITH TIME ZONE` 数据类型。 - -示例 --------------- - -执行以下语句: - -```javascript -SELECT TO_TIMESTAMP_TZ ('10-Sep-02 14:10:10.123000', 'DD-Mon-RR HH24:MI:SS.FF') FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+----------------------------------------------------------------------+ -| TO_TIMESTAMP_TZ('10-SEP-0214:10:10.123000','DD-MON-RRHH24:MI:SS.FF') | -+----------------------------------------------------------------------+ -| 2002-09-10 14:10:10.123000000 +08:00 | -+----------------------------------------------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/22.TO_YMINTERVAL.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/22.TO_YMINTERVAL.md deleted file mode 100644 index bab4c92fc..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/22.TO_YMINTERVAL.md +++ /dev/null @@ -1,68 +0,0 @@ -TO_YMINTERVAL -================================== - - - -`TO_YMINTERVAL` 函数将一个 `CHAR`、`VARCHAR2`、`NCHAR` 或 `NVARCHAR2` 数据类型的字符串转换为一个 `INTERVAL YEAR TO MONTH` 数据类型的值,该函数可以用来对一个日期时间值进行加减计算。 - -语法 --------------- - -```javascript -TO_YMINTERVAL (years-months) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|--------------|------------------------------------------------------------| -| years-months | 符合该参数格式的 `CHAR`、`VARCHAR2`、`NCHAR` 或 `NVARCHAR2` 数据类型的字符串。 | - - - - - -返回类型 ----------------- - - - -`INTERVAL YEAR TO MONTH` 数据类型。 - - - -示例 --------------- - - - -以下示例展示了返回当前时间 1 年 2 个月后的时间日期值: - - - -```javascript -SELECT SYSDATE,SYSDATE+TO_YMINTERVAL('01-02') FROM DUAL; -``` - - - - - -查询结果如下: - - - -```javascript -+---------------------+--------------------------------+ -| SYSDATE | SYSDATE+TO_YMINTERVAL('01-02') | -+---------------------+--------------------------------+ -| 2020-03-08 22:32:01 | 2021-05-08 22:32:01 | -+---------------------+--------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/23.trunc-date.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/23.trunc-date.md deleted file mode 100644 index acbd8978c..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/23.trunc-date.md +++ /dev/null @@ -1,102 +0,0 @@ -TRUNC (date) -================================= - - - -`TRUNC` 函数返回以参数 `fmt` 为单位距离的离指定日期 `date` 最近的日期时间值,并且返回的日期值在 `date` 之前。 -**注意** - - - -与函数 `ROUND` 的区别为,`TRUNC` 返回的值必须是在 `date` 之前的离 `date` 最近的日期,`ROUND` 可以是 `date` 之前也可以是 `date` 之后的离它最近的日期值。 - -语法 --------------- - -```javascript -TRUNC (date,[fmt]) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|------|-----------------------------------------------| -| date | `DATE` 数据类型。 | -| fmt | 指定了函数返回值与 `date` 的距离单位,以下表格列举了该参数的可取值,大小写不敏感。 | - - - - -| fmt参数表 | 说明 | -|-----------------|---------------------------------| -| j | 默认值,最近 0 点日期。 | -| day、dy、d | 返回离指定日期最近的星期日。 | -| month、mon、mm、rm | 返回离指定日期最近的月的第一天日期。 | -| q | 返回离指定日期最近的季的日期。 | -| yyyy、yyy、yy、y | 多个 y 表示不同的精度,返回离指定日期最近的年的第一个日期。 | -| cc、scc | 返回离指定日期最近的世纪的初日期。 | - - - -返回类型 ----------------- - -`DATE` 数据类型。 - -示例 --------------- - -以下示例展示了用 `TRUNC` 计算距离 **SYSDATE** 最近的符合要求的日期值: - -```javascript -SELECT SYSDATE 当时日期, -TRUNC(SYSDATE) 今天日期, -TRUNC(SYSDATE,'DAY') 本周星期日, -TRUNC(SYSDATE,'MONTH') 本月初, -TRUNC(SYSDATE,'Q') 本季初日期, -TRUNC(SYSDATE,'YEAR') 本年初日期 FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+---------------------+---------------------+---------------------+---------------------+---------------------+---------------------+ -| 当时日期 | 今天日期 | 本周星期日 | 本月初 | 本季初日期 | 本年初日期 | -+---------------------+---------------------+---------------------+---------------------+---------------------+---------------------+ -| 2020-03-08 22:41:46 | 2020-03-08 00:00:00 | 2020-03-08 00:00:00 | 2020-03-01 00:00:00 | 2020-01-01 00:00:00 | 2020-01-01 00:00:00 | -+---------------------+---------------------+---------------------+---------------------+---------------------+---------------------+ -``` - - - -以下示例展示了在相同日期下用 `ROUND` 计算符合要求的最近日期的结果: - -```javascript -SELECT SYSDATE 当时日期, -ROUND(SYSDATE) 最近0点日期, -ROUND(SYSDATE,'DAY') 最近星期日, -ROUND(SYSDATE,'MONTH') 最近月初, -ROUND(SYSDATE,'Q') 最近季初日期, -ROUND(SYSDATE,'YEAR') 最近年初日期 FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+---------------------+---------------------+---------------------+---------------------+---------------------+---------------------+ -| 当时日期 | 最近0点日期 | 最近星期日 | 最近月初 | 最近季初日期 | 最近年初日期 | -+---------------------+---------------------+---------------------+---------------------+---------------------+---------------------+ -| 2020-03-08 22:41:02 | 2020-03-09 00:00:00 | 2020-03-08 00:00:00 | 2020-03-01 00:00:00 | 2020-04-01 00:00:00 | 2020-01-01 00:00:00 | -+---------------------+---------------------+---------------------+---------------------+---------------------+---------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/24.TZ_OFFSET.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/24.TZ_OFFSET.md deleted file mode 100644 index 9a6963b12..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/24.TZ_OFFSET.md +++ /dev/null @@ -1,54 +0,0 @@ -TZ_OFFSET -============================== - - - -`TZ_OFFSET` 函数返回时区 `n` 的时区偏移量。时区偏移量是指与格林尼治标准时间 GMT 的差(小时和分钟)。 - -语法 --------------- - -```javascript -TZ_OFFSET (n) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|----|---------| -| n | 时区区域名称。 | - - - -返回类型 ----------------- - -`VARCHAR2` 数据类型。 - -示例 --------------- - -以下示例返回了当前会话时区 `SESSIONTIMEZONE` 、数据库时区 `DBTIMEZONE` 和 US/Eastern 所在时区的时区偏移量: - -```javascript -SELECT TZ_OFFSET(SESSIONTIMEZONE),TZ_OFFSET(DBTIMEZONE),TZ_OFFSET('US/Eastern') FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+----------------------------+-----------------------+-------------------------+ -| TZ_OFFSET(SESSIONTIMEZONE) | TZ_OFFSET(DBTIMEZONE) | TZ_OFFSET('US/EASTERN') | -+----------------------------+-----------------------+-------------------------+ -| +08:00 | +00:00 | -04:00 | -+----------------------------+-----------------------+-------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/3.CURRENT_TIMESTAMP.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/3.CURRENT_TIMESTAMP.md deleted file mode 100644 index e1530a168..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/3.CURRENT_TIMESTAMP.md +++ /dev/null @@ -1,92 +0,0 @@ -CURRENT_TIMESTAMP -====================================== - - - -`CURRENT_TIMESTAMP` 函数返回 `TIMESTAMP WITH TIME ZONE` 数据类型的当前会话时区中的当前日期,返回值中包含当前的时区信息。 - -语法 --------------- - -```javascript -CURRENT_TIMESTAMP (precision) -``` - - - -参数 --------------- - - - -| **参数** | **说明** | -|-----------|-----------------------------| -| precision | 表示秒小数位的精度,默认值为 6,取值范围 0\~9。 | - - - -返回类型 ----------------- - -包含当前的时区信息的 `TIMESTAMP WITH TIME ZONE` 数据类型。 - -示例 --------------- - -此示例显示了不同会话时区使用 `CURRENT_TIMESTAMP` 函数所得的结果。 - -设置当前时区至 GMT-5 时区: - -```javascript -ALTER SESSION SET TIME_ZONE = '-05:00'; -``` - - - -执行以下语句调用函数: - -```javascript -SELECT CURRENT_TIMESTAMP FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+------------------------------------+ -| CURRENT_TIMESTAMP | -+------------------------------------+ -| 2020-03-08 01:49:31.219066 -05:00 | -+------------------------------------+ -``` - - - -切换当前时区至 GMT+8 时区,且调整秒的小数位精度为 3: - -```javascript -ALTER SESSION SET TIME_ZONE = '+08:00'; -``` - - - -执行以下语句调用函数: - -```javascript -SELECT CURRENT_TIMESTAMP(3) FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+---------------------------------+ -| CURRENT_TIMESTAMP(3) | -+---------------------------------+ -| 2020-03-08 14:50:32.499 +08:00 | -+---------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/4.DBTIMEZONE.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/4.DBTIMEZONE.md deleted file mode 100644 index b77f851df..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/4.DBTIMEZONE.md +++ /dev/null @@ -1,48 +0,0 @@ -DBTIMEZONE -=============================== - - - -`DBTIMEZONE` 函数返回当前数据库实例的时区,在 OceanBase 中数据库时区恒为+00:00,且不支持修改。 - -语法 --------------- - -```javascript -DBTIMEZONE -``` - - - -参数 --------------- - -无参数。 - -返回类型 ----------------- - -`VARCHAR2` 数据类型。 - -示例 --------------- - -执行以下语句: - -```javascript -SELECT DBTIMEZONE FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+------------+ -| DBTIMEZONE | -+------------+ -| +00:00 | -+------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/5.extract-datetime.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/5.extract-datetime.md deleted file mode 100644 index 34d11a1f5..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/5.extract-datetime.md +++ /dev/null @@ -1,61 +0,0 @@ -EXTRACT(datetime) -====================================== - - - -`EXTRACT(datetime)` 函数是从指定的时间字段或表达式中抽取年、月、日、时、分、秒等元素。 - -语法 --------------- - -```javascript -EXTRACT (fields FROM datetime) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|----------|-------------------------------------------------------------------------------------------------------------------------------------------------| -| fields | 要抽取的元素的名称: `YEAR`、`MONTH`、`DAY`、`HOUR`、`MINUTE`、`SECOND`、`TIMEZONE_HOUR`、`TIMEZONE_MINUTE`、`TIMEZONE_MINUTE`、`TIMEZONE_REGION`、`TIMEZONE_ABBR`。 | -| datetime | `DATE`、`TIMESTAMP`、`TIMESTAMP WITH TIME ZONE`、`TIMESTAMP WITH LOCAL TIME ZONE`、`INTERVAL YEAR TO MONTH`、`INTERVAL DAY TO SECOND` 等数据类型的值。 | - - - -返回类型 ----------------- - -抽取元素 `TIMEZONE_REGION`、`TIMEZONE_ABBR` 时,返回值的数据类型为 `VARCHAR2`。抽取其他元素时,返回值的数据类型为 `NUMBER`。 - -示例 --------------- - -执行以下语句: - -```javascript -SELECT EXTRACT(HOUR FROM TIMESTAMP '2001-2-16 2:38:40 ') 小时, - EXTRACT(MINUTE FROM TIMESTAMP '2001-2-16 2:38:40 ') 分钟, - EXTRACT(SECOND FROM TIMESTAMP '2001-2-16 2:38:40 ') 秒, - EXTRACT(DAY FROM TIMESTAMP '2001-2-16 2:38:40 ') 日, - EXTRACT(MONTH FROM TIMESTAMP '2001-2-16 2:38:40 ') 月, - EXTRACT(YEAR FROM TIMESTAMP '2001-2-16 2:38:40 ') 年 -FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+--------+--------+------+------+------+------+ -| 小时 | 分钟 | 秒 | 日 | 月 | 年 | -+--------+--------+------+------+------+------+ -| 2 | 38 | 40 | 16 | 2 | 2001 | -+--------+--------+------+------+------+------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/6.FROM_TZ.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/6.FROM_TZ.md deleted file mode 100644 index 94f478c39..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/6.FROM_TZ.md +++ /dev/null @@ -1,55 +0,0 @@ -FROM_TZ -============================ - - - -`FROM_TZ` 函数将一个 `TIMSTAMP` 数据类型的值和时区信息拼成一个 `TIMESTAMP WITH TIME ZONE` 数据类型的时间值。 - -语法 --------------- - -```javascript -FROM_TZ (timestamp_value,time_zone_value) -``` - - - -参数 --------------- - - - -| **参数** | **说明** | -|-----------------|----------------------| -| timestamp_value | `TIMSTAMP` 数据类型的时间值。 | -| time_zone_value | 时区信息。 | - - - -返回类型 ----------------- - -`TIMESTAMP WITH TIME ZONE` 数据类型。 - -示例 --------------- - -执行以下语句: - -```javascript -SELECT FROM_TZ(TIMESTAMP '2020-03-28 08:00:00', '-03:00') FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+------------------------------------------------+ -| FROM_TZ(TIMESTAMP'2020-03-2808:00:00','-03:00') | -+------------------------------------------------+ -| 2020-03-28 08:00:00.000000000 -03:00 | -+------------------------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/7.LAST_DAY.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/7.LAST_DAY.md deleted file mode 100644 index ade80dfb6..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/7.LAST_DAY.md +++ /dev/null @@ -1,56 +0,0 @@ -LAST_DAY -============================= - - - -`LAST_DAY` 函数返回日期 `date` 所在月份的最后一天的日期。 - -语法 --------------- - -```javascript -LAST_DAY (date) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|------|--------------------------------------------------------------------------------------------------| -| date | 所有包含日期信息的数据类型(`DATE`、`TIMESTAMP`、`TIMESTAMP WITH TIME ZONE`、`TIMESTAMP WITH LOCAL TIME ZONE`)的值。 | - - - -返回类型 ----------------- - -`DATE` 数据类型。 - -示例 --------------- - -本示例显示了当前日期与本月的最后一天日期以及本月剩余的天数。 - -执行以下语句: - -```javascript -SELECT SYSDATE, LAST_DAY(SYSDATE)Last, LAST_DAY(SYSDATE)-SYSDATE "Left" FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+---------------------+---------------------+------+ -| SYSDATE | LAST | Left | -+---------------------+---------------------+------+ -| 2020-03-08 15:23:33 | 2020-03-31 15:23:33 | 23 | -+---------------------+---------------------+------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/8.LOCALTIMESTAMP.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/8.LOCALTIMESTAMP.md deleted file mode 100644 index 8775160ba..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/8.LOCALTIMESTAMP.md +++ /dev/null @@ -1,92 +0,0 @@ -LOCALTIMESTAMP -=================================== - - - -`LOCALTIMESTAMP` 函数返回当前会话时区中的当前日期,返回 `TIMESTAMP` 数据类型的值。与函数 [CURRENT_TIMESTAMP](sxtu3i) 的区别是,`CURRENT_TIMESTAMP` 函数返回 `TIMESTAMP WITH TIME ZONE` 数据类型的值。 - -语法 --------------- - -```javascript -LOCALTIMESTAMP (timestamp_precision) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|---------------------|------------------------------| -| timestamp_precision | 表示秒的小数位的精度,默认值为 6,取值范围 0\~9。 | - - - -返回类型 ----------------- - -`TIMESTAMP` 数据类型。 - -示例 --------------- - -此示例显示了不同会话时区使用 `LOCALTIMESTAMP` 函数所得的结果。 - -设置当前时区至 GMT-5 时区: - -```javascript -ALTER SESSION SET TIME_ZONE = '-05:00'; -``` - - - -执行以下语句调用函数: - -```javascript -SELECT LOCALTIMESTAMP FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+----------------------------+ -| LOCALTIMESTAMP | -+----------------------------+ -| 2020-03-08 02:30:20.062104 | -+----------------------------+ -``` - - - -切换当前时区至 GMT+8 时区,且调整秒的小数位精度为 3: - -```javascript -ALTER SESSION SET TIME_ZONE = '+08:00'; -``` - - - -执行以下语句调用函数: - -```javascript -SELECT LOCALTIMESTAMP(3) FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+-------------------------+ -| LOCALTIMESTAMP(3) | -+-------------------------+ -| 2020-03-08 15:30:54.500 | -+-------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/9.MONTHS_BETWEEN.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/9.MONTHS_BETWEEN.md deleted file mode 100644 index eb34a014e..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/4.date-and-time-functions/9.MONTHS_BETWEEN.md +++ /dev/null @@ -1,58 +0,0 @@ -MONTHS_BETWEEN -=================================== - - - -`MONTHS_BETWEEN` 函数是返回返回参数 `date1` 到 `date2` 之间的月数。 - -语法 --------------- - -```javascript -MONTHS_BETWEEN (date1,date2) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|-------|----------------| -| date1 | `DATE` 数据类型的值。 | -| date2 | `DATE` 数据类型的值。 | - - - -返回类型 ----------------- - -`NUMBER` 数据类型。如果 `date1`\>`date2`,返回正数;如果 `date1`\<`date2`,则返回负数。 - -示例 --------------- - -以下示例展示了当前时间和指定时间值之间的月数: - -```javascript -SELECT SYSDATE, -MONTHS_BETWEEN(SYSDATE,TO_DATE('2006-01-01','YYYY-MM-DD')), -MONTHS_BETWEEN(SYSDATE,TO_DATE('2022-01-01','YYYY-MM-DD')) -FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+---------------------+------------------------------------------------------------+------------------------------------------------------------+ -| SYSDATE | MONTHS_BETWEEN(SYSDATE,TO_DATE('2006-01-01','YYYY-MM-DD')) | MONTHS_BETWEEN(SYSDATE,TO_DATE('2022-01-01','YYYY-MM-DD')) | -+---------------------+------------------------------------------------------------+------------------------------------------------------------+ -| 2020-03-08 15:38:35 | 170.246832063918757467144563918757467145 | -21.75316793608124253285543608124253285544 | -+---------------------+------------------------------------------------------------+------------------------------------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/5.generic-comparison-functions/1.GREATEST.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/5.generic-comparison-functions/1.GREATEST.md deleted file mode 100644 index 8af3a1bc6..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/5.generic-comparison-functions/1.GREATEST.md +++ /dev/null @@ -1,76 +0,0 @@ -GREATEST -============================= - - - -`GREATEST` 函数返回一个或多个表达式列表中的最大值。 数据库使用第一个参数 `expr` 来确定返回类型。 如果其余参数的数据类型和第一个参数 `expr` 的数据类型不同,则 OceanBase 将第一个参数 `expr` 之后的每个参数隐式转换为比较之前的第一个 `expr` 的数据类型。 - -语法 --------------- - -```javascript -GREATEST(expr [, expr ]...) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|------|--------------------------------------------------------------------------------------------------------------------| -| expr | 一个表达式或表达式列表。数据类型可以是:`NUMBER`、`FLOAT`、`BINARY_FLOAT`、`BINARY_DOUBLE`、`CHAR`、`VARCHAR2`、`NCHAR`、`NVARCHAR2`或 `CLOB`。 | - - - -返回类型 ----------------- - -如果第一个参数 `expr` 的数据类型为 `NUMBER`、`FLOAT`、`BINARY_FLOAT`或 `BINARY_DOUBLE`,则返回与第一个参数 `expr` 相同的数据类型。如果第一个参数 `expr` 的数据类型为 `CHAR`、`VARCHAR2` 或 `CLOB`,则返回 `VARCHAR2` 类型。如果第一个参数 `expr` 的数据类型为 `NCHAR` 或 `NVARCHAR2`,则返回 `NVARCHAR2` 类型。 - -示例 --------------- - -以下语句比较了字符串的大小,并返回了其中最大的字符串: - -```javascript -SELECT GREATEST('HAPPY', 'HAPPEN', 'HAPPINESS') "Greatest" -FROM DUAL; -``` - - - -返回结果: - -```javascript -+----------+ -| Greatest | -+----------+ -| HAPPY | -+----------+ -``` - - - -以下语句比较了整数 **1** 和 字符串 **3.925** 、 **2.4** 三者间的大小,由于第一个参数的数据类型为数值数据类型,所以其余参数将被隐式转换为数值数据类型后再进行比较: - -```javascript -SELECT GREATEST (1, '3.935', '2.4') "Greatest" -FROM DUAL; -``` - - - -返回结果: - -```javascript -+----------+ -| Greatest | -+----------+ -| 3.935 | -+----------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/5.generic-comparison-functions/2.LEAST.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/5.generic-comparison-functions/2.LEAST.md deleted file mode 100644 index eb356cab7..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/5.generic-comparison-functions/2.LEAST.md +++ /dev/null @@ -1,76 +0,0 @@ -LEAST -========================== - - - -`LEAST` 函数返回一个或多个表达式列表中的最小值。 数据库使用第一个参数 `expr` 来确定返回类型。 如果其余参数的数据类型和第一个参数 `expr` 的数据类型不同,则 OceanBase 将第一个参数 `expr` 之后的每个参数隐式转换为比较之前的第一个 `expr` 的数据类型。 - -语法 --------------- - -```javascript -LEAST(expr [, expr ]...) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|------|--------------------------------------------------------------------------------------------------------------------| -| expr | 一个表达式或表达式列表。数据类型可以是:`NUMBER`、`FLOAT`、`BINARY_FLOAT`、`BINARY_DOUBLE`、`CHAR`、`VARCHAR2`、`NCHAR`、`NVARCHAR2`或 `CLOB`。 | - - - -返回类型 ----------------- - -如果第一个参数 `expr` 的数据类型为 `NUMBER`、`FLOAT`、`BINARY_FLOAT`或 `BINARY_DOUBLE`,则返回与第一个参数 `expr` 相同的数据类型。如果第一个参数 `expr` 的数据类型为 `CHAR`、`VARCHAR2` 或 `CLOB`,则返回 `VARCHAR2` 类型。如果第一个参数 `expr` 的数据类型为 `NCHAR` 或 `NVARCHAR2`,则返回 `NVARCHAR2` 类型。 - -示例 --------------- - -以下语句比较了字符串的大小,并返回了其中最小的字符串: - -```javascript -SELECT LEAST('HAPPY', 'HAPPEN', 'HAPPINESS') "Least" -FROM DUAL; -``` - - - -返回结果: - -```javascript -+--------+ -| Least | -+--------+ -| HAPPEN | -+--------+ -``` - - - -以下语句比较了整数 **1** 和 字符串 **3.925** 、 **2.4** 三者间的大小,由于第一个参数的数据类型为数值数据类型,所以其余参数将被隐式转换为数值数据类型后再进行比较: - -```javascript -SELECT LEAST (1, '3.925', '2.4') "Least" -FROM DUAL; -``` - - - -返回结果: - -```javascript -+-------+ -| Least | -+-------+ -| 1 | -+-------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/1.CAST.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/1.CAST.md deleted file mode 100644 index e34422a4c..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/1.CAST.md +++ /dev/null @@ -1,78 +0,0 @@ -CAST -========================= - - - -`CAST` 函数用于将源数据类型的表达式显式转换为另一种数据类型。 - -语法 --------------- - -```javascript -CAST (expr AS type_name ) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|-----------|--------------------------------------------------------------------------| -| expr | 列名或者表达式。 | -| AS | 用于分隔两个参数,在 `AS` 之前的是要处理的数据,在 `AS` 之后是要转换的数据类型。 | -| type_name | 数据类型为 OceanBase 的 [内建数据类型](../../../../11.sql-reference-oracle-mode/3.basic-elements-1/1.built-in-data-types/1.overview-of-built-in-data-types.md)。 | - - - -返回类型 ----------------- - -返回与 `type_name` 相同的类型。 - -下表显示了哪些数据类型可以转换为其他内置数据类型: - - -| | **from BINARY_FLOAT, BINARY_DOUBLE** | **from CHAR, VARCHAR2** | **from NUMBER** | ^[1]()^ **from DATETIME/INTERVAL** | **from RAW** | **from NCHAR, NVARCHAR2** | -|------------------------------------|--------------------------------------|-------------------------|-----------------|----------------------------------------------------|--------------|---------------------------| -| **to BINARY_FLOAT, BINARY_DOUBLE** | yes | yes | yes | no | no | yes | -| **to CHAR, VARCHAR2** | yes | yes | yes | yes | yes | no | -| **to NUMBER** | yes | yes | yes | no | no | yes | -| **to DATETIME, INTERVAL** | no | yes | no | yes | no | no | -| **to RAW** | yes | yes | yes | no | yes | no | -| **to NCHAR, NVARCHAR2** | yes | no | yes | yes | yes | yes | - - - -^[1]()^`To DATETIME/INTERVAL` 数据类型包括 `DATE`、`TIMESTAMP`、`TIMESTAMP WITH TIMEZONE`、`INTERVAL DAY TO SECOND` 和 `INTERVAL YEAR TO MONTH`。 - -示例 --------------- - -执行以下语句: - -```javascript -SELECT CAST('123' AS INT),CAST(1 AS VARCHAR2(10)),CAST('22-OCT-1997' AS TIMESTAMP WITH LOCAL TIME ZONE) -AS RESULT FROM DUAL; -``` - - -**说明** - - - -此函数会受 NLS_DATE_FORMAT 格式的影响,建议先执行如下语句更改 NLS_DATE_FORMAT 格式:`ALTER SESSION SET N``LS_DATE_FORMAT = 'YYYY-MM-DD HH24:MI:SS';` - -查询结果如下: - -```javascript -+------------------+-----------------------+----------------------------+ -| CAST('123'ASINT) | CAST(1ASVARCHAR2(10)) | RESULT | -+------------------+-----------------------+----------------------------+ -| 123 | 1 | 1997-10-22 00:00:00.000000 | -+------------------+-----------------------+----------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/10.TO_DSINTERVAL-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/10.TO_DSINTERVAL-1.md deleted file mode 100644 index ba969f9b9..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/10.TO_DSINTERVAL-1.md +++ /dev/null @@ -1,54 +0,0 @@ -TO_DSINTERVAL -================================== - - - -`TO_DSINTERVAL` 函数将一个 `CHAR`、`VARCHAR2`、`NCHAR` 或 `NVARCHAR2` 数据类型的字符串转换为一个 `INTERVAL DAY TO SECOND` 数据类型的值,该函数可以用来对一个日期时间值进行加减计算。 - -语法 --------------- - -```javascript -TO_DSINTERVAL (days hours:minutes:seconds[.frac_secs]) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|------------------------------------------|------------------------------------------------------------| -| days hours:minutes:seconds\[.frac_secs\] | 符合该参数格式的 `CHAR`、`VARCHAR2`、`NCHAR` 或 `NVARCHAR2` 数据类型的字符串。 | - - - -返回类型 ----------------- - -`INTERVAL DAY TO SECOND` 数据类型。 - -示例 --------------- - -以下示例返回了当前时间 100 天后的日期时间值: - -```javascript -SELECT SYSDATE, SYSDATE+TO_DSINTERVAL('100 00:00:00') FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+---------------------+--------------------------------------+ -| SYSDATE | SYSDATE+TO_DSINTERVAL('10000:00:00') | -+---------------------+--------------------------------------+ -| 2020-03-26 12:40:39 | 2020-07-04 12:40:39 | -+---------------------+--------------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/11.TO_NUMBER.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/11.TO_NUMBER.md deleted file mode 100644 index 714264be0..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/11.TO_NUMBER.md +++ /dev/null @@ -1,56 +0,0 @@ -TO_NUMBER -============================== - - - -`TO_NUMBER` 函数将 `expr` 转换为数值数据类型的值。`expr` 可以是 `CHAR`、`VARCHAR2`、`NCHAR`、`NVARCHAR2`、`BINARY_FLOAT` 或 `BINARY_DOUBLE` 数据类型的数值。 - -语法 --------------- - -```javascript -TO_NUMBER(expr [, fmt [, 'nlsparam' ] ]) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|----------|---------------------------------------------------------------------------------| -| expr | `CHAR`、`VARCHAR2`、`NCHAR`、`NVARCHAR2`、`BINARY_FLOAT` 或 `BINARY_DOUBLE` 数据类型的数值。 | -| fmt | 格式模型。 | -| nlsparam | 支持的语言从 `sys.V_$NLS_VALID_VALUES` 获取。 | - - - -返回类型 ----------------- - -返回 `NUMBER` 类型的数据。 - -示例 --------------- - -执行以下语句: - -```javascript -SELECT TO_NUMBER('199912'),TO_NUMBER('450.05') FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+---------------------+---------------------+ -| TO_NUMBER('199912') | TO_NUMBER('450.05') | -+---------------------+---------------------+ -| 199912 | 450.05 | -+---------------------+---------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/12.TO_TIMESTAMP-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/12.TO_TIMESTAMP-1.md deleted file mode 100644 index 78bbb1436..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/12.TO_TIMESTAMP-1.md +++ /dev/null @@ -1,57 +0,0 @@ -TO_TIMESTAMP -================================= - - - -`TO_TIMESTAMP` 函数将字符串转换为 `TIMESTAMP` 数据类型。 - -语法 --------------- - -```javascript -TO_TIMESTAMP (char,[fmt],['nlsparam']) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|----------|---------------------------------------------------| -| char | `CHAR`、`VARCHAR2`、`NCHAR` 或 `NVARCHAR2` 数据类型的字符串。 | -| fmt | 指定返回值的格式。 | -| nlsparam | 用来控制返回的月份和日份所使用的语言。 | - - - -返回类型 ----------------- - -`TIMESTAMP` 数据类型。 - -示例 --------------- - -执行以下语句: - -```javascript -SELECT TO_TIMESTAMP ('10-Sep-02 14:10:10.123000', 'DD-Mon-RR HH24:MI:SS.FF') -FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+-------------------------------------------------------------------+ -| TO_TIMESTAMP('10-SEP-0214:10:10.123000','DD-MON-RRHH24:MI:SS.FF') | -+-------------------------------------------------------------------+ -| 2002-09-10 14:10:10.123000000 | -+-------------------------------------------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/13.TO_TIMESTAMP_TZ-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/13.TO_TIMESTAMP_TZ-1.md deleted file mode 100644 index 37233e18e..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/13.TO_TIMESTAMP_TZ-1.md +++ /dev/null @@ -1,56 +0,0 @@ -TO_TIMESTAMP_TZ -==================================== - - - -`TO_TIMESTAMP` 函数将字符串转换为 `TIMESTAMP WITH TIME ZONE` 数据类型,包含时区信息。 - -语法 --------------- - -```javascript -TO_TIMESTAMP_TZ (char,[fmt],['nlsparam']) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|----------|---------------------------------------------------| -| char | `CHAR`、`VARCHAR2`、`NCHAR` 或 `NVARCHAR2` 数据类型的字符串。 | -| fmt | 指定输出格式。 | -| nlsparam | 用来控制返回的月份和日份所使用的语言。 | - - - -返回类型 ----------------- - -`TIMESTAMP WITH TIME ZONE` 数据类型。 - -示例 --------------- - -执行以下语句: - -```javascript -SELECT TO_TIMESTAMP_TZ ('10-Sep-02 14:10:10.123000', 'DD-Mon-RR HH24:MI:SS.FF') FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+----------------------------------------------------------------------+ -| TO_TIMESTAMP_TZ('10-SEP-0214:10:10.123000','DD-MON-RRHH24:MI:SS.FF') | -+----------------------------------------------------------------------+ -| 2002-09-10 14:10:10.123000000 +08:00 | -+----------------------------------------------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/14.TO_YMINTERVAL-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/14.TO_YMINTERVAL-1.md deleted file mode 100644 index 7cd7cb127..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/14.TO_YMINTERVAL-1.md +++ /dev/null @@ -1,54 +0,0 @@ -TO_YMINTERVAL -================================== - - - -`TO_YMINTERVAL` 函数将一个 `CHAR`、`VARCHAR2`、`NCHAR` 或 `NVARCHAR2` 数据类型的字符串转换为一个 `INTERVAL YEAR TO MONTH` 数据类型的值,该函数可以用来对一个日期时间值进行加减计算。 - -语法 --------------- - -```javascript -TO_YMINTERVAL (years-months) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|--------------|------------------------------------------------------------| -| years-months | 符合该参数格式的 `CHAR`、`VARCHAR2`、`NCHAR` 或 `NVARCHAR2` 数据类型的字符串。 | - - - -返回类型 ----------------- - -`INTERVAL YEAR TO MONTH` 数据类型。 - -示例 --------------- - -以下示例展示了返回当前时间 1 年 2 个月后的时间日期值: - -```javascript -SELECT SYSDATE,SYSDATE+TO_YMINTERVAL('01-02') FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+---------------------+--------------------------------+ -| SYSDATE | SYSDATE+TO_YMINTERVAL('01-02') | -+---------------------+--------------------------------+ -| 2020-03-08 22:32:01 | 2021-05-08 22:32:01 | -+---------------------+--------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/2.HEXTORAW.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/2.HEXTORAW.md deleted file mode 100644 index 8382a48c2..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/2.HEXTORAW.md +++ /dev/null @@ -1,54 +0,0 @@ -HEXTORAW -============================= - - - -`HEXTORAW` 函数将 `CHAR`、`VARCHAR2`、`NCHAR` 或 `NVARCHAR2` 数据类型中包含十六进制数字的字符转换为 `RAW` 数据类型。 - -语法 --------------- - -```javascript -HEXTORAW (char) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|------|-----------------------------------------------------------| -| char | 十六进制的字符串。字符串类型可为:`CHAR`、`VARCHAR2`、`NCHAR` 或 `NVARCHAR2`。 | - - - -返回类型 ----------------- - -返回 `RAW` 类型的数据。 - -示例 --------------- - -执行以下语句: - -```javascript -select HEXTORAW('A123') from dual; -``` - - - -查询结果如下: - -```javascript -+------------------+ -| HEXTORAW('A123') | -+------------------+ -| A123 | -+------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/3.RAWTOHEX.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/3.RAWTOHEX.md deleted file mode 100644 index 6413d4b69..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/3.RAWTOHEX.md +++ /dev/null @@ -1,54 +0,0 @@ -RAWTOHEX -============================= - - - -`RAWTOHEX` 函数将二进制数转换为一个相应的十六进制表示的字符串。 - -语法 --------------- - -```javascript -RAWTOHEX (raw) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|-----|----------| -| raw | 二进制的字符串。 | - - - -返回类型 ----------------- - -十六进制表示的字符串。 - -示例 --------------- - -执行以下语句: - -```javascript -SELECT RAWTOHEX('AB') FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+----------------+ -| RAWTOHEX('AB') | -+----------------+ -| 4142 | -+----------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/4.TO_BINARY_DOUBLE.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/4.TO_BINARY_DOUBLE.md deleted file mode 100644 index 89e7d61e8..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/4.TO_BINARY_DOUBLE.md +++ /dev/null @@ -1,58 +0,0 @@ -TO_BINARY_DOUBLE -===================================== - - - -`TO_BINARY_DOUBLE` 函数返回一个双精度的 64 位浮点数。 - -语法 --------------- - -```javascript -TO_BINARY_DOUBLE(expr [, fmt [, 'nlsparam' ] ]) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|------|--------------------------------------------------------| -| expr | 字符串或 `NUMBER`、`BINARY_FLOAT` 或 `BINARY_DOUBLE` 数值数据类型。 | - - - -当 `expr` 是字符串时,可选的 `fmt` 和 `nlsparam` 参数才有效。它们的作用与 `TO_CHAR(number)` 功能的作用相同。当 `expr` 为 `BINARY_DOUBLE`,则该函数返回 `expr`。 - -返回类型 ----------------- - -双精度的 64 位浮点数。从字符串或 `NUMBER` 到 `BINARY_DOUBLE` 的转换可能不准确,因为 `NUMBER` 和字符类型使用十进制精度表示数值,而 `BINARY_DOUBLE` 使用二进制精度。从 `BINARY_FLOAT` 到 `BINARY_DOUBLE` 的转换是准确的。 - -示例 --------------- - -执行以下语句: - -```javascript -SELECT TO_BINARY_DOUBLE(1222.111) FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+----------------------------+ -| TO_BINARY_DOUBLE(1222.111) | -+----------------------------+ -| 1.2221110000000001E+003 | -+----------------------------+ -``` - - - -您可以看 [TO_BINARY_FLOAT](ab1u5c) 和 [TO_CHAR(number)](kh9rud)。 diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/5.TO_BINARY_FLOAT.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/5.TO_BINARY_FLOAT.md deleted file mode 100644 index acd2d984e..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/5.TO_BINARY_FLOAT.md +++ /dev/null @@ -1,58 +0,0 @@ -TO_BINARY_FLOAT -==================================== - - - -`TO_BINARY_FLOAT` 函数返回一个单精度的 32 位浮点数。 - -语法 --------------- - -```javascript -TO_BINARY_FLOAT(expr [, fmt [, 'nlsparam' ] ]) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|------|--------------------------------------------------------| -| expr | 字符串或 `NUMBER`、`BINARY_FLOAT` 或 `BINARY_DOUBLE` 数值数据类型。 | - - - -当 `expr` 是字符串时,可选的 `fmt` 和 `nlsparam` 参数才有效。它们的作用与 `TO_CHAR(number)` 功能的作用相同。当 `expr` 为 `BINARY_FLOAT`,则函数返回 `expr`。 - -返回类型 ----------------- - -单精度的 32 位浮点数。从字符串或 `NUMBER` 到 `BINARY_FLOAT` 的转换可能不精确,因为 `NUMBER` 和字符类型使用十进制精度表示数值,而 `BINARY_FLOAT` 使用二进制精度。如果 `BINARY_DOUBLE` 值使用的精度比`BINARY_FLOAT` 支持的精度高,则从 `BINARY_DOUBLE` 到 `BINARY_FLOAT` 的转换是不精确的。 - -示例 --------------- - -执行以下语句: - -```javascript -SELECT TO_BINARY_FLOAT(1222.111) from dual; -``` - - - -查询结果如下: - -```javascript -+---------------------------+ -| TO_BINARY_FLOAT(1222.111) | -+---------------------------+ -| 1.22211096E+003 | -+---------------------------+ -``` - - - -您可以看 [TO_BINARY_DOUBLE](pc6zsr) 和 [TO_CHAR(number)](kh9rud)。 diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/6.to_char-character.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/6.to_char-character.md deleted file mode 100644 index fb9984813..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/6.to_char-character.md +++ /dev/null @@ -1,63 +0,0 @@ -TO_CHAR (character) -======================================== - - - -`TO_CHAR (character)` 函数将 `NCHAR`、`NVARCHAR2` 或 `CLOB` 数据转换为数据库字符集。 - -语法 --------------- - -```javascript -TO_CHAR(character ) -``` - - - -参数 --------------- - - - -| | 说明 | -|-----------|----------------------------------------| -| character | 可以是 `NCHAR`、`NVARCHAR2` 或 `CLOB` 数据类型。 | - - - -返回类型 ----------------- - -返回 `VARCHAR2`。当函数将字符 `LOB` 转换为数据库字符集时,如果要转换的 `LOB` 值大于目标类型,则数据库返回错误。 - -示例 --------------- - -新建表 **CLOBTEST** ,并给 `RAW` 数据类型的列插入数据。 - -```javascript -CREATE TABLE CLOBTEST(TEXT CLOB); -INSERT INTO CLOBTEST VALUES('DWUIDBWUIDBWIOBFWUIOBFIOWBFWUIOBFUWIFB') ; -``` - - - -执行以下语句: - -```javascript -SELECT TO_CHAR(TEXT) FROM CLOBTEST; -``` - - - -查询结果如下: - -```javascript -+----------------------------------------+ -| TO_CHAR(TEXT) | -+----------------------------------------+ -| DWUIDBWUIDBWIOBFWUIOBFIOWBFWUIOBFUWIFB | -+----------------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/7.to_char-datetime-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/7.to_char-datetime-1.md deleted file mode 100644 index c46b9b1e1..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/7.to_char-datetime-1.md +++ /dev/null @@ -1,87 +0,0 @@ -TO_CHAR (datetime) -======================================= - - - -`TO_CHAR` 函数将 `DATE`、`TIMESTAMP`、`TIMESTAMP WITH TIME ZONE`、`TIMESTAMP WITH LOCAL TIME ZONE`、`INTERVAL DAY TO SECOND` 和 `INTERVAL YEAR TO MONTH` 等数据类型的值按照参数 `fmt` 指定的格式转换为 `VARCHAR2` 数据类型的值。 如果不指定参数 `fmt`,则参数 `datetime` 的值将按如下格式转换为 `VARCHAR2` 数据类型: - -* `DATE`、`TIMESTAMP`、`TIMESTAMP WITH TIME ZONE` 和 `TIMESTAMP WITH LOCAL TIME ZONE` 的值被转换为数据库中日期时间值的默认格式。您可在数据类型章节中查看各日期时间类型的默认格式。 - - - -* `INTERVAL DAY TO SECOND` 和 `INTERVAL YEAR TO MONTH` 数据类型的值转换为数字格式的间隔值。 - - - - - - -语法 --------------- - -```javascript -TO_CHAR({ datetime | interval } [, fmt [, 'nlsparam' ] ]) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|----------|---------------------------------------------------------------------------------------------------------------------------------------------| -| datetime | `DATE`、`TIMESTAMP`、`TIMESTAMP WITH TIME ZONE`、`TIMESTAMP WITH LOCAL TIME ZONE`、`INTERVAL DAY TO SECOND` 和 `INTERVAL YEAR TO MONTH` 等数据类型的值。 | -| fmt | 输出格式参数。 | -| nlsparam | 用来控制返回的月份和日份所使用的语言。 | - - - -返回类型 ----------------- - -`VARCHAR2` 数据类型。 - -示例 --------------- - -**示例 1** : 以下语句通过 TO_CHAR 函数返回系统当前日期,并且将日期时间值转换为了 **DS DL** 格式: - -```javascript -SELECT TO_CHAR(SYSDATE,'DS DL') FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+-----------------------------------+ -| TO_CHAR(SYSDATE,'DSDL') | -+-----------------------------------+ -| 03/08/2020 Sunday, March 08, 2020 | -+-----------------------------------+ -``` - - - -**示例 2** :以下语句将间隔值转化为指定格式,并且设置了返回语言为 **AMERICAN** : - -```javascript -SELECT TO_CHAR(interval'1' year, 'SS-MI-HH', 'nls_language = AMERICAN') FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+-------------------------------------------------------------+ -| TO_CHAR(INTERVAL'1'YEAR,'SS-MI-HH','NLS_LANGUAGE=AMERICAN') | -+-------------------------------------------------------------+ -| +01-00 | -+-------------------------------------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/8.to_char-number.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/8.to_char-number.md deleted file mode 100644 index deb09adbd..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/8.to_char-number.md +++ /dev/null @@ -1,68 +0,0 @@ -TO_CHAR (number) -===================================== - - - -`TO_CHAR` 函数将 `NUMBER`、`BINARY_FLOAT` 或 `BINARY_DOUBLE` 类型的数值 `n` 按照指定数值格式 `fmt` 转换为 `varchar2` 数据类型的值。如果省略 `fmt`,则 `n` 被转换为 `VARCHAR2` 值,其长度足以保持有效数字。若 `n` 为负值,则负号显示在输出值最左侧,比如 `TO_CHAR(-1,'$9')` 返回 `-$1`,而不是 `$-1`。 - -语法 --------------- - -```javascript -TO_CHAR(n [, fmt [, 'nlsparam' ] ]) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|----------|---------------------------------------------------------------------------------| -| n | 精确数值或近似数值数据类型类别的表达式。数值数据类型可以为 `NUMBER`、`BINARY_FLOAT` 或 `BINARY_DOUBLE` 数值数据类型。 | -| fmt | 输出格式参数。 | -| nlsparam | 支持的语言从 `sys.V_$NLS_VALID_VALUES` 获取。 | - - - -**fmt 参数列表** - - -| fmt 参数 | 说明 | -|--------|----------------------------------------------------------------------------------------| -| 9 | 返回指定位数的值。 | -| 0 | 它返回前导 0,它返回尾随 0。 | -| ,(逗号) | 返回指定位置的逗号。您可以在数字格式化中指定多个逗号。 **限制条件** :格式化数值不能以逗号开头,且逗号不能出现在小数字符或句点的右边。 | -| .(小数点) | 返回一个小数,且小数点在指定位置。 **限制条件** :在数字格式化中,您只能指定一个小数点。 | - - - -返回类型 ----------------- - -`VARCHAR2` 数据类型。 - -示例 --------------- - -执行以下语句: - -```javascript -SELECT TO_CHAR(123.456,'999') FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+------------------------+ -| TO_CHAR(123.456,'999') | -+------------------------+ -| 123 | -+---------------------- -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/9.TO_DATE.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/9.TO_DATE.md deleted file mode 100644 index 0845eeadc..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/6.conversion-functions/9.TO_DATE.md +++ /dev/null @@ -1,60 +0,0 @@ -TO_DATE -============================ - - - -`TO_DATE` 函数将 `CHAR`、`VARCHAR`、`NCHAR` 或 `NVARCHAR2` 数据类型的字符转换为日期数据类型的值。 - -语法 --------------- - -```javascript -TO_DATE(char [, fmt [, 'nlsparam' ] ]) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|----------|--------------------------------------------------------| -| char | `CHAR`、`VARCHAR`、`NCHAR` 或 `NVARCHAR2` 字符数据。 | -| fmt | 指定日期时间格式化。 | -| nlsparam | 由 `nls_territory` 初始化参数隐式指定或 `nls_date_format` 参数显式指定。 | - - - -返回类型 ----------------- - -返回 `DATE` 类型。 - -示例 --------------- - -执行以下语句: - -```javascript -SELECT TO_DATE('199912','YYYYMM'),TO_DATE('2000.05.20','YYYY.MM.DD'), -(DATE '2008-12-31') XXDATE, -TO_DATE('2008-12-31 12:31:30','YYYY-MM-DD HH24:MI:SS'), -(TIMESTAMP '2008-12-31 12:31:30') XXTIMESTAMP -FROM DUAL; -``` - - - -查询结果如下: - -```javascript -+----------------------------+------------------------------------+---------------------+------------------------------------------------------+-------------------------------+ -| TO_DATE('199912','YYYYMM') | TO_DATE('2000.05.20','YYYY.MM.DD') | XXDATE | TO_DATE('2008-12-3112:31:30','YYYY-MM-DDHH24:MI:SS') | XXTIMESTAMP | -+----------------------------+------------------------------------+---------------------+------------------------------------------------------+-------------------------------+ -| 1999-12-01 00:00:00 | 2000-05-20 00:00:00 | 2008-12-31 00:00:00 | 2008-12-31 12:31:30 | 2008-12-31 12:31:30.000000000 | -+----------------------------+------------------------------------+---------------------+------------------------------------------------------+-------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/7.encoding-and-decoding-functions/1.DECODE.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/7.encoding-and-decoding-functions/1.DECODE.md deleted file mode 100644 index e2430bc6c..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/7.encoding-and-decoding-functions/1.DECODE.md +++ /dev/null @@ -1,145 +0,0 @@ -DECODE -=========================== - - - -`DECODE` 函数依次用参数 `search` 与 `condition` 做比较,直至 `condition` 与 `search` 的值相等,则返回对应 `search` 后跟随的参数 `result` 的值。如果没有 `search` 与 `condition` 相等,则返回参数 `default` 的值。 - -语法 --------------- - -```javascript -DECODE (condition, search 1, result 1, search 2, result 2 ... search n, result n, default) -``` - - - -`DECODE` 函数的含义可以用 `IF...ELSE IF...END` 语句进行解释: - -```javascript -IF condition = search 1 THEN -RETURN(result 1) -ELSE IF condition = search 2 THEN -RETURN(result 2) -...... -ELSE IF condition = search n THEN -RETURN(result n) -ELSE -RETURN(default) -END IF -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|-----------------------------------------------------------|-----------------------------------------------------------------------------------------------------------| -| condition、search 1...search n、result 1...result n、default | 数值型(`NUMBER`、`FLOAT`、`BINARY_FLOAT` 或 `BINARY_DOUBLE`)或字符型( `CHAR`、`VARCHAR2`、`NCHAR` 或 `NVARCHAR2`)的表达式。 | - - -**注意** - - - -`search 1` \~ `search n` 不能为条件表达式,这种情况只能用 `CASE WHEN THEN END` 语句解决: - -```unknow -WHEN CASE condition = search 1 THEN -RETURN(result 1) -ELSE CASE condition = search 2 THEN -RETURN(result 2) -......   -ELSE CASE condition = search n THEN -RETURN(result n) -ELSE -RETURN(default) -END -``` - - - -示例 --------------- - -**示例 1:** 使用 `DECODE` 比较数值的大小。 - -以下语句使用 `DECODE` 函数来返回数值 10 与 20 当中较小的那个数。`SIGN()` 函数用来计算两个值差的符号,由于 10 小于 20,所以差为负数,`SIGN()` 返回 -1。此时 `DECODE` 函数将参数 -1 与 `SIGN()` 函数的返回值作比较。相等时,返回值 10,不相等时,返回值 20: - -```javascript -SELECT DECODE(SIGN(10-20),-1,10,20) FROM DUAL; -``` - - - -返回结果如下: - -```javascript -+------------------------------+ -| DECODE(SIGN(10-20),-1,10,20) | -+------------------------------+ -| 10 | -+------------------------------+ -``` - - - -**示例 2** :使用 `DECODE` 函数查看数据中是否包含字符 **S** 。 - -以下语句创建了表 **EMP** ,表中包含列 **ename** 和 **sal** ,并向其中插入值: - -```javascript -CREATE TABLE EMP(ename VARCHAR(30),sal NUMBER); -INSERT INTO EMP VALUES('CLARK', 2750); -INSERT INTO EMP VALUES('KING', 5300); -INSERT INTO EMP VALUES('MILLER', 1600); -INSERT INTO EMP VALUES('ADAMS', 1400); -INSERT INTO EMP VALUES('FORD', 3300); -INSERT INTO EMP VALUES('JONES', 3275); -INSERT INTO EMP VALUES('SCOTT', 3300); -INSERT INTO EMP VALUES('SMITH', 1100); -INSERT INTO EMP VALUES('ALLEN', 1900); -INSERT INTO EMP VALUES('BLAKE', 3150); -INSERT INTO EMP VALUES('JAMES', 1250); -INSERT INTO EMP VALUES('MARTIN', 1550); -INSERT INTO EMP VALUES('TURNER', 1800); -INSERT INTO EMP VALUES('WARD', 1550); -``` - - - -以下语句通过函数 `INSTR()` 返回字符 **S** 在列 **ename** 的值中出现的位置,若没有出现过则返回 0。此时 `DECODE` 函数将 `INSTR` 函数的返回值与 0 做比较,相等时说明字符 **S** 在值中没有出现过,则 `DECODE` 函数返回值 **不含有 S** ,否则返回值 **含有 S** : - -```javascript -SELECT ENAME, SAL, DECODE(INSTR(ename, 'S'), 0, '不含有 S', '含有 S') AS INFO FROM EMP; -``` - - - -查询结果如下: - -```javascript -+--------+------+------------+ -| ENAME | SAL | INFO | -+--------+------+------------+ -| CLARK | 2750 | 不含有 S | -| KING | 5300 | 不含有 S | -| MILLER | 1600 | 不含有 S | -| ADAMS | 1400 | 含有 S | -| FORD | 3300 | 不含有 S | -| JONES | 3275 | 含有 S | -| SCOTT | 3300 | 含有 S | -| SMITH | 1100 | 含有 S | -| ALLEN | 1900 | 不含有 S | -| BLAKE | 3150 | 不含有 S | -| JAMES | 1250 | 含有 S | -| MARTIN | 1550 | 不含有 S | -| TURNER | 1800 | 不含有 S | -| WARD | 1550 | 不含有 S | -+--------+------+------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/7.encoding-and-decoding-functions/2.ORA_HASH.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/7.encoding-and-decoding-functions/2.ORA_HASH.md deleted file mode 100644 index 6abbade7a..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/7.encoding-and-decoding-functions/2.ORA_HASH.md +++ /dev/null @@ -1,83 +0,0 @@ -ORA_HASH -============================= - - - -`ORA_HASH` 函数获取对应表达式的 HASH 值。 - -语法 --------------- - -```javascript -ORA_HASH(expr [, max_bucket [, seed_value ] ]) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|------------|--------------------------------------------------------------------------------------| -| expr | 通常为数据库表的列名,数据类型可以是数值类型、字符类型、日期时间类型 或 `RAW` 类型。 | -| max_bucket | 可选的 `max_bucket` 参数确定哈希函数返回的最大桶数。取值范围为 0\~4294967295,默认值是 4294967295。 | -| seed_value | 可选的 `seed_value` 参数使 OceanBase 能够为同一组数据产生许多不同的结果。 您可以指定 0\~4294967295 之间的任何值。默认值为 0。 | - - - -返回类型 ----------------- - -`NUMBER` 类型数据。 - -示例 --------------- - -创建表 **SALE** ,并向里面插入数据。执行以下语句: - -```javascript -CREATE TABLE SALE(MONTH CHAR(6), SELL NUMBER(10,2)); -INSERT INTO SALE VALUES(200001, 1000); -INSERT INTO SALE VALUES(200002, 1100); -INSERT INTO SALE VALUES(200003, 1200); -INSERT INTO SALE VALUES(200004, 1300); -INSERT INTO SALE VALUES(200005, 1400); -INSERT INTO SALE VALUES(200006, 1500); -INSERT INTO SALE VALUES(200007, 1600); -INSERT INTO SALE VALUES(200101, 1100); -INSERT INTO SALE VALUES(200202, 1200); -INSERT INTO SALE VALUES(200301, 1300); -``` - - - -使用 `ORA_HASH` 函数查询 **SALE** 表,并执行以下语句: - -```javascript -SELECT ORA_HASH(CONCAT(month,sell),12,0), month, sell FROM Sale; -``` - - - -查询结果如下: - -```javascript -+-----------------------------------+--------+------+ -| ORA_HASH(CONCAT(MONTH,SELL),12,0) | MONTH | SELL | -+-----------------------------------+--------+------+ -| 1 | 200001 | 1000 | -| 6 | 200002 | 1100 | -| 5 | 200003 | 1200 | -| 4 | 200004 | 1300 | -| 5 | 200005 | 1400 | -| 2 | 200006 | 1500 | -| 7 | 200007 | 1600 | -| 10 | 200101 | 1100 | -| 7 | 200202 | 1200 | -| 4 | 200301 | 1300 | -+-----------------------------------+--------+------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/7.encoding-and-decoding-functions/3.VSIZE.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/7.encoding-and-decoding-functions/3.VSIZE.md deleted file mode 100644 index 2087713f6..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/7.encoding-and-decoding-functions/3.VSIZE.md +++ /dev/null @@ -1,56 +0,0 @@ -VSIZE -========================== - - - -`VSIZE` 函数返回 `X` 的字节大小数。 - -语法 --------------- - -```javascript -VSIZE(X) -``` - - - -返回类型 ----------------- - -返回 x 的字节数,如果 x 为 `NULL`,则函数返回 `NULL`。 - -示例 --------------- - -创建 **employees** ,并向里面插入数据。执行以下语句: - -```javascript -CREATE TABLE employees(manager_id INT,last_name varchar(50),hiredate varchar(50),SALARY INT); -INSERT INTO employees VALUES(300, 'Wei', '2019-09-11',23600); -INSERT INTO employees VALUES(200, 'Red', '2019-11-05', 23800); -INSERT INTO employees VALUES(100, 'Part', '2018-10-01',24000); -INSERT INTO employees VALUES(200, 'Ross', '2019-06-11',23500); -COMMIT; -``` - - - -使用 `VSIZE` 函数查询 **last_name** 列中 **manager_id = 300** 的字节数。执行以下语句: - -```javascript -SELECT last_name, VSIZE (last_name) "BYTES" FROM employees WHERE manager_id = 300; -``` - - - -查询结果如下: - -```javascript -+-----------+-------+ -| LAST_NAME | BYTES | -+-----------+-------+ -| Wei | 3 | -+-----------+-------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/8.null-value-related-function/1.COALESCE.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/8.null-value-related-function/1.COALESCE.md deleted file mode 100644 index dfbb436f5..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/8.null-value-related-function/1.COALESCE.md +++ /dev/null @@ -1,78 +0,0 @@ -COALESCE -============================= - - - -`COALESCE` 函数返回参数列表中第一个非空表达式,必须指定最少两个参数。 - -语法 --------------- - -```javascript -COALESCE(expr1, expr2[,..., exprn]) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|-----------------------------|----------------| -| expr1, expr2\[,..., exprn\] | 非空表达式,且最少 2 个。 | - - - -返回类型 ----------------- - -返回参数列表中第一个非空表达式,如果所有的参数都是 `NULL`,则返回 `NULL`。 - -示例 --------------- - -假设有一张表 **product_information** , **product_id** 为商品 ID, **list_price** 为该商品原价, **min_price** 为商品最低价, **Sale** 为商品实际售价。设置商品折扣为 9 折,计算各商品的实际售价。此时可使用 `COALESCE` 函数,若 **list_price** 为空,就按最低价 **min_price** 计算;若 **min_price** 也为空,则按 **5** 计算。 - -您可以执行以下语句,建立 **product_information** 数据表,并插入数据: - -```javascript -CREATE TABLE product_information(supplier_id INT, product_id INT,list_price numeric, min_price numeric); -INSERT INTO PRODUCT_INFORMATION VALUES ('102050', '1659', '45', NULL); -INSERT INTO PRODUCT_INFORMATION VALUES ('102050', '1770', NULL, '70'); -INSERT INTO PRODUCT_INFORMATION VALUES ('102050', '2370', '305', '247'); -INSERT INTO PRODUCT_INFORMATION VALUES ('102050', '2380', '750', '731'); -INSERT INTO PRODUCT_INFORMATION VALUES ('102050', '3255', NULL, NULL); -``` - - - -执行以下查询语句: - -```javascript -SELECT product_id, list_price,min_price,COALESCE(0.9*list_price, min_price, 5) "Sale" -FROM product_information WHERE supplier_id = 102050 ORDER BY product_id; -``` - - - -查询结果如下: - -```javascript -+--------------+--------------+------------+--------+ -| PRODUCT_ID | LIST_PRICE | MIN_PRICE | Sale | -+--------------+--------------+------------+--------+ -| 1659 | 45 | | 40.5 | -+--------------+--------------+------------+--------+ -| 1770 | | 70 | 70 | -+--------------+--------------+------------+--------+ -| 2370 | 305 | 247 | 274.5 | -+--------------+--------------+------------+--------+ -| 2380 | 750 | 731 | 675 | -+--------------+--------------+------------+--------+ -| 3255 | | | 5 | -+--------------+--------------+------------+--------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/8.null-value-related-function/2.LNNVL.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/8.null-value-related-function/2.LNNVL.md deleted file mode 100644 index d620bef69..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/8.null-value-related-function/2.LNNVL.md +++ /dev/null @@ -1,102 +0,0 @@ -LNNVL -========================== - - - -`LNNVL` 函数判断条件中的一个或者两个操作数是否为 `NULL`。该函数可以在 `WHERE` 子句中使用,也可以作为 `CASE` 表达式中的 `WHEN` 条件。将条件作为参数,如果条件为 `FALSE` 或 `UNKNOWN`,则返回 `TRUE`;如果条件为 `TRUE`,则返回 `FALSE`。 - -语法 --------------- - -```javascript -LNNVL(condition) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|-----------|----| -| condition | 条件 | - - - -假设 a = 2,b 值为 **NULL** ,下表显示了 `LNNVL` 函数的返回值。 - - -| 条件 | 条件判断结果 | LNNVL 返回值 | -|-----------|---------|-----------| -| a = 1 | FALSE | TRUE | -| a = 2 | TRUE | FALSE | -| a IS NULL | FALSE | TRUE | -| b = 1 | UNKNOWN | TRUE | -| b IS NULL | TRUE | FALSE | -| a = b | UNKNOWN | TRUE | - - - -返回类型 ----------------- - -返回布尔型 `TRUE` 或 `FALSE`。 - -示例 --------------- - -假设有一张表 **EMPLOYEES** ,给员工姓名列 **name** 和佣金列 **commission_pct** 里面插入数据,执行以下语句: - -```javascript -CREATE TABLE EMPLOYEES (name VARCHAR(20), commission_pct numeric(10,2)); -INSERT INTO EMPLOYEEs VALUES ('Baer', null); -INSERT INTO EMPLOYEEs VALUES ('Bada', null); -INSERT INTO EMPLOYEEs VALUES ('Boll', 0.1); -INSERT INTO EMPLOYEEs VALUES ('Bates', 0.15); -INSERT INTO EMPLOYEEs VALUES ('Eros', null); -INSERT INTO EMPLOYEEs VALUES ('Girl', 0.25); -``` - - - -您想知道佣金率低于 20% 的员工人数,包括没有收到佣金的员工。执行以下语句,您只能查询实际获得佣金低于 20% 的员工人数: - -```javascript -SELECT COUNT(*) FROM employees WHERE commission_pct < .2; -``` - - - -查询结果如下: - -```javascript -+------------+ -| COUNT(*) | -+------------+ -| 2 | -+------------+ -``` - - - -要包括没有收到佣金的另外 3 名员工,您需要使用 `LNNVL` 函数重写查询。执行以下语句: - -```javascript -SELECT COUNT(*) FROM employees WHERE LNNVL(commission_pct >= .2); -``` - - - -查询结果如下: - -```javascript -+------------+ -| COUNT(*) | -+------------+ -| 5 | -+------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/8.null-value-related-function/3.NVL.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/8.null-value-related-function/3.NVL.md deleted file mode 100644 index a2c064f9a..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/8.null-value-related-function/3.NVL.md +++ /dev/null @@ -1,88 +0,0 @@ -NVL -======================== - - - -`NVL` 函数从两个表达式返回一个非 `NULL` 值。如果 `expr1` 与 `expr2` 的结果皆为 `NULL` 值,则 `NVL` 函数返回 `NULL`。 - -语法 --------------- - -```javascript -NVL(expr1, expr2) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|-------|----------------------------------------| -| expr1 | 表达式。数据类型可以是 OceanBase 内建数据类型 中的任何数据类型。 | -| expr2 | 表达式。数据类型可以是 OceanBase 内建数据类型中的任何数据类型。 | - - - -`expr1` 和 `expr2` 必须是相同类型,或者可以隐式转换为相同类型。如果它们不能隐式转换,则 OceanBase 返回错误。隐式转换实现如下: - -* 如果 `expr1` 是 `CHAR`、`NCHAR`、`NVARCHAR`、`VARCHAR2` 或 `VARCHAR` 字符型数据,则 OceanBase 在比较 `expr1` 之前将 `expr2` 转换为 `expr1` 的数据类型,并返回 `expr1` 字符集的 `VARCHAR2`。 - - - -* 如果 `expr1` 是 `NUMBER`、`FLOAT`、`BINARY_FLOAT` 或 `BINARY_DOUBLE` 数值型数据,则 OceanBase 确定哪个参数具有最高的数字优先级,隐式地将另一个参数转换为该数据类型,并返回该数据类型。 - - - - - - -返回类型 ----------------- - -如果 `expr1`、`expr2` 是 `NULL`,则返回 `NULL`。如果 `expr1` 是 `CHAR`、`NCHAR`、`NVARCHAR`、`VARCHAR2` 或 `VARCHAR` 字符型数据,则返回 `expr1` 字符集的 `VARCHAR2`。如果 `expr1` 是 `NUMBER`、`FLOAT`、`BINARY_FLOAT` 或 `BINARY_DOUBLE` 数值型数据,则返回 `expr1` 中具有最高数字优先级的数据类型。 - -示例 --------------- - -假设有一张表 **EMPLOYEES** ,给员工姓名列 **name** 和佣金列 **commission_pct** 里面插入数据,执行以下语句: - -```javascript -CREATE TABLE EMPLOYEES (name VARCHAR(20),commission_pct float(5)); -INSERT INTO EMPLOYEEs VALUES ('Baer', null); -INSERT INTO EMPLOYEEs VALUES ('Bada', null); -INSERT INTO EMPLOYEEs VALUES ('Boll', 0.1); -INSERT INTO EMPLOYEEs VALUES ('Bates', 0.15); -INSERT INTO EMPLOYEEs VALUES ('Eric', null); -``` - - - -查询员工的姓名和佣金,如果员工没有收到佣金,则显示 **Not Applicable** 。执行以下语句: - -```javascript -SELECT name, NVL(TO_CHAR(commission_pct), 'Not Applicable') commission -FROM employees WHERE name LIKE 'B%' ORDER BY name; -``` - - - -查询结果如下: - -```javascript -+--------------+----------------+ -| NAME | COMMISSION | -+--------------+----------------+ -| Baer | Not Applicable | -+--------------+----------------+ -| Bada | Not Applicable | -+--------------+----------------+ -| Boll | .1 | -+--------------+----------------+ -| Bates | .15 | -+--------------+----------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/8.null-value-related-function/4.NVL2.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/8.null-value-related-function/4.NVL2.md deleted file mode 100644 index 7752b2bcf..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/2.single-row-functions-1/8.null-value-related-function/4.NVL2.md +++ /dev/null @@ -1,88 +0,0 @@ -NVL2 -========================= - - - -`NVL2` 函数根据表达式是否为空,返回不同的值。如果 `expr1` 不为空,则返回 `expr2` 的值,如果 `expr1` 为空,则返回 `expr3` 的值。`expr2` 和 `expr3` 类型不同的话,`expr3` 会转换为 `expr1` 的类型。 - -语法 --------------- - -```javascript -NVL2(expr1, expr2, expr3) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|-------|----------------------------------------| -| expr1 | 表达式。数据类型可以是 OceanBase 内建数据类型 中的任何数据类型。 | -| expr2 | 表达式。数据类型可以是 OceanBase 内建数据类型中的任何数据类型。 | -| expr3 | 表达式。数据类型可以是 OceanBase 内建数据类型中的任何数据类型。 | - - - -如果 `expr2` 和 `expr3` 的数据类型不同,则 OceanBase 将其中一个隐式转换为另一个。 如果它们不能隐式转换,则数据库返回错误。 如果 `expr2` 是字符或数字数据,则隐式转换规则如下: - -* 如果 `expr2` 是 `CHAR`、`NCHAR`、`NVARCHAR`、`VARCHAR2` 或 `VARCHAR` 字符型数据,则 OceanBase 在返回值之前将 `expr3` 转换为 `expr2` 的数据类型,除非 `expr3` 是 `NULL`。 在这种情况下,不需要数据类型转换,数据库返回 `expr2` 字符集的 `VARCHAR2`。 - - - -* 如果 `expr2` 是 `NUMBER`、`FLOAT`、`BINARY_FLOAT` 或 `BINARY_DOUBL` 数值型数据,则 OceanBase 确定哪个参数具有最高的数值优先级,隐式地将另一个参数转换为该数据类型,并返回该数据类型。 - - - - - - -返回类型 ----------------------- - -如果 `expr1`、`expr2` 是 `NULL`,则返回 `NULL`。如果 `expr1` 是 `CHAR`、`NCHAR`、`NVARCHAR`、`VARCHAR2` 或 `VARCHAR` 字符型数据,则返回 `expr1` 字符集的 `VARCHAR2`。如果 `expr1` 是 `NUMBER`、`FLOAT`、`BINARY_FLOAT` 或 `BINARY_DOUBLE` 数值型数据,则返回 `expr1` 中具有最高数字优先级的数据类型。 - -示例 --------------- - -假设有一张表 **EMPLOYEES** ,给员工姓名列 **name** 、薪资列 **salary** 和佣金列 **commission_pct** 里面插入数据,执行以下语句: - -```javascript -CREATE TABLE EMPLOYEES (name VARCHAR(20),salary VARCHAR(20),commission_pct numeric(10,2)); -INSERT INTO EMPLOYEEs VALUES ('Baer', 10000, null); -INSERT INTO EMPLOYEEs VALUES ('Bada', 2800, null); -INSERT INTO EMPLOYEEs VALUES ('Boll', 5600, .25); -INSERT INTO EMPLOYEEs VALUES ('Bates', 7300, .39); -INSERT INTO EMPLOYEEs VALUES ('Broll', 4000, null); -``` - - - -使用 `NVL2` 函数查询员工的总收入。如果员工的 **commission_pct** 列不为空,则员工的收入为工资加佣金,否则,收入仅仅为工资。执行以下语句: - -```javascript -SELECT name, salary,NVL2(commission_pct, salary + (salary * commission_pct), salary) income -FROM employees WHERE name like 'B%' ORDER BY name; -``` - - - -查询结果如下: - -```javascript -+-------+--------+--------+ -| NAME | SALARY | INCOME | -+-------+--------+--------+ -| Bada | 2800 | 2800 | -| Baer | 10000 | 10000 | -| Bates | 7300 | 10147 | -| Boll | 5600 | 7000 | -| Broll | 4000 | 4000 | -+-------+--------+--------+ -5 rows in set (0.02 sec) -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/1.APPROX_COUNT_DISTINCT.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/1.APPROX_COUNT_DISTINCT.md deleted file mode 100644 index d0f1ea37c..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/1.APPROX_COUNT_DISTINCT.md +++ /dev/null @@ -1,84 +0,0 @@ -APPROX_COUNT_DISTINCT -========================================== - - - -`APPROX_COUNT_DISTINCT` 函数是聚合函数,它对某一列去重后的行数进行计算,结果只能返回一个值,且该值是近似值,该函数可以进一步用于计算被引用的列的选择性。 - -与函数 `COUNT(DISTINCT x)` 相比,`APPROX_COUNT_DISTINCT` 返回的是近似值,所以计算速度极快。在处理大量级的数据时 `COUNT(DISTINCT x)` 经常要花费很长的时间,使用 `APPROX_COUNT_DISTINCT` 牺牲了少量的精确度,却换来了计算效率的极大提升。 - -语法 --------------- - -```javascript -APPROX_COUNT_DISTINCT(expr) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|------|------| -| expr | 数值列。 | - - - -返回类型 ----------------- - -返回 `NUMBER` 类型数据。 - -示例 --------------- - -以下语句创建了表 **employees** ,并向里面插入数据: - -```javascript -CREATE TABLE employees (manager_id INT,last_name varchar(50),hiredate varchar(50),SALARY INT); -INSERT INTO employees VALUES(100, 'Raphaely', '2017-07-01', 1700); -INSERT INTO employees VALUES(100, 'De Haan', '2018-05-01',11000); -INSERT INTO employees VALUES(100, 'Errazuriz', '2017-07-21', 1400); -INSERT INTO employees VALUES(100, 'Hartstein', '2019-05-01',14000); -INSERT INTO employees VALUES(100, 'Raphaely', '2017-07-22', 1700); -INSERT INTO employees VALUES(100, 'Weiss', '2019-07-11',13500); -INSERT INTO employees VALUES(100, 'Russell', '2019-10-05', 13000); -INSERT INTO employees VALUES(100, 'Partners', '2018-12-01',14000); -INSERT INTO employees VALUES(200, 'Ross', '2019-06-11',13500); -INSERT INTO employees VALUES(200, 'Bell', '2019-05-25', 13000); -INSERT INTO employees VALUES(200, 'Part', '2018-08-11',14000); -COMMIT; -``` - - - -执行以下语句: - -```javascript -SELECT last_name, salary, APPROX_COUNT_DISTINCT(salary) OVER (ORDER BY hiredate) "Variance" -FROM employees WHERE manager_id = 100 ORDER BY last_name, salary, "Variance"; -``` - - - -查询结果如下: - -```javascript -+-----------+--------+----------+ -| LAST_NAME | SALARY | Variance | -+-----------+--------+----------+ -| De Haan | 11000 | 3 | -| Errazuriz | 1400 | 2 | -| Hartstein | 14000 | 4 | -| Partners | 14000 | 4 | -| Raphaely | 1700 | 1 | -| Raphaely | 1700 | 2 | -| Russell | 13000 | 6 | -| Weiss | 13500 | 5 | -+-----------+--------+----------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/10.STDDEV_POP.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/10.STDDEV_POP.md deleted file mode 100644 index 1a2ad8baf..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/10.STDDEV_POP.md +++ /dev/null @@ -1,118 +0,0 @@ -STDDEV_POP -=============================== - - - -`STDDEV_POP` 函数计算总体标准差。`STDDEV_POP` 函数将数值型数据作为参数,返回数值型数据。 -**注意** - - - -总体标准差是总体方差的算术平方根。 - -语法 --------------- - -```javascript -STDDEV_POP([ALL] expr) [ OVER (analytic_clause) ] -``` - - - -作为分析函数使用时,您需要使用窗口函数的完整语法,它对一组行的集合进行计算并返回多个值[](pt3avi)。作为聚合函数使用时,该函数对一组行的集合进行聚合计算,结果只能返回一个值,此时不需要加 `OVER` 关键字。 - -参数 --------------- - - - -| 参数 | 说明 | -|------|---------------------------------------------------------------| -| ALL | 全部数值列。 | -| OVER | 使用 `OVER` 子句定义窗口进行计算。 | -| expr | 是数值类型(`NUMBER`、`FLOAT`、`BINARY_FLOAT` 和 `BINARY_DOUBLE`)的表达式。 | - - - -返回类型 ----------------- - -返回类型与参数 `expr` 的数据类型相同。 - -示例 --------------- - -**分析函数示例** - -以下语句创建了表 **employees** ,并向里面插入数据: - -```javascript -CREATE TABLE employees (manager_id INT,last_name varchar(50),hiredate varchar(50),SALARY INT); -INSERT INTO employees VALUES(100, 'Raphaely', '2017-07-01', 1700); -INSERT INTO employees VALUES(100, 'De Haan', '2018-05-01',11000); -INSERT INTO employees VALUES(100, 'Errazuriz', '2017-07-21', 1400); -INSERT INTO employees VALUES(100, 'Hartstein', '2019-05-01',14000); -INSERT INTO employees VALUES(100, 'Raphaely', '2017-07-22', 1700); -INSERT INTO employees VALUES(100, 'Weiss', '2019-07-11',13500); -INSERT INTO employees VALUES(100, 'Russell', '2019-10-05', 13000); -INSERT INTO employees VALUES(100, 'Partners', '2018-12-01',14000); -INSERT INTO employees VALUES(200, 'Ross', '2019-06-11',13500); -INSERT INTO employees VALUES(200, 'Bell', '2019-05-25', 13000); -INSERT INTO employees VALUES(200, 'Part', '2018-08-11',14000); -COMMIT; -``` - - - -调用函数并执行以下语句: - -```javascript -SELECT manager_id, last_name, salary, STDDEV_POP(salary) OVER (PARTITION BY manager_id) AS pop_std -FROM employees ORDER BY manager_id, last_name, salary, pop_std; -``` - - - -查询结果如下: - -```javascript -+------------+-----------+--------+-------------------------------------------+ -| MANAGER_ID | LAST_NAME | SALARY | POP_STD | -+------------+-----------+--------+-------------------------------------------+ -| 100 | De Haan | 11000 | 5637.250548804798333699350384281939588505 | -| 100 | Errazuriz | 1400 | 5637.250548804798333699350384281939588505 | -| 100 | Hartstein | 14000 | 5637.250548804798333699350384281939588505 | -| 100 | Partners | 14000 | 5637.250548804798333699350384281939588505 | -| 100 | Raphaely | 1700 | 5637.250548804798333699350384281939588505 | -| 100 | Raphaely | 1700 | 5637.250548804798333699350384281939588505 | -| 100 | Russell | 13000 | 5637.250548804798333699350384281939588505 | -| 100 | Weiss | 13500 | 5637.250548804798333699350384281939588505 | -| 200 | Bell | 13000 | 408.248290463863016366214012450981899069 | -| 200 | Part | 14000 | 408.248290463863016366214012450981899069 | -| 200 | Ross | 13500 | 408.248290463863016366214012450981899069 | -+------------+-----------+--------+-------------------------------------------+ -``` - - - -**聚合函数示例** - -调用函数并执行以下语句: - -```javascript -SELECT STDDEV_POP(salary) FROM employees ; -``` - - - -查询结果如下: - -```javascript -+-------------------------------------------+ -| STDDEV_POP(SALARY) | -+-------------------------------------------+ -| 5249.950806538512715446505486136315088416 | -+-------------------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/11.STDDEV_SAMP.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/11.STDDEV_SAMP.md deleted file mode 100644 index 2f541ca33..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/11.STDDEV_SAMP.md +++ /dev/null @@ -1,119 +0,0 @@ -STDDEV_SAMP -================================ - - - -`STDDEV_SAMP` 函数计算样本标准差。`STDDEV_SAMP` 函数将数值型数据作为参数,返回数值型数据。它与函数 [STDDEV](lbfuea) 的不同之处在于,`STDDEV` 只有一行输入数据时返回 0,而 `STDDEV_SAMP` 返回 NULL。 -**说明** - - - -样本标准差是样本方差的算术平方根。 - -语法 --------------- - -```javascript -STDDEV_SAMP([ALL] expr) [ OVER (analytic_clause) ] -``` - - - -作为分析函数使用时,您需要使用窗口函数的完整语法,它对一组行的集合进行计算并返回多个值 。作为聚合函数使用时,该函数对一组行的集合进行聚合计算,结果只能返回一个值,此时不需要加 OVER 关键字。 - -参数 --------------- - - - -| 参数 | 说明 | -|------|--------------------------------------------------------------------------| -| ALL | 全部数值列。 | -| expr | 是数值类型(`NUMBER`、`FLOAT`、`BINARY_FLOAT` 和 `BINARY_DOUBLE`)或者可以转换成数值类型的表达式。 | -| OVER | 使用 `OVER` 子句定义窗口进行计算。 | - - - -返回类型 ----------------- - -返回类型与参数 `expr` 的数据类型相同。 - -示例 --------------- - -**分析函数示例** - -以下语句创建了表 **employees** ,并向里面插入数据: - -```javascript -CREATE TABLE employees (manager_id INT,last_name varchar(50),hiredate varchar(50),SALARY INT); -INSERT INTO employees VALUES(100, 'Raphaely', '2017-07-01', 1700); -INSERT INTO employees VALUES(100, 'De Haan', '2018-05-01',11000); -INSERT INTO employees VALUES(100, 'Errazuriz', '2017-07-21', 1400); -INSERT INTO employees VALUES(100, 'Hartstein', '2019-05-01',14000); -INSERT INTO employees VALUES(100, 'Raphaely', '2017-07-22', 1700); -INSERT INTO employees VALUES(100, 'Weiss', '2019-07-11',13500); -INSERT INTO employees VALUES(100, 'Russell', '2019-10-05', 13000); -INSERT INTO employees VALUES(100, 'Partners', '2018-12-01',14000); -INSERT INTO employees VALUES(200, 'Ross', '2019-06-11',13500); -INSERT INTO employees VALUES(200, 'Bell', '2019-05-25', 13000); -INSERT INTO employees VALUES(200, 'Part', '2018-08-11',14000); -COMMIT; -``` - - - -调用函数并执行以下语句: - -```javascript -SELECT manager_id, last_name, hiredate, salary,STDDEV_SAMP(salary) OVER (PARTITION BY manager_id -ORDER BY hiredate ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW) AS cum_sdev -FROM employees ORDER BY manager_id, last_name, hiredate, salary, cum_sdev; -``` - - - -返回结果如下: - -```javascript -+------------+-----------+------------+--------+-------------------------------------------+ -| MANAGER_ID | LAST_NAME | HIREDATE | SALARY | CUM_SDEV | -+------------+-----------+------------+--------+-------------------------------------------+ -| 100 | De Haan | 2018-05-01 | 11000 | 4702.127178203498995615489088200868644482 | -| 100 | Errazuriz | 2017-07-21 | 1400 | 212.132034355964257320253308631454711785 | -| 100 | Hartstein | 2019-05-01 | 14000 | 6340.346993658943269176828928801701088079 | -| 100 | Partners | 2018-12-01 | 14000 | 6064.899009876421676804205219406952308814 | -| 100 | Raphaely | 2017-07-01 | 1700 | NULL | -| 100 | Raphaely | 2017-07-22 | 1700 | 173.205080756887729352744634150587236694 | -| 100 | Russell | 2019-10-05 | 13000 | 6026.474330580265330900400184969999384459 | -| 100 | Weiss | 2019-07-11 | 13500 | 6244.311697171159907069428668980211861012 | -| 200 | Bell | 2019-05-25 | 13000 | 707.106781186547524400844362104849039285 | -| 200 | Part | 2018-08-11 | 14000 | NULL | -| 200 | Ross | 2019-06-11 | 13500 | 500 | -+------------+-----------+------------+--------+-------------------------------------------+ -``` - - - -**聚合函数示例** - -调用函数并执行以下语句: - -```javascript -SELECT STDDEV_SAMP(salary) FROM employees ; -``` - - - -查询结果如下: - -```javascript -+-------------------------------------------+ -| STDDEV_SAMP(SALARY) | -+-------------------------------------------+ -| 5506.194858355615640082358245403620332764 | -+-------------------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/12.SUM.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/12.SUM.md deleted file mode 100644 index 41fada3ec..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/12.SUM.md +++ /dev/null @@ -1,117 +0,0 @@ -SUM -======================== - - - -`SUM` 函数返回参数中指定列的和。此函数将可以隐式转换为数值数据类型的任何数值数据类型或任何非数值数据类型作为参数。 函数返回与参数的数值数据类型相同的数据类型。 - -语法 --------------- - -```javascript -SUM([ DISTINCT | UNQIUE | ALL ] expr) [ OVER (analytic_clause) ] -``` - - - -作为分析函数使用时,您需要使用窗口函数的完整语法,它对一组行的集合进行计算并返回多个值。作为聚合函数使用时,该函数对一组行的集合进行聚合计算,结果只能返回一个值,此时不需要加 `OVER` 关键字。 - -参数 --------------- - - - -| 参数 | 说明 | -|----------|---------------------------------------| -| DISTINCT | 去除重复行,且忽略值为 NULL 的行。 | -| UNQIUE | 去除重复行,且忽略值为 NULL 的行。 | -| ALL | 返回所有值,包含重复行,且忽略值为 NULL 的行。 | -| expr | 可为数值、字符、日期型或其它类型的数据列或表达式。 | -| OVER | 使用 `OVER` 子句定义窗口进行计算。 | - - -**注意** - -: - -如果您指定了`DISTINCT` 或 `UNIQUE` 关键字,则 `analytic_clause` 中不允许出现 `order_by_clause` 和 `windowing_clause`。 - -返回类型 ----------------- - -返回与 `expr` 相同数据类型的值。 - -示例 --------------- - -**分析函数示例** - -创建表 **employees** ,并向里面插入数据,执行以下语句: - -```javascript -CREATE TABLE employees(manager_id INT,last_name varchar(50),hiredate varchar(50),SALARY INT); -INSERT INTO employees VALUES(300, 'Wei', '2019-09-11',23600); -INSERT INTO employees VALUES(200, 'Red', '2019-11-05', 23800); -INSERT INTO employees VALUES(100, 'Part', '2018-10-01',24000); -INSERT INTO employees VALUES(200, 'Ross', '2019-06-11',23500); -INSERT INTO employees VALUES(200, 'Bell', '2019-05-25', 23000); -INSERT INTO employees VALUES(200, 'Part', '2018-06-11',24500); -INSERT INTO employees VALUES(100, 'De Haan', '2018-05-01',11000); -INSERT INTO employees VALUES(100, 'Errazuriz', '2017-07-21', 1400); -INSERT INTO employees VALUES(100, 'Hartstein', '2019-05-01',14000); -COMMIT; -``` - - - -计算工资总额,执行以下语句: - -```javascript -SELECT manager_id, last_name, salary, SUM(salary) OVER (PARTITION BY manager_id -ORDER BY salary RANGE UNBOUNDED PRECEDING) l_csum -FROM employees ORDER BY manager_id, last_name, salary, l_csum; -``` - - - -查询结果如下: - -```javascript -+------------+-----------+--------+--------+ -| MANAGER_ID | LAST_NAME | SALARY | L_CSUM | -+------------+-----------+--------+--------+ -| 100 | De Haan | 11000 | 12400 | -| 100 | Errazuriz | 1400 | 1400 | -| 100 | Hartstein | 14000 | 26400 | -| 100 | Part | 24000 | 50400 | -| 200 | Bell | 23000 | 23000 | -| 200 | Part | 24500 | 94800 | -| 200 | Red | 23800 | 70300 | -| 200 | Ross | 23500 | 46500 | -| 300 | Wei | 23600 | 23600 | -+------------+-----------+--------+--------+ -``` - - - -**聚合函数示例** - -计算工资总额,执行以下语句: - -```javascript -SELECT SUM(salary) FROM employees; -``` - - - -查询结果如下: - -```javascript -+-------------+ -| SUM(SALARY) | -+-------------+ -| 168800 | -+-------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/13.VARIANCE.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/13.VARIANCE.md deleted file mode 100644 index a63d88e9a..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/13.VARIANCE.md +++ /dev/null @@ -1,117 +0,0 @@ -VARIANCE -============================= - - - -`VARIANCE` 函数返回参数指定列的方差。 - -语法 --------------- - -```javascript -VARIANCE([ DISTINCT | UNIQUE | ALL ] expr) [ OVER (analytic_clause) ] -``` - - - -作为分析函数使用时,您需要使用窗口函数的完整语法,它对一组行的集合进行计算并返回多个值。作为聚合函数使用时,该函数对一组行的集合进行聚合计算,结果只能返回一个值,此时不需要加 `OVER` 关键字。 - -参数 --------------- - - - -| 参数 | 说明 | -|----------|----------------------------------------| -| DISTINCT | 查询时去除列中的重复值,且忽略列中的 NULL 值。 | -| UNIQUE | 查询时去除列中的重复值,且忽略列中的 NULL 值。 | -| ALL | 查询时不去除列中的重复值,且忽略列中的 NULL 值。`ALL` 为默认值。 | -| expr | 可为数值、字符、日期型或其它类型的数据列或表达式。 | -| OVER | 使用 `OVER` 子句定义窗口进行计算。 | - - -**注意** - - - -如果您指定了 `DISTINCT` 或 `UNIQUE` 关键字,则 `analytic_clause` 中不允许出现 `order_by_clause` 和 `windowing_clause`。 - -返回类型 ----------------- - -返回 `NUMBER` 类型数据。 - -示例 --------------- - -**分析函数示例** - -以下语句创建了表 **employees** ,并向里面插入数据: - -```javascript -CREATE TABLE employees (manager_id INT,last_name varchar(50),hiredate varchar(50),SALARY INT); -INSERT INTO employees VALUES(100, 'Raphaely', '2017-07-01', 1700); -INSERT INTO employees VALUES(100, 'De Haan', '2018-05-01',11000); -INSERT INTO employees VALUES(100, 'Errazuriz', '2017-07-21', 1400); -INSERT INTO employees VALUES(100, 'Hartstein', '2019-05-01',14000); -INSERT INTO employees VALUES(100, 'Raphaely', '2017-07-22', 1700); -INSERT INTO employees VALUES(100, 'Weiss', '2019-07-11',13500); -INSERT INTO employees VALUES(100, 'Russell', '2019-10-05', 13000); -INSERT INTO employees VALUES(100, 'Partners', '2018-12-01',14000); -INSERT INTO employees VALUES(200, 'Ross', '2019-06-11',13500); -INSERT INTO employees VALUES(200, 'Bell', '2019-05-25', 13000); -INSERT INTO employees VALUES(200, 'Part', '2018-08-11',14000); -COMMIT; -``` - - - -执行以下语句计算列 **salary** 的方差: - -```javascript -SELECT last_name, salary, VARIANCE(salary) OVER (ORDER BY hiredate) "Variance" -FROM employees WHERE manager_id = 100 ORDER BY last_name, salary, "Variance"; -``` - - - -查询结果如下: - -```javascript -+-----------+--------+-------------------------------------------+ -| LAST_NAME | SALARY | Variance | -+-----------+--------+-------------------------------------------+ -| De Haan | 11000 | 22110000 | -| Errazuriz | 1400 | 45000 | -| Hartstein | 14000 | 40200000 | -| Partners | 14000 | 36783000 | -| Raphaely | 1700 | 0 | -| Raphaely | 1700 | 30000 | -| Russell | 13000 | 36318392.85714285714285714285714285714286 | -| Weiss | 13500 | 38991428.57142857142857142857142857142857 | -+-----------+--------+-------------------------------------------+ -``` - - - -**聚合函数示例** - -执行以下语句计算列 **salary** 的方差: - -```javascript -SELECT VARIANCE(salary) FROM employees; -``` - - - -查询结果如下: - -```javascript -+-----------------------------------------+ -| VARIANCE(SALARY) | -+-----------------------------------------+ -| 30318181.818181818181818181818181818182 | -+-----------------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/14.wmsys-wm_concat-and-wm_concat.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/14.wmsys-wm_concat-and-wm_concat.md deleted file mode 100644 index 08dc0589d..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/14.wmsys-wm_concat-and-wm_concat.md +++ /dev/null @@ -1,126 +0,0 @@ -WMSYS.WM_CONCAT/WM_CONCAT -============================================== - - - -`WM_CONCAT` 函数用于列转行,将度量列的值进行合并。作为单个集合的聚合函数,`WM_CONCAT` 对所有行进行操作并返回单个输出行。作为组集聚合,`WM_CONCAT` 将对 `GROUP BY` 子句定义的每个组进行操作并返回输出行。作为分析函数,`WM_CONCAT` 基于 `query_partition_clause` 中的一个或多个表达式将查询结果集分为几组。 - -语法 --------------- - -```javascript -WM_CONCAT ([DISTINCT] measure_expr) [OVER query_partition_clause] -``` - - - -作为分析函数使用时,您需要使用窗口函数的完整语法,它对一组行的集合进行计算并返回多个值。作为聚合函数使用时,该函数对一组行的集合进行聚合计算,结果只能返回一个值,此时不需要加 `OVER` 关键字。 - -参数 --------------- - - - -| 参数 | 说明 | -|--------------|-----------------------------| -| OVER | 使用 `OVER` 子句定义窗口进行计算。 | -| measure_expr | 可以是任何表达式。度量列中的空值将被忽略。 | -| DISTINCT | 如果指定 DISTINCT,会在返回结果中删除重复值。 | - - - -返回类型 ----------------- - -返回的数据类型为 `CLOB`。 - -示例 --------------- - -**分析函数示例** - -建表 **employees** ,并向里面插入数据,执行以下语句: - -```javascript -CREATE TABLE employees (department_id INT,manager_id INT,last_name varchar(50),hiredate varchar(50),SALARY INT); -INSERT INTO employees VALUES(30, 100, 'Raphaely', '2017-07-01', 1700); -INSERT INTO employees VALUES(30, 100, 'De Haan', '2018-05-01',11000); -INSERT INTO employees VALUES(40, 100, 'Errazuriz', '2017-07-21', 1400); -INSERT INTO employees VALUES(50, 100, 'Hartstein', '2019-05-01',14000); -INSERT INTO employees VALUES(50, 100, 'Raphaely', '2017-07-22', 1700); -INSERT INTO employees VALUES(70, 100, 'Weiss', '2019-07-11',13500); -INSERT INTO employees VALUES(90, 100, 'Russell', '2019-10-05', 13000); -INSERT INTO employees VALUES(90,100, 'Partners', '2018-12-01',14000); -``` - - - -查询 2019 年 10 月 10 日之前雇用的雇员,以及该雇员的部门,雇用日期以及该部门中的其他雇员。执行以下语句: - -```javascript -SELECT department_id "Dept", hiredate "Date", last_name "Name",wmsys.wm_concat(last_name) - OVER (PARTITION BY department_id) as "Emp_list" -FROM employees WHERE hiredate < '2019-10-10' ORDER BY "Dept", "Date", "Name"; -``` - - - -查询结果如下: - -```javascript -+------+------------+-----------+--------------------+ -| Dept | Date | Name | Emp_list | -+------+------------+-----------+--------------------+ -| 30 | 2017-07-01 | Raphaely | Raphaely,De Haan | -| 30 | 2018-05-01 | De Haan | Raphaely,De Haan | -| 40 | 2017-07-21 | Errazuriz | Errazuriz | -| 50 | 2017-07-22 | Raphaely | Hartstein,Raphaely | -| 50 | 2019-05-01 | Hartstein | Hartstein,Raphaely | -| 70 | 2019-07-11 | Weiss | Weiss | -| 90 | 2018-12-01 | Partners | Russell,Partners | -| 90 | 2019-10-05 | Russell | Russell,Partners | -+------+------------+-----------+--------------------+ -8 rows in set (0.01 sec) -``` - - - -**聚合函数示例** - -建表 **employees** ,并向里面插入数据,执行以下语句: - -```javascript -CREATE TABLE employees (department_id INT,manager_id INT,last_name varchar(50),hiredate varchar(50),SALARY INT); -INSERT INTO employees VALUES(30, 100, 'Raphaely', '2017-07-01', 1700); -INSERT INTO employees VALUES(30, 100, 'De Haan', '2018-05-01',11000); -INSERT INTO employees VALUES(30, 100, 'Errazuriz', '2017-07-01', 1400); -INSERT INTO employees VALUES(30, 100, 'Hartstein', '2019-05-01',14000); -INSERT INTO employees VALUES(30, 100, 'Raphaely', '2017-07-01', 1700); -INSERT INTO employees VALUES(30, 100, 'Weiss', '2019-07-01',13500); -INSERT INTO employees VALUES(30, 100, 'Russell', '2019-07-01', 13000); -INSERT INTO employees VALUES(30,100, 'Partners', '2018-12-01',14000); -``` - - - -查询第 30 部门的所有员工,并查找最早的雇用日期。执行以下语句: - -```javascript -SELECT wmsys.wm_concat(last_name) as "Emp_list", MIN(hiredate) as "Earliest" -FROM employees WHERE department_id = 30; -``` - - - -查询结果如下: - -```javascript -+----------------------------------------------------------------------+------------+ -| Emp_list | Earliest | -+----------------------------------------------------------------------+------------+ -| Raphaely,De Haan,Errazuriz,Hartstein,Raphaely,Weiss,Russell,Partners | 2017-07-01 | -+----------------------------------------------------------------------+------------+ -1 row in set (0.01 sec) -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/2.AVG.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/2.AVG.md deleted file mode 100644 index b3689269a..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/2.AVG.md +++ /dev/null @@ -1,119 +0,0 @@ -AVG -======================== - - - -`AVG` 函数返回数值列的平均值。 - -语法 --------------- - -```javascript -AVG([ DISTINCT | UNIQUE | ALL ] expr) [ OVER (analytic_clause) ] -``` - - - -作为分析函数使用时,您需要使用窗口函数的完整语法,它对一组行的集合进行计算并返回多个值。作为聚合函数使用时,该函数对一组行的集合进行聚合计算,结果只能返回一个值,此时不需要加 `OVER` 关键字。 - -参数 --------------- - - - -| 参数 | 说明 | -|----------|---------------------------------------------------------------------------------| -| DISTINCT | 查询时去除数据中的重复值,且忽略数据中的 NULL 值。 | -| UNIQUE | 查询时去除数据中的重复值,且忽略数据中的 NULL 值。 | -| ALL | 查询时不去除数据中的重复值,且忽略数据中的 NULL 值。`ALL` 为默认值。 | -| expr | 是数值类型或者可以转换成数值类型的表达式。数值类型可以为:`NUMBER`、`FLOAT`、`BINARY_FLOAT` 或 `BINARY_DOUBLE`。 | -| OVER | 使用 `OVER` 子句定义窗口进行计算。 | - - -**注意** - - - -如果您指定了 `DISTINCT` 或 `UNIQUE` 关键字,则 `analytic_clause` 中不允许出现 `order_by_clause` 和 `windowing_clause`。 - -返回类型 ----------------- - -返回类型与参数 `expr` 的数据类型相同。 - -示例 --------------- - -**分析函数示例** - -以下语句创建了表 **employees** ,并向里面插入数据: - -```javascript -CREATE TABLE employees (manager_id INT, last_name varchar(50), hiredate varchar(50), SALARY INT); -INSERT INTO employees VALUES(100, 'De Haan', '2018-05-01',11000); -INSERT INTO employees VALUES(100, 'Errazuriz', '2017-07-21', 1400); -INSERT INTO employees VALUES(100, 'Hartstein', '2019-05-01',14000); -INSERT INTO employees VALUES(100, 'Raphaely', '2017-07-22', 1700); -INSERT INTO employees VALUES(100, 'Weiss', '2019-07-11',13500); -INSERT INTO employees VALUES(100, 'Russell', '2019-10-05', 13000); -INSERT INTO employees VALUES(100, 'Partners', '2018-12-01',14000); -INSERT INTO employees VALUES(200, 'Ross', '2019-06-11',13500); -INSERT INTO employees VALUES(200, 'Bell', '2019-05-25', 13000); -INSERT INTO employees VALUES(200, 'Part', '2018-08-11',14000); -COMMIT; -``` - - - -执行以下语句计算各列的平均值: - -```javascript -SELECT manager_id, last_name, hiredate, salary, AVG(salary) OVER (PARTITION BY manager_id -ORDER BY hiredate ROWS BETWEEN 1 PRECEDING AND 1 FOLLOWING) AS c_mavg -FROM employees ORDER BY manager_id, hiredate, salary; -``` - - - -返回结果如下: - -```javascript -+------------+-----------+------------+--------+------------------------------------------+ -| MANAGER_ID | LAST_NAME | HIREDATE | SALARY | C_MAVG | -+------------+-----------+------------+--------+------------------------------------------+ -| 100 | Errazuriz | 2017-07-21 | 1400 | 1550 | -| 100 | Raphaely | 2017-07-22 | 1700 | 4700 | -| 100 | De Haan | 2018-05-01 | 11000 | 8900 | -| 100 | Partners | 2018-12-01 | 14000 | 13000 | -| 100 | Hartstein | 2019-05-01 | 14000 | 13833.333 | -| 100 | Weiss | 2019-07-11 | 13500 | 13500 | -| 100 | Russell | 2019-10-05 | 13000 | 13250 | -| 200 | Part | 2018-08-11 | 14000 | 13500 | -| 200 | Bell | 2019-05-25 | 13000 | 13500 | -| 200 | Ross | 2019-06-11 | 13500 | 13250 | -+------------+-----------+------------+--------+------------------------------------------+ -``` - - - -**聚合函数示例** - -执行以下语句计算 **salary** 的平均值: - -```javascript -SELECT AVG(salary) FROM employees; -``` - - - -查询结果如下: - -```javascript -+-------------+ -| AVG(SALARY) | -+-------------+ -| 10910 | -+-------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/3.COUNT.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/3.COUNT.md deleted file mode 100644 index 281d087d6..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/3.COUNT.md +++ /dev/null @@ -1,163 +0,0 @@ -COUNT -========================== - - - -`COUNT` 函数用于查询 `expr` 的行数。 - -语法 --------------- - -```javascript -COUNT({ * | [ DISTINCT | UNIQUE | ALL ] expr }) [ OVER (analytic_clause) ] -``` - - - -作为分析函数使用时,您需要使用窗口函数的完整语法,它对一组行的集合进行计算并返回多个值 。作为聚合函数使用时,该函数对一组行的集合进行聚合计算,结果只能返回一个值,此时不需要加 `OVER` 关键字。 - -参数 --------------- - - - -| 参数 | 说明 | -|----------|---------------------------------------------------------------------------------| -| \* | 表示满足条件的所有行,且包含值为 NULL 的行。 | -| DISTINCT | 返回的行中去除重复行,且忽略值为 NULL 的行。 | -| UNIQUE | 返回的行中去除重复行,且忽略值为 NULL 的行。 | -| ALL | 返回所有值,包含重复行,且忽略值为 NULL 的行。 | -| expr | 是数值类型或者可以转换成数值类型的表达式。数值类型可以为:`NUMBER`、`FLOAT`、`BINARY_FLOAT` 或 `BINARY_DOUBLE`。 | -| OVER | 使用 OVER 子句定义窗口进行计算。 | - - -**注意** - - - -* 对于 `COUNT` 函数,从不返回 `NULL`,如果指定了 `expr`,即返回 `expr` 不为 `NULL` 的统计个数,如果指定 `COUNT(*)` 返回所有行的统计数目。使用参数 `DISTINCT` 、`UNIQUE` 或 `ALL` 时需要与 `expr` 用空格隔开。 - - - -* 如果您指定了 `DISTINCT` 或 `UNIQUE` 关键字,则 `analytic_clause` 中不允许出现 `order_by_clause` 和 `windowing_clause`。 - - - - - - -返回类型 ----------------- - -返回类型与参数 `expr` 的数据类型相同。 - -示例 --------------- - -以下语句创建了表 **employees** ,并向里面插入数据: - -```javascript -CREATE TABLE employees(manager_id INT,last_name varchar(50),hiredate varchar(50),SALARY INT); -INSERT INTO employees VALUES(300, 'Wei', '2019-09-11',23600); -INSERT INTO employees VALUES(200, 'Red', '2019-11-05', 23800); -INSERT INTO employees VALUES(100, 'Part', '2018-10-01',24000); -INSERT INTO employees VALUES(200, 'Ross', '2019-06-11',23500); -INSERT INTO employees VALUES(200, 'Bell', '2019-05-25', 23000); -INSERT INTO employees VALUES(200, 'Part', '2018-06-11',24500); -INSERT INTO employees VALUES(100, 'De Haan', '2018-05-01',11000); -INSERT INTO employees VALUES(100, 'Errazuriz', '2017-07-21', 1400); -INSERT INTO employees VALUES(100, 'Hartstein', '2019-05-01',14000); -COMMIT; -``` - - - -**分析函数示例** - -执行以下语句查询表中的行数: - -```javascript -SELECT last_name, salary,COUNT(*) OVER (ORDER BY salary RANGE BETWEEN 50 PRECEDING -AND 150 FOLLOWING) AS mov_count FROM employees ORDER BY salary, last_name; -``` - - - -查询结果如下: - -```javascript -+-----------+--------+-----------+ -| LAST_NAME | SALARY | MOV_COUNT | -+-----------+--------+-----------+ -| Errazuriz | 1400 | 1 | -| De Haan | 11000 | 1 | -| Hartstein | 14000 | 1 | -| Bell | 23000 | 1 | -| Ross | 23500 | 2 | -| Wei | 23600 | 1 | -| Red | 23800 | 1 | -| Part | 24000 | 1 | -| Part | 24500 | 1 | -+-----------+--------+-----------+ -``` - - - -**聚合函数示例** - -创建表 **a** ,并向里面插入数据。执行以下语句: - -```javascript -CREATE TABLE a ( -b INT -); -INSERT INTO a VALUES (1); -INSERT INTO a VALUES (null); -INSERT INTO a VALUES (null); -INSERT INTO a VALUES (1); -INSERT INTO a VALUES (null); -INSERT INTO a VALUES (1); -INSERT INTO a VALUES (1); -``` - - - -返回表 **a** 值不为 NULL 的统计个数,执行以下语句: - -```javascript -SELECT COUNT(b) FROM a; -``` - - - -查询结果如下: - -```javascript -+----------+ -| COUNT(B) | -+----------+ -| 4 | -+----------+ -``` - - - -指定 `COUNT(*)` 返回所有行的统计数目,执行以下语句: - -```javascript -SELECT COUNT(*) FROM a; -``` - - - -查询结果如下: - -```javascript -+----------+ -| COUNT(*) | -+----------+ -| 7 | -+----------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/4.KEEP.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/4.KEEP.md deleted file mode 100644 index 5b2671732..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/4.KEEP.md +++ /dev/null @@ -1,134 +0,0 @@ -KEEP -========================= - - - -`KEEP` 函数用于对一组行中的值进行操作,将这组行按照给定的排序规则排序后返回排在第一或最后的值。作为聚合函数,`KEEP` 对所有行进行操作并返回单个输出行。作为分析函数,`KEEP` 基于 `query_partition_clause` 中的一个或多个表达式将查询结果集分为几组。 - -`KEEP` 函数必须与 `MIN`、`MAX`、`SUM`、`AVG`、`COUNT`、`VARIANCE` 或 `STDDEV` 函数一起使用。 - -语法 --------------- - -```javascript -KEEP (DENSE_RANK {FIRST | LAST} ORDER BY expr [ DESC | ASC ] [ NULLS { FIRST | LAST } ] [, expr [ DESC | ASC ] [ NULLS { FIRST | LAST } ]]... ) -[ OVER ( [query_partition_clause] ) ] -``` - - - -作为分析函数使用时,您需要使用窗口函数的完整语法,它对一组行的集合进行计算并返回多个值。作为聚合函数使用时,该函数对一组行的集合进行聚合计算,结果只能返回一个值,此时不需要加 `OVER` 关键字。 - -参数 --------------- - - - -| 参数 | 说明 | -|------|-----------------------| -| OVER | 使用 `OVER` 子句定义窗口进行计算。 | -| expr | 可以是任何表达式。度量列中的空值将被忽略。 | - - - -返回类型 ----------------- - -返回与度量列相同的数据类型。 - -示例 --------------- - -**分析函数示例** - -建表 **employees** ,并向里面插入数据,执行以下语句: - -```javascript -CREATE TABLE employees (department_id INT,manager_id INT,last_name varchar(50),hiredate varchar(50),SALARY INT); -INSERT INTO employees VALUES(30, 100, 'Raphaely', '2017-07-01', 1700); -INSERT INTO employees VALUES(30, 100, 'De Haan', '2018-05-01',11000); -INSERT INTO employees VALUES(40, 100, 'Errazuriz', '2017-07-21', 1400); -INSERT INTO employees VALUES(50, 100, 'Hartstein', '2019-10-05',14000); -INSERT INTO employees VALUES(50, 100, 'Raphaely', '2017-07-22', 1700); -INSERT INTO employees VALUES(50, 100, 'Weiss', '2019-10-05',13500); -INSERT INTO employees VALUES(90, 100, 'Russell', '2019-07-11', 13000); -INSERT INTO employees VALUES(90,100, 'Partners', '2018-12-01',14000); -``` - - - -对于每个部门:按照薪水排序,对排在第一的员工的薪水求和;按照雇用日期排序,对排在最后的员工的薪水求和。执行以下语句: - -```javascript -SELECT last_name, department_id, salary, - SUM(salary) KEEP (DENSE_RANK FIRST ORDER BY salary) - OVER (PARTITION BY department_id) "Worst", - SUM(salary) KEEP (DENSE_RANK LAST ORDER BY HIREDATE) - OVER (PARTITION BY department_id) "Best" - FROM employees - ORDER BY department_id, salary, last_name; -``` - - - -查询结果如下: - -```javascript -+-----------+---------------+--------+-------+-------+ -| LAST_NAME | DEPARTMENT_ID | SALARY | Worst | Best | -+-----------+---------------+--------+-------+-------+ -| Raphaely | 30 | 1700 | 1700 | 11000 | -| De Haan | 30 | 11000 | 1700 | 11000 | -| Errazuriz | 40 | 1400 | 1400 | 1400 | -| Raphaely | 50 | 1700 | 1700 | 27500 | -| Weiss | 50 | 13500 | 1700 | 27500 | -| Hartstein | 50 | 14000 | 1700 | 27500 | -| Russell | 90 | 13000 | 13000 | 13000 | -| Partners | 90 | 14000 | 13000 | 13000 | -+-----------+---------------+--------+-------+-------+ -8 rows in set (0.01 sec) -``` - - - -**聚合函数示例** - -建表 **employees** ,并向里面插入数据,执行以下语句: - -```javascript -CREATE TABLE employees (department_id INT,manager_id INT,last_name varchar(50),hiredate varchar(50),SALARY INT); -INSERT INTO employees VALUES(30, 100, 'Raphaely', '2017-07-01', 1700); -INSERT INTO employees VALUES(30, 100, 'De Haan', '2018-05-01',11000); -INSERT INTO employees VALUES(40, 100, 'Errazuriz', '2017-07-21', 1400); -INSERT INTO employees VALUES(50, 100, 'Hartstein', '2019-10-05',14000); -INSERT INTO employees VALUES(50, 100, 'Raphaely', '2017-07-22', 1700); -INSERT INTO employees VALUES(50, 100, 'Weiss', '2019-10-05',13500); -INSERT INTO employees VALUES(90, 100, 'Russell', '2019-07-11', 13000); -INSERT INTO employees VALUES(90,100, 'Partners', '2018-12-01',14000); -``` - - - -按照薪水排序,对排在第一的员工的薪水求和;按照雇用日期排序,对排在最后的员工的薪水求和。执行以下语句: - -```javascript -SELECT - SUM(salary) KEEP (DENSE_RANK FIRST ORDER BY salary) "Worst", - SUM(salary) KEEP (DENSE_RANK LAST ORDER BY HIREDATE) "Best" - FROM employees; -``` - - - -查询结果如下: - -```javascript -+-------+-------+ -| Worst | Best | -+-------+-------+ -| 1400 | 27500 | -+-------+-------+ -1 row in set (0.00 sec) -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/5.LISTAGG.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/5.LISTAGG.md deleted file mode 100644 index e304f0329..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/5.LISTAGG.md +++ /dev/null @@ -1,125 +0,0 @@ -LISTAGG -============================ - - - -`LISTAGG` 函数用于列转行,`LISTAGG` 对 `ORDER BY` 子句中指定的每个组内的数据进行排序,然后合并度量列的值。作为单个集合的聚合函数,`LISTAGG` 对所有行进行操作并返回单个输出行。作为组集聚合,`LISTAGG` 将对 `GROUP BY` 子句定义的每个组进行操作并返回输出行。作为分析函数,`LISTAGG` 基于 `query_partition_clause` 中的一个或多个表达式将查询结果集分为几组。 - -语法 --------------- - -```javascript -LISTAGG (measure_expr [,'delimiter']) [ WITHIN GROUP ] (order_by_clause) -[OVER query_partition_clause] -``` - - - -作为分析函数使用时,您需要使用窗口函数的完整语法,它对一组行的集合进行计算并返回多个值。作为聚合函数使用时,该函数对一组行的集合进行聚合计算,结果只能返回一个值,此时不需要加 `OVER` 关键字。 - -参数 --------------- - - - -| 参数 | 说明 | -|--------------|---------------------------------| -| OVER | 使用 `OVER` 子句定义窗口进行计算。 | -| measure_expr | 可以是任何表达式。度量列中的空值将被忽略。 | -| delimiter | 指定用于分隔度量值的字符串。此子句是可选的,默认为 NULL。 | - - - -返回类型 ----------------- - -如果度量列是 `RAW` 的,则返回数据类型为 `RAW`,否则返回值为 `VARCHAR2` 型。 - -示例 --------------- - -**分析函数示例** - -建表 **employees** ,并向里面插入数据,执行以下语句: - -```javascript -CREATE TABLE employees (department_id INT,manager_id INT,last_name varchar(50),hiredate varchar(50),SALARY INT); -INSERT INTO employees VALUES(30, 100, 'Raphaely', '2017-07-01', 1700); -INSERT INTO employees VALUES(30, 100, 'De Haan', '2018-05-01',11000); -INSERT INTO employees VALUES(40, 100, 'Errazuriz', '2017-07-21', 1400); -INSERT INTO employees VALUES(50, 100, 'Hartstein', '2019-05-01',14000); -INSERT INTO employees VALUES(50, 100, 'Raphaely', '2017-07-22', 1700); -INSERT INTO employees VALUES(70, 100, 'Weiss', '2019-07-11',13500); -INSERT INTO employees VALUES(90, 100, 'Russell', '2019-10-05', 13000); -INSERT INTO employees VALUES(90,100, 'Partners', '2018-12-01',14000); -``` - - - -查询 2019 年 10 月 10 日之前雇用的雇员,以及该雇员的部门,雇用日期以及该部门中的其他雇员。执行以下语句: - -```javascript -SELECT department_id "Dept", hiredate "Date", last_name "Name",LISTAGG(last_name, '; ') WITHIN GROUP -(ORDER BY hiredate, last_name) OVER (PARTITION BY department_id) as "Emp_list" -FROM employees WHERE hiredate < '2019-10-10' ORDER BY "Dept", "Date", "Name"; -``` - - - -查询结果如下: - -```javascript -+------+------------+-----------+---------------------+ -| Dept | Date | Name | Emp_list | -+------+------------+-----------+---------------------+ -| 30 | 2017-07-01 | Raphaely | Raphaely; De Haan | -| 30 | 2018-05-01 | De Haan | Raphaely; De Haan | -| 40 | 2017-07-21 | Errazuriz | Errazuriz | -| 50 | 2017-07-22 | Raphaely | Raphaely; Hartstein | -| 50 | 2019-05-01 | Hartstein | Raphaely; Hartstein | -| 70 | 2019-07-11 | Weiss | Weiss | -| 90 | 2018-12-01 | Partners | Partners; Russell | -| 90 | 2019-10-05 | Russell | Partners; Russell | -+------+------------+-----------+---------------------+ -``` - - - -**聚合函数示例** - -建表 **employees** ,并向里面插入数据,执行以下语句: - -```javascript -CREATE TABLE employees (department_id INT,manager_id INT,last_name varchar(50),hiredate varchar(50),SALARY INT); -INSERT INTO employees VALUES(30, 100, 'Raphaely', '2017-07-01', 1700); -INSERT INTO employees VALUES(30, 100, 'De Haan', '2018-05-01',11000); -INSERT INTO employees VALUES(30, 100, 'Errazuriz', '2017-07-01', 1400); -INSERT INTO employees VALUES(30, 100, 'Hartstein', '2019-05-01',14000); -INSERT INTO employees VALUES(30, 100, 'Raphaely', '2017-07-01', 1700); -INSERT INTO employees VALUES(30, 100, 'Weiss', '2019-07-01',13500); -INSERT INTO employees VALUES(30, 100, 'Russell', '2019-07-01', 13000); -INSERT INTO employees VALUES(30,100, 'Partners', '2018-12-01',14000); -``` - - - -查询第 30 部门的所有员工,并按雇用日期和姓氏排序。执行以下语句: - -```javascript -SELECT LISTAGG(last_name, '; ') WITHIN GROUP (ORDER BY hiredate, last_name) as "Emp_list", -MIN(hiredate) as "Earliest" FROM employees WHERE department_id = 30; -``` - - - -查询结果如下: - -```javascript -+-----------------------------------------------------------------------------+------------+ -| Emp_list | Earliest | -+-----------------------------------------------------------------------------+------------+ -| Errazuriz; Raphaely; Raphaely; De Haan; Partners; Hartstein; Russell; Weiss | 2017-07-01 | -+-----------------------------------------------------------------------------+------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/6.MAX.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/6.MAX.md deleted file mode 100644 index 82de7e2b2..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/6.MAX.md +++ /dev/null @@ -1,106 +0,0 @@ -MAX -======================== - - - -`MAX` 函数返回参数中指定的列中的最大值。 - -语法 --------------- - -```javascript -MAX([ DISTINCT | UNIQUE | ALL ] expr) [ OVER (analytic_clause) ] -``` - - - -作为分析函数使用时,您需要使用窗口函数的完整语法,它对一组行的集合进行计算并返回多个值。作为聚合函数使用时,该函数对一组行的集合进行聚合计算,结果只能返回一个值,此时不需要加 `OVER` 关键字。 - -参数 --------------- - - - -| 参数 | 说明 | -|----------|----------------------------| -| DISTINCT | 返回的行中去除重复行,且忽略值为 NULL 的行。 | -| UNIQUE | 返回的行中去除重复行,且忽略值为 NULL 的行。 | -| ALL | 返回所有值,包含重复行,且忽略值为 NULL 的行。 | -| expr | 可为数值、字符、日期型或其它类型的数据列或表达式。 | -| OVER | 使用 `OVER` 子句定义窗口进行计算。 | - - - -返回类型 ----------------- - -返回与 `expr` 相同的数据类型值。 - -示例 --------------- - -**分析函数示例** - -以下语句创建了表 **employees** ,并向里面插入数据: - -```javascript -CREATE TABLE employees (manager_id INT, last_name varchar(50), hiredate varchar(50), SALARY INT); -INSERT INTO employees VALUES(100, 'Wei', '2019-09-11',17000); -INSERT INTO employees VALUES(100, 'Red', '2019-11-05', 17000); -INSERT INTO employees VALUES(101, 'Part', '2018-10-01',12008); -INSERT INTO employees VALUES(102, 'Wei', '2019-09-11',9000); -INSERT INTO employees VALUES(103, 'Red', '2019-11-05', 6000); -INSERT INTO employees VALUES(104, 'Part', '2018-10-01',8000); -COMMIT; -``` - - - -执行以下语句查询 **SALARY** 列的最大值: - -```javascript -SELECT manager_id, last_name, salary FROM (SELECT manager_id, last_name, salary, -MAX(salary) OVER (PARTITION BY manager_id) AS rmax_sal -FROM employees) WHERE salary = rmax_sal ORDER BY manager_id, last_name, salary; -``` - - - -查询结果如下: - -```javascript -+------------+-----------+--------+ -| MANAGER_ID | LAST_NAME | SALARY | -+------------+-----------+--------+ -| 100 | Red | 17000 | -| 100 | Wei | 17000 | -| 101 | Part | 12008 | -| 102 | Wei | 9000 | -| 103 | Red | 6000 | -| 104 | Part | 8000 | -+------------+-----------+--------+ -``` - - - -**聚合函数示例** - -执行以下语句查询 **SALARY** 列的最大值: - -```javascript -SELECT MAX(salary) FROM employees; -``` - - - -查询结果如下: - -```javascript -+-------------+ -| MAX(SALARY) | -+-------------+ -| 17000 | -+-------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/7.MIN.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/7.MIN.md deleted file mode 100644 index 6634c0504..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/7.MIN.md +++ /dev/null @@ -1,116 +0,0 @@ -MIN -======================== - - - -`MIN` 函数返回参数中指定列的最小值。 - -语法 --------------- - -```javascript -MIN([ DISTINCT | UNIQUE | ALL ] expr) [ OVER (analytic_clause) ] -``` - - - -作为分析函数使用时,您需要使用窗口函数的完整语法,它对一组行的集合进行计算并返回多个值。作为聚合函数使用时,该函数对一组行的集合进行聚合计算,结果只能返回一个值,此时不需要加 `OVER` 关键字。 - -参数 --------------- - - - -| **参数** | **说明** | -|----------|----------------------------| -| DISTINCT | 返回的行中去除重复行,且忽略值为 NULL 的行。 | -| UNIQUE | 返回的行中去除重复行,且忽略值为 NULL 的行。 | -| ALL | 返回所有值,包含重复行,且忽略值为 NULL 的行。 | -| expr | 可为数值、字符、日期型或其它类型的数据列或表达式。 | -| OVER | 使用 OVER 子句定义窗口进行计算。 | - - - -返回类型 ----------------- - -返回与 `expr` 相同数据类型的值。 - -示例 --------------- - -**分析函数示例** - -以下语句创建了表 **employees** ,并向里面插入数据: - -```javascript -CREATE TABLE employees (manager_id INT,last_name varchar(50),hiredate varchar(50),SALARY INT); -INSERT INTO employees VALUES(100, 'Raphaely', '2017-07-01', 1700); -INSERT INTO employees VALUES(100, 'De Haan', '2018-05-01',11000); -INSERT INTO employees VALUES(100, 'Errazuriz', '2017-07-21', 1400); -INSERT INTO employees VALUES(100, 'Hartstein', '2019-05-01',14000); -INSERT INTO employees VALUES(100, 'Raphaely', '2017-07-22', 1700); -INSERT INTO employees VALUES(100, 'Weiss', '2019-07-11',13500); -INSERT INTO employees VALUES(100, 'Russell', '2019-10-05', 13000); -INSERT INTO employees VALUES(100, 'Partners', '2018-12-01',14000); -INSERT INTO employees VALUES(200, 'Ross', '2019-06-11',13500); -INSERT INTO employees VALUES(200, 'Bell', '2019-05-25', 13000); -INSERT INTO employees VALUES(200, 'Part', '2018-08-11',14000); -``` - - - -执行以下语句查询 **SALARY** 列的最小值: - -```javascript -SELECT manager_id, last_name, hiredate, salary, MIN(salary) OVER(PARTITION BY manager_id -ORDER BY hiredate RANGE UNBOUNDED PRECEDING) AS p_cmin -FROM employees ORDER BY manager_id, last_name, hiredate, salary; -COMMIT; -``` - - - -查询结果如下: - -```javascript -+------------+-----------+------------+--------+--------+ -| MANAGER_ID | LAST_NAME | HIREDATE | SALARY | P_CMIN | -+------------+-----------+------------+--------+--------+ -| 100 | De Haan | 2018-05-01 | 11000 | 1400 | -| 100 | Errazuriz | 2017-07-21 | 1400 | 1400 | -| 100 | Hartstein | 2019-05-01 | 14000 | 1400 | -| 100 | Partners | 2018-12-01 | 14000 | 1400 | -| 100 | Raphaely | 2017-07-01 | 1700 | 1700 | -| 100 | Raphaely | 2017-07-22 | 1700 | 1400 | -| 100 | Russell | 2019-10-05 | 13000 | 1400 | -| 100 | Weiss | 2019-07-11 | 13500 | 1400 | -| 200 | Bell | 2019-05-25 | 13000 | 13000 | -| 200 | Part | 2018-08-11 | 14000 | 14000 | -| 200 | Ross | 2019-06-11 | 13500 | 13000 | -+------------+-----------+------------+--------+--------+ -``` - - - -**聚合函数示例** - -执行以下语句查询 **SALARY** 列的最小值: - -```javascript -SELECT MIN(salary) FROM employees ; -``` - - - -查询结果如下: - -```javascript -+-------------+ -| MIN(SALARY) | -+-------------+ -| 1400 | -+-------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/8.ROLLUP.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/8.ROLLUP.md deleted file mode 100644 index 54e954ccf..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/8.ROLLUP.md +++ /dev/null @@ -1,186 +0,0 @@ -ROLLUP -=========================== - - - -`ROLLUP` 函数是聚合函数,它是 `GROUP BY` 语句的简单扩展。在数据统计和报表生成过程中,它可以为每个分组返回一个小计,同时为所有分组返回总计,效率比 `GROUP BY` 和 `UNION` 组合方法高。 - -`ROLLUP` 函数的执行很简单,以下是它的执行顺序: - -* 根据参数指定的列从右到左递减分组; - - - -* 对每个分组小计,再对所有分组合计; - - - -* 按照 `ORDER BY col1 (,col2,col3,col4 ...)` 排序。 - - - - - - -如果 `ROLLUP` 参数为 `N` 个,则相当于 `N+1` 个 `GROUP BY` 分组的 `UNION` 的结合。 - -在涉及分组统计的任务中使用 `ROLLUP` 函数非常高效。例如,沿着时间或地理等层次维度进行小计,您只需要查询 `ROLLUP(y, m, day)` 或 `ROLLUP(country, state, city)`。数据仓库管理员使用 `ROLLUP` 函数可以简化和加快汇总表的维护。 - -语法 --------------- - -```javascript -SELECT ... GROUP BY ROLLUP(col1 [,col2...]) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|------|-------------------------| -| col1 | 进行分组操作的列名。列数指的是数据库中的行数。 | - - - -示例 --------------- - -创建表 **group_test** ,并向里面插入数据,执行以下语句: - -```javascript -CREATE TABLE group_test (group_id int, job varchar2(10), name varchar2(10), salary int); -INSERT INTO group_test VALUES (10, 'Coding', 'Bruce', 1000); -INSERT INTO group_test VALUES (10, 'Programmer', 'Clair', 1000); -INSERT INTO group_test VALUES (20, 'Coding', 'Jason', 2000); -INSERT INTO group_test VALUES (20, 'Programmer', 'Joey', 2000); -INSERT INTO group_test VALUES (30, 'Coding', 'Rebecca', 3000); -INSERT INTO group_test VALUES (30, 'Programmer', 'Rex', 3000); -INSERT INTO group_test VALUES (40, 'Coding', 'Samuel', 4000); -INSERT INTO group_test VALUES (40, 'Programmer', 'Susy', 4000); -COMMIT; -``` - - - -对 **group_id** 进行 `GROUP BY` 分组操作,执行以下语句: - -```javascript -SELECT group_id, SUM(salary) FROM group_test GROUP BY group_id; -``` - - - -查询结果如下: - -```javascript -+----------+-------------+ -| GROUP_ID | SUM(SALARY) | -+----------+-------------+ -| 10 | 2000 | -| 20 | 4000 | -| 30 | 6000 | -| 40 | 8000 | -+----------+-------------+ -``` - - - -对 **group_id** 使用 `ROLLUP` 函数进行分组,同时求总计。执行以下语句: - -```javascript -SELECT group_id, SUM(salary) FROM group_test GROUP BY ROLLUP (group_id); -``` - - - -查询结果如下: - -```javascript -+----------+-------------+ -| GROUP_ID | SUM(SALARY) | -+----------+-------------+ -| 10 | 2000 | -| 20 | 4000 | -| 30 | 6000 | -| 40 | 8000 | -| NULL | 20000 | -+----------+-------------+ -``` - - - -对 **group_id** 列和 **job** 列使用 `ROLLUP` 函数进行分组,同时求总计。执行以下语句: - -```javascript -SELECT group_id, job, SUM(salary) FROM group_test GROUP BY ROLLUP (group_id, job); -``` - - - -查询结果如下: - -```javascript -+----------+------------+-------------+ -| GROUP_ID | JOB | SUM(SALARY) | -+----------+------------+-------------+ -| 10 | Coding | 1000 | -| 10 | Programmer | 1000 | -| 10 | NULL | 2000 | -| 20 | Coding | 2000 | -| 20 | Programmer | 2000 | -| 20 | NULL | 4000 | -| 30 | Coding | 3000 | -| 30 | Programmer | 3000 | -| 30 | NULL | 6000 | -| 40 | Coding | 4000 | -| 40 | Programmer | 4000 | -| 40 | NULL | 8000 | -| NULL | NULL | 20000 | -+----------+------------+-------------+ -``` - - - -上面的 SQL 语句用 `GROUP BY` 与 `UNION` 组合方法替换,执行以下语句: - -```javascript -SELECT group_id, job, SUM(salary) FROM group_test GROUP BY group_id, job -UNION ALL -SELECT group_id, NULL, SUM(salary) FROM group_test GROUP BY group_id -UNION ALL -SELECT NULL, NULL, SUM(salary) FROM group_test ORDER BY 1, 2; -``` - - - -查询结果如下: - -```javascript -+----------+------------+-------------+ -| GROUP_ID | JOB | SUM(SALARY) | -+----------+------------+-------------+ -| 10 | Coding | 1000 | -| 10 | Programmer | 1000 | -| 10 | NULL | 2000 | -| 20 | Coding | 2000 | -| 20 | Programmer | 2000 | -| 20 | NULL | 4000 | -| 30 | Coding | 3000 | -| 30 | Programmer | 3000 | -| 30 | NULL | 6000 | -| 40 | Coding | 4000 | -| 40 | Programmer | 4000 | -| 40 | NULL | 8000 | -| NULL | NULL | 20000 | -+----------+------------+-------------+ -``` - - - - - -输出结果和 `ROLLUP` 函数一样,但是 `ROLLUP` 函数更加简洁、高效。 diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/9.STDDEV.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/9.STDDEV.md deleted file mode 100644 index 9c3156911..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/3.aggregate-functions-1/9.STDDEV.md +++ /dev/null @@ -1,119 +0,0 @@ -STDDEV -=========================== - - - -`STDDEV` 函数用于计算总体标准差。`STDDEV` 函数将数值型数据作为参数,返回数值型数据。它与函数 `STDDEV_SAMP` 的不同之处在于,`STDDEV` 只有一行输入数据时返回 0,而 `STDDEV_SAMP` 返回 NULL。 - -OceanBase 中标准差的值是函数 `VARIANCE` 计算出的方差的算术平方根。 - -语法 --------------- - -```javascript -STDDEV([ DISTINCT | UNIQUE | ALL ] expr) [ OVER (analytic_clause) ] -``` - - - -作为分析函数使用时,您需要使用窗口函数的完整语法,它对一组行的集合进行计算并返回多个值[](pt3avi)。作为聚合函数使用时,该函数对一组行的集合进行聚合计算,结果只能返回一个值,此时不需要加 `OVER` 关键字。 - -参数 --------------- - - - -| 参数 | 说明 | -|----------|-----------------------| -| DISTINCT | 去重关键字,表示计算唯一值的总体标准差。 | -| UNIQUE | 去重关键字,表示计算唯一值的总体标准差。 | -| ALL | 全部数值列。 | -| expr | 是数值类型或者可以转换成数值类型的类型。 | -| OVER | 使用 `OVER` 子句定义窗口进行计算。 | - - -**注意** - - - -如果您指定了 `DISTINCT` 或 `UNIQUE` 关键字,则 `analytic_clause` 中不允许出现 `order_by_clause` 和 `windowing_clause`。 - -返回类型 ----------------- - -返回 `NUMBER` 类型数据。 - -示例 --------------- - -**分析函数示例** - -以下语句创建了表 **employees** ,并向里面插入数据 - -```javascript -CREATE TABLE employees(manager_id INT,last_name varchar(50),hiredate varchar(50),SALARY INT); -INSERT INTO employees VALUES(100, 'Raphaely', '2017-07-01', 1700); -INSERT INTO employees VALUES(100, 'De Haan', '2018-05-01',11000); -INSERT INTO employees VALUES(100, 'Errazuriz', '2017-07-21', 1400); -INSERT INTO employees VALUES(100, 'Hartstein', '2019-05-01',14000); -INSERT INTO employees VALUES(100, 'Raphaely', '2017-07-22', 1700); -INSERT INTO employees VALUES(100, 'Weiss', '2019-07-11',13500); -INSERT INTO employees VALUES(100, 'Russell', '2019-10-05', 13000); -INSERT INTO employees VALUES(100, 'Partners', '2018-12-01',14000); -INSERT INTO employees VALUES(200, 'Ross', '2019-06-11',13500); -INSERT INTO employees VALUES(200, 'Bell', '2019-05-25', 13000); -INSERT INTO employees VALUES(200, 'Part', '2018-08-11',14000); -COMMIT; -``` - - - -调用函数并执行以下语句: - -```javascript -SELECT last_name, salary, STDDEV(salary) OVER (ORDER BY hiredate) "StdDev" -FROM employees WHERE manager_id = 100 ORDER BY last_name, salary, "StdDev"; -``` - - - -查询结果如下: - -```javascript -+-----------+--------+-------------------------------------------+ -| LAST_NAME | SALARY | StdDev | -+-----------+--------+-------------------------------------------+ -| De Haan | 11000 | 4702.127178203498995615489088200868644482 | -| Errazuriz | 1400 | 212.132034355964257320253308631454711785 | -| Hartstein | 14000 | 6340.346993658943269176828928801701088079 | -| Partners | 14000 | 6064.899009876421676804205219406952308814 | -| Raphaely | 1700 | 0 | -| Raphaely | 1700 | 173.205080756887729352744634150587236694 | -| Russell | 13000 | 6026.474330580265330900400184969999384459 | -| Weiss | 13500 | 6244.311697171159907069428668980211861012 | -+-----------+--------+-------------------------------------------+ -``` - - - -**聚合函数示例** - -调用函数并执行以下语句: - -```javascript -SELECT STDDEV(salary) FROM employees WHERE manager_id = 100 ; -``` - - - -查询结果如下: - -```javascript -+-------------------------------------------+ -| STDDEV(SALARY) | -+-------------------------------------------+ -| 6026.474330580265330900400184969999384459 | -+-------------------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/1.window-function-description.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/1.window-function-description.md deleted file mode 100644 index 90496166b..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/1.window-function-description.md +++ /dev/null @@ -1,250 +0,0 @@ -窗口函数说明 -=========================== - - - -分析函数(也叫窗口函数)与聚合函数,都是对行集组(一组行的集合)进行聚合计算,不同的是,聚合函数每组只能返回一个值(一行),而窗口函数每组可以返回多个值(多行)。行集组又称为窗口(Window),由 `analytic_clause` 定义。而窗口大小取决于实际的行数或逻辑间隔(例如时间)。组内每一行都是基于窗口的逻辑计算的结果。 - -触发一个分析函数需要特殊的关键字 `OVER` 来指定窗口。一个窗口包含三个组成部分: - -* 分区规范,用于将输入行分裂到不同的分区中。这个过程和 `GROUP BY` 子句的分裂过程相似。 - - - -* 排序规范,用于决定输入数据行在窗口函数中执行的顺序。 - - - -* 窗口边界,指定计算数据的窗口边界。默认值为 `RANGE UNBOUNDED PRECEDING` 。这个边界包含当前分区中所有从开始到目前行所有数据。 - - - - - - -分析函数是查询中执行的最后一组操作,除了最后的 `ORDER BY` 子句。在处理窗口函数之前,必须完成所有 `JOIN` 以及 `WHERE`、`GROUP BY` 和 `HAVING` 子句。因此,窗口函数只能出现在选择列表或 `ORDER BY` 子句中。 - -分析函数通常用于计算累积、移动、居中和报告汇总。 - -语法 --------------- - -**analytic_function** - -```javascript -analytic_function([ arguments ]) OVER (analytic_clause) -``` - - - -**analytic_clause** - -```javascript -[ query_partition_clause ] [ order_by_clause [ windowing_clause ] ] -``` - - - -**query_partition_clause** - -```javascript -PARTITION BY { expr[, expr ]... | ( expr[, expr ]... ) } -``` - - - -**order_by_clause** - -```javascript -ORDER [ SIBLINGS ] BY{ expr | position | c_alias } [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] [, { expr | position | c_alias } [ ASC | DESC ][ NULLS FIRST | NULLS LAST ]]... -``` - - - -**windowing_clause** - -```javascript -{ ROWS | RANGE } { BETWEEN { UNBOUNDED PRECEDING | CURRENT ROW | value_expr { PRECEDING | FOLLOWING } } AND{ UNBOUNDED FOLLOWING | CURRENT ROW | value_expr { PRECEDING | FOLLOWING } } | { UNBOUNDED PRECEDING | CURRENT ROW| value_expr PRECEDING}} -``` - - - -在以下各节中将讨论此语法的语义。 - -analytic_function --------------------------------------- - -分析函数(analytic_function)指定了分析函数的名称。 - -arguments ----------------------- - -参数(arguments),分析函数采用 0\~3 个参数。参数可以是任何数字数据类型或可以隐式转换为数字数据类型的任何非数字数据类型。OceanBase 根据数据类型优先级确定具有最高数值优先级的参数,然后将其余参数隐式转换为这个具有最高数值优先级参数的数据类型。返回类型也是具有最高数值优先级参数的数据类型,除非对单个函数另有说明。 - -analytic_clause ----------------------------------- - -分析子句(analytic_clause),使用 `OVER analytic_clause` 指示函数在查询结果集上操作。此子句在 `FROM`、`WHERE`、`GROUP BY` 和 `HAVING` 子句之后计算。您可以在选择列表或按子句顺序中用此子句指定分析函数。若要筛选基于分析函数的查询结果,请将这些函数嵌套在父查询中,然后筛选嵌套子查询的结果。 -**注意** - - - -* 您不能通过在分析子句中指定分析函数来嵌套分析函数。但是您可以在子查询中指定分析函数,并在其上计算另一个分析函数。 - - - -* 您可以使用用户定义的解析函数以及内置的解析函数指定 `analytic_clause`。 - - - - - - -query_partition_clause ------------------------------------------------- - -分区子句(query_partition_clause),使用 `PARTITION BY` 子句将查询结果集划分为基于一个或多个 `value_expr` 的组。如果省略此子句,则函数将查询结果集的所有行视为单个组。 - -您可以在同一查询中指定多个分析函数,每个函数通过键具有相同或不同的分区。如果您用 `query_partition_clause` 指定了一个分析函数,并且被查询的对象具有并行属性,那么函数计算也是并行化的。 - -`value_expr` 的有效值是常量、列、非分析函数、函数表达式或涉及其中任何一个的表达式。 - -order_by_clause ----------------------------------- - -使用排序子句 `order_by_clause` 指定如何在分区内对数据进行排序。 对于所有分析函数,您可以在多个键上的分区中对值进行排序,每个键由 `value_expr` 定义,由排序序列限定。 - -在每个函数中,您可以指定多个排序表达式。当使用对值进行排序的函数时,这样做特别有用。 - -当 `order_by_clause` 对多行产生相同的值时,函数的行为如下: - -* `CUME_DIST`、`DENSE_RANK`、`NTILE`、`PERCENT_RANK` 和 `RANK` 为每一行返回相同的结果。 - - - -* 即使有一个基于 `order_by_clause` 的值,`ROW_NUMBER` 也会为每一行分配一个不同的值。该值基于行处理的顺序,如果 `ORDER BY` 不能实现总排序,则该顺序可能是不确定的。 - - - -* 对于其他分析函数,它的结果取决于窗口规则。如果您指定了一个带有 `RANGE` 关键字的逻辑窗口,则函数将为每个行返回相同的结果。如果您用 `ROWS` 关键字指定了物理窗口,则结果是不确定的。 - - - - - - -### ORDER BY 子句的限制 - -使用 `ORDER BY` 子句会受到以下限制: - -* 在分析函数中,`order_by_clause` 必须使用表达式(expr)。`SIBLINGS` 关键字无效(仅与分层查询中相关)。位置(position)和列别名(c_alias)也无效。否则,该 `order_by_clause` 与整个查询或子查询的排序命令相同。 - - - -* 使用 RANGE 关键字的分析函数可以在其函数的 `ORDER BY` 子句中使用多个排序键。您需要指定以下窗口: - - - - - - - - - - -除了这四个之外,窗口边界只能在分析函数的 `ORDER BY` 子句中有一个排序键。 此限制不适用于 `ROW` 关键字指定的窗口边界。 - -### ASC 或 DESC 关键字 - -指定排序序列,`ASC` 指升序,`DESC` 指降序。默认为升序(ASC)。 - -### NULLS FIRST 或 NULLS LAST 关键字 - -`order_by_clause` 中的 `nulls first` 和 `nulls last`, `nulls first` 表示排序时NULL值作为最小值处理,而 `nulls last` 表示排序时NULL值作为最大值处理。 - -windowing_clause ------------------------------------- - -窗口函数子句(windowing_clause)有一些分析函数可以使用 `windowing_clause`。相关的关键字如下。 - -### ROWS 或 RANGE 关键字 - -这些关键字为每一行定义一个用于计算函数结果的窗口,然后将该函数应用于窗口中的所有行。窗口从上到下通过查询结果集或分区移动。窗口也称为 `FRAME`,OceanBase 同时支持以下窗口语句: - -* `ROWS`:以物理单位(行)指定窗口。 - - - -* `RANGE`:将窗口指定为逻辑偏移量。默认方式是 `RANGE UNBOUNDED PRECEDING`。您可以在分析函数中使用窗口函数,而要使用 `windowing_clause`,就必须添加 `order_by_clause`。 - - - - - - -`windowing_clause` 若由 `RANGE` 子句定义窗口边界,那么在 `order_by_clause` 中您只能指定一个表达式。请参阅ORDER BY 子句的限制。具有逻辑偏移的分析函数返回的值总是确定性的。但是具有物理偏移量的分析函数返回的值可能会产生不确定的结果。排序表达式返回唯一的排序才能使具有物理偏移量的分析函数返回确定的值,因此,您必须在 `order_by_clause` 中指定多个列实现唯一的排序。 - -### BETWEEN ... AND 关键字 - -使用 `BETWEEN ... AND` 子句指定窗口的起点和终点。第一个表达式(AND 之前)定义起点,第二个表达式(AND 之后)定义终点。 如果省略 `BETWEEN` 并仅指定一个终点,则 OceanBase 将其视为起点,并且终点默认为当前行。 - -### UNBOUNDED PRECEDING 关键字 - -`UNBOUNDED PRECEDING` 指示窗口从分区的第一行开始。这是起点,不是终点。 - -### UNBOUNDED FOLLOWING 关键字 - -`UNBOUNDED FOLLOWING` 表示窗口在分区的最后一行结束。这是终点,不是起点。 - -### CURRENT ROW 关键字 - -作为起点,`CURRENT ROW` 指定了窗口从当前行或当前值开始(取决于分别指定了 `ROW` 还是 `RANGE`)。在这种情况下,端点不能为 `value_expr PRECEDING`。 作为终点,`CURRENT ROW` 指定窗口在当前行或值处结束(分别取决于您是否指定了 `ROW` 或 `RANGE`)。在这种情况下,起点不能为 `value_expr FOLLOWING`。 - -### value_expr PRECEDING 或 value_expr FOLLOWING 关键字 - -* 如果 `value_expr FOLLOWING` 是起点,则终点必须是 `value_expr FOLLOWING`。 - - - -* 如果 `value_expr PRECEDING` 是终点,则起点必须是 `value_expr PRECEDING`。 - - - - - - -如果要定义由时间间隔定义的数值格式的逻辑窗口,则可能需要使用转换函数。 - -如果您指定 `ROWS`: - -* `value_expr` 是物理偏移量。则它必须是一个常数或表达式,并且必须计算为正数。 - - - -* 如果 `value_expr` 是起点的一部分,则它必须把起点与终点之前的部分当作一行计算。 - - - - - - -如果您指定 `RANGE`: - -* `value_expr` 是逻辑偏移量。它必须是一个常数或表达式,其结果为正数值或间隔字面量。 - - - -* 您只能在 `order_by_clause` 中指定一个表达式。 - - - -* 如果 `value_expr` 为数值,则 `ORDER BY expr` 必须为数值或 `DATE` 数据类型。 - - - -* 如果 `value_expr` 为间隔值,则 `ORDER BY expr` 必须为 `DATE` 数据类型。如果您完全省略 `windowing_clause`,则默认值为 `RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW`。 - - - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/10.STDDEV_POP-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/10.STDDEV_POP-1.md deleted file mode 100644 index 1a2ad8baf..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/10.STDDEV_POP-1.md +++ /dev/null @@ -1,118 +0,0 @@ -STDDEV_POP -=============================== - - - -`STDDEV_POP` 函数计算总体标准差。`STDDEV_POP` 函数将数值型数据作为参数,返回数值型数据。 -**注意** - - - -总体标准差是总体方差的算术平方根。 - -语法 --------------- - -```javascript -STDDEV_POP([ALL] expr) [ OVER (analytic_clause) ] -``` - - - -作为分析函数使用时,您需要使用窗口函数的完整语法,它对一组行的集合进行计算并返回多个值[](pt3avi)。作为聚合函数使用时,该函数对一组行的集合进行聚合计算,结果只能返回一个值,此时不需要加 `OVER` 关键字。 - -参数 --------------- - - - -| 参数 | 说明 | -|------|---------------------------------------------------------------| -| ALL | 全部数值列。 | -| OVER | 使用 `OVER` 子句定义窗口进行计算。 | -| expr | 是数值类型(`NUMBER`、`FLOAT`、`BINARY_FLOAT` 和 `BINARY_DOUBLE`)的表达式。 | - - - -返回类型 ----------------- - -返回类型与参数 `expr` 的数据类型相同。 - -示例 --------------- - -**分析函数示例** - -以下语句创建了表 **employees** ,并向里面插入数据: - -```javascript -CREATE TABLE employees (manager_id INT,last_name varchar(50),hiredate varchar(50),SALARY INT); -INSERT INTO employees VALUES(100, 'Raphaely', '2017-07-01', 1700); -INSERT INTO employees VALUES(100, 'De Haan', '2018-05-01',11000); -INSERT INTO employees VALUES(100, 'Errazuriz', '2017-07-21', 1400); -INSERT INTO employees VALUES(100, 'Hartstein', '2019-05-01',14000); -INSERT INTO employees VALUES(100, 'Raphaely', '2017-07-22', 1700); -INSERT INTO employees VALUES(100, 'Weiss', '2019-07-11',13500); -INSERT INTO employees VALUES(100, 'Russell', '2019-10-05', 13000); -INSERT INTO employees VALUES(100, 'Partners', '2018-12-01',14000); -INSERT INTO employees VALUES(200, 'Ross', '2019-06-11',13500); -INSERT INTO employees VALUES(200, 'Bell', '2019-05-25', 13000); -INSERT INTO employees VALUES(200, 'Part', '2018-08-11',14000); -COMMIT; -``` - - - -调用函数并执行以下语句: - -```javascript -SELECT manager_id, last_name, salary, STDDEV_POP(salary) OVER (PARTITION BY manager_id) AS pop_std -FROM employees ORDER BY manager_id, last_name, salary, pop_std; -``` - - - -查询结果如下: - -```javascript -+------------+-----------+--------+-------------------------------------------+ -| MANAGER_ID | LAST_NAME | SALARY | POP_STD | -+------------+-----------+--------+-------------------------------------------+ -| 100 | De Haan | 11000 | 5637.250548804798333699350384281939588505 | -| 100 | Errazuriz | 1400 | 5637.250548804798333699350384281939588505 | -| 100 | Hartstein | 14000 | 5637.250548804798333699350384281939588505 | -| 100 | Partners | 14000 | 5637.250548804798333699350384281939588505 | -| 100 | Raphaely | 1700 | 5637.250548804798333699350384281939588505 | -| 100 | Raphaely | 1700 | 5637.250548804798333699350384281939588505 | -| 100 | Russell | 13000 | 5637.250548804798333699350384281939588505 | -| 100 | Weiss | 13500 | 5637.250548804798333699350384281939588505 | -| 200 | Bell | 13000 | 408.248290463863016366214012450981899069 | -| 200 | Part | 14000 | 408.248290463863016366214012450981899069 | -| 200 | Ross | 13500 | 408.248290463863016366214012450981899069 | -+------------+-----------+--------+-------------------------------------------+ -``` - - - -**聚合函数示例** - -调用函数并执行以下语句: - -```javascript -SELECT STDDEV_POP(salary) FROM employees ; -``` - - - -查询结果如下: - -```javascript -+-------------------------------------------+ -| STDDEV_POP(SALARY) | -+-------------------------------------------+ -| 5249.950806538512715446505486136315088416 | -+-------------------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/11.STDDEV_SAMP-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/11.STDDEV_SAMP-1.md deleted file mode 100644 index 2f541ca33..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/11.STDDEV_SAMP-1.md +++ /dev/null @@ -1,119 +0,0 @@ -STDDEV_SAMP -================================ - - - -`STDDEV_SAMP` 函数计算样本标准差。`STDDEV_SAMP` 函数将数值型数据作为参数,返回数值型数据。它与函数 [STDDEV](lbfuea) 的不同之处在于,`STDDEV` 只有一行输入数据时返回 0,而 `STDDEV_SAMP` 返回 NULL。 -**说明** - - - -样本标准差是样本方差的算术平方根。 - -语法 --------------- - -```javascript -STDDEV_SAMP([ALL] expr) [ OVER (analytic_clause) ] -``` - - - -作为分析函数使用时,您需要使用窗口函数的完整语法,它对一组行的集合进行计算并返回多个值 。作为聚合函数使用时,该函数对一组行的集合进行聚合计算,结果只能返回一个值,此时不需要加 OVER 关键字。 - -参数 --------------- - - - -| 参数 | 说明 | -|------|--------------------------------------------------------------------------| -| ALL | 全部数值列。 | -| expr | 是数值类型(`NUMBER`、`FLOAT`、`BINARY_FLOAT` 和 `BINARY_DOUBLE`)或者可以转换成数值类型的表达式。 | -| OVER | 使用 `OVER` 子句定义窗口进行计算。 | - - - -返回类型 ----------------- - -返回类型与参数 `expr` 的数据类型相同。 - -示例 --------------- - -**分析函数示例** - -以下语句创建了表 **employees** ,并向里面插入数据: - -```javascript -CREATE TABLE employees (manager_id INT,last_name varchar(50),hiredate varchar(50),SALARY INT); -INSERT INTO employees VALUES(100, 'Raphaely', '2017-07-01', 1700); -INSERT INTO employees VALUES(100, 'De Haan', '2018-05-01',11000); -INSERT INTO employees VALUES(100, 'Errazuriz', '2017-07-21', 1400); -INSERT INTO employees VALUES(100, 'Hartstein', '2019-05-01',14000); -INSERT INTO employees VALUES(100, 'Raphaely', '2017-07-22', 1700); -INSERT INTO employees VALUES(100, 'Weiss', '2019-07-11',13500); -INSERT INTO employees VALUES(100, 'Russell', '2019-10-05', 13000); -INSERT INTO employees VALUES(100, 'Partners', '2018-12-01',14000); -INSERT INTO employees VALUES(200, 'Ross', '2019-06-11',13500); -INSERT INTO employees VALUES(200, 'Bell', '2019-05-25', 13000); -INSERT INTO employees VALUES(200, 'Part', '2018-08-11',14000); -COMMIT; -``` - - - -调用函数并执行以下语句: - -```javascript -SELECT manager_id, last_name, hiredate, salary,STDDEV_SAMP(salary) OVER (PARTITION BY manager_id -ORDER BY hiredate ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW) AS cum_sdev -FROM employees ORDER BY manager_id, last_name, hiredate, salary, cum_sdev; -``` - - - -返回结果如下: - -```javascript -+------------+-----------+------------+--------+-------------------------------------------+ -| MANAGER_ID | LAST_NAME | HIREDATE | SALARY | CUM_SDEV | -+------------+-----------+------------+--------+-------------------------------------------+ -| 100 | De Haan | 2018-05-01 | 11000 | 4702.127178203498995615489088200868644482 | -| 100 | Errazuriz | 2017-07-21 | 1400 | 212.132034355964257320253308631454711785 | -| 100 | Hartstein | 2019-05-01 | 14000 | 6340.346993658943269176828928801701088079 | -| 100 | Partners | 2018-12-01 | 14000 | 6064.899009876421676804205219406952308814 | -| 100 | Raphaely | 2017-07-01 | 1700 | NULL | -| 100 | Raphaely | 2017-07-22 | 1700 | 173.205080756887729352744634150587236694 | -| 100 | Russell | 2019-10-05 | 13000 | 6026.474330580265330900400184969999384459 | -| 100 | Weiss | 2019-07-11 | 13500 | 6244.311697171159907069428668980211861012 | -| 200 | Bell | 2019-05-25 | 13000 | 707.106781186547524400844362104849039285 | -| 200 | Part | 2018-08-11 | 14000 | NULL | -| 200 | Ross | 2019-06-11 | 13500 | 500 | -+------------+-----------+------------+--------+-------------------------------------------+ -``` - - - -**聚合函数示例** - -调用函数并执行以下语句: - -```javascript -SELECT STDDEV_SAMP(salary) FROM employees ; -``` - - - -查询结果如下: - -```javascript -+-------------------------------------------+ -| STDDEV_SAMP(SALARY) | -+-------------------------------------------+ -| 5506.194858355615640082358245403620332764 | -+-------------------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/12.VARIANCE-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/12.VARIANCE-1.md deleted file mode 100644 index a63d88e9a..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/12.VARIANCE-1.md +++ /dev/null @@ -1,117 +0,0 @@ -VARIANCE -============================= - - - -`VARIANCE` 函数返回参数指定列的方差。 - -语法 --------------- - -```javascript -VARIANCE([ DISTINCT | UNIQUE | ALL ] expr) [ OVER (analytic_clause) ] -``` - - - -作为分析函数使用时,您需要使用窗口函数的完整语法,它对一组行的集合进行计算并返回多个值。作为聚合函数使用时,该函数对一组行的集合进行聚合计算,结果只能返回一个值,此时不需要加 `OVER` 关键字。 - -参数 --------------- - - - -| 参数 | 说明 | -|----------|----------------------------------------| -| DISTINCT | 查询时去除列中的重复值,且忽略列中的 NULL 值。 | -| UNIQUE | 查询时去除列中的重复值,且忽略列中的 NULL 值。 | -| ALL | 查询时不去除列中的重复值,且忽略列中的 NULL 值。`ALL` 为默认值。 | -| expr | 可为数值、字符、日期型或其它类型的数据列或表达式。 | -| OVER | 使用 `OVER` 子句定义窗口进行计算。 | - - -**注意** - - - -如果您指定了 `DISTINCT` 或 `UNIQUE` 关键字,则 `analytic_clause` 中不允许出现 `order_by_clause` 和 `windowing_clause`。 - -返回类型 ----------------- - -返回 `NUMBER` 类型数据。 - -示例 --------------- - -**分析函数示例** - -以下语句创建了表 **employees** ,并向里面插入数据: - -```javascript -CREATE TABLE employees (manager_id INT,last_name varchar(50),hiredate varchar(50),SALARY INT); -INSERT INTO employees VALUES(100, 'Raphaely', '2017-07-01', 1700); -INSERT INTO employees VALUES(100, 'De Haan', '2018-05-01',11000); -INSERT INTO employees VALUES(100, 'Errazuriz', '2017-07-21', 1400); -INSERT INTO employees VALUES(100, 'Hartstein', '2019-05-01',14000); -INSERT INTO employees VALUES(100, 'Raphaely', '2017-07-22', 1700); -INSERT INTO employees VALUES(100, 'Weiss', '2019-07-11',13500); -INSERT INTO employees VALUES(100, 'Russell', '2019-10-05', 13000); -INSERT INTO employees VALUES(100, 'Partners', '2018-12-01',14000); -INSERT INTO employees VALUES(200, 'Ross', '2019-06-11',13500); -INSERT INTO employees VALUES(200, 'Bell', '2019-05-25', 13000); -INSERT INTO employees VALUES(200, 'Part', '2018-08-11',14000); -COMMIT; -``` - - - -执行以下语句计算列 **salary** 的方差: - -```javascript -SELECT last_name, salary, VARIANCE(salary) OVER (ORDER BY hiredate) "Variance" -FROM employees WHERE manager_id = 100 ORDER BY last_name, salary, "Variance"; -``` - - - -查询结果如下: - -```javascript -+-----------+--------+-------------------------------------------+ -| LAST_NAME | SALARY | Variance | -+-----------+--------+-------------------------------------------+ -| De Haan | 11000 | 22110000 | -| Errazuriz | 1400 | 45000 | -| Hartstein | 14000 | 40200000 | -| Partners | 14000 | 36783000 | -| Raphaely | 1700 | 0 | -| Raphaely | 1700 | 30000 | -| Russell | 13000 | 36318392.85714285714285714285714285714286 | -| Weiss | 13500 | 38991428.57142857142857142857142857142857 | -+-----------+--------+-------------------------------------------+ -``` - - - -**聚合函数示例** - -执行以下语句计算列 **salary** 的方差: - -```javascript -SELECT VARIANCE(salary) FROM employees; -``` - - - -查询结果如下: - -```javascript -+-----------------------------------------+ -| VARIANCE(SALARY) | -+-----------------------------------------+ -| 30318181.818181818181818181818181818182 | -+-----------------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/13.RANK.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/13.RANK.md deleted file mode 100644 index dfd56ed24..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/13.RANK.md +++ /dev/null @@ -1,85 +0,0 @@ -RANK -========================= - - - -`RANK` 函数基于 `OVER` 子句中的 `ORDER BY` 表达式确定一组值的排名。当有相同排序值时,将会有相同的排名,并且值相同的行数会被记录到下个排名中。 - -语法 --------------- - -```javascript -RANK() OVER ( [ PARTITION BY expr_list ] [ ORDER BY order_list ]) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|-------------------------------|-----------------------| -| OVER | 使用 `OVER` 子句定义窗口进行计算。 | -| PARTITION BY \[col1, col2..\] | 指定开窗口的列。 | -| ORDER BY col1\[asc\|desc\] | 指定排名依据的值。 | -| expr_list | 是数值类型或者可以转换成数值类型的类型。 | -| order_list | 定义排名值参考的数据列。 | - - - -示例 --------------- - -建表 **course** ,并向 **name** 和 **grade** 列插入数据,执行以下语句: - -```javascript -CREATE TABLE course -( - name VARCHAR(8), - grade NUMBER -); -INSERT INTO course VALUES('Linda',50); -INSERT INTO course VALUES('Tan',85); -INSERT INTO course VALUES('Tom',90); -INSERT INTO course VALUES('John',95); -INSERT INTO course VALUES('Mery',55); -INSERT INTO course VALUES('Peter',60); -INSERT INTO course VALUES('Jack',65); -INSERT INTO course VALUES('Rose',70); -INSERT INTO course VALUES('Tonny',75); -INSERT INTO course VALUES('Apple',80); -COMMIT; -``` - - - -执行以下语句: - -```javascript -SELECT name,grade ,RANK() over(ORDER BY grade DESC) FROM course; -``` - - - -查询结果如下: - -```javascript -+-------+-------+------------------------------+ -| NAME | GRADE | RANK()OVER(ORDERBYGRADEDESC) | -+-------+-------+------------------------------+ -| John | 95 | 1 | -| Tom | 90 | 2 | -| Tan | 85 | 3 | -| Apple | 80 | 4 | -| Tonny | 75 | 5 | -| Rose | 70 | 6 | -| Jack | 65 | 7 | -| Peter | 60 | 8 | -| Mery | 55 | 9 | -| Linda | 50 | 10 | -+-------+-------+------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/14.LEAD.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/14.LEAD.md deleted file mode 100644 index a8ecdb27d..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/14.LEAD.md +++ /dev/null @@ -1,101 +0,0 @@ -LEAD -========================= - - - -`LEAD` 是一种分析函数,它提供了对表多行的访问,而无需进行自我连接。给定从查询返回的一些列行和光标的位置,`LEAD` 提供超出该位置的物理偏移量的行的访问。 - -语法 --------------- - -```javascript -LEAD { (value_expr [,offset [,default]]) [RESPECT|IGNORE] NULLS -|(value_expr [RESPECT|IGNORE] NULLS [,offset [,default]]) } -OVER([query_partition_clause] order_by_clause) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|---------------------------|----------------------------------------------------------------------| -| OVER | 使用 `OVER` 子句定义窗口进行计算。 | -| offset | 是 value_expr 的可选参数偏移量。 | -| default | 如果未指定默认值,则其默认值为 `null`。如果在 `LEAD` 没有显式的设置 default 值的情况下,返回值为 `NULL`。 | -| {RESPECT \| IGNORE} NULLS | 表示是否忽略 `NULL` 值。默认值为 `RESPECT NULLS`,考虑 `NULL` 值。 | -| value_expr | 是要做比对的字段。您不能使用 `LEAD` 函数或其他分析函数来嵌套 `value_expr`。 | - - -**注意** - - - -`LEAD` 函数后必须跟 order_by_clause ,query_partition_clause 是可选的。 - -返回类型 ----------------- - -返回的数据类型不限。 - -示例 --------------- - -创建 **emp_msg** 表,并向列中插入数据。执行以下语句: - -```javascript -CREATE TABLE emp_msg(deptno INT, ename VARCHAR(30),sal INT); -INSERT INTO emp_msg VALUES(20,'ADAMS',1400); -INSERT INTO emp_msg VALUES(30,'ALLEN',1900); -INSERT INTO emp_msg VALUES(30,'BLAKE',3135); -INSERT INTO emp_msg VALUES(10,'CLARK',2750); -INSERT INTO emp_msg VALUES(20,'FORD',3300); -INSERT INTO emp_msg VALUES(30,'JAMES',1250); -INSERT INTO emp_msg VALUES(20,'JONES',3275); -INSERT INTO emp_msg VALUES(10,'KING',5300); -INSERT INTO emp_msg VALUES(30,'MARTIN',1550); -INSERT INTO emp_msg VALUES(10,'MILLER',1600); -INSERT INTO emp_msg VALUES(20,'SCOTT',3300); -INSERT INTO emp_msg VALUES(20,'SWITH',1100); -INSERT INTO emp_msg VALUES(30,'TURNER',1800); -INSERT INTO emp_msg VALUES(30,'WARD',1550); -``` - - - -查询 **emp_msg** 表,最后 5 个值用 **Jane** 代替,从倒数第 6 个值开始追加按 **ename** 列升序排列的值。 - -```javascript -SELECT deptno, ename, sal, LEAD(ename,5,'Jane') OVER (ORDER BY ename) AS new_ename -FROM emp_msg; -``` - - - -查询结果如下: - -```javascript -+--------+--------+------+-----------+ -| DEPTNO | ENAME | SAL | NEW_ENAME | -+--------+--------+------+-----------+ -| 20 | ADAMS | 1400 | JAMES | -| 30 | ALLEN | 1900 | JONES | -| 30 | BLAKE | 3135 | KING | -| 10 | CLARK | 2750 | MARTIN | -| 20 | FORD | 3300 | MILLER | -| 30 | JAMES | 1250 | SCOTT | -| 20 | JONES | 3275 | SWITH | -| 10 | KING | 5300 | TURNER | -| 30 | MARTIN | 1550 | WARD | -| 10 | MILLER | 1600 | Jane | -| 20 | SCOTT | 3300 | Jane | -| 20 | SWITH | 1100 | Jane | -| 30 | TURNER | 1800 | Jane | -| 30 | WARD | 1550 | Jane | -+--------+--------+------+-----------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/15.LAG.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/15.LAG.md deleted file mode 100644 index 14ebaa40e..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/15.LAG.md +++ /dev/null @@ -1,101 +0,0 @@ -LAG -======================== - - - -`LAG` 是一个分析函数。它同时提供对多行表的访问,而不需要自连接。给定从查询返回的一系列行和游标的位置,`LAG` 可以访问位于该位置之前给定物理偏移量的行。您可以给偏移参数指定一个大于零的整数。如果不指定偏移量,则其默认值为 1。如果偏移量超出窗口的范围,则返回可选值。如果不指定默认值,则其默认值为 `NULL`。 - -语法 --------------- - -```javascript -LAG { (value_expr [,offset [,default]]) [RESPECT|IGNORE] NULLS -|(value_expr [RESPECT | IGNORE] NULLS [,offset [,default] ]) } -OVER([query_partition_clause] order_by_clause) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|---------------------------|----------------------------------------------------------------------| -| value_expr | 是要做比对的字段。您不能使用 `LAG` 函数或其他分析函数来嵌套 `value_expr`。 | -| offset | 是 value_expr 的可选参数偏移量。 | -| default | 如果未指定默认值,则其默认值为 `NULL`。如果在 `LEAD` 没有显式的设置 default 值的情况下,返回值为 `NULL`。 | -| {RESPECT \| IGNORE} NULLS | 表示是否忽略 `NULL` 值。默认值为 `RESPECT NULLS`,考虑 `NULL` 值。 | -| OVER | 使用 OVER 子句定义窗口进行计算。 | - - -**注意** - - - -`LAG` 函数后必须跟 order_by_clause ,query_partition_clause 是可选的。 - -返回类型 ----------------- - -返回值的数据类型不限。 - -示例 --------------- - -创建 **emp_msg** 表,并向里面插入数据。执行以下语句: - -```javascript -CREATE TABLE emp_msg(deptno INT, ename varchar(30),sal INT); -INSERT INTO emp_msg VALUES(20,'ADAMS',1400); -INSERT INTO emp_msg VALUES(30,'ALLEN',1900); -INSERT INTO emp_msg VALUES(30,'BLAKE',3135); -INSERT INTO emp_msg VALUES(10,'CLARK',2750); -INSERT INTO emp_msg VALUES(20,'FORD',3300); -INSERT INTO emp_msg VALUES(30,'JAMES',1250); -INSERT INTO emp_msg VALUES(20,'JONES',3275); -INSERT INTO emp_msg VALUES(10,'KING',5300); -INSERT INTO emp_msg VALUES(30,'MARTIN',1550); -INSERT INTO emp_msg VALUES(10,'MILLER',1600); -INSERT INTO emp_msg VALUES(20,'SCOTT',3300); -INSERT INTO emp_msg VALUES(20,'SWITH',1100); -INSERT INTO emp_msg VALUES(30,'TURNER',1800); -INSERT INTO emp_msg VALUES(30,'WARD',1550); -``` - - - -查询 **emp_msg** 表,前 5 个值用 **Jane** 代替,从第 6 个值开始追加按 **ename** 字段升序排列的值。执行以下语句: - -```javascript -SELECT deptno, ename, sal, LAG(ename,5,'Jane') OVER (ORDER BY ename) AS new_ename -FROM emp_msg; -``` - - - -查询结果如下: - -```javascript -+--------+--------+------+-----------+ -| DEPTNO | ENAME | SAL | NEW_ENAME | -+--------+--------+------+-----------+ -| 20 | ADAMS | 1400 | Jane | -| 30 | ALLEN | 1900 | Jane | -| 30 | BLAKE | 3135 | Jane | -| 10 | CLARK | 2750 | Jane | -| 20 | FORD | 3300 | Jane | -| 30 | JAMES | 1250 | ADAMS | -| 20 | JONES | 3275 | ALLEN | -| 10 | KING | 5300 | BLAKE | -| 30 | MARTIN | 1550 | CLARK | -| 10 | MILLER | 1600 | FORD | -| 20 | SCOTT | 3300 | JAMES | -| 20 | SWITH | 1100 | JONES | -| 30 | TURNER | 1800 | KING | -| 30 | WARD | 1550 | MARTIN | -+--------+--------+------+-----------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/16.FIRST_VALUE.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/16.FIRST_VALUE.md deleted file mode 100644 index d2e73c81d..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/16.FIRST_VALUE.md +++ /dev/null @@ -1,94 +0,0 @@ -FIRST_VALUE -================================ - - - -`FIRST_VALUE` 是一个分析函数。它返回有序值中的第一个值。如果集合中的第一个值为 `NULL`,则函数返回`NULL`,除非您指定 `IGNORE NULLS`,该设置对于数据致密化很有用。 - -语法 --------------- - -```javascript -FIRST_VALUE { (expr) [ {RESPECT | IGNORE} NULLS ] | (expr [ {RESPECT | IGNORE} NULLS ]) } OVER (analytic_clause) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|---------------------------|-----------------------------------------------------------------------------------------------------------------------| -| expr | 参数类型不限。 | -| OVER | 使用 `OVER` 子句定义窗口进行计算。 | -| {RESPECT \| IGNORE} NULLS | 表示是否忽略 `NULL` 值。默认值为 `RESPECT NULLS`,考虑 `NULL` 值。 | -| FROM { FIRST \| LAST } | 确定计算方向是从窗口的第一行还是最后一行开始,默认值为 `FROM FIRST`。如果您指定 `IGNORE NULLS`,则 `FIRST_VALUE` 返回集合中的第一个非空值,如果所有值都为 `NULL`,则返回 `NULL`。 | - - - -返回类型 ----------------- - -数据类型不限。 - -示例 --------------- - -建表 **emp_msg** ,并向里面插入数据。执行以下语句: - -```javascript -CREATE TABLE emp_msg(deptno INT, ename VARCHAR(30), sal INT, MGR VARCHAR(30)); -INSERT INTO emp_msg VALUES(10,'CLARK', 2750, 7839); -INSERT INTO emp_msg VALUES(10,'KING', 5300, NULL); -INSERT INTO emp_msg VALUES(10,'MILLER', 1600, 7782); -INSERT INTO emp_msg VALUES(20,'ADAMS', 1400, 7788); -INSERT INTO emp_msg VALUES(20,'FORD', 3300, 7566); -INSERT INTO emp_msg VALUES(20,'JONES', 3275, 7839); -INSERT INTO emp_msg VALUES(20,'SCOTT', 3300, 7566); -INSERT INTO emp_msg VALUES(20,'SMITH', 1100, 7902); -INSERT INTO emp_msg VALUES(30,'ALLEN', 1900, 7698); -INSERT INTO emp_msg VALUES(30,'BLAKE', 3150, 7839); -INSERT INTO emp_msg VALUES(30,'JAMES', 1250, 7698); -INSERT INTO emp_msg VALUES(30,'MARTIN', 1550, 7698); -INSERT INTO emp_msg VALUES(30,'TURNER', 1800, 7698); -INSERT INTO emp_msg VALUES(30,'WARD', 1550, 7698); -``` - - - -查询 **emp_msg** 表中 **sal** 列最高的第一个非空 **MGR** 值作为 **first_MGR** 列。 - -```javascript -SELECT deptno , ename , sal , MGR , -FIRST_VALUE ( MGR ) IGNORE NULLS over ( ORDER BY sal DESC ROWS UNBOUNDED PRECEDING ) AS first_MGR -FROM emp_msg ORDER BY deptno , ename; -``` - - - -查询结果如下: - -```javascript -+--------+--------+------+------+-----------+ -| DEPTNO | ENAME | SAL | MGR | FIRST_MGR | -+--------+--------+------+------+-----------+ -| 10 | CLARK | 2750 | 7839 | 7566 | -| 10 | KING | 5300 | NULL | NULL | -| 10 | MILLER | 1600 | 7782 | 7566 | -| 20 | ADAMS | 1400 | 7788 | 7566 | -| 20 | FORD | 3300 | 7566 | 7566 | -| 20 | JONES | 3275 | 7839 | 7566 | -| 20 | SCOTT | 3300 | 7566 | 7566 | -| 20 | SMITH | 1100 | 7902 | 7566 | -| 30 | ALLEN | 1900 | 7698 | 7566 | -| 30 | BLAKE | 3150 | 7839 | 7566 | -| 30 | JAMES | 1250 | 7698 | 7566 | -| 30 | MARTIN | 1550 | 7698 | 7566 | -| 30 | TURNER | 1800 | 7698 | 7566 | -| 30 | WARD | 1550 | 7698 | 7566 | -+--------+--------+------+------+-----------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/17.LAST_VALUE.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/17.LAST_VALUE.md deleted file mode 100644 index 49881ba0a..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/17.LAST_VALUE.md +++ /dev/null @@ -1,95 +0,0 @@ -LAST_VALUE -=============================== - - - -`LAST_VALUE` 是一个分析函数。它返回一组有序值中的最后一个值。如果集合中的最后一个值为 `NULL`,则该函数将返回为 `NULL`,除非您指定 `IGNORE NULLS`,此设置对数据致密化很有用。 - -语法 --------------- - -```javascript -LAST_VALUE {(expr) [RESPECT|IGNORE NULLS] | (expr [RESPECT|IGNORE NULLS])} -OVER (analytic_clause) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|---------------------------|-------------------------------------------------------------------------------------------------------------------------------| -| OVER | 使用 `OVER` 子句定义窗口进行计算。 | -| expr | 不能将 `LAST_VALUE` 或其他分析函数用于 `expr` 来嵌套分析函数。 | -| FROM { FIRST \| LAST } | 确定计算方向是从窗口的第一行还是最后一行开始,默认值为 `FROM FIRST`。 | -| {RESPECT \| IGNORE} NULLS | 表示是否忽略 `NULL` 值。默认值为 `RESPECT NULLS`,考虑 `NULL` 值。如果您指定 `IGNORE NULLS`,则 `LAST_VALUE` 返回集合中的最后一个非空值,如果所有值都为 `NULL`,则返回 `NULL`。 | - - - -返回类型 ----------------- - -返回值的数据类型不限。 - -示例 --------------- - -建表 **emp_msg** ,并向里面插入数据,执行以下语句: - -```javascript -CREATE TABLE emp_msg(deptno INT, ename varchar(30),sal INT, MGR varchar(30)); -INSERT INTO emp_msg VALUES(10,'CLARK', 2750, 7839); -INSERT INTO emp_msg VALUES(10,'KING', 5300, NULL); -INSERT INTO emp_msg VALUES(10,'MILLER', 1600, 7782); -INSERT INTO emp_msg VALUES(20,'ADAMS', 1400, 7788); -INSERT INTO emp_msg VALUES(20,'FORD', 3300, 7566); -INSERT INTO emp_msg VALUES(20,'JONES', 3275, 7839); -INSERT INTO emp_msg VALUES(20,'SCOTT', 3300, 7566); -INSERT INTO emp_msg VALUES(20,'SMITH', 1100, 7902); -INSERT INTO emp_msg VALUES(30,'ALLEN', 1900, 7698); -INSERT INTO emp_msg VALUES(30,'BLAKE', 3150, 7839); -INSERT INTO emp_msg VALUES(30,'JAMES', 1250, 7698); -INSERT INTO emp_msg VALUES(30,'MARTIN', 1550, 7698); -INSERT INTO emp_msg VALUES(30,'TURNER', 1800, 7698); -INSERT INTO emp_msg VALUES(30,'WARD', 1550, 7698); -``` - - - -查询 **emp_msg** 表中 **sal** 列最低的最后一个非空 **MGR** 值作为 **last_MGR** 列,执行以下语句: - -```javascript -SELECT deptno , ename , sal , MGR , -LAST_VALUE ( MGR ) IGNORE NULLS OVER (ORDER BY sal DESC ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING ) AS last_MGR -FROM emp_msg ORDER BY deptno , ename ; -``` - - - -查询结果如下: - -```javascript -+--------+--------+------+------+----------+ -| DEPTNO | ENAME | SAL | MGR | LAST_MGR | -+--------+--------+------+------+----------+ -| 10 | CLARK | 2750 | 7839 | 7902 | -| 10 | KING | 5300 | NULL | 7902 | -| 10 | MILLER | 1600 | 7782 | 7902 | -| 20 | ADAMS | 1400 | 7788 | 7902 | -| 20 | FORD | 3300 | 7566 | 7902 | -| 20 | JONES | 3275 | 7839 | 7902 | -| 20 | SCOTT | 3300 | 7566 | 7902 | -| 20 | SMITH | 1100 | 7902 | 7902 | -| 30 | ALLEN | 1900 | 7698 | 7902 | -| 30 | BLAKE | 3150 | 7839 | 7902 | -| 30 | JAMES | 1250 | 7698 | 7902 | -| 30 | MARTIN | 1550 | 7698 | 7902 | -| 30 | TURNER | 1800 | 7698 | 7902 | -| 30 | WARD | 1550 | 7698 | 7902 | -+--------+--------+------+------+----------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/18.NTH_VALUE.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/18.NTH_VALUE.md deleted file mode 100644 index c156ba3fc..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/18.NTH_VALUE.md +++ /dev/null @@ -1,95 +0,0 @@ -NTH_VALUE -============================== - - - -`NTH_VALUE` 返回 `analytic_clause` 定义的窗口中第 `n` 行的 `measure_expr` 值。返回的值具有 `measure_expr` 的数据类型。 - -语法 --------------- - -```javascript -NTH_VALUE (measure_expr, n) [ FROM { FIRST | LAST } ][ { RESPECT | IGNORE } NULLS ] OVER (analytic_clause) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|---------------------------|------------------------------------------------------------------------| -| OVER | 使用 `OVER` 子句定义窗口进行计算。 | -| measure_expr | 字段名 | -| n | n 为正数,确定要为其返回测量值的第 n 行,如果 n 是 NULL ,函数将返回错误,如果 n 大于窗口内所有的行数,函数返回 NULL。 | -| FROM { FIRST \| LAST } | 确定计算方向是从窗口的第一行还是最后一行开始,默认值为 `FROM FIRST`。 | -| {RESPECT \| IGNORE} NULLS | 表示是否忽略 `NULL` 值。默认值为 `RESPECT NULLS`,考虑 `NULL` 值。 | - - - -返回类型 ----------------- - -返回值的数据类型不限。 - -示例 --------------- - -创建表 **emp_msg** ,并向里面插入数据。执行以下语句: - -```javascript -CREATE TABLE emp_msg(deptno INT, ename VARCHAR(30),sal INT, MGR VARCHAR(30), hiredate VARCHAR(50)); -INSERT INTO emp_msg VALUES(10,'CLARK', 2750, 7839, '2018-05-01'); -INSERT INTO emp_msg VALUES(10,'KING', 5300, NULL, '2018-05-10'); -INSERT INTO emp_msg VALUES(10,'MILLER', 1600, 7782, '2018-06-01'); -INSERT INTO emp_msg VALUES(20,'ADAMS', 1400, 7788, '2018-05-21'); -INSERT INTO emp_msg VALUES(20,'FORD', 3300, 7566, '2018-06-01'); -INSERT INTO emp_msg VALUES(20,'JONES', 3275, 7839, '2018-06-20'); -INSERT INTO emp_msg VALUES(20,'SCOTT', 3300, 7566, '2018-07-01'); -INSERT INTO emp_msg VALUES(20,'SMITH', 1100, 7902, '2018-07-10'); -INSERT INTO emp_msg VALUES(30,'ALLEN', 1900, 7698, '2018-08-05'); -INSERT INTO emp_msg VALUES(30,'BLAKE', 3150, 7839, '2018-06-10'); -INSERT INTO emp_msg VALUES(30,'JAMES', 1250, 7698, '2018-09-05'); -INSERT INTO emp_msg VALUES(30,'MARTIN', 1550, 7698, '2018-10-01'); -INSERT INTO emp_msg VALUES(30,'TURNER', 1800, 7698, '2019-05-01'); -INSERT INTO emp_msg VALUES(30,'WARD', 1550, 7698, '2019-05-10'); -``` - - - -按部门 **deptno** 分组,查询每个部门的人员的薪资和该部门内排名第三的薪资金额的对比。执行以下语句: - -```javascript -SELECT deptno, ename, sal, nth_value(sal, 3) OVER (PARTITION BY deptno ORDER BY sal DESC -rows BETWEEN unbounded preceding AND unbounded following) AS third_most_sal -FROM emp_msg ORDER BY deptno,sal DESC; -``` - - - -查询结果如下: - -```javascript -+--------+--------+------+----------------+ -| DEPTNO | ENAME | SAL | THIRD_MOST_SAL | -+--------+--------+------+----------------+ -| 10 | KING | 5300 | 1600 | -| 10 | CLARK | 2750 | 1600 | -| 10 | MILLER | 1600 | 1600 | -| 20 | FORD | 3300 | 3275 | -| 20 | SCOTT | 3300 | 3275 | -| 20 | JONES | 3275 | 3275 | -| 20 | ADAMS | 1400 | 3275 | -| 20 | SMITH | 1100 | 3275 | -| 30 | BLAKE | 3150 | 1800 | -| 30 | ALLEN | 1900 | 1800 | -| 30 | TURNER | 1800 | 1800 | -| 30 | MARTIN | 1550 | 1800 | -| 30 | WARD | 1550 | 1800 | -| 30 | JAMES | 1250 | 1800 | -+--------+--------+------+----------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/19.CUME_DIST.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/19.CUME_DIST.md deleted file mode 100644 index 0ab042194..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/19.CUME_DIST.md +++ /dev/null @@ -1,85 +0,0 @@ -CUME_DIST -============================== - - - -`CUME_DIST` 计算一个值在一组值中的累积分布。返回值的范围为 `0 < CUME_DIST <= 1`。领带值总是评估到相同的累积分布值。此函数将可以隐式转换为数字数据类型的任何数字数据类型或任何非数字数据类型作为参数。OceanBase 数据库确定具有最高数值优先级的参数,隐式地将其余参数转换为该数据类型,进行计算并返回 `NUMBER`。 - -作为一个分析函数,`CUME_DIST` 计算指定值在一组值中的相对位置。 对于行 r,假设升序,r 的 cume_dist 是值低于或等于 r 值的行数除以被计算的行数(整个查询结果集或分区)。 - -语法 --------------- - -```javascript -CUME_DIST() OVER ([ query_partition_clause ] order_by_clause) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|---------------------------|---------------------------------------------------| -| expr | `NUMBER` 类型或可隐式转换为 `NUMBER` 类型的表达式 。 | -| {RESPECT \| IGNORE} NULLS | 表示是否忽略 `NULL` 值。默认值为 `RESPECT NULLS`,考虑 `NULL` 值。 | - - - -返回类型 ----------------- - -返回值为 `NUMBER` 数据类型。 - -示例 --------------- - -创建表 **emp_msg** ,并向里面插入数据。执行以下语句: - -```javascript -CREATE TABLE emp_msg(deptno INT, ename varchar(30), sal INT, MGR varchar(30)); -INSERT INTO emp_msg VALUES(10,'CLARK', 2750, 7839); -INSERT INTO emp_msg VALUES(10,'KING', 5300, NULL); -INSERT INTO emp_msg VALUES(10,'MILLER', 1600, 7782); -INSERT INTO emp_msg VALUES(20,'ADAMS', 1400, 7788); -INSERT INTO emp_msg VALUES(20,'FORD', 3300, 7566); -INSERT INTO emp_msg VALUES(20,'JONES', 3275, 7839); -INSERT INTO emp_msg VALUES(20,'SCOTT', 3300, 7566); -INSERT INTO emp_msg VALUES(20,'SMITH', 1100, 7902); -INSERT INTO emp_msg VALUES(30,'ALLEN', 1900, 7698); -INSERT INTO emp_msg VALUES(30,'BLAKE', 3150, 7839); -INSERT INTO emp_msg VALUES(30,'JAMES', 1250, 7698); -INSERT INTO emp_msg VALUES(30,'MARTIN', 1550, 7698); -INSERT INTO emp_msg VALUES(30,'TURNER', 1800, 7698); -INSERT INTO emp_msg VALUES(30,'WARD', 1550, 7698); -``` - - - -返回指定列 **sal** 在同 **deptno** 中的 `CUME_DIST` 的值,执行以下语句: - -```javascript -SELECT deptno , ename , sal, cume_dist ( ) over ( partition BY deptno ORDER BY sal DESC ) "RANK" -FROM emp_msg WHERE sal>2000; -``` - - - -查询结果如下: - -```javascript -+--------+-------+------+-------------------------------------------+ -| DEPTNO | ENAME | SAL | RANK | -+--------+-------+------+-------------------------------------------+ -| 10 | KING | 5300 | .5 | -| 10 | CLARK | 2750 | 1 | -| 20 | FORD | 3300 | .6666666666666666666666666666666666666667 | -| 20 | SCOTT | 3300 | .6666666666666666666666666666666666666667 | -| 20 | JONES | 3275 | 1 | -| 30 | BLAKE | 3150 | 1 | -+--------+-------+------+-------------------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/2.AVG-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/2.AVG-1.md deleted file mode 100644 index b3689269a..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/2.AVG-1.md +++ /dev/null @@ -1,119 +0,0 @@ -AVG -======================== - - - -`AVG` 函数返回数值列的平均值。 - -语法 --------------- - -```javascript -AVG([ DISTINCT | UNIQUE | ALL ] expr) [ OVER (analytic_clause) ] -``` - - - -作为分析函数使用时,您需要使用窗口函数的完整语法,它对一组行的集合进行计算并返回多个值。作为聚合函数使用时,该函数对一组行的集合进行聚合计算,结果只能返回一个值,此时不需要加 `OVER` 关键字。 - -参数 --------------- - - - -| 参数 | 说明 | -|----------|---------------------------------------------------------------------------------| -| DISTINCT | 查询时去除数据中的重复值,且忽略数据中的 NULL 值。 | -| UNIQUE | 查询时去除数据中的重复值,且忽略数据中的 NULL 值。 | -| ALL | 查询时不去除数据中的重复值,且忽略数据中的 NULL 值。`ALL` 为默认值。 | -| expr | 是数值类型或者可以转换成数值类型的表达式。数值类型可以为:`NUMBER`、`FLOAT`、`BINARY_FLOAT` 或 `BINARY_DOUBLE`。 | -| OVER | 使用 `OVER` 子句定义窗口进行计算。 | - - -**注意** - - - -如果您指定了 `DISTINCT` 或 `UNIQUE` 关键字,则 `analytic_clause` 中不允许出现 `order_by_clause` 和 `windowing_clause`。 - -返回类型 ----------------- - -返回类型与参数 `expr` 的数据类型相同。 - -示例 --------------- - -**分析函数示例** - -以下语句创建了表 **employees** ,并向里面插入数据: - -```javascript -CREATE TABLE employees (manager_id INT, last_name varchar(50), hiredate varchar(50), SALARY INT); -INSERT INTO employees VALUES(100, 'De Haan', '2018-05-01',11000); -INSERT INTO employees VALUES(100, 'Errazuriz', '2017-07-21', 1400); -INSERT INTO employees VALUES(100, 'Hartstein', '2019-05-01',14000); -INSERT INTO employees VALUES(100, 'Raphaely', '2017-07-22', 1700); -INSERT INTO employees VALUES(100, 'Weiss', '2019-07-11',13500); -INSERT INTO employees VALUES(100, 'Russell', '2019-10-05', 13000); -INSERT INTO employees VALUES(100, 'Partners', '2018-12-01',14000); -INSERT INTO employees VALUES(200, 'Ross', '2019-06-11',13500); -INSERT INTO employees VALUES(200, 'Bell', '2019-05-25', 13000); -INSERT INTO employees VALUES(200, 'Part', '2018-08-11',14000); -COMMIT; -``` - - - -执行以下语句计算各列的平均值: - -```javascript -SELECT manager_id, last_name, hiredate, salary, AVG(salary) OVER (PARTITION BY manager_id -ORDER BY hiredate ROWS BETWEEN 1 PRECEDING AND 1 FOLLOWING) AS c_mavg -FROM employees ORDER BY manager_id, hiredate, salary; -``` - - - -返回结果如下: - -```javascript -+------------+-----------+------------+--------+------------------------------------------+ -| MANAGER_ID | LAST_NAME | HIREDATE | SALARY | C_MAVG | -+------------+-----------+------------+--------+------------------------------------------+ -| 100 | Errazuriz | 2017-07-21 | 1400 | 1550 | -| 100 | Raphaely | 2017-07-22 | 1700 | 4700 | -| 100 | De Haan | 2018-05-01 | 11000 | 8900 | -| 100 | Partners | 2018-12-01 | 14000 | 13000 | -| 100 | Hartstein | 2019-05-01 | 14000 | 13833.333 | -| 100 | Weiss | 2019-07-11 | 13500 | 13500 | -| 100 | Russell | 2019-10-05 | 13000 | 13250 | -| 200 | Part | 2018-08-11 | 14000 | 13500 | -| 200 | Bell | 2019-05-25 | 13000 | 13500 | -| 200 | Ross | 2019-06-11 | 13500 | 13250 | -+------------+-----------+------------+--------+------------------------------------------+ -``` - - - -**聚合函数示例** - -执行以下语句计算 **salary** 的平均值: - -```javascript -SELECT AVG(salary) FROM employees; -``` - - - -查询结果如下: - -```javascript -+-------------+ -| AVG(SALARY) | -+-------------+ -| 10910 | -+-------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/20.DENSE_RANK.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/20.DENSE_RANK.md deleted file mode 100644 index abf729651..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/20.DENSE_RANK.md +++ /dev/null @@ -1,84 +0,0 @@ -DENSE_RANK -=============================== - - - -`DENSE_RANK` 计算有序行组中行的秩,并将秩作为 `NUMBER` 返回。行列是从 1 开始的连续整数,最大的秩值是查询返回的唯一值的数目。在关系的情况下,秩值不被跳过。具有相同值的排序标准的行接收相同的秩。此函数对于顶部 n 和底部 n 报告是有用的。 - -作为一个分析函数,`DENSE_RANK` 根据 `order_by_clause` 中 `value_exprs` 的值,计算从查询返回的每一行相对于其他行的秩。 - -语法 --------------- - -```javascript -DENSE_RANK( ) OVER([ query_partition_clause ] order_by_clause) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|------|-----------------------| -| OVER | 使用 `OVER` 子句定义窗口进行计算。 | - - - -返回类型 ----------------- - -返回值为 `NUMBER` 数据类型。 - -示例 --------------- - -创建表 **emp_msg** ,并向里面插入数据。执行以下语句: - -```javascript -CREATE TABLE emp_msg(deptno INT, ename varchar(30), sal INT, MGR varchar(30)); -INSERT INTO emp_msg VALUES(10,'CLARK', 2750, 7839); -INSERT INTO emp_msg VALUES(10,'KING', 5300, NULL); -INSERT INTO emp_msg VALUES(10,'MILLER', 1600, 7782); -INSERT INTO emp_msg VALUES(20,'ADAMS', 1400, 7788); -INSERT INTO emp_msg VALUES(20,'FORD', 3300, 7566); -INSERT INTO emp_msg VALUES(20,'JONES', 3275, 7839); -INSERT INTO emp_msg VALUES(20,'SCOTT', 3300, 7566); -INSERT INTO emp_msg VALUES(20,'SMITH', 1100, 7902); -INSERT INTO emp_msg VALUES(30,'ALLEN', 1900, 7698); -INSERT INTO emp_msg VALUES(30,'BLAKE', 3150, 7839); -INSERT INTO emp_msg VALUES(30,'JAMES', 1250, 7698); -INSERT INTO emp_msg VALUES(30,'MARTIN', 1550, 7698); -INSERT INTO emp_msg VALUES(30,'TURNER', 1800, 7698); -INSERT INTO emp_msg VALUES(30,'WARD', 1550, 7698); -``` - - - -分析函数功能示例,执行以下语句: - -```javascript -SELECT deptno, ename, sal, DENSE_RANK ( ) OVER ( partition BY deptno ORDER BY sal DESC ) "RANK" -FROM emp_msg WHERE sal>2000; -``` - - - -查询结果如下: - -```javascript -+--------+-------+------+------+ -| DEPTNO | ENAME | SAL | RANK | -+--------+-------+------+------+ -| 10 | KING | 5300 | 1 | -| 10 | CLARK | 2750 | 2 | -| 20 | SCOTT | 3300 | 1 | -| 20 | FORD | 3300 | 1 | -| 20 | JONES | 3275 | 2 | -| 30 | BLAKE | 3150 | 1 | -+--------+-------+------+------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/21.NTILE.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/21.NTILE.md deleted file mode 100644 index 49156aa24..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/21.NTILE.md +++ /dev/null @@ -1,91 +0,0 @@ -NTILE -========================== - - - -`NTILE` 函数将有序数据集划分为 `expr` 指示的若干桶,并为每一行分配适当的桶号。桶编号为 1 到 `expr`。 对于每个分区,`expr` 值必须解析为正常数。如果 `expr` 是一个非整数常量,则 OceanBase 将该值截断为整数。 返回值为 `NUMBER`。 - -桶中的行数最多可以相差 1,其余值(行数的其余部分除以桶)为每个桶分配一个,从桶 1 开始。如果 `expr` 大于行数,则将填充与行数相等的多个桶,其余的桶将为空。 - -您不能通过使用 `NTILE` 或任何其他分析函数来嵌套分析函数。 但是您可以将其他内置函数表达式用在 `expr` 中。 - -语法 --------------- - -```javascript -NTILE(expr) OVER ([query_partition_clause] order_by_clause) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|------|-----------------------| -| expr | 只能为正常数。 | -| OVER | 使用 `OVER` 子句定义窗口进行计算。 | - - - -返回类型 ----------------- - -返回 `NUMERIC` 类型数据。 - -示例 --------------- - -根据成绩将同学分成四个等级,为学生评奖。创建表 **course** ,并向里面插入数据,执行以下语句: - -```javascript -CREATE TABLE course -( - name VARCHAR(8), - grade NUMBER -); -INSERT INTO course VALUES('Linda',50); -INSERT INTO course VALUES('Tan',85); -INSERT INTO course VALUES('Tom',90); -INSERT INTO course VALUES('John',95); -INSERT INTO course VALUES('Mery',55); -INSERT INTO course VALUES('Peter',60); -INSERT INTO course VALUES('Jack',65); -INSERT INTO course VALUES('Rose',70); -INSERT INTO course VALUES('Tonny',75); -INSERT INTO course VALUES('Apple',80); -COMMIT; -``` - - - -执行以下语句: - -```javascript -SELECT name, grade, ntile(4) OVER (ORDER BY grade DESC) til FROM course; -``` - - - -查询结果如下: - -```javascript -+-------+-------+------+ -| NAME | GRADE | TIL | -+-------+-------+------+ -| John | 95 | 1 | -| Tom | 90 | 1 | -| Tan | 85 | 1 | -| Apple | 80 | 2 | -| Tonny | 75 | 2 | -| Rose | 70 | 2 | -| Jack | 65 | 3 | -| Peter | 60 | 3 | -| Mery | 55 | 4 | -| Linda | 50 | 4 | -+-------+-------+------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/22.PERCENT_RANK.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/22.PERCENT_RANK.md deleted file mode 100644 index ba97fdc5e..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/22.PERCENT_RANK.md +++ /dev/null @@ -1,76 +0,0 @@ -PERCENT_RANK -================================= - - - -`PERCENT_RANK` 函数类似于 `CUME_DIST`(累积分布)函数。 它的返回值范围为 0\~1。任何集合中的第一行的 `PERCENT_RANK` 函数为 0,返回值为 `NUMBER`。 - -语法 --------------- - -```javascript -PERCENT_RANK( ) OVER ([query_partition_clause] order_by_clause) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|------|-----------------------| -| OVER | 使用 `OVER` 子句定义窗口进行计算。 | - - - -返回类型 ----------------- - -返回数值数据类型。 - -示例 --------------- - -根据成绩将同学分成四个等级,为学生评奖。建表 **course_rank** ,并向里面插入数据,执行以下语句: - -```javascript -CREATE TABLE course_rank -( - name VARCHAR(8), - id NUMBER -); -INSERT INTO course_rank VALUES('Linda',1); -INSERT INTO course_rank VALUES('Tan',2); -INSERT INTO course_rank VALUES('Tom',3); -INSERT INTO course_rank VALUES('John',4); -INSERT INTO course_rank VALUES('Mery',5); -COMMIT; -``` - - - -执行以下语句: - -```javascript -SELECT name, id ,percent_rank() OVER (ORDER BY id) AS pr1 FROM course_rank; -``` - - - -查询结果如下: - -```javascript -+-------+------+------+ -| NAME | ID | PR1 | -+-------+------+------+ -| Linda | 1 | 0 | -| Tan | 2 | .25 | -| Tom | 3 | .5 | -| John | 4 | .75 | -| Mery | 5 | 1 | -+-------+------+------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/23.RATIO_TO_REPORT.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/23.RATIO_TO_REPORT.md deleted file mode 100644 index 08e57c47f..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/23.RATIO_TO_REPORT.md +++ /dev/null @@ -1,79 +0,0 @@ -RATIO_TO_REPORT -==================================== - - - -`RATIO_TO_REPORT` 函数计算一个值与一组值之和的比率。 - -语法 --------------- - -```javascript -RATIO_TO_REPORT(expr) OVER ([query_partition_clause]) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|------|-----------------------| -| expr | 只能为正常数。 | -| OVER | 使用 `OVER` 子句定义窗口进行计算。 | - - - -返回类型 ----------------- - -返回数值型数据。 - -示例 --------------- - -根据部分展示员工产出占部门总展出的比例。建表 **product** ,并向里面插入数据,执行以下语句: - -```javascript -CREATE TABLE product (name VARCHAR(8), deptno NUMBER, output NUMBER); -INSERT INTO product VALUES('Linda',100,5050); -INSERT INTO product VALUES('Tan',1001,8500); -INSERT INTO product VALUES('Tom',1001,3900); -INSERT INTO product VALUES('John',100,29500); -INSERT INTO product VALUES('Mery',1001,1500); -INSERT INTO product VALUES('Peter',100,1060); -COMMIT; -``` - - - -执行以下语句: - -```javascript -SELECT name, OUTPUT, deptno, RATIO_TO_REPORT(output) OVER (partition BY deptno) FROM product; -``` - - - - - -查询结果如下: - - - -```javascript -+-------+--------+--------+------------------------------------------------+ -| NAME | OUTPUT | DEPTNO | RATIO_TO_REPORT(OUTPUT)OVER(PARTITIONBYDEPTNO) | -+-------+--------+--------+------------------------------------------------+ -| Linda | 5050 | 100 | .1418140971637180567256388654872226902555 | -| John | 29500 | 100 | .8284189834316203313675933726481325470373 | -| Peter | 1060 | 100 | .0297669194046616119067677618646447627071 | -| Tan | 8500 | 1001 | .6115107913669064748201438848920863309353 | -| Tom | 3900 | 1001 | .2805755395683453237410071942446043165468 | -| Mery | 1500 | 1001 | .107913669064748201438848920863309352518 | -+-------+--------+--------+------------------------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/24.ROW_NUMBER.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/24.ROW_NUMBER.md deleted file mode 100644 index 884d0e59c..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/24.ROW_NUMBER.md +++ /dev/null @@ -1,74 +0,0 @@ -ROW_NUMBER -=============================== - - - -`ROW_NUMBER` 函数为应用它的每一行分配一个唯一的数字(无论是分区中的每一行还是查询返回的每一行),按照`order_by_clause` 中指定的行的有序序列,从 1 开始,通过在检索指定范围的 `ROW_NUMBER` 的查询中使用子查询嵌套一个子查询,您可以从内部查询的结果中找到一个精确的行子集。 此函数的使用允许您实现 `top-n`、`bottom-n` 和 `inner-n` 报告。对于一致的结果,查询必须确保确定的排序顺序。 - -语法 --------------- - -```javascript -ROW_NUMBER( ) OVER ([ query_partition_clause ] order_by_clause) -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|------|-----------------------| -| OVER | 使用 `OVER` 子句定义窗口进行计算。 | - - - -返回类型 ----------------- - -返回数值型数据。 - -示例 --------------- - -以部门为单位根据员工的产出进行排名。建表 **product** ,并向里面插入数据。执行以下语句: - -```javascript -CREATE TABLE product(name VARCHAR(8), deptno NUMBER, output NUMBER); -INSERT INTO product VALUES('Linda',100,5050); -INSERT INTO product VALUES('Tan',1001,8500); -INSERT INTO product VALUES('Tom',1001,3900); -INSERT INTO product VALUES('John',100,29500); -INSERT INTO product VALUES('Mery',1001,1500); -INSERT INTO product VALUES('Peter',100,1060); -COMMIT; -``` - - - -执行以下语句: - -```javascript -SELECT name,OUTPUT,deptno,ROW_NUMBER() OVER (partition BY deptno ORDER BY OUTPUT DESC) FROM product; -``` - - - -查询结果如下: - -```javascript -+-------+--------+--------+------------------------------------------------------+ -| NAME | OUTPUT | DEPTNO | ROW_NUMBER()OVER(PARTITIONBYDEPTNOORDERBYOUTPUTDESC) | -+-------+--------+--------+------------------------------------------------------+ -| John | 29500 | 100 | 1 | -| Linda | 5050 | 100 | 2 | -| Peter | 1060 | 100 | 3 | -| Tan | 8500 | 1001 | 1 | -| Tom | 3900 | 1001 | 2 | -| Mery | 1500 | 1001 | 3 | -+-------+--------+--------+------------------------------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/25.wmsys-wm_concat-and-wm_concat-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/25.wmsys-wm_concat-and-wm_concat-1.md deleted file mode 100644 index 08dc0589d..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/25.wmsys-wm_concat-and-wm_concat-1.md +++ /dev/null @@ -1,126 +0,0 @@ -WMSYS.WM_CONCAT/WM_CONCAT -============================================== - - - -`WM_CONCAT` 函数用于列转行,将度量列的值进行合并。作为单个集合的聚合函数,`WM_CONCAT` 对所有行进行操作并返回单个输出行。作为组集聚合,`WM_CONCAT` 将对 `GROUP BY` 子句定义的每个组进行操作并返回输出行。作为分析函数,`WM_CONCAT` 基于 `query_partition_clause` 中的一个或多个表达式将查询结果集分为几组。 - -语法 --------------- - -```javascript -WM_CONCAT ([DISTINCT] measure_expr) [OVER query_partition_clause] -``` - - - -作为分析函数使用时,您需要使用窗口函数的完整语法,它对一组行的集合进行计算并返回多个值。作为聚合函数使用时,该函数对一组行的集合进行聚合计算,结果只能返回一个值,此时不需要加 `OVER` 关键字。 - -参数 --------------- - - - -| 参数 | 说明 | -|--------------|-----------------------------| -| OVER | 使用 `OVER` 子句定义窗口进行计算。 | -| measure_expr | 可以是任何表达式。度量列中的空值将被忽略。 | -| DISTINCT | 如果指定 DISTINCT,会在返回结果中删除重复值。 | - - - -返回类型 ----------------- - -返回的数据类型为 `CLOB`。 - -示例 --------------- - -**分析函数示例** - -建表 **employees** ,并向里面插入数据,执行以下语句: - -```javascript -CREATE TABLE employees (department_id INT,manager_id INT,last_name varchar(50),hiredate varchar(50),SALARY INT); -INSERT INTO employees VALUES(30, 100, 'Raphaely', '2017-07-01', 1700); -INSERT INTO employees VALUES(30, 100, 'De Haan', '2018-05-01',11000); -INSERT INTO employees VALUES(40, 100, 'Errazuriz', '2017-07-21', 1400); -INSERT INTO employees VALUES(50, 100, 'Hartstein', '2019-05-01',14000); -INSERT INTO employees VALUES(50, 100, 'Raphaely', '2017-07-22', 1700); -INSERT INTO employees VALUES(70, 100, 'Weiss', '2019-07-11',13500); -INSERT INTO employees VALUES(90, 100, 'Russell', '2019-10-05', 13000); -INSERT INTO employees VALUES(90,100, 'Partners', '2018-12-01',14000); -``` - - - -查询 2019 年 10 月 10 日之前雇用的雇员,以及该雇员的部门,雇用日期以及该部门中的其他雇员。执行以下语句: - -```javascript -SELECT department_id "Dept", hiredate "Date", last_name "Name",wmsys.wm_concat(last_name) - OVER (PARTITION BY department_id) as "Emp_list" -FROM employees WHERE hiredate < '2019-10-10' ORDER BY "Dept", "Date", "Name"; -``` - - - -查询结果如下: - -```javascript -+------+------------+-----------+--------------------+ -| Dept | Date | Name | Emp_list | -+------+------------+-----------+--------------------+ -| 30 | 2017-07-01 | Raphaely | Raphaely,De Haan | -| 30 | 2018-05-01 | De Haan | Raphaely,De Haan | -| 40 | 2017-07-21 | Errazuriz | Errazuriz | -| 50 | 2017-07-22 | Raphaely | Hartstein,Raphaely | -| 50 | 2019-05-01 | Hartstein | Hartstein,Raphaely | -| 70 | 2019-07-11 | Weiss | Weiss | -| 90 | 2018-12-01 | Partners | Russell,Partners | -| 90 | 2019-10-05 | Russell | Russell,Partners | -+------+------------+-----------+--------------------+ -8 rows in set (0.01 sec) -``` - - - -**聚合函数示例** - -建表 **employees** ,并向里面插入数据,执行以下语句: - -```javascript -CREATE TABLE employees (department_id INT,manager_id INT,last_name varchar(50),hiredate varchar(50),SALARY INT); -INSERT INTO employees VALUES(30, 100, 'Raphaely', '2017-07-01', 1700); -INSERT INTO employees VALUES(30, 100, 'De Haan', '2018-05-01',11000); -INSERT INTO employees VALUES(30, 100, 'Errazuriz', '2017-07-01', 1400); -INSERT INTO employees VALUES(30, 100, 'Hartstein', '2019-05-01',14000); -INSERT INTO employees VALUES(30, 100, 'Raphaely', '2017-07-01', 1700); -INSERT INTO employees VALUES(30, 100, 'Weiss', '2019-07-01',13500); -INSERT INTO employees VALUES(30, 100, 'Russell', '2019-07-01', 13000); -INSERT INTO employees VALUES(30,100, 'Partners', '2018-12-01',14000); -``` - - - -查询第 30 部门的所有员工,并查找最早的雇用日期。执行以下语句: - -```javascript -SELECT wmsys.wm_concat(last_name) as "Emp_list", MIN(hiredate) as "Earliest" -FROM employees WHERE department_id = 30; -``` - - - -查询结果如下: - -```javascript -+----------------------------------------------------------------------+------------+ -| Emp_list | Earliest | -+----------------------------------------------------------------------+------------+ -| Raphaely,De Haan,Errazuriz,Hartstein,Raphaely,Weiss,Russell,Partners | 2017-07-01 | -+----------------------------------------------------------------------+------------+ -1 row in set (0.01 sec) -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/3.COUNT-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/3.COUNT-1.md deleted file mode 100644 index 281d087d6..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/3.COUNT-1.md +++ /dev/null @@ -1,163 +0,0 @@ -COUNT -========================== - - - -`COUNT` 函数用于查询 `expr` 的行数。 - -语法 --------------- - -```javascript -COUNT({ * | [ DISTINCT | UNIQUE | ALL ] expr }) [ OVER (analytic_clause) ] -``` - - - -作为分析函数使用时,您需要使用窗口函数的完整语法,它对一组行的集合进行计算并返回多个值 。作为聚合函数使用时,该函数对一组行的集合进行聚合计算,结果只能返回一个值,此时不需要加 `OVER` 关键字。 - -参数 --------------- - - - -| 参数 | 说明 | -|----------|---------------------------------------------------------------------------------| -| \* | 表示满足条件的所有行,且包含值为 NULL 的行。 | -| DISTINCT | 返回的行中去除重复行,且忽略值为 NULL 的行。 | -| UNIQUE | 返回的行中去除重复行,且忽略值为 NULL 的行。 | -| ALL | 返回所有值,包含重复行,且忽略值为 NULL 的行。 | -| expr | 是数值类型或者可以转换成数值类型的表达式。数值类型可以为:`NUMBER`、`FLOAT`、`BINARY_FLOAT` 或 `BINARY_DOUBLE`。 | -| OVER | 使用 OVER 子句定义窗口进行计算。 | - - -**注意** - - - -* 对于 `COUNT` 函数,从不返回 `NULL`,如果指定了 `expr`,即返回 `expr` 不为 `NULL` 的统计个数,如果指定 `COUNT(*)` 返回所有行的统计数目。使用参数 `DISTINCT` 、`UNIQUE` 或 `ALL` 时需要与 `expr` 用空格隔开。 - - - -* 如果您指定了 `DISTINCT` 或 `UNIQUE` 关键字,则 `analytic_clause` 中不允许出现 `order_by_clause` 和 `windowing_clause`。 - - - - - - -返回类型 ----------------- - -返回类型与参数 `expr` 的数据类型相同。 - -示例 --------------- - -以下语句创建了表 **employees** ,并向里面插入数据: - -```javascript -CREATE TABLE employees(manager_id INT,last_name varchar(50),hiredate varchar(50),SALARY INT); -INSERT INTO employees VALUES(300, 'Wei', '2019-09-11',23600); -INSERT INTO employees VALUES(200, 'Red', '2019-11-05', 23800); -INSERT INTO employees VALUES(100, 'Part', '2018-10-01',24000); -INSERT INTO employees VALUES(200, 'Ross', '2019-06-11',23500); -INSERT INTO employees VALUES(200, 'Bell', '2019-05-25', 23000); -INSERT INTO employees VALUES(200, 'Part', '2018-06-11',24500); -INSERT INTO employees VALUES(100, 'De Haan', '2018-05-01',11000); -INSERT INTO employees VALUES(100, 'Errazuriz', '2017-07-21', 1400); -INSERT INTO employees VALUES(100, 'Hartstein', '2019-05-01',14000); -COMMIT; -``` - - - -**分析函数示例** - -执行以下语句查询表中的行数: - -```javascript -SELECT last_name, salary,COUNT(*) OVER (ORDER BY salary RANGE BETWEEN 50 PRECEDING -AND 150 FOLLOWING) AS mov_count FROM employees ORDER BY salary, last_name; -``` - - - -查询结果如下: - -```javascript -+-----------+--------+-----------+ -| LAST_NAME | SALARY | MOV_COUNT | -+-----------+--------+-----------+ -| Errazuriz | 1400 | 1 | -| De Haan | 11000 | 1 | -| Hartstein | 14000 | 1 | -| Bell | 23000 | 1 | -| Ross | 23500 | 2 | -| Wei | 23600 | 1 | -| Red | 23800 | 1 | -| Part | 24000 | 1 | -| Part | 24500 | 1 | -+-----------+--------+-----------+ -``` - - - -**聚合函数示例** - -创建表 **a** ,并向里面插入数据。执行以下语句: - -```javascript -CREATE TABLE a ( -b INT -); -INSERT INTO a VALUES (1); -INSERT INTO a VALUES (null); -INSERT INTO a VALUES (null); -INSERT INTO a VALUES (1); -INSERT INTO a VALUES (null); -INSERT INTO a VALUES (1); -INSERT INTO a VALUES (1); -``` - - - -返回表 **a** 值不为 NULL 的统计个数,执行以下语句: - -```javascript -SELECT COUNT(b) FROM a; -``` - - - -查询结果如下: - -```javascript -+----------+ -| COUNT(B) | -+----------+ -| 4 | -+----------+ -``` - - - -指定 `COUNT(*)` 返回所有行的统计数目,执行以下语句: - -```javascript -SELECT COUNT(*) FROM a; -``` - - - -查询结果如下: - -```javascript -+----------+ -| COUNT(*) | -+----------+ -| 7 | -+----------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/4.KEEP-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/4.KEEP-1.md deleted file mode 100644 index 5b2671732..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/4.KEEP-1.md +++ /dev/null @@ -1,134 +0,0 @@ -KEEP -========================= - - - -`KEEP` 函数用于对一组行中的值进行操作,将这组行按照给定的排序规则排序后返回排在第一或最后的值。作为聚合函数,`KEEP` 对所有行进行操作并返回单个输出行。作为分析函数,`KEEP` 基于 `query_partition_clause` 中的一个或多个表达式将查询结果集分为几组。 - -`KEEP` 函数必须与 `MIN`、`MAX`、`SUM`、`AVG`、`COUNT`、`VARIANCE` 或 `STDDEV` 函数一起使用。 - -语法 --------------- - -```javascript -KEEP (DENSE_RANK {FIRST | LAST} ORDER BY expr [ DESC | ASC ] [ NULLS { FIRST | LAST } ] [, expr [ DESC | ASC ] [ NULLS { FIRST | LAST } ]]... ) -[ OVER ( [query_partition_clause] ) ] -``` - - - -作为分析函数使用时,您需要使用窗口函数的完整语法,它对一组行的集合进行计算并返回多个值。作为聚合函数使用时,该函数对一组行的集合进行聚合计算,结果只能返回一个值,此时不需要加 `OVER` 关键字。 - -参数 --------------- - - - -| 参数 | 说明 | -|------|-----------------------| -| OVER | 使用 `OVER` 子句定义窗口进行计算。 | -| expr | 可以是任何表达式。度量列中的空值将被忽略。 | - - - -返回类型 ----------------- - -返回与度量列相同的数据类型。 - -示例 --------------- - -**分析函数示例** - -建表 **employees** ,并向里面插入数据,执行以下语句: - -```javascript -CREATE TABLE employees (department_id INT,manager_id INT,last_name varchar(50),hiredate varchar(50),SALARY INT); -INSERT INTO employees VALUES(30, 100, 'Raphaely', '2017-07-01', 1700); -INSERT INTO employees VALUES(30, 100, 'De Haan', '2018-05-01',11000); -INSERT INTO employees VALUES(40, 100, 'Errazuriz', '2017-07-21', 1400); -INSERT INTO employees VALUES(50, 100, 'Hartstein', '2019-10-05',14000); -INSERT INTO employees VALUES(50, 100, 'Raphaely', '2017-07-22', 1700); -INSERT INTO employees VALUES(50, 100, 'Weiss', '2019-10-05',13500); -INSERT INTO employees VALUES(90, 100, 'Russell', '2019-07-11', 13000); -INSERT INTO employees VALUES(90,100, 'Partners', '2018-12-01',14000); -``` - - - -对于每个部门:按照薪水排序,对排在第一的员工的薪水求和;按照雇用日期排序,对排在最后的员工的薪水求和。执行以下语句: - -```javascript -SELECT last_name, department_id, salary, - SUM(salary) KEEP (DENSE_RANK FIRST ORDER BY salary) - OVER (PARTITION BY department_id) "Worst", - SUM(salary) KEEP (DENSE_RANK LAST ORDER BY HIREDATE) - OVER (PARTITION BY department_id) "Best" - FROM employees - ORDER BY department_id, salary, last_name; -``` - - - -查询结果如下: - -```javascript -+-----------+---------------+--------+-------+-------+ -| LAST_NAME | DEPARTMENT_ID | SALARY | Worst | Best | -+-----------+---------------+--------+-------+-------+ -| Raphaely | 30 | 1700 | 1700 | 11000 | -| De Haan | 30 | 11000 | 1700 | 11000 | -| Errazuriz | 40 | 1400 | 1400 | 1400 | -| Raphaely | 50 | 1700 | 1700 | 27500 | -| Weiss | 50 | 13500 | 1700 | 27500 | -| Hartstein | 50 | 14000 | 1700 | 27500 | -| Russell | 90 | 13000 | 13000 | 13000 | -| Partners | 90 | 14000 | 13000 | 13000 | -+-----------+---------------+--------+-------+-------+ -8 rows in set (0.01 sec) -``` - - - -**聚合函数示例** - -建表 **employees** ,并向里面插入数据,执行以下语句: - -```javascript -CREATE TABLE employees (department_id INT,manager_id INT,last_name varchar(50),hiredate varchar(50),SALARY INT); -INSERT INTO employees VALUES(30, 100, 'Raphaely', '2017-07-01', 1700); -INSERT INTO employees VALUES(30, 100, 'De Haan', '2018-05-01',11000); -INSERT INTO employees VALUES(40, 100, 'Errazuriz', '2017-07-21', 1400); -INSERT INTO employees VALUES(50, 100, 'Hartstein', '2019-10-05',14000); -INSERT INTO employees VALUES(50, 100, 'Raphaely', '2017-07-22', 1700); -INSERT INTO employees VALUES(50, 100, 'Weiss', '2019-10-05',13500); -INSERT INTO employees VALUES(90, 100, 'Russell', '2019-07-11', 13000); -INSERT INTO employees VALUES(90,100, 'Partners', '2018-12-01',14000); -``` - - - -按照薪水排序,对排在第一的员工的薪水求和;按照雇用日期排序,对排在最后的员工的薪水求和。执行以下语句: - -```javascript -SELECT - SUM(salary) KEEP (DENSE_RANK FIRST ORDER BY salary) "Worst", - SUM(salary) KEEP (DENSE_RANK LAST ORDER BY HIREDATE) "Best" - FROM employees; -``` - - - -查询结果如下: - -```javascript -+-------+-------+ -| Worst | Best | -+-------+-------+ -| 1400 | 27500 | -+-------+-------+ -1 row in set (0.00 sec) -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/5.SUM-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/5.SUM-1.md deleted file mode 100644 index 41fada3ec..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/5.SUM-1.md +++ /dev/null @@ -1,117 +0,0 @@ -SUM -======================== - - - -`SUM` 函数返回参数中指定列的和。此函数将可以隐式转换为数值数据类型的任何数值数据类型或任何非数值数据类型作为参数。 函数返回与参数的数值数据类型相同的数据类型。 - -语法 --------------- - -```javascript -SUM([ DISTINCT | UNQIUE | ALL ] expr) [ OVER (analytic_clause) ] -``` - - - -作为分析函数使用时,您需要使用窗口函数的完整语法,它对一组行的集合进行计算并返回多个值。作为聚合函数使用时,该函数对一组行的集合进行聚合计算,结果只能返回一个值,此时不需要加 `OVER` 关键字。 - -参数 --------------- - - - -| 参数 | 说明 | -|----------|---------------------------------------| -| DISTINCT | 去除重复行,且忽略值为 NULL 的行。 | -| UNQIUE | 去除重复行,且忽略值为 NULL 的行。 | -| ALL | 返回所有值,包含重复行,且忽略值为 NULL 的行。 | -| expr | 可为数值、字符、日期型或其它类型的数据列或表达式。 | -| OVER | 使用 `OVER` 子句定义窗口进行计算。 | - - -**注意** - -: - -如果您指定了`DISTINCT` 或 `UNIQUE` 关键字,则 `analytic_clause` 中不允许出现 `order_by_clause` 和 `windowing_clause`。 - -返回类型 ----------------- - -返回与 `expr` 相同数据类型的值。 - -示例 --------------- - -**分析函数示例** - -创建表 **employees** ,并向里面插入数据,执行以下语句: - -```javascript -CREATE TABLE employees(manager_id INT,last_name varchar(50),hiredate varchar(50),SALARY INT); -INSERT INTO employees VALUES(300, 'Wei', '2019-09-11',23600); -INSERT INTO employees VALUES(200, 'Red', '2019-11-05', 23800); -INSERT INTO employees VALUES(100, 'Part', '2018-10-01',24000); -INSERT INTO employees VALUES(200, 'Ross', '2019-06-11',23500); -INSERT INTO employees VALUES(200, 'Bell', '2019-05-25', 23000); -INSERT INTO employees VALUES(200, 'Part', '2018-06-11',24500); -INSERT INTO employees VALUES(100, 'De Haan', '2018-05-01',11000); -INSERT INTO employees VALUES(100, 'Errazuriz', '2017-07-21', 1400); -INSERT INTO employees VALUES(100, 'Hartstein', '2019-05-01',14000); -COMMIT; -``` - - - -计算工资总额,执行以下语句: - -```javascript -SELECT manager_id, last_name, salary, SUM(salary) OVER (PARTITION BY manager_id -ORDER BY salary RANGE UNBOUNDED PRECEDING) l_csum -FROM employees ORDER BY manager_id, last_name, salary, l_csum; -``` - - - -查询结果如下: - -```javascript -+------------+-----------+--------+--------+ -| MANAGER_ID | LAST_NAME | SALARY | L_CSUM | -+------------+-----------+--------+--------+ -| 100 | De Haan | 11000 | 12400 | -| 100 | Errazuriz | 1400 | 1400 | -| 100 | Hartstein | 14000 | 26400 | -| 100 | Part | 24000 | 50400 | -| 200 | Bell | 23000 | 23000 | -| 200 | Part | 24500 | 94800 | -| 200 | Red | 23800 | 70300 | -| 200 | Ross | 23500 | 46500 | -| 300 | Wei | 23600 | 23600 | -+------------+-----------+--------+--------+ -``` - - - -**聚合函数示例** - -计算工资总额,执行以下语句: - -```javascript -SELECT SUM(salary) FROM employees; -``` - - - -查询结果如下: - -```javascript -+-------------+ -| SUM(SALARY) | -+-------------+ -| 168800 | -+-------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/6.MAX-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/6.MAX-1.md deleted file mode 100644 index 82de7e2b2..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/6.MAX-1.md +++ /dev/null @@ -1,106 +0,0 @@ -MAX -======================== - - - -`MAX` 函数返回参数中指定的列中的最大值。 - -语法 --------------- - -```javascript -MAX([ DISTINCT | UNIQUE | ALL ] expr) [ OVER (analytic_clause) ] -``` - - - -作为分析函数使用时,您需要使用窗口函数的完整语法,它对一组行的集合进行计算并返回多个值。作为聚合函数使用时,该函数对一组行的集合进行聚合计算,结果只能返回一个值,此时不需要加 `OVER` 关键字。 - -参数 --------------- - - - -| 参数 | 说明 | -|----------|----------------------------| -| DISTINCT | 返回的行中去除重复行,且忽略值为 NULL 的行。 | -| UNIQUE | 返回的行中去除重复行,且忽略值为 NULL 的行。 | -| ALL | 返回所有值,包含重复行,且忽略值为 NULL 的行。 | -| expr | 可为数值、字符、日期型或其它类型的数据列或表达式。 | -| OVER | 使用 `OVER` 子句定义窗口进行计算。 | - - - -返回类型 ----------------- - -返回与 `expr` 相同的数据类型值。 - -示例 --------------- - -**分析函数示例** - -以下语句创建了表 **employees** ,并向里面插入数据: - -```javascript -CREATE TABLE employees (manager_id INT, last_name varchar(50), hiredate varchar(50), SALARY INT); -INSERT INTO employees VALUES(100, 'Wei', '2019-09-11',17000); -INSERT INTO employees VALUES(100, 'Red', '2019-11-05', 17000); -INSERT INTO employees VALUES(101, 'Part', '2018-10-01',12008); -INSERT INTO employees VALUES(102, 'Wei', '2019-09-11',9000); -INSERT INTO employees VALUES(103, 'Red', '2019-11-05', 6000); -INSERT INTO employees VALUES(104, 'Part', '2018-10-01',8000); -COMMIT; -``` - - - -执行以下语句查询 **SALARY** 列的最大值: - -```javascript -SELECT manager_id, last_name, salary FROM (SELECT manager_id, last_name, salary, -MAX(salary) OVER (PARTITION BY manager_id) AS rmax_sal -FROM employees) WHERE salary = rmax_sal ORDER BY manager_id, last_name, salary; -``` - - - -查询结果如下: - -```javascript -+------------+-----------+--------+ -| MANAGER_ID | LAST_NAME | SALARY | -+------------+-----------+--------+ -| 100 | Red | 17000 | -| 100 | Wei | 17000 | -| 101 | Part | 12008 | -| 102 | Wei | 9000 | -| 103 | Red | 6000 | -| 104 | Part | 8000 | -+------------+-----------+--------+ -``` - - - -**聚合函数示例** - -执行以下语句查询 **SALARY** 列的最大值: - -```javascript -SELECT MAX(salary) FROM employees; -``` - - - -查询结果如下: - -```javascript -+-------------+ -| MAX(SALARY) | -+-------------+ -| 17000 | -+-------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/7.MIN-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/7.MIN-1.md deleted file mode 100644 index 6634c0504..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/7.MIN-1.md +++ /dev/null @@ -1,116 +0,0 @@ -MIN -======================== - - - -`MIN` 函数返回参数中指定列的最小值。 - -语法 --------------- - -```javascript -MIN([ DISTINCT | UNIQUE | ALL ] expr) [ OVER (analytic_clause) ] -``` - - - -作为分析函数使用时,您需要使用窗口函数的完整语法,它对一组行的集合进行计算并返回多个值。作为聚合函数使用时,该函数对一组行的集合进行聚合计算,结果只能返回一个值,此时不需要加 `OVER` 关键字。 - -参数 --------------- - - - -| **参数** | **说明** | -|----------|----------------------------| -| DISTINCT | 返回的行中去除重复行,且忽略值为 NULL 的行。 | -| UNIQUE | 返回的行中去除重复行,且忽略值为 NULL 的行。 | -| ALL | 返回所有值,包含重复行,且忽略值为 NULL 的行。 | -| expr | 可为数值、字符、日期型或其它类型的数据列或表达式。 | -| OVER | 使用 OVER 子句定义窗口进行计算。 | - - - -返回类型 ----------------- - -返回与 `expr` 相同数据类型的值。 - -示例 --------------- - -**分析函数示例** - -以下语句创建了表 **employees** ,并向里面插入数据: - -```javascript -CREATE TABLE employees (manager_id INT,last_name varchar(50),hiredate varchar(50),SALARY INT); -INSERT INTO employees VALUES(100, 'Raphaely', '2017-07-01', 1700); -INSERT INTO employees VALUES(100, 'De Haan', '2018-05-01',11000); -INSERT INTO employees VALUES(100, 'Errazuriz', '2017-07-21', 1400); -INSERT INTO employees VALUES(100, 'Hartstein', '2019-05-01',14000); -INSERT INTO employees VALUES(100, 'Raphaely', '2017-07-22', 1700); -INSERT INTO employees VALUES(100, 'Weiss', '2019-07-11',13500); -INSERT INTO employees VALUES(100, 'Russell', '2019-10-05', 13000); -INSERT INTO employees VALUES(100, 'Partners', '2018-12-01',14000); -INSERT INTO employees VALUES(200, 'Ross', '2019-06-11',13500); -INSERT INTO employees VALUES(200, 'Bell', '2019-05-25', 13000); -INSERT INTO employees VALUES(200, 'Part', '2018-08-11',14000); -``` - - - -执行以下语句查询 **SALARY** 列的最小值: - -```javascript -SELECT manager_id, last_name, hiredate, salary, MIN(salary) OVER(PARTITION BY manager_id -ORDER BY hiredate RANGE UNBOUNDED PRECEDING) AS p_cmin -FROM employees ORDER BY manager_id, last_name, hiredate, salary; -COMMIT; -``` - - - -查询结果如下: - -```javascript -+------------+-----------+------------+--------+--------+ -| MANAGER_ID | LAST_NAME | HIREDATE | SALARY | P_CMIN | -+------------+-----------+------------+--------+--------+ -| 100 | De Haan | 2018-05-01 | 11000 | 1400 | -| 100 | Errazuriz | 2017-07-21 | 1400 | 1400 | -| 100 | Hartstein | 2019-05-01 | 14000 | 1400 | -| 100 | Partners | 2018-12-01 | 14000 | 1400 | -| 100 | Raphaely | 2017-07-01 | 1700 | 1700 | -| 100 | Raphaely | 2017-07-22 | 1700 | 1400 | -| 100 | Russell | 2019-10-05 | 13000 | 1400 | -| 100 | Weiss | 2019-07-11 | 13500 | 1400 | -| 200 | Bell | 2019-05-25 | 13000 | 13000 | -| 200 | Part | 2018-08-11 | 14000 | 14000 | -| 200 | Ross | 2019-06-11 | 13500 | 13000 | -+------------+-----------+------------+--------+--------+ -``` - - - -**聚合函数示例** - -执行以下语句查询 **SALARY** 列的最小值: - -```javascript -SELECT MIN(salary) FROM employees ; -``` - - - -查询结果如下: - -```javascript -+-------------+ -| MIN(SALARY) | -+-------------+ -| 1400 | -+-------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/8.LISTAGG-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/8.LISTAGG-1.md deleted file mode 100644 index d3c74325a..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/8.LISTAGG-1.md +++ /dev/null @@ -1,125 +0,0 @@ -LISTAGG -============================ - - - -`LISTAGG` 函数用于列转行,`LISTAGG` 对 `ORDER BY` 子句中指定的每个组内的数据进行排序,然后合并度量列的值。作为单个集合的聚合函数,`LISTAGG` 对所有行进行操作并返回单个输出行。作为组集聚合,`LISTAGG` 将对 `GROUP BY` 子句定义的每个组进行操作并返回输出行。作为分析函数,`LISTAGG` 基于 `query_partition_clause` 中的一个或多个表达式将查询结果集分为几组。 - -语法 --------------- - -```javascript -LISTAGG(measure_expr [,'delimiter'])WITHIN GROUP (order_by_clause) -[OVER query_partition_clause] -``` - - - -作为分析函数使用时,您需要使用窗口函数的完整语法,它对一组行的集合进行计算并返回多个值。作为聚合函数使用时,该函数对一组行的集合进行聚合计算,结果只能返回一个值,此时不需要加 `OVER` 关键字。 - -参数 --------------- - - - -| 参数 | 说明 | -|--------------|---------------------------------| -| OVER | 使用 `OVER` 子句定义窗口进行计算。 | -| measure_expr | 可以是任何表达式。度量列中的空值将被忽略。 | -| delimiter | 指定用于分隔度量值的字符串。此子句是可选的,默认为 NULL。 | - - - -返回类型 ----------------- - -如果度量列是 `RAW` 的,则返回数据类型为 `RAW`,否则返回值为 `VARCHAR2` 型。 - -示例 --------------- - -**分析函数示例** - -建表 **employees** ,并向里面插入数据,执行以下语句: - -```javascript -CREATE TABLE employees (department_id INT,manager_id INT,last_name varchar(50),hiredate varchar(50),SALARY INT); -INSERT INTO employees VALUES(30, 100, 'Raphaely', '2017-07-01', 1700); -INSERT INTO employees VALUES(30, 100, 'De Haan', '2018-05-01',11000); -INSERT INTO employees VALUES(40, 100, 'Errazuriz', '2017-07-21', 1400); -INSERT INTO employees VALUES(50, 100, 'Hartstein', '2019-05-01',14000); -INSERT INTO employees VALUES(50, 100, 'Raphaely', '2017-07-22', 1700); -INSERT INTO employees VALUES(70, 100, 'Weiss', '2019-07-11',13500); -INSERT INTO employees VALUES(90, 100, 'Russell', '2019-10-05', 13000); -INSERT INTO employees VALUES(90,100, 'Partners', '2018-12-01',14000); -``` - - - -查询 2019 年 10 月 10 日之前雇用的雇员,以及该雇员的部门,雇用日期以及该部门中的其他雇员。执行以下语句: - -```javascript -SELECT department_id "Dept", hiredate "Date", last_name "Name",LISTAGG(last_name, '; ') WITHIN GROUP -(ORDER BY hiredate, last_name) OVER (PARTITION BY department_id) as "Emp_list" -FROM employees WHERE hiredate < '2019-10-10' ORDER BY "Dept", "Date", "Name"; -``` - - - -查询结果如下: - -```javascript -+------+------------+-----------+---------------------+ -| Dept | Date | Name | Emp_list | -+------+------------+-----------+---------------------+ -| 30 | 2017-07-01 | Raphaely | Raphaely; De Haan | -| 30 | 2018-05-01 | De Haan | Raphaely; De Haan | -| 40 | 2017-07-21 | Errazuriz | Errazuriz | -| 50 | 2017-07-22 | Raphaely | Raphaely; Hartstein | -| 50 | 2019-05-01 | Hartstein | Raphaely; Hartstein | -| 70 | 2019-07-11 | Weiss | Weiss | -| 90 | 2018-12-01 | Partners | Partners; Russell | -| 90 | 2019-10-05 | Russell | Partners; Russell | -+------+------------+-----------+---------------------+ -``` - - - -**聚合函数示例** - -建表 **employees** ,并向里面插入数据,执行以下语句: - -```javascript -CREATE TABLE employees (department_id INT,manager_id INT,last_name varchar(50),hiredate varchar(50),SALARY INT); -INSERT INTO employees VALUES(30, 100, 'Raphaely', '2017-07-01', 1700); -INSERT INTO employees VALUES(30, 100, 'De Haan', '2018-05-01',11000); -INSERT INTO employees VALUES(30, 100, 'Errazuriz', '2017-07-01', 1400); -INSERT INTO employees VALUES(30, 100, 'Hartstein', '2019-05-01',14000); -INSERT INTO employees VALUES(30, 100, 'Raphaely', '2017-07-01', 1700); -INSERT INTO employees VALUES(30, 100, 'Weiss', '2019-07-01',13500); -INSERT INTO employees VALUES(30, 100, 'Russell', '2019-07-01', 13000); -INSERT INTO employees VALUES(30,100, 'Partners', '2018-12-01',14000); -``` - - - -查询第 30 部门的所有员工,并按雇用日期和姓氏排序。执行以下语句: - -```javascript -SELECT LISTAGG(last_name, '; ') WITHIN GROUP (ORDER BY hiredate, last_name) as "Emp_list", -MIN(hiredate) as "Earliest" FROM employees WHERE department_id = 30; -``` - - - -查询结果如下: - -```javascript -+-----------------------------------------------------------------------------+------------+ -| Emp_list | Earliest | -+-----------------------------------------------------------------------------+------------+ -| Errazuriz; Raphaely; Raphaely; De Haan; Partners; Hartstein; Russell; Weiss | 2017-07-01 | -+-----------------------------------------------------------------------------+------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/9.STDDEV-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/9.STDDEV-1.md deleted file mode 100644 index 9c3156911..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/5.functions-1/4.analysis-functions-1/9.STDDEV-1.md +++ /dev/null @@ -1,119 +0,0 @@ -STDDEV -=========================== - - - -`STDDEV` 函数用于计算总体标准差。`STDDEV` 函数将数值型数据作为参数,返回数值型数据。它与函数 `STDDEV_SAMP` 的不同之处在于,`STDDEV` 只有一行输入数据时返回 0,而 `STDDEV_SAMP` 返回 NULL。 - -OceanBase 中标准差的值是函数 `VARIANCE` 计算出的方差的算术平方根。 - -语法 --------------- - -```javascript -STDDEV([ DISTINCT | UNIQUE | ALL ] expr) [ OVER (analytic_clause) ] -``` - - - -作为分析函数使用时,您需要使用窗口函数的完整语法,它对一组行的集合进行计算并返回多个值[](pt3avi)。作为聚合函数使用时,该函数对一组行的集合进行聚合计算,结果只能返回一个值,此时不需要加 `OVER` 关键字。 - -参数 --------------- - - - -| 参数 | 说明 | -|----------|-----------------------| -| DISTINCT | 去重关键字,表示计算唯一值的总体标准差。 | -| UNIQUE | 去重关键字,表示计算唯一值的总体标准差。 | -| ALL | 全部数值列。 | -| expr | 是数值类型或者可以转换成数值类型的类型。 | -| OVER | 使用 `OVER` 子句定义窗口进行计算。 | - - -**注意** - - - -如果您指定了 `DISTINCT` 或 `UNIQUE` 关键字,则 `analytic_clause` 中不允许出现 `order_by_clause` 和 `windowing_clause`。 - -返回类型 ----------------- - -返回 `NUMBER` 类型数据。 - -示例 --------------- - -**分析函数示例** - -以下语句创建了表 **employees** ,并向里面插入数据 - -```javascript -CREATE TABLE employees(manager_id INT,last_name varchar(50),hiredate varchar(50),SALARY INT); -INSERT INTO employees VALUES(100, 'Raphaely', '2017-07-01', 1700); -INSERT INTO employees VALUES(100, 'De Haan', '2018-05-01',11000); -INSERT INTO employees VALUES(100, 'Errazuriz', '2017-07-21', 1400); -INSERT INTO employees VALUES(100, 'Hartstein', '2019-05-01',14000); -INSERT INTO employees VALUES(100, 'Raphaely', '2017-07-22', 1700); -INSERT INTO employees VALUES(100, 'Weiss', '2019-07-11',13500); -INSERT INTO employees VALUES(100, 'Russell', '2019-10-05', 13000); -INSERT INTO employees VALUES(100, 'Partners', '2018-12-01',14000); -INSERT INTO employees VALUES(200, 'Ross', '2019-06-11',13500); -INSERT INTO employees VALUES(200, 'Bell', '2019-05-25', 13000); -INSERT INTO employees VALUES(200, 'Part', '2018-08-11',14000); -COMMIT; -``` - - - -调用函数并执行以下语句: - -```javascript -SELECT last_name, salary, STDDEV(salary) OVER (ORDER BY hiredate) "StdDev" -FROM employees WHERE manager_id = 100 ORDER BY last_name, salary, "StdDev"; -``` - - - -查询结果如下: - -```javascript -+-----------+--------+-------------------------------------------+ -| LAST_NAME | SALARY | StdDev | -+-----------+--------+-------------------------------------------+ -| De Haan | 11000 | 4702.127178203498995615489088200868644482 | -| Errazuriz | 1400 | 212.132034355964257320253308631454711785 | -| Hartstein | 14000 | 6340.346993658943269176828928801701088079 | -| Partners | 14000 | 6064.899009876421676804205219406952308814 | -| Raphaely | 1700 | 0 | -| Raphaely | 1700 | 173.205080756887729352744634150587236694 | -| Russell | 13000 | 6026.474330580265330900400184969999384459 | -| Weiss | 13500 | 6244.311697171159907069428668980211861012 | -+-----------+--------+-------------------------------------------+ -``` - - - -**聚合函数示例** - -调用函数并执行以下语句: - -```javascript -SELECT STDDEV(salary) FROM employees WHERE manager_id = 100 ; -``` - - - -查询结果如下: - -```javascript -+-------------------------------------------+ -| STDDEV(SALARY) | -+-------------------------------------------+ -| 6026.474330580265330900400184969999384459 | -+-------------------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/6.expression-1/1.sql-expressions.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/6.expression-1/1.sql-expressions.md deleted file mode 100644 index 552fc631a..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/6.expression-1/1.sql-expressions.md +++ /dev/null @@ -1,60 +0,0 @@ -SQL 表达式概述 -============================== - - - -表达式用来计算数据的值,它由一个或多个数值、运算符和 SQL 函数等组件组合而成,通常表达式中要为它的组件假定数据类型。 -**注意** - - - -`NLS_COMP` 与 `NLS_SORT` 两个参数值共同影响字符的排序与比较。如果在数据库中 `NLS_COMP` 的值为`LINGUISTIC`,那么本章节中所有被提到的实体都会遵循参数 `NLS_SORT` 所指定的规则。如果 `NLS_COMP` 的值没有被指定为 `LINGUISTIC`,那么函数将不会受 `NLS_SORT` 的影响。`NLS_SORT` 的值可以被直接指定,如果没有被指定,它将继承 `NLS_LANGUAGE` 的值。 - -下面这个简单表达式的计算结果为 4,数据类型为 `NUMBER` (与组件的数据类型一致)。 - -```javascript -2*2 -``` - - - -如下是一个使用了函数和运算符的复杂表达式。这个表达式表示将当前日期增加 7 天,然后移除时间部分,最后将结果转换成 `CHAR` 数据类型。 - -```javascript -TO_CHAR(TRUNC(SYSDATE+7)) -``` - - - -您还可以在如下情形中使用表达式: - -* `SELECT` 语句的选择列中。 - -* `WHERE` 子句中和 `HAVING` 子句中。 - -* `CONNECT BY`、`START WITH` 和 `ORDER BY` 子句中。 - -* `INSERT` 语句的 `VALUES` 子句中。 - -* `UPDATE` 语句的 `SET` 子句中。 - - - - -例如,在下面的 `UPDATE` 语句的 `SET` 子句中您可以使用一个表达式替换字符串 **Smith** : - -```javascript -SET last_name = 'Smith'; -``` - - - -这个 `SET` 子句使用表达式 `INITCAP(last_name)` 替代字符串 **Smith** : - -```javascript -SET last_name = INITCAP(last_name); -``` - - - -OceanBase 数据库中,并不是所有表达式都可以直接被任意 SQL 语句使用,请参考 SQL语句 章节中关于表达式的限制。 diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/6.expression-1/10.expression-list.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/6.expression-1/10.expression-list.md deleted file mode 100644 index ccc4fb370..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/6.expression-1/10.expression-list.md +++ /dev/null @@ -1,79 +0,0 @@ -表达式列表 -========================== - - - -表达式列表(Expression List)是一组其它表达式的组合。 - -表达式列表可以出现在比较和成员条件,以及查询和子查询的 `GROUP BY` 子句中。在比较和成员条件中的表达式列表有时被称为行值构造器(Row value constructor)或者行构造器(Row constructor)。 - -比较和成员条件出现在 `WHERE` 子句中。它们可以包含一个或多个逗号分隔的表达式,或是一组或多组表达式,其中每组表达式包含一个或多个逗号分隔的表达式。在接下来的例子中(多组表达式): - -* 每一组被括号包含。 - - - -* 每一组必须包含相同数量的表达式。 - - - -* 每一组中表达式的数量需要与比较条件中运算符之前的表达式的数量匹配,或者与成员条件中 `IN` 关键字之前的表达式的数量匹配。 - - - - - - -逗号分隔的表达式列表最多只能包含 1000 个表达式。逗号分隔的表达式组列表可以包含任意数量表达式组,但是每一表达式组最多只能包含 1000 个表达式。 - -下例是一些有效的表达式列表: - -```javascript -(10, 20, 40) -('SCOTT', 'BLAKE', 'TAYLOR') -( ('Guy', 'Himuro', 'GHIMURO'),('Karen', 'Colmenares', 'KCOLMENA') ) -``` - - - -在第三个例子中,每一组的表达式数量必须与 SQL 语句条件的第一部分的表达式数量相等。例如: - -```javascript -SELECT * FROM employees - WHERE (first_name, last_name, email) IN - (('Guy', 'Himuro', 'GHIMURO'),('Karen', 'Colmenares', 'KCOLMENA')); -``` - - - -在简单的 `GROUP BY` 子句中,使用大写或小写形式的表达式列表都可以: - -```javascript -SELECT department_id, MIN(salary) min, MAX(salary) max FROM employees - GROUP BY department_id, salary - ORDER BY department_id, min, max; - -SELECT department_id, MIN(salary) min, MAX(salary) max FROM employees - GROUP BY (department_id, salary) - ORDER BY department_id, min, max; -``` - - - -在 `GROUP BY` 子句的 `ROLLUP`、`CUBE` 和 `GROUPING SETS` 子句中,您可以在同一表达式列表中将单个表达式与表达式组结合。下例展示了一些在 SQL 语句中有效分组表达式列表: - -```javascript -SELECT prod_category, prod_subcategory, country_id, cust_city, count(*) - FROM products, sales, customers - WHERE sales.prod_id = products.prod_id - AND sales.cust_id=customers.cust_id - AND sales.time_id = '01-oct-00' - AND customers.cust_year_of_birth BETWEEN 1960 and 1970 - GROUP BY GROUPING SETS ( - (prod_category, prod_subcategory, country_id, cust_city), (prod_category, prod_subcategory, country_id), (prod_category, prod_subcategory), - country_id - ) - ORDER BY prod_category, prod_subcategory, country_id, cust_city; -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/6.expression-1/2.simple-expression.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/6.expression-1/2.simple-expression.md deleted file mode 100644 index ff14bb16a..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/6.expression-1/2.simple-expression.md +++ /dev/null @@ -1,21 +0,0 @@ -简单表达式 -========================== - - - -一个简单表达式(Simple Expressions)可以是列、伪列、常量、序列数或空值。 - -除了用户schema,`schema` 也可以是 **PUBLIC** 的 ,用来指定一个指向表、视图的同义词的属性。注意只有在数据操纵语言(DML)语句中支持使用 **PUBLIC** 为公共同义词,而在数据定义语言(DDL)语句中则不支持。`NCHAR` 与 `NVARCHAR2` 并不是有效的伪列数据类型。 - -下列是一些有效的简单表达式: - -* `employees.last_name` - -* `'this is a text string'` - -* `10` - -* `N 'this is an NCHAR string'` - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/6.expression-1/3.compound-expression.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/6.expression-1/3.compound-expression.md deleted file mode 100644 index e7ddc7d9f..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/6.expression-1/3.compound-expression.md +++ /dev/null @@ -1,23 +0,0 @@ -复合表达式 -========================== - - - -复合表达式(Compound Expressions)是由其它类型表达式组合而成的表达式。 - -您可以使用任意内置函数作为一个表达式。然而,在复合表达式中,一些函数的组合会因为不合适而被弃用。例如,在一个聚合函数中,`LENGTH` 函数就不适用。 - -`PRIOR` 运算符用于层次查询的 `CONNECT BY` 子句。 - -下列是一些有效的复合表达式: - -* `('CLARK' || 'SMITH')` - -* `LENGTH('MOOSE') * 57` - -* `SORT(144) + 72` - -* `my_fun(TO_CHAR(sysdate, 'DD-MMM-YY'))` - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/6.expression-1/4.conditional-expressions.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/6.expression-1/4.conditional-expressions.md deleted file mode 100644 index e69c1cf0d..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/6.expression-1/4.conditional-expressions.md +++ /dev/null @@ -1,79 +0,0 @@ -条件表达式 -========================== - - - -条件表达式(Case Expression)允许用户在不调用存储过程的情况下,在 SQL 语句中使用 `IF ... THEN ... ELSE` 逻辑。 - -语法 --------------- - -```javascript -CASE { simple_case_expression -| searched_case_expression -} -[ ELSE else_expr ] -END -``` - - - -其中简单条件表达式中 `simple_case_expression` 的语法为: - -```javascript -expr -{ WHEN comparison_expr THEN return_expr }... -``` - - - -搜索条件表达式 `searched_case_expression` 的语法为: - -```javascript -{ WHEN condition THEN return_expr }... -``` - - - -使用规则 ----------------- - -### 条件的验证 - -在一个简单条件表达式中,OceanBase 数据库会以 `expr` 为基准,在 `WHEN ... THEN` 中搜寻第一个与之等值的 `comparison_expr`,并返回相应的 `return_expr`。如果没有 `WHEN ... THEN` 满足此情形,并且 `ELSE` 子句存在,那么 OceanBase 数据库会返回 `else_expr`。否则,OceanBase 会返回 NULL。 - -在搜索条件表达式中,OceanBase 会自左向右搜索直到 `condition` 条件成立,然后返回 `return_expr`。如果所有条件都不成立,且 `ELSE` 子句存在,则数据库返回 `else_expr`。否则,数据库会返回 NULL。 - -### 条件的计算 - -OceanBase 数据库使用短路计算法则。对于简单条件表达式,数据库仅会在与 `expr` 比较之前计算 `comparison_expr` 的值,而不是在与 `expr` 比较之前就将计算所有 `comparison_expr` 的值。因此,如果前一个 `comparison_expr` 与 `expr` 相等,OceanBase 将不会计算下一个 `comparison_expr` 的值。对于搜索条件表达式,数据库将会串行计算每个条件(Condition)是否为真,如果前一个条件(Condition)为真,OceanBase 将不会计算下一个条件。 - -### 数据类型 - -对于简单条件表达式,`expr` 和所有的 `comparison_expr` 的值的数据类型必须相同(如 `CHAR`、`VARCHAR2` 和 `NCHAR`; `NVARCHAR2`、`NUMBER` 和 `BINARY_FLOAT`,或 `BINARY_DOUBLE`),或者都是数值类型。如果所有的返回表达式都是数值类型,则 OceanBase 会选择最高优先级的数据类型,显式地将其它参数转化为此数据类型,并返回这个数据类型。 - -对于简单条件表达式和搜索条件表达式,所有的 `return_exprs` 的数据类型必须相同(如 `CHAR`、`VARCHAR2`和`NCHAR`;`NVARCHAR2`、`NUMBER` 和 `BINARY_FLOAT`;`BINARY_DOUBLE`),或者都是数值类型。如果所有的返回表达式都是数值类型,则 OceanBase 会选择最高优先级的数据类型,显式地将其它参数转化为此数据类型,并返回这个数据类型。 - -示例 --------------- - -```javascript -SELECT cust_last_name, - CASE credit_limit - WHEN 100 THEN 'Low' - WHEN 5000 THEN 'High' - ELSE 'Medium' END AS credit -FROM customer -ORDER BY cust_last_name, credit; -``` - - - -以下是搜索条件表达式的示例: - -```javascript -SELECT AVG(CASE WHEN e.salary > 2000 THEN e.salary -ELSE 2000 END) "Average Salary" FROM employee e; -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/6.expression-1/5.column-expression.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/6.expression-1/5.column-expression.md deleted file mode 100644 index dc694fcb9..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/6.expression-1/5.column-expression.md +++ /dev/null @@ -1,38 +0,0 @@ -列表达式 -========================= - - - -列表达式(Column Expressions)是一种形式受限制的 `expr`,在本章其他表达式的语法中被命名为 `column_expression`。列表达式可以是 [简单表达式](../../11.sql-reference-oracle-mode/6.expression-1/2.simple-expression.md)、[复合表达式](../../11.sql-reference-oracle-mode/6.expression-1/3.compound-expression.md)、[函数表达式](../../11.sql-reference-oracle-mode/6.expression-1/7.function-expression.md) 或者 [表达式列表](../../11.sql-reference-oracle-mode/6.expression-1/10.expression-list.md),但它只能包含以下形式的表达式: - -* 目标表(被创建,变更或索引的表)的列。 - - - -* 常量(字符串或数字)。 - - - -* 确定性函数(SQL 内建函数或用户自定义函数)。 - - - - - - -除以上形式表达式外,其它形式的表达式都不是有效的列表达式。此外,列表达式不支持使用 `PRIOR` 关键字的复合表达式与聚合函数。 - -使用列表达式可以实现以下目的: - -* 创建基于函数的索引。 - - - -* 显式或隐式定义一个虚拟列。定义一个虚拟列时,`column_expression` 只适用于在此前语句中已经定义的目标表的列。 - - - - - - -列表达式的组件必须是确定的,也就是说,输入同样的值必须返回同样的输出值。 diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/6.expression-1/6.date-and-time-expressions.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/6.expression-1/6.date-and-time-expressions.md deleted file mode 100644 index fc0080470..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/6.expression-1/6.date-and-time-expressions.md +++ /dev/null @@ -1,46 +0,0 @@ -日期时间表达式 -============================ - - - -日期时间表达式(Datetime Expression)会生成日期时间数据类型的值。 - -语法如下: - -```javascript -{TIMESTAMP | DATE} string -``` - - - -TIMESTAMP 或 DATE 加上字符串字面量可以生成 TIMESTAMP 或 DATE 类型的值,注意字符串的格式要与系统变量 `NLS_TIMESTAMP_FORMAT` 和 `NLS_DATE_FORMAT` 一致。 - -系统变量的值可以通过下面的 SQL 查询: - -```javascript -obclient> SELECT * from v$nls_parameters WHERE parameter like '%FORMAT'; -+-------------------------+------------------------------+--------+ -| PARAMETER | VALUE | CON_ID | -+-------------------------+------------------------------+--------+ -| NLS_DATE_FORMAT | DD-MON-RR | 0 | -| NLS_TIMESTAMP_FORMAT | DD-MON-RR HH.MI.SSXFF AM | 0 | -| NLS_TIMESTAMP_TZ_FORMAT | DD-MON-RR HH.MI.SSXFF AM TZR | 0 | -+-------------------------+------------------------------+--------+ -3 rows in set (0.00 sec) -``` - - - -例如系统变量 `NLS_TIMESTAMP_FORMAT` 的值为 `DD-MON-RR HH.MI.SSXFF AM`,可以用下面的表达式生成一个 timestamp 类型的值。 - -```javascript -obclient> SELECT timestamp '2020-01-01 10:00:00' FROM DUAL; -+---------------------------------+ -| TIMESTAMP'2020-01-0110:00:00' | -+---------------------------------+ -| 01-JAN-20 10.00.00.000000000 AM | -+---------------------------------+ -1 row in set (0.01 sec) -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/6.expression-1/7.function-expression.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/6.expression-1/7.function-expression.md deleted file mode 100644 index 2db98cd89..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/6.expression-1/7.function-expression.md +++ /dev/null @@ -1,60 +0,0 @@ -函数表达式 -========================== - - - -函数表达式(Function Expression)使您可以使用任何内置 SQL 函数或是自定义函数表达式。 - -如下所示的是一些有效的内置函数表达式: - -* `LENGTH('BLAKE')` - -* `ROUND(1234.567*43)` - -* `SYSDATE` - - - -**注意** - - - -自定义函数表达式不能传递对象类型或 XMLType 的参数到远程函数或过程。 - -自定义函数表达式会调用: - -* 一个自定义包、类型或一个独立自定义函数中的函数。 - - - -* 一个自定义函数或运算符。 - - - - - - -下列是一些有效的自定义函数表达式: - -* `circle_area(radius)` - -* `payroll.tax_rate(empno)` - -* `hr.employees.comm_pct@remote(dependents, empno)` - -* `DBMS_LOB.getlength(column_name)` - -* `my_function(a_column)` - - - - -使用自定义函数作为表达式时,支持位置表示法、名字表示法和混合表示法。例如,下面的表示法都是正确的: - -```javascript -CALL my_function(arg1 => 3, arg2 => 4) ... -CALL my_function(3, 4) ... -CALL my_function(3, arg2 => 4) ... -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/6.expression-1/8.interval-expression.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/6.expression-1/8.interval-expression.md deleted file mode 100644 index 50163568e..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/6.expression-1/8.interval-expression.md +++ /dev/null @@ -1,33 +0,0 @@ -间隔表达式 -========================== - - - -时间间隔表达式(Interval Expression)生成 `INTERVAL YEAR TO MONTH` 或 `INTERVAL DAY TO SECOND` 数据类型的值。 - -语法如下: - -```javascript -INTERVAL string - { DAY [ (leading_field_precision) ] TO - SECOND [ (fractional_second_precision) ] - | YEAR [ (leading_field_precision) ] TO - MONTH - } -``` - -`leading_field_precision` 和 `fractional_second_precision` 可以是 0 到 9 的任意整数,这两个参数指定了对应元素值的精确度。如果在指定 `DAY` 和 `YEAR` 元素时省略了 `leading_field_precision` 参数,其使用默认值为 2,表示该元素的值不能超过 2 位整数。如果对 `SECOND` 元素省略了 `fractional_second_ precision` 参数,其默认值为 6,表示该值精确到小数点第 6 位。如果查询的返回值比默认精度位数更多,OceanBase 数据库会返回一个错误。 - -例如,下面的语句展示了一个 DAY TO SECOND 类型的 INTERVAL 值。 - -```javascript -obclient> SELECT INTERVAL '999999999 23:59:59.999' day(9) to second FROM DUAL; -+-----------------------------------------------+ -| INTERVAL'99999999923:59:59.999'DAY(9)TOSECOND | -+-----------------------------------------------+ -| +999999999 23:59:59.999000 | -+-----------------------------------------------+ -1 row in set (0.00 sec) -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/6.expression-1/9.scalar-subquery-expression.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/6.expression-1/9.scalar-subquery-expression.md deleted file mode 100644 index 88c066c20..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/6.expression-1/9.scalar-subquery-expression.md +++ /dev/null @@ -1,39 +0,0 @@ -标量子查询表达式 -============================= - - - -标量子查询表达式(Scalar Subquery Expression)是返回一行包含多列值的子查询。如果子查询返回 0 行,则标量子查询表达式的值是 NULL。如果子查询返回多行,则标量子查询表达式返回一个错误。大多数表达式都可以使用标量子查询表达式作为参数。 - -标量子查询在以下情形中是无效的表达式: - -* 作为列的默认值。 - - - -* 用于哈希函数中。 - - - -* 在 DML 语句的 `RETURNING` 子句中。 - - - -* 在函数索引的定义中。 - - - -* 在 `CHECK` 约束中。 - - - -* 在 `GROUP BY` 子句中。 - - - -* 在与查询无关的语句中,如 `CREATE PROFILE`。 - - - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/7.condition/1.overview-of-sql-conditions.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/7.condition/1.overview-of-sql-conditions.md deleted file mode 100644 index cb9fc0cb1..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/7.condition/1.overview-of-sql-conditions.md +++ /dev/null @@ -1,88 +0,0 @@ -SQL 条件概述 -============================= - - - -条件用来判断数据的值,并返回 `TRUE`、`FALSE` 或 `UNKNOWN`。它由一个或多个表达式和逻辑(布尔)运算符等组件组合而成。只要条件出现在 SQL 语句中,您就必须使用正确的条件语法。 -**注意** - - - -参数 `NLS_COMP` 和 `NLS_SORT` 共同影响字符的排序与比较。若将数据库的 `NLS_COMP` 指定为`LINGUISTIC`,那么本开发指南中所有被提到的实体都会遵循参数 `NLS_SORT` 所指定的规则。若 `NLS_COMP` 的值没有被指定为 `LINGUISTIC`,那么函数将不受 `NLS_SORT` 影响。`NLS_SORT` 的值可以被直接指定,如果没有被指定,它将继承 `NLS_LANGUAGE1` 的值。 - -您可以在这些语句的 `WHERE` 子句中使用条件: - -* `DELETE` - -* `SELECT` - -* `UPDATE` - - - - -您也可以在 `SELECT` 语句的这些子句中使用条件: - -* `WHERE` - -* `START WITH` - -* `CONNECT BY` - -* `HAVING` - - - - -条件可以称为逻辑数据类型,尽管 OceanBase 数据库不正式支持这样的数据类型。 - -例如,简单条件 1 = 1 判断结果为 TRUE。 - -下面更复杂的条件将 **salary** 的值加上 **commission_pct** 得值(函数 `NVL` 将 **salary** 中的 NULL 值替换为 0 ),并判断总和是否大于 25000。 - -```javascript -NVL(salary, 0) + NVL(salary + (salary * commission_pct, 0) > 25000) -``` - - - -逻辑条件 `AND` 可以将多个条件组合成一个条件。 - -```javascript -(1 = 1) AND (5 < 7) -``` - - - -SQL 语句中的有效条件: - -```javascript -name = 'SMITH' -employees.department_id = departments.department_id -hire_date > '01-JAN-08' -job_id IN ('SA_MAN', 'SA_REP') -salary BETWEEN 5000 AND 10000 -commission_pct IS NULL AND salary = 2100 -``` - - - -条件优先 ----------------- - -条件优先级指的是 OceanBase 数据库在同一表达式中判断不同条件的顺序。当计算包含多个条件的表达式时,先判断较高优先级的条件,最后判断较低优先级的条件,而优先级相等的条件则按照从左到右的顺序判断。例如 `AND` 和 `OR` 连接的多个条件,不能按照从左到右的顺序判断,而是按照先计算`AND`然后计算`OR`的顺序。 - -**SQL 条件优先级表** - - -| 条件类型 | 功能 | -|-----------------------------------------------------------------|----------| -| =、!=、\<、\>、\<=、\>= | 比较。 | -| IS \[NOT\] NULL、LIKE、\[NOT\] BETWEEN、\[NOT\] IN、EXISTS、IS OF 类型 | 比较。 | -| NOT | 取幂,逻辑取反。 | -| AND | 比较。 | -| OR | 分离。 | - - - -优先级按照从高到低排列出,同一行上列出的条件具有相同的优先级。 diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/7.condition/2.comparison-conditions.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/7.condition/2.comparison-conditions.md deleted file mode 100644 index eb1a76a42..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/7.condition/2.comparison-conditions.md +++ /dev/null @@ -1,52 +0,0 @@ -比较条件 -========================= - - - -比较条件(Comparison Conditions)用于比较一个表达式与另一个表达式,比较的结果为 `TRUE`、`FALSE` 或 `UNKNOWN`。 - -比较条件不能比较大对象(LOB)数据类型。但是您可以通过 PL 程序对 `CLOB` 数据进行比较。 - -比较数值表达式时,OceanBase 使用数值优先级来确定条件中的数值比较顺序,比如比较符两边出现不同类型的 数值时,如果有`BINARY_DOUBLE`则按照`BINARY_DOUBLE`进行比较, 其次是`BINARY_FLOAT`, 最后是`NUMBER`。是比较 `NUMBER`、`BINARY_FLOAT` 还是 `BINARY_DOUBLE` 值。 - -比较字符表达式时,OceanBase 使用字符数据类型比较规则中的规定。它规定了表达式的字符集在比较之前是如何统一的,选择使用二进制和语言比较,还是选择使用空白填充和非空白填充的比较语义。 - -当使用比较条件对字符值进行语言比较时,首先将它们转换为排序键,然后做比较,比较的过程类似 `RAW` 数据类型。排序键是由函数 `NLSSORT` 返回的值。如果两个表达式生成的排序键的前缀相同,即使它们在值的其余部分不同,它们也可以在语言上相等。 - -如果两个非标量类型的对象具有相同的命名类型,并且它们的元素之间存在一一对应的关系,则它们是可比较的。用户定义的对象类型---嵌套表,在相等或 `IN` 条件下使用时,必须定义 `MAP` 方法。嵌套表的元素可以比较。 - -简单比较条件 ------------------- - -一个简单比较条件可以是单个表达式与表达式列表比较或单个表达式与子查询结果比较。 - -简单比较条件语法如下: - -```javascript -expr {= | != | ^= | <> | < | >= |} ( expression_list | subquery ) -``` - - - -在简单比较条件中,如果是单个表达式与表达式列表比较,并且表达式列表中的表达式必须在数量和数据类型上与运算符左边的表达式匹配。如果是单个表达式与子查询的值比较,则子查询返回的值必须与运算符左侧的表达式在数量和数据类型上匹配。 - -组比较条件 ------------------ - -一个组比较条件可以是单个表达式与表达式列表或子查询结果的任何或所有成员比较,也可以是多个表达式与表达式列表或子查询结果的任何或所有成员比较。 - -在组比较条件中,如果是单个表达式或多个表达式列表与表达式列表的任何或所有成员比较,则每个表达式列表中的表达式必须在数量和数据类型上与运算符左边的表达式匹配。如果是单个表达式或多个表达式与子查询结果的任何或所有成员比较,则子查询返回的值必须与运算符左侧的表达式在数量和数据类型上匹配。 - -组比较条件语法有如下两种: - -```javascript -expr {= | != | ^= | <> | < | >= | ANY | SOME | ALL } ({ expression_list | subquery}) -``` - - - -```javascript -(expr [, expr ]...){= | != | ^= | ANY | SOME | ALL} ({expression_list [, expression_list ]... |subquery}) -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/7.condition/3.logical-conditions.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/7.condition/3.logical-conditions.md deleted file mode 100644 index b9d1e1c0f..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/7.condition/3.logical-conditions.md +++ /dev/null @@ -1,46 +0,0 @@ -逻辑条件 -========================= - - - -逻辑条件(Logical Conditions)将两个条件组合在一起,产生单个结果或反转单个条件的结果。 - -逻辑条件 NOT --------------------- - -逻辑条件 `NOT` 表示'非',可以反转单个条件的结果。如果条件为 `FALSE`,则返回 `TRUE`。如果条件为 `TRUE`,则返回 `FALSE`。如果它是 `UNKNOWN`,则返回 `UNKNOWN`。 - -**逻辑条件 NOT 示例** - -```javascript -SELECT * FROM employees WHERE NOT (job_id IS NULL) ORDER BY employee_id; -SELECT * FROM employees WHERE NOT (salary BETWEEN 1000 AND 2000) ORDER BY employee_id; -``` - - - -逻辑条件 AND --------------------- - -逻辑条件 `AND` 表示'与',用于连接两个条件。如果两个条件均为 `TRUE`,则返回 `TRUE`。如果任意一个为 `FALSE`,则返回 `FALSE`。否则返回 `UNKNOWN`。 - -**逻辑条件 AND 示例** - -```javascript -SELECT * FROM employees WHERE job_id = 'PU_CLERK' AND department_id = 30 ORDER BY employee_id; -``` - - - -逻辑条件 OR -------------------- - -逻辑条件 `OR` 表示'或',表示任何一个都可以。如果任一条件为 `TRUE`,则返回 `TRUE`。如果两者均为 `FALSE`,则返回 `FALSE`。否则返回 `UNKNOWN`。 - -**逻辑条件 OR 示例** - -```javascript -SELECT * FROM employees WHERE job_id = 'PU_CLERK' OR department_id = 10 ORDER BY employee_id; -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/7.condition/4.pattern-matching-conditions.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/7.condition/4.pattern-matching-conditions.md deleted file mode 100644 index a72584b93..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/7.condition/4.pattern-matching-conditions.md +++ /dev/null @@ -1,119 +0,0 @@ -模式匹配条件 -=========================== - - - -模式匹配条件(Pattern-matching Conditions)用来比较字符数据。 - -LIKE 条件 -------------------- - -`LIKE` 条件用于模式匹配。相等运算符(=)指的是一个字符值与另一个字符值完全匹配,而 `LIKE` 条件通过在第一个值中搜索由第二个字符值指定的模式来将一个字符值的一部分与另一个字符值进行匹配。 - -`LIKE` 使用输入字符集定义的字符来计算字符串。 - -**语法** - -```javascript -char1 [NOT] LIKE char2 [ ESCAPE esc_char ] -``` - - - -除了 `LIKE`,特殊的模式匹配字符 `_` 表示值中的一个字符恰好匹配,`%` 表示值中的零个或多个字符匹配。模式 `%` 不能与 `NULL` 匹配。 - -**参数** - - -| 参数 | 说明 | -|----------|--------------------------------------------------------------------------| -| char1 | 字符表达式,例如字符列,称为搜索值。 | -| char2 | 字符表达式,通常是文字,称为模式。 | -| esc_char | 字符表达式,通常是文字,`ESCAPE` 将 `esc_char`标识为转义字符。当转义符置于模式匹配符之前时,该模式匹配符被解释为普通的字符。 | - - - -**示例** - -以下语句使用了 `LIKE`: - -```javascript -SELECT last_name FROM employees WHERE last_name LIKE '%A\_B%' ESCAPE '\' ORDER BY last_name; -``` - -`ESCAPE '\'` 会将 `%A\_B%` 中 `\` 后面的模式匹配符'_'解释为普通的字符。 - -```javascript -SELECT salary FROM employees WHERE 'SM%' LIKE last_name ORDER BY salary; -``` - - - -REGEXP_LIKE 条件 --------------------------- - -`REGEXP_LIKE` 用于正则表达式匹配。`REGEXP_LIKE` 使用输入字符集定义的字符评估字符串。 - -### 语法 - -```javascript -REGEXP_LIKE(source_char, pattern [, match_param ]) -``` - - - -### 参数 - - - -| 参数 | 说明 | -|-------------|---------------------------------------------------------------------| -| source_char | 用作搜索值的字符表达式,数据类型可以是 `CHAR`,`VARCHAR2`,`NCHAR`,`NVARCHAR2` 或 `CLOB`。 | -| pattern | 正则表达式,数据类型可以是 `CHAR`,`VARCHAR2`,`NCHAR`,`NVARCHAR2` 或 `CLOB`。 | -| source_char | 数据类型 `VARCHAR2 `或 `CHAR` 的字符表达式,允许您更改条件的默认匹配行为。 | - - - -如果模式的数据类型与 `source_char` 的数据类型不同,OceanBase 将模式转换为 `source_char` 的数据类型。 - -### 示例 - -创建表 **employees** ,并向里面插入数据。执行以下语句: - -```javascript -CREATE TABLE employees(manager_id INT, first_name varchar(50), last_name varchar(50), hiredate varchar(50),SALARY INT); -INSERT INTO employees VALUES(300, 'Steven', 'King', '2019-09-11',23600); -INSERT INTO employees VALUES(200, 'Steven', 'Markle', '2019-11-05', 23800); -INSERT INTO employees VALUES(100, 'Deven', 'Part', '2018-10-01',24000); -INSERT INTO employees VALUES(200, 'Carlos', 'Ross', '2019-06-11',23500); -INSERT INTO employees VALUES(200, 'Teven', 'Bell', '2019-05-25', 23000); -INSERT INTO employees VALUES(200, 'Stephen', 'Stiles', '2018-06-11',24500); -INSERT INTO employees VALUES(100, 'Ame', 'De Haan', '2018-05-01',11000); -INSERT INTO employees VALUES(100, 'Jon', 'Errazuriz', '2017-07-21', 1400); -COMMIT; -``` - - - -查询返回名字为 **Steven** 或 **Stephen** 的员工的名字和姓氏(其中 `first_name` 以 **Ste** 开头,以 **en** 结尾,中间是 **v** 或 **ph** ),执行以下语句: - -```javascript -SELECT first_name, last_name FROM employees WHERE REGEXP_LIKE (first_name, '^Ste(v|ph)en$') -ORDER BY first_name, last_name; -``` - - - -查询结果如下: - -```javascript -+------------+-----------+ -| FIRST_NAME | LAST_NAME | -+------------+-----------+ -| Stephen | Stiles | -| Steven | King | -| Steven | Markle | -+------------+-----------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/7.condition/5.empty-condition.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/7.condition/5.empty-condition.md deleted file mode 100644 index 0f8090ee4..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/7.condition/5.empty-condition.md +++ /dev/null @@ -1,22 +0,0 @@ -空条件 -=== - -空条件(Null Conditions)检测 NULL 值。这是用于检测 NULL 的唯一条件。 - -语法 --------------- - -```javascript -expr IS [ NOT ] NULL -``` - -示例 --------------- - -执行以下语句: - -```javascript -SELECT last_name FROM employees WHERE commission_pct IS NULL -ORDER BY last_name; -``` - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/7.condition/6.composite-condition.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/7.condition/6.composite-condition.md deleted file mode 100644 index 28a1c6986..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/7.condition/6.composite-condition.md +++ /dev/null @@ -1,17 +0,0 @@ -复合条件 -========================= - - - -复合条件(Compound Conditions)指的是其他条件的组合。 - -语法 --------------- - -```javascript -{ (condition) | NOT condition | condition { AND | OR } condition } -``` - - - -更多关于条件 `NOT`、`AND` 和 `OR` 的信息,请参考文档 [逻辑条件](../../11.sql-reference-oracle-mode/7.condition/3.logical-conditions.md)。 diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/7.condition/7.between-condition.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/7.condition/7.between-condition.md deleted file mode 100644 index 0ca154cfc..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/7.condition/7.between-condition.md +++ /dev/null @@ -1,30 +0,0 @@ -BETWEEN 条件 -=============================== - - - -`BETWEEN` 条件(Between Condition)确定一个表达式的值是否在其他两个表达式定义的间隔内。 - -语法 --------------- - -```javascript -expr1 [ NOT ] BETWEEN expr2 AND expr3 - -NOT (expr1 BETWEEN expr2 AND expr3) -``` - - - -`expr1`、`expr2` 和 `expr3` 这三个表达式都必须是数字、字符或日期时间表达式。在 SQL 中,可能会对 `expr1` 进行多次计算。如果在 PL 中出现表达式,则保证只计算一次 `expr1`。如果表达式不都是相同的数据类型,那么 OceanBase 数据库将表达式隐式转换为统一的数据类型。如果表达式不能转换为相同的数据类型,则返回错误。 - -示例 --------------- - -查询薪资在 2000\~3000 范围内的员工信息,并按照员工号排序。 - -```javascript -SELECT * FROM employees WHERE salary BETWEEN 2000 AND 3000 ORDER BY employee_id; -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/7.condition/8.existence-condition.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/7.condition/8.existence-condition.md deleted file mode 100644 index b2d639c74..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/7.condition/8.existence-condition.md +++ /dev/null @@ -1,22 +0,0 @@ -存在条件 -==== - -存在条件(EXISTS Conditions)用于测试子查询中是否存在指定的行。 - -语法 --------------- - -```javascript -EXISTS (subquery) -``` - -如果子查询至少返回一行,则说明存在您想要的数据。 - -示例 --------------- - -```javascript -SELECT department_id FROM departments d WHERE EXISTS (SELECT * FROM employees e -WHERE d.department_id = e.department_id) ORDER BY department_id; -``` - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/7.condition/9.in-conditions.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/7.condition/9.in-conditions.md deleted file mode 100644 index 41d2eb1e6..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/7.condition/9.in-conditions.md +++ /dev/null @@ -1,45 +0,0 @@ -IN 条件 -========================== - - - -`IN` 条件(IN Conditions)是成员资格条件。它测试值或子查询列表中成员的值。 - -语法 --------------- - -```javascript -expr [ NOT ] IN ({ expression_list | subquery }) -| -( expr [, expr ]... ) [ NOT ] IN ( { expression_list [, expression_list ]... | subquery } ) -``` - - - -`IN` 条件可以测试表达式是表达式列表或子查询的成员,或者多个表达式是表达式列表或子查询的成员。并且每个表达式列表中的表达式必须在数量和数据类型上与运算符 `IN` 左边的表达式匹配。 - -示例 --------------- - -**IN 示例** :相当于 `=ANY`,表示集合中所有的成员。 - -```javascript -SELECT * FROM employees WHERE job_id IN ('PU_CLERK','SH_CLERK') ORDER BY employee_id; - -SELECT * FROM employees WHERE salary IN (SELECT salary FROM employees -WHERE department_id =30) ORDER BY employee_id; -``` - - - -**NOT IN 示例** :相当于 `!= ALL`。如果集合中的任何成员为 `NULL`,则计算为 `false`。 - -```javascript -SELECT * FROM employees WHERE salary NOT IN (SELECT salary FROM employees -WHERE department_id = 30) ORDER BY employee_id; - -SELECT * FROM employees WHERE job_id NOT IN ('PU_CLERK', 'SH_CLERK') -ORDER BY employee_id; -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/8.queries-and-subqueries-1/1.query-and-subquery-overview.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/8.queries-and-subqueries-1/1.query-and-subquery-overview.md deleted file mode 100644 index 2e4dfa1a1..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/8.queries-and-subqueries-1/1.query-and-subquery-overview.md +++ /dev/null @@ -1,79 +0,0 @@ -查询和子查询概述 -============================= - - - -查询是指数据库中用来获取数据的方式,它可搭配条件限制的子句(如 `WHERE`),排列顺序的子句(如 `ORDER BY`)等语句来获取查询结果。子查询是指嵌套在一个上层查询中的查询。上层的查询一般被称为父查询或外部查询。子查询的结果作为输入传递回父查询或外部查询。父查询将这个值结合到计算中,以便确定最后的输出。SQL 语言允许多层嵌套查询,即一个子查询中还可以嵌套其他子查询。同时,子查询可以出现在 SQL 语句中的各种子句中,比如 `SELECT` 语句、`FROM` 语句和 `WHERE` 语句等。下列为 SQL 语句中常见的查询: - -* 简单查询 - - - -* 层次查询 - - - -* 集合 - - - -* 连接 - - - -* 子查询 - - - - - - -简单查询(Simple Queries) --------------------------------- - -简单查询指从 OceanBase 一个或多个选择列表或视图中检索一个或多个列数据的操作,列的数量以及它们的数据类型和长度由选择列表的元素确定。而选择列表指的是 `SELECT` 关键字之后和 `FROM` 子句之前的表达式列表。 - -层次查询(Hierarchical Query) ------------------------------------- - -层次查询是一种具有特殊功能的查询语句,通过它能够将分层数据按照层次关系展示出来。分层数据是指关系表中的数据之间具有层次关系。 - -集合 --------------- - -您可以使用集合运算符 `UNION`、`UNION ALL`、`INTERSECT` 和 `MINUS` 来组合多个查询。 所有集合运算符都具有相同的优先级。如果 `SQL` 语句包含多个集合运算符,则 OceanBase 从左到右对它们进行判断,除非括号中指定了顺序。本节主要讲了以下集合运算符: - - -| 运算符 | 说明 | -|-----------|--------------------| -| UNION | 返回两个结果集的并集,并且不重复。 | -| UNION ALL | 返回两个结果集的并集,并且可以重复。 | -| INTERSECT | 返回两个结果集的交集。 | -| MINUS | 返回两个结果集的差集。 | - - - -连接 (Join) ---------------------- - -连接(Join)是将来自两个或多个表、视图或实例视图的行组合在一起的查询。 每当查询的 `FROM` 子句中出现多个表时,OceanBase 数据库执行连接。 查询的选择列表可以从其中任何表中选择任何列。 如果这两个表都有一个列名,那么您必须用表名限定查询过程中对这些列的所有引用。本节主要讲了以下连接: - - -| 连接类型 | 表示 | 说明 | -|---------|----------------------|----------------------------------------------| -| 等值连接 | Equijoins | 包含等式运算符连接条件的连接。 | -| 自连接 | SELF-JOIN | 表与其自身的连接。 | -| 内连接 | INNER JOIN | 内连接,结果为两个连接表中的匹配行的连接。 | -| 左(外)连接 | LEFT \[OUTER\] JOIN | 结果包括左表(出现在 `JOIN` 子句最左边)中的所有行,不包括右表中的不匹配行。 | -| 右(外)连接 | RIGHT \[OUTER\] JOIN | 结果包括右表(出现在 `JOIN` 子句最右边)中的所有行,不包括有左表中的不匹配的行。 | -| 全(外)连接 | FULL \[OUTER\] JOIN | 结果包括所有连接中的所有行,不论他们是否匹配。 | -| SEMI 连接 | SEMI-JOIN | SEMI-JOIN 只能通过子查询展开得到。 | -| ANTI 连接 | ANTI-JOIN | ANTI-JOIN 也只能通过子查询展开得到。 | -| 笛卡儿积 | Cartesian Products | 当两个表没有连接操作时,对这两个表进行查询得到的数据是这两个表的笛卡儿积。 | - - - -子查询 ---------------- - -子查询指的是 `SELECT` 查询语句中嵌套了另一个或者多个 `SELECT` 语句,可以返回单行结果、多行结果或不返回结果。`SELECT` 语句的 `FROM` 子句中的子查询也称为内联视图。您可以在嵌入式视图中嵌套任意数量的子查询。`SELECT` 语句的 `WHERE` 子句中的子查询也称为嵌套子查询。 diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/8.queries-and-subqueries-1/2.simple-query.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/8.queries-and-subqueries-1/2.simple-query.md deleted file mode 100644 index 2f88642f7..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/8.queries-and-subqueries-1/2.simple-query.md +++ /dev/null @@ -1,174 +0,0 @@ -简单查询 -========================= - - - -简单查询指从 OceanBase 一个或多个表或视图中检索一个或多个列数据的操作,列的数量以及它们的数据类型和长度由表结构确定。而选择列表指的是 `SELECT` 关键字之后和 `FROM` 子句之前的表达式列表。 - -语法 --------------- - -```javascript -SELECT 列名1,列名2,列名3,... FROM 表; -``` - - - -表名、字段名和关键字 `SELECT`、`FROM` 不区分大小写。查询的最后可以跟上分号(;),多条 SQL 可以同时执行。您可以使用 `SELECT` 语句中的 Hint 将指令或提示传递给 OceanBase 数据库优化器。优化器使用 Hint 为语句选择执行计划。 - -示例 --------------- - -创建一张员工表 **employee** ,并向列 **employee_id** 、 **first_name** 、 **last_name** 、 **manager_id** 和 **salary** 插入数据: - -```javascript -CREATE TABLE employee ( -employee_id INT, -first_name VARCHAR(50), -last_name VARCHAR(50), -manager_id INT, -salary NUMERIC -); -INSERT INTO employee VALUES(111, 'DEL', 'FA BEN', 1, 1500); -INSERT INTO employee VALUES(112, 'AXEL', 'BELL', 1, 1000); -INSERT INTO employee VALUES(113, 'CRIS', 'RACHAR', 1, 1000); -``` - - **简单查询示例** - -* 查询部分列: - - - - - - -```javascript -SELECT first_name, last_name, salary FROM employee; -+------------+-----------+--------+ -| FIRST_NAME | LAST_NAME | SALARY | -+------------+-----------+--------+ -| DEL | FA BEN | 1500 | -| AXEL | BELL | 1000 | -| CRIS | RACHAR | 1000 | -+------------+-----------+--------+ -``` - - - -* 查询所有列: - - - - - - -```javascript -SELECT * FROM employee; -+-------------+------------+-----------+------------+--------+ -| EMPLOYEE_ID | FIRST_NAME | LAST_NAME | MANAGER_ID | SALARY | -+-------------+------------+-----------+------------+--------+ -| 111 | DEL | FA BEN | 1 | 1500 | -| 112 | AXEL | BELL | 1 | 1000 | -| 113 | CRIS | RACHAR | 1 | 1000 | -+-------------+------------+-----------+------------+--------+ -``` - - - -* 对列进行数学运算: - - - - - - -```javascript -SELECT salary+100 FROM employee; -+------------+ -| SALARY+100 | -+------------+ -| 1600 | -| 1100 | -| 1100 | -+------------+ -``` - - - -* 给列取别名: - - - - - - -```javascript -SELECT salary*12 年薪 FROM employee; -+--------+ -| 年薪 | -+--------+ -| 18000 | -| 12000 | -| 12000 | -+--------+ -``` - - - -* 字符串拼接: - - - - - - -```javascript -SELECT first_name || '-' || last_name AS 姓名 FROM employee; -+-------------+ -| 姓名 | -+-------------+ -| DEL-FA BEN | -| AXEL-BELL | -| CRIS-RACHAR | -+-------------+ -``` - - - -* 数据去重: - - - - - - -```javascript -SELECT DISTINCT MANAGER_ID FROM employee; -+------------+ -| MANAGER_ID | -+------------+ -| 1 | -+------------+ -``` - - - -* `CASE WHEN` 语句: - - - - -```javascript -SELECT salary, CASE WHEN salary >= 1000 then '高薪' WHEN salary >= 800 THEN '一般' -ELSE '继续努力' END AS typeFROM employee; -+--------+--------+ -| SALARY | TYPE | -+--------+--------+ -| 1500 | 高薪 | -| 1000 | 高薪 | -| 1000 | 高薪 | -+--------+--------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/8.queries-and-subqueries-1/3.hierarchical-query.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/8.queries-and-subqueries-1/3.hierarchical-query.md deleted file mode 100644 index b4f28cb76..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/8.queries-and-subqueries-1/3.hierarchical-query.md +++ /dev/null @@ -1,167 +0,0 @@ -层次查询 -========================= - - - -层次查询(Hierarchical Query)是一种具有特殊功能的查询语句,通过它能够将分层数据按照层次关系展示出来。分层数据是指关系表中的数据之间具有层次关系。这种关系在现实生活中十分常见,例如: - -* 组织架构中组长和组员之间的关系。 - - - -* 企业中上下级部门之间的关系。 - - - -* Web 网页中,页面跳转的关系。 - - - - - - -语法 --------------- - -```javascript -SELECT [level], column, expr... FROM table [WHERE condition] [ START WITH start_expression ] -CONNECT BY [NOCYCLE] { PRIOR child_expr = parent_expr | parent_expr = PRIOR child_expr } -[ ORDER SIBLINGS BY ...] [ GROUP BY ... ] [ HAVING ... ] [ ORDER BY ... ] -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|--------------------|-----------------------------------------------------------------------------------| -| LEVEL | 节点的层次,是伪列,表示等级。由查询的起点开始算起为 1,依次类推。 | -| CONNECT_BY_ISLEAF | 当前数据行是否是层次关系中的叶子节点,是伪列,0表示不是,1表示是。 | -| CONNECT_BY_ISCYCLE | 当前数据行是否在循环中,是伪列,0表示不是,1表示是。 | -| CONNECT_BY_ROOT运算符 | CONNECT_BY_ROOT是一元运算符,表示参数中的列来自于层次查询的根节点,与一元的 + 和 - 具有相同的优先级。 | -| condition | 条件。 | -| CONNECT BY | 指明如何来确定父子关系,这里通常使用等值表达式,但其他表达式同样支持。 | -| START WITH | 指明层次查询中的根行(Root row)。 | -| PRIOR 运算符 | `PRIOR` 是一元运算符,表示参数中的列来自于父行(Parent row),与一元的 + 和 - 具有相同的优先级。 | -| NOCYCLE | 当指定该关键字时,即使返回结果中有循环仍旧可以返回,并可以通过 `CONNECT_BY_ISCYCLE` 虚拟列来指明哪里出现循环;否则,出现循环会给客户端报错。 | -| ORDER SIBLINGS BY | 指定同一个层级行之间的排列顺序。 | - - - -执行流程 ----------------- - -使用和实现层次查询最关键是要理解其执行流程,层次查询执行流程: - -1. 执行 `FROM` 后面的 `SCAN` 或 `JOIN` 操作; - - - -2. 根据 `START WITH` 和 `CONNECT BY` 的内容生成层次关系结果; - - - -3. 按照常规查询执行流程执行剩下的子句(例如 `WHERE`、`GROUP`、`ORDER BY`......)对于 2 中生成层次关系的流程可以理解为: - - - -4. 根据 `START WITH` 中的表达式得到根行(Root rows)。 - - - -5. 根据 `CONNECT BY` 中的表达式 选择每个根行(Root rows)的子行(Child rows)。 - - - -6. 将 2 中生成的子行(Child rows)作为新的根行(Root rows)进一步生成子行(Child rows),周而复始直到没有新行生成。 - - - - - - -示例 --------------- - -展示层次查询的使用,向表 **emp** 中的 **emp_id** 、 **position** 和 **mgr_id** 列插入数据。执行以下语句: - -```javascript -CREATE TABLE emp(emp_id INT,position VARCHAR(50),mgr_id INT); -INSERT INTO emp VALUES (1,'全球经理',NULL); -INSERT INTO emp VALUES (2,'欧洲区经理',1); -INSERT INTO emp VALUES (3,'亚太区经理',1); -INSERT INTO emp VALUES (4,'美洲区经理',1); -INSERT INTO emp VALUES (5,'意大利区经理',2); -INSERT INTO emp VALUES (6,'法国区经理',2); -INSERT INTO emp VALUES (7,'中国区经理',3); -INSERT INTO emp VALUES (8,'韩国区经理',3); -INSERT INTO emp VALUES (9,'日本区经理',3); -INSERT INTO emp VALUES (10,'美国区经理',4); -INSERT INTO emp VALUES (11,'加拿大区经理',4); -INSERT INTO emp VALUES (12,'北京区经理',7); -``` - - - -通过上面的内容可以看见列 **position** 具有清晰的层次关系。树状结构如下: - -![](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/8355055061/p179244.png) - -是按照层次结构将结果展示出来,执行以下语句: - -```javascript -SELECT emp_id, mgr_id, position, level FROM emp -START WITH mgr_id IS NULL CONNECT BY PRIOR emp_id = mgr_id; -``` - - - -查询结果如下: - -```javascript -+--------+--------+-------------------+-------+ -| EMP_ID | MGR_ID | POSITION | LEVEL | -+--------+--------+-------------------+-------+ -| 1 | NULL| 全球经理 | 1 | -| 2 | 1 | 欧洲区经理 | 2 | -| 5 | 2 | 意大利区经理 | 3 | -| 6 | 2 | 法国区经理 | 3 | -| 3 | 1 | 亚太区经理 | 2 | -| 7 | 3 | 中国区经理 | 3 | -| 12 | 7 | 北京区经理 | 4 | -| 8 | 3 | 韩国区经理 | 3 | -| 9 | 3 | 日本区经理 | 3 | -| 4 | 1 | 美洲区经理 | 2 | -| 10 | 4 | 美国区经理 | 3 | -| 11 | 4 | 加拿大区经理 | 3 | -+--------+--------+-------------------+-------+ -``` - - - -如果仅查询"亚太区"的层次结构,执行以下语句: - -```javascript -SELECT emp_id, mgr_id, position, level FROM emp START WITH position = '亚太区经理' CONNECT BY PRIOR emp_id = mgr_id; -``` - - - -查询结果如下: - -```javascript -+--------+--------+----------------+-------+ -| EMP_ID | MGR_ID | POSITION | LEVEL | -+--------+--------+----------------+-------+ -| 3 | 1 | 亚太区经理 | 1 | -| 7 | 3 | 中国区经理 | 2 | -| 12 | 7 | 北京区经理 | 3 | -| 8 | 3 | 韩国区经理 | 2 | -| 9 | 3 | 日本区经理 | 2 | -+--------+--------+----------------+-------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/8.queries-and-subqueries-1/4.collection-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/8.queries-and-subqueries-1/4.collection-1.md deleted file mode 100644 index 7095c504f..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/8.queries-and-subqueries-1/4.collection-1.md +++ /dev/null @@ -1,305 +0,0 @@ -集合 -======================= - - - -您可以使用集合运算符 `UNION`、`UNION ALL`、`INTERSECT` 和 `MINUS` 来组合多个查询。 所有集合运算符都具有相同的优先级。如果 `SQL` 语句包含多个集合运算符,则 OceanBase 从左到右对它们进行判断,除非括号中指定了顺序。 - -集合运算符的规则和限制 ------------------------ - -您可以指定 `UNION` 的属性为 `ALL` 和 `DISTINCT` 或 `UNIQUE`。分别代表集合可重复,和集合不可重复。而其它几种集合操作是不能指定 `ALL` 属性的(它们只有 `DISTINCT` 属性)。所有的集合操作默认的属性是 `DISTINCT`。在 Oceanbase 中,集合操作中可以指定 `ORDER BY` 和 `LIMIT` 子句,但是不允许其他子句的出现。我们仅支持`MINUS`,不支持 `EXCEPT` 尽管这两者的语义是相同的。参加集合操作的各查询结果的列数和相应表达式的数量必须相同,对应的数据类型也必须兼容(例如数值或字符)。 - -### 集合运算符规则 - -如果组件查询是字符数据,则返回值的数据类型如下: - -* 查询两个长度相等的 `VARCHAR2` 类型值,则返回的值为相同长度的 `CHAR` 类型。 查询不同长度的 `CHAR` 类型值,则返回的值为 `VARCHAR2` 类型,其长度为较大的 `CHAR` 值。 - - - -* 其中一个或两个查询是 `VARCHAR2` 数据类型的值,则返回的值为 `VARCHAR2` 类型。 - - - - - - -如果组件查询是数值数据,则返回值的数据类型由数值优先级决定: - -* 查询 `BINARY_DOUBLE` 类型值,则返回的值为 `BINARY_DOUBLE` 类型。 - - - -* 查询都选择 `BINARY_FLOAT` 类型值,则返回的值为 `BINARY_FLOAT` 类型。 - - - -* 所有查询都选择 `NUMBER` 类型值,则返回的值为 `NUMBER` 类型。 - - - - - - -在使用集合运算符的查询中,OceanBase 不会跨数据类型组执行隐式转换。如果组件查询的相应表达式同时解析为字符数据和数值数据,OceanBase 将返回错误。 - -### 集合运算符限制 - -集合运算符受到以下限制: - -* 集合运算符在 `BLOB` 和 `CLOB` 的列上无效。 - - - -* 如果集合运算符前面的 `SELECT` 列表包含表达式,则必须为表达式提供列别名,以便在 `ORDER BY` 子句引用。 - - - -* 您不能用设置的运算符指定 `UPDATE` 语句。 - - - -* 您不能在这些运算符的子查询中指定 `ORDER BY` 语句。 - - - -* 不能在包含表集合表达式的 `SELECT` 语句中使用这些运算符 。 - - - - - - -UNION 运算符和 UNION ALL 运算符 ------------------------------------- - -`UNION` 运算符用于合并两个或多个 `SELECT` 语句的结果集。`UNION` 内部的 `SELECT` 语句必须拥有相同数量的列。列也必须拥有相似的数据类型。同时,每条 `SELECT` 语句中的列的顺序必须相同。默认地,`UNION` 运算符选取不同的值。如果允许重复的值,请使用 `UNION ALL`。 - -### 语法 - -```javascript -{ (< SQL- 查询语句 1>) } -UNION [ALL] -{ (< SQL- 查询语句 2>) } -``` - - - -INTERSECT 运算符 -------------------------- - -返回两个结果集的交集,即两个查询都返回的所有非重复值。 - -### 语法 - -```javascript -{ (< SQL- 查询语句 1>) } -INTERSECT -{ (< SQL- 查询语句 2>) } -``` - - - -### 限制条件 - -* 所有查询中的列数和列的顺序必须相同。 - - - -* 比较的两个查询结果集中的列数据类型可以不同但必须兼容。 - - - -* 比较的两个查询结果集中不能包含不可比较的数据类型列(XML、TEXT、NTEXT、IMAGE 或非二进制 CLR 用户定义类型)。 - - - -* 返回的结果集的列名与操作数左侧的查询返回的列名相同。`ORDER BY` 子句中的列名或别名必须引用左侧查询返回的列名。 - - - -* 不能与 `COMPUTE` 和 `COMPUTE BY` 子句一起使用。 - - - -* 通过比较行来确定非重复值时,两个 NULL 值被视为相等。 - - - - - - -MINUS 运算符 ---------------------- - -`MINUS` 运算符返回两个结果集的差,即从左查询中返回右查询没有找到的所有非重复值。 - -### 语法 - -```javascript -{ (< SQL- 查询语句 1>) } -MINUS -{ (< SQL- 查询语句 2>) } -``` - - - -### 执行顺序 - -与表达式中的其他运算符一起使用时的执行顺序: - -1、括号中的表达式。 - -2、`INTERSECT` 操作数。 - -3、基于在表达式中的位置从左到右求值的 `MINUS` 和 `UNION`。 - -如果 `MINUS` 或 `INTERSECT` 用于比较两个以上的查询集,则数据类型转换是通过一次比较两个查询来确定的,并遵循前面提到的表达式求值规则。 - -示例 --------------- - -以下语句创建了表 **table_a** 和表 **table_b** ,并向表中插入数据: - -```javascript -CREATE TABLE table_a(PK INT, name VARCHAR(25)); -INSERT INTO table_a VALUES(1,'福克斯'); -INSERT INTO table_a VALUES(2,'警察'); -INSERT INTO table_a VALUES(3,'的士'); -INSERT INTO table_a VALUES(4,'林肯'); -INSERT INTO table_a VALUES(5,'纽约'); -INSERT INTO table_a VALUES(6,'华盛顿'); -INSERT INTO table_a VALUES(7,'戴尔'); -INSERT INTO table_a VALUES(10,'朗讯'); -CREATE TABLE table_b(PK INT, name VARCHAR(25)); -INSERT INTO table_b VALUES(1,'福克斯'); -INSERT INTO table_b VALUES(2,'警察'); -INSERT INTO table_b VALUES(3,'的士'); -INSERT INTO table_b VALUES(6,'华盛顿'); -INSERT INTO table_b VALUES(7,'戴尔'); -INSERT INTO table_b VALUES(8,'微软'); -INSERT INTO table_b VALUES(9,'苹果'); -INSERT INTO table_b VALUES(11,'苏格兰'); -``` - - - -**UNION 示例** : - -```javascript -SELECT PK, name FROM table_a -UNION -SELECT PK, name FROM table_b; -``` - - - -查询结果如下: - -```javascript -+------+-----------+ -| PK | NAME | -+------+-----------+ -| 1 | 福克斯 | -| 2 | 警察 | -| 3 | 的士 | -| 4 | 林肯 | -| 5 | 纽约 | -| 6 | 华盛顿 | -| 7 | 戴尔 | -| 10 | 朗讯 | -| 8 | 微软 | -| 9 | 苹果 | -| 11 | 苏格兰 | -+------+-----------+ -``` - - - -**UNION ALL 示例** : - -```javascript -SELECT PK, name FROM table_a -UNION ALL -SELECT PK, name FROM table_b; -``` - - - -查询结果如下: - -```javascript -+------+-----------+ -| PK | NAME | -+------+-----------+ -| 1 | 福克斯 | -| 2 | 警察 | -| 3 | 的士 | -| 4 | 林肯 | -| 5 | 纽约 | -| 6 | 华盛顿 | -| 7 | 戴尔 | -| 10 | 朗讯 | -| 1 | 福克斯 | -| 2 | 警察 | -| 3 | 的士 | -| 6 | 华盛顿 | -| 7 | 戴尔 | -| 8 | 微软 | -| 9 | 苹果 | -| 11 | 苏格兰 | -+------+-----------+ -``` - - - -**INTERSECT 示例** : - -```javascript -SELECT PK, NAME FROM table_a -INTERSECT -SELECT PK, NAME FROM table_b; -``` - - - -查询结果如下: - -```javascript -+------+-----------+ -| PK | NAME | -+------+-----------+ -| 1 | 福克斯 | -| 2 | 警察 | -| 3 | 的士 | -| 6 | 华盛顿 | -| 7 | 戴尔 | -+------+-----------+ -``` - - - -**MINUS 示例** : - -```javascript -SELECT PK, NAME FROM table_a -MINUS -SELECT PK, NAME FROM table_b; -``` - - - -查询结果如下: - -```javascript -+------+--------+ -| PK | NAME | -+------+--------+ -| 4 | 林肯 | -| 5 | 纽约 | -| 10 | 朗讯 | -+------+--------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/8.queries-and-subqueries-1/5.connection-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/8.queries-and-subqueries-1/5.connection-1.md deleted file mode 100644 index 8dc4ebac2..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/8.queries-and-subqueries-1/5.connection-1.md +++ /dev/null @@ -1,286 +0,0 @@ -连接 -======================= - - - -连接(Join)是将两个或多个表、视图或物化视图的结合在一起的查询。当查询的 `FROM` 子句中出现多个表时OceanBase 数据库会进行连接查询,查询输出列可以从`FROM` 子句任何表中选取。 如果多个表都有一个列名,那么您必须用表名限定查询过程中对这些列的所有引用。数据库中的连接类型一般包括 `inner join`、`outer join`、`semi-join` 和 `anti-join`。其中 `Semi-join` 和 `Anti-join` 都是通过子查询改写得到,OceanBase 本身并没有表述 `Anti-join` 和 `Semi-join` 的语法。 - -连接条件 ----------------- - -连接条件是将多表结合在一起的规则,存在于从句或 `WHERE` 子句中,用于比较来自不同的表两列,多数连接至少包含一个连接条件。连接条件可以分为等值连接(比如 t1.a = t2.b)和非等值连接(t1.a \< t2.b),相比于非等值连接条件, 等值连接条件允许数据库使用高效的连接算法,比如 `Hash Join` 和 `Merge-Sort join`。 - -为了执行连接,OceanBase 从不同表取行组合成对,使用连接条件进行匹配。 要执行两表以上的多表连接,OceanBase 首先根据比较它们的列的连接条件连接其中的两个表,然后根据包含连接表和新表列的连接条件将结果连接到另一个表。优化器根据连接条件、基表索引以及可用统计信息确定 OceanBase 连接顺序。 - -`WHERE` 子句除了连接条件还可能含有其他条件,这些仅引用一个表的条件可以进一步限制连接查询返回的行数。 - -等值连接(EQUI-JOINS) ----------------------------- - -等值连接(Equijoins)是连接条件包含等式运算符的连接。进行等值连接时将特定列满足等值条件的行进行组合输出。 - -自连接(SELF-JOIN) --------------------------- - -自连接是表与其自身的连接。该表在 `FROM` 子句中出现两次,后跟表别名,这些别名限定联接条件中的列名。执行自连接时OceanBase数据库将组合并返回满足连接条件的行。 - -笛卡儿积(Cartesian Products) ------------------------------------- - -如果连接查询中的两个表没有连接条件,OceanBase 数据库返回其笛卡尔乘积,使用第一个表的每一行与另一表每一个行进行组合输出。笛卡尔乘积总是生成许多行,很少有用。 例如,两个都有 100 行的表的笛卡尔积有 10,000 行。除非您特别需要笛卡尔乘积,否则始终包括一个连接条件。 如果查询连接了三个或多个表,并且没有为特定对指定连接条件,则优化器可以选择避免生成中间笛卡尔乘积的连接顺序。 - -内连接(INNER JOIN) ---------------------------- - -内连接(INNER JOIN)是数据库中最基本的连接操作。内连接基于连接条件将两张表(如 A 和 B)的列组合在一起,产生新的结果表。查询会将 A 表的每一行和 B 表的每一行进行比较,并找出满足连接条件的组合。当连接条件被满足,A 和 B 中匹配的行会按列组合(并排组合)成结果集中的一行。连接产生的结果集等于首先对两张表做笛卡尔积,将 A 中的每一行和 B 中的每一行组合,然后返回满足连接条件的记录。 - -外连接(OUTER JOIN) ---------------------------- - -外连接(OUTER JOIN) 返回满足连接条件的所有行,同时从一个表返回没有使用的行,在另一个表相应位置填充`NULL`。外连接可依据连接表保留左表、右表或全部表的行而进一步分为左连接、右连接和全连接。其中左连接(LEFT \[OUTER\] JOIN)中左表行未在右表匹配到行时,在右表自动填充 `NULL`。右连接(RIGHT \[OUTER\] JOIN)中右表行未在左表匹配到行时,在左表自动填充 `NULL`。全连接(FULL \[OUTER\] JOIN)左表或者右表未在其它表匹配到行时均会填充`NULL`。 - -SEMI 连接(SEMI-JOIN) ------------------------------- - -当 A 表和 B 表进行 `LEFT` 或 `RIGHT ANTI-JOIN` 的时候,它只返回 A 或 B 中所有能够在 B 或 A 中找到匹配的行。`SEMI-JOIN` 只能通过子查询展开得到。 - -ANTI 连接(ANTI-JOIN) ------------------------------- - -当 A 表和 B 表进行 `LEFT` 或 `RIGHT ANTI-JOIN` 的时候,它只返回 A 或 B 中所有不能在 B 或 A 中找到匹配的行。类似于 `SEMI-JOIN`,`ANTI-JOIN` 也只能通过子查询展开得到。 - -示例 --------------- - -建立表 **table_a** 和表 **table_b** ,并插入数据。执行以下语句: - -```javascript -CREATE TABLE table_a(PK INT, name VARCHAR(25)); -INSERT INTO table_a VALUES(1,'福克斯'); -INSERT INTO table_a VALUES(2,'警察'); -INSERT INTO table_a VALUES(3,'的士'); -INSERT INTO table_a VALUES(4,'林肯'); -INSERT INTO table_a VALUES(5,'亚利桑那州'); -INSERT INTO table_a VALUES(6,'华盛顿'); -INSERT INTO table_a VALUES(7,'戴尔'); -INSERT INTO table_a VALUES(10,'朗讯'); -CREATE TABLE table_b(PK INT, name VARCHAR(25)); -INSERT INTO table_b VALUES(1,'福克斯'); -INSERT INTO table_b VALUES(2,'警察'); -INSERT INTO table_b VALUES(3,'的士'); -INSERT INTO table_b VALUES(6,'华盛顿'); -INSERT INTO table_b VALUES(7,'戴尔'); -INSERT INTO table_b VALUES(8,'微软'); -INSERT INTO table_b VALUES(9,'苹果'); -INSERT INTO table_b VALUES(11,'苏格兰威士忌'); -``` - - - -**自连接查询(SELF-JOIN)** : - -```javascript -SELECT * FROM table_a ta, table_a tb WHERE ta.NAME = tb.NAME; -``` - - - -查询结果如下: - -```javascript -+------+-----------------+------+-----------------+ -| PK | NAME | PK | NAME | -+------+-----------------+------+-----------------+ -| 1 | 福克斯 | 1 | 福克斯 | -| 2 | 警察 | 2 | 警察 | -| 3 | 的士 | 3 | 的士 | -| 4 | 林肯 | 4 | 林肯 | -| 5 | 亚利桑那州 | 5 | 亚利桑那州 | -| 6 | 华盛顿 | 6 | 华盛顿 | -| 7 | 戴尔 | 7 | 戴尔 | -| 10 | 朗讯 | 10 | 朗讯 | -+------+-----------------+------+-----------------+ -``` - - - -**内连接(INNER JOIN)查询** : - -```javascript -SELECT A.PK AS A_PK, A.name AS A_Value, B.PK AS B_PK, B.name AS B_Value -FROM table_a A INNER JOIN table_b B ON A.PK = B.PK; -``` - - - -查询结果如下: - -```javascript -+------+-----------+------+-----------+ -| A_PK | A_VALUE | B_PK | B_VALUE | -+------+-----------+------+-----------+ -| 1 | 福克斯 | 1 | 福克斯 | -| 2 | 警察 | 2 | 警察 | -| 3 | 的士 | 3 | 的士 | -| 6 | 华盛顿 | 6 | 华盛顿 | -| 7 | 戴尔 | 7 | 戴尔 | -+------+-----------+------+-----------+ -``` - - - -**左连接查询** : - -```javascript -SELECT A.PK AS A_PK, A.name AS A_Value, B.PK AS B_PK, B.name AS B_Value -FROM table_a A LEFT JOIN table_b B ON A.PK = B.PK; -``` - - - -查询结果如下: - -```javascript -+------+-----------------+------+-----------+ -| A_PK | A_VALUE | B_PK | B_VALUE | -+------+-----------------+------+-----------+ -| 1 | 福克斯 | 1 | 福克斯 | -| 2 | 警察 | 2 | 警察 | -| 3 | 的士 | 3 | 的士 | -| 6 | 华盛顿 | 6 | 华盛顿 | -| 7 | 戴尔 | 7 | 戴尔 | -| 4 | 林肯 | NULL | NULL | -| 5 | 亚利桑那州 | NULL | NULL | -| 10 | 朗讯 | NULL | NULL | -+------+-----------------+------+-----------+ -``` - - - -**右连接查询** : - -```javascript -obclient> SELECT A.PK AS A_PK, A.name AS A_Value, B.PK AS B_PK, B.name AS B_Value FROM table_a A RIGHT JOIN table_b B ON A.PK = B.PK; -``` - - - -查询结果如下: - -```javascript -+------+-----------+------+--------------------+ -| A_PK | A_VALUE | B_PK | B_VALUE | -+------+-----------+------+--------------------+ -| 1 | 福克斯 | 1 | 福克斯 | -| 2 | 警察 | 2 | 警察 | -| 3 | 的士 | 3 | 的士 | -| 6 | 华盛顿 | 6 | 华盛顿 | -| 7 | 戴尔 | 7 | 戴尔 | -| NULL | NULL | 8 | 微软 | -| NULL | NULL | 9 | 苹果 | -| NULL | NULL | 11 | 苏格兰威士忌 | -+------+-----------+------+--------------------+ -``` - - - -**全连接查询** : - -```javascript -obclient> SELECT A.PK AS A_PK,A.name AS A_Value,B.PK AS B_PK,B.name AS B_Value FROM table_a A FULL JOIN table_b B ON A.PK = B.PK; -``` - - - -查询结果如下: - -```javascript -+------+-----------------+------+--------------------+ -| A_PK | A_VALUE | B_PK | B_VALUE | -+------+-----------------+------+--------------------+ -| 1 | 福克斯 | 1 | 福克斯 | -| 2 | 警察 | 2 | 警察 | -| 3 | 的士 | 3 | 的士 | -| 6 | 华盛顿 | 6 | 华盛顿 | -| 7 | 戴尔 | 7 | 戴尔 | -| NULL | NULL | 8 | 微软 | -| NULL | NULL | 9 | 苹果 | -| NULL | NULL | 11 | 苏格兰威士忌 | -| 4 | 林肯 | NULL | NULL | -| 5 | 亚利桑那州 | NULL | NULL | -| 10 | 朗讯 | NULL | NULL | -+------+-----------------+------+--------------------+ -``` - - - -**Semi 连接(semi-join)** :有依赖关系的子查询被展开改写成 **SEMI-JOIN** 。 - -```javascript -explain SELECT * FROM table_a t1 WHERE t1.PK IN (SELECT t2.PK FROM table_b t2 WHERE t2.NAME = t1.NAME); -``` - - - -查询结果如下: - -```javascript -+------------------------------------------------+ -| Query Plan | -+------------------------------------------------+ -======================================= -|ID|OPERATOR |NAME|EST. ROWS|COST| ---------------------------------------- -|0 |HASH SEMI JOIN| |8 |114 | -|1 | TABLE SCAN |T1 |8 |38 | -|2 | TABLE SCAN |T2 |8 |38 | -======================================= - -Outputs & filters: -------------------------------------- - 0 - output([T1.PK], [T1.NAME]), filter(nil), - equal_conds([T1.PK = T2.PK], [T2.NAME = T1.NAME]), other_conds(nil) - 1 - output([T1.NAME], [T1.PK]), filter(nil), - access([T1.NAME], [T1.PK]), partitions(p0) - 2 - output([T2.NAME], [T2.PK]), filter(nil), - access([T2.NAME], [T2.PK]), partitions(p0) -+------------------------------------------------+ -``` - - - -**Anti 连接(anti-join)** :有依赖关系的子查询被改写成 `Anti-join`。 - -```javascript -EXPLAIN SELECT * FROM table_a t1 WHERE t1.PK NOT IN (SELECT t2.PK -FROM table_b t2 WHERE t2.name = t1.name); -``` - - - -查询结果如下: - -```javascript -+------------------------------------------------+ -| Query Plan | -+------------------------------------------------+ -======================================= -|ID|OPERATOR |NAME|EST. ROWS|COST| ---------------------------------------- -|0 |HASH ANTI JOIN| |0 |112 | -|1 | TABLE SCAN |T1 |8 |38 | -|2 | TABLE SCAN |T2 |8 |38 | -======================================= -Outputs & filters: -------------------------------------- - 0 - output([T1.PK], [T1.NAME]), filter(nil), - equal_conds([T2.NAME = T1.NAME]), other_conds([(T_OP_OR, T1.PK = T2.PK, - (T_OP_IS, T1.PK, NULL, 0), (T_OP_IS, T2.PK, NULL, 0))]) - 1 - output([T1.NAME], [T1.PK]), filter(nil), - access([T1.NAME], [T1.PK]), partitions(p0) - 2 - output([T2.NAME], [T2.PK]), filter(nil), - access([T2.NAME], [T2.PK]), partitions(p0) -+---------------------------------------------------------+ -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/8.queries-and-subqueries-1/6.subquery-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/8.queries-and-subqueries-1/6.subquery-1.md deleted file mode 100644 index 7c66612bb..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/8.queries-and-subqueries-1/6.subquery-1.md +++ /dev/null @@ -1,194 +0,0 @@ -子查询 -======================== - - - -子查询指的是 `SELECT` 查询语句中嵌套了另一个或者多个 `SELECT` 语句,可以返回单行结果、多行结果或不返回结果。`SELECT` 语句的 `FROM` 子句中的子查询也称为内联视图,`SELECT` 语句的 `WHERE` 子句中的子查询也称为嵌套子查询。 - -子查询可以分为相关子查询和非相关子查询。相关子查询指该子查询的执行依赖了外部查询的变量,这种子查询通常会执行多次。非相关子查询指该子查询的执行不依赖外部查询的变量,这种子查询一般只需要计算一次。对于非相关子查询与部分相关子查询,可以通过改写进行子查询消除,实现嵌套子查询的展开。 - -语法 --------------- - -```javascript -SELECT [ hint ] [ { { DISTINCT | UNIQUE } | ALL } ] select_list -FROM { table_reference | join_clause | ( join_clause ) } - [ , { table_reference | join_clause | (join_clause) } ] - [ where_clause ] - [ hierarchical_query_clause ] - [ group_by_clause ] -| subquery { UNION [ALL] | INTERSECT | MINUS } subquery [ { UNION [ALL] | INTERSECT | MINUS } subquery ] -| ( subquery ) [ order_by_clause ] [ row_limiting_clause ] -``` - - - -参数 --------------- - - - -| 参数 | 说明 | -|-----------------|---------| -| select_list | 查询列表 | -| subquery | 子查询 | -| hint | 注释 | -| table_reference | 要查询的目标表 | - - - -如果子查询中的列与外层查询中的列具有相同列名,必须在外层查询中在重复列名前加上表名或使用别名。 - -当上层查询引用到子查询中相关列时,将执行子查询,上层查询可以是`SELECT`,`UPDATE` 或 `DELETE`语句,各语句中使用子查询方式: - -* 定义要插入到 `INSERT` 或 `CREATE TABLE` 语句的目标表中的行集。 - - - -* 在 `CREATE VIEW` 或 `CREATE MATERIALIZED VIEW` 语句中定义要包含在视图或物化视图中的行集。 - - - -* 在 `UPDATE` 中定义要分配给现有行的一个或多个值。 - - - -* 在 `WHERE` 子句、`HAVING` 子句或 `START WITH` 中提供条件值。 - - - -* 定义包含查询操作的表。 - - - - - - -嵌套子查询的展开(Unnesting of Nested Subqueries) -------------------------------------------------- - -嵌套子查询展开是数据库的一种优化策略,它把一些子查询置于外层的父查询中,其实质是把某些子查询转化为等价的多表连接操作。这种策略带来的一个明显的好处是能够有效利用访问路径、连接方法和连接顺序,使查询的层次尽可能的减少。 - -以下情况数据库将进行嵌套子查询的展开: - -* 不相关的 `IN` 子查询。 - - - -* `IN` 和 `EXISTS` 中的相关子查询不包含聚合函数或 `GROUP BY` 子句。 - - - - -可以通过 Hint `UNNEST` 控制是否展开嵌套子查询。 - -示例 ------------ - -以下语句创建了表 **table_a** 和表 **table_b** ,并向表中插入数据: - -```javascript -CREATE TABLE table_a(PK INT, name VARCHAR(25)); -INSERT INTO table_a VALUES(1,'福克斯'); -INSERT INTO table_a VALUES(2,'警察'); -INSERT INTO table_a VALUES(3,'的士'); -INSERT INTO table_a VALUES(4,'林肯'); -INSERT INTO table_a VALUES(5,'亚利桑那州'); -INSERT INTO table_a VALUES(6,'华盛顿'); -INSERT INTO table_a VALUES(7,'戴尔'); -INSERT INTO table_a VALUES(10,'朗讯'); -CREATE TABLE table_b(PK INT, name VARCHAR(25)); -INSERT INTO table_b VALUES(1,'福克斯'); -INSERT INTO table_b VALUES(2,'警察'); -INSERT INTO table_b VALUES(3,'的士'); -INSERT INTO table_b VALUES(6,'华盛顿'); -INSERT INTO table_b VALUES(7,'戴尔'); -INSERT INTO table_b VALUES(8,'微软'); -INSERT INTO table_b VALUES(9,'苹果'); -INSERT INTO table_b VALUES(11,'苏格兰威士忌'); -``` - - - -没有依赖关系的子查询,执行以下语句: - -```javascript -SELECT * FROM TABLE_A T1 WHERE T1.PK IN (SELECT T2.PK FROM TABLE_B T2); -``` - - - -查询结果如下: - -```javascript -+------+-----------+ -| PK | NAME | -+------+-----------+ -| 1 | 福克斯 | -| 2 | 警察 | -| 3 | 的士 | -| 6 | 华盛顿 | -| 7 | 戴尔 | -+------+-----------+ -``` - - - -有依赖关系的子查询,子查询中用到了外层查询变量 **T1.PK** ,执行以下语句: - -```javascript -SELECT * FROM TABLE_A T1 WHERE T1.PK IN (SELECT T2.PK FROM TABLE_B T2 WHERE T2.PK = T1.PK); -``` - - - -查询结果如下: - -```javascript -+------+-----------+ -| PK | NAME | -+------+-----------+ -| 1 | 福克斯 | -| 2 | 警察 | -| 3 | 的士 | -| 6 | 华盛顿 | -| 7 | 戴尔 | -+------+-----------+ -``` - - - -有依赖关系的子查询被展开改写成连接,执行以下语句: - -```javascript -EXPLAIN SELECT * FROM TABLE_A T1 WHERE T1.PK IN (SELECT T2.NAME FROM TABLE_B T2 WHERE T2.NAME = T1.NAME); -``` - - - -查询结果如下: - -```javascript -+------------------------------------+ -| Query Plan | -+------------------------------------+ -============================================= -|ID|OPERATOR |NAME|EST. ROWS|COST| ---------------------------------------------- -|0 |HASH RIGHT SEMI JOIN| |8 |107 | -|1 | TABLE SCAN |T2 |8 |38 | -|2 | TABLE SCAN |T1 |8 |38 | -============================================= -Outputs & filters: -------------------------------------- - 0 - output([T1.PK], [T1.NAME]), filter(nil), - equal_conds([T1.PK = T2.NAME], [T2.NAME = T1.NAME]), other_conds(nil) - 1 - output([T2.NAME]), filter(nil), - access([T2.NAME]), partitions(p0) - 2 - output([T1.NAME], [T1.PK]), filter(nil), - access([T1.NAME], [T1.PK]), partitions(p0) -+------------------------------------+ -``` - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/1.alter-keystore.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/1.alter-keystore.md deleted file mode 100644 index f0af1f0e3..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/1.alter-keystore.md +++ /dev/null @@ -1,65 +0,0 @@ -ALTER KEYSTORE -=================================== - - - -描述 ------------ - -该语句用于修改 Keystore 属性,包括打开/关闭 Keystore、修改 Keystore 密码、生成 Keystore 密钥。 - -格式 ------------ - -```javascript -## 打开/关闭 KEYSTORE -ADMINISTER KEY MANAGEMENT SET KEYSTORE OPEN IDENTIFIED BY [password]; -ADMINISTER KEY MANAGEMENT SET KEYSTORE CLOSE IDENTIFIED BY [password]; - -## 设置密钥 -ADMINISTER KEY MANAGEMENT SET KEY IDENTIFIED BY [password] -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|---------------|---------------------| -| keystore_name | 指定 Keystore 名称 | -| password | 指定访问控制 Keystore 的密码 | - - - -示例 ------------ - -* 打开 Keystore,在 keystore 处于 open 状态时,才能访问加密表以及 set key 操作。 - - - - - - -```javascript -ADMINISTER KEY MANAGEMENT SET KEYSTORE OPEN IDENTIFIED BY abcCBAK123; -``` - - - -* 更新 Keystore 中存放的主密钥。 - - - - - - -```javascript -ADMINISTER KEY MANAGEMENT SET KEY IDENTIFIED BY abcCBAK123; -``` - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/10.create-outline-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/10.create-outline-1.md deleted file mode 100644 index ec3680c9b..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/10.create-outline-1.md +++ /dev/null @@ -1,96 +0,0 @@ -CREATE OUTLINE -=================================== - - - -描述 ------------ - -该语句用来创建 OUTLINE。可以通过两种方式创建,一种是通过 SQL_TEXT(用户执行的带参数的原始语句),另一种是通过 SQL_ID 创建。 -**注意** - - - -创建 OUTLINE 需要进入对应的用户下执行。 - -格式 ------------ - -* **使用** **SQL_TEXT 创建** **OUTLINE** - - - - - - -```javascript -CREATE [OR REPLACE] OUTLINE outline_name ON stmt [ TO target_stmt ] -``` - - - -* **使用** **SQL_ID 创建** **OUTLINE** - - - - - - -```javascript -CREATE OUTLINE outline_name ON sql_id USING HINT hint; -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| outline_name | 指定要创建的 OUTLINE 名称。 | -| OR REPLACE | 指定 OR REPLACE 后,如果要创建的 OUTLINE 已存在,则会替换原有的 OUTLINE。 | -| stmt | 一般为一个带有 hint 和原始参数的 DML 语句。 | -| TO target_stmt | 如果不指定 TO target_stmt, 则表示如果数据库接受的SQL参数化后与stmt去掉hint参数化文本相同,则将该SQL绑定stmt中hint生成执行计划;如果期望对含有hint的语句进行固定计划,则需要 TO target_stmt 来指明原始的SQL。 **注意** 在使用target_stmt时,严格要求stmt与target_stmt在去掉hint后完全匹配。 | -| sql_id | 如果sql_id对应的SQL语句已经有hint,则创建OUTLINE指定的hint会覆盖原始语句中所有hint。 | -| hint | 格式为 /\*+ xxx \*/ 。 | - - - -示例 ------------ - -* 使用 SQL_TEXT 创建 OUTLINE - - - - - - -```javascript -CREATE OUTLINE otl_idx_c2 -ON SELECT/*+ index(t1 idx_c2)*/ * FROM t1 WHERE c2 = 1; -``` - - - -* 使用 SQL_ID 创建 OUTLINE - - - - - - -```javascript -CREATE OUTLINE otl_idx_c2 -ON 'ED570339F2C856BA96008A29EDF04C74' -USING HINT /*+ index(t1 idx_c2)*/ ; -``` - - - -注意事项 -------------- - -使用 SQL_TEXT 方式创建的 OUTLINE 会覆盖 SQL_ID 方式创建的 OUTLINE,SQL_TEXT 方式创建的优先级高。 diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/11.create-restore-point-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/11.create-restore-point-1.md deleted file mode 100644 index 6f02581da..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/11.create-restore-point-1.md +++ /dev/null @@ -1,47 +0,0 @@ -CREATE RESTORE POINT -========================================= - - - -描述 ------------------------ - -该语句用来创建还原点(Restore Point)。使用该功能可以保留当前时刻的数据快照,并在之后指定在这个数据快照上进行查询。目前还不支持将数据回滚到该还原点。 - -创建还原点后,可以在 V$RESTORE_POINT 视图中查询到该还原点的 SCN 值,然后通过 `SELECT * FROM table_name AS OF SCN scn;` 查询数据快照中的值。 - -格式 ------------------------ - -```unknow -CREATE RESTORE POINT restore_point; -``` - - - -参数解释 -------------------------- - - - -| 参数 | 描述 | -|---------------|----------| -| restore_point | 指定还原点名称。 | - - - -示例 ------------------------ - -* 创建一个还原点 rp1。 - - ```unknow - obclient> CREATE RESTORE POINT rp1; - Query OK, 0 rows affected (0.01 sec) - ``` - - - - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/12.create-sequence.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/12.create-sequence.md deleted file mode 100644 index ee3b05ba0..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/12.create-sequence.md +++ /dev/null @@ -1,84 +0,0 @@ -CREATE SEQUENCE -==================================== - - - -描述 ------------ - -该语句用来创建自增列。 - -格式 ------------ - -```javascript -CREATE SEQUENCE sequence_name -[MINVALUE value | NOMINVALUE] -[MAXVALUE value | NOMAXVALUE] -[START WITH value] -[INCREMENT BY value] -[CACHE value | NOCACHE] -[ORDER | NOORDER] -[CYCLE | NOCYCLE]; -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------| -| MINVALUE value \| NOMINVALUE | 指定自增列的最小值,取值范围是 -10^27^ \~ (10^27^-1)。 如果指定为 NOMINVALUE,则升序时最小值为 1,降序时最小值为 -(10^27^-1)。 不指定时缺省为 NOMINVALUE。 | -| MAXVALUE value \| NOMAXVALUE | 指定自增列的最大值,取值范围是 (-10^27^+1) \~ 10^27^。 如果指定为 NOMAXVALUE,则升序时最大值为(10^28^-1),降序时最大值为 -1。 不指定时缺省为 NOMAXVALUE。 | -| START WITH value | 指定自增列的起始值。该值必须小于等于 MAXVALUE,且大于等于 MINVALUE。 如果不指定,则升序时默认取值为最小值,降序时默认取值为最大值。 | -| INCREMENT BY value | 指定自增列的自增步数。该值不可以为 0。 如果指定为正数,则自增列为升序;如果指定为负数,则自增列为降序。 不指定缺省值为 1。 | -| CACHE value \| NOCACHE | 指定在内存中预分配的自增值个数,默认为20。 | -| ORDER \| NOORDER | 指定自增列的值是否按顺序生成,默认为 NOORDER。 | -| CYCLE \| NOCYCLE | 指定自增列的值是否循环生成,默认为 NOCYCLE。 | - - - -示例 ------------ - -* 创建一个自增列 s1。 - - - - - - -```javascript -OceanBase(ADMIN@TEST)>create sequence S1 minvalue 1 maxvalue 5 nocycle noorder cache 10240000; -``` - - - -注意事项 -------------- - -* 同时指定 MINVALUE 和 MAXVALUE 时,MINVALUE 必须小于 MAXVALUE。 - - - -* MAXVALUE 和 MINVALUE 之差必须大于等于 INCREMENT BY value。 - - - -* CACHE value 的值必须大于 1,如果 CACHE value 的值为 1,则等价于 NOCACHE。 - - - -* 指定了 CYCLE,且 INCREMENT BY value 小于 0 时,必须指定 MINVALUE。 - - - -* 指定了 CYCLE 时, CACHE 的数量必须不能超过一个 cycle。 - - - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/13.create-synonym-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/13.create-synonym-1.md deleted file mode 100644 index 6fdb866c0..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/13.create-synonym-1.md +++ /dev/null @@ -1,137 +0,0 @@ -CREATE SYNONYM -=================================== - - - -描述 ------------ - -该语句用来创建一个同义词。 - -格式 ------------ - -```javascript -CREATE [ OR REPLACE ] [ PUBLIC ] -SYNONYM [ schema. ]synonym -FOR [ schema. ]object; -``` - - - -参数说明 -------------- - - - -| 参数 | 描述 | -|----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| OR REPLACE | 表示如果要创建的同义词名称已存在,则使用新的定义重新创建同义词。 | -| PUBLIC | 指定 PUBLIC 来创建公共同义词,所有用户都可以使用。用户必须对基础对象具有相应的权限才能使用该同义词。 在解析对象的引用时,仅当对象没有指定 schema 时,才会使用公共同义词。 如果不指定 PUBLIC,则同义词是私有的,只能当前 schema访问,并且同义词名称在当前 schema 中必须唯一。 | -| \[ schema. \]synonym | schema 指定当前同义词属于哪个 schema,如果指定了 PUBLIC,则对同义词不需要指定 schema;synonym 表示同义词的名称。 | -| \[ schema. \]object | 表示同义词对应对象的名称。 | - - - -示例 ------------ - -* 创建一个同义词。 - - - - - - -```javascript -OceanBase(TEST@TEST)>create table t1(c1 int); -Query OK, 0 rows affected (0.11 sec) - -OceanBase(TEST@TEST)>create synonym s1 for t1; -Query OK, 0 rows affected (0.04 sec) - -OceanBase(TEST@TEST)>insert into s1 values(1); -Query OK, 1 row affected (0.04 sec) - -OceanBase(TEST@TEST)>select * from s1; -+------+ -| C1 | -+------+ -| 1 | -+------+ -1 row in set (0.02 sec) -``` - - - -* 创建一个 PUBLIC 同义词 - - - - - - -```javascript -OceanBase(TEST@TEST)>create public synonym syn_pub for t1; -Query OK, 0 rows affected (0.04 sec) - -OceanBase(TEST@TEST)>select * from syn_pub; -+------+ -| C1 | -+------+ -| 1 | -+------+ -1 row in set (0.01 sec) -``` - - - -注意事项 -------------- - -创建同义词时,需要满足如下权限要求: - -* 在当前的 schema 下创建私有的 synonym,需要 CREATE SYNONYM 权限 - - - -* 在非当前 schema 下创建私有的 synonym,需要 CREATE ANY SYNONYM 权限 - - - -* 创建 PUBLIC 的 synonym,需要 CREATE PUBLIC SYNONYM 权限 - - - -* 对于需要创建 synonym 的对象不需要存在,也不需要具有访问权限 - - - - - - -```javascript -// 创建synonym_user -OceanBase(TEST@TEST)>CREATE USER synonym_user IDENTIFIED BY synonym_user; -Query OK, 0 rows affected (0.04 sec) - -OceanBase(TEST@TEST)>grant CREATE on test.* to synonym_user; -Query OK, 0 rows affected (0.05 sec) - -OceanBase(TEST@TEST)>grant SELECT on test.* to synonym_user; -Query OK, 0 rows affected (0.02 sec) - -// 连接synonym_user -OceanBase(SYNONYM_USER@TEST)>create or replace synonym s1 for t1; -ERROR-00600: internal error code, arguments: -5036, Access denied; you need (at least one of) the CREATE SYNONYM privilege(s) for this operation - -// 重新给定CREATE SYNONYM权限 -OceanBase(TEST@TEST)>grant CREATE SYNONYM on *.* to synonym_user; -Query OK, 0 rows affected (0.03 sec) - -OceanBase(SYNONYM_USER@TEST)>create synonym s1 for t1; -Query OK, 0 rows affected (0.07 sec) -``` - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/14.create-table-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/14.create-table-1.md deleted file mode 100644 index 66f3d4583..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/14.create-table-1.md +++ /dev/null @@ -1,396 +0,0 @@ -CREATE TABLE -================================= - - - -描述 ------------ - -该语句用来在数据库中创建一张新表。 - -格式 ------------ - -```javascript -CREATE [GLOBAL TEMPORARY] TABLE table_name - (table_definition_list) [table_option_list] [partition_option] [on_commit_option] -CREATE [GLOBAL TEMPORARY] TABLE table_name - (table_definition_list) [table_option_list] [partition_option] [AS] select; - -table_definition_list: - table_definition [, table_definition ...] - -table_definition: - column_definition - | INDEX [index_name] index_desc - | [CONSTRAINT [constraint_name]] [PRIMARY KEY|UNIQUE] (column_desc_list) [USING INDEX index_option_list] - | [CONSTRAINT [constraint_name]] FOREIGN KEY (column_name, column_name ...) references_clause constranit_state - | [CONSTRAINT [constraint_name]] CHECK(expression) constranit_state - - -column_definition_list: - column_definition [, column_definition ...] - -column_definition: - column_name data_type - [VISIBLE|INVISIBLE] - { - [DEFAULT expression] - [NULL | NOT NULL] - [CONSTRAINT [constraint_name] [PRIMARY] KEY] [UNIQUE [KEY]] - [CONSTRAINT [constraint_name] CHECK(expression) constranit_state] - [CONSTRAINT [constraint_name] references_clause - | - [GENERATED ALWAYS] AS (expression) [VIRTUAL] - [NULL | NOT NULL] [UNIQUE KEY] [[PRIMARY] KEY] [UNIQUE LOWER_KEY] [COMMENT string] - } - -references_clause: - REFERENCES table_name [ (column_name, column_name ...) ] [ON DELETE {CASCADE}]] - -constranit_state: - [RELY|NORELY] [USING INDEX index_option_list] [ENABLE|DISABLE] [VALIDATE|NOVALIDATE] - -index_desc: - (column_desc_list) [index_option_list] - -column_desc_list: - column_desc [, column_desc ...] - -column_desc: - column_name [ASC | DESC][NULL LAST|NULL FIRST] - -index_option_list: - index_option [ index_option ...] - -index_option: - [GLOBAL | LOCAL] - | block_size - | compression - | STORING(column_name_list) - | comment - -table_option_list: - table_option [ table_option ...] - -table_option: - primary_zone - | replica_num - | table_tablegroup - | block_size - | compression - | comment - | DUPLICATE_SCOPE [=] "none|zone|region|cluster" - | LOCALITY [=] "locality description" - | ENABLE ROW MOVEMENT - | DISABLE ROW MOVEMENT - | physical_attribute - | parallel_clause - -physical_attribute_list: - physical_attribute [physical_attribute] - -physical_attribute: - PCTFREE [=] num - | PCTUSED num - | INITRANS num - | MAXTRANS num - | STORAGE(storage_option [storage_option] ...) - | TABLESPACE tablespace - -parallel_clause: - {NOPARALLEL | PARALLEL integer} - -compression: - NOCOMPRESS - | COMPRESS { BASIC | FOR OLTP | FOR QUERY [LOW|HIGH] | FOR ARCHIVE [LOW|HIGH]} - -storage_option: - INITIAL_ num [K|M|G|T|P|E] - | NEXT num [K|M|G|T|P|E] - | MINEXTENTS num [K|M|G|T|P|E] - | MAXEXTENTS num [K|M|G|T|P|E] - -partition_option: - PARTITION BY HASH(column_name_list) - [subpartition_option] hash_partition_define - | PARTITION BY RANGE (column_name_list) - [subpartition_option] (range_partition_list) - | PARTITION BY LIST (column_name_list) - [subpartition_option] (list_partition_list) - -/*模板化二级分区*/ -subpartition_option: - SUBPARTITION BY HASH (column_name_list) hash_subpartition_define - | SUBPARTITION BY RANGE (column_name_list) SUBPARTITION TEMPLATE - (range_subpartition_list) - | SUBPARTITION BY LIST (column_name_list) SUBPARTITION TEMPLATE - (list_subpartition_list) - -/*非模板化二级分区*/ -subpartition_option: - SUBPARTITION BY HASH (column_name_list) - | SUBPARTITION BY RANGE (column_name_list) - | SUBPARTITION BY LIST (column_name_list) - -subpartition_list: - (hash_subpartition_list) - | (range_subpartition_list) - | (list_subpartition_list) - -hash_partition_define: - PARTITIONS partition_count [TABLESPACE tablespace] [compression] - | (hash_partition_list) - -hash_partition_list: - hash_partition [, hash_partition, ...] - -hash_partition: - partition [partition_name] [subpartition_list/*仅非模板化二级分区可定义*/] - -hash_subpartition_define: - SUBPARTITIONS subpartition_count - | SUBPARTITION TEMPLATE (hash_subpartition_list) - -hash_subpartition_list: - hash_subpartition [, hash_subpartition, ...] - -hash_subpartition: - subpartition [subpartition_name] - -range_partition_list: - range_partition [, range_partition ...] - -range_partition: - PARTITION [partition_name] - VALUES LESS THAN {(expression_list) | (MAXVALUE)} - [subpartition_list/*仅非模板化二级分区可定义*/] - [ID = num] [physical_attribute_list] [compression] - -range_subpartition_list: - range_subpartition [, range_subpartition ...] - -range_subpartition: - SUBPARTITION subpartition_name - VALUES LESS THAN {(expression_list) | MAXVALUE} [physical_attribute_list] - -list_partition_list: - list_partition [, list_partition] ... - -list_partition: - PARTITION [partition_name] - VALUES (DEFAULT|expression_list) - [subpartition_list/*仅非模板化二级分区可定义*/] - [ID num] [physical_attribute_list] [compression] - -list_subpartition_list: - list_subpartition [, list_subpartition] ... - -list_subpartition: - SUBPARTITION [partition_name] VALUES (DEFAULT|expression_list) [physical_attribute_list] - -expression_list: - expression [, expression ...] - -column_name_list: - column_name [, column_name ...] - -partition_name_list: - partition_name [, partition_name ...] - -partition_count | subpartition_count: - INT_VALUE - -on_commit_option: - ON COMMIT DELETE ROWS - | ON COMMIT PRESERVE ROWS -``` - - - -参数说明 -------------- - - - -| 参数 | 描述 | -|-----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| DUPLICATE_SCOPE | 用来指定复制表属性,取值如下: * none:表示该表是一个普通表 * zone:表示该表是一个复制表,leader 需要将事务复制到本 zone 的所有 F 副本及 R 副本 * region:表示该表是一个复制表,leader 需要将事务复制到本 region 的所有 F 副本及 R 副本 * cluster:表示该表是一个复制表,leader 需要将事务复掉到 cluster 的所有 F 副本及 R 副本 不指定 DUPLICATE_SCOPE 的情况下,默认值为 none。 | -| BLOCK_SIZE | 指定表的微块大小 | -| COMPRESSION | 指定存储格式 flat/encoding 以及压缩方法,对应如下: * nocompress:flat 格式, none 压缩 * compress \[basic\]:flat 格式, lz4_1.0 压缩 * compress for oltp:flat 格式, zstd_1.0 压缩 * query \[low\|high\]:encoding 格式, lz4_1.0 压缩 * archive \[low\|high\]:encoding 格式, zstd_1.0 压缩 | -| primary_zone | 指定主 Zone(副本 Leader 所在 Zone)。 | -| replica_num | 指定副本数。 | -| table_tablegroup | 指定表所属的 talegroup。 | -| comment | 注释。 | -| LOCALITY | 描述副本在 Zone 间的分布情况,如:F@z1,F@z2,F@z3,R@z4 表示 z1, z2, z3 为全功能副本,z4 为只读副本。 | -| physical_attribute | PCTFREE: 指定宏块保留空间百分比 其它属性:STORAGE, TABLESPACE 等仅为了语法兼容方便迁移,不生效 | -| ENABLE/DISABLE ROW MOVEMENT | 是否允许更会致行在不同分区间移动的分区键更新 | -| ON COMMIT DELETE ROWS | 事务级临时表:提交时删除数据 | -| ON COMMIT PRESERVE ROWS | 会话级临时表:会话结束时删除数据 | -| parallel_clause | 指定表级别的并行度: * NOPARALLEL:并行度为1,默认配置 * PARALLEL integer:指定并行度,integer 取值大于等于 1。 **注意** 当指定并行度时,优先级关系如下:通过 hint 指定的并行度 \> 通过 `ALTER SESSION` 指定的并行度 \> 表级别的并行度 | - - - -示例 ------------ - -* 创建数据库表。 - - - - - - -```javascript -CREATE TABLE test (c1 INT PRIMARY KEY, c2 VARCHAR(50)) REPLICA_NUM = 3, PRIMARY_ZONE = 'zone1'; -``` - - - -* 创建一个复制表。 - - - - - - -```javascript -CREATE TABLE item (i_id INT -, i_name VARCHAR(24) -, i_price DECIMAL(5,2) -, i_data VARCHAR(50) -, i_im_id INT -, PRIMARY KEY(i_id)) COMPRESS FOR QUERY pctfree=0 BLOCK_SIZE=16384 -DUPLICATE_SCOPE='cluster' LOCALITY='F@zone1, F@zone2,R{all_server}@zone3' primary_zone='zone1'; -``` - - - -* 创建带索引的表。 - - - - - - -```javascript -create table t1 (c1 int primary key, c2 int, c3 int, index i1 (c2)); -``` - - - -* 创建 hash 分区,分区数为 8 的表。 - - - - - - -```javascript -create table t1 (c1 int primary key, c2 int) partition by hash(c1) partitions 8; -``` - - - -* 创建一级分区为 range 分区,二级分区为 hash 分区的表。 - - - - - - -```javascript -create table t1 (c1 int, c2 int, c3 int) -partition by range(c1) subpartition by hash(c2) subpartitions 5 -(partition p0 values less than(0), partition p1 values less than(100)); -``` - - - -* 开启 encoding 并使用 zstd 压缩,宏块保留空间为 5%。 - - - - - - -```javascript -create table t1 (c1 int, c2 int, c3 varchar(64)) -COMPRESS FOR ARCHIVE -PCTFREE 5; -``` - - - -* 创建一个事务级临时表。 - - - - - - -```javascript -create global temporary table t1 (c1 int) on commit delete rows ; -``` - - - -* 创建一个带约束的表。 - - - - - - -```javascript -create table t1 (c1 int, c2 int, c3 int, CONSTRAINT equal_check CHECK(c2 = c3 * 2) ENABLE VALIDATE); -``` - - - -* 创建非模板化的二级分区表。 - - - - - - -```unknow -create table t_range_range1 (c1 int, c2 int, c3 int) partition by range(c1) -subpartition by range (c2) -( - partition p0 values less than (100) - ( - subpartition p0_r1 values less than (100), - subpartition p0_r2 values less than (200), - subpartition p0_r3 values less than (300) - ), - partition p1 values less than (200) - ( - subpartition p1_r1 values less than (100), - subpartition p1_r2 values less than (200), - subpartition p1_r3 values less than (300) - ), - partition p2 values less than (300) - ( - subpartition p2_r1 values less than (100), - subpartition p2_r2 values less than (200), - subpartition p2_r3 values less than (300) - ) -); -``` - - - -* 创建表 t1 的并行度为 3。 - - - - - - -```unknow -CREATE TABLE t1(c1 int primary key, c2 int) PARALLEL 3; -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/15.create-tablegroup-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/15.create-tablegroup-1.md deleted file mode 100644 index c777b99e6..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/15.create-tablegroup-1.md +++ /dev/null @@ -1,99 +0,0 @@ -CREATE TABLEGROUP -====================================== - - - -描述 ------------ - -该语句用来创建表组。 -**说明** - - - -只有租户下的管理员权限才可以创建表组。 - -格式 ------------ - -```javascript -CREATE TABLEGROUP [IF NOT EXISTS] tablegroupname [opt_tablegroup_option_list] [opt_tg_partition_option] - -opt_tablegroup_option_list: -tablegroup_option [tablegroup_option] - -tablegroup_option: -LOCALITY [=] locality_name -| PRIMARY_ZONE [=] primary_zone_name - -opt_tg_partition_option: -PARTITION BY - HASH COLUMN_NUM [tg_subpartition_option] PARTITIONS INTNUM -| RANGE COLUMNS COLUMN_NUM [tg_subpartition_option] {PARTITION partition_name VALUES LESS THAN range_partition_expr, ...} -| LIST COLUMNS COLUMN_NUM [tg_subpartition_option] {PARTITION partition_name VALUES in list_partition_expr, ...} - -tg_subpartition_option: -SUBPARTITION BY -RANGE COLUMN_NUM SUBPARTITION TEMPLATE {SUBPARTITION partition_name VALUES LESS THAN range_partition_expr, ...} -| HASH COLUMN_NUM [SUBPARTITIONS INTNUM] -| LIST COLUMN_NUM SUBPARTITION TEMPLATE {SUBPARTITION partition_name VALUES in list_partition_expr, ...} -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|----------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| tablegroupname | 表组名称,最长 64 个字符,字符只能有大小写英文字母,数字和下划线,而且必须以字母或下划线开头,并且不能使用 OceanBase 的关键字。 如果要创建的表组名称已存在,并且没有指定 IF NOT EXISTS,则会出现错误。 | -| opt_tablegroup_option_list | 表组的分区方式、locality、primary zone 必须和组内的表完全一致。 组内的表信息不能独立变更某一项,只可以通过操作表组进行批量操作。 相同的 locality:副本类型、个数、位置要完全一致 相同的 primary zone:leader 位置及其优先级要完全一致 相同的分区方式: * 分区类型相同(例如,都是 hash+range 分区)。 * 如果是 hash 分区,要求引用的列数相同,且分区个数相同。 * 如果是 range 分区,要求引用的列数相同,且分区数相同,且 range 分割点相同。 * 对于二级分区,根据分区类型,要求和上述一致 | -| opt_tg_partition_option | 表组的分区规则定义,与 CREATE TABLE 使用同样的分区方式。 表组没有具体的列定义,所以 HASH、RANGE、LIST 不需要写出具体的列,只需要指定列个数(COLUMN_NUM)。 | - - - -示例 ------------ - -* 创建名为 myTableGroup1 的表组。 - - - - - - -```javascript -OceanBase(admin@test)> CREATE TABLEGROUP myTableGroup1; -Query OK, 0 rows affected (0.07 sec) - -OceanBase(admin@test)> create table myt1 (c1 int, c2 int ) tablegroup = myTableGroup1; -Query OK, 0 rows affected (0.28 sec) - -OceanBase(admin@test)> create table myt2 (c1 int, c2 int ) tablegroup = myTableGroup1; -Query OK, 0 rows affected (0.26 sec) -``` - - - -* 创建 hash 分区的表组 tgh,同时创建 hash 分区的表 ttgh,且分区个数相同。 - - - - - - -```javascript -OceanBase(admin@test)> create tablegroup tgh locality='F,R{ALL_SERVER}@z1' partition by hash partitions 10; -Query OK, 0 rows affected (0.09 sec) - -OceanBase(admin@test)> create table ttgh(c1 int, c2 int) locality='F,R{ALL_SERVER}@z1' partition by hash(c1) partitions 10; -Query OK, 0 rows affected (0.55 sec) - -OceanBase(admin@test)> create table ttgh2(c1 int, c2 int) locality='F,R{ALL_SERVER}@z1' partition by hash(c2) partitions 10; -Query OK, 0 rows affected (0.39 sec) -``` - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/16.create-tablespace.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/16.create-tablespace.md deleted file mode 100644 index d37fef8ac..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/16.create-tablespace.md +++ /dev/null @@ -1,49 +0,0 @@ -CREATE TABLESPACE -====================================== - - - -描述 ------------ - -该语句用来创建 TableSpace 逻辑对象,TableSpace 属性支持加密。 - -格式 ------------ - -```javascript -CREATE TABLESPACE tablespace_name [ENCRYPTION USING 'AES-256|AES-128|AES-192|SM4'] -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|--------------------------------|------------------------| -| tablespace_name | 指定要创建的 TableSpace 对象名称 | -| ENCRYPTION USING | 使用加密的关键字 | -| AES-256\|AES-128\|AES-192\|SM4 | 分别代表不同的加密算法 | - - - -示例 ------------ - -* 创建 TableSpace 对象。 - - - - - - -```javascript -CREATE TABLESPACE ob_tablespace; - -CREATE TABLESPACE ob_tablespace ENCRYPTION USING 'AES-256'; -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/17.create-user-2.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/17.create-user-2.md deleted file mode 100644 index 64d8f8b06..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/17.create-user-2.md +++ /dev/null @@ -1,103 +0,0 @@ -CREATE USER -================================ - - - -描述 ------------ - -该语句用于创建新的 OceanBase 用户。创建新用户后,可以使用该用户连接 OceanBase。 -**说明** - - - -必须拥有 CREATE USER 的系统权限,才可以使用 CREATE USER 命令。 - -格式 ------------ - -```javascript -create_user_stmt: - CREATE USER user_name [host_name] IDENTIFIED BY password [REQUIRE {NONE | SSL | X509 | tls_option_list}] - [PROFILE user_profile] [DEFAULT TABLESPACE table_space] [PRIMARY_ZONE 'zone_name'] - -password: - STR_VALUE - -tls_option_list: - tls_option - | tls_option_list, tls_option - -tls_option: - CIPHER STR_VALUE - | ISSUER STR_VALUE - | SUBJECT STR_VALUE -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|--------------------------------|------------------------------------------------------| -| user_name | 用户名,新建用户后,"dba_users"表会新增一行该用户的表项。如果同名用户已经存在,则报错。 | -| host_name | 用户所在的主机名,为 @xxx.xxx.xx.x格式。 | -| IDENTIFIED BY | 必须使用 IDENTIFIED BY 子句,可以为账户指定一个密码。 | -| REQUIRE | 指定用户使用的加密协议为 NONE, SSL, X509 和 tls_option_list 中的一种。 | -| PROFILE user_profile | 指定用户使用的 Profile。 | -| DEFAULT TABLESPACE table_space | 指定用户的默认表空间。 | -| PRIMARY_ZONE | 指定用户的 Primary Zone。 | - - - -示例 ------------ - -1. 执行以下命令创建名为 sqluser 的用户,密码为 123456。 - - ```javascript - CREATE USER sqluser IDENTIFIED BY 123456; - ``` - - - - - - - - -2. 执行以下命令查看创建的用户。 - - ```javascript - SELECT username FROM dba_users; - ``` - - - - 执行结果如下所示。 - - ```javascript - OceanBase(TEST@TEST)>CREATE USER sqluser IDENTIFIED BY 123456; - Query OK, 0 rows affected (0.05 sec) - OceanBase(TEST@TEST)>SELECT username FROM dba_users; - +------------+ - | USERNAME | - +------------+ - | SYS | - | LBACSYS | - | ORAAUDITOR | - | ROOT | - | TEST | - | ADMIN | - | SQLUSER | - +------------+ - 7 rows in set (0.01 sec) - ``` - - - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/18.create-view-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/18.create-view-1.md deleted file mode 100644 index 3ed0bfd3b..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/18.create-view-1.md +++ /dev/null @@ -1,59 +0,0 @@ -CREATE VIEW -================================ - - - -描述 ------------ - -该语句用于创建视图语句,如果指定了 OR REPLACE 子句,该语句能够替换已有的视图。 - -视图在数据库中实际上并不是以表的形式存在,每次使用时他们就会派生。视图是通过 CREATE VIEW 语句中指定的 SELECT 语句的结果生成的。 - -支持可更新视图。 - -格式 ------------ - -```javascript -create_view_stmt: - CREATE [OR REPLACE] VIEW view_name [(column_name_list)] AS select_stmt; - -column_name_list: - column_name [, column_name ...] -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| OR REPLACE | 表示如果要创建的视图名称已存在,则使用新的定义重新创建视图。 | -| view_name | 视图名。 | -| select_stmt | 是一种 SELECT 语句。它给出了视图的定义。该语句可以从基表或其他视图进行选择。 | -| column_name_list | 视图必须具有唯一的列名,不得有重复,就像基表那样。默认情况下,由 SELECT 语句检索的列名将用作视图列名。 要想为视图列定义明确的名称,可使用可选的 column_name_list 子句,列出由逗号隔开的 ID。column_name_list 中的名称数目必须等于SELECT语句检索的列数。 SELECT 语句检索的列可以是对表列的简单引用。也可以是使用函数、常量值、操作符等的表达式。 | - - - -示例 ------------ - -* 选择表 t 中的 c1、c2 列来创建视图 v。 - - - - - - -```javascript -create or replace view v(vc1, vc2) as select c1, c2 from t; -``` - - - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/19.drop-index-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/19.drop-index-1.md deleted file mode 100644 index 0d33f803a..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/19.drop-index-1.md +++ /dev/null @@ -1,49 +0,0 @@ -DROP INDEX -=============================== - - - -描述 ------------ - -该语句用来删除索引。当索引过多时,维护开销增大,因此,需要删除不必要的索引。 - -删除索引的时候需要等待一段时间才能完全删除。 - -格式 ------------ - -```javascript -DROP INDEX [schema.]indexname; -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|-----------|--------------| -| schema | 指定 schema 名称 | -| indexname | 指定索引名称 | - - - -示例 ------------ - -* 删除索引 test_index。 - - - - - - -```javascript -DROP INDEX test_index; -``` - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/2.alter-outline-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/2.alter-outline-1.md deleted file mode 100644 index 68b3b1d8e..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/2.alter-outline-1.md +++ /dev/null @@ -1,86 +0,0 @@ -ALTER OUTLINE -================================== - - - -描述 ------------ - -该语句仅支持使用 SQL_TEXT 创建的 Outline,可用于添加绑定 Outline 和限流规则。 - -格式 ------------ - -```javascript -ALTER OUTLINE outline_name ADD stmt [ TO target_stmt ] -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| outline_name | 指定要创建的 Outline 名称。 | -| stmt | 一般为一个带有 Hint 和原始参数的 DML 语句。 | -| TO target_stmt | 如果不指定 `TO target_stmt`,则表示如果数据库接受的 SQL 参数化后与 `stmt` 去掉 Hint 参数化文本相同,则将该 SQL 绑定 `stmt` 中 Hint 生成执行计划;如果期望对含有 Hint 的语句进行固定计划,则需要 `TO target_stmt` 来指明原始的 SQL。 **注意** 在使用 `target_stmt` 时,严格要求 `stmt` 与`target_stmt` 在去掉 Hint 后完全匹配。 | - - - -示例 ------------ - -* 通过 ALTER OUTLINE 来添加限流规则。 - - - - - - -```javascript -obclient>CREATE OUTLINE ol_1 ON SELECT /*+max_concurrent(1)*/ * FROM t1 WHERE c1 =1 - AND c2 = 1; -obclient>ALTER OUTLINE ol_1 ADD SELECT /*+max_concurrent(1)*/ * FROM t1 WHERE c1 =1 - AND c2 = ?; -obclient>ALTER OUTLINE ol_1 ADD SELECT /*+max_concurrent(1)*/ * FROM t1 WHERE c1 =? - AND c2 = 1; -``` - - - -* 通过 ALTER OUTLINE 来添加执行计划。 - - - - - - -```javascript -obclient>CREATE OUTLINE ol_2 ON SELECT /*+max_concurrent(1)*/ * FROM t1,t2 - WHERE t1.c1 = 1; -obclient>ALTER OUTLINE ol_2 ADD SELECT /*+use_nl(t2)*/ * FROM t1,t2 - WHERE t1.c1 = 1; -``` - - - -注意事项 -------------- - -* 同一个 `outline_name` 只能指定一个执行计划。如果通过 `CREATE OUTLINE` 语句指定了执行计划,则无法通过执行 `ALTER OUTLINE` 时再添加。 - - - -* 同 `CREATE OUTLINE` 类似,在 `ALTER OUTLINE` 时不能同时指定限流规则和执行计划。 - - - -* 执行 `ALTER OUTLINE` 时,需要` outline_name` 和 `signature` 同时匹配。 - - - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/20.drop-outline-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/20.drop-outline-1.md deleted file mode 100644 index a98a1de41..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/20.drop-outline-1.md +++ /dev/null @@ -1,46 +0,0 @@ -DROP OUTLINE -================================= - - - -描述 ------------ - -该语句用于删除 OceanBase 数据库中的 OUTLINE。 - -格式 ------------ - -```javascript -DROP OUTLINE outline_name; -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|--------------|--------------------| -| outline_name | 指定要删除的 OUTLINE 名称。 | - - - -示例 ------------ - -* 删除 OUTLINE ol_1 - - - - - - -```javascript -DROP OUTLINE ol_1; -``` - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/21.drop-restore-point-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/21.drop-restore-point-1.md deleted file mode 100644 index 97f558a61..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/21.drop-restore-point-1.md +++ /dev/null @@ -1,45 +0,0 @@ -DROP RESTORE POINT -======================================= - - - -描述 ------------------------ - -该语句用来删除还原点(Restore Point)。 - -格式 ------------------------ - -```unknow -DROP RESTORE POINT restore_point; -``` - - - -参数解释 -------------------------- - - - -| 参数 | 描述 | -|---------------|----------| -| restore_point | 指定还原点名称。 | - - - -示例 ------------------------ - -* 删除一个还原点 rp1。 - - ```unknow - obclient> DROP RESTORE POINT rp1; - Query OK, 0 rows affected (0.01 sec) - ``` - - - - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/22.drop-sequence.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/22.drop-sequence.md deleted file mode 100644 index 0ccb792a3..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/22.drop-sequence.md +++ /dev/null @@ -1,47 +0,0 @@ -DROP SEQUENCE -================================== - - - -描述 ------------ - -该语句用来删除自增列。 - -格式 ------------ - -```javascript -DROP SEQUENCE sequence_name -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|---------------|-------------| -| sequence_name | 指定要删除的自增列名称 | - - - -示例 ------------ - -* 删除自增列 S1 - - - - - - -```javascript -OceanBase(TEST@TEST)>drop sequence S1; -Query OK, 0 rows affected (0.16 sec) -``` - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/23.drop-synonym-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/23.drop-synonym-1.md deleted file mode 100644 index ae46f088a..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/23.drop-synonym-1.md +++ /dev/null @@ -1,88 +0,0 @@ -DROP SYNONYM -================================= - - - -描述 ------------ - -该语句用来删除一个同义词。 - -格式 ------------ - -```javascript -DROP [PUBLIC] SYNONYM [ schema. ]synonym; -``` - - - -参数说明 -------------- - - - -| 参数 | 描述 | -|----------------------|----------------------------------------------------------------------------| -| PUBLIC | 指定 PUBLIC 来删除公共同义词;如果不指定 PUBLIC,则删除私有同义词。 | -| \[ schema. \]synonym | schema 指定当前同义词属于哪个 schema,如果指定了 PUBLIC,则对同义词不需要指定 schema;synonym 表示同义词的名称。 | - - - -举例 ------------ - -* 删除一个同义词。 - - - - - - -```javascript -OceanBase(TEST@TEST)>drop synonym test.s1; -Query OK, 0 rows affected (0.04 sec) -``` - - - -* 删除一个 PUBLIC 同义词。 - - - - - - -```javascript -OceanBase(TEST@TEST)>drop public synonym syn_pub; -Query OK, 0 rows affected (0.03 sec) -``` - - - -注意事项 -------------- - -1. 删除同义词时,需要满足如下权限: - - - - - - - - - - - - - - - - -2. 删除 public synonym 时,必须指定 PUBLIC 关键字,且不能指定 schema。 - - - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/24.drop-table-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/24.drop-table-1.md deleted file mode 100644 index f9f9f9da8..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/24.drop-table-1.md +++ /dev/null @@ -1,48 +0,0 @@ -DROP TABLE -=============================== - - - -描述 ------------ - -该语句用于删除 OceanBase 数据库中的表。 - -格式 ------------ - -```javascript -DROP TABLE table_name [CASCADE CONSTRAINTS] [PURGE] -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|---------------------|------------------------| -| table_name | 指定要删除的表名 | -| CASCADE CONSTRAINTS | 级联删除跟 table_name 关联的约束 | -| PURGE | 彻底删除表 (不进回收站) | - - - -示例 ------------ - -* 删除表 test - - - - - - -```javascript -DROP TABLE test; -``` - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/25.drop-tablegroup-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/25.drop-tablegroup-1.md deleted file mode 100644 index 0c2ff80ff..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/25.drop-tablegroup-1.md +++ /dev/null @@ -1,46 +0,0 @@ -DROP TABLEGROUP -==================================== - - - -描述 ------------ - -该语句用来删除表组。 - -格式 ------------ - -```javascript -DROP TABLEGROUP [IF EXISTS] tablegroupname -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|----------------|---------------------------------------------| -| tablegroupname | 表组名称。如果要删除的表组名称不存在,并且没有指定 IF EXISTS,则会出现错误。 | - - - -示例 ------------ - -* 删除名为 myTableGroup1 的表组。 - - - - - - -```javascript -OceanBase(admin@test)> DROP TABLEGROUP myTableGroup1; -``` - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/26.drop-tablespace.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/26.drop-tablespace.md deleted file mode 100644 index e67926d51..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/26.drop-tablespace.md +++ /dev/null @@ -1,45 +0,0 @@ -DROP TABLESPACE -==================================== - - - -描述 ------------ - -该语句用来删除 TableSpace 逻辑对象,仅在 TableSpace下没有表时可以删除成功。 - -格式 ------------ - -```javascript -DROP TABLESPACE tablespace_name; -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|-----------------|----------------------| -| tablespace_name | 指定要删除的 TableSpace 名称 | - - - -示例 ------------ - -* 删除 TableSpace 对象 ts - - - - - - -```javascript -OceanBase(root@oceanbase)>drop tablesapce ts; -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/27.drop-user-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/27.drop-user-1.md deleted file mode 100644 index e3cb81156..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/27.drop-user-1.md +++ /dev/null @@ -1,61 +0,0 @@ -DROP USER -============================== - - - -描述 ------------ - -该语句用于删除一个 OceanBase 用户。 -**说明** - - - -* 必须拥有 CREATE USER 的系统权限,才可以使用 DROP USER 命令。 - - - -* CASCADE 会指定在删除用户前,删除该用户拥有的所有 Object,包括权限,数据库,表等。 - - - - - - -格式 ------------ - -```javascript -DROP USER username CASCADE; -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|----------|----------------| -| username | 用户名,只支持删除单个用户。 | - - - -示例 ------------ - -* 执行以下命令,删除名为 sqluser 的用户。 - - - - - - -```javascript -oceanBase(admin@TEST)>DROP USER sqluser CASCADE; -Query OK, 0 rows affected (0.06 sec) -``` - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/28.drop-view-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/28.drop-view-1.md deleted file mode 100644 index 03a23e818..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/28.drop-view-1.md +++ /dev/null @@ -1,53 +0,0 @@ -DROP VIEW -============================== - - - -描述 ------------ - -该语句用于删除一个或多个视图。 -**说明** - - - -当前用户必须在每个视图上有 DROP 权限。 - -格式 ------------ - -```javascript -drop_view_stmt: -DROP VIEW view_name [CASCADE | RESTRICT]; -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|---------------------|-----------------------------| -| view_name | 删除的视图名 | -| CASCADE \| RESTRICT | CASCADE 和 RESTRICT 会被解析和忽略。 | - - - -示例 ------------ - -* 删除视图 v1 - - - - - - -```javascript -OceanBase(root@oceanbase)>drop view v1; -``` - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/29.RENAME.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/29.RENAME.md deleted file mode 100644 index 7ef4319ae..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/29.RENAME.md +++ /dev/null @@ -1,64 +0,0 @@ -RENAME -=========================== - - - -描述 ------------ - -该语句用来对对象进行重命名。 - -格式 ------------ - -```javascript -RENAME obj_name TO new_obj_name; -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|--------------|-------| -| obj_name | 原对象名。 | -| new_obj_name | 新对象名。 | - - - -示例 ------------ - -1. 创建表 t1 和 t2。 - - - - - - -```javascript -create table t1(c1 int); -``` - - - -2. 将表 t1 重命名为 t11。 - - - - - - -```javascript -rename t1 to t11; -``` - - - -注意事项 -------------- - -重命名操作可以对表、视图、私有同义词、sequence 进行。 diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/3.alter-sequence.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/3.alter-sequence.md deleted file mode 100644 index 505a4a292..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/3.alter-sequence.md +++ /dev/null @@ -1,72 +0,0 @@ -ALTER SEQUENCE -=================================== - - - -描述 ------------ - -该语句用来修改自增列。 - -格式 ------------ - -```javascript -ALTER SEQUENCE sequence_name -[MINVALUE value | NOMINVALUE] -[MAXVALUE value | NOMAXVALUE] -[INCREMENT BY value] -[CACHE value | NOCACHE] -[ORDER | NOORDER] -[CYCLE | NOCYCLE]; -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------| -| MINVALUE value \| NOMINVALUE | 指定自增列的最小值,取值范围是 -10^27^ \~ (10^27^-1)。 如果指定为 NOMINVALUE,则升序时最小值为 1,降序时最小值为 -(10^27^-1)。 不指定时缺省为 NOMINVALUE。 | -| MAXVALUE value \| NOMAXVALUE | 指定自增列的最大值,取值范围是 (-10^27^+1) \~ 10^27^。 如果指定为 NOMAXVALUE,则升序时最大值为(10^28^-1),降序时最大值为 -1。 不指定时缺省为 NOMAXVALUE。 | -| START WITH value | 指定自增列的起始值。该值必须小于等于 MAXVALUE,且大于等于 MINVALUE。 如果不指定,则升序时默认取值为最小值,降序时默认取值为最大值。 | -| INCREMENT BY value | 指定自增列的自增步数。该值不可以为 0。 如果指定为正数,则自增列为升序;如果指定为负数,则自增列为降序。 不指定缺省值为 1。 | -| CACHE value \| NOCACHE | 指定在内存中预分配的自增值个数,默认为20。 | -| ORDER \| NOORDER | 指定自增列的值是否按顺序生成,默认为 NOORDER。 | -| CYCLE \| NOCYCLE | 指定自增列的值是否循环生成,默认为 NOCYCLE。 | - - - -示例 ------------ - -* 修改自增列 my_sequence 的最大值,并指定自增值循环生成。 - - - - - - -```javascript -OceanBase(root@oceanbase)>ALTER SEQUENCE my_sequence MAXVALUE 1024 CYCLE; -``` - - - -注意事项 -------------- - -* `ALTER SEQUENCE` 不支持修改 START WITH 值。如果希望修改下一个 SEQUENCE 的起始位置,可以通过修改 `INCREMENT BY` - - 实现。 - - -* 其他自增列取值注意事项可参考 [CREATE SEQUENCE](../../../11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/12.create-sequence.md) 语句。 - - - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/30.truncate-table-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/30.truncate-table-1.md deleted file mode 100644 index e9094c78a..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/30.truncate-table-1.md +++ /dev/null @@ -1,59 +0,0 @@ -TRUNCATE TABLE -=================================== - - - -描述 ------------ - -该语句用于完全清空指定表,但是保留表结构,包括表中定义的 Partition 信息。从逻辑上说,该语句与用于删除所有行的DELETE FROM语句相同。执行TRUNCATE语句,必须具有表的删除和创建权限。 - -TRUNCATE TABLE 语句与 DELETE FROM 语句有以下不同: - -* 删减操作会取消并重新创建表,这比一行一行的删除行要快很多。 - - - -* TRUNCATE TABLE 语句执行结果显示影响行数始终显示为 0 行。 - - - - - - -格式 ------------ - -```javascript -TRUNCATE [TABLE] table_name; -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|------------|-------| -| table_name | 指定表名。 | - - - -示例 ------------ - -* 完全清空表 tb1。 - - - - - - -```javascript -OceanBase(root@oceanbase)>TRUNCATE TABLE tb1; -``` - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/4.alter-session.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/4.alter-session.md deleted file mode 100644 index 2a68341dc..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/4.alter-session.md +++ /dev/null @@ -1,94 +0,0 @@ -ALTER SESSION -================================== - - - -描述 ------------ - -该语句用来修改 SESSION 状态。 - -ALTER SESSION 下面对应了多种功能的语句,目前支持四种: - -* 切换当前 SESSION 连接的数据库 - - - -* 修改当前 SESSION 的隔离级别 - - - -* 设置 SESSION 变量,支持同一个语句设置多个变量 - - - -* 设置 QUERY 或 DML 的并行执行能力 - - - - - - -格式 ------------ - -```javascript -ALTER SESSION SET CURRENT_SCHEMA = current_schema; -ALTER SESSION SET ISOLATION_LEVEL = [READ UNCOMMITTED|READ COMMITTED|REPEATABLE READ|SERIALIZABLE]; -ALTER SESSION SET var1_name = var1_value var2_name = var2_value ...; -ALTER SESSION { ENABLE | DISABLE | FORCE } PARALLEL { DML | QUERY } [ PARALLEL integer ]; -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|---------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| CURRENT_SCHEMA | 指定 SESSION 连接要切换到的数据库名称。 | -| ISOLATION_LEVEL | 指定 SESSION 的隔离级别。 | -| var1_name = var1_value var2_name = var2_value ... | 指定要设置的 SESSION 变量名称和取值。设置多个变量时,变量之间没有逗号分隔。 | -| { ENABLE \| DISABLE \| FORCE } PARALLEL | 设置 QUERY 或 DML 的并行执行能力: * ENABLE:默认情况下 SESSION 上并行度的值根据Table DOP的值进行决定 * DISABLE:默认情况下 SESSION 上的并行度的值为 1 * FORCE:指定 QUERY 或 DML 的并行度的值,此时参数 `PARALLEL integer` 必须指定。 **注意** 当指定并行度时,优先级关系如下:通过 hint 指定的并行度 \> 通过 `ALTER SESSION` 指定的并行度 \> 表级别的并行度 | - - - -示例 ------------ - -* 修改 SESSION 的变量值 recyclebin、sql_warnings 和 tx_isolation。 - - - - - - -```javascript -obclient>alter session set recyclebin = 'on' sql_warnings = 'on' tx_isolation = 'read-committed'; -Query OK, 0 rows affected (0.01 sec) -``` - - - -* 设置 SESSION 上 QUERY 和 DML 的并行执行。 - - - - - - -```unknow -alter session force parallel query parallel 3; -select * from t1; # 以并发度为 3 并行执行 -alter session force parallel query parallel 1; -select * from t1; # 串行执行 - -alter session force parallel dml parallel 3; -insert into t3 select * from t1; # 开启 PDML 路径,以并发度为 3 并行执行 -alter session force parallel dml parallel 1; -insert into t3 select * from t1; # 串行执行 -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/5.alter-table-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/5.alter-table-1.md deleted file mode 100644 index 9da888a36..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/5.alter-table-1.md +++ /dev/null @@ -1,414 +0,0 @@ -ALTER TABLE -================================ - - - -描述 ------------ - -该语句用来修改已存在的表的结构,比如:修改表及表属性、新增列、修改列及属性、删除列等。 - -格式 ------------ - -```javascript -alter_table_stmt: - ALTER TABLE table_name - alter_table_action_list; - | RENAME TABLE rename_table_action_list; - -alter_table_action_list: - alter_table_action [, alter_table_action ...] - -alter_table_action: - ADD [COLUMN] {column_definition | (column_definition_list)} - | MODIFY [COLUMN] column_definition - | MODIFY CONSTRAINT constraint_name { ENABLE | DISABLE } - | DROP [COLUMN] column_name - | ADD [CONSTRAINT [constraint_name]] UNIQUE {INDEX | KEY} [index_name] index_desc - | ADD [CONSTRAINT [constraint_name]] FOREIGN KEY (column_name_list) references_clause - | ADD [CONSTRAINT [constraint_name]] CHECK (expr) - | ADD {INDEX | KEY} [index_name] index_desc - | ADD FULLTEXT [INDEX | KEY] [index_name] fulltext_index_desc - | ALTER INDEX index_name [VISIBLE | INVISIBLE] - | DROP {INDEX | KEY} index_name - | ADD PARTITION (range_partition_list) - | DROP PARTITION (partition_name_list) - | REORGANIZE PARTITION name_list INTO partition_range_or_list - | TRUNCATE PARTITION name_list - | [SET] table_option_list - | RENAME [TO] table_name - | DROP TABLEGROUP - | DROP CONSTRAINT constraint_name - | {ENABLE | DISABLE} CONSTRAINT constraint_name - -rename_table_action_list: - rename_table_action [, rename_table_action ...] - -rename_table_action: - table_name TO table_name - -column_definition_list: - column_definition [, column_definition ...] - -column_definition: - column_name data_type - [DEFAULT const_value] [AUTO_INCREMENT] - [NULL | NOT NULL] [[PRIMARY] KEY] [UNIQUE [KEY]] comment - -index_desc: - (column_desc_list) [index_type] [index_option_list] - -fulltext_index_desc: - (column_desc_list) CTXCAT(column_desc_list) [index_option_list] - -column_desc_list: - column_desc [, column_desc ...] - -column_desc: - column_name [(length)] [ASC | DESC] - -references_clause: - REFERENCES table_name [ (column_name, column_name ...) ] [ON DELETE {CASCADE}]] - -index_type: - USING BTREE - -index_option_list: - index_option [ index_option ...] - -index_option: - [GLOBAL | LOCAL] - | block_size - | compression - | STORING(column_name_list) - | comment - -table_option_list: - table_option [ table_option ...] - -table_option: - | primary_zone - | replica_num - | table_tablegroup - | block_size - | compression - | AUTO_INCREMENT [=] INT_VALUE - | comment - | DUPLICATE_SCOPE [=] "none|zone|region|cluster" - | parallel_clause - -parallel_clause: - {NOPARALLEL | PARALLEL integer} - -partition_option: - PARTITION BY HASH(column_name_list) - [subpartition_option] hash_partition_define - | PARTITION BY RANGE (column_name_list) - [subpartition_option] (range_partition_list) - | PARTITION BY LIST (column_name_list) - [subpartition_option] (list_partition_list) - -/*模板化二级分区*/ -subpartition_option: - SUBPARTITION BY HASH (column_name_list) hash_subpartition_define - | SUBPARTITION BY RANGE (column_name_list) SUBPARTITION TEMPLATE - (range_subpartition_list) - | SUBPARTITION BY LIST (column_name_list) SUBPARTITION TEMPLATE - (list_subpartition_list) - -/*非模板化二级分区*/ -subpartition_option: - SUBPARTITION BY HASH (column_name_list) - | SUBPARTITION BY RANGE (column_name_list) - | SUBPARTITION BY LIST (column_name_list) - -subpartition_list: - (hash_subpartition_list) - | (range_subpartition_list) - | (list_subpartition_list) - -hash_partition_define: - PARTITIONS partition_count [TABLESPACE tablespace] [compression] - | (hash_partition_list) - -hash_partition_list: - hash_partition [, hash_partition, ...] - -hash_partition: - partition [partition_name] [subpartition_list/*仅非模板化二级分区可定义*/] - -hash_subpartition_define: - SUBPARTITIONS subpartition_count - | SUBPARTITION TEMPLATE (hash_subpartition_list) - -hash_subpartition_list: - hash_subpartition [, hash_subpartition, ...] - -hash_subpartition: - subpartition [subpartition_name] - -range_partition_list: - range_partition [, range_partition ...] - -range_partition: - PARTITION [partition_name] - VALUES LESS THAN {(expression_list) | (MAXVALUE)} - [subpartition_list/*仅非模板化二级分区可定义*/] - [ID = num] [physical_attribute_list] [compression] - -range_subpartition_list: - range_subpartition [, range_subpartition ...] - -range_subpartition: - SUBPARTITION subpartition_name - VALUES LESS THAN {(expression_list) | MAXVALUE} [physical_attribute_list] - -list_partition_list: - list_partition [, list_partition] ... - -list_partition: - PARTITION [partition_name] - VALUES (DEFAULT|expression_list) - [subpartition_list/*仅非模板化二级分区可定义*/] - [ID num] [physical_attribute_list] [compression] - -list_subpartition_list: - list_subpartition [, list_subpartition] ... - -list_subpartition: - SUBPARTITION [partition_name] VALUES (DEFAULT|expression_list) [physical_attribute_list] - -expression_list: - expression [, expression ...] - -column_name_list: - column_name [, column_name ...] - -partition_name_list: - partition_name [, partition_name ...] - -partition_count | subpartition_count: - INT_VALUE -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| ADD \[COLUMN\] | 增加列,目前不支持增加主键列。 | -| MODIFY \[COLUMN\] | 修改列属性。 | -| MODIFY CONSTRAINT | 修改约束的状态为开启或关闭,只支持外键约束和 CHECK 约束。 | -| DROP \[COLUMN\] | 删除列,不允许删除主键列或者包含索引的列。 | -| ADD \[UNIQUE INDEX\] | 增加唯一索引。 | -| ADD \[INDEX\] | 增加普通索引 | -| ALTER \[INDEX\] | 修改索引属性。 | -| ADD \[PARTITION\] | 增加分区。 | -| DROP \[PARTITION\] | 删除分区。 | -| REORGANIZE \[PARTITION\] | 分区重组。 | -| TRUNCATE \[PARTITION\] | 删除分区数据。 | -| RENAME \[TO\] table_name | 表重命名。 | -| DROP \[TABLEGROUP\] | 删除表组。 | -| DROP \[CONSTRAINT\] | 删除约束。 | -| SET BLOCK_SIZE | 设置 Partition 表 BLOCK 大小。 | -| SET REPLICA_NUM | 设置表的副本数(指表的副本总数)。 | -| SET COMPRESSION | 设置表的压缩方式。 | -| SET USE_BLOOM_FILTER | 设置是否使用 BloomFilter。 | -| SET COMMENT | 设置注释信息。 | -| SET PROGRESSIVE_MERGE_NUM | 设置渐进合并步数,取值范围是 1\~64。 | -| parallel_clause | 指定表级别的并行度: * NOPARALLEL:并行度为1,默认配置 * PARALLEL integer:指定并行度,integer 取值大于等于 1。 **注意** 当指定并行度时,优先级关系如下:通过 hint 指定的并行度 \> 通过 `ALTER SESSION` 指定的并行度 \> 表级别的并行度 | -| {ENABLE \| DISABLE} CONSTRAINT constraint_name | 修改约束的状态,支持外键约束或 CHECK 约束。 | - - - -示例 ------------ - -* 示例:修改表 t2 中字段 d 的字段类型。 - - - - - - -```javascript -obclient>CREATE TABLE t2(d VARCHAR(3)); -Query OK, 0 rows affected (0.04 sec) -obclient>ALTER TABLE t2 MODIFY d CHAR(10); -Query OK, 0 rows affected (0.04 sec) -``` - - - -* 示例:增加、删除列。 - - ```unknow - obclient> CREATE TABLE test (c1 NUMBER(30) PRIMARY KEY,c2 VARCHAR(50)); - Query OK, 0 rows affected (0.07 sec) - ``` - - - - - - - - - - - - - - - - - - - - - - - - - - - - -* 示例:设置表格 test 的副本数,并且增加列 c5。 - - - - - - -```javascript -obclient> ALTER TABLE test SET REPLICA_NUM=2, ADD c5 INT; -Query OK, 0 rows affected (0.02 sec) -``` - - - -* 为非模板化二级分区表 t_range_range1 添加二级分区 p1_r4。 - - - - - - -```javascript -obclient>ALTER TABLE t_range_range1 MODIFY partition p1 ADD subpartition p1_r4 values less than (400); -Query OK, 0 rows affected (0.08 sec) -``` - - - -* 删除非模板化二级分区表 t_range_range1 的二级分区 p2_r1。 - - - - - - -```unknow -obclient>ALTER TABLE t_range_range1 DROP subpartition p2_r1; -Query OK, 0 rows affected (0.08 sec) -``` - - - -* 为非模板化二级分区表 t_range_range1 添加一级分区 p4,需要同时指定一级分区的定义和该分区下的二级分区定义。 - - - - - - -```unknow -obclient>ALTER TABLE t_range_range1 ADD partition p4 values less than (500) ( - subpartition p4_r1 values less than (100), - subpartition p4_r2 values less than (200), - subpartition p5_r3 values less than (300) -); -Query OK, 0 rows affected (0.08 sec) -``` - - - -* 为模板化二级分区表 t_range_range 添加一级分区 p3,只需要指定一级分区的定义,二级分区的定义会自动按照模板填充。 - - - - - - -```unknow -obclient>CREATE TABLE t_range_range(c1 INT, c2 INT, PRIMARY KEY(c1,c2)) - PARTITION BY RANGE(c1) SUBPARTITION BY RANGE(c2) SUBPARTITION TEMPLATE - (SUBPARTITION p0 VALUES LESS THAN (50),SUBPARTITION p1 VALUES LESS THAN (100)) - (PARTITION p0 VALUES LESS THAN (100), PARTITION p1 VALUES LESS THAN (200), - PARTITION p2 VALUES LESS THAN (300)); -Query OK, 0 rows affected (0.07 sec) - -obclient>ALTER TABLE t_range_range ADD PARTITION p3 VALUES LESS THAN (400); -Query OK, 0 rows affected (0.07 sec) -``` - - - -* 修改表 t1 的并行度为 3。 - - - - - - -```unknow -obclient> ALTER TABLE t1 PARALLEL 3; -Query OK, 0 rows affected (0.06 sec) -``` - - - -* 修改外键约束的状态 - - - - - - -```unknow -obclient> CREATE TABLE MMS_GROUPUSER ( - "ID" VARCHAR2(254 BYTE) NOT NULL, - "GROUPID" VARCHAR2(254 BYTE), - "USERID" VARCHAR2(254 BYTE), - CONSTRAINT "PK_MMS_GROUPUSER" PRIMARY KEY ("ID"), - CONSTRAINT "FK_MMS_GROUPUSER_02" FOREIGN KEY ("GROUPID") REFERENCES MMS_GROUPUSER ("ID") ON DELETE CASCADE DISABLE -); -Query OK, 0 rows affected (0.09 sec) - -obclient> select CONSTRAINT_NAME,CONSTRAINT_TYPE,TABLE_NAME,STATUS from user_constraints where CONSTRAINT_NAME like 'FK_MMS_GROUPUSE%'; -+---------------------+-----------------+---------------+----------+ -| CONSTRAINT_NAME | CONSTRAINT_TYPE | TABLE_NAME | STATUS | -+---------------------+-----------------+---------------+----------+ -| FK_MMS_GROUPUSER_02 | R | MMS_GROUPUSER | DISABLED | -+---------------------+-----------------+---------------+----------+ -1 row in set (0.00 sec) - -obclient> ALTER TABLE MMS_GROUPUSER ENABLE CONSTRAINT FK_MMS_GROUPUSER_02; -Query OK, 0 rows affected (0.21 sec) - -obclient> select CONSTRAINT_NAME,CONSTRAINT_TYPE,TABLE_NAME,STATUS from user_constraints where CONSTRAINT_NAME like 'FK_MMS_GROUPUSE%'; -+---------------------+-----------------+---------------+---------+ -| CONSTRAINT_NAME | CONSTRAINT_TYPE | TABLE_NAME | STATUS | -+---------------------+-----------------+---------------+---------+ -| FK_MMS_GROUPUSER_02 | R | MMS_GROUPUSER | ENABLED | -+---------------------+-----------------+---------------+---------+ -1 row in set (0.15 sec) -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/6.alter-tablegroup-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/6.alter-tablegroup-1.md deleted file mode 100644 index b6ac21a0b..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/6.alter-tablegroup-1.md +++ /dev/null @@ -1,142 +0,0 @@ -ALTER TABLEGROUP -===================================== - - - -描述 ------------ - -该语句用来执行以下操作: - -* 对一个表组增加多张表。 - - - -* 修改表组的分区规则。 - - - -* 修改表组的 Locality 和 Primary Zone。 - - - - - - -格式 ------------ - -* 对一个表组增加多张表。 - - - - - - -```javascript -ALTER TABLEGROUP tablegroupname ADD [TABLE] tblname [, tblname...] -``` - - - -* 修改表组的分区规则。 - - - - - - -```javascript -ALTER TABLEGROUP tablegroupname alter_tg_partition_option -alter_tg_partition_option: -DROP PARTITION '(' name_list ')' -| ADD PARTITION opt_range_partition_list -| modify_tg_partition_info -``` - - - -* 修改表组的 Locality 和 Primary Zone。 - - - - - - -```javascript -ALTER TABLEGROUP tablegroupname alter_tablegroup_actions -alter_tablegroup_actions: -alter_tablegroup_action -| alter_tablegroup_action, alter_tablegroup_action -alter_tablegroup_action: -SET LOCALITY [=] locality_name -|SET PRIMARY_ZONE [=] primary_zone_name -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|--------------------------------|-------------------------------------------------------------------------------------------------------| -| tablegroupname | 指定表组。 | -| tblname | 表名。对一个表组增加多张表时,表与表之间以逗号(',')分隔。 当添加多个表时,允许表名重复。如果待添加的表已经属于`tablegroupname`的表格组,系统不报错。 | -| modify_tg_partition_info | 修改表组的分区规则。 | -| LOCALITY locality_name | 指定表组的 Locality。 | -| PRIMARY_ZONE primary_zone_name | 指定表组的主 Zone。 | - - - -示例 ------------ - -* 创建表组`tgh`,并将表组的 `Locality`修改为 `F@z1`,并创建两张关系表`ttgh1`和`ttgh2`。 - - - - - - -```javascript -obclient>CREATE TABLEGROUP tgh LOCALITY='F,R{ALL_SERVER}@z1' PARTITION BY HASH PARTITIONS 10; -Query OK, 0 rows affected (0.09 sec) - -obclient>SELECT LOCALITY FROM sys.all_virtual_tablegroup_agent WHERE tablegroup_name ='TGH'; -+------------------------------------+ -| LOCALITY | -+------------------------------------+ -| FULL{1},READONLY{ALL_SERVER}@1 | -+------------------------------------+ -1 row in set (0.01 sec) - -obclient>ALTER TABLEGROUP tgh SET LOCALITY ='F@z1'; -Query OK, 0 rows affected (0.09 sec) - -obclient>SELECT LOCALITY FROM sys.all_virtual_tablegroup_agent WHERE tablegroup_name ='TGH'; -+------------+ -| LOCALITY | -+------------+ -| FULL{1}@z1 | -+------------+ -1 row in set (0.05 sec) - -obclient>SELECT LOCALITY FROM sys.all_virtual_tablegroup_agent WHERE tablegroup_id=(SELECT tablegroup_id FROM sys.all_virtual_tablegroup_agent WHERE tablegroup_name ='TGH'); -+---------------+ -| LOCALITY | -+---------------+ -| FULL{1}@z1 | -+---------------+ -1 row in set (0.00 sec) - -obclient>CREATE TABLE ttgh1(c1 INT, c2 INT) TABLEGROUP = tgh LOCALITY='F@z1' PARTITION BY HASH(c1) PARTITIONS 10; -Query OK, 0 rows affected (0.55 sec) - -obclient>CREATE TABLE ttgh2(c1 INT, c2 INT) TABLEGROUP = tgh LOCALITY='F@z1' PARTITION BY HASH(c1) PARTITIONS 10; -Query OK, 0 rows affected (0.39 sec) -``` - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/7.alter-user-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/7.alter-user-1.md deleted file mode 100644 index f6a069259..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/7.alter-user-1.md +++ /dev/null @@ -1,136 +0,0 @@ -ALTER USER -=============================== - - - -描述 ------------ - -该语句主要用于执行以下操作: - -* 修改 OceanBase 用户的密码。 - - - -* 修改 OceanBase 用户连接的加密方式。 - - - -* 修改 OceanBase 用户的 Primary Zone。 - - - - - -**说明** - - - -必须拥有 UPDATE USER 的权限,才可以执行本命令。 - -格式 ------------ - -* 修改用户密码 - - - - - - -```javascript -ALTER USER username IDENTIFIED BY password; -``` - - - -* 修改用户连接的加密方式 - - - - - - -```javascript -ALTER USER user REQUIRE {NONE | SSL | x509 | tls_option_list} - -tls_option_list: - tls_option - | tls_option_list tls_option - -tls_option: - CIPHER str_value - | ISSUER str_value - | SUBJECT str_value -``` - - - -* 修改用户的 Primary Zone。 - - - - - - -```unknow -ALTER USER username PRIMARY_ZONE 'zone_name'; -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|--------------|---------------------| -| REQUIRE | 指定加密协议。 | -| password | 指定用户密码。 | -| PRIMARY_ZONE | 指定用户的 Primary Zone。 | - - - -示例 ------------ - -* 修改用户 sqluser01 的密码为 abc123 - - - - - - -```javascript -ALTER USER sqluser01 IDENTIFIED BY abc123; -``` - - - -* 修改用户连接加密协议为 SSL - - - - - - -```javascript -ALTER USER sqluser REQUIRE SSL; -``` - - - -* 修改用户 sqluser 的 Primary Zone 为 Zone3 - - - - - - -```unknow -ALTER USER sqluser01 PRIMARY_ZONE 'Zone3'; -``` - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/8.create-index-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/8.create-index-1.md deleted file mode 100644 index 308c9db4d..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/8.create-index-1.md +++ /dev/null @@ -1,85 +0,0 @@ -CREATE INDEX -================================= - - - -描述 ------------ - -该语句用来创建索引。索引是创建在表上的,对数据库表中一列或多列的值进行排序的一种结构。其作用主要在于提高查询的速度,降低数据库系统的性能开销。 - -格式 ------------ - -```javascript -CREATE [UNIQUE] INDEX indexname -     ON tblname (index_col_name,...) - [index_type] [index_options] -index_type: - USING BTREE - -index_options: - index_option [index_option...] - -index_option: - GLOBAL | LOCAL - | COMMENT 'string' - | COMPRESSION [=] {NONE | LZ4_1.0 | LZO_1.0 | SNAPPY_1.0 | ZLIB_1.0} - | BLOCK_SIZE [=] size - | STORING(columname_list) - | VISIBLE | INVISIBLE - -index_col_name: - colname [(length)] [ASC | DESC] - -columname_list: - colname [, colname...] -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|-----------------|-------------------------------------------------------------------------------------------------------------------------------| -| indexname | 指定要创建的索引名称。 | -| tblname | 指过索引所属的表名。 | -| index_col_name | 指定索引的列名,每个列名后都支持 ASC(升序),不支持 DESC(降序)。默认为升序。 建立索引的排序方式为:首先以`index_col_name`中第一个列的值排序;该列值相同的记录,按下一列名的值排序;以此类推。 | -| index_type | 索引类型,只支持`USING BTREE`,以 B 树为索引。 | -| UNIQUE | 指定为唯一索引。 | -| index_option | 指定索引选项,多个`index_option`以空格分隔。 | -| GLOBAL \| LOCAL | 指定该索引是全局索引或局部索引,默认是GLOBAL。 | -| COMMENT | 指定注释。 | -| COMPRESSION | 指定压缩算法。 | -| BLOCK_SIZE | 指定微块大小。 | -| STORING | 表示索引表中冗余存储某些列,以提高系统查询性能。 | - - - -示例 ------------ - -* 创建表 test 的索引。 - - - - - - -```javascript -/* 创建表 test */ -obclient> CREATE TABLE test (c1 INT PRIMARY KEY, c2 VARCHAR(10)); -Query OK, 0 rows affected (0.09 sec) - -/* 创建表 test 的索引 */ -obclient> CREATE INDEX test_index ON test (c1, c2); -Query OK, 0 rows affected (0.64 sec) - -/* 查看表 test 的索引 */ -obclient> SELECT * FROM USER_INDEXES WHERE table_name='TEST'\G -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/9.create-keystore.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/9.create-keystore.md deleted file mode 100644 index d5cce50d9..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/1.DDL-1/9.create-keystore.md +++ /dev/null @@ -1,44 +0,0 @@ -CREATE KEYSTORE -==================================== - - - -描述 ------------ - -该语句用来创建 Keystore 对象,此对象用于存储密钥。在透明加密场景中,需要创建 Keystore 对象,每个租户最多只能创建一个 Keystore 对象。 - -格式 ------------ - -```javascript -ADMINISTER KEY MANAGEMENT CREATE KEYSTORE [KEYSTORE_NAME] IDENTIFIED BY [PASSSWORD] ; -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|---------------|---------------------| -| KEYSTORE_NAME | 指定 Keystore 名称 | -| PASSWORD | 指定访问控制 Keystore 的密码 | - - - -示例 ------------ - -创建一个 Keystore 对象。 - -```javascript -OceanBase(admin@test)>ADMINISTER KEY MANAGEMENT CREATE KEYSTORE my_keystore IDENTIFIED BY abcCBAK123; -``` - - - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/2.DML/1.DELETE-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/2.DML/1.DELETE-1.md deleted file mode 100644 index cda5db44f..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/2.DML/1.DELETE-1.md +++ /dev/null @@ -1,157 +0,0 @@ -DELETE -=========================== - - - -描述 ------------ - -该语句用来删除表中符合条件的行,包括单表删除及多表删除两种方式。 - -格式 ------------ - -```javascript -DELETE [hint_options] [FROM] table_factor - [WHERE where_condition] - [{ RETURNING | RETURN } returning_exprs [into_clause]] - -table_factor: - {tbl_name | table_subquery | '(' table_reference ')' } - -where_condition: - expression - -returning_exprs: - projection [, ...] - -into_clause: -{ INTO into_var_list | BULK COLLECT INTO into_var_list} - -into_var_list: -{ USER_VARIABLE | ref_name } [, ...] - -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|-----------------|----------------------------| -| hint_options | 指定 Hint 选项。 | -| table_factor | 指定需要删除的表名(基表、可更新视图、特殊子查询)。 | -| where_condition | 删除的表需要满足的过滤条件。 | -| returning_exprs | 返回删除数据前的投影列。 | -| into_clause | 将删除数据前的投影列插入到指定列表。 | - - -**注意** - - - -特殊子查询指的类似于可更新视图对应的子查询,这类子查询不应该包含复杂的算子(比如 `GROUP BY`/`DISTINCT`/`WINDOW FUNCTION`等) - -示例 ------------ - -创建表 t1 并插入数据: - -```javascript -obclient>CREATE TABLE t1(c1 INT PRIMARY KEY, c2 INT); -Query OK, 0 rows affected (0.16 sec) - -obclient>INSERT INTO t1 VALUES(1,1); -Query OK, 1 row affected (0.00 sec) - -obclient>INSERT INTO t1 VALUES(2,2); -Query OK, 1 row affected (0.00 sec) - -obclient>INSERT INTO t1 VALUES(3,3); -Query OK, 1 row affected (0.00 sec) - -obclient>INSERT INTO t1 VALUES(4,4); -Query OK, 1 row affected (0.00 sec) - -obclient>SELECT * FROM t1; -+----+------+ -| c1 | c2 | -+----+------+ -| 1 | 1 | -| 2 | 2 | -| 3 | 3 | -| 4 | 4 | -+----+------+ -4 rows in set (0.06 sec) -``` - - - -* 单表删除:删除 "c1=2" 的行,其中 c1 列为表 t1 中的 Primary Key。 - - - - - - -```javascript -obclient>DELETE FROM t1 WHERE c1 = 2; -Query OK, 1 row affected (0.02 sec) - -obclient>SELECT * FROM t1; -+----+------+ -| c1 | c2 | -+----+------+ -| 1 | 1 | -| 3 | 3 | -| 4 | 4 | -+----+------+ -3 rows in set (0.01 sec) -``` - - - -* 单表删除:直接操作子查询进去删除操作。 - - - - - - -```javascript -obclient>DELETE FROM (SELECT * FROM t1); -Query OK, 4 rows affected (0.04 sec) - -obclient>SELECT * FROM t1; -Empty set (0.01 sec) -``` - - - -* 单表删除:包含 `RETURNING` 子句。 - - - - - - -```javascript -obclient>DELETE FROM t1 RETURNING c1; -+----+ -| C1 | -+----+ -| 1 | -| 2 | -| 3 | -| 4 | -+----+ -4 rows in set (0.01 sec) - -obclient>SELECT * FROM t1; -Empty set (0.01 sec) -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/2.DML/2.INSERT-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/2.DML/2.INSERT-1.md deleted file mode 100644 index e4099df1d..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/2.DML/2.INSERT-1.md +++ /dev/null @@ -1,288 +0,0 @@ -INSERT -=========================== - - - -描述 ------------ - -该语句用于添加一个或多个记录到表中。 - -格式 ------------ - -```javascript -INSERT [hint_options] { single_table_insert | multi_table_insert } - -single_table_insert: -{ INTO insert_table_clause opt_nologging '(' column_list ')' values_clause [{ RETURNING | RETURN } returning_exprs [into_clause]] -| INTO insert_table_clause opt_nologging '(' ')' values_clause [{ RETURNING | RETURN } returning_exprs [into_clause]] -| INTO insert_table_clause opt_nologging values_clause [{ RETURNING | RETURN } returning_exprs [into_clause]] -} - -opt_nologging: { NOLOGGING | /*EMPTY*/ } - -returning_exprs: - projection [, ...] - -insert_into_clause: -{ INTO into_var_list | BULK COLLECT INTO into_var_list} - -into_var_list: -{ USER_VARIABLE | ref_name } [, ...] - -values_clause: -VALUES ({ expr | DEFAULT } [, { expr | DEFAULT } ]... ) - -multi_table_insert: -{ ALL { insert_into_clause [ values_clause ] [error_logging_clause] } -| conditional_insert_clause -} subquery - -conditional_insert_clause: -[ ALL | FIRST ] -WHEN condition -THEN insert_into_clause - [ values_clause ] - [ error_logging_clause ] - [ insert_into_clause [ values_clause ] [ error_logging_clause ] ]... -[ WHEN condition - THEN insert_into_clause - [ values_clause ] - [ error_logging_clause ] - [ insert_into_clause [ values_clause ] [ error_logging_clause ] ]... -]... -[ ELSE insert_into_clause - [ values_clause ] - [ error_logging_clause ] - [ insert_into_clause [ values_clause ] [ error_logging_clause ] ]... -] - -error_logging_clause: -LOG ERRORS [ INTO [schema.] table ] [ (simple_expression) ] [ REJECT LIMIT { integer | UNLIMITED } ] -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|---------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| hint_options | 指定 Hint 选项。 | -| single_table_insert | 单表插入。 | -| insert_table_clause | 指定的插入的表,可以是基表、可更新视图、特殊子查询。 | -| opt_nologging | 尽量减少插入时的日志信息。 | -| column_list | 指定要插入的列名。 | -| returning_exprs | 返回插入数据之后的投影列。 | -| insert_into_clause | 将插入数据之后的列值插入到指定列表中。 | -| multi_table_insert | 多表插入。 | -| conditional_insert_clause | 带条件的多表插入。 * ALL:遍历所有匹配条件的分支,只要满足条件就会将数据插入对应的表。 * FIRST:找到第一个满足条件的分支后,将数据插入该分支对应的表,不会再继续检查剩余分支的条件是否满足。 | - - -**注意** - - - -特殊子查询指的类似于可更新视图对应的子查询,这类子查询不应该包含复杂的算子(比如 group by/distinct/window function 等) - -示例 ------------ - -示例表及数据基于以下定义: - -```javascript -obclient>CREATE TABLE t1(c1 INT PRIMARY KEY, c2 INT,c3 INT); -Query OK, 0 rows affected (0.10 sec) - -obclient> SELECT * FROM t; -Empty set (0.02 sec) -``` - - - -* 单表插入:向表 t 中插入一行数据。 - - - - - - -```javascript -obclient> INSERT INTO t VALUES(1,2,3); -Query OK, 1 row affected (0.00 sec) - -obclient> SELECT * FROM t; -+----+------+------+ -| C1 | C2 | C3 | -+----+------+------+ -| 1 | 2 | 3 | -+----+------+------+ -1 row in set (0.00 sec) -``` - - - -* 单表插入:直接向子查询中插入数据 - - - - - - -```javascript -obclient>INSERT INTO (SELECT * FROM t) VALUES(1,2,3); -Query OK, 1 row affected (0.00 sec) - -obclient> SELECT * FROM t; -+----+------+------+ -| C1 | C2 | C3 | -+----+------+------+ -| 1 | 2 | 3 | -+----+------+------+ -1 row in set (0.01 sec) -``` - - - -* 单表插入:包含 `RETURNING` 子句。 - - - - - - -```javascript -obclient>INSERT INTO t VALUES(1,2,3) RETURNING c1; -+----+ -| C1 | -+----+ -| 1 | -+----+ -1 row in set (0.00 sec) - -obclient>SELECT * FROM t; -+----+------+------+ -| C1 | C2 | C3 | -+----+------+------+ -| 1 | 2 | 3 | -+----+------+------+ -1 row in set (0.00 sec) -``` - - - -* 普通的多表插入:当表 t 中有至少一行数据时,向表 t1 插入一行数据 (1,1,1),向表 t2 插入一行数据 (2,2,2)。 - - - - - - -```unknow -obclient>INSERT ALL INTO t1 VALUES(1,1,1) INTO t2 VALUES(2,2,2) SELECT * FROM t - WHERE ROWNUM< 2; -Query OK, 2 rows affected (0.01 sec) -Records: 2 Duplicates: 0 Warnings: 0 - -obclient>SELECT * FROM t1; -+----+------+------+ -| C1 | C2 | C3 | -+----+------+------+ -| 1 | 1 | 1 | -+----+------+------+ -1 row in set (0.02 sec) - -obclient>SELECT * FROM t2; -+----+------+------+ -| C1 | C2 | C3 | -+----+------+------+ -| 2 | 2 | 2 | -+----+------+------+ -1 row in set (0.01 sec) -``` - - - -* 带条件的多表插入:使用 `INSERT ALL`,当表 t 中 c2 的值大于 1 时,向表 t1 中插入数据 (1,1,1);当表 t 中 c3 的值大于 1 时,向表 t2 中插入数据 (2,2,2);如果都不满足,则向表 t1 中插入数据 (3,3,3)。 - - - - - - -```unknow -obclient>DELETE FROM (SELECT * FROM t); -Query OK, 4 rows affected (0.04 sec) - -obclient>INSERT INTO t VALUES(1,2,3); -Query OK, 1 row affected (0.00 sec) - -obclient>INSERT ALL - WHEN c2 > 1 THEN INTO t1 VALUES(1,1,1) - WHEN c3 > 1 THEN INTO t2 VALUES(2,2,2) - ELSE INTO t1 VALUES(3,3,3) SELECT c2,c3 FROM t; -Query OK, 2 rows affected (0.01 sec) -Records: 2 Duplicates: 0 Warnings: 0 - -obclient>SELECT * FROM t1; -+----+------+------+ -| C1 | C2 | C3 | -+----+------+------+ -| 1 | 1 | 1 | -+----+------+------+ -1 row in set (0.00 sec) - -obclient>SELECT * FROM t2; -+----+------+------+ -| C1 | C2 | C3 | -+----+------+------+ -| 2 | 2 | 2 | -+----+------+------+ -1 row in set (0.00 sec) -``` - - - -* 带条件的多表插入:使用 `INSERT FIRST`,当表 t 中 c2 的值大于 1 时,向表 t1 中插入数据 (1,1,1),向表 t2 中插入数据 (4,4,4);当表 t 中 c3 的值大于 1 时,向表 t2 中插入数据 (2,2,2);如果都不满足,则向表 t1 中插入数据 (3,3,3)。 - - - - - - -```unknow -obclient>DELETE FROM (SELECT * FROM t); -Query OK, 4 rows affected (0.04 sec) - -obclient>INSERT INTO t VALUES(1,2,3); -Query OK, 1 row affected (0.00 sec) - -obclient>INSERT ALL - WHEN c2 > 1 THEN INTO t1 VALUES(1,1,1) INTO t2 VALUES(4,4,4) - when c3 > 1 THEN INTO t2 VALUES(2,2,2) - ELSE INTO t1 VALUES(3,3,3) SELECT c2,c3 FROM t; -Query OK, 2 rows affected (0.01 sec) -Records: 2 Duplicates: 0 Warnings: 0 - -obclient>SELECT * FROM t1; -+----+------+------+ -| C1 | C2 | C3 | -+----+------+------+ -| 1 | 1 | 1 | -+----+------+------+ -1 row in set (0.00 sec) - -obclient>SELECT * FROM t2; -+------+------+------+ -| C1 | C2 | C3 | -+------+------+------+ -| 4 | 4 | 4 | -| 2 | 2 | 2 | -+------+------+------+ -2 rows in set (0.00 sec) -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/2.DML/3.MERGE.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/2.DML/3.MERGE.md deleted file mode 100644 index 4602ad4dd..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/2.DML/3.MERGE.md +++ /dev/null @@ -1,103 +0,0 @@ -MERGE -========================== - - - -描述 ------------ - -该语句用来根据一张源表更新一张目标表的数据,可以对目标表进行插入、更新或者删除。 - -格式 ------------ - -```javascript -MERGE [hint_options] - INTO table_factor [opt_alias] - USING table_factor [opt_alias] - ON '(' expr ')' - [merge_update_clause] - [merge_insert_clause] - -merge_update_clause: - WHEN MATCHED THEN UPDATE SET update_asgn_list [WHERE expr] [DELETE WHERE expr] - -merge_insert_clause: - WHEN NOT MATCHED THEN INSERT opt_insert_columns VALUES '(' insert_vals ')' [WHERE expr] -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|------------------|------------------------| -| hint_options | 指定 Hint 选项 | -| table_factor | 指定源表和目标表的表名 | -| ON expr | 源表和目标表的连接条件 | -| update_asgn_list | 更新语句的赋值操作 | -| WHERE expr | 触发更新、删除或者插入操作时的需要满足的条件 | - - - -示例 ------------ - -示例表和数据基于以下定义: - -```javascript -CREATE TABLE t1 (c1 INT, c2 INT); -CREATE TABLE t2 (c1 INT, c2 INT); - -INSERT INTO t1 VALUES(0, 0); -INSERT INTO t1 VALUES(1, null); -INSERT INTO t1 VALUES(2, null); -INSERT INTO t2 VALUES(1, 1); -INSERT INTO t2 VALUES(2, 20); -INSERT INTO t2 VALUES(3, 3); -INSERT INTO t2 VALUES(4, 40); -``` - - - -根据 T2 的数据更新 T1 的数据: - -1. 如果 t1.c1 在 t2 中能够找到 c1 取值相同的行,如果 t1.c2 取值为空,那么使用 t2.c2 更新 t1.c2;如果更新之后`t1.c2 >= 10`,那么删除该行。 - - - - - - - - -2. 如果 t2.c1 在 t1 中找不到取值相同的行,将 t2 中的这行插入到 t1 中,且只插入满足 `t2.c2 < 10` 的行。 - - - - - - -```javascript -obclient>MERGE INTO t1 USING t2 ON (t1.c1 = t2.c1) - WHEN MATCHED THEN UPDATE SET c2 = t2.c2 where t1.c2 IS NULL DELETE - WHERE t1.c2 >= 10 WHEN NOT MATCHED THEN INSERT VALUES(t2.c1, t2.c2) - WHERE t2.c2 < 10; -Query OK, 3 rows affected (0.02 sec) - -obclient>SELECT * FROM t1; -+------+------+ -| C1 | C2 | -+------+------+ -| 0 | 0 | -| 1 | 1 | -| 3 | 3 | -+------+------+ -3 rows in set (0.00 sec) -``` - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/2.DML/4.purge-index-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/2.DML/4.purge-index-1.md deleted file mode 100644 index 260c9b290..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/2.DML/4.purge-index-1.md +++ /dev/null @@ -1,64 +0,0 @@ -PURGE INDEX -================================ - - - -描述 ------------ - -该语句用来删除放在回收站中的索引表。 - -格式 ------------ - -```javascript - PURGE INDEX object_name; -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|-------------|--------------| -| object_name | 对象进入回收站后的新名字 | - - - -示例 ------------ - -* 删除放在回收站中的索引 RECYCLE_$_2_1615970480497000。 - - - - - - -```javascript -obclient>CREATE TABLE t1(c1 INT); -Query OK, 0 rows affected (0.09 sec) - -obclient>CREATE INDEX idx ON t1(c1); -Query OK, 0 rows affected (0.48 sec) - -obclient>DROP TABLE t1; -Query OK, 0 rows affected (0.03 sec) - -obclient>SHOW RECYCLEBIN; -+------------------------------+----------------------------+-------+------------------------------+ -| OBJECT_NAME | ORIGINAL_NAME | TYPE | CREATETIME | -+------------------------------+----------------------------+-------+------------------------------+ -| RECYCLE_$_2_1615970480497000 | __idx_1102810162709362_IDX | INDEX | 17-MAR-21 04.41.20.497680 PM | -| RECYCLE_$_2_1615970480507000 | T1 | TABLE | 17-MAR-21 04.41.20.507102 PM | -+------------------------------+----------------------------+-------+------------------------------+ -2 rows in set (0.00 sec) - -obclient> PURGE RECYCLE_$_2_1615970480497000; -Query OK, 0 rows affected (0.04 sec) -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/2.DML/5.purge-recyclebin-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/2.DML/5.purge-recyclebin-1.md deleted file mode 100644 index 08e737236..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/2.DML/5.purge-recyclebin-1.md +++ /dev/null @@ -1,45 +0,0 @@ -PURGE RECYCLEBIN -===================================== - - - -描述 ------------ - -该语句用于 root 用户清空回收站。 -**注意** - - - -PURGE RECYCLEBIN会清除回收站中的所有东西,只有 root 用户才能够执行这条语句,操作时请谨慎。 - -格式 ------------ - -```javascript - PURGE RECYCLEBIN; -``` - - - -参数解释 -------------- - -无。 - -示例 ------------ - -* root 用户清空回收站。 - - - - - - -```javascript -OceanBase(admin@test)> purge recyclebin; -Query OK, 0 rows affected (0.03 sec) -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/2.DML/6.purge-table-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/2.DML/6.purge-table-1.md deleted file mode 100644 index fa8c60b50..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/2.DML/6.purge-table-1.md +++ /dev/null @@ -1,61 +0,0 @@ -PURGE TABLE -================================ - - - -描述 ------------ - -该语句用于删除放在回收站的表。 - -格式 ------------ - -```javascript - PURGE TABLE object_name; -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|-------------|--------------| -| object_name | 对象进入回收站后的新名字 | - - - -示例 ------------ - -* 删除放在回收站中的表 RECYCLE_$_2_1615971441068848。 - - - - - - -```javascript -obclient>CREATE TABLE test(c1 INT); -Query OK, 0 rows affected (0.16 sec) - -obclient>DROP TABLE test; -Query OK, 0 rows affected (0.03 sec) - -obclient>SHOW RECYCLEBIN; -+-------------------------------------------+---------------+-------+----------------------------+ -| OBJECT_NAME | ORIGINAL_NAME | TYPE | CREATETIME | -+-------------------------------------------+---------------+-------+----------------------------+ -| RECYCLE_$_2_1615971441068848 | TEST | TABLE | 17-MAR-21 04.57.21.068968 PM | -+-------------------------------------------+---------------+-------+----------------------------+ -1 row in set (0.02 sec) - -obclient>PURGE TABLE RECYCLE_$_2_1615971441068848; -Query OK, 0 rows affected (0.04 sec) -``` - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/2.DML/7.SELECT-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/2.DML/7.SELECT-1.md deleted file mode 100644 index 95af08b9b..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/2.DML/7.SELECT-1.md +++ /dev/null @@ -1,524 +0,0 @@ -SELECT -=========================== - - - -`SELECT`的语法相对比较复杂。本节首先会介绍`SIMPLE SELECT`语法结构,然后介绍集合类`SELECT`的语法结构,最后介绍带有`with clause`的`SELECT`。 - -SIMPLE SELECT ----------------------- - -### 描述 - -该语句用于查询表中的内容。 - -### 格式 - -```javascript -simple_select: -SELECT [/*+ hint statement */] [DISTINCT | UNIQUE | ALL] - select_expr_list FROM from_list [WHERE condition] - [GROUP BY group_expression_list] [{ROLLUP | GROUPING SETS} group_expression_list] [HAVING condition]] - [ORDER BY order_expression_list] - [FOR UPDATE [OF column] [ {NOWAIT | WAIT integer | SKIP LOCKED } ] ] - -select_expr: - table_name.* - | table_alias_name.* - | expr [[AS] column_alias_name] - -from_list: - table_reference [, table_reference ...] - -table_reference: - simple_table - | joined_table - -simple_table: - table_factor [partition_option] [[AS] table_alias_name] - | (select_stmt) [AS] table_alias_name - | (table_reference_list) - -joined_table: - table_reference [INNER] JOIN simple_table [join_condition] - | table_reference outer_join_type JOIN simple_table join_condition - -partition_option: - PARTITION (partition_name_list) - -partition_name_list: - partition_name [, partition_name ...] - -outer_join_type: - {LEFT | RIGHT | FULL} [OUTER] - -join_condition: - ON expression - -condition: - expression - -group_expression_list: - group_expression [, group_expression ...] - -group_expression: - expression [ASC | DESC] - -order_expression_list: - order_expression [, order_expression ...] - -order_expression: - expression [ASC | DESC] -``` - - - -### 参数解释 - - - -| 参数 | 描述 | -|---------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| DISTINCT \| UNIQUE \| ALL | 在数据库表中,可能会包含重复值。 * 指定"DISTINCT",则在查询结果中相同的行只显示一行。 * 指定 "UNIQUE",则在查询结果中相同的行只显示一行。 * 指定"ALL",则在查询结果中显示所有的行(包含重复),默认为 ALL。 | -| select_expr | 列出要查询的表达式或列名,用","隔开。也可以用"\*"表示所有列。 | -| AS othername | 为输出字段重新命名。 | -| FROM table_references | 指名了从哪个表或哪些表中读取数据(支持多表查询)。 | -| WHERE where_conditions | 可选项,`WHERE`子句用来设置一个筛选条件,查询结果中仅包含满足条件的数据。`where_conditions` 为表达式。 | -| GROUP BY group_by_list | 按一些字段进行分组,产生统计值。 | -| ROLLUP group_expression_list | 合并 Group By 的分组,产生统计值。 | -| GROUPING SETS group_expression_list | 在一个查询中指定多个数据分组,分别产生统计值,并将指定的分组统计值聚合显示。`GROUPING SETS` 中可以指定单个字段或字段列表。 | -| HAVING search_confitions | `HAVING`子句与`WHERE`子句类似,但是`HAVING`子句可以使用累计函数(如 SUM、AVG 等)。 | -| ORDER BY order_list order_list : colname \[ASC \| DESC\] \[,colname \[ASC \| DESC\]...\] | 用来按升序(ASC)或者降序(DESC)显示查询结果。不指定 ASC 或者 DESC 时,默认为 ASC。 | -| FOR UPDATE | 对查询结果所有行上排他锁,以阻止其他事务的并发修改,或阻止在某些事务隔离级别时的并发读取。 * `OF column`:对于多表 Join 的场景,使用该子句可以指示仅锁定某些表(即 column 指定列所在的表)的查询结果行。 * `WAIT`:等待 Interger 时间后再对查询结果行尝试加锁,如果查询结果行中已经有被其他会话加锁的行,则执行失败。 * `NOWAIT`:立即对查询结果行尝试加锁如果查询结果行中已经有被其他会话加锁的行,则执行失败。 * `SKIP LOCKED`:如果查询结果中已经有被其他会话加锁的行,则会跳过这些加锁行,返回未被加锁的行。 **说明** SKIP LOCKED 暂不支持多表 JOIN 加锁的场景。 | -| PARTITION(partition_list) | 指定查询表的分区信息。例如:`partition(p0,p1...)` | - - - -### 示例 - -以如下表`a`为例。 - -![image.png](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/5455055061/p179248.png "image.png") - -```unknow -CREATE TABLE a (id INT,name VARCHAR(10),num INT); -INSERT INTO a VALUES (1, 'a',100); -INSERT INTO a VALUES (2, 'b',200); -INSERT INTO a VALUES (3, 'a',50); -``` - - - -* 从表`a`中读取`name`数据。 - - ```javascript - obclient> SELECT name FROM a; - +------+ - | NAME | - +------+ - | a | - | b | - | a | - +------+ - 3 rows in set (0.00 sec) - ``` - - - - - - - - -* 在查询结果中对`name`进行去重处理。 - - ```javascript - obclient> SELECT DISTINCT name FROM a; - +------+ - | NAME | - +------+ - | a | - | b | - +------+ - 2 rows in set (0.00 sec) - ``` - - - - - - - - -* 从表`a`中查询 `id`、`name`和`num`,然后把`num`列除以 2 输出,输出的列名为`avg`。 - - ```javascript - obclient> SELECT id, name, num/2 AS avg FROM a; - +----+------+------+ - | ID | NAME | AVG | - +----+------+------+ - | 1 | a | 50 | - | 2 | b | 100 | - | 3 | a | 25 | - +----+------+------+ - 3 rows in set (0.00 sec) - ``` - - - - - - - - -* 从表`a`中根据筛选条件" name = 'a' ",输出对应的`id` 、`name`和`num` 。 - - ```javascript - obclient> SELECT id, name, num FROM a WHERE name = 'a'; - +----+------+------+ - | ID | NAME | NUM | - +----+------+------+ - | 1 | a | 100 | - | 3 | a | 50 | - +----+------+------+ - 2 rows in set (0.00 sec) - ``` - - - - - - - - -* 从表`a`中查询`name`,按照`name`分组对`num`求和,并输出。 - - ```javascript - obclient> SELECT id, name, num FROM a WHERE name = 'a'; - +----+------+------+ - | ID | NAME | NUM | - +----+------+------+ - | 1 | a | 100 | - | 3 | a | 50 | - +----+------+------+ - 2 rows in set (0.00 sec) - ``` - - - - - - - - -* 从表`a`中查询`name`,按照`name`分组对`num`求和,查询`num`总和小于 160 的行,并输出。 - - ```javascript - obclient> SELECT name, SUM(num) as sum FROM a GROUP BY name HAVING SUM(num) < 160; - +------+------+ - | NAME | SUM | - +------+------+ - | a | 150 | - +------+------+ - 1 row in set (0.00 sec) - ``` - - - - - - - - -* 从表`a`中查询`id`、`name`和`num`,根据`num`按升序(ASC)输出查询结果。 - - ```javascript - obclient> SELECT * FROM a ORDER BY num ASC; - +----+------+------+ - | ID | NAME | NUM | - +----+------+------+ - | 3 | a | 50 | - | 1 | a | 100 | - | 2 | b | 200 | - +----+------+------+ - 3 rows in set (0.00 sec) - ``` - - - - - - - - -* 从表`a`中查询`id`、`name`和`num`,根据`num`按降序(DESC)输出查询结果。 - - ```javascript - obclient> SELECT * FROM a ORDER BY num DESC; - +----+------+------+ - | ID | NAME | NUM | - +----+------+------+ - | 2 | b | 200 | - | 1 | a | 100 | - | 3 | a | 50 | - +----+------+------+ - 3 rows in set (0.00 sec) - ``` - - - - - - - - -* 从表`a`中查询指定`id`的行,并使用`FOR UPDATE`子句把查询结果行进行锁定。 - - ```unknow - /* 在会话 1 中查询表 a 中 id=1 的行并锁定 */ - obclient> SELECT * FROM a WHERE id=1 FOR UPDATE; - +------+------+------+ - | ID | NAME | NUM | - +------+------+------+ - | 1 | a | 100 | - +------+------+------+ - 1 row in set (0.01 sec) - - /* 在会话 2 中查询表 a 中 id=1 或 id=2 的行并锁定 */ - obclient> SELECT * FROM a WHERE id=1 or id=2 FOR UPDATE; - ORA-30006: resource busy; acquire with WAIT timeout expired - - obclient> SELECT * FROM a WHERE id=1 or id=2 FOR UPDATE SKIP LOCKED; - +------+------+------+ - | ID | NAME | NUM | - +------+------+------+ - | 2 | b | 200 | - +------+------+------+ - 1 row in set (0.01 sec) - ``` - - - -* 从表`a`中按 name 和 num 分组查询并统计每个分组中的数量。 - - ```unknow - obclient> SELECT name, num, COUNT(*) from a GROUP BY GROUPING SETS(name, num); - +------+------+----------+ - | NAME | NUM | COUNT(*) | - +------+------+----------+ - | a | NULL | 2 | - | b | NULL | 1 | - | NULL | 100 | 1 | - | NULL | 200 | 1 | - | NULL | 50 | 1 | - +------+------+----------+ - 5 rows in set (0.01 sec) - ``` - - - - - - - - -集合类 SELECT -------------------- - -### 描述 - -该语句用于对多个`SELECT`查询的结果进行`UNION`、`MINUS`、`INTERSECT`。 - -### 格式 - -```javascript -select_clause_set: - simple_select [ UNION | UNION ALL | | INTERSECT] select_clause_set_right - [ORDER BY sort_list_columns] - -select_clause_set_right: - simple_select | - select_caluse_set -``` - - - -### 参数解释 - - - -| 参数 | 描述 | -|-----------|--------------------------| -| UNION ALL | 合并两个查询的结果 | -| UNION | 合并两个查询的结果,并去重 | -| MINUS | 从左查询结果集中去重出现在右查询中的结果,并去重 | -| INTERSECT | 保留左查询结果集中出现在右查询中的结果,并去重 | - - - -### 示例 - -以如下两表的数据为例: - -```javascript -CREATE TABLE t1 (c1 INT, c2 INT); -CREATE TABLE t2 (c1 INT, c2 INT); -INSERT INTO t1 VALUES (1, -1), (2, -2); -INSERT INTO t2 VALUES (1, 1), (2, -2), (3, 3); -``` - - - -* 计算`t1`、`t2`的所有的记录 - - ```javascript - obclient>SELECT c1, c2 FROM t1 UNION ALL SELECT c1, c2 FROM t2; - +------+------+ - | C1 | C2 | - +------+------+ - | 1 | -1 | - | 2 | -2 | - | 1 | 1 | - | 2 | -2 | - | 3 | 3 | - +------+------+ - 5 rows in set (0.01 sec) - ``` - - - - - - - - -* 计算`t1`、`t2`的去重后的所有记录 - - ```javascript - obclient>SELECT c1, c2 FROM t1 UNION SELECT c1, c2 FROM t2; - +------+------+ - | C1 | C2 | - +------+------+ - | 1 | -1 | - | 2 | -2 | - | 1 | 1 | - | 3 | 3 | - +------+------+ - 4 rows in set (0.01 sec) - ``` - - - - - - - - -* 计算`t1`和`t2`的交集 - - ```javascript - SELECT c1, c2 FROM t1 INTERSECT SELECT c1, c2 FROM t2; - +------+------+ - | C1 | C2 | - +------+------+ - | 2 | -2 | - +------+------+ - ``` - - - - - - - - -* 计算`t1`和`t2`的差集 - - ```javascript - obclient>SELECT c1, c2 FROM t1 INTERSECT SELECT c1, c2 FROM t2; - +------+------+ - | C1 | C2 | - +------+------+ - | 2 | -2 | - +------+------+ - ``` - - - - - - -带有 with clause 的 SELECT --------------------------------- - -### 描述 - -如果查询语句中有多个相同的子查询,可以把相同的子查询放在`with clause`作为公共表达式,在主体查询中直接引用即可。 - -### 格式 - -```javascript -with_clause_select: - with_clause simple_select - -with_clause: - WITH table_name [opt_column_alias_name_list] AS ( select_clause ) - -select_clause: - simple_select | select_clause_set - -opt_column_alias_name_list: - (column_name_list) - -column_name_list: - column_name | column_name , column_name_list -``` - - - -### 参数解释 - -无 - -### 示例 - -以如下表格数据和`SELECT`查询为例。 - -```javascript -CREATE TABLE t1(c1 INT, c2 INT, c3 INT); -CREATE TABLE t2(c1 INT); -INSERT INTO t1 VALUES(1,1,1); -INSERT INTO t1 VALUES(2,2,2); -INSERT INTO t1 VALUES(3,3,3); -INSERT INTO t2 VALUES(4); - -obclient>SELECT * FROM t1 WHERE c1 > (SELECT COUNT(*) FROM t2) - AND c2 > (SELECT COUNT(*) FROM t2) - AND c3 > (SELECT COUNT(*) FROM t2); -+------+------+------+ -| C1 | C2 | C3 | -+------+------+------+ -| 2 | 2 | 2 | -| 3 | 3 | 3 | -+------+------+------+ -2 rows in set (0.01 sec) -``` - - - -可以抽取相同子查询为`with clause`: - -```javascript -obclient>WITH TEMP(cnt) AS (SELECT COUNT(*) FROM t2) - SELECT t1.* FROM t1, temp WHERE c1 > temp.cnt AND c2 > temp.cnt - AND c3 > temp.cnt; -+------+------+------+ -| C1 | C2 | C3 | -+------+------+------+ -| 2 | 2 | 2 | -| 3 | 3 | 3 | -+------+------+------+ -2 rows in set (0.00 sec) -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/2.DML/8.UPDATE-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/2.DML/8.UPDATE-1.md deleted file mode 100644 index b42ddcfe8..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/2.DML/8.UPDATE-1.md +++ /dev/null @@ -1,167 +0,0 @@ -UPDATE -=========================== - - - -描述 ------------ - -该语句用于修改表中的字段值。 - -格式 ------------ - -```javascript -UPDATE [hint_options] dml_table_clause - SET update_asgn_list - [WHERE where_condition] - [{ RETURNING | RETURN } returning_exprs [into_clause]] - -dml_table_clause: - dml_table_name opt_table_alias - -update_asgn_list: - column_name = expr [, ...] - -where_condition: - expression - -returning_exprs: - projection [, ...] - -into_clause: -{ INTO into_var_list | BULK COLLECT INTO into_var_list} - -into_var_list: -{ USER_VARIABLE | ref_name } [, ...] -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|------------------|-------------------------| -| hint_options | 指定 hint 选项。 | -| dml_table_clause | 指定修改的表名(基表、可更新视图、特殊子查询) | -| where_condition | 指定过滤条件。 | -| update_asgn_list | 指定更新列表。 | -| returning_exprs | 返回修改数据后的投影列。 | -| into_clause | 将修改数据后的投影列插入到指定列表 | - - -**注意** - - - -特殊子查询指的类似于可更新视图对应的子查询,这类子查询不应该包含复杂的算子(比如group by/distinct/window function等等) - -示例 ------------ - -创建示例表 t1 和 t2。 - -```javascript -OceanBase(admin@test)>create table t1(c1 int primary key, c2 int); -Query OK, 0 rows affected (0.16 sec) -OceanBase(admin@test)>select * from t1; -+----+------+ -| c1 | c2 | -+----+------+ -| 1 | 1 | -| 2 | 2 | -| 3 | 3 | -| 4 | 4 | -+----+------+ -4 rows in set (0.06 sec) -``` - - - -* 单表更新:将表 t1 中 "t1.c1=1" 对应的那一行数据的 c2 列值修改为 100。 - - - - - - -```javascript -OceanBase(admin@test)>update t1 set t1.c2 = 100 where t1.c1 = 1; -Query OK, 1 row affected (0.02 sec) -Rows matched: 1 Changed: 1 Warnings: 0 - -OceanBase(admin@test)>select * from t1; -+----+------+ -| c1 | c2 | -+----+------+ -| 1 | 100 | -| 2 | 2 | -| 3 | 3 | -| 4 | 4 | -+----+------+ -4 rows in set (0.01 sec) -``` - - - -* 单表更新:直接操作子查询,将子查询 中 "v.c1=1" 对应的那一行数据的 c2 列值修改为 100。 - - - - - - -```javascript -OceanBase(admin@test)>update (select * from t1)v set v.c2 = 100 where v.c1 = 1; -Query OK, 1 row affected (0.02 sec) -Rows matched: 1 Changed: 1 Warnings: 0 - -OceanBase(admin@test)>select * from t1; -+----+------+ -| C1 | C2 | -+----+------+ -| 1 | 100 | -| 2 | 2 | -| 3 | 3 | -| 4 | 4 | -+----+------+ -4 rows in set (0.01 sec) -``` - - - -* 单表更新:包含 returning 子句。 - - - - - - -```javascript -OceanBase(admin@test)>update t1 set t1.c2 = 100 where t1.c1 = 1 returning c2; -+------+ -| C2 | -+------+ -| 100 | -+------+ -1 row in set (0.02 sec) - -OceanBase(admin@test)>select * from t1; -+----+------+ -| C1 | C2 | -+----+------+ -| 1 | 100 | -| 2 | 2 | -| 3 | 3 | -| 4 | 4 | -+----+------+ -4 rows in set (0.01 sec) -``` - - - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/1.EXPLAIN-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/1.EXPLAIN-1.md deleted file mode 100644 index 0044cb261..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/1.EXPLAIN-1.md +++ /dev/null @@ -1,213 +0,0 @@ -EXPLAIN -============================ - - - -描述 ------------ - -该语句用于解释 SQL 语句的执行计划,可以是 `SELECT`、`DELETE`、`INSERT`、`REPLACE` 或 `UPDATE` 语句。 - -格式 ------------ - -```javascript -获取表或列的信息: -{EXPLAIN | DESCRIBE | DESC} tbl_name [col_name | wild] - -获取SQL计划信息: -{EXPLAIN} -[BASIC | OUTLINE | EXTENDED | EXTENDED_NOADDR | PARTITIONS | FORMAT = {TRADITIONAL| JSON}] -{SELECT statement | DELETE statement | INSERT statement | UPDATE statement | MERGE statement} -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|-------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| tbl_name | 指定表名。 | -| col_name | 指定表的列名。 | -| BASIC | 指定输出计划的基础信息,如算子 ID、算子名称、所引用的表名。 | -| OUTLINE | 指定输出的计划信息包含 Outline 信息。 | -| EXTENDED | `EXPLAIN`产生附加信息,包括:每个算子的输入列和输出列,访问表的分区信息,当前使用的filter信息,如果当前算子使用了索引,显示所使用的索引列及抽取的 Query Range。 | -| EXTENDED_NOADDR | 以简约的方式展示附加信息。 | -| PARTITIONS | 显示分区相关信息。 | -| FORMAT = {TRADITIONAL\| JSON} | 指定`EXPALIN`的输出格式: * `TRADITIONAL`:表格输出格式. * `JSON`:`KEY:VALUE`输出格式,`JSON`显示为`JSON`字符串,包括`EXTENDED`和`PARTITIONS`信息。 | - - - -示例 ------------ - -* 省略 `explain_type` - - - - - - -```javascript -obclient>CREATE TABLE t1(c1 INT,c2 INT); -Query OK, 0 rows affected (0.04 sec) - -obclient>CREATE TABLE t2(c1 INT,c2 INT); -Query OK, 0 rows affected (0.07 sec) - -obclient>EXPLAIN SELECT * FROM t1,t2 WHERE t1.c2=t2.c2 AND t2.c1 > 4\G -*************************** 1. row *************************** -Query Plan: ======================================= -|ID|OPERATOR |NAME|EST. ROWS|COST | ---------------------------------------- -|0 |HASH JOIN | |9801000 |5933109| -|1 | TABLE SCAN|t2 |10000 |6219 | -|2 | TABLE SCAN|t1 |100000 |68478 | -======================================= - -Outputs & filters: -------------------------------------- - 0 - output([t1.c1], [t1.c2], [t2.c1], [t2.c2]), filter(nil), - equal_conds([t1.c2 = t2.c2]), other_conds(nil) - 1 - output([t2.c2], [t2.c1]), filter(nil), - access([t2.c2], [t2.c1]), partitions(p0) - 2 - output([t1.c2], [t1.c1]), filter(nil), - access([t1.c2], [t1.c1]), partitions(p0) -``` - - - -* EXTENDED - - - - - - -```javascript -obclient>EXPLAIN EXTENDED_NOADDR SELECT * FROM t1,t2 - WHERE t1.c2=t2.c2 AND t2.c1 > 4\G -*************************** 1. row *************************** -Query Plan: ======================================= -|ID|OPERATOR |NAME|EST. ROWS|COST | ---------------------------------------- -|0 |HASH JOIN | |9801000 |5933109| -|1 | TABLE SCAN|t2 |10000 |6219 | -|2 | TABLE SCAN|t1 |100000 |68478 | -======================================= - -Outputs & filters: -------------------------------------- - 0 - output([t1.c1], [t1.c2], [t2.c1], [t2.c2]), filter(nil), - equal_conds([t1.c2 = t2.c2]), other_conds(nil) - 1 - output([t2.c2], [t2.c1]), filter(nil), - access([t2.c2], [t2.c1]), partitions(p0), - is_index_back=false, - range_key([t2.c1]), range(4 ; MAX), - range_cond([t2.c1 > 4]) - 2 - output([t1.c2], [t1.c1]), filter(nil), - access([t1.c2], [t1.c1]), partitions(p0), - is_index_back=false, - range_key([t1.__pk_increment], [t1.__pk_cluster_id], [t1.__pk_partition_id]), range(MIN,MIN,MIN ; MAX,MAX,MAX)always true -``` - - - -* `TRADITIONAL`格式 - - - - - - -```javascript -obclient>EXPLAIN FORMAT=TRADITIONAL SELECT * FROM t1,t2 - WHERE t1.c2=t2.c2 AND t2.c1 > 4\G -*************************** 1. row *************************** -Query Plan: ======================================= -|ID|OPERATOR |NAME|EST. ROWS|COST | ---------------------------------------- -|0 |HASH JOIN | |9801000 |5933109| -|1 | TABLE SCAN|t2 |10000 |6219 | -|2 | TABLE SCAN|t1 |100000 |68478 | -======================================= - -Outputs & filters: -------------------------------------- - 0 - output([t1.c1], [t1.c2], [t2.c1], [t2.c2]), filter(nil), - equal_conds([t1.c2 = t2.c2]), other_conds(nil) - 1 - output([t2.c2], [t2.c1]), filter(nil), - access([t2.c2], [t2.c1]), partitions(p0) - 2 - output([t1.c2], [t1.c1]), filter(nil), - access([t1.c2], [t1.c1]), partitions(p0) -``` - - - -* JSON 格式 - - - - - - -```javascript -obclient>EXPLAIN FORMAT=JSON SELECT * FROM t1,t2 - WHERE t1.c2=t2.c2 AND t2.c1 > 4\G -*************************** 1. row *************************** -Query Plan: { - "ID":2, - "OPERATOR":"JOIN", - "NAME":"JOIN", - "EST.ROWS":9800999, - "COST":6840524, - "output": [ - "T1.C1", - "T1.C2", - "T2.C1", - "T2.C2" - ], - "CHILD_1": { - "ID":0, - "OPERATOR":"TABLE SCAN", - "NAME":"TABLE SCAN", - "EST.ROWS":10000, - "COST":80810, - "output": [ - "T2.C2", - "T2.C1" - ] - }, - "CHILD_2": { - "ID":1, - "OPERATOR":"TABLE SCAN", - "NAME":"TABLE SCAN", - "EST.ROWS":100000, - "COST":64065, - "output": [ - "T1.C2", - "T1.C1" - ] - } -} -1 row in set (0.01 sec) -``` - - - -EXPLAIN 的每个输出行提供一个表的相关信息,并且每个行包括下面的列: - - -| 列名 | 说明 | -|----------|------------------| -| ID | 计划执行序列号。 | -| OPERATOR | 执行算子。 | -| NAME | 算子所引用的表。 | -| EST.ROWS | 估计执行到当前算子输出的行数。 | -| COST | 执行到当前算子的 CPU 时间。 | - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/10.SHOW.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/10.SHOW.md deleted file mode 100644 index 88cd95517..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/10.SHOW.md +++ /dev/null @@ -1,45 +0,0 @@ -SHOW -========================= - - - -描述 ------------ - -`SHOW PARAMETERS` 用于显示所有系统配置项。 - -`SHOW VARIABLES` 用于显示所有系统变量。 - -`SHOW ERRORS` 用于显示当前对象的错误信息。 - -格式 ------------ - -```javascript -SHOW PARAMETERS; -SHOW VARIABLES; -SHOW ERRORS; -``` - - - -参数解释 -------------- - -无 - -示例 ------------ - -* 显示所有系统配置项。 - - - - - - -```javascript -obclient> SHOW PARAMETERS; -``` - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/11.show-recyclebin-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/11.show-recyclebin-1.md deleted file mode 100644 index 6a864c54b..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/11.show-recyclebin-1.md +++ /dev/null @@ -1,41 +0,0 @@ -SHOW RECYCLEBIN -=============== - -描述 ------------ - -该语句用于查看回收站中的内容。 - -格式 ------------ - -```javascript - SHOW RECYCLEBIN; -``` - -参数解释 -------------- - -无。 - -示例 ------------ - -* 查看回收站中的内容。 - -```javascript -OceanBase(admin@test)> create table t1(c1 int); -Query OK, 0 rows affected (0.24 sec) - -OceanBase(admin@test)> drop table t1; -Query OK, 0 rows affected (0.07 sec) - -OceanBase(admin@test)> show recyclebin; -+-------------------------------------------+---------------+-------+----------------------------+ -| OBJECT_NAME | ORIGINAL_NAME | TYPE | CREATETIME | -+-------------------------------------------+---------------+-------+----------------------------+ -| __recycle_$_1_1099511628776_1099511677777 | t1 | TABLE | 2017-10-20 17:27:40.881506 | -+-------------------------------------------+---------------+-------+----------------------------+ -1 row in set (0.02 sec) -``` - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/12.SHRINK.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/12.SHRINK.md deleted file mode 100644 index 5577a9fcc..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/12.SHRINK.md +++ /dev/null @@ -1,46 +0,0 @@ -SHRINK -=========================== - - - -描述 ------------ - -该语句会将表的数据重整,即在合并的过程中重新写一遍。 - -格式 ------------ - -```javascript -ALTER TABLE table_name SHRINK SPACE -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|------------|----| -| table_name | 表名 | - - - -示例 ------------ - -* 将表 t1 的数据重整 - - - - - - -```javascript -OceanBase(admin@test)>ALTER TABLE t1 SHRINK SPACE; -``` - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/13.TRANSACTION-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/13.TRANSACTION-1.md deleted file mode 100644 index db03e3707..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/13.TRANSACTION-1.md +++ /dev/null @@ -1,120 +0,0 @@ -TRANSACTION -================================ - - - -描述 ------------ - -该语句用于开启事务。 - -数据库事务(Database Transaction)是指作为单个逻辑工作单元执行的一系列操作。事务处理可以用来维护数据库的完整性,保证成批的 SQL 操作全部执行或全部不执行。 - -显示事务是用户自定义或用户指定的事务。通过`BEGIN TRANSACTION`,或`BEGIN`和`BEGIN WORK`(被作为 `START TRANSACTION`的别名受到支持)语句显示开始,以`COMMIT`或`ROLLBACK`语句显示结束。 - -格式 ------------ - -```javascript -transaction_stmt: - START TRANSACTION [READ ONLY | READ WRITE]; - | BEGIN [WORK]; - | COMMIT [WORK]; - | ROLLBACK [WORK]; - | SET TRANSACTION {READ ONLY | READ WRITE}; -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|-----------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| START TRANSACTION \[READ ONLY \| READ WRITE\] | 开启事务语句。一旦开启事务,则随后的 SQL 数据操作语句(即`INSERT`、`UPDATE`、`DELETE`等)直到显式提交时才会生效。 `READ ONLY` 子句表示事务是只读方式开启,事务内不允许执行修改操作。 `READ WRITE` 子句表示事务是读写方式开启,默认就是此种模式。 | -| BEGIN | `BEGIN` 和 `BEGIN WORK` 被作为` START TRANSACTION` 的别名受到支持 | -| COMMIT | 提交当前事务。 | -| ROLLBACK | 回滚当前事务。 | -| SET TRANSACTION {READ ONLY \| READ WRITE} | 将当前事务设置成`READ ONLY`或者`READ WRITE`模式。 | - - - -示例 ------------ - -假设现有表 a 如下所示。 - - -| id | name | num | sell_date | -|----|------|-----|---------------------| -| 1 | a | 100 | 2013-06-21 10:06:43 | -| 2 | b | 200 | 2013-06-21 13:07:21 | -| 3 | a | 50 | 2013-06-21 13:08:15 | - - - -```javascript -CREATE TABLE a (id INT,name VARCHAR(10),num INT,sell_date DATE); -INSERT INTO a VALUES (1, 'a',100,'2013-06-21 10:06:43'); - -INSERT INTO a VALUES (2, 'b',200,'2013-06-21 13:07:21'); -INSERT INTO a VALUES (3, 'a',50,'2013-06-21 13:08:15'); -``` - - - -1. 依次执行以下命令开始执行事务,将 id 为 3 的的 name 改为 c,并插入一行当前卖出 a 的记录。 - - - - - - -```javascript -obclient> START TRANSACTION; -Query OK, 0 rows affected (0.00 sec) - -obclient> UPDATE a SET name = 'c' WHERE id = 3; -Query OK, 1 rows affected (0.00 sec) -Rows matched: 1 Changed: 1 Warnings: 0 - -obclient> INSERT INTO a VALUES (4, 'a', 30, '2013-06-21 16:09:13'); -Query OK, 1 rows affected (0.00 sec) - -obclient> COMMIT; -Query OK, 0 rows affected (0.00 sec) -``` - - - -2. 事务提交后,执行命令查看表 a 信息。 - - - - - - -```javascript -obclient>SELECT * FROM a; -``` - - - -结果如下: - - -| id | na | num | sell_date | -|----|----|-----|---------------------| -| 1 | a | 100 | 2013-06-21 10:06:43 | -| 2 | b | 200 | 2013-06-21 13:07:21 | -| 3 | c | 50 | 2013-06-21 13:08:15 | -| 4 | a | 30 | 2013-06-21 16:09:13 | - - -**注意** - - - -在事务还没有 `COMMIT` 之前,您可以查看下本事务中的操作是否已经生效,比如可以在 `COMMIT` 前,加一句 `SELECT * FROM a;` 。本事务 Session 的访问能读到最新的结果,本事务 Session 之外的访问结果肯定是没有生效,在事务还没有 `COMMIT` 前,你之前做的操作除当前事务连接之外都是不可见的。如果您想回滚该事务,直接用 `ROOLBACK` 代替 `COMMIT` 。 diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/2.flashback-table-before-drop.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/2.flashback-table-before-drop.md deleted file mode 100644 index 45f4df493..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/2.flashback-table-before-drop.md +++ /dev/null @@ -1,103 +0,0 @@ -FLASHBACK TABLE BEFORE DROP -================================================ - - - -描述 ------------ - -用于从回收站中恢复被删除的表。 - -前置条件 -------------- - -回收站需要处于开启状态,可以通过`SHOW VARIABLES LIKE 'recyclebin';`来查看回收站是否开启。 - -```javascript -obclient>SHOW VARIABLES LIKE 'recyclebin'; -+---------------+-------+ -| Variable_name | Value | -+---------------+-------+ -| recyclebin | ON | -+---------------+-------+ -1 row in set (0.00 sec) -``` - - - -如果回收站处于关闭状态,可以通过`SET RECYCLEBIN = ON;`来开启。回收站中的表没有被实际删除,仍然会占用资源,如果需要彻底删除,可以执行`PURGE RECYCLEBIN;` - -格式 ------------ - -```javascript - FLASHBACK TABLE object_name TO BEFORE DROP [RENAME to db_name.table_name]; -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|-------------|---------------------------------------------------| -| object_name | 指定要恢复的对象名称或表名,只有在表所在的数据库中才能执行。恢复表时,也会同步恢复和表相关的索引。 | -| RENAME to | 修改表名和表所属的库。 | - - - -示例 ------------ - -* 从回收站中恢复被删除的表 t。 - - - - - - -```javascript -obclient>CREATE TABLE t(id INT PRIMARY KEY, k INT); -Query OK, 0 rows affected (0.04 sec) - -obclient>INSERT INTO t VALUES(1,1); -Query OK, 1 row affected (0.00 sec) - -obclient>SELECT * FROM t; -+----+------+ -| id | k | -+----+------+ -| 1 | 1 | -+----+------+ -1 row in set (0.00 sec) - -obclient>DROP TABLE t; -Query OK, 0 rows affected (0.01 sec) - -obclient>SELECT * FROM t; -ORA-00942: table or view 'SYS.T' does not exist - -obclient>SHOW RECYCLEBIN; -+--------------------------------+---------------+-------+----------------------------+ -| OBJECT_NAME | ORIGINAL_NAME | TYPE | CREATETIME | -+--------------------------------+---------------+-------+----------------------------+ -| RECYCLE_$_2_1616038871797032 | T | TABLE | 18-MAR-21 11.41.11.797691 AM| -+--------------------------------+---------------+-------+----------------------------+ -1 row in set (0.00 sec) - -obclient>FLASHBACK TABLE t TO BEFORE DROP; -Query OK, 0 rows affected (0.01 sec) - -obclient>SELECT * FROM t; -+----+------+ -| id | k | -+----+------+ -| 1 | 1 | -+----+------+ -1 row in set (0.00 sec) -``` - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/3.GRANT-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/3.GRANT-1.md deleted file mode 100644 index e162212a0..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/3.GRANT-1.md +++ /dev/null @@ -1,306 +0,0 @@ -GRANT -========================== - - - -描述 ------------ - -该语句用于系统管理员授予 User 某些权限,包括对象权限,系统权限和角色。 -**说明** - - - -* 当授予对象权限时,当前用户必须是对象的所有者,或者拥有被授予的权限(例如,user1 把表 t1 的 SELECT 权限授予 user2,则 user1 必须拥有表 t1 的 SELECT 的权限),并且拥有 GRANT OPTION 权限,才能授予成功。 - - - -* 当授予系统权限和角色时,当前用户必须拥有被授予的权限或角色,并且拥有 GRANT OPTION 权限,才能授予成功。 - - - -* 用户授权后,该用户只有重新连接 OceanBase,权限才能生效。 - - - - - - -格式 ------------ - -```javascript -/*授予对象权限*/ -GRANT obj_with_col_priv_list - ON obj_clause TO grant_user_list [WITH GRANT OPTION]; - -obj_with_col_priv_list: - obj_with_col_priv - | obj_with_col_priv_list, obj_with_col_priv - -obj_with_col_priv: - obj_privilege [column_list] - -obj_privilege: - ALTER - | AUDIT - | COMMENT - | DELETE - | GRANT - | INDEX - | INSERT - | LOCK - | RENAME - | SELECT - | UPDATE - | REFERENCES - | EXECUTE - | CREATE - | FLASHBACK - | READ - | WRITE - | DEBUG - -obj_clause: - relation_name - | relation_name '.' relation_name - | DIRECTORY relation_name - -grant_user_list: - grant_user [, grant_user ...] - -/*授予系统权限*/ -GRANT {system_privilege_list | ALL PRIVILEGES} - TO grantee_user [IDENTIFIED BY password] [WITH {GRANT | ADMID} OPTION]; - -system_privilege_list: - system_privilege [, system_privilege ...] - -system_privilege: - CREATE SESSION - | EXEMPT REDACTION POLICY - | SYSDBA - | SYSOPER - | SYSBACKUP - | CREATE TABLE - | CREATE ANY TABLE - | ALTER ANY TABLE - | BACKUP ANY TABLE - | DROP ANY TABLE - | LOCK ANY TABLE - | COMMENT ANY TABLE - | SELECT ANY TABLE - | INSERT ANY TABLE - | UPDATE ANY TABLE - | DELETE ANY TABLE - | FLASHBACK ANY TABLE - | CREATE ROLE - | DROP ANY ROLE - | GRANT ANY ROLE - | ALTER ANY ROLE - | AUDIT ANY - | GRANT ANY PRIVILEGE - | GRANT ANY OBJECT PRIVILEGE - | CREATE ANY INDEX - | ALTER ANY INDEX - | DROP ANY INDEX - | CREATE ANY VIEW - | DROP ANY VIEW - | CREATE VIEW - | SELECT ANY DICTIONARY - | CREATE PROCEDURE - | CREATE ANY PROCEDURE - | ALTER ANY PROCEDURE - | DROP ANY PROCEDURE - | EXECUTE ANY PROCEDURE - | CREATE SYNONYM - | CREATE ANY SYNONYM - | DROP ANY SYNONYM - | CREATE PUBLIC SYNONYM - | DROP PUBLIC SYNONYM - | CREATE SEQUENCE - | CREATE ANY SEQUENCE - | ALTER ANY SEQUENCE - | DROP ANY SEQUENCE - | SELECT ANY SEQUENCE - | CREATE TRIGGER - | CREATE ANY TRIGGER - | ALTER ANY TRIGGER - | DROP ANY TRIGGER - | CREATE PROFILE - | ALTER PROFILE - | DROP PROFILE - | CREATE USER - | ALTER USER - | DROP USER - | CREATE TYPE - | CREATE ANY TYPE - | ALTER ANY TYPE - | DROP ANY TYPE - | EXECUTE ANY TYPE - | UNDER ANY TYPE - | PURGE DBA_RECYCLEBIN - | CREATE ANY OUTLINE - | ALTER ANY OUTLINE - | DROP ANY OUTLINE - | SYSKM - | CREATE TABLESPACE - | ALTER TABLESPACE - | DROP TABLESPACE - | SHOW PROCESS - | ALTER SYSTEM - | CREATE DATABASE LINK - | CREATE PUBLIC DATABASE LINK - | DROP DATABASE LINK - | ALTER SESSION - | ALTER DATABASE - -/*授予角色*/ -GRANT role_list TO grantee_user [IDENTIFIED BY password] [WITH {GRANT | ADMID} OPTION]; - -role_list: -role [, role ...] -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|-------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| priv_type | 指定授予的权限类型。具体的权限类型及其说明请参见下方权限类型说明表。 同时把多个权限赋予用户时,权限类型用","隔开。 | -| system_privilege | 指定授予的系统权限类型。 同时把多个权限赋予用户时,权限类型用","隔开。 | -| obj_clause | 指定授予权限的层级。权限可以分为以下几个层级: * 全局层级:适用于所有的数据库。 * 数据库层级:适用于一个给定数据库中的所有目标。 * 表层级:表权限适用于一个给定表中的所有列 | -| WITH GRANT OPTION | 指定权限是否允许转授,取消授权时级联。 | -| WITH ADMIN OPTION | 指定权限是否允许转授,取消授权时不级联。 | - - - -可以授予的权限类型如下表所示。 - -**权限类型说明表** - - -| 权限 | 说明 | -|-----------------------------|----------------------------------------| -| ALL PRIVILEGES | 除GRANT OPTION以外所有权限。 | -| ALTER | ALTER TABLE的权限。 | -| CREATE | CREATE TABLE的权限。 | -| DELETE | DELETE的权限。 | -| DROP | DROP的权限。 | -| GRANT OPTION | GRANT OPTION的权限。 | -| INSERT | INSERT的权限。 | -| UPDATE | UPDATE的权限。 | -| SELECT | SELECT的权限。 | -| INDEX | CREATE INDEX, DROP INDEX的权限 | -| SHOW VIEW | SHOW CREATE VIEW权限。 | -| SHOW DATABASES | 全局 SHOW DATABASES的权限。 | -| SUPER | SET GLOBAL修改全局系统参数的权限。 | -| REFERENCES | 创建指向表的约束的权限。 | -| EXECUTE | 执行预处理程序的权限。 | -| FLASHBACK | FLASHBACK的权限。 | -| READ | READ的权限。 | -| WRITE | WRITE的权限。 | -| CREATE SESSION | 连接到数据库的权限。 | -| EXEMPT REDACTION POLICY | 绕过任意现有 REDACTION POLICY 并查看数据的权限。 | -| SYSDBA | SYSDBA的权限。 | -| SYSOPER | SYSOPER的权限。 | -| SYSBACKUP | SYSBACKUP的权限。 | -| CREATE TABLE | 在指定用户SCHEMA内创建表的权限。 | -| CREATE ANY TABLE | 在除SYS外所有用户SCHEMA内创建表的权限。 | -| ALTER ANY TABLE | 在除SYS外所有用户SCHEMA内修改表的权限。 | -| BACKUP ANY TABLE | 在除SYS外所有用户SCHEMA内创建表的权限。 | -| DROP ANY TABLE | 在除SYS外所有用户SCHEMA内备份表的权限。 | -| LOCK ANY TABLE | 在除SYS外所有用户SCHEMA内锁定表的权限。 | -| COMMENT ANY TABLE | 在除SYS外所有用户SCHEMA内评论表的权限。 | -| SELECT ANY TABLE | 在除SYS外所有用户SCHEMA内查看表的权限。 | -| INSERT ANY TABLE | 在除SYS外所有用户SCHEMA内的表插入行的权限。 | -| UPDATE ANY TABLE | 在除SYS外所有用户SCHEMA内的表更新行的权限。 | -| DELETE ANY TABLE | 在除SYS外所有用户SCHEMA内删除表的权限。 | -| FLASHBACK ANY TABLE | 在除SYS外所有用户SCHEMA内FLASHBACK表的权限。 | -| CREATE ROLE | 创建角色的权限。 | -| DROP ANY ROLE | 删除任意角色的权限。 | -| GRANT ANY ROLE | 授予任意角色的权限。 | -| ALTER ANY ROLE | 修改任意角色的权限。 | -| AUDIT ANY | 在除SYS外所有用户SCHEMA内修改对象的权限。 | -| GRANT ANY PRIVILEGE | 授予任意系统权限的权限。 | -| GRANT ANY OBJECT PRIVILEGE | 授予任意对象权限的权限。 | -| CREATE ANY INDEX | 在除SYS外所有用户SCHEMA内创建索引的权限。 | -| ALTER ANY INDEX | 在除SYS外所有用户SCHEMA内修改索引的权限。 | -| DROP ANY INDEX | 在除SYS外所有用户SCHEMA内删除索引的权限。 | -| CREATE ANY VIEW | 在除SYS外所有用户SCHEMA内创建视图的权限。 | -| DROP ANY VIEW | 在除SYS外所有用户SCHEMA内删除索引的权限。 | -| CREATE VIEW | 在指定用户SCHEMA内创建视图的权限。 | -| SELECT ANY DICTIONARY | 在指定用户SCHEMA内查询DICTIONARY的权限。 | -| CREATE PROCEDURE | 在指定用户SCHEMA内创建PROCEDURE的权限。 | -| CREATE ANY PROCEDURE | 在除SYS外所有用户SCHEMA内创建PROCEDURE的权限。 | -| ALTER ANY PROCEDURE | 在除SYS外所有用户SCHEMA内修改PROCEDURE的权限。 | -| DROP ANY PROCEDURE | 在除SYS外所有用户SCHEMA内删除PROCEDURE的权限。 | -| EXECUTE ANY PROCEDURE | 在除SYS外所有用户SCHEMA内执行PROCEDURE的权限。 | -| CREATE SYNONYM | 在指定用户SCHEMA内创建SYNONYM的权限。 | -| CREATE ANY SYNONYM | 在除SYS外所有用户SCHEMA内创建SYNONYM的权限。 | -| DROP ANY SYNONYM | 在除SYS外所有用户SCHEMA内删除SYNONYM的权限。 | -| CREATE PUBLIC SYNONYM | 创建公共SYNONYM的权限。 | -| DROP PUBLIC SYNONYM | 删除公共SYNONYM的权限。 | -| CREATE SEQUENCE | 在指定用户SCHEMA内创建SEQUENCE的权限。 | -| CREATE ANY SEQUENCE | 在除SYS外所有用户SCHEMA内创建SEQUENCE的权限。 | -| ALTER ANY SEQUENCE | 在除SYS外所有用户SCHEMA内修改SEQUENCE的权限。 | -| DROP ANY SEQUENCE | 在除SYS外所有用户SCHEMA内删除SEQUENCE的权限。 | -| SELECT ANY SEQUENCE | 在除SYS外所有用户SCHEMA内查询SEQUENCE的权限。 | -| CREATE TRIGGER | 在指定用户SCHEMA内创建TRIGGER的权限。 | -| CREATE ANY TRIGGER | 在除SYS外所有用户SCHEMA内创建TRIGGER的权限。 | -| ALTER ANY TRIGGER | 在除SYS外所有用户SCHEMA内修改TRIGGER的权限。 | -| DROP ANY TRIGGER | 在除SYS外所有用户SCHEMA内删除TRIGGER的权限。 | -| CREATE PROFILE | 创建PROFILE的权限。 | -| ALTER PROFILE | 修改PROFILE的权限。 | -| DROP PROFILE | 删除PROFILE的权限。 | -| CREATE USER | 创建用户的权限。 | -| ALTER USER | 修改用户的权限。 | -| DROP USER | 删除用户的权限。 | -| CREATE TYPE | 在指定用户SCHEMA内创建TYPE的权限。 | -| CREATE ANY TYPE | 在除SYS外所有用户SCHEMA内创建TYPE的权限。 | -| ALTER ANY TYPE | 在除SYS外所有用户SCHEMA内修改TYPE的权限。 | -| DROP ANY TYPE | 在除SYS外所有用户SCHEMA内删除TYPE的权限。 | -| EXECUTE ANY TYPE | 在除SYS外所有用户SCHEMA内执行TYPE的权限。 | -| UNDER ANY TYPE | 在除SYS外所有用户SCHEMA内TYPE的基础上创建SUBTYPE的权限。 | -| PURGE DBA_RECYCLEBIN | 从系统回收站中删除所有对象的权限。 | -| CREATE ANY OUTLINE | 在除SYS外所有用户SCHEMA内创建OUTLINE的权限。 | -| ALTER ANY OUTLINE | 在除SYS外所有用户SCHEMA内修改OUTLINE的权限。 | -| DROP ANY OUTLINE | 在除SYS外所有用户SCHEMA内删除OUTLINE的权限。 | -| SYSKM | SYSKM的权限。 | -| CREATE TABLESPACE | 创建表空间的权限。 | -| ALTER TABLESPACE | 修改表空间的权限。 | -| DROP TABLESPACE | 删除表空间的权限。 | -| ALTER SYSTEM | ALTER SYSTEM的权限 | -| CREATE DATABASE LINK | 在指定用户SCHEMA内创建DATABASE LINK的权限。 | -| CREATE PUBLIC DATABASE LINK | 创建PUBLIC DATABASE LINK的权限。 | -| DROP DATABASE LINK | 在指定用户SCHEMA内删除DATABASE LINK的权限。 | -| ALTER SESSION | 修改SESSION的权限。 | -| ALTER DATABASE | 修改DATABASE的权限。 | - - - -示例 ------------ - -* 执行以下命令给用户 obsqluser 赋予所有权限。 - - - - - - -```javascript -obclient>GRANT ALL PRIVILEGES TO obsqluser; -Query OK, 0 rows affected (0.03 sec) -``` - - - - - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/4.KILL-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/4.KILL-1.md deleted file mode 100644 index 50d920984..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/4.KILL-1.md +++ /dev/null @@ -1,66 +0,0 @@ -KILL -========================= - - - -描述 ------------ - -该语句用来终止一个会话。 -**说明** - - - -如果您拥有 PROCESS 权限,则您可以查看所有会话。如果您拥有 SUPER 权限,您可以终止所有会话和语句。否则,您只能查看和终止您自己的会话和语句。 - -格式 ------------ - -```javascript -KILL [CONNECTION | QUERY] 'sessionid' -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|-----------------|--------------------------------------| -| KILL | 与 KILL CONNECTION 一样,可终止给定的threadid。 | -| KILL CONNECTION | 与不含修改符的KILL一样,可终止给定的threadid。 | -| KILL QUERY | 可终止连接当前正在执行的语句,但是会保持连接的原状。 | - - - -示例 ------------ - -* 终止 sessionid 为 3221638213 的会话连接当前正在执行的语句后,再终止该会话。 - - - - - - -```javascript -OceanBase(admin@test)>show processlist; -+------------+-------+--------------------+------+---------+------+--------+------------------+ -| Id | User | Host | db | Command | Time | State | Info | -+------------+-------+--------------------+------+---------+------+--------+------------------+ -| 3221638212 | admin | 1.11.111.127:11161 | test | Query | 0 | ACTIVE | show processlist | -| 3221638213 | admin | 1.11.111.127:11161 | test | Query | 0 | ACTIVE | select "abcedfg" | -+------------+-------+--------------------+------+---------+------+--------+------------------+ -1 row in set (0.03 sec) - -OceanBase(admin@test)>kill query 3221638213; -Query OK, 0 rows affected (0.01 sec) - -OceanBase(admin@test)>kill 3221638212; -Query OK, 0 rows affected (0.01 sec) -``` - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/5.REVOKE-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/5.REVOKE-1.md deleted file mode 100644 index 3fb493985..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/5.REVOKE-1.md +++ /dev/null @@ -1,298 +0,0 @@ -REVOKE -=========================== - - - -描述 ------------ - -该语句用于系统管理员撤销 User 的某些权限。 - -使用说明如下: - -* 用户必须拥有被撤销的权限(例如,user1 要撤销 user2 对表 t1 的 SELECT 权限,则 user1 必须拥有表 t1 的 SELECT 的权限),并且拥有 GRANT OPTION 权限。 - - - -* 撤销 ALL PRIVILEGES 和 GRANT OPTION 权限时,当前用户必须拥有全局 GRANT OPTION 权限,或者对权限表的 UPDATE 及 DELETE 权限。 - - - -* 当权限没有 GRANT OPTION 时,撤销操作不会级联。例如,用户 user1 给 user2 授予了某些权限,撤回 user1 的权限不会同时也撤回 user2 的相应权限。当拥有 GRANT OPTION 时,撤销操作会级联。 - - - - - - -格式 ------------ - -```javascript -/*撤销对象权限*/ -REVOKE obj_privileges - ON obj_clause FROM user_list; - -user_list: - user [, user ...] - -obj_privileges: - obj_privilege [, obj_privilege ...] - -obj_privilege: - ALTER - | AUDIT - | COMMENT - | DELETE - | GRANT - | INDEX - | INSERT - | LOCK - | RENAME - | SELECT - | UPDATE - | REFERENCES - | EXECUTE - | CREATE - | FLASHBACK - | READ - | WRITE - | DEBUG - -obj_clause: - relation_name - | relation_name '.' relation_name - | DIRECTORY relation_name - -relation_name: - STR_VALUE - -/*撤销系统权限*/ -REVOKE {system_privilege_list | ALL PRIVILEGES} - FROM user_list; -REVOKE ALL [PRIVILEGES], GRANT_OPTION FROM user_list; - -system_privilege_list: - system_privilege [, system_privilege ...] - -system_privilege: - CREATE SESSION - | EXEMPT REDACTION POLICY - | SYSDBA - | SYSOPER - | SYSBACKUP - | CREATE TABLE - | CREATE ANY TABLE - | ALTER ANY TABLE - | BACKUP ANY TABLE - | DROP ANY TABLE - | LOCK ANY TABLE - | COMMENT ANY TABLE - | SELECT ANY TABLE - | INSERT ANY TABLE - | UPDATE ANY TABLE - | DELETE ANY TABLE - | FLASHBACK ANY TABLE - | CREATE ROLE - | DROP ANY ROLE - | GRANT ANY ROLE - | ALTER ANY ROLE - | AUDIT ANY - | GRANT ANY PRIVILEGE - | GRANT ANY OBJECT PRIVILEGE - | CREATE ANY INDEX - | ALTER ANY INDEX - | DROP ANY INDEX - | CREATE ANY VIEW - | DROP ANY VIEW - | CREATE VIEW - | SELECT ANY DICTIONARY - | CREATE PROCEDURE - | CREATE ANY PROCEDURE - | ALTER ANY PROCEDURE - | DROP ANY PROCEDURE - | EXECUTE ANY PROCEDURE - | CREATE SYNONYM - | CREATE ANY SYNONYM - | DROP ANY SYNONYM - | CREATE PUBLIC SYNONYM - | DROP PUBLIC SYNONYM - | CREATE SEQUENCE - | CREATE ANY SEQUENCE - | ALTER ANY SEQUENCE - | DROP ANY SEQUENCE - | SELECT ANY SEQUENCE - | CREATE TRIGGER - | CREATE ANY TRIGGER - | ALTER ANY TRIGGER - | DROP ANY TRIGGER - | CREATE PROFILE - | ALTER PROFILE - | DROP PROFILE - | CREATE USER - | ALTER USER - | DROP USER - | CREATE TYPE - | CREATE ANY TYPE - | ALTER ANY TYPE - | DROP ANY TYPE - | EXECUTE ANY TYPE - | UNDER ANY TYPE - | PURGE DBA_RECYCLEBIN - | CREATE ANY OUTLINE - | ALTER ANY OUTLINE - | DROP ANY OUTLINE - | SYSKM - | CREATE TABLESPACE - | ALTER TABLESPACE - | DROP TABLESPACE - | SHOW PROCESS - | ALTER SYSTEM - | CREATE DATABASE LINK - | CREATE PUBLIC DATABASE LINK - | DROP DATABASE LINK - | ALTER SESSION - | ALTER DATABASE - -/*撤销角色*/ -REVOKE role_list FROM user; - -role_list: -role [, role ...] -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| obj_privileges | 指定撤销的对象权限类型。具体的权限类型及其说明请参见下方权限类型说明表。 同时撤销多个权限时,权限类型用","隔开。 | -| system_privilege | 指定撤销的系统权限类型。 同时撤销多个权限时,权限类型用","隔开。 | -| obj_clause | 指定撤销权限的层级,relation_name指定具体对象的名称。权限可以分为以下几个层级: * 全局层级:适用于所有的数据库。 * 数据库层级:适用于一个给定数据库中的所有目标。 * 表层级:表权限适用于一个给定表中的所有列。 | - - - -可以撤销的权限类型如下表所示。 - -**权限类型说明表** - - -| 权限 | 说明 | -|-----------------------------|----------------------------------------| -| ALL PRIVILEGES | 除GRANT OPTION以外所有权限。 | -| ALTER | ALTER TABLE的权限。 | -| CREATE | CREATE TABLE的权限。 | -| DELETE | DELETE的权限。 | -| DROP | DROP的权限。 | -| GRANT OPTION | GRANT OPTION的权限。 | -| INSERT | INSERT的权限。 | -| UPDATE | UPDATE的权限。 | -| SELECT | SELECT的权限。 | -| INDEX | CREATE INDEX, DROP INDEX的权限 | -| SHOW VIEW | SHOW CREATE VIEW权限。 | -| SHOW DATABASES | 全局 SHOW DATABASES的权限。 | -| SUPER | SET GLOBAL修改全局系统参数的权限。 | -| REFERENCES | 创建指向表的约束的权限。 | -| EXECUTE | 执行预处理程序的权限。 | -| FLASHBACK | FLASHBACK的权限。 | -| READ | READ的权限。 | -| WRITE | WRITE的权限。 | -| CREATE SESSION | 连接到数据库的权限。 | -| EXEMPT REDACTION POLICY | 绕过任意现有 REDACTION POLICY 并查看数据的权限。 | -| SYSDBA | SYSDBA的权限。 | -| SYSOPER | SYSOPER的权限。 | -| SYSBACKUP | SYSBACKUP的权限。 | -| CREATE TABLE | 在指定用户SCHEMA内创建表的权限。 | -| CREATE ANY TABLE | 在除SYS外所有用户SCHEMA内创建表的权限。 | -| ALTER ANY TABLE | 在除SYS外所有用户SCHEMA内修改表的权限。 | -| BACKUP ANY TABLE | 在除SYS外所有用户SCHEMA内创建表的权限。 | -| DROP ANY TABLE | 在除SYS外所有用户SCHEMA内备份表的权限。 | -| LOCK ANY TABLE | 在除SYS外所有用户SCHEMA内锁定表的权限。 | -| COMMENT ANY TABLE | 在除SYS外所有用户SCHEMA内评论表的权限。 | -| SELECT ANY TABLE | 在除SYS外所有用户SCHEMA内查看表的权限。 | -| INSERT ANY TABLE | 在除SYS外所有用户SCHEMA内的表插入行的权限。 | -| UPDATE ANY TABLE | 在除SYS外所有用户SCHEMA内的表更新行的权限。 | -| DELETE ANY TABLE | 在除SYS外所有用户SCHEMA内删除表的权限。 | -| FLASHBACK ANY TABLE | 在除SYS外所有用户SCHEMA内FLASHBACK表的权限。 | -| CREATE ROLE | 创建角色的权限。 | -| DROP ANY ROLE | 删除任意角色的权限。 | -| GRANT ANY ROLE | 授予任意角色的权限。 | -| ALTER ANY ROLE | 修改任意角色的权限。 | -| AUDIT ANY | 在除SYS外所有用户SCHEMA内修改对象的权限。 | -| GRANT ANY PRIVILEGE | 授予任意系统权限的权限。 | -| GRANT ANY OBJECT PRIVILEGE | 授予任意对象权限的权限。 | -| CREATE ANY INDEX | 在除SYS外所有用户SCHEMA内创建索引的权限。 | -| ALTER ANY INDEX | 在除SYS外所有用户SCHEMA内修改索引的权限。 | -| DROP ANY INDEX | 在除SYS外所有用户SCHEMA内删除索引的权限。 | -| CREATE ANY VIEW | 在除SYS外所有用户SCHEMA内创建视图的权限。 | -| DROP ANY VIEW | 在除SYS外所有用户SCHEMA内删除索引的权限。 | -| CREATE VIEW | 在指定用户SCHEMA内创建视图的权限。 | -| SELECT ANY DICTIONARY | 在指定用户SCHEMA内查询DICTIONARY的权限。 | -| CREATE PROCEDURE | 在指定用户SCHEMA内创建PROCEDURE的权限。 | -| CREATE ANY PROCEDURE | 在除SYS外所有用户SCHEMA内创建PROCEDURE的权限。 | -| ALTER ANY PROCEDURE | 在除SYS外所有用户SCHEMA内修改PROCEDURE的权限。 | -| DROP ANY PROCEDURE | 在除SYS外所有用户SCHEMA内删除PROCEDURE的权限。 | -| EXECUTE ANY PROCEDURE | 在除SYS外所有用户SCHEMA内执行PROCEDURE的权限。 | -| CREATE SYNONYM | 在指定用户SCHEMA内创建SYNONYM的权限。 | -| CREATE ANY SYNONYM | 在除SYS外所有用户SCHEMA内创建SYNONYM的权限。 | -| DROP ANY SYNONYM | 在除SYS外所有用户SCHEMA内删除SYNONYM的权限。 | -| CREATE PUBLIC SYNONYM | 创建公共SYNONYM的权限。 | -| DROP PUBLIC SYNONYM | 删除公共SYNONYM的权限。 | -| CREATE SEQUENCE | 在指定用户SCHEMA内创建SEQUENCE的权限。 | -| CREATE ANY SEQUENCE | 在除SYS外所有用户SCHEMA内创建SEQUENCE的权限。 | -| ALTER ANY SEQUENCE | 在除SYS外所有用户SCHEMA内修改SEQUENCE的权限。 | -| DROP ANY SEQUENCE | 在除SYS外所有用户SCHEMA内删除SEQUENCE的权限。 | -| SELECT ANY SEQUENCE | 在除SYS外所有用户SCHEMA内查询SEQUENCE的权限。 | -| CREATE TRIGGER | 在指定用户SCHEMA内创建TRIGGER的权限。 | -| CREATE ANY TRIGGER | 在除SYS外所有用户SCHEMA内创建TRIGGER的权限。 | -| ALTER ANY TRIGGER | 在除SYS外所有用户SCHEMA内修改TRIGGER的权限。 | -| DROP ANY TRIGGER | 在除SYS外所有用户SCHEMA内删除TRIGGER的权限。 | -| CREATE PROFILE | 创建PROFILE的权限。 | -| ALTER PROFILE | 修改PROFILE的权限。 | -| DROP PROFILE | 删除PROFILE的权限。 | -| CREATE USER | 创建用户的权限。 | -| ALTER USER | 修改用户的权限。 | -| DROP USER | 删除用户的权限。 | -| CREATE TYPE | 在指定用户SCHEMA内创建TYPE的权限。 | -| CREATE ANY TYPE | 在除SYS外所有用户SCHEMA内创建TYPE的权限。 | -| ALTER ANY TYPE | 在除SYS外所有用户SCHEMA内修改TYPE的权限。 | -| DROP ANY TYPE | 在除SYS外所有用户SCHEMA内删除TYPE的权限。 | -| EXECUTE ANY TYPE | 在除SYS外所有用户SCHEMA内执行TYPE的权限。 | -| UNDER ANY TYPE | 在除SYS外所有用户SCHEMA内TYPE的基础上创建SUBTYPE的权限。 | -| PURGE DBA_RECYCLEBIN | 从系统回收站中删除所有对象的权限。 | -| CREATE ANY OUTLINE | 在除SYS外所有用户SCHEMA内创建OUTLINE的权限。 | -| ALTER ANY OUTLINE | 在除SYS外所有用户SCHEMA内修改OUTLINE的权限。 | -| DROP ANY OUTLINE | 在除SYS外所有用户SCHEMA内删除OUTLINE的权限。 | -| SYSKM | SYSKM的权限。 | -| CREATE TABLESPACE | 创建表空间的权限。 | -| ALTER TABLESPACE | 修改表空间的权限。 | -| DROP TABLESPACE | 删除表空间的权限。 | -| ALTER SYSTEM | ALTER SYSTEM的权限 | -| CREATE DATABASE LINK | 在指定用户SCHEMA内创建DATABASE LINK的权限。 | -| CREATE PUBLIC DATABASE LINK | 创建PUBLIC DATABASE LINK的权限。 | -| DROP DATABASE LINK | 在指定用户SCHEMA内删除DATABASE LINK的权限。 | -| ALTER SESSION | 修改SESSION的权限。 | -| ALTER DATABASE | 修改DATABASE的权限。 | - - - -示例 ------------ - -执行以下命令撤销用户 obsqluser 的所有权限。 - -```javascript -obclient>REVOKE ALL PRIVILEGES FROM sqluser; -Query OK, 0 rows affected (0.10 sec) -``` - - - - - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/6.SAVEPOINT-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/6.SAVEPOINT-1.md deleted file mode 100644 index f2c673aad..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/6.SAVEPOINT-1.md +++ /dev/null @@ -1,135 +0,0 @@ -SAVEPOINT -============================== - - - -描述 ------------ - -`SAVEPOINT`语句用来实现事务的部分回滚。 - -格式 ------------ - -* 创建`SAVEPOINT`: - - - - - - -```javascript -SAVEPOINT spname -``` - - - -* 回滚到`SAVEPOINT`: - - - - - - -```javascript -ROLLBACK [WORK] to [SAVEPOINT] spname -``` - - - -参数说明 -------------- - - - -| 参数 | 描述 | -|--------|-------------------------------------------------------------------------------------------------------------------------------------| -| spname | 指定`SAVEPOINT`的名称`SAVEPOINT`是事务范围内唯一的,一个`SAVEPOINT`会覆盖前一个同名的`SAVEPOINT`。创建`SAVEPOINT`后可以将事务回滚到指定`SAVEPOINT`,也可以使用`ROLLBACK`语句回滚整个事务。 | - - - -示例 ------------ - -假设一个事务执行了如下语句: - - -| **sql_no** | **语句** | **分区** | -|------------|---------------|------------| -| 1 | update... | p1, p4 | -| | savepoint sp1 | | -| 2 | update... | p2, p4 | -| 3 | update... | p3, p5 | -| | savepoint sp2 | | -| 4 | update... | p1, p3, p6 | -| 5 | update... | p1, p5 | -| | savepoint sp3 | | -| 6 | select... | | -| 7 | update... | p5, p6 | -| | savepoint sp4 | | - - - -#### 记录 Savepoint - -用户在提交事务之前可以创建`SAVEPOINT`,需要根据`SAVEPOINT`创建的顺序,将事务的`SAVEPOINT`串成链表。以上事务包含了 7 条 SQL 和 4 个`SAVEPOINT`,记录`SAVEPOINT`的链表如下图所示,其中每个节点记录了``的映射关系: - -![image.png](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/7455055061/p179258.png "image.png") - -#### 事务参与者列表 - -事务为了支持回滚某条 SQL 之后的所有修改,需要将每条语句涉及的参与者以及对应的 `sql_no` 记录下来,以上事务执行了 7 条 SQL,涉及 p1\~p6 共 6 个分区: - -![image.png](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/7455055061/p179259.png "image.png") - -#### Savepoint 回滚过程 - -1. 根据`SAVEPOINT`链表查询`spname`对应的`sql_no` - - 假设用户执行`ROLLBACK to SAVEPOINT sp2`,根据savepoint链表查询到 sp2 对应的`sql_no`为 3。 - - - - - - - -2. 根据事务参与者列表查询`sql_no`对应的分区 - - 根据事务参与者列表查询到`sql_no`大于 3 的语句操作的分区涉及 p1、p3、p5、p6。 - - - - - - - -3. 回滚分区数据 - - 根据第 2 步查询到的分区,调度程序向这些分区发起回滚请求,回滚当前事务在这些分区上 sp2 之后的所有修改。其中 p1、p3、p5 上关于本事务的部分修改被回滚掉,p6 上关于本事务的所有修改都被回滚掉。 - - - - - - - -4. 更新事务参与者列表信息 - - 修改事务参与者列表,将`sql_no`大于 3 的操作信息从事务参与者列表中删除,由于 p6上的所有修改都被回滚掉,因此 p6 可以从参与者列表中删除。 - - - - - -![image.png](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/7455055061/p179260.png "image.png") - -5. 删除无效的 Savepoint - - 用户执行`ROLLBACK to SAVEPOINT sp2`成功后,系统会删除 sp3 和 sp4 的`SAVEPOINT`,不允许再回滚到 sp3 和 sp4。 - - - - - -![image.png](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/7455055061/p179261.png "image.png") diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/7.set-names.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/7.set-names.md deleted file mode 100644 index 930906429..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/7.set-names.md +++ /dev/null @@ -1,92 +0,0 @@ -SET NAMES -============================== - - - -描述 ------------ - -该语句用来设置当前连接的数据库的字符集编码。 - -格式 ------------ - -```javascript -SET NAMES 'charset_name' [COLLATE 'collation_name'] -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|----------------|------------------------------| -| charset_name | 指定字符集 | -| collation_name | 指定字符集排序规则。如未指定,则使用字符集默认排序规则。 | - - -**说明** - - - -该语句将三个会话系统变量 `character_set_client` , `character_set_connection` 和 `character_set_results` 设置为给定的字符集。将 `character_set_connection` 设置为 `charset_name` ,将 `collation_connection` 设置为 `charset_name` 的默认排序规则。 - -示例 ------------ - -* 设置数据库的字符集和排序规则。 - - - - - - -```javascript -OceanBase(admin@test)>SET NAMES 'utf8mb4' COLLATE 'utf8mb4_general_ci'; -Query OK, 0 rows affected (0.00 sec) - -OceanBase(admin@test)>show variables like 'character_set_c%'; -+--------------------------+---------+ -| Variable_name | Value | -+--------------------------+---------+ -| character_set_client | utf8mb4 | -| character_set_connection | utf8mb4 | -+--------------------------+---------+ -2 rows in set (0.01 sec) - -OceanBase(admin@test)>show variables like 'collation_connection'; -+----------------------+--------------------+ -| Variable_name | Value | -+----------------------+--------------------+ -| collation_connection | utf8mb4_general_ci | -+----------------------+--------------------+ -1 row in set (0.05 sec) - - -OceanBase(admin@test)>SET NAMES 'gbk'; -Query OK, 0 rows affected (0.02 sec) - -OceanBase(admin@test)>show variables like 'character_set_c%'; -+--------------------------+-------+ -| Variable_name | Value | -+--------------------------+-------+ -| character_set_client | gbk | -| character_set_connection | gbk | -+--------------------------+-------+ -2 rows in set (0.01 sec) - - -OceanBase(admin@test)>show variables like 'collation_connection'; -+----------------------+----------------+ -| Variable_name | Value | -+----------------------+----------------+ -| collation_connection | gbk_chinese_ci | -+----------------------+----------------+ -1 row in set (0.01 sec) -``` - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/8.set-password-1.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/8.set-password-1.md deleted file mode 100644 index b4171e97a..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/8.set-password-1.md +++ /dev/null @@ -1,53 +0,0 @@ -SET PASSWORD -================================= - - - -描述 ------------ - -该语句用于修改 OceanBase 当前登录用户或其他用户的密码。 - -格式 ------------ - -```javascript -SET PASSWORD [FOR user] = PASSWORD(password); -ALTER USER user IDENTIFIED BY password; - -password: - STR_VALUE -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|----------|--------------------------------------------------------------------------------------------------------------------------------------| -| FOR user | 如果没有 For user 子句,表示修改当前用户的密码。任何成功登录的用户都可以修改当前用户的密码。 如果有 For user 子句,表示修改指定用户的密码。必须拥有 CREATE USER 的系统权限,才可以修改指定用户的密码。 | - - - -示例 ------------ - -* 执行以下命令将 sqluser 用户的密码修改为 abc123。 - - - - - - -```javascript -oceanBase(admin@TEST)>SET PASSWORD for sqluser = PASSWORD(abc123); -Query OK, 0 rows affected (0.02 sec) -``` - - - - - diff --git a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/9.set-variable.md b/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/9.set-variable.md deleted file mode 100644 index 8ef0500ca..000000000 --- a/docs/docs/docs-cn/11.sql-reference-oracle-mode/9.sql-statement-1/3.DCL/9.set-variable.md +++ /dev/null @@ -1,53 +0,0 @@ -SET VARIABLE -================================= - - - -描述 ------------ - -该语句用来设置用户自定义和系统定义的 session 变量。 - -格式 ------------ - -```javascript -SET var1_name = var1_value, var2_name = var2_value, ...; -``` - - - -参数解释 -------------- - - - -| 参数 | 描述 | -|-----------|---------------------------------------------------| -| var1_name | 指定要设置的变量,可以是用户自定义的变量,也可以是系统变量。如果要设置多个变量,中间用 , 分隔。 | - - - -示例 ------------ - -```javascript -OceanBase(TEST@TEST)>set @a = 1, @b = 2, @c = 3; -Query OK, 0 rows affected (0.02 sec) - -OceanBase(TEST@TEST)>set @@tx_isolation = 'read-what'; -ORA-00600: internal error code, arguments: -5145, Variable 'tx_isolation' can't be set to the value of 'read-what' - -OceanBase(TEST@TEST)>set @@tx_isolation = 'read-committed'; -Query OK, 0 rows affected (0.01 sec) - -OceanBase(TEST@TEST)>select @a,@b,@c,@@tx_isolation from dual; -+------+------+------+----------------+ -| @A | @B | @C | @@TX_ISOLATION | -+------+------+------+----------------+ -| 1 | 2 | 3 | read-committed | -+------+------+------+----------------+ -1 row in set (0.01 sec) -``` - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/1.ALL_ALL_TABLES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/1.ALL_ALL_TABLES.md deleted file mode 100644 index 4f52ed4f1..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/1.ALL_ALL_TABLES.md +++ /dev/null @@ -1,92 +0,0 @@ -ALL_ALL_TABLES -=================================== - - - -功能 ------------ - -查看用户可访问的对象表和关系表,与 ALL_TABLES 不同,ALL_ALL_TABLES 能够查询到对象表。 - -相关视图 -------------- - -* DBA_ALL_TABLES - - - -* USER_ALL_TABLES - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|---------------------------|---------------|----------------|---------------------------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 表的拥有者 | -| TABLE_NAME | VARCHAR2(128) | NO | 表名 | -| TABLESPACE_NAME | VARCHAR2(30) | NO | 包含该表的表空间名字 | -| CLUSTER_NAME | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| IOT_NAME | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| STATUS | VARCHAR2(8) | NO | 表状态: * VALID * UNUSABLE | -| PCT_FREE | NUMBER | NO | 块的最小空闲空间比例 | -| PCT_USED | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INI_TRANS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_TRANS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INITIAL_EXTENT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NEXT_EXTENT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MIN_EXTENTS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_EXTENTS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| PCT_INCREASE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| FREELISTS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| FREELIST_GROUPS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| LOGGING | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| BACKED_UP | VARCHAR2(1) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NUM_ROWS | NUMBER | NO | 表行数 | -| BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| EMPTY_BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_SPACE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CHAIN_CNT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_ROW_LEN | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_SPACE_FREELIST_BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NUM_FREELIST_BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEGREE | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INSTANCES | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CACHE | VARCHAR2(20) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| TABLE_LOCK | VARCHAR2(8) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| SAMPLE_SIZE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| LAST_ANALYZED | DATE | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| PARTITIONED | VARCHAR2(3) | NO | 指定表是否是分区: * YES * NO | -| IOT_TYPE | VARCHAR2(12) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| OBJECT_ID_TYPE | VARCHAR2(16) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| TABLE_TYPE_OWNER | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| TABLE_TYPE | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| TEMPORARY | VARCHAR2(1) | NO | 指定表是否是临时表 | -| SECONDARY | VARCHAR2(1) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NESTED | VARCHAR2(3) | NO | 指定表是否是嵌套表 * YES * NO | -| BUFFER_POOL | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CELL_FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| ROW_MOVEMENT | VARCHAR2(8) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| GLOBAL_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| USER_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DURATION | VARCHAR2(15) | NO | 指示临时表的持续时间 | -| SKIP_CORRUPT | VARCHAR2(8) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MONITORING | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CLUSTER_OWNER | VARCHAR2(30) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEPENDENCIES | VARCHAR2(8) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| COMPRESSION | VARCHAR2(8) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| COMPRESS_FOR | VARCHAR2(12) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DROPPED | VARCHAR2(3) | NO | 表示被删除表是否在回收站里 | -| READ_ONLY | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| SEGMENT_CREATED | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| RESULT_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/10.ALL_INDEXES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/10.ALL_INDEXES.md deleted file mode 100644 index 092c8c1bd..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/10.ALL_INDEXES.md +++ /dev/null @@ -1,92 +0,0 @@ -ALL_INDEXES -================================ - - - -功能 ------------ - -ALL_INDEXES 用于查看用户可访问的所有表的索引的索引列信息。 - -相关视图 -------------- - -* USER_INDEXES - - - -* DBA_INDEXES - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-------------------------|----------------|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 索引所属的拥有者。 | -| INDEX_NAME | VARCHAR2(128) | NO | 索引名字。 | -| INDEX_TYPE | VARCHAR2(27) | NO | 索引的类型。 | -| TABLE_OWNER | VARCHAR2(128) | NO | 被索引对象的拥有者。 | -| TABLE_NAME | VARCHAR2(128) | NO | 被索引对象的名字。 | -| TABLE_TYPE | CHAR(5) | NO | 被索引对象的类型。 | -| UNIQUENESS | VARCHAR2(9) | NO | 表示索引是否是唯一的(UNIQUE)或不唯一的。 | -| COMPRESSION | VARCHAR2(8) | NO | 表示索引是否是被压缩的。 | -| PREFIX_LENGTH | NUMBER | NO | 表示在压缩索引中的前缀列数量。目前暂不支持该字段,当前该字段显示为 NULL | -| TABLESPACE_NAME | VARCHAR2(30) | NO | 索引所在的表空间名。 | -| INI_TRANS | NUMBER | NO | 表示初始事务数量。目前暂不支持该字段,当前该字段显示为 NULL。 | -| MAX_TRANS | NUMBER | NO | 表示最大事务数量。目前暂不支持该字段,当前该字段显示为 NULL。 | -| INITIAL_EXTENT | NUMBER | NO | 表示初始 extent 大小。目前暂不支持该字段,当前该字段显示为 NULL。 | -| NEXT_EXTENT | NUMBER | NO | 表示第二 extent 大小。目前暂不支持该字段,当前该字段显示为 NULL | -| MIN_EXTENTS | NUMBER | NO | 表示在段里允许的最小 extent 数量。目前暂不支持该字段,当前该字段显示为 NULL。 | -| MAX_EXTENTS | NUMBER | NO | 表示在段里允许的最大 extent 数量。目前暂不支持该字段,当前该字段显示为 NULL。 | -| PCT_INCREASE | NUMBER | NO | 表示 extent 大小的增长率。目前暂不支持该字段,当前该字段显示为 NULL。 | -| PCT_THRESHOLD | NUMBER | NO | 表示每个索引被允许占用的块空间百分比。目前暂不支持该字段,当前该字段显示为 NULL。 | -| INCLUDE_COLUMN | NUMBER | NO | 表示索引组织表的主键的最后一列的列编号。目前暂不支持该字段,当前该字段显示为 NULL。 | -| FREELISTS | NUMBER | NO | 表示被分配各段的进程 freelist 数量。目前暂不支持该字段,当前该字段显示为 NULL。 | -| FREELIST_GROUPS | NUMBER | NO | 表示被分配各段的 freelist 组数量。目前暂不支持该字段,当前该字段显示为 NULL。 | -| PCT_FREE | NUMBER | NO | 表示块中空余空间的最小百分比。目前暂不支持该字段,当前该字段显示为 NULL | -| LOGGING | VARCHAR2(3) | NO | 表示对索引的修改是否被记录了日志。目前暂不支持该字段,当前该字段显示为 NULL。 | -| BLEVEL | NUMBER | NO | 表示 B\*-Tree 的深度。目前暂不支持该字段,当前该字段显示为 NULL。 | -| LEAF_BLOCKS | NUMBER | NO | 表示索引中叶子块的数量。目前暂不支持该字段,当前该字段显示为 NULL。 | -| DISTINCT_KEYS | NUMBER | NO | 表示不同索引值的数量。目前暂不支持该字段,当前该字段显示为 NULL。 | -| AVG_LEAF_BLOCKS_PER_KEY | NUMBER | NO | 表示出现索引中每个不同值的叶块的平均数目,四舍五入到最接近的整数。对于具有 UNIQUE 和 PRIMARY KEY 约束的索引,此值始终为 1。目前暂不支持该字段,当前该字段显示为 NULL。 | -| AVG_DATA_BLOCKS_PER_KEY | NUMBER | NO | 表示表中由索引中不同值四舍五入到最接近的整数所指向的平均数据块数。此统计信息是包含行的数据块的平均数量,这些行包含给定索引列的给定值。目前暂不支持该字段,当前该字段显示为 NULL。 | -| CLUSTERING_FACTOR | NUMBER | NO | 指示基于索引值的表中行的数量。 如果该值接近块数,则表的顺序非常好。在这种情况下,单个叶块中的索引条目往往指向同一数据块中的行。 如果该值接近行数,则表是非常随机的。在这种情况下,同一叶块中的索引条目不太可能指向同一数据块中的行。目前暂不支持该字段,当前该字段显示为 NULL。 | -| STATUS | VARCHAR2(10) | NO | 指示未分区的索引是 VALID 还是 UNUSABLE。 | -| NUM_ROWS | NUMBER | NO | 表示索引中的行数。目前暂不支持该字段,当前该字段显示为 NULL。 | -| SAMPLE_SIZE | NUMBER | NO | 表示用于分析指标的样本大小。目前暂不支持该字段,当前该字段显示为 NULL。 | -| LAST_ANALYZED | DATE | NO | 最近分析该指数的日期。目前暂不支持该字段,当前该字段显示为 NULL。 | -| DEGREE | VARCHAR2(40) | NO | 表示每个实例用于扫描索引的线程数。目前暂不支持该字段,当前该字段显示为 NULL。 | -| INSTANCES | VARCHAR2(40) | NO | 表示要扫描索引的实例数。目前暂不支持该字段,当前该字段显示为 NULL。 | -| PARTITIONED | VARCHAR2(3) | NO | 表示索引是否是分区。 | -| TEMPORARY | VARCHAR2(1) | NO | 表示索引是否在临时表上。目前暂不支持该字段,当前该字段显示为 NULL。 | -| GENERATED | VARCHAR2(1) | NO | 指示索引的名称是系统生成的。目前暂不支持该字段,当前该字段显示为 NULL。 | -| SECONDARY | VARCHAR2(1) | NO | 指示索引是否是辅助对象。目前暂不支持该字段,当前该字段显示为 NULL。 | -| BUFFER_POOL | VARCHAR2(7) | NO | 用于索引块的默认缓冲池的名称。目前暂不支持该字段,当前该字段显示为 NULL。 | -| FLASH_CACHE | VARCHAR2(7) | NO | 用于索引块的数据库智能闪存缓存。目前暂不支持该字段,当前该字段显示为 NULL。 | -| CELL_FLASH_CACHE | VARCHAR2(7) | NO | 用于索引块的单元闪存缓存。目前暂不支持该字段,当前该字段显示为 NULL。 | -| USER_STATS | VARCHAR2(3) | NO | 是否由用户直接输入统计信息。目前暂不支持该字段,当前该字段显示为 NULL。 | -| DURATION | VARCHAR2(15) | NO | 指示临时表的持续时间: * SYS $ SESSION:在会话期间将保留行 * SYS $ TRANSACTION:在COMMIT 之后删除行 目前暂不支持该字段,当前该字段显示为 NULL。 | -| PCT_DIRECT_ACCESS | NUMBER | NO | 对于索引组织的表上的二级索引,具有 VALID 猜测的行的百分比。目前暂不支持该字段,当前该字段显示为 NULL。 | -| ITYP_OWNER | VARCHAR2(30) | NO | 域索引的索引类型的所有者。目前暂不支持该字段,当前该字段显示为 NULL。 | -| ITYP_NAME | VARCHAR2(30) | NO | 域索引的索引类型名称。目前暂不支持该字段,当前该字段显示为 NULL。 | -| PARAMETERS | VARCHAR2(1000) | NO | 域索引的参数字符串。目前暂不支持该字段,当前该字段显示为 NULL。 | -| GLOBAL_STATS | VARCHAR2(3) | NO | 对于分区索引,指定是通过整体分析索引收集统计信息,还是从基础索引分区和子分区的统计信息中估算统计信息。目前暂不支持该字段,当前该字段显示为 NULL。 | -| DOMIDX_STATUS | VARCHAR2(12) | NO | 表示域索引的状态。目前暂不支持该字段,当前该字段显示为 NULL。 | -| DOMIDX_OPSTATUS | VARCHAR2(6) | NO | 表示域索引上的操作状态。目前暂不支持该字段,当前该字段显示为 NULL。 | -| FUNCIDX_STATUS | VARCHAR2(8) | NO | 基于函数的索引的状态。 | -| JOIN_INDEX | VARCHAR2(3) | NO | 指示索引是否为联接索引。 | -| IOT_REDUNDANT_PKEY_ELIM | VARCHAR2(3) | NO | 指示是否从索引组织表的二级索引中消除了冗余主键列。目前暂不支持该字段,当前该字段显示为 NULL。 | -| DROPPED | VARCHAR2(9) | NO | 表示索引是否被删除并进了回收站。 | -| VISIBILITY | VARCHAR2(10) | NO | 表示索引对优化器是否可见。 | -| DOMIDX_MANAGEMENT | VARCHAR2(14) | NO | 表示域索引是由系统管理还是用户管理。目前暂不支持该字段,当前该字段显示为 NULL。 | -| SEGMENT_CREATED | VARCHAR2(3) | NO | 指示是否已创建索引段。目前暂不支持该字段,当前该字段显示为 NULL。 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/100.DBA_RSRC_PLANS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/100.DBA_RSRC_PLANS.md deleted file mode 100644 index 28e7cefb7..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/100.DBA_RSRC_PLANS.md +++ /dev/null @@ -1,46 +0,0 @@ -DBA_RSRC_PLANS -=================================== - - - -功能 ------------------------ - -`DBA_RSRC_PLANS` 视图用于记录系统定义的所有资源管理计划。 - -相关视图 -------------------------- - -* `DBA_RSRC_PLAN_DIRECTIVES` - - - -* `V$RSRC_PLAN` - - - - - - -字段说明 -------------------------- - - - -| 字段名称 | 类型 | 是否可以为 NULL | 描述 | -|---------------------------|----------------|------------|----------------------------------------------------| -| PLAN_ID | NUMBER | NO | 资源计划的 ID。 | -| PLAN | VARCHAR2(128) | NO | 资源计划名。 | -| NUM_PLAN_DIRECTIVES | NUMBER | NO | 当前资源计划定义的指令数。 仅用于兼容,目前值固定为 `NULL`。 | -| CPU_METHOD | VARCHAR2(128) | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| MGMT_METHOD | VARCHAR2(128) | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| ACTIVE_SESS_POOL_MTH | VARCHAR2(128) | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| PARALLEL_DEGREE_LIMIT_MTH | VARCHAR2(128) | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| QUEUING_MTH | VARCHAR2(128) | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| SUB_PLAN | VARCHAR2(3) | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| COMMENTS | VARCHAR2(2000) | YES | 资源计划的备注信息。 | -| STATUS | VARCHAR2(128) | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| MANDATORY | VARCHAR2(3) | NO | 仅用于兼容,目前值固定为 `NULL`。 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/101.DBA_RSRC_PLAN_DIRECTIVES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/101.DBA_RSRC_PLAN_DIRECTIVES.md deleted file mode 100644 index e4e52dd40..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/101.DBA_RSRC_PLAN_DIRECTIVES.md +++ /dev/null @@ -1,79 +0,0 @@ -DBA_RSRC_PLAN_DIRECTIVES -============================================= - - - -功能 ------------------------ - -`DBA_RSRC_PLAN_DIRECTIVES` 视图用于记录数据库中每组资源计划指令的详细信息。 - -相关视图 -------------------------- - -* `DBA_RSRC_PLANS` - - - -* `V$RSRC_PLAN` - - - - - - -字段说明 -------------------------- - - - -| 字段名称 | 类型 | 是否可以为 NULL | 描述 | -|----------------------------|----------------|------------|----------------------| -| PLAN | VARCHAR2(128) | NO | 指令所属的资源计划名。 | -| GROUP_OR_SUBPLAN | VARCHAR2(128) | NO | 指令控制的资源组名。 | -| TYPE | VARCHAR2(14) | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| CPU_P1 | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| CPU_P2 | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| CPU_P3 | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| CPU_P4 | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| CPU_P5 | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| CPU_P6 | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| CPU_P7 | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| CPU_P8 | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| MGMT_P1 | NUMBER(38) | NO | 满负载场景下,可用的最大 CPU 份额。 | -| MGMT_P2 | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| MGMT_P3 | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| MGMT_P4 | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| MGMT_P5 | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| MGMT_P6 | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| MGMT_P7 | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| MGMT_P8 | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| ACTIVE_SESS_POOL_P1 | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| QUEUEING_P1 | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| PARALLEL_TARGET_PERCENTAGE | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| PARALLEL_DEGREE_LIMIT_P1 | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| SWITCH_GROUP | VARCHAR2(128) | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| SWITCH_FOR_CALL | VARCHAR2(5) | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| SWITCH_TIME | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| SWITCH_IO_MEGABYTES | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| SWITCH_IO_REQS | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| SWITCH_ESTIMATE | VARCHAR2(5) | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| MAX_EST_EXEC_TIME | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| UNDO_POOL | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| MAX_IDLE_TIME | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| MAX_IDLE_BLOCKER_TIME | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| MAX_UTILIZATION_LIMIT | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| PARALLEL_QUEUE_TIMEOUT | NUMBER | NO | 仅用于兼容,值一直为 `NULL`。 | -| SWITCH_TIME_IN_CALL | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| SWITCH_IO_LOGICAL | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| SWITCH_ELAPSED_TIME | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| PARALLEL_SERVER_LIMIT | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| UTILIZATION_LIMIT | NUMBER(38) | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| PARALLEL_STMT_CRITICAL | VARCHAR2(12) | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| SESSION_PGA_LIMIT | NUMBER | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| PQ_TIMEOUT_ACTION | VARCHAR2(6) | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| COMMENTS | VARCHAR2(2000) | YES | 指令的备注信息 | -| STATUS | VARCHAR2(128) | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| MANDATORY | VARCHAR2(3) | NO | 仅用于兼容,目前值固定为 `NULL`。 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/102.NLS_DATABASE_PARAMETERS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/102.NLS_DATABASE_PARAMETERS.md deleted file mode 100644 index 781282caa..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/102.NLS_DATABASE_PARAMETERS.md +++ /dev/null @@ -1,67 +0,0 @@ -NLS_DATABASE_PARAMETERS -============================================ - - - -功能 ------------ - -查看 DataBase 级别(OceanBase 数据库租户级)的 NLS 参数。 - -相关视图 -------------- - -* NLS_INSTANCE_PARAMETERS - - - -* NLS_SESSION_PARAMETERS, - - - -* V$NLS_PARAMETERS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-----------|-----------------|----------------|--------| -| PARAMETER | VARCHAR2(128) | NO | 参数名称 | -| VALUE | VARCHAR2(65536) | YES | 参数取值 | - - - -示例 ------------ - -```sql -obclient> SELECT * FROM SYS.NLS_DATABASE_PARAMETERS; -+-------------------------+----------------------------------+ -| PARAMETER | VALUE | -+-------------------------+----------------------------------+ -| NLS_DATE_FORMAT | YYYY-MM-DD HH24:MI:SS | -| NLS_TIMESTAMP_FORMAT | YYYY-MM-DD HH24:MI:SS.FF | -| NLS_TIMESTAMP_TZ_FORMAT | YYYY-MM-DD HH24:MI:SS.FF TZR TZD | -| NLS_TERRITORY | AMERICA | -| NLS_SORT | BINARY | -| NLS_COMP | BINARY | -| NLS_CHARACTERSET | AL32UTF8 | -| NLS_NCHAR_CHARACTERSET | AL16UTF16 | -| NLS_DATE_LANGUAGE | AMERICAN | -| NLS_LENGTH_SEMANTICS | BYTE | -| NLS_NCHAR_CONV_EXCP | FALSE | -| NLS_CALENDAR | GREGORIAN | -| NLS_NUMERIC_CHARACTERS | ., | -+-------------------------+----------------------------------+ -13 rows in set (0.03 sec) -``` - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/103.NLS_INSTANCE_PARAMETERS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/103.NLS_INSTANCE_PARAMETERS.md deleted file mode 100644 index 4eeb0b002..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/103.NLS_INSTANCE_PARAMETERS.md +++ /dev/null @@ -1,67 +0,0 @@ -NLS_INSTANCE_PARAMETERS -============================================ - - - -功能 ------------ - -查看实例级别(租户级别)的 NLS 参数。 - -相关视图 -------------- - -* NLS_DATABASE_PARAMETERS - - - -* NLS_SESSION_PARAMETERS - - - -* V$NLS_PARAMETERS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-----------|-----------------|----------------|--------| -| PARAMETER | VARCHAR2(128) | NO | 参数名称 | -| VALUE | VARCHAR2(65536) | YES | 参数取值 | - - - -示例 ------------ - -```sql -obclient> SELECT * FROM SYS.NLS_INSTANCE_PARAMETERS; -+-------------------------+----------------------------------+ -| PARAMETER | VALUE | -+-------------------------+----------------------------------+ -| NLS_DATE_FORMAT | YYYY-MM-DD HH24:MI:SS | -| NLS_TIMESTAMP_FORMAT | YYYY-MM-DD HH24:MI:SS.FF | -| NLS_TIMESTAMP_TZ_FORMAT | YYYY-MM-DD HH24:MI:SS.FF TZR TZD | -| NLS_TERRITORY | AMERICA | -| NLS_SORT | BINARY | -| NLS_COMP | BINARY | -| NLS_CHARACTERSET | AL32UTF8 | -| NLS_NCHAR_CHARACTERSET | AL16UTF16 | -| NLS_DATE_LANGUAGE | AMERICAN | -| NLS_LENGTH_SEMANTICS | BYTE | -| NLS_NCHAR_CONV_EXCP | FALSE | -| NLS_CALENDAR | GREGORIAN | -| NLS_NUMERIC_CHARACTERS | ., | -+-------------------------+----------------------------------+ -13 rows in set (0.02 sec) -``` - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/104.NLS_SESSION_PARAMETERS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/104.NLS_SESSION_PARAMETERS.md deleted file mode 100644 index ce5fd0029..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/104.NLS_SESSION_PARAMETERS.md +++ /dev/null @@ -1,66 +0,0 @@ -NLS_SESSION_PARAMETERS -=========================================== - - - -功能 ------------ - -查看 Session 级别的 NLS 参数。 - -相关视图 -------------- - -* NLS_INSTANCE_PARAMETERS - - - -* NLS_DATABASE_PARAMETERS - - - -* V$NLS_PARAMETERS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-----------|-----------------|----------------|--------| -| PARAMETER | VARCHAR2(128) | NO | 参数名称 | -| VALUE | VARCHAR2(65536) | YES | 参数取值 | - - - -示例 ------------ - -```sql -obclient> SELECT * FROM SYS.NLS_SESSION_PARAMETERS; -+-------------------------+----------------------------------+ -| PARAMETER | VALUE | -+-------------------------+----------------------------------+ -| NLS_DATE_FORMAT | YYYY-MM-DD HH24:MI:SS | -| NLS_TIMESTAMP_FORMAT | YYYY-MM-DD HH24:MI:SS.FF | -| NLS_TIMESTAMP_TZ_FORMAT | YYYY-MM-DD HH24:MI:SS.FF TZR TZD | -| NLS_LANGUAGE | AMERICAN | -| NLS_TERRITORY | AMERICA | -| NLS_SORT | BINARY | -| NLS_COMP | BINARY | -| NLS_DATE_LANGUAGE | AMERICAN | -| NLS_LENGTH_SEMANTICS | BYTE | -| NLS_NCHAR_CONV_EXCP | FALSE | -| NLS_CALENDAR | GREGORIAN | -| NLS_NUMERIC_CHARACTERS | ., | -+-------------------------+----------------------------------+ -12 rows in set (0.01 sec) -``` - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/105.STMT_AUDIT_OPTION_MAP.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/105.STMT_AUDIT_OPTION_MAP.md deleted file mode 100644 index 58626bead..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/105.STMT_AUDIT_OPTION_MAP.md +++ /dev/null @@ -1,28 +0,0 @@ -STMT_AUDIT_OPTION_MAP -========================================== - - - -功能 ------------ - -记录语句级别审计的 Type 及对应的名称和优先级。 - -相关视图 -------------- - -DBA_STMT_AUDIT_OPTS - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------|---------------|----------------|-------------------------------------| -| OPTION# | NUMBER(38) | NO | 语句级别审计的 Type ID | -| NAME | VARCHAR2(128) | NO | 语句级别审计的 Type 对应的名称 | -| PROPERTY | NUMBER | NO | 语句级别审计 Type 的优先级,目前暂不支持该字段,默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/106.USER_ALL_TABLES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/106.USER_ALL_TABLES.md deleted file mode 100644 index f941b9da3..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/106.USER_ALL_TABLES.md +++ /dev/null @@ -1,91 +0,0 @@ -USER_ALL_TABLES -==================================== - - - -功能 ------------ - -查看当前用户可访问的对象表和关系表,除了 OWNER 字段之外,其他字段和 ALL_ALL_TABLES 相同。 - -相关视图 -------------- - -* DAB_ALL_TABLES - - - -* ALL_ALL_TABLES - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|---------------------------|---------------|----------------|---------------------------------------------------------------------------------------------------------------------------------| -| TABLE_NAME | VARCHAR2(128) | NO | 表名 | -| TABLESPACE_NAME | VARCHAR2(30) | NO | 包含该表的表空间名字 | -| CLUSTER_NAME | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| IOT_NAME | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| STATUS | VARCHAR2(8) | NO | 表状态: * VALID * UNUSABLE | -| PCT_FREE | NUMBER | NO | 块的最小空闲空间比例 | -| PCT_USED | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INI_TRANS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_TRANS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INITIAL_EXTENT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NEXT_EXTENT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MIN_EXTENTS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_EXTENTS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| PCT_INCREASE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| FREELISTS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| FREELIST_GROUPS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| LOGGING | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| BACKED_UP | VARCHAR2(1) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NUM_ROWS | NUMBER | NO | 表行数 | -| BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| EMPTY_BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_SPACE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CHAIN_CNT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_ROW_LEN | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_SPACE_FREELIST_BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NUM_FREELIST_BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEGREE | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INSTANCES | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CACHE | VARCHAR2(20) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| TABLE_LOCK | VARCHAR2(8) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| SAMPLE_SIZE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| LAST_ANALYZED | DATE | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| PARTITIONED | VARCHAR2(3) | NO | 指定表是否是分区: * YES * NO | -| IOT_TYPE | VARCHAR2(12) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| OBJECT_ID_TYPE | VARCHAR2(16) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| TABLE_TYPE_OWNER | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| TABLE_TYPE | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| TEMPORARY | VARCHAR2(1) | NO | 指定表是否是临时表 | -| SECONDARY | VARCHAR2(1) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NESTED | VARCHAR2(3) | NO | 指定表是否是嵌套表: * YES * NO | -| BUFFER_POOL | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CELL_FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| ROW_MOVEMENT | VARCHAR2(8) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| GLOBAL_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| USER_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DURATION | VARCHAR2(15) | NO | 指示临时表的持续时间 | -| SKIP_CORRUPT | VARCHAR2(8) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MONITORING | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CLUSTER_OWNER | VARCHAR2(30) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEPENDENCIES | VARCHAR2(8) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| COMPRESSION | VARCHAR2(8) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| COMPRESS_FOR | VARCHAR2(12) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DROPPED | VARCHAR2(3) | NO | 表示被删除表是否在回收站里 | -| READ_ONLY | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| SEGMENT_CREATED | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| RESULT_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/107.USER_ARGUMENTS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/107.USER_ARGUMENTS.md deleted file mode 100644 index 05d252ead..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/107.USER_ARGUMENTS.md +++ /dev/null @@ -1,55 +0,0 @@ -USER_ARGUMENTS -=================================== - - - -功能 ------------ - -列出数据库中可用的过程和函数的参数。其列与 `ALL_ARGUMENTS` 中的列相同,去除了 `OWNER` 字段。 - -相关视图 -------------- - -* DBA_ARGUMENTS - - - -* ALL_ARGUMENTS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------------|---------------|----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| OBJECT_NAME | VARCHAR2(128) | YES | 过程或者函数名 | -| PACKAGE_NAME | VARCHAR2(128) | YES | 包名 | -| OBJECT_ID | NUMBER | NO | 对象 ID | -| OVERLOAD | NUMBER | YES | 出现在包源文件中的第几次重载 | -| SUBPROGRAM_ID | NUMBER | YES | 出现在包中的顺序, 对于独立的过程或者函数该值为 1 | -| ARGUMENT_NAME | VARCHAR2(128) | YES | 参数名,该值为 NULL 说明是函数的返回值 | -| POSITION | NUMBER(38) | NO | 出现在参数列表中的位置 | -| SEQUENCE | NUMBER(38) | NO | 对于复杂类型,该值代表属性的序号 | -| DATA_LEVEL | NUMBER(38) | NO | 对于嵌套的复杂类型, 该值代表当前类型嵌套的层次 | -| DATA_TYPE | VARCHAR2(128) | YES | 参数的数据类型, 对于嵌套的复杂类型, 该值代表当前层的数据类型 | -| DEFAULTED | CHAR(2) | YES | 标识当前参数是否有默认值 | -| DATA_LENGTH | NUMBER(38) | YES | 数据类型的长度 | -| IN_OUT | VARCHAR2(5) | YES | 参数的输入输出属性(NULL 表示是返回值) * IN * OUT * IN OUT | -| DATA_PRECISION | NUMBER(38) | YES | 数值类型的最大长度 | -| DATA_SCALE | NUMBER(38) | YES | 数值类型小数点右边的数据长度 | -| CHARACTER_SET_NAME | VARCHAR2(7) | YES | 参数的字符集名 | -| COLLATION | VARCHAR2(18) | YES | 字符集排序规则 | -| TYPE_OWNER | NUMBER(38) | YES | 复杂数据类型的类型拥有者 | -| TYPE_NAME | VARCHAR2(128) | YES | 复杂数据类型的名字 | -| TYPE_SUBNAME | VARCHAR2(128) | YES | 如果是包中的类型, 该字段代表包名 | -| ORIGIN_CON_ID | NUMBER(38) | YES | 该字段当前代表租户 ID | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/108.USER_AUDIT_OBJECT.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/108.USER_AUDIT_OBJECT.md deleted file mode 100644 index 89864a688..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/108.USER_AUDIT_OBJECT.md +++ /dev/null @@ -1,64 +0,0 @@ -USER_AUDIT_OBJECT -====================================== - - - -功能 ------------ - -显示当前用户可访问的对象的审计跟踪记录。 - -相关视图 -------------- - -* DBA_AUDIT_OBJECT - - - -* ALL_AUDIT_OBJECT - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------------|-----------------------------|----------------|-------------------------------------------------------| -| OS_USERNAME | VARCHAR2(255) | NO | 操作被审计的用户的操作系统登录用户名。目前暂不支持该字段,当前该字段默认为 NULL | -| USERNAME | VARCHAR2(32) | NO | 操作被审计的用户的名称 | -| USERHOST | VARCHAR2(64) | NO | 客户端主机名称。目前暂不支持该字段,当前该字段默认为 NULL | -| TERMINAL | VARCHAR2(255) | NO | 用户终端的标识符。目前暂不支持该字段,当前该字段默认为 NULL | -| TIMESTAMP | DATE | NO | 在本地数据库会话时区中创建审计跟踪条目的日期和时间 | -| OWNER | VARCHAR2(64) | YES | 受行为影响的对象的创建者 | -| OBJ_NAME | VARCHAR2(256) | YES | 受操作影响的对象的名称 | -| ACTION_NAME | VARCHAR2(128) | NO | 与 DBA_AUDIT_TRAIL 中操作列中的数字代码对应的操作类型的名称 | -| NEW_OWNER | VARCHAR2(64) | YES | 在 NEW_NAME 列中命名的对象的所有者 | -| NEW_NAME | VARCHAR2(256) | YES | 对象的新名称在 RENAME 或基础对象的名称之后 | -| SES_ACTIONS | VARCHAR2(19) | NO | 会话摘要。目前暂不支持该字段,当前该字段默认为 NULL | -| COMMENT_TEXT | VARCHAR2(65536) | YES | 在审计跟踪上的文本注释 | -| SESSIONID | NUMBER(38) | NO | 会话的数字 ID | -| ENTRYID | NUMBER(38) | NO | 会话中每个审计跟踪条目的数字 ID | -| STATEMENTID | NUMBER(38) | NO | 每个语句的数字 ID | -| RETURNCODE | NUMBER(38) | NO | 操作生成的错误代码 | -| PRIV_USED | VARCHAR2(40) | NO | 用于执行操作的系统特权。目前暂不支持该字段,当前该字段默认为 NULL | -| CLIENT_ID | VARCHAR2(40) | NO | 会话中的客户端标识符。目前暂不支持该字段,当前该字段默认为 NULL | -| ECONTEXT_ID | VARCHAR2(40) | NO | 应用程序执行上下文标识符。目前暂不支持该字段,当前该字段默认为 NULL | -| SESSION_CPU | NUMBER(38) | NO | 会话使用的CPU时间 | -| EXTENDED_TIMESTAMP | TIMESTAMP(6) WITH TIME ZONE | NO | 在 UTC 时区中创建审计跟踪条目的时间戳 | -| PROXY_SESSIONID | NUMBER(38) | NO | 代理会话序列号 | -| GLOBAL_UID | NUMBER(38) | NO | 用户的全局用户标识符 | -| INSTANCE_NUMBER | VARCHAR2(40) | NO | 实例编号由 INSTANCE_NUMBER 初始化参数指定。目前暂不支持该字段,当前该字段默认为 NULL | -| OS_PROCESS | VARCHAR2(40) | NO | 操作系统进程标识符。目前暂不支持该字段,当前该字段默认为 NULL | -| TRANSACTIONID | VARCHAR2(128) | NO | 在其中访问或修改对象的事务标识符 | -| SCN | NUMBER(38) | NO | 系统变更号(SCN)的查询。目前暂不支持该字段,当前该字段默认为 0 | -| SQL_BIND | VARCHAR2(2000) | YES | 绑定查询的变量数据。目前暂不支持该字段,当前该字段默认为 NULL | -| SQL_TEXT | VARCHAR2(2000) | YES | 查询的 SQL 文本 | -| OBJ_EDITION_NAME | VARCHAR2(128) | NO | 包含被审计对象的版本的名称。目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/109.USER_AUDIT_SESSION.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/109.USER_AUDIT_SESSION.md deleted file mode 100644 index 7feb9ae71..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/109.USER_AUDIT_SESSION.md +++ /dev/null @@ -1,45 +0,0 @@ -USER_AUDIT_SESSION -======================================= - - - -功能 ------------ - -显示关于当前用户的连接和断开的审计跟踪记录。 - -相关视图 -------------- - -DBA_AUDIT_SESSION - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------------|-----------------------------|----------------|-------------------------------------------------------| -| OS_USERNAME | VARCHAR2(255) | NO | 操作被审计的用户的操作系统登录用户名。目前暂不支持该字段,当前该字段默认为 NULL | -| USERNAME | VARCHAR2(64) | NO | 操作被审计的用户的名称 | -| USERHOST | VARCHAR2(32) | NO | 客户端主机名称。目前暂不支持该字段,当前该字段默认为 NULL | -| TERMINAL | VARCHAR2(255) | NO | 用户终端的标识符。目前暂不支持该字段,当前该字段默认为 NULL | -| TIMESTAMP | DATE | NO | 在本地数据库会话时区中创建审计跟踪条目的日期和时间 | -| ACTION_NAME | VARCHAR2(128) | NO | 与 DBA_AUDIT_TRAIL 中操作列中的数字代码对应的操作类型的名称 | -| LOGOFF_TIME | DATE | NO | 用户注销的日期和时间 | -| LOGOFF_LREAD | NUMBER(38) | NO | 会话的逻辑读取 | -| LOGOFF_PREAD | NUMBER | NO | 会话的物理读取。目前暂不支持该字段,当前该字段默认为 NULL | -| LOGOFF_LWRITE | NUMBER | NO | 会话的逻辑写操作。目前暂不支持该字段,当前该字段默认为 NULL | -| LOGOFF_DLOCK | VARCHAR2(40) | NO | 在会话期间检测到死锁。目前暂不支持该字段,当前该字段默认为 NULL | -| SESSIONID | NUMBER(38) | NO | 会话的数字 ID | -| RETURNCODE | NUMBER(38) | NO | 操作生成的错误代码 | -| CLIENT_ID | VARCHAR2(40) | NO | 会话中的客户端标识符 | -| SESSION_CPU | NUMBER(38) | NO | 会话使用的 CPU 时间 | -| EXTENDED_TIMESTAMP | TIMESTAMP(6) WITH TIME ZONE | NO | 在 UTC 时区中创建审计跟踪条目的时间戳 | -| PROXY_SESSIONID | NUMBER(38) | NO | 代理会话序列号 | -| GLOBAL_UID | NUMBER(38) | NO | 用户的全局用户标识符 | -| INSTANCE_NUMBER | VARCHAR2(40) | NO | INSTANCE_NUMBER 初始化参数指定的实例编号由。目前暂不支持该字段,当前该字段默认为 NULL | -| OS_PROCESS | VARCHAR2(40) | NO | 操作系统进程标识符。目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/11.ALL_IND_COLUMNS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/11.ALL_IND_COLUMNS.md deleted file mode 100644 index ce9177075..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/11.ALL_IND_COLUMNS.md +++ /dev/null @@ -1,43 +0,0 @@ -ALL_IND_COLUMNS -==================================== - - - -功能 ------------ - -查看用户可访问的所有表的索引的索引列信息。 - -相关视图 -------------- - -* USER_IND_COLUMNS - - - -* DBA_IND_COLUMNS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-----------------|----------------|----------------|------------------------------| -| INDEX_OWNER | VARCHAR2(128) | NO | 索引所属的拥有者 | -| INDEX_NAME | VARCHAR2(128) | NO | 索引名字 | -| TABLE_OWNER | VARCHAR2(128) | NO | 索引所在的表的拥有者 | -| TABLE_NAME | VARCHAR2(128) | NO | 索引所在的表的名字 | -| COLUMN_NAME | VARCHAR2(4000) | NO | 索引列的名字 | -| COLUMN_POSITION | NUMBER | NO | 索引列在索引中的位置 | -| COLUMN_LENGTH | NUMBER | NO | 索引列的长度 | -| CHAR_LENGTH | NUMBER | NO | 索引列的字符长度 | -| DESCEND | VARCHAR2(4) | NO | 表示索引列是按降序(DESC)排列还是升序(ASC)排列 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/110.USER_AUDIT_STATEMENT.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/110.USER_AUDIT_STATEMENT.md deleted file mode 100644 index c22e24dad..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/110.USER_AUDIT_STATEMENT.md +++ /dev/null @@ -1,64 +0,0 @@ -USER_AUDIT_STATEMENT -========================================= - - - -功能 ------------ - -显示当前用户发出的 `GRANT`、`REVOKE`、`AUDIT`、`NOAUDIT` 和 `ALTER SYSTEM` 语句的审计跟踪条目。 - -相关视图 -------------- - -* DBA_AUDIT_STATEMENT - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------------|-----------------------------|----------------|--------------------------------------------------------| -| OS_USERNAME | VARCHAR2(255) | NO | 操作被审计的用户的操作系统登录用户名。目前暂不支持该字段,当前该字段默认为 NULL | -| USERNAME | VARCHAR2(64) | NO | 操作被审计的用户的名称 | -| USERHOST | VARCHAR2(32) | NO | 客户端主机名称。目前暂不支持该字段,当前该字段默认为 NULL | -| TERMINAL | VARCHAR2(255) | NO | 用户终端的标识符。目前暂不支持该字段,当前该字段默认为 NULL | -| TIMESTAMP | DATE | NO | 在本地数据库会话时区中创建审计跟踪条目的日期和时间 | -| OWNER | VARCHAR2(64) | YES | 受行为影响的对象的创建者 | -| OBJ_NAME | VARCHAR2(256) | YES | 受操作影响的对象的名称 | -| ACTION_NAME | VARCHAR2(128) | NO | 与 DBA_AUDIT_TRAIL 中操作列中的数字代码对应的操作类型的名称 | -| NEW_NAME | VARCHAR2(256) | YES | 对象的新名称在 RENAME 或基础对象的名称之后 | -| OBJ_PRIVILEGE | VARCHAR2(255) | NO | 由 GRANT 或 REVOKE 语句授予或撤销的对象权限,待 Patch | -| SYS_PRIVILEGE | VARCHAR2(255) | NO | 由 GRANT 或 REVOKE 语句授予或撤消的系统权限,待 Patch | -| ADMIN_OPTION | VARCHAR2(1) | NO | 表示已使用 ADMIN 选项授予角色或系统权限,待 Patch | -| GRANTEE | VARCHAR2(128) | NO | GRANT 或 REVOKE 中指定的授予者名称,待 Patch | -| AUDIT_OPTION | VARCHAR2(40) | NO | 审计选项与审计语句一起设置,待 Patch | -| SES_ACTIONS | VARCHAR2(19) | NO | 会话摘要。目前暂不支持该字段,当前该字段默认为 NULL | -| COMMENT_TEXT | VARCHAR2(65536) | YES | 审核跟踪上的文本注释,由应用程序插入 | -| SESSIONID | NUMBER(38) | NO | 会话的数字 ID | -| ENTRYID | NUMBER(38) | NO | 会话中每个审计跟踪条目的数字 ID | -| STATEMENTID | NUMBER(38) | NO | 每个语句的数字 ID | -| RETURNCODE | NUMBER(38) | NO | 操作生成的错误代码 | -| PRIV_USED | VARCHAR2(40) | NO | 用于执行操作的系统权限。目前暂不支持该字段,当前该字段默认为 NULL | -| CLIENT_ID | VARCHAR2(40) | NO | 会话中的客户端标识符。目前暂不支持该字段,当前该字段默认为 NULL | -| ECONTEXT_ID | VARCHAR2(40) | NO | 应用程序执行上下文标识符。目前暂不支持该字段,当前该字段默认为 NULL | -| SESSION_CPU | NUMBER(38) | NO | 会话使用的 CPU 时间 | -| EXTENDED_TIMESTAMP | TIMESTAMP(6) WITH TIME ZONE | NO | 在 UTC 时区中创建审计跟踪条目的时间戳 | -| PROXY_SESSIONID | NUMBER(38) | NO | 代理会话序列号 | -| GLOBAL_UID | NUMBER(38) | NO | 用户的全局用户标识符 | -| INSTANCE_NUMBER | VARCHAR2(40) | NO | 由 INSTANCE_NUMBER 初始化参数指定的实例编号。目前暂不支持该字段,当前该字段默认为 NULL | -| OS_PROCESS | VARCHAR2(40) | NO | 进程的操作系统进程标识符。目前暂不支持该字段,当前该字段默认为 NULL | -| TRANSACTIONID | VARCHAR2(128) | NO | 在其中访问或修改对象的事务标识符 | -| SCN | NUMBER(38) | NO | 系统变更号 (SCN) 的查询。目前暂不支持该字段,当前该字段默认为 0 | -| SQL_BIND | VARCHAR2(2000) | YES | 绑定查询的变量数据。目前暂不支持该字段,当前该字段默认为 NULL | -| SQL_TEXT | VARCHAR2(2000) | YES | 查询的 SQL 文本 | -| OBJ_EDITION_NAME | VARCHAR2(128) | NO | 包含被审计对象的版本的名称。目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/111.USER_AUDIT_TRAIL.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/111.USER_AUDIT_TRAIL.md deleted file mode 100644 index 91b56c88e..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/111.USER_AUDIT_TRAIL.md +++ /dev/null @@ -1,66 +0,0 @@ -USER_AUDIT_TRAIL -===================================== - - - -功能 ------------ - -显示与当前用户相关的标准审计跟踪条目。 - -相关视图 -------------- - -DBA_AUDIT_TRAIL - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------------|-----------------------------|----------------|--------------------------------------------------------| -| OS_USERNAME | VARCHAR2(255) | NO | 操作被审计的用户的操作系统登录用户名。目前暂不支持该字段,当前该字段默认为 NULL | -| USERNAME | VARCHAR2(64) | NO | 操作被审计的用户的名称 | -| USERHOST | VARCHAR2(32) | NO | 客户端主机名称。目前暂不支持该字段,当前该字段默认为 NULL | -| TERMINAL | VARCHAR2(255) | NO | 用户终端的标识符。目前暂不支持该字段,当前该字段默认为 NULL | -| TIMESTAMP | DATE | NO | 在本地数据库会话时区中创建审计跟踪条目的日期和时间 | -| OWNER | VARCHAR2(64) | YES | 受行为影响的对象的创建者 | -| OBJ_NAME | VARCHAR2(256) | YES | 受操作影响的对象的名称 | -| ACTION | NUMBER(38) | NO | 数字操作类型代码 | -| ACTION_NAME | VARCHAR2(128) | NO | 与操作列中的数字代码对应的操作类型的名称 | -| NEW_OWNER | VARCHAR2(64) | YES | 在 NEW_NAME 列中命名的对象的所有者 | -| NEW_NAME | VARCHAR2(256) | YES | 在 RENAME 或基础对象的名称后对象的新名称 | -| OBJ_PRIVILEGE | VARCHAR2(255) | NO | 由 GRANT 或 REVOKE 语句授予或撤销的对象特权,待 Patch | -| SYS_PRIVILEGE | VARCHAR2(255) | NO | 由 GRANT 或 REVOKE 语句授予或撤消的系统特权,待 Patch | -| ADMIN_OPTION | VARCHAR2(1) | NO | 指示是否使用 ADMIN 选项授予角色或系统特权,待 Patch | -| GRANTEE | VARCHAR2(128) | NO | GRANT 或 REVOKE 中指定的授予者名称,待 Patch | -| AUDIT_OPTION | VARCHAR2(40) | NO | AUDIT 语句设置的审计选项,待Patch | -| SES_ACTIONS | VARCHAR2(19) | NO | 会话摘要,OB 不支持,默认为 NULL | -| LOGOFF_TIME | DATE | NO | 用户注销的日期和时间 | -| LOGOFF_LREAD | NUMBER(38) | NO | 会话的逻辑读取 | -| LOGOFF_PREAD | NUMBER | NO | 会话的物理读取。目前暂不支持该字段,当前该字段默认为 NULL | -| LOGOFF_LWRITE | NUMBER | NO | 会话的逻辑写操作。目前暂不支持该字段,当前该字段默认为 NULL | -| LOGOFF_DLOCK | VARCHAR2(40) | NO | 在会话期间检测到死锁。目前暂不支持该字段,当前该字段默认为 NULL | -| COMMENT_TEXT | VARCHAR2(65536) | YES | 在审计跟踪条目上的文本注释,提供关于被审计的语句的更多信息 | -| SESSIONID | NUMBER(38) | NO | 会话的数字 ID | -| ENTRYID | NUMBER(38) | NO | 每个审计跟踪条目的数字 ID | -| STATEMENTID | NUMBER(38) | NO | 每个语句的数字 ID | -| RETURNCODE | NUMBER(38) | NO | 操作生成的错误代码 | -| PRIV_USED | VARCHAR2(40) | NO | 用于执行操作的系统特权。目前暂不支持该字段,当前该字段默认为 NULL | -| CLIENT_ID | VARCHAR2(40) | NO | 会话中的客户端标识符。目前暂不支持该字段,当前该字段默认为 NULL | -| ECONTEXT_ID | VARCHAR2(40) | NO | 应用程序执行上下文标识符。目前暂不支持该字段,当前该字段默认为 NULL | -| SESSION_CPU | NUMBER(38) | NO | 会话使用的 CPU 时间 | -| EXTENDED_TIMESTAMP | TIMESTAMP(6) WITH TIME ZONE | NO | 在 UTC 时区中创建审计跟踪条目的时间戳 | -| PROXY_SESSIONID | NUMBER(38) | NO | 代理会话序列号 | -| GLOBAL_UID | NUMBER(38) | NO | 用户的全局用户标识符 | -| INSTANCE_NUMBER | VARCHAR2(40) | NO | 由 INSTANCE_NUMBER 初始化参数指定的实例编号。目前暂不支持该字段,当前该字段默认为 NULL | -| OS_PROCESS | VARCHAR2(40) | NO | 进程的操作系统进程标识符。目前暂不支持该字段,当前该字段默认为 NULL | -| TRANSACTIONID | VARCHAR2(128) | NO | 在其中访问或修改对象的事务标识符 | -| SCN | NUMBER(38) | NO | 系统变更号(SCN)的查询。目前暂不支持该字段,当前该字段默认为 0 | -| SQL_BIND | VARCHAR2(2000) | YES | 绑定查询的变量数据。目前暂不支持该字段,当前该字段默认为 NULL | -| SQL_TEXT | VARCHAR2(2000) | YES | 查询的 SQL 文本 | -| OBJ_EDITION_NAME | VARCHAR2(128) | NO | 包含被审计对象的版本的名称。目前暂不支持该字段,当前该字段默认为 NULL | -| DBID | NUMBER(38) | NO | 被审计数据库的数据库标识符 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/112.USER_COLL_TYPES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/112.USER_COLL_TYPES.md deleted file mode 100644 index 94556f4e8..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/112.USER_COLL_TYPES.md +++ /dev/null @@ -1,46 +0,0 @@ -USER_COLL_TYPES -==================================== - - - -功能 ------------ - -列出当前用户可用的用户自定义集合类型。 - -相关视图 -------------- - -* DBA_COLL_TYPES - - - -* ALL_COLL_TYPES - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------------|---------------|----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| TYPE_NAME | VARCHAR2(64) | NO | 类型名 | -| COLL_TYPE | VARCHAR2(10) | NO | 集合类型: * VARYING * ARRAY * NESTED TABLE | -| UPPER_BOUND | NUMBER(38) | YES | 对于 VARYING,记录集合的最大大小 | -| ELEM_TYPE_MOD | VARCHAR2(7) | YES | 目前暂不支持该字段,当前该字段默认为 NULL | -| ELEM_TYPE_OWNER | VARCHAR2(128) | YES | 集合元素类型的拥有者 | -| ELEM_TYPE_NAME | VARCHAR2(324) | YES | 集合元素类型名 | -| LENGTH | NUMBER(38) | YES | 集合元素类型长度 | -| NUMBER_PRECISION | NUMBER(38) | YES | 集合元素类型精度 | -| SCALE | NUMBER(38) | YES | 集合元素类型小数点右边数据的长度 | -| CHARACTER_SET_NAME | CHAR(7) | YES | 集合元素类型字符集 | -| ELEM_STORAGE | CHAR(7) | YES | 目前暂不支持该字段,当前该字段默认为 NULL | -| NULLS_STORED | CHAR(7) | YES | 目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/113.USER_COL_COMMENTS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/113.USER_COL_COMMENTS.md deleted file mode 100644 index ab9567f48..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/113.USER_COL_COMMENTS.md +++ /dev/null @@ -1,39 +0,0 @@ -USER_COL_COMMENTS -====================================== - - - -功能 ------------ - -查看当前用户拥有的视图和表的所有列注释。 - -相关视图 -------------- - -* ALL_COL_COMMENTS - - - -* DBA_COL_COMMENTS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-------------|----------------|----------------|--------| -| OBJECT_NAME | VARCHAR2(128) | NO | 对象名字 | -| COLUMN_NAME | VARCHAR2(128) | NO | 列名 | -| COMMENTS | VARCHAR2(4000) | YES | 列注释 | - - - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/114.USER_COL_PRIVS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/114.USER_COL_PRIVS.md deleted file mode 100644 index 3d7214cef..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/114.USER_COL_PRIVS.md +++ /dev/null @@ -1,36 +0,0 @@ -USER_COL_PRIVS -=================================== - - - -功能 ------------ - -描述当前用户是对象所有者、授予者或被授予者的列对象授予。 -**说明** - - - -目前不支持列权限功能。 - -相关视图 -------------- - -DBA_COL_PRIVS - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-------------|---------------|----------------|------------------| -| GRANTEE | VARCHAR2(128) | NO | 被授予访问权限的用户的名称 | -| OWNER | VARCHAR2(128) | NO | 对象的所有者 | -| TABLE_NAME | VARCHAR2(256) | NO | 对象的名称 | -| COLUMN_NAME | VARCHAR2(128) | NO | 列的名称 | -| GRANTOR | VARCHAR2(128) | NO | 执行授权的用户的名称 | -| PRIVILEGE | VARCHAR2(40) | NO | 列上的特权 | -| GRANTABLE | VARCHAR2(3) | NO | 是否能使用 GRANT 授予权限 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/115.USER_CONSTRAINTS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/115.USER_CONSTRAINTS.md deleted file mode 100644 index 671c2da34..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/115.USER_CONSTRAINTS.md +++ /dev/null @@ -1,54 +0,0 @@ -USER_CONSTRAINTS -===================================== - - - -功能 ------------ - -查看用户拥有的所有表的约束信息。 - -相关视图 -------------- - -* ALL_CONSTRAINT - - - -* DBA_CONSTRAINT - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-------------------|----------------|----------------|--------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 约束的所有者 | -| CONSTRAINT_NAME | VARCHAR2(128) | NO | 约束名字 | -| CONSTRAINT_TYPE | VARCHAR2(1) | NO | 索引类型,目前只支持 NORMAL 类型 | -| TABLE_NAME | VARCHAR2(128) | NO | 约束所在的表的名字 | -| SEARCH_CONDITION | VARCHAR2(4000) | NO | check 约束 search condition 的文本 | -| R_OWNER | VARCHAR2(128) | NO | 被引用约束的拥有者 | -| R_CONSTRAINT_NAME | VARCHAR2(128) | NO | 被引用约束的名字 | -| DELETE_RULE | VARCHAR2(9) | NO | 外键约束的级联删除规则 | -| STATUS | VARCHAR2(8) | NO | 表示约束是 ENABLE 还是 DISABLE | -| DEFERRABLE | VARCHAR2(14) | NO | 表示约束是 DEFERRABLE 还是 NOT DEFERRABLE | -| DEFERRED | VARCHAR2(9) | NO | 表示约束是 DEFERRED 还是 IMMEDIATE | -| VALIDATED | VARCHAR2(13) | NO | 表示约束是 VALIDATED 还是 NOT VALIDATED | -| GENERATED | VARCHAR2(14) | NO | 表示约束的名字是 USER NAME 还是 GENERATED NAME | -| BAD | VARCHAR2(3) | NO | 暂不支持该字段,字段默认为 NULL | -| RELY | VARCHAR2(4) | NO | 表示约束是否是 RELY 状态 | -| LAST_CHANGE | DATE | NO | 约束上一次被改为 ENABLE 或者 DISABLE 的时间 | -| INDEX_OWNER | VARCHAR2(128) | NO | 约束上索引的拥有者 | -| INDEX_NAME | VARCHAR2(128) | NO | 约束上索引的名字 | -| INVALID | VARCHAR2(7) | NO | 表示约束是否是 INVALIDATE 状态 | -| VIEW_RELATED | VARCHAR2(14) | NO | 表示约束是否创建在视图上 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/116.USER_CONS_COLUMNS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/116.USER_CONS_COLUMNS.md deleted file mode 100644 index adcff386e..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/116.USER_CONS_COLUMNS.md +++ /dev/null @@ -1,39 +0,0 @@ -USER_CONS_COLUMNS -====================================== - - - -功能 ------------ - -查看用户拥有的所有表的约束中的列信息。 - -相关视图 -------------- - -* ALL_CONS_COLUMNS - - - -* DBA_CONS_COLUMNS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-----------------|----------------|----------------|----------| -| OWNER | VARCHAR2(128) | VARCHAR2(128) | 列的拥有者 | -| CONSTRAINT_NAME | VARCHAR2(128) | NO | 约束名字 | -| TABLE_NAME | VARCHAR2(128) | NO | 约束所在表的表名 | -| COLUMN_NAME | VARCHAR2(4000) | YES | 约束中的列名 | -| POSITION | NUMBER | YES | 列在约束中的位置 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/117.USER_ERRORS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/117.USER_ERRORS.md deleted file mode 100644 index d59940142..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/117.USER_ERRORS.md +++ /dev/null @@ -1,47 +0,0 @@ -USER_ERRORS -================================ - - -**说明** - - - -OceanBase 数据库暂未支持该视图。 - -功能 ------------ - -查看用户可访问的当前存储对象的错误。 - -相关视图 -------------- - -* ALL_ERRORS - - - -* DBA_ERRORS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------------|----------------|----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| NAME | VARCHAR2(128) | NO | 对象的名称 | -| TYPE | VARCHAR2(19) | NO | 对象的类型: * VIEW * PROCEDUCE * FUNCTION * PACKAGE * PACKAGE_BODY * TRIGGER * TYPE * TYPE BODY * LIBRARY * JAVA SOURCE * JAVA CLASS * DIMENSION | -| SEQUENCE | NUMBER | NO | 同一次编译多个错误的错误编号(未排序) | -| LINE | NUMBER | NO | 错误发生的行号 | -| POSITION | NUMBER | NO | 错误发生的列号 | -| TEXT | VARCHAR2(4000) | NO | 错误信息文本 | -| ATTRIBUTE | VARCHAR2(9) | NO | 表明是 ERROR 还是 WARNING | -| MESSAGE_NUMBER | NUMBER | NO | 错误编码 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/118.USER_INDEXES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/118.USER_INDEXES.md deleted file mode 100644 index d7d9048d4..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/118.USER_INDEXES.md +++ /dev/null @@ -1,91 +0,0 @@ -USER_INDEXES -================================= - - - -功能 ------------ - -USER_INDEXES 用于查看用户拥有的所有表的索引信息。 - -相关视图 -------------- - -* ALL_INDEXES - - - -* DBA_INDEXES - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-------------------------|----------------|----------------|---------------------------------------------------------------------------------------------------------------------------------------------| -| INDEX_NAME | VARCHAR2(128) | NO | 索引名字。 | -| INDEX_TYPE | VARCHAR2(27) | NO | 索引的类型。 | -| TABLE_OWNER | VARCHAR2(128) | NO | 被索引对象的拥有者。 | -| TABLE_NAME | VARCHAR2(128) | NO | 被索引对象的名字。 | -| TABLE_TYPE | CHAR(5) | NO | 被索引对象的类型。 | -| UNIQUENESS | VARCHAR2(9) | NO | 表示索引是否是唯一的(UNIQUE)或不唯一的。 | -| COMPRESSION | VARCHAR2(8) | NO | 表示索引是否是被压缩的。 | -| PREFIX_LENGTH | NUMBER | NO | 表示在压缩索引中的前缀列数量。目前暂不支持该字段,当前该字段显示为 NULL。 | -| TABLESPACE_NAME | VARCHAR2(30) | NO | 索引所在的表空间名。 | -| INI_TRANS | NUMBER | NO | 表示初始事务数量。目前暂不支持该字段,当前该字段显示为 NULL。 | -| MAX_TRANS | NUMBER | NO | 表示最大事务数量。目前暂不支持该字段,当前该字段显示为 NULL。 | -| INITIAL_EXTENT | NUMBER | NO | 表示初始 extent 大小。目前暂不支持该字段,当前该字段显示为 NULL。 | -| NEXT_EXTENT | NUMBER | NO | 表示第二 extent 大小。目前暂不支持该字段,当前该字段显示为 NULL。 | -| MIN_EXTENTS | NUMBER | NO | 表示在段里允许的最小 extent 数量。目前暂不支持该字段,当前该字段显示为 NULL。 | -| MAX_EXTENTS | NUMBER | NO | 表示在段里允许的最大 extent 数量。目前暂不支持该字段,当前该字段显示为 NULL。 | -| PCT_INCREASE | NUMBER | NO | 表示 extent 大小的增长率。目前暂不支持该字段,当前该字段显示为 NULL。 | -| PCT_THRESHOLD | NUMBER | NO | 表示每个索引被允许占用的块空间百分比。目前暂不支持该字段,当前该字段显示为 NULL。 | -| INCLUDE_COLUMN | NUMBER | NO | 表示索引组织表的主键的最后一列的列编号。目前暂不支持该字段,当前该字段显示为 NULL。 | -| FREELISTS | NUMBER | NO | 表示被分配个段的进程 freelist 数量。目前暂不支持该字段,当前该字段显示为 NULL。 | -| FREELIST_GROUPS | NUMBER | NO | 表示被分配个段的 freelist 组数量。目前暂不支持该字段,当前该字段显示为 NULL。 | -| PCT_FREE | NUMBER | NO | 表示块中空余空间的最小百分比。目前暂不支持该字段,当前该字段显示为 NULL。 | -| LOGGING | VARCHAR2(3) | NO | 指示对索引的修改是否被记录了日志。目前暂不支持该字段,当前该字段显示为 NULL。 | -| BLEVEL | NUMBER | NO | 表示 B\*-Tree 的深度。目前暂不支持该字段,当前该字段显示为 NULL。 | -| LEAF_BLOCKS | NUMBER | NO | 表示索引中叶子块的数量。目前暂不支持该字段,当前该字段显示为 NULL。 | -| DISTINCT_KEYS | NUMBER | NO | 表示不同索引值的数量。目前暂不支持该字段,当前该字段显示为 NULL。 | -| AVG_LEAF_BLOCKS_PER_KEY | NUMBER | NO | 出现索引中每个不同值的叶块的平均数目,四舍五入到最接近的整数。对于具有 UNIQUE 和 PRIMARY KEY 约束的索引,此值始终为 1。目前暂不支持该字段,当前该字段显示为 NULL。 | -| AVG_DATA_BLOCKS_PER_KEY | NUMBER | NO | 表中由索引中不同值四舍五入到最接近的整数所指向的平均数据块数。此统计信息是包含行的数据块的平均数量,这些行包含给定索引列的给定值。目前暂不支持该字段,当前该字段显示为 NULL。 | -| CLUSTERING_FACTOR | NUMBER | NO | 指示基于索引值的表中行的数量。 如果该值接近块数,则表的顺序非常好。在这种情况下,单个叶块中的索引条目往往指向同一数据块中的行。 如果该值接近行数,则表是非常随机的。在这种情况下,同一叶块中的索引条目不太可能指向同一数据块中的行。目前暂不支持该字段,当前该字段显示为 NULL。 | -| STATUS | VARCHAR2(10) | NO | 指示未分区的索引是 VALID 还是 UNUSABLE。 | -| NUM_ROWS | NUMBER | NO | 索引中的行数。 | -| SAMPLE_SIZE | NUMBER | NO | 用于分析指标的样本大小。目前暂不支持该字段,当前该字段显示为 NULL。 | -| LAST_ANALYZED | DATE | NO | 最近分析该指数的日期。目前暂不支持该字段,当前该字段显示为 NULL。 | -| DEGREE | VARCHAR2(40) | NO | 表示每个实例用于扫描索引的线程数。目前暂不支持该字段,当前该字段显示为 NULL。 | -| INSTANCES | VARCHAR2(40) | NO | 要扫描索引的实例数。目前暂不支持该字段,当前该字段显示为 NULL。 | -| PARTITIONED | VARCHAR2(3) | NO | 表示索引是否是分区索引。 | -| TEMPORARY | VARCHAR2(1) | NO | 表示索引是否在临时表上。目前暂不支持该字段,当前该字段显示为 NULL。 | -| GENERATED | VARCHAR2(1) | NO | 指示索引的名称是系统生成的。目前暂不支持该字段,当前该字段显示为 NULL。 | -| SECONDARY | VARCHAR2(1) | NO | 指示索引是否是辅助对象。目前暂不支持该字段,当前该字段显示为 NULL。 | -| BUFFER_POOL | VARCHAR2(7) | NO | 用于索引块的默认缓冲池的名称。目前暂不支持该字段,当前该字段显示为 NULL。 | -| FLASH_CACHE | VARCHAR2(7) | NO | 用于索引块的数据库智能闪存缓存。目前暂不支持该字段,当前该字段显示为 NULL。 | -| CELL_FLASH_CACHE | VARCHAR2(7) | NO | 用于索引块的单元闪存缓存。目前暂不支持该字段,当前该字段显示为 NULL。 | -| USER_STATS | VARCHAR2(3) | NO | 是否由用户直接输入统计信息。目前暂不支持该字段,当前该字段显示为 NULL。 | -| DURATION | VARCHAR2(15) | NO | 指示临时表的持续时间。目前暂不支持该字段,当前该字段显示为 NULL。 | -| PCT_DIRECT_ACCESS | NUMBER | NO | 对于索引组织的表上的二级索引,具有 VALID 猜测的行的百分比。目前暂不支持该字段,当前该字段显示为 NULL。 | -| ITYP_OWNER | VARCHAR2(30) | NO | 对于域索引,索引类型的所有者。目前暂不支持该字段,当前该字段显示为 NULL。 | -| ITYP_NAME | VARCHAR2(30) | NO | 对于域索引,索引类型的名称。目前暂不支持该字段,当前该字段显示为 NULL。 | -| PARAMETERS | VARCHAR2(1000) | NO | 域索引的参数字符串。目前暂不支持该字段,当前该字段显示为 NULL。 | -| GLOBAL_STATS | VARCHAR2(3) | NO | 对于分区索引,指示是通过整体分析索引收集统计信息,还是从基础索引分区和子分区的统计信息中估算统计信息。目前暂不支持该字段,当前该字段显示为 NULL。 | -| DOMIDX_STATUS | VARCHAR2(12) | NO | 表示域索引的状态。目前暂不支持该字段,当前该字段显示为 NULL。 | -| DOMIDX_OPSTATUS | VARCHAR2(6) | NO | 表示域索引上的操作状态。目前暂不支持该字段,当前该字段显示为 NULL。 | -| FUNCIDX_STATUS | VARCHAR2(8) | NO | 基于函数的索引的状态。 | -| JOIN_INDEX | VARCHAR2(3) | NO | 指示索引是否为联接索引。 | -| IOT_REDUNDANT_PKEY_ELIM | VARCHAR2(3) | NO | 指示是否从索引组织表的二级索引中消除了冗余主键列。目前暂不支持该字段,当前该字段显示为 NULL。 | -| DROPPED | VARCHAR2(9) | NO | 表示索引是否被删除并进了回收站。 | -| VISIBILITY | VARCHAR2(10) | NO | 表示索引对优化器是否可见。 | -| DOMIDX_MANAGEMENT | VARCHAR2(14) | NO | 表示域索引是由系统管理还是用户管理。目前暂不支持该字段,当前该字段显示为 NULL。 | -| SEGMENT_CREATED | VARCHAR2(3) | NO | 指示是否已创建索引段。目前暂不支持该字段,当前该字段显示为 NULL。 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/119.USER_IND_COLUMNS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/119.USER_IND_COLUMNS.md deleted file mode 100644 index 3db5650d7..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/119.USER_IND_COLUMNS.md +++ /dev/null @@ -1,41 +0,0 @@ -USER_IND_COLUMNS -===================================== - - - -功能 ------------ - -查看用户拥有的所有表的索引的索引列信息。 - -相关视图 -------------- - -* ALL_IND_COLUMNS - - - -* DBA_IND_COLUMNS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-----------------|----------------|----------------|------------------------------| -| INDEX_NAME | VARCHAR2(128) | NO | 索引名字 | -| TABLE_OWNER | VARCHAR2(128) | NO | 索引所在的表的拥有者 | -| COLUMN_NAME | VARCHAR2(4000) | NO | 索引列的名字 | -| COLUMN_POSITION | NUMBER | NO | 索引列在索引中的位置 | -| COLUMN_LENGTH | NUMBER | NO | 索引列的长度 | -| CHAR_LENGTH | NUMBER | NO | 索引列的字符长度 | -| DESCEND | VARCHAR2(4) | NO | 表示索引列是按降序(DESC)排列还是升序(ASC)排列 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/12.ALL_IND_EXPRESSIONS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/12.ALL_IND_EXPRESSIONS.md deleted file mode 100644 index e62e7f059..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/12.ALL_IND_EXPRESSIONS.md +++ /dev/null @@ -1,40 +0,0 @@ -ALL_IND_EXPRESSIONS -======================================== - - - -功能 ------------ - -查看用户在数据库中可访问的 function-based 索引的信息。 - -相关视图 -------------- - -* DBA_IND_EXPRESSIONS - - - -* USER_IND_EXPRESSIONS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-------------------|----------------|----------------|----------------------| -| INDEX_OWNER | VARCHAR2(128) | NO | 索引所属的拥有者 | -| INDEX_NAME | VARCHAR2(128) | NO | 索引名字 | -| TABLE_OWNER | VARCHAR2(128) | NO | 索引所在表的拥有者 | -| TABLE_NAME | VARCHAR2(128) | NO | 索引所在表的名字 | -| COLUMN_EXPRESSION | VARCHAR2(1000) | NO | function-base 索引的表达式 | -| COLUMN_POSITION | NUMBER(38) | NO | 列所在索引的位置 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/120.USER_IND_EXPRESSIONS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/120.USER_IND_EXPRESSIONS.md deleted file mode 100644 index 949fe3f15..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/120.USER_IND_EXPRESSIONS.md +++ /dev/null @@ -1,38 +0,0 @@ -USER_IND_EXPRESSIONS -========================================= - - - -功能 ------------ - -查看用户在数据库中所拥有的 function-based 索引的信息。 - -相关视图 -------------- - -* DBA_IND_EXPRESSIONS - - - -* ALL_IND_EXPRESSIONS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-------------------|----------------|----------------|----------------------| -| INDEX_NAME | VARCHAR2(128) | NO | 索引名字 | -| TABLE_NAME | VARCHAR2(128) | NO | 索引所在表的名字 | -| COLUMN_EXPRESSION | VARCHAR2(1000) | NO | function-base 索引的表达式 | -| COLUMN_POSITION | NUMBER(38) | NO | 列所在索引的位置 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/121.USER_IND_PARTITIONS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/121.USER_IND_PARTITIONS.md deleted file mode 100644 index fbeda5aa6..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/121.USER_IND_PARTITIONS.md +++ /dev/null @@ -1,75 +0,0 @@ -USER_IND_PARTITIONS -======================================== - - - -功能 ------------ - -查看当前用户为所有者的数据库中索引分区的信息,与 `ALL_IND_PARTITIONS`、`DBA_IND_PARTITIONS` 相比没有`INDEX_OWNER` 字段。 - -相关视图 -------------- - -* DBA_IND_PARTITIONS - - - -* ALL_IND_PARTITIONS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|---------------------------|----------------|----------------|---------------------------------------------------------------------------------------------------------------------------------------------------| -| INDEX_NAME | VARCHAR2(128) | NO | 索引名字 | -| COMPOSITE | VARCHAR2(3) | NO | 表示分区是否属于composited-partition 表的本地索引(YES)或者(NO) | -| PARTITION_NAME | VARCHAR2(128) | NO | 索引名称 | -| SUBPARTITION_COUNT | NUMBER(38) | YES | 子分区个数 | -| HIGH_VALUE | VARCHAR2(1024) | NO | 分区绑定 Value 的表达式 | -| HIGH_VALUE_LENGTH | NUMBER | NO | 分区绑定 Value 表达式的长度 | -| PARTITION_POSITION | NUMBER | NO | 分区在索引中的位置 | -| STATUS | VARCHAR2(8) | NO | 指示索引分区是否可用 | -| TABLESPACE_NAME | VARCHAR2(30) | NO | 包含分区的表空间的名称 | -| PCT_FREE | NUMBER | NO | 块中最小可用空间百分比。目前暂不支持该字段,当前该字段默认为 NULL | -| INI_TRANS | NUMBER | NO | 初始交易数。目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_TRANS | NUMBER | NO | 最大交易数。目前暂不支持该字段,当前该字段默认为 NULL | -| INITIAL_EXTENT | NUMBER | NO | 初始范围的大小,单位:字节。目前暂不支持该字段,当前该字段默认为 NULL | -| NEXT_EXTENT | NUMBER | NO | 辅助扩展区的大小,单位:字节。目前暂不支持该字段,当前该字段默认为 NULL | -| MIN_EXTENT | NUMBER | NO | 段中允许的最小范围数。目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_EXTENT | NUMBER | NO | 段中允许的最大扩展数。目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_SIZE | NUMBER | NO | 段中允许的最大块数。目前暂不支持该字段,当前该字段默认为 NULL | -| PCT_INCREASE | NUMBER | NO | 范围大小的百分比增加。目前暂不支持该字段,当前该字段默认为 NULL | -| FREELISTS | NUMBER | NO | 在此段中分配的进程空闲列表数。目前暂不支持该字段,当前该字段默认为 NULL | -| FREELIST_GROUPS | NUMBER | NO | 在此段中分配的进程自由列表组数。目前暂不支持该字段,当前该字段默认为 NULL | -| LOGGING | VARCHAR2(7) | NO | 指示是否记录对索引的更改。目前暂不支持该字段,当前该字段默认为 NULL | -| COMPRESSION | VARCHAR2(8) | NO | 表示分区索引是否开启压缩: * 开启(ENABLE) * 未开启(DISABLE) | -| BLEVEL | NUMBER | NO | B\*- 树级别(从根块到叶块的索引深度)。深度为 0 表示根块和叶块相同。目前暂不支持该字段,当前该字段默认为 NULL | -| LEAF_BLOCKS | NUMBER | NO | 索引分区中的叶块数。目前暂不支持该字段,当前该字段默认为 NULL | -| DISTINCT_KEYS | NUMBER | NO | 索引分区中不同键的数量。目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_LEAF_BLOCKS_PER_KEY | NUMBER | NO | 出现索引中每个不同值的叶块的平均数目,四舍五入到最接近的整数。对于强制执行 UNIQUE 和 PRIMARY KEY 约束的索引,此值始终为 1。目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_DATA_BLOCKS_PER_KEY | NUMBER | NO | 表中由索引中不同值四舍五入到最接近的整数所指向的平均数据块数。此统计数据是包含行的数据块的平均数量,这些行包含给定索引列的给定值。目前暂不支持该字段,当前该字段默认为 NULL | -| CLUSTERING_FACTOR | NUMBER | NO | 指示基于索引值的表中行的数量。目前暂不支持该字段,当前该字段默认为 NULL | -| NUM_ROWS | NUMBER | NO | ANALYZE 语句返回的行数。目前暂不支持该字段,当前该字段默认为 NULL | -| SAMPLE_SIZE | NUMBER | NO | 分析此分区时使用的样本量。目前暂不支持该字段,当前该字段默认为 NULL | -| LAST_ANALYZED | DATE | NO | 最近对该分区进行分析的日期。目前暂不支持该字段,当前该字段默认为 NULL | -| BUFFER_POOL | VARCHAR2(7) | NO | 分区的实际缓冲池。目前暂不支持该字段,当前该字段默认为 NULL | -| FLASH_CACHE | VARCHAR2(7) | NO | 用于分区块的数据库智能闪存缓存提示。目前暂不支持该字段,当前该字段默认为 NULL | -| CELL_FLASH_CACHE | VARCHAR2(7) | NO | 单元闪存缓存提示用于分区块。目前暂不支持该字段,当前该字段默认为 NULL | -| USER_STATS | VARCHAR2(3) | NO | 指示是否由用户直接输入统计信息。目前暂不支持该字段,当前该字段默认为 NULL | -| PCT_DIRECT_ACCESS | NUMBER | NO | 如果在索引组织表上有二级索引,则用 VALID 猜测的行百分比。目前暂不支持该字段,当前该字段默认为 NULL | -| GLOBAL_STATS | VARCHAR2(3) | NO | 指示是针对整个分区收集分区的统计信息,还是根据基础子分区的统计信息进行估计。目前暂不支持该字段,当前该字段默认为 NULL | -| DOMIDX_OPSTATUS | VARCHAR2(6) | NO | 与索引上的操作状态。目前暂不支持该字段,当前该字段默认为 NULL | -| PARAMETERS | VARCHAR2(1000) | NO | 对于域索引,参数字符串。目前暂不支持该字段,当前该字段默认为 NULL | -| INTERVAL | VARCHAR2(3) | NO | 指示分区是否在间隔分区表的间隔部分中或分区是否在范围部分中。目前暂不支持该字段,当前该字段默认为 NULL | -| SEGMENT_CREATED | VARCHAR2(3) | NO | 指示是否已创建索引分区段。 N/A 表示该索引已细分,并且分区级别不存在任何段。目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/122.USER_IND_SUBPARTITIONS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/122.USER_IND_SUBPARTITIONS.md deleted file mode 100644 index d7b8a208f..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/122.USER_IND_SUBPARTITIONS.md +++ /dev/null @@ -1,74 +0,0 @@ -USER_IND_SUBPARTITIONS -=========================================== - - - -功能 ------------ - -查看数据库中用户所拥有的所有索引子分区的信息,与 `DBA``_IND_SUBPARTITIONS`、`ALL_IND_SUBPARTITIONS` 相比没有 `INDEX_OWNER` 字段。 - -相关视图 -------------- - -* DBA_IND_SUBPARTITIONS - - - -* ALL_IND_SUBPARTITIONS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|---------------------------|----------------|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| INDEX_NAME | VARCHAR2(128) | NO | 索引名字 | -| PARTITION_NAME | VARCHAR2(128) | NO | 分区名字 | -| SUBPARTITION_NAME | VARCHAR2(128) | NO | 子分区名字 | -| HIGH_VALUE | VARCHAR2(1024) | NO | 子分区绑定 Value 的表达式 | -| HIGH_VALUE_LENGTH | NUMBER | NO | 子分区绑定 Value 表达式的长度 | -| SUBPARTITION_POSITION | NUMBER | NO | 子分区在分区的位置 | -| STATUS | VARCHAR2(8) | NO | 指示索引分区是否可用 | -| TABLESPACE_NAME | VARCHAR2(30) | NO | 包含分区的表空间的名称 | -| PCT_FREE | NUMBER | NO | 块中最小可用空间百分比。目前暂不支持该字段,当前该字段显示为 NULL | -| INI_TRANS | NUMBER | NO | 初始交易数。目前暂不支持该字段,当前该字段显示为 NULL | -| MAX_TRANS | NUMBER | NO | 最大交易数。目前暂不支持该字段,当前该字段显示为 NULL | -| INITIAL_EXTENT | NUMBER | NO | 初始范围的大小,单位:字节。目前暂不支持该字段,当前该字段显示为 NULL | -| NEXT_EXTENT | NUMBER | NO | 辅助扩展区的大小,单位:字节。目前暂不支持该字段,当前该字段显示为 NULL | -| MIN_EXTENT | NUMBER | NO | 段中允许的最小范围数。目前暂不支持该字段,当前该字段显示为 NULL | -| MAX_EXTENT | NUMBER | NO | 段中允许的最大扩展数。目前暂不支持该字段,当前该字段显示为 NULL | -| MAX_SIZE | NUMBER | NO | 段中允许的最大块数。目前暂不支持该字段,当前该字段显示为 NULL | -| PCT_INCREASE | NUMBER | NO | 范围大小的百分比增加。目前暂不支持该字段,当前该字段显示为 NULL | -| FREELISTS | NUMBER | NO | 在此段中分配的进程空闲列表数。目前暂不支持该字段,当前该字段显示为 NULL | -| FREELIST_GROUPS | NUMBER | NO | 在此段中分配的进程自由列表组数。目前暂不支持该字段,当前该字段显示为 NULL | -| LOGGING | VARCHAR2(7) | NO | 指示是否记录对索引的更改。目前暂不支持该字段,当前该字段显示为 NULL | -| COMPRESSION | VARCHAR2(8) | NO | 表示分区索引是否开启压缩: * 开启(ENABLE) * 未开启(DISABLE) | -| BLEVEL | NUMBER | NO | B树级别(从根块到叶块的索引深度)。深度为 0 表示根块和叶块相同。目前暂不支持该字段,当前该字段显示为 NULL | -| LEAF_BLOCKS | NUMBER | NO | 索引中的叶块数。目前暂不支持该字段,当前该字段显示为 NULL | -| DISTINCT_KEYS | NUMBER | NO | 索引分区中不同键的数量。目前暂不支持该字段,当前该字段显示为 NULL | -| AVG_LEAF_BLOCKS_PER_KEY | NUMBER | NO | 出现索引中每个不同值的叶块的平均数目,四舍五入到最接近的整数。对于强制执行 UNIQUE 和 PRIMARY KEY 约束的索引,此值始终为 1。目前暂不支持该字段,当前该字段显示为 NULL | -| AVG_DATA_BLOCKS_PER_KEY | NUMBER | NO | 表中由索引中不同值四舍五入到最接近的整数所指向的平均数据块数。此统计数据是包含行的数据块的平均数量,这些行包含给定索引列的给定值。目前暂不支持该字段,当前该字段显示为 NULL | -| CLUSTERING_FACTOR | NUMBER | NO | 指示基于索引值的表中行的数量。目前暂不支持该字段,当前该字段显示为 NULL | -| NUM_ROWS | NUMBER | NO | 此索引子分区中的行数。目前暂不支持该字段,当前该字段显示为 NULL | -| SAMPLE_SIZE | NUMBER | NO | 分析此子分区时使用的样本量。目前暂不支持该字段,当前该字段显示为 NULL | -| LAST_ANALYZED | DATE | NO | 最近对该分区进行分析的日期。目前暂不支持该字段,当前该字段显示为 NULL | -| BUFFER_POOL | VARCHAR2(7) | NO | 子分区的默认缓冲池。目前暂不支持该字段,当前该字段显示为 NULL | -| FLASH_CACHE | VARCHAR2(7) | NO | 用于子分区块的数据库智能闪存缓存提示。目前暂不支持该字段,当前该字段显示为 NULL | -| CELL_FLASH_CACHE | VARCHAR2(7) | NO | 单元闪存缓存提示将用于子分区块。目前暂不支持该字段,当前该字段显示为 NULL | -| USER_STATS | VARCHAR2(3) | NO | 指示是否由用户直接输入统计信息。OceanBase 数据库暂不支持该字段,目前该字段显示为 NULL | -| PCT_DIRECT_ACCESS | NUMBER | NO | 如果索引组织表上的二级索引,则具有有效猜测的行的百分比。目前暂不支持该字段,当前该字段显示为 NULL | -| GLOBAL_STATS | VARCHAR2(3) | NO | * 如果已收集统计信息,则GLOBAL_STATS 将为 YES * 如果未收集统计信息,则GLOBAL_STATS 将为 NO 目前暂不支持该字段,当前该字段显示为 NULL | -| DOMIDX_OPSTATUS | VARCHAR2(6) | NO | 域索引上的操作状态。目前暂不支持该字段,当前该字段显示为 NULL | -| PARAMETERS | VARCHAR2(1000) | NO | 对于域索引,参数字符串。目前暂不支持该字段,当前该字段显示为 NULL | -| INTERVAL | VARCHAR2(3) | NO | 指示分区是否在间隔分区表的间隔部分中(是)或分区是否在范围部分中(否)。目前暂不支持该字段,当前该字段显示为 NULL | -| SEGMENT_CREATED | VARCHAR2(3) | NO | 指示是否已创建索引子分区段。N/A 表示该索引未分区。目前暂不支持该字段,当前该字段显示为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/123.USER_OBJECTS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/123.USER_OBJECTS.md deleted file mode 100644 index e32c67c87..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/123.USER_OBJECTS.md +++ /dev/null @@ -1,48 +0,0 @@ -USER_OBJECTS -================================= - - - -功能 ------------ - -查看用户拥有的所有数据库对象,视图与 ALL_OBJECTS 一致,但没有 OWNER 列,因为 OWNER 就是自己本身。 - -相关视图 -------------- - -* ALL_OBJECTS - - - -* DBA_OBJECTS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------------|---------------|----------------|---------------------------------------------------------------------------------------------------------------------------------| -| OBJECT_NAME | VARCHAR2(128) | NO | 对象名字 | -| SUBOBJECT_NAME | VARCHAR2(128) | NO | 子对象名字(例如,partition) | -| OBJECT_ID | NUMBER(38) | NO | 对象的字典 ID 值 | -| DATA_OBJECT_ID | NUMBER | NO | 包含该对象 segment 的字典 ID 值 | -| OBJECT_TYPE | VARCHAR2(23) | NO | 对象类型,包括表、索引、分区、包、存储过程、同义词、序列等 | -| CREATED | DATE | NO | 对象创建时间 | -| LAST_DDL_TIME | DATE | NO | 对象最后一次 DDL 时间 | -| TIMESTAMP | VARCHAR2(256) | NO | 对象指定的时间戳,以字符形式输出 | -| STATUS | VARCHAR2(7) | NO | 对象状态: * VALID * INVALID | -| TEMPORARY | VARCHAR2(1) | NO | 表示该对象是一个临时对象 | -| GENERATED | VARCHAR2(1) | NO | 表示该对象的名字是否是由系统生成 | -| SECONDARY | VARCHAR2(1) | NO | 该字段暂未使用 | -| NAMESPACE | NUMBER | NO | 对象的命名空间 | -| EDITION_NAME | VARCHAR2(128) | NO | 保留字段 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/124.USER_PART_INDEXES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/124.USER_PART_INDEXES.md deleted file mode 100644 index df1144572..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/124.USER_PART_INDEXES.md +++ /dev/null @@ -1,62 +0,0 @@ -USER_PART_INDEXES -====================================== - - - -功能 ------------ - -查看属于当前用户的分区索引的分区信息。 - -相关视图 -------------- - -* DBA_PART_INDEXES - - - -* USER_PART_INDEXES - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|---------------------------|----------------|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| INDEX_NAME | VARCHAR2(30) | NO | 分区索引的名字 | -| TABLE_NAME | VARCHAR2(30) | NO | 索引所属的表的名字 | -| PARTITIONING_TYPE | VARCHAR2(9) | NO | 分区方式: * HASH * RANGE * LIST | -| SUBPARTITIONING_TYPE | VARCHAR2(9) | NO | 子分区的分区方式: * HASH * RANGE * LIST | -| PARTITION_COUNT | NUMBER | NO | 索引中分区个数 | -| DEF_SUBPARTITION_COUNT | NUMBER | NO | 对于复合分区索引, 表示子分区的个数 | -| PARTITIONING_KEY_COUNT | NUMBER | NO | 分区键的数量 | -| SUBPARTITIONING_KEY_COUNT | NUMBER | NO | 对于复合分区索引,表示子分区键的数量 | -| LOCALITY | VARCHAR2(6) | NO | 分区索引是局部(LOCAL)还是全局 (GLOBAL) | -| ALIGNMENT | VARCHAR2(12) | NO | 分区索引是前缀 (PREFIXED)还是非前缀 (NON_PREFIXED) | -| DEF_TABLESPACE_NAME | VARCHAR2(30) | NO | 对于局部索引, 添加或分割表分区时默认的表空间 | -| DEF_PCT_FREE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_INI_TRANS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_MAX_TRANS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_INITIAL_EXTENT | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_NEXT_EXTENT | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_MIN_EXTENTS | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_MAX_EXTENTS | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_MAX_SIZE | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_PCT_INCREASE | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_FREELISTS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_FREELIST_GROUPS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_LOGGING | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_BUFFER_POOL | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_CELL_FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_PARAMETERS | VARCHAR2(1000) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INTERVAL | VARCHAR2(1000) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/125.USER_PART_KEY_COLUMNS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/125.USER_PART_KEY_COLUMNS.md deleted file mode 100644 index 867d8100f..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/125.USER_PART_KEY_COLUMNS.md +++ /dev/null @@ -1,39 +0,0 @@ -USER_PART_KEY_COLUMNS -========================================== - - - -功能 ------------ - -查看当前用户拥有的所有分区对象中分区键包含的列。 - -相关视图 -------------- - -* DBA_PART_KEY_COLUMNS - - - -* ALL_PART_KEY_COLUMNS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------------|----------------|----------------|----------------------------------------------------------------------------------------------------------------------------------| -| NAME | VARCHAR2(128) | NO | 分区表或分区索引的名字 | -| OBJECT_TYPE | CHAR(5) | NO | 分区对象的类型: * TABLE * INDEX | -| COLUMN_NAME | VARCHAR2(4000) | NO | 列的名字 | -| COLUMN_POSITION | NUMBER | NO | 列在分区键中的位置 | -| COLLATED_COLUMN_ID | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/126.USER_PART_TABLES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/126.USER_PART_TABLES.md deleted file mode 100644 index 8b6c4f05e..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/126.USER_PART_TABLES.md +++ /dev/null @@ -1,61 +0,0 @@ -USER_PART_TABLES -===================================== - - - -功能 ------------ - -查看当前用户的分区表的分区信息。 - -相关视图 -------------- - -* DBA_PART_TABLES - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|---------------------------|----------------|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| TABLE_NAME | VARCHAR2(128) | NO | 分区表的名字 | -| PARTITIONING_TYPE | VARCHAR2(9) | NO | 分区方式: * HASH * RANGE * LIST | -| SUBPARTITIONING_TYPE | VARCHAR2(9) | NO | 子分区的分区方式: * HASH * RANGE * LIST | -| PARTITION_COUNT | NUMBER | NO | 分区表中分区个数 | -| DEF_SUBPARTITION_COUNT | NUMBER | NO | 对于复合分区表,表示子分区的个数 | -| PARTITIONING_KEY_COUNT | NUMBER | NO | 分区键的数量 | -| SUBPARTITIONING_KEY_COUNT | NUMBER | NO | 对于复合分区表,表示子分区键的数量 | -| STATUS | VARCHAR2(8) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_TABLESPACE_NAME | VARCHAR2(30) | NO | 分区表所属的表空间名 | -| DEF_PCT_FREE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_PCT_USED | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_INI_TRANS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_MAX_TRANS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_INITIAL_EXTENT | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_NEXT_EXTENT | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_MIN_EXTENT | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_EXTENT | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_MAX_SIZE | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_PCT_INCREASE | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_FREELISTS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_FREELIST_GROUPS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_LOGGING | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| COMPRESSION | VARCHAR2(8) | NO | 是否开启压缩 | -| COMPRESS_FOR | VARCHAR2(12) | NO | 压缩方法 | -| DEF_BUFFER_POOL | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_CELL_FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| REF_PTN_CONSTRAINT_NAME | VARCHAR2(30) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INTERVAL | VARCHAR2(1000) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| IS_NESTED | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_SEGMENT_CREATED | VARCHAR2(4) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/127.USER_PROCEDURES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/127.USER_PROCEDURES.md deleted file mode 100644 index 956fc1a3b..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/127.USER_PROCEDURES.md +++ /dev/null @@ -1,49 +0,0 @@ -USER_PROCEDURES -==================================== - - - -功能 ------------ - -列出当前用户可用的过程和函数。 - -相关视图 -------------- - -* DBA_PROCEDURES - - - -* ALL_PROCEDURES - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------------|---------------|----------------|------------------------------------------------| -| OBJECT_NAME | VARCHAR2(128) | YES | 包名 | -| PROCEDURE_NAME | VARCHAR2(128) | NO | 过程或者函数名 | -| OBJECT_ID | NUMBER | NO | 对象 ID | -| SUBPROGRAM_ID | NUMBER | NO | 出现在包中的顺序, 对于独立的过程或者函数该值为 1 | -| OVERLOAD | NUMBER | NO | 出现在包源文件中的第几次重载 | -| OBJECT_TYPE | VARCHAR2(9) | NO | 对象的类型 | -| AGGREGATE | VARCHAR2(3) | NO | 表示该过程是否为聚合函数。目前暂不支持该字段,当前该字段默认为 NO | -| PIPELINED | VARCHAR2(3) | NO | 表示该过程是否为管道表函数 | -| IMPLTYPEOWNER | VARCHAR2(30) | NO | 实现类型所有者的名称。目前暂不支持该字段,当前该字段默认为 NULL | -| IMPLTYPENAME | VARCHAR2(30) | NO | 实现类型的名称。目前暂不支持该字段,当前该字段默认为 NULL | -| PARALLEL | VARCHAR2(3) | NO | 指示过程或功能是否是并行启用的 | -| INTERFACE | VARCHAR2(3) | NO | 过程/函数是使用 ODCI 接口实现的表函数。目前暂不支持该字段,当前该字段默认为 NULL | -| DETERMINISTIC | VARCHAR2(3) | NO | 该过程/功能被声明为确定性的 | -| AUTHID | VARCHAR2(12) | NO | INVOKER/DEFINER | -| ORIGIN_CON_ID | NUMBER(38) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/128.USER_PROFILES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/128.USER_PROFILES.md deleted file mode 100644 index 0fe4148a4..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/128.USER_PROFILES.md +++ /dev/null @@ -1,38 +0,0 @@ -USER_PROFILES -================================== - - - -功能 ------------ - -查看所有的简介和这些简介的限制。 - -相关视图 -------------- - -* DBA_PROFILES - - - -* ALL_PROFILES - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|---------------|--------------|----------------|-----------------------------------| -| PROFILE | VARCHAR2(30) | NO | 简介的名称 | -| RESOURCE_NAME | VARCHAR2(32) | NO | 资源的名称 | -| RESOURCE_TYPE | VARCHAR2(8) | NO | 表明一个资源的简介是一个 KERNEL 还是一个 PASSWORD | -| LIMIT | VARCHAR2(40) | NO | 简介资源的限制 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/129.USER_ROLE_PRIVS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/129.USER_ROLE_PRIVS.md deleted file mode 100644 index 3a9fa4c47..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/129.USER_ROLE_PRIVS.md +++ /dev/null @@ -1,23 +0,0 @@ -USER_ROLE_PRIVS -==================================== - - - -功能 ------------ - -描述授予当前用户的角色。 - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------|--------------|----------------|----------------------------| -| GRANTEE | VARCHAR2(30) | NO | 用户的名称,或 PUBLIC | -| GRANTED_ROLE | VARCHAR2(30) | NO | 授予用户的角色名称 | -| ADMIN_OPTION | VARCHAR2(3) | NO | 指示授权是否带有 ADMIN 选项 | -| DEFAULT_ROLE | VARCHAR2(3) | NO | 指示角色是否被指定为用户的 DEFAULT ROLE | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/13.ALL_IND_PARTITIONS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/13.ALL_IND_PARTITIONS.md deleted file mode 100644 index a35392f3d..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/13.ALL_IND_PARTITIONS.md +++ /dev/null @@ -1,76 +0,0 @@ -ALL_IND_PARTITIONS -======================================= - - - -功能 ------------ - -查看用户可访问的数据库中索引分区的信息。 - -相关视图 -------------- - -* DBA_IND_PARTITIONS - - - -* USER_IND_PARTITIONS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|---------------------------|----------------|----------------|---------------------------------------------------------------------------------------------------------------------------------------------------| -| INDEX_OWNER | VARCHAR2(128) | NO | 索引所属的拥有者 | -| INDEX_NAME | VARCHAR2(128) | NO | 索引名字 | -| COMPOSITE | VARCHAR2(3) | NO | 表示分区是否属于composited-partition 表的本地索引(YSE) 或者(NO) | -| PARTITION_NAME | VARCHAR2(128) | NO | 索引名称 | -| SUBPARTITION_COUNT | NUMBER(38) | YES | 子分区个数 | -| HIGH_VALUE | VARCHAR2(1024) | NO | 分区绑定 Value 的表达式 | -| HIGH_VALUE_LENGTH | NUMBER | NO | 分区绑定 Value 表达式的长度 | -| PARTITION_POSITION | NUMBER | NO | 分区在索引中的位置 | -| STATUS | VARCHAR2(8) | NO | 指示索引分区是否可用 | -| TABLESPACE_NAME | VARCHAR2(30) | NO | 包含分区的表空间的名称 | -| PCT_FREE | NUMBER | NO | 块中最小可用空间百分比。目前暂不支持该字段,当前该字段默认为 NULL | -| INI_TRANS | NUMBER | NO | 初始交易数。目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_TRANS | NUMBER | NO | 最大交易数。目前暂不支持该字段,当前该字段默认为 NULL | -| INITIAL_EXTENT | NUMBER | NO | 初始范围的大小,单位:字节。目前暂不支持该字段,当前该字段默认为 NULL | -| NEXT_EXTENT | NUMBER | NO | 辅助扩展区的大小,单位:字节。目前暂不支持该字段,当前该字段默认为 NULL | -| MIN_EXTENT | NUMBER | NO | 段中允许的最小范围数。目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_EXTENT | NUMBER | NO | 段中允许的最大扩展数。目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_SIZE | NUMBER | NO | 段中允许的最大块数。目前暂不支持该字段,当前该字段默认为 NULL | -| PCT_INCREASE | NUMBER | NO | 范围大小的百分比增加。目前暂不支持该字段,当前该字段默认为 NULL | -| FREELISTS | NUMBER | NO | 在此段中分配的进程空闲列表数。目前暂不支持该字段,当前该字段默认为 NULL | -| FREELIST_GROUPS | NUMBER | NO | 在此段中分配的进程自由列表组数。目前暂不支持该字段,当前该字段默认为 NULL | -| LOGGING | VARCHAR2(7) | NO | 指示是否记录对索引的更改。目前暂不支持该字段,当前该字段默认为 NULL | -| COMPRESSION | VARCHAR2(8) | NO | 表示分区索引是否开启压缩: * 开启(ENABLE) * 未开启(DISABLE) | -| BLEVEL | NUMBER | NO | B\*- 树级别(从根块到叶块的索引深度)。深度为 0 表示根块和叶块相同。目前暂不支持该字段,当前该字段默认为 NULL | -| LEAF_BLOCKS | NUMBER | NO | 索引分区中的叶块数。目前暂不支持该字段,当前该字段默认为 NULL | -| DISTINCT_KEYS | NUMBER | NO | 索引分区中不同键的数量。目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_LEAF_BLOCKS_PER_KEY | NUMBER | NO | 出现索引中每个不同值的叶块的平均数目,四舍五入到最接近的整数。对于强制执行 UNIQUE 和 PRIMARY KEY 约束的索引,此值始终为 1。目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_DATA_BLOCKS_PER_KEY | NUMBER | NO | 表中由索引中不同值四舍五入到最接近的整数所指向的平均数据块数。此统计数据是包含行的数据块的平均数量,这些行包含给定索引列的给定值。目前暂不支持该字段,当前该字段默认为 NULL | -| CLUSTERING_FACTOR | NUMBER | NO | 指示基于索引值的表中行的数量。目前暂不支持该字段,当前该字段默认为 NULL | -| NUM_ROWS | NUMBER | NO | ANALYZE 语句返回的行数。目前暂不支持该字段,当前该字段默认为 NULL | -| SAMPLE_SIZE | NUMBER | NO | 分析此分区时使用的样本量。目前暂不支持该字段,当前该字段默认为 NULL | -| LAST_ANALYZED | DATE | NO | 最近对该分区进行分析的日期。目前暂不支持该字段,当前该字段默认为 NULL | -| BUFFER_POOL | VARCHAR2(7) | NO | 分区的实际缓冲池。目前暂不支持该字段,当前该字段默认为 NULL | -| FLASH_CACHE | VARCHAR2(7) | NO | 用于分区块的数据库智能闪存缓存提示。目前暂不支持该字段,当前该字段默认为 NULL | -| CELL_FLASH_CACHE | VARCHAR2(7) | NO | 单元闪存缓存提示用于分区块。目前暂不支持该字段,当前该字段默认为 NULL | -| USER_STATS | VARCHAR2(3) | NO | 指示是否由用户直接输入统计信息。目前暂不支持该字段,当前该字段默认为 NULL | -| PCT_DIRECT_ACCESS | NUMBER | NO | 如果在索引组织表上有二级索引,则用 VALID 猜测的行百分比。目前暂不支持该字段,当前该字段默认为 NULL | -| GLOBAL_STATS | VARCHAR2(3) | NO | 指示是针对整个分区收集分区的统计信息,还是根据基础子分区的统计信息进行估计。目前暂不支持该字段,当前该字段默认为 NULL | -| DOMIDX_OPSTATUS | VARCHAR2(6) | NO | 与索引上的操作状态。目前暂不支持该字段,当前该字段默认为 NULL | -| PARAMETERS | VARCHAR2(1000) | NO | 对于域索引,参数字符串。目前暂不支持该字段,当前该字段默认为 NULL | -| INTERVAL | VARCHAR2(3) | NO | 指示分区是否在间隔分区表的间隔部分中或分区是否在范围部分中。目前暂不支持该字段,当前该字段默认为 NULL | -| SEGMENT_CREATED | VARCHAR2(3) | NO | 指示是否已创建索引分区段。 N/A 表示该索引已细分,并且分区级别不存在任何段。目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/130.USER_SEGMENTS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/130.USER_SEGMENTS.md deleted file mode 100644 index b6942857b..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/130.USER_SEGMENTS.md +++ /dev/null @@ -1,46 +0,0 @@ -USER_SEGMENTS -================================== - - - -功能 ------------ - -查看当前用户下的对象拥有的段分配的存储信息。 - -相关视图 -------------- - -DBA_SEGMENTS - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|------------------|---------------|----------------|-----------------------------------------------| -| SEGMENT_NAME | VARCHAR2(128) | NO | 段名字(如果有) | -| PARTITION_NAME | VARCHAR2(128) | NO | 分区名字,如果是非分区对象,则为空值 NULL | -| SEGMENT_TYPE | VARCHAR2(18) | NO | 段类型 | -| SEGMENT_SUBTYPE | VARCHAR2(10) | NO | 大字段 LOB 段的子类型。目前暂不支持该字段,当前该字段默认为 NULL | -| TABLESPACE_NAME | VARCHAR2(30) | NO | 含有该段的表空间。目前暂不支持该字段,当前该字段默认为 NULL | -| BYTES | NUMBER(38) | NO | 段大小,单位:bytes | -| BLOCKS | NUMBER(38) | NO | 段块大小 | -| EXTENTS | NUMBER | NO | 段申请的簇数。目前暂不支持该字段,当前该字段默认为 NULL | -| INITIAL_EXTENT | NUMBER | NO | 段创建初始化时段簇的大小,单位:bytes。目前暂不支持该字段,当前该字段默认为 NULL | -| NEXT_EXTENT | NUMBER | NO | 段申请下一个簇的大小,单位:bytes。目前暂不支持该字段,当前该字段默认为 NULL | -| MIN_EXTENTS | NUMBER | NO | 段允许申请的最小簇数量。目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_EXTENTS | NUMBER | NO | 段允许申请的最大簇数量。目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_SIZE | NUMBER | NO | 段允许申请的最大块数量。目前暂不支持该字段,当前该字段默认为 NULL | -| RETENTION | VARCHAR2(7) | NO | SecureFile 的保留字段。目前暂不支持该字段,当前该字段默认为 NULL | -| MINRETENTION | NUMBER | NO | SecureFile 的最短保留时长。目前暂不支持该字段,当前该字段默认为 NULL | -| PCT_INCREASE | NUMBER | NO | 增加要分配的下一个数据块大小的百分比。目前暂不支持该字段,当前该字段默认为 NULL | -| FREELISTS | NUMBER | NO | 该段申请的空闲链表数。目前暂不支持该字段,当前该字段默认为 NULL | -| FREELIST_GROUPS | NUMBER | NO | 该段申请的空闲组数。目前暂不支持该字段,当前该字段默认为 NULL | -| BUFFER_POOL | VARCHAR2(7) | NO | 用于段块的缓冲池 | -| FLASH_CACHE | VARCHAR2(7) | NO | 用于段块的数据库智能闪存缓存提示 | -| CELL_FLASH_CACHE | VARCHAR2(7) | NO | 用于段块的单元闪存缓存提示 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/131.USER_SEQUENCES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/131.USER_SEQUENCES.md deleted file mode 100644 index f98b6b0c5..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/131.USER_SEQUENCES.md +++ /dev/null @@ -1,42 +0,0 @@ -USER_SEQUENCES -=================================== - - - -功能 ------------ - -列出当前用户拥有的所有 SEQUENCE。 - -相关视图 -------------- - -* ALL_SEQUENCES - - - -* DBA_SEQUENCES - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------|---------------|----------------|-------------------------| -| OBJECT_NAME | VARCHAR2(128) | NO | SEQUENCE 名 | -| MIN_VALUE | NUMBER(28) | NO | SEQUENCE 可取的最小值(含最小值) | -| MAX_VALUE | NUMBER(28) | NO | SEQUENCE 可取的最大值(含最大值) | -| INCREMENT_BY | NUMBER(28) | NO | 每次取值的步长,可为正整数或负整数,不可为 0 | -| CYCLE_FLAG | CHAR(1) | NO | 是否可以循环取值 | -| ORDER_FLAG | CHAR(1) | NO | 取值是否保证全局有序 | -| CACHE_SIZE | NUMBER(28) | NO | 每个节点缓存值的数量 | -| LAST_NUMBER | NUMBER(38) | NO | 记录下一个可分配给节点的值 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/132.USER_SOURCE.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/132.USER_SOURCE.md deleted file mode 100644 index 36989b48d..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/132.USER_SOURCE.md +++ /dev/null @@ -1,38 +0,0 @@ -USER_SOURCE -================================ - - - -功能 ------------ - -列出当前用户可用的过程和函数的源代码。 - -相关视图 -------------- - -* DBA_SOURCE - - - -* ALL_SOURCE - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|---------------|--------------|----------------|-------------------------| -| NAME | VARCHAR2(30) | NO | 对象名 | -| TYPE | VARCHAR2(12) | NO | 对象类型 | -| LINE | NUMBER | NO | TEXT 字段对应的源代码中的行号 | -| TEXT | CLOB | NO | 当前行的源代码 | -| ORIGIN_CON_ID | NUMBER(38) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/133.USER_SUBPARTITION_TEMPLATES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/133.USER_SUBPARTITION_TEMPLATES.md deleted file mode 100644 index 6afb62aa5..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/133.USER_SUBPARTITION_TEMPLATES.md +++ /dev/null @@ -1,39 +0,0 @@ -USER_SUBPARTITION_TEMPLATES -================================================ - - - -功能 ------------ - -查看所有子分区模版描述信息。 - -相关视图 -------------- - -* ALL_SUBPARTITION_TEMPLATES - - - -* DBA_SUBPARTITION_TEMPLATES - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-----------------------|----------------|----------------|-----------| -| TABLE_NAME | VARCHAR2(256) | NO | 分区表名字 | -| SUBPARTITION_NAME | VARCHAR2(64) | NO | 子分区名 | -| SUBPARTITION_POSITION | NUMBER | YES | 子分区位置 | -| TABLESPACE_NAME | VARCHAR2(30) | NO | 分区所属的表空间名 | -| HIGH_BOUND | VARCHAR2(1024) | NO | 分区模板表达式 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/134.USER_SUBPART_KEY_COLUMNS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/134.USER_SUBPART_KEY_COLUMNS.md deleted file mode 100644 index 8b0e22532..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/134.USER_SUBPART_KEY_COLUMNS.md +++ /dev/null @@ -1,39 +0,0 @@ -USER_SUBPART_KEY_COLUMNS -============================================= - - - -功能 ------------ - -查看当前用户拥有的所有分区对象中子分区键包含的列。 - -相关视图 -------------- - -* DBA_SUBPART_KEY_COLUMNS - - - -* ALL_SUBPART_KEY_COLUMNS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------------|----------------|----------------|----------------------------------------------------------------------------------------------------------------------------------| -| NAME | VARCHAR2(128) | NO | 分区表或分区索引的名字 | -| OBJECT_TYPE | CHAR(5) | NO | 分区对象的类型: * TABLE * INDEX | -| COLUMN_NAME | VARCHAR2(4000) | NO | 列的名字 | -| COLUMN_POSITION | NUMBER | NO | 列在分区键中的位置 | -| COLLATED_COLUMN_ID | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/135.USER_SYNONYMS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/135.USER_SYNONYMS.md deleted file mode 100644 index 8e411eeeb..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/135.USER_SYNONYMS.md +++ /dev/null @@ -1,37 +0,0 @@ -USER_SYNONYMS -================================== - - - -功能 ------------ - -查看当前用户所拥有的同义词。 - -相关视图 -------------- - -* ALL_SYNONYMS - - - -* DBA_SYNONYMS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------|---------------|----------------|----------------------------------------------------------| -| SYNONYM_NAME | VARCHAR2(128) | NO | 同义词名字 | -| TABLE_OWNER | VARCHAR2(128) | NO | 同义词引用对象的名字,这里的TABLE_NAME 仅仅是列名而已,同义词也可以是对其他对象(例如视图等)的同义词 | -| TABLE_NAME | VARCHAR2(128) | NO | 同义词引用的对象名字 | -| DB_LINK | VARCHAR2(128) | NO | 如果引用的是 DB Link,则表示 DB Link 的名字 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/136.USER_SYS_PRIVS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/136.USER_SYS_PRIVS.md deleted file mode 100644 index 53868a9d6..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/136.USER_SYS_PRIVS.md +++ /dev/null @@ -1,27 +0,0 @@ -USER_SYS_PRIVS -=================================== - - - -功能 ------------ - -列出了授予当前用户的系统权限。 - -相关视图 -------------- - -DBA_SYS_PRIVS - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------|---------------|----------------|------------------| -| GRANTEE | VARCHAR2(128) | NO | 接受授权的受让人名称、用户或角色 | -| PRIVILEGE | VARCHAR2(40) | NO | 系统权限 | -| ADMIN_OPTION | VARCHAR2(3) | NO | 授予管理选项 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/137.USER_TAB_SUBPARTITIONS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/137.USER_TAB_SUBPARTITIONS.md deleted file mode 100644 index 2bad3cbfc..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/137.USER_TAB_SUBPARTITIONS.md +++ /dev/null @@ -1,71 +0,0 @@ -USER_TAB_SUBPARTITIONS -=========================================== - - - -功能 ------------ - -描述了当前用户拥有的每个表子分区的子分区名、表的名称和它所属的分区以及它的存储属性。 - -相关视图 -------------- - -* ALL_TAB_SUBPARTITIONS - - - -* DBA_TAB_SUBPARTITIONS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-----------------------|----------------|----------------|-----------------------| -| TABLE_NAME | VARCHAR2(128) | NO | 表名 | -| PARTITION_NAME | VARCHAR2(128) | NO | 分区名称 | -| SUBPARTITION_NAME | VARCHAR2(128) | NO | 子分区名称 | -| HIGH_VALUE | VARCHAR2(1024) | NO | 子分区表达式 | -| HIGH_VALUE_LENGTH | NUMBER | NO | 子分区表达式的长度 | -| SUBPARTITION_POSITION | NUMBER | NO | 子分区在分区中的位置 | -| TABLESPACE_NAME | VARCHAR2(30) | NO | 包含子分区的表空间的名称 | -| PCT_FREE | NUMBER | NO | 目前暂不支持该字段,该字段默认为 NULL | -| PCT_USED | NUMBER | NO | 目前暂不支持该字段,该字段默认为 NULL | -| INI_TRANS | NUMBER | NO | 目前暂不支持该字段,该字段默认为 NULL | -| MAX_TRANS | NUMBER | NO | 目前暂不支持该字段,该字段默认为 NULL | -| INITIAL_EXTENT | NUMBER | NO | 目前暂不支持该字段,该字段默认为 NULL | -| NEXT_EXTENT | NUMBER | NO | 目前暂不支持该字段,该字段默认为 NULL | -| MIN_EXTENT | NUMBER | NO | 目前暂不支持该字段,该字段默认为 NULL | -| MAX_EXTENT | NUMBER | NO | 目前暂不支持该字段,该字段默认为 NULL | -| MAX_SIZE | NUMBER | NO | 目前暂不支持该字段,该字段默认为 NULL | -| PCT_INCREASE | NUMBER | NO | 目前暂不支持该字段,该字段默认为 NULL | -| FREELISTS | NUMBER | NO | 目前暂不支持该字段,该字段默认为 NULL | -| FREELIST_GROUPS | NUMBER | NO | 目前暂不支持该字段,该字段默认为 NULL | -| LOGGING | VARCHAR2(3) | NO | 目前暂不支持该字段,该字段默认为 NULL | -| COMPRESSION | VARCHAR2(8) | NO | 子分区是否压缩 | -| COMPRESS_FOR | VARCHAR2(12) | YES | 压缩方法 | -| NUM_ROWS | NUMBER | NO | 目前暂不支持该字段,该字段默认为 NULL | -| BLOCKS | NUMBER | NO | 目前暂不支持该字段,该字段默认为 NULL | -| EMPTY_BLOCKS | NUMBER | NO | 目前暂不支持该字段,该字段默认为 NULL | -| AVG_SPACE | NUMBER | NO | 目前暂不支持该字段,该字段默认为 NULL | -| CHAIN_CNT | NUMBER | NO | 目前暂不支持该字段,该字段默认为 NULL | -| AVG_ROW_LEN | NUMBER | NO | 目前暂不支持该字段,该字段默认为 NULL | -| SAMPLE_SIZE | NUMBER | NO | 目前暂不支持该字段,该字段默认为 NULL | -| LAST_ANALYZED | DATE | NO | 目前暂不支持该字段,该字段默认为 NULL | -| BUFFER_POOL | VARCHAR2(7) | NO | 目前暂不支持该字段,该字段默认为 NULL | -| FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,该字段默认为 NULL | -| CELL_FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,该字段默认为 NULL | -| GLOBAL_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,该字段默认为 NULL | -| USER_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,该字段默认为 NULL | -| INTERVAL | VARCHAR2(3) | NO | 目前暂不支持该字段,该字段默认为 NULL | -| SEGMENT_CREATED | VARCHAR2(3) | NO | 目前暂不支持该字段,该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/138.USER_TRIGGERS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/138.USER_TRIGGERS.md deleted file mode 100644 index b83bd57f9..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/138.USER_TRIGGERS.md +++ /dev/null @@ -1,54 +0,0 @@ -USER_TRIGGERS -================================== - - - -功能 ------------ - -描述当前用户拥有的触发器。 - -相关视图 -------------- - -* ALL_TRIGGERS - - - -* DBA_TRIGGERS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-------------------|-----------------|----------------|------------------------------------------------------------------------------------------------------------------------------------------| -| TRIGGER_NAME | VARCHAR2(128) | NO | 触发器名字 | -| TRIGGER_TYPE | VARCHAR2(16) | NO | 触发器类型: * BEFORE/AFTER * ROW/STMT | -| TRIGGERING_EVENT | VARCHAR2(246) | NO | 触发事件,当前 OceanBase 数据库仅支持 INSERT、UPDATE、DELETE等。 | -| TABLE_OWNER | VARCHAR2(128) | NO | 表 OWNER,触发对象类型为表时有效。 | -| BASE_OBJECT_TYPE | VARCHAR2(18) | NO | 触发对象类型,当前 OceanBase 数据库仅支持 TABLE。 | -| TABLE_NAME | VARCHAR2(256) | NO | 表名,触发对象类型为表时有效。 | -| COLUMN_NAME | VARCHAR2(4000) | NO | 列名,仅在触发对象为嵌套表时有效,其它情况为 NULL。 | -| REFERENCING_NAMES | VARCHAR2(422) | NO | REF 名,OLD 和 NEW 的别名。 | -| WHEN_CLAUSE | VARCHAR2(4000) | YES | 触发条件 | -| STATUS | VARCHAR2(8) | NO | 状态: * ENABLE * DISABLE | -| DESCRIPTION | VARCHAR2(65536) | NO | 触发器描述,包括名字、类型、事件信息。当前 OceanBase 数据库包含的信息比 Oracle 更多。 | -| ACTION_TYPE | VARCHAR2(11) | NO | ACTION 类型,当前 OceanBase 数据库仅支持 PL/SQL。 | -| TRIGGER_BODY | VARCHAR2(65536) | NO | 触发器语句,当前 OceanBase 数据库包含的信息比 Oracle 更多。 | -| CROSSEDITION | VARCHAR2(7) | NO | 跨版本信息。目前暂不支持该字段 | -| BEFORE_STATEMENT | VARCHAR2(3) | NO | 语句前,YES/NO。表示组合触发器是否包含指定类型的 Section。 | -| BEFORE_ROW | VARCHAR2(3) | NO | 行前,YES/NO。表示组合触发器是否包含指定类型的 Section。 | -| AFTER_ROW | VARCHAR2(3) | NO | 行后,YES/NO。表示组合触发器是否包含指定类型的 Section。 | -| AFTER_STATEMENT | VARCHAR2(3) | NO | 语句后,YES/NO。表示组合触发器是否包含指定类型的 Section。 | -| INSTEAD_OF_ROW | VARCHAR2(3) | NO | 代替,YES/NO。表示组合触发器是否包含指定类型的 Section。 | -| FIRE_ONCE | VARCHAR2(3) | NO | 目前暂不支持该字段 | -| APPLY_SERVER_ONLY | VARCHAR2(3) | NO | 目前暂不支持该字段 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/139.USER_TABLES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/139.USER_TABLES.md deleted file mode 100644 index bb71cc60b..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/139.USER_TABLES.md +++ /dev/null @@ -1,87 +0,0 @@ -USER_TABLES -================================ - - - -功能 ------------ - -查看当前用户拥有的所有表。 - -相关视图 -------------- - -* ALL_TABLES - - - -* DBA_TABLES - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|---------------------------|---------------|----------------|---------------------------------------------------------------------------------------------------------------------------------| -| TABLE_NAME | VARCHAR2(128) | NO | 表名 | -| TABLESPACE_NAME | VARCHAR2(30) | NO | 包含该表的表空间名字 | -| CLUSTER_NAME | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| IOT_NAME | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| STATUS | VARCHAR2(8) | NO | 表状态: * VALID * UNUSABLE | -| PCT_FREE | NUMBER | NO | 块的最小空闲空间比例 | -| PCT_USED | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INI_TRANS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_TRANS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INITIAL_EXTENT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NEXT_EXTENT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MIN_EXTENTS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_EXTENTS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| PCT_INCREASE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| FREELISTS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| FREELIST_GROUPS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| LOGGING | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| BACKED_UP | VARCHAR2(1) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NUM_ROWS | NUMBER | NO | 表行数 | -| BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| EMPTY_BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_SPACE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CHAIN_CNT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_ROW_LEN | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_SPACE_FREELIST_BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NUM_FREELIST_BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEGREE | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INSTANCES | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CACHE | VARCHAR2(20) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| TABLE_LOCK | VARCHAR2(8) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| SAMPLE_SIZE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| LAST_ANALYZED | DATE | NO | 目前暂不支持该字段,该字段默认为 NULL | -| PARTITIONED | VARCHAR2(3) | NO | 目前暂不支持该字段,该字段默认为 NULL | -| IOT_TYPE | VARCHAR2(12) | NO | 目前暂不支持该字段,该字段默认为 NULL | -| TEMPORARY | VARCHAR2(1) | NO | 指定表是否是临时表 | -| SECONDARY | VARCHAR2(1) | NO | 目前暂不支持该字段,该字段默认为 NULL | -| NESTED | VARCHAR2(3) | NO | 目前暂不支持该字段,该字段默认为 NULL | -| BUFFER_POOL | VARCHAR2(7) | NO | 目前暂不支持该字段,该字段默认为 NULL | -| FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,该字段默认为 NULL | -| CELL_FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,该字段默认为 NULL | -| ROW_MOVEMENT | VARCHAR2(8) | NO | 目前暂不支持该字段,该字段默认为 NULL | -| GLOBAL_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,该字段默认为 NULL | -| USER_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,该字段默认为 NULL | -| DURATION | VARCHAR2(15) | NO | 指示临时表的持续时间 | -| SKIP_CORRUPT | VARCHAR2(8) | NO | 目前暂不支持该字段,该字段默认为 NULL | -| MONITORING | VARCHAR2(3) | NO | 目前暂不支持该字段,该字段默认为 NULL | -| CLUSTER_OWNER | VARCHAR2(30) | NO | 目前暂不支持该字段,该字段默认为 NULL | -| DEPENDENCIES | VARCHAR2(8) | NO | 目前暂不支持该字段,该字段默认为 NULL | -| COMPRESSION | VARCHAR2(8) | NO | 目前暂不支持该字段,该字段默认为 NULL | -| COMPRESS_FOR | VARCHAR2(12) | NO | 目前暂不支持该字段,该字段默认为 NULL | -| DROPPED | VARCHAR2(3) | NO | 表示被删除表是否在回收站里 | -| READ_ONLY | VARCHAR2(3) | NO | 目前暂不支持该字段,该字段默认为 NULL | -| SEGMENT_CREATED | VARCHAR2(3) | NO | 目前暂不支持该字段,该字段默认为 NULL | -| RESULT_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,该字段默认为 NULL | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/14.ALL_IND_SUBPARTITIONS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/14.ALL_IND_SUBPARTITIONS.md deleted file mode 100644 index f38a24afd..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/14.ALL_IND_SUBPARTITIONS.md +++ /dev/null @@ -1,75 +0,0 @@ -ALL_IND_SUBPARTITIONS -========================================== - - - -功能 ------------ - -查看数据库中用户可以访问的所有索引子分区的信息。 - -相关视图 -------------- - -* DBA_IND_SUBPARTITIONS - - - -* USER_IND_SUBPARTITIONS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|---------------------------|----------------|----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| INDEX_OWNER | VARCHAR2(128) | NO | 索引所属的拥有者 | -| INDEX_NAME | VARCHAR2(128) | NO | 索引名字 | -| PARTITION_NAME | VARCHAR2(128) | NO | 分区名字 | -| SUBPARTITION_NAME | VARCHAR2(128) | NO | 子分区名字 | -| HIGH_VALUE | VARCHAR2(1024) | NO | 子分区绑定 Value 的表达式 | -| HIGH_VALUE_LENGTH | NUMBER | NO | 子分区绑定 Value 表达式的长度 | -| SUBPARTITION_POSITION | NUMBER | NO | 子分区在分区的位置 | -| STATUS | VARCHAR2(8) | NO | 指示索引分区是否可用 | -| TABLESPACE_NAME | VARCHAR2(30) | NO | 包含分区的表空间的名称 | -| PCT_FREE | NUMBER | NO | 块中最小可用空间百分比。目前暂不支持该字段,当前该字段默认为 NULL | -| INI_TRANS | NUMBER | NO | 初始交易数。目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_TRANS | NUMBER | NO | 最大交易数。目前暂不支持该字段,当前该字段默认为 NULL | -| INITIAL_EXTENT | NUMBER | NO | 初始范围的大小(以字节为单位)。目前暂不支持该字段,当前该字段默认为 NULL | -| NEXT_EXTENT | NUMBER | NO | 辅助扩展区的大小(以字节为单位)。目前暂不支持该字段,当前该字段默认为 NULL | -| MIN_EXTENT | NUMBER | NO | 段中允许的最小范围数。目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_EXTENT | NUMBER | NO | 段中允许的最大扩展数。目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_SIZE | NUMBER | NO | 段中允许的最大块数。目前暂不支持该字段,当前该字段默认为 NULL | -| PCT_INCREASE | NUMBER | NO | 范围大小的百分比增加。目前暂不支持该字段,当前该字段默认为 NULL | -| FREELISTS | NUMBER | NO | 在此段中分配的进程空闲列表数。目前暂不支持该字段,当前该字段默认为 NULL | -| FREELIST_GROUPS | NUMBER | NO | 在此段中分配的进程自由列表组数。目前暂不支持该字段,当前该字段默认为 NULL | -| LOGGING | VARCHAR2(7) | NO | 指示是否记录对索引的更改。目前暂不支持该字段,当前该字段默认为 NULL | -| COMPRESSION | VARCHAR2(8) | NO | 表示分区索引是否开启压缩: * 开启(ENABLE) * 未开启(DISABLE) | -| BLEVEL | NUMBER | NO | B树级别(从根块到叶块的索引深度)。深度为 0 表示根块和叶块相同。目前暂不支持该字段,当前该字段默认为 NULL | -| LEAF_BLOCKS | NUMBER | NO | 索引中的叶块数。目前暂不支持该字段,当前该字段默认为 NULL | -| DISTINCT_KEYS | NUMBER | NO | 索引分区中不同键的数量。目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_LEAF_BLOCKS_PER_KEY | NUMBER | NO | 出现索引中每个不同值的叶块的平均数目,四舍五入到最接近的整数。对于强制执行 UNIQUE 和 PRIMARY KEY 约束的索引,此值始终为 1。目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_DATA_BLOCKS_PER_KEY | NUMBER | NO | 表中由索引中不同值四舍五入到最接近的整数所指向的平均数据块数。此统计数据是包含行的数据块的平均数量,这些行包含给定索引列的指定值。目前暂不支持该字段,当前该字段默认为 NULL | -| CLUSTERING_FACTOR | NUMBER | NO | 指示基于索引值的表中行的数量。目前暂不支持该字段,当前该字段默认为 NULL | -| NUM_ROWS | NUMBER | NO | 此索引子分区中的行数。目前暂不支持该字段,当前该字段默认为 NULL | -| SAMPLE_SIZE | NUMBER | NO | 分析此子分区时使用的样本量。目前暂不支持该字段,当前该字段默认为 NULL | -| LAST_ANALYZED | DATE | NO | 最近对该分区进行分析的日期。目前暂不支持该字段,当前该字段默认为 NULL | -| BUFFER_POOL | VARCHAR2(7) | NO | 子分区的默认缓冲池。目前暂不支持该字段,当前该字段默认为 NULL | -| FLASH_CACHE | VARCHAR2(7) | NO | 用于子分区块的数据库智能闪存缓存提示。目前暂不支持该字段,当前该字段默认为 NULL | -| CELL_FLASH_CACHE | VARCHAR2(7) | NO | 单元闪存缓存提示将用于子分区块。目前暂不支持该字段,当前该字段默认为 NULL | -| USER_STATS | VARCHAR2(3) | NO | 指示是否由用户直接输入统计信息。目前暂不支持该字段,当前该字段默认为 NULL | -| PCT_DIRECT_ACCESS | NUMBER | NO | 如果索引组织表上的二级索引,则具有有效猜测的行的百分比。目前暂不支持该字段,当前该字段默认为 NULL | -| GLOBAL_STATS | VARCHAR2(3) | NO | * 如果已收集统计信息,则 GLOBAL_STATS 将为 YES * 如果未收集统计信息,则 GLOBAL_STATS 将为 NO 目前暂不支持该字段,当前该字段默认为 NULL | -| DOMIDX_OPSTATUS | VARCHAR(6) | NO | 域索引上的操作状态。目前暂不支持该字段,当前该字段默认为 NULL | -| PARAMETERS | VARCHAR2(1000) | NO | 对于域索引,参数字符串。目前暂不支持该字段,当前该字段默认为 NULL | -| INTERVAL | VARCHAR2(3) | NO | 指示分区是否在间隔分区表的间隔部分中(是)或分区是否在范围部分中(否)。目前暂不支持该字段,当前该字段默认为 NULL | -| SEGMENT_CREATED | VARCHAR2(3) | NO | 指示是否已创建索引子分区段。 N/A 表示该索引未分区。目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/140.USER_TABLESPACES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/140.USER_TABLESPACES.md deleted file mode 100644 index e29e55bb7..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/140.USER_TABLESPACES.md +++ /dev/null @@ -1,47 +0,0 @@ -USER_TABLESPACES -===================================== - - - -功能 ------------ - -USER_TABLESPACES 用于展示所有的 Tablespace。 - -相关视图 -------------- - -DBA_TABLESPACES - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------------------|--------------|----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| TABLESPACE_NAME | VARCHAR2(30) | NO | 表空间的名称。 | -| BLOCK_SIZE | NUMBER | NO | 表空间块大小。目前暂不支持该字段,当前该字段默认为 NULL。 | -| INITIAL_EXTENT | NUMBER | NO | 默认初始区段大小。目前暂不支持该字段,该字段默认为 NULL。 | -| NEXT_EXTENT | NUMBER | NO | 默认增量区段大小。目前暂不支持该字段,当前该字段默认为 NULL。 | -| MIN_EXTENTS | NUMBER | NO | 默认的最小扩展数。目前暂不支持该字段,当前该字段默认为 NULL。 | -| MAX_EXTENTS | NUMBER | NO | 默认的最大扩展数。目前暂不支持该字段,当前该字段默认为 NULL。 | -| MAX_SIZE | NUMBER | NO | 段的默认最大大小。目前暂不支持该字段,当前该字段默认为 NULL。 | -| PCT_INCREASE | NUMBER | NO | 区段大小的默认增加百分比。目前暂不支持该字段,当前该字段默认为 NULL。 | -| MIN_EXTLEN | NUMBER | NO | 此表空间的最小区段大小。目前暂不支持该字段,当前该字段默认为 NULL。 | -| STATUS | VARCHAR2(9) | NO | 表空间状态: * ONLINE * OFFLINE * READ ONLY 目前暂不支持该字段,当前该字段默认为 NULL。 | -| CONTENTS | VARCHAR2(9) | NO | 表内容: * UNDO * PERMANENT * TEMPORARY 目前暂不支持该字段,当前该字段默认为 NULL。 | -| LOGGING | VARCHAR2(9) | NO | 默认的日志记录属性: * LOGGING * NOLOGGING 目前暂不支持该字段,当前该字段默认为 NULL。 | -| FORCE_LOGGING | VARCHAR2(3) | NO | 指示表空间是否处于强制日志记录模式。目前暂不支持该字段,当前该字段默认为 NULL。 | -| EXTENT_MANAGEMENT | VARCHAR2(10) | NO | 指示表空间中的区段是字典管理的还是本地管理。目前暂不支持该字段,当前该字段默认为 NULL。 | -| ALLOCATION_TYPE | VARCHAR2(9) | NO | 表空间中有效的区段分配类型: * SYSTEM * UNIFORM * USER 目前暂不支持该字段,当前该字段默认为 NULL。 | -| SEGMENT_SPACE_MANAGEMENT | VARCHAR2(6) | NO | 指示表空间中的空闲和使用的段空间是使用空闲列表还是位图来管理。目前暂不支持该字段,当前该字段默认为 NULL。 | -| DEF_TAB_COMPRESSION | VARCHAR2(8) | NO | 指示是否启用默认表压缩。 | -| RETENTION | VARCHAR2(11) | NO | 撤消表空间保留: * GUARANTEE * A RETENTION * NOGUARANTEE * NOT APPLY 目前暂不支持该字段,当前该字段默认为 NULL。 | -| BIGFILE | VARCHAR2(3) | NO | 指示表空间是大文件表空间还是小文件表空间。目前暂不支持该字段,当前该字段默认为 NULL。 | -| PREDICATE_EVALUATION | VARCHAR2(7) | NO | 指示谓词是由主机计算还是由存储计算。目前暂不支持该字段,当前该字段默认为 NULL。 | -| ENCRYPTED | VARCHAR2(3) | NO | 指示表空间是否加密或不加密。目前暂不支持该字段,当前该字段默认为 NULL。 | -| COMPRESS_FOR | VARCHAR2(12) | NO | 默认压缩操作的类型。 OceanBase 数据库暂不支持该字段,目前该字段默认为 NULL。 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/141.USER_TAB_COLS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/141.USER_TAB_COLS.md deleted file mode 100644 index 8c0dfaa9a..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/141.USER_TAB_COLS.md +++ /dev/null @@ -1,71 +0,0 @@ -USER_TAB_COLS -================================== - - - -功能 ------------ - -查看当前用户拥有的表、视图、集群的所有列。 - -这个视图与 USER_TABLE_COLUMNS 区别在于没有对隐藏列进行过滤。 - -相关视图 -------------- - -* ALL_TAB_COLS - - - -* DBA_TAB_COLS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------------------|----------------|----------------|-------------------------------------------------------------------------------------------------------------------------------| -| TABLE_NAME | VARCHAR2(128) | NO | 表、视图的名字 | -| COLUMN_NAME | VARCHAR2(128) | NO | 列名 | -| DATA_TYPE | VARCHAR2(128) | NO | 列类型 | -| DATA_TYPE_MOD | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DATA_TYPE_OWNER | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DATA_LENGTH | NUMBER | NO | 列长度,单位:bytes | -| DATA_PRECISION | NUMBER | NO | 数字数据类型的十进制精度;浮点数据类型的二进制精度;所有其他数据类型为空值 | -| DATA_SCALE | NUMBER | NO | 数值小数点右边的数字 | -| NULLABLE | VARCHAR2(1) | NO | 列是否允许为空 | -| COLUMN_ID | NUMBER | NO | 列序号 | -| DEFAULT_LENGTH | NUMBER | NO | 列默认长度 | -| DATA_DEFAULT | VARCHAR2(128) | NO | 列默认值 | -| NUM_DISTINCT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| LOW_VALUE | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| HIGH_VALUE | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DENSITY | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NUM_NULLS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NUM_BUCKETS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| LAST_ANALYZED | DATE | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| SAMPLE_SIZE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CHARACTER_SET_NAME | VARCHAR2(44) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CHAR_COL_DECL_LENGTH | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| GLOBAL_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| USER_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_COL_LEN | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CHAR_LENGTH | NUMBER | NO | 字符类型的列长度 | -| CHAR_USED | VARCHAR2(1) | NO | 表示列是按照字节长度还是字符长度 | -| V80_FMT_IMAGE | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DATA_UPGRADED | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| HIDDEN_COLUMN | VARCHAR2(3) | NO | 表示列是否是隐藏列: * YES * NO | -| VIRTUAL_COLUMN | VARCHAR2(3) | NO | 表示列是否是虚拟列: * YES * NO | -| SEGMENT_COLUMN_ID | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INTERNAL_COLUMN_ID | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| HISTOGRAM | VARCHAR2(15) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| QUALIFIED_COL_NAME | VARCHAR2(4000) | NO | 限定列名 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/142.USER_TAB_COLUMNS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/142.USER_TAB_COLUMNS.md deleted file mode 100644 index c1d03c75b..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/142.USER_TAB_COLUMNS.md +++ /dev/null @@ -1,63 +0,0 @@ -USER_TAB_COLUMNS -===================================== - - - -功能 ------------ - -查看当前用户拥有的表、视图、集群的所有列。 - -相关视图 -------------- - -* ALL_TAB_COLUMNS - - - -* DBA_TAB_COLUMNS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------------------|---------------|----------------|---------------------------------------| -| TABLE_NAME | VARCHAR2(128) | NO | 表、视图的名字 | -| COLUMN_NAME | VARCHAR2(128) | NO | 列名 | -| DATA_TYPE | VARCHAR2(128) | NO | 列类型 | -| DATA_TYPE_MOD | VARCHAR2(3) | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| DATA_TYPE_OWNER | VARCHAR2(128) | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| DATA_LENGTH | NUMBER | NO | 列长度,单位:bytes | -| DATA_PRECISION | NUMBER | NO | 数字数据类型的十进制精度;浮点数据类型的二进制精度;所有其他数据类型为空值 | -| DATA_SCALE | NUMBER | NO | 数值小数点右边的数字 | -| NULLABLE | VARCHAR2(1) | NO | 列是否允许为空 | -| COLUMN_ID | NUMBER | NO | 列序号 | -| DEFAULT_LENGTH | NUMBER | NO | 列默认长度 | -| DATA_DEFAULT | VARCHAR2(128) | NO | 列默认值 | -| NUM_DISTINCT | NUMBER | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| LOW_VALUE | VARCHAR2(128) | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| HIGH_VALUE | VARCHAR2(128) | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| DENSITY | NUMBER | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| NUM_NULLS | NUMBER | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| NUM_BUCKETS | NUMBER | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| LAST_ANALYZED | DATE | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| SAMPLE_SIZE | NUMBER | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| CHARACTER_SET_NAME | VARCHAR2(44) | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| CHAR_COL_DECL_LENGTH | NUMBER | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| GLOBAL_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| USER_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| AVG_COL_LEN | NUMBER | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| CHAR_LENGTH | NUMBER | NO | 字符类型的列长度 | -| CHAR_USED | VARCHAR2(1) | NO | 表示列是按照字节长度还是字符长度 | -| V80_FMT_IMAGE | VARCHAR2(3) | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| DATA_UPGRADED | VARCHAR2(3) | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| HISTOGRAM | VARCHAR2(15) | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/143.USER_TAB_COMMENTS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/143.USER_TAB_COMMENTS.md deleted file mode 100644 index 4ae0f9787..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/143.USER_TAB_COMMENTS.md +++ /dev/null @@ -1,37 +0,0 @@ -USER_TAB_COMMENTS -====================================== - - - -功能 ------------ - -查看当前用户拥有的表、视图的注释。 - -相关视图 -------------- - -* ALL_TAB_COMMENTS - - - -* DBA_TAB_COMMENTS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|------------|----------------|----------------|---------| -| TABLE_NAME | VARCHAR2(128) | NO | 表、视图的名字 | -| TABLE_TYPE | VARCHAR2(11) | NO | 对象类型 | -| COMMENTS | VARCHAR2(4000) | NO | 对象注释 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/144.USER_TAB_PARTITIONS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/144.USER_TAB_PARTITIONS.md deleted file mode 100644 index 201bf2612..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/144.USER_TAB_PARTITIONS.md +++ /dev/null @@ -1,74 +0,0 @@ -USER_TAB_PARTITIONS -======================================== - - - -功能 ------------ - -查看属于当前用户的多级分区信息、分区存储参数和分区统计信息。 - -相关视图 -------------- - -* DBA_TAB_PARTITIONS - - - -* ALL_TAB_PARTITIONS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|------------------------|----------------|----------------|--------------------------| -| TABLE_NAME | VARCHAR2(128) | NO | 分区表名字 | -| COMPOSITE | VARCHAR2(3) | NO | 是否为多级分区 | -| PARTITION_NAME | VARCHAR2(128) | NO | 分区名 | -| SUBPARTITION_COUNT | NUMBER | YES | 子分区个数 | -| HIGH_VALUE | VARCHAR2(1024) | NO | 分区表达式 | -| HIGH_VALUE_LENGTH | NUMBER | NO | 分区表达式的长度 | -| PARTITION_POSITION | NUMBER | NO | 分区的位置 | -| TABLESPACE_NAME | VARCHAR2(30) | NO | 分区所属的表空间名 | -| PCT_FREE | NUMBER | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| PCT_USED | NUMBER | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| INI_TRANS | NUMBER | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| MAX_TRANS | NUMBER | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| INITIAL_EXTENT | NUMBER | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| NEXT_EXTENT | NUMBER | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| MIN_EXTENT | NUMBER | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| MAX_EXTENT | NUMBER | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| MAX_SIZE | NUMBER | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| PCT_INCREASE | NUMBER | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| FREELISTS | NUMBER | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| FREELIST_GROUPS | NUMBER | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| LOGGING | VARCHAR2(7) | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| COMPRESSION | VARCHAR2(8) | NO | 是否开启压缩 | -| COMPRESS_FOR | VARCHAR2(12) | YES | 压缩方法 | -| NUM_ROWS | NUMBER | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| BLOCKS | NUMBER | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| EMPTY_BLOCKS | NUMBER | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| AVG_SPACE | NUMBER | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| CHAIN_CNT | NUMBER | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| AVG_ROW_LEN | NUMBER | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| SAMPLE_SIZE | NUMBER | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| LAST_ANALYZED | DATE | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| BUFFER_POOL | VARCHAR2(7) | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| CELL_FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| GLOBAL_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| USER_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| IS_NESTED | VARCHAR2(3) | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| PARENT_TABLE_PARTITION | VARCHAR2(30) | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| INTERVAL | VARCHAR2(3) | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | -| SEGMENT_CREATED | VARCHAR2(4) | NO | 目前暂不支持该字段,且当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/145.USER_TYPES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/145.USER_TYPES.md deleted file mode 100644 index 6e2c5a8f9..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/145.USER_TYPES.md +++ /dev/null @@ -1,48 +0,0 @@ -USER_TYPES -=============================== - - - -功能 ------------ - -列出当前用户的用户自定义类型。 - -相关视图 -------------- - -* DBA_TYPES - - - -* ALL_TYPES - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|------------------|--------------|----------------|--------------------------| -| TYPE_NAME | VARCHAR2(64) | NO | 类型名 | -| TYPE_OID | NUMBER(38) | NO | 类型 OID | -| TYPECODE | VARCHAR2(10) | NO | 代表对象的类型,例如 OBJECT、COLL 等 | -| ATTRIBUTES | NUMBER(38) | NO | 类型包含的属性数 | -| METHODS | NUMBER(38) | NO | 类型包含的方法数 | -| PREDEFINED | CHAR(2) | NO | 是否是系统预定义类型 | -| INCOMPLETE | CHAR(2) | NO | 是否是不完整类型, 只有名字没有方法和属性 | -| FINAL | CHAR(3) | NO | 是否不可被继承 | -| INSTANTIABLE | CHAR(3) | NO | 是否可实例化 | -| SUPERTYPE_OWNER | VARCHAR2(30) | NO | 父类型的拥有者 | -| SUPERTYPE_NAME | VARCHAR2(30) | NO | 父类型名 | -| LOCAL_ATTRIBUTES | NUMBER(38) | NO | 本地属性数 | -| LOCAL_METHODS | NUMBER(38) | NO | 本地方法数 | -| TYPEID | NUMBER(38) | YES | 目前暂不支持该字段,且当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/146.USER_TYPE_ATTRS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/146.USER_TYPE_ATTRS.md deleted file mode 100644 index c3803652b..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/146.USER_TYPE_ATTRS.md +++ /dev/null @@ -1,46 +0,0 @@ -USER_TYPE_ATTRS -==================================== - - - -功能 ------------ - -列出当前用户可用的用户自定义类型的属性信息。 - -相关视图 -------------- - -* DBA_TYPE_ATTRS - - - -* ALL_TYPE_ATTRS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------------|---------------|----------------|--------------------------| -| TYPE_NAME | VARCHAR2(64) | NO | 类型名 | -| ATTR_NAME | VARCHAR2(64) | NO | 类型属性名 | -| ATTR_TYPE_MOD | VARCHAR2(7) | NO | 类型的 Modify 属性。目前暂未使用该字段 | -| ATTR_TYPE_OWNER | VARCHAR2(128) | NO | 属性的类型拥有者 | -| ATTR_TYPE_NAME | VARCHAR2(324) | NO | 属性的类型名 | -| LENGTH | NUMBER(38) | NO | 属性类型长度 | -| NUMBER_PRECISION | NUMBER(38) | NO | 属性数值类型的长度 | -| SCALE | NUMBER(38) | NO | 数值类型小数点右边的数据长度 | -| CHARACTER_SET_NAME | CHAR(7) | NO | 属性类型的字符集 | -| ATTR_NO | NUMBER(38) | NO | 属性编号 | -| INHERITED | CHAR(2) | NO | 该属性是否继承自父类型 | -| CHAR_USED | CHAR(1) | YES | 目前暂不支持该字段,且当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/147.USER_TYPE_METHODS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/147.USER_TYPE_METHODS.md deleted file mode 100644 index 21b467766..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/147.USER_TYPE_METHODS.md +++ /dev/null @@ -1,47 +0,0 @@ -USER_TYPE_METHODS -====================================== - - -**说明** - -说明: OceanBase 数据库暂未支持该视图的相关功能。 - -功能 ------------ - -查看用户可以访问的对象类型的方法,除了不含有OWNER字段,字段信息和ALL_TYPE_METHODS一致。 - -相关视图 -------------- - -* DBA_TYPE_METHODS - - - -* ALL_TYPE_METHODS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------|--------------|----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| TYPE_NAME | VARCHAR2(30) | NO | 类型的名称 | -| METHOD_NAME | VARCHAR2(30) | NO | 方法的名称 | -| METHOD_NO | NUMBER | NO | 方法编号,为了区分重载方法 | -| METHOD_TYPE | VARCHAR2(6) | NO | 方法类型: * MAP * ORDER * PUBLIC | -| PARAMETERS | NUMBER | NO | 方法参数的个数 | -| RESULTS | NUMBER | NO | 方法返回结果的个数 | -| FINAL | VARCHAR2(3) | NO | 表明此方法是否为 FINAL: * YES * NO | -| INSTANTIABLE | VARCHAR2(3) | NO | 表明此方法是否可实例化: * YES * NO | -| OVERRIDING | VARCHAR2(3) | NO | 表明此方法是否重载一个超类型方法: * YES * NO | -| INHERITED | VARCHAR2(3) | NO | 表明此方法是否继承自一个超类型: * YES * NO | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/148.USER_VIEWS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/148.USER_VIEWS.md deleted file mode 100644 index a936cafca..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/148.USER_VIEWS.md +++ /dev/null @@ -1,43 +0,0 @@ -USER_VIEWS -=============================== - - - -功能 ------------ - -描述当前用户拥有的视图。 - -相关视图 -------------- - -* ALL_VIEWS - - - -* DBA_VIEWS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-----------------|----------------|----------------|------------------------------------------------------------| -| VIEW_NAME | VARCHAR2(128) | NO | 索引名字 | -| TEXT_LENGTH | NUMBER | NO | 视图定义长度 | -| TEXT | VARCHAR2(4000) | NO | 视图正文 | -| OID_TEXT_LENGTH | NUMBER | NO | 类型视图的 WITH OID 子句的长度。目前暂不支持该字段,且当前该字段默认为 NULL | -| OID_TEXT | VARCHAR2(4000) | NO | 类型视图的 WITH OID 子句。目前暂不支持该字段,且当前该字段默认为 NULL | -| VIEW_TYPE | VARCHAR2(30) | NO | 视图的类型(如果视图是类型视图)。 目前暂不支持该字段,且当前该字段默认为 NULL | -| SUPERVIEW_NAME | VARCHAR2(30) | NO | 超级视图的名称。目前暂不支持该字段,且当前该字段默认为 NULL | -| EDITIONING_VIEW | VARCHAR2(1) | NO | 保留以备将来使用。目前暂不支持该字段,且当前该字段默认为 NULL | -| READ_ONLY | VARCHAR2(1) | NO | 表示视图是否只读。目前暂不支持该字段,且当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/149.USER_RECYCLEBIN.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/149.USER_RECYCLEBIN.md deleted file mode 100644 index 4dbf796e7..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/149.USER_RECYCLEBIN.md +++ /dev/null @@ -1,40 +0,0 @@ -USER_RECYCLEBIN -==================================== - - - -功能 ------------------------ - -记录回收站的信息。 - -相关视图 -------------------------- - -DBA__RECYCLEBIN - -字段说明 -------------------------- - - - - -| 字段名称 | 类型 | 是否可以为 NULL | 描述 | -|----------------|---------------|------------|------------------------------------------------------------------------------------------------------------------------------------| -| OBJECT_NAME | VARCHAR2(128) | NO | 对象的新名称 | -| ORIGINAL_NAME | VARCHAR2(128) | NO | 对象的原始名称 | -| OPERATION | VARCHAR2(9) | NO | 暂不支持该字段,默认为 NULL | -| TYPE | VARCHAR2(25) | NO | 对象类型 | -| TS_NAME | VARCHAR2(30) | NO | 对象所属的表的名称 | -| CREATETIME | VARCHAR2(30) | NO | 创建对象的时间 | -| DROPTIME | VARCHAR2(30) | NO | 对象进入回收站的时间 | -| DROPSCN | NUMBER | NO | 暂不支持该字段,默认为 NULL | -| PARTITION_NAME | VARCHAR2(128) | NO | 暂不支持该字段,默认为 NULL | -| CAN_UNDROP | VARCHAR2(3) | NO | 是否可以将对象从回收站中恢复: * YES * NO | -| CAN_PURGE | VARCHAR2(3) | NO | 是否可以将对象清除: * YES * NO | -| RELATED | NUMBER | NO | 暂不支持该字段,默认为 NULL | -| BASE_OBJECT | NUMBER | NO | 暂不支持该字段,默认为 NULL | -| PURGE_OBJECT | NUMBER | NO | 暂不支持该字段,默认为 NULL | -| SPACE | NUMBER | NO | 暂不支持该字段,默认为 NULL | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/15.ALL_METHOD_PARAMS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/15.ALL_METHOD_PARAMS.md deleted file mode 100644 index cf1ef547c..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/15.ALL_METHOD_PARAMS.md +++ /dev/null @@ -1,50 +0,0 @@ -ALL_METHOD_PARAMS -====================================== - - -**说明** - - - -OceanBase 数据库暂未支持该视图。 - -功能 ------------ - -查看用户可访问的对象类型的方法参数。 - -相关视图 -------------- - -* DBA_METHOD_PARAMS - - - -* USER_METHOD_PARAMS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------------|--------------|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(30) | NO | 类型的拥有者 | -| TYPE_NAME | VARCHAR2(30) | NO | 类型名称 | -| METHOD_NAME | VARCHAR2(30) | NO | 方法名称 | -| METHOD_NO | NUMBER | NO | 对于重载的方法,这个编号区分另一个名字相同的方法。不要将这个和对象 ID 混淆。 | -| PARAM_NAME | VARCHAR2(30) | NO | 参数的名称 | -| PARAM_NO | NUMBER | NO | 参数编号(正数) | -| PARAM_MODE | VARCHAR2(6) | NO | 参数模式: * IN * OUT * IN OUT | -| PARAM_TYPE_MOD | VARCHAR2(7) | NO | 参数是否引用其他的对象 | -| PARAM_TYPE_OWNER | VARCHAR2(30) | NO | 参数类型的拥有者 | -| PARAM_TYPE_NAME | VARCHAR2(30) | NO | 参数类型的名称 | -| CHARACTER_SET_NAME | VARCHAR2(44) | NO | 方法的字符集是鼎昌的字符集(CHAR_CS)或者是鼎昌的自然字符集(NCHAR_CS),或者用户特殊指定的一个字符集。 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/150.USER_DEPENDENCIES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/150.USER_DEPENDENCIES.md deleted file mode 100644 index ee443321e..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/150.USER_DEPENDENCIES.md +++ /dev/null @@ -1,41 +0,0 @@ -USER_DEPENDENCIES -====================================== - - - -功能 ------------------------ - -`USER_DEPENDENCIES` 视图用于展示当前用户 Schema 中各对象之间的依赖关系。目前仅支持展示 PL 对象之间的依赖关系。 - -相关视图 -------------------------- - -* `ALL_DEPENDENCIES` - - - -* `DBA_DEPENDENCIES` - - - - - - -字段说明 -------------------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------------------|---------------|----------------|-------------------| -| NAME | VARCHAR2(128) | NO | 依赖者的名称 | -| TYPE | VARCHAR2(23) | NO | 依赖者的类型 | -| REFERENCED_OWNER | VARCHAR2(128) | NO | 被依赖者的 Owner 名称 | -| REFERENCED_NAME | VARCHAR2(128) | NO | 被依赖者的名称 | -| REFERENCED_TYPE | VARCHAR2(18) | NO | 被依赖者的类型 | -| REFERENCED_LINK_NAME | VARCHAR2(128) | NO | 被依赖者的 Dblink 名称 | -| SCHEMAID | NUMBER | NO | 当前用户对应的 Schema ID | -| DEPENDENCY_TYPE | VARCHAR2(4) | NO | 指示该依赖为强依赖或者其他依赖 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/151.ROLE_TAB_PRIVS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/151.ROLE_TAB_PRIVS.md deleted file mode 100644 index 816bfe993..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/151.ROLE_TAB_PRIVS.md +++ /dev/null @@ -1,26 +0,0 @@ -ROLE_TAB_PRIVS -=================================== - - - -功能 ------------ - -描述授予角色的表特权。仅提供关于用户可以访问的角色的信息。 - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-------------|---------------|----------------|--------------------| -| ROLE | VARCHAR2(128) | NO | 角色名称 | -| OWNER | VARCHAR2(128) | NO | 对象的所有者 | -| TABLE_NAME | VARCHAR2(128) | NO | 对象的名称 | -| COLUMN_NAME | VARCHAR2(128) | NO | 列的名称(如果使用) | -| PRIVILEGE | VARCHAR2(40) | NO | 授予角色的对象权限 | -| GRANTABLE | VARCHAR2(3) | NO | 该角色是否被授予了 ADMIN 选项 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/152.ROLE_SYS_PRIVS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/152.ROLE_SYS_PRIVS.md deleted file mode 100644 index 882024925..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/152.ROLE_SYS_PRIVS.md +++ /dev/null @@ -1,23 +0,0 @@ -ROLE_SYS_PRIVS -=================================== - - - -功能 ------------ - -描述授予角色的系统特权。 - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------|---------------|----------------|--------------------| -| ROLE | VARCHAR2(128) | NO | 角色名称 | -| PRIVILEGE | VARCHAR2(40) | NO | 授予该角色的系统权限 | -| ADMIN_OPTION | VARCHAR2(3) | NO | 该角色是否被授予了 ADMIN 选项 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/153.ROLE_ROLE_PRIVS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/153.ROLE_ROLE_PRIVS.md deleted file mode 100644 index 85ec21f86..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/153.ROLE_ROLE_PRIVS.md +++ /dev/null @@ -1,23 +0,0 @@ -ROLE_ROLE_PRIVS -==================================== - - - -功能 ------------ - -描述授予其他角色的角色。只提供关于用户可以访问的角色的信息。 - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为空** | **描述** | -|--------------|---------------|------------|--------------------| -| ROLE | VARCHAR2(128) | NO | 角色名称 | -| GRANTED_ROLE | VARCHAR2(128) | NO | 授予的角色 | -| ADMIN_OPTION | VARCHAR2(3) | NO | 该角色是否被授予了 ADMIN 选项 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/154.DICTIONARY.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/154.DICTIONARY.md deleted file mode 100644 index fd447cc04..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/154.DICTIONARY.md +++ /dev/null @@ -1,22 +0,0 @@ -DICTIONARY -=============================== - - - -功能 ------------ - -包含对数据字典表和视图的描述。 - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|------------|----------------|----------------|---------| -| TABLE_NAME | VARCHAR2(128) | NO | 对象的名称 | -| COMMENTS | VARCHAR2(4000) | NO | 对象的文本注释 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/155.DICT.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/155.DICT.md deleted file mode 100644 index 1d9c9fa60..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/155.DICT.md +++ /dev/null @@ -1,22 +0,0 @@ -DICT -========================= - - - -功能 ------------ - -与 `DICTIONARY` 视图相同,包含对数据字典表和视图的描述。 - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|------------|----------------|----------------|---------| -| TABLE_NAME | VARCHAR2(128) | NO | 对象的名称 | -| COMMENTS | VARCHAR2(4000) | NO | 对象的文本注释 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/16.ALL_OBJECTS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/16.ALL_OBJECTS.md deleted file mode 100644 index 7dbaf40df..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/16.ALL_OBJECTS.md +++ /dev/null @@ -1,51 +0,0 @@ -ALL_OBJECTS -================================ - - - -功能 ------------ - -查看用户可访问的所有数据库对象。 - -相关视图 -------------- - -* USER_OBJECTS - - - -* DBA_OBJECTS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------------|---------------|----------------|---------------------------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 对象所属的拥有者 | -| OBJECT_NAME | VARCHAR2(128) | NO | 对象名字 | -| SUBOBJECT_NAME | VARCHAR2(128) | NO | 子对象名字(例如,partition) | -| OBJECT_ID | NUMBER(38) | NO | 对象的字典ID值 | -| DATA_OBJECT_ID | NUMBER | NO | 包含该对象 Segment 的字典 ID 值 | -| OBJECT_TYPE | VARCHAR2(23) | NO | 对象类型,包括表、索引、分区、包、存储过程、同义词、序列等 | -| CREATED | DATE | NO | 对象创建时间 | -| LAST_DDL_TIME | DATE | NO | 对象最后一次 DDL 时间 | -| TIMESTAMP | VARCHAR2(256) | NO | 对象指定的时间戳,以字符形式输出 | -| STATUS | VARCHAR2(7) | NO | 对象状态: * VALID * INVALID | -| TEMPORARY | VARCHAR2(1) | NO | 表示该对象是一个临时对象 | -| GENERATED | VARCHAR2(1) | NO | 表示该对象的名字是否是由系统生成 | -| SECONDARY | VARCHAR2(1) | NO | 暂未使用 | -| NAMESPACE | NUMBER | NO | 对象的命名空间 | -| EDITION_NAME | VARCHAR2(128) | NO | 保留字段 | - - - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/17.ALL_PART_INDEXES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/17.ALL_PART_INDEXES.md deleted file mode 100644 index b8580c5b8..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/17.ALL_PART_INDEXES.md +++ /dev/null @@ -1,63 +0,0 @@ -ALL_PART_INDEXES -===================================== - - - -功能 ------------ - -查看当前用户可访问的分区索引的分区信息。 - -相关视图 -------------- - -* DBA_PART_INDEXES - - - -* USER_PART_INDEXES - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|---------------------------|----------------|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 分区索引的拥有者 | -| INDEX_NAME | VARCHAR2(128) | NO | 分区索引的名字 | -| TABLE_NAME | VARCHAR2(128) | NO | 索引所属的表的名字 | -| PARTITIONING_TYPE | VARCHAR2(9) | NO | 分区方式: * HASH * RANGE * LIST | -| SUBPARTITIONING_TYPE | VARCHAR2(9) | NO | 子分区的分区方式: * HASH * RANGE * LIST | -| PARTITION_COUNT | NUMBER | NO | 索引中分区个数 | -| DEF_SUBPARTITION_COUNT | NUMBER | NO | 对于复合分区索引,表示子分区的个数 | -| PARTITIONING_KEY_COUNT | NUMBER | NO | 分区键的数量 | -| SUBPARTITIONING_KEY_COUNT | NUMBER | NO | 对于复合分区索引,表示子分区键的数量 | -| LOCALITY | VARCHAR2(6) | NO | 分区索引是局部 (LOCAL)还是全局 (GLOBAL) | -| ALIGNMENT | VARCHAR2(12) | NO | 分区索引是前缀(PREFIXED)还是非前缀 (NON_PREFIXED) | -| DEF_TABLESPACE_NAME | VARCHAR2(30) | NO | 对于局部索引,添加或分割表分区时默认表空间 | -| DEF_PCT_FREE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_INI_TRANS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_MAX_TRANS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_INITIAL_EXTENT | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_NEXT_EXTENT | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_MIN_EXTENTS | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_MAX_EXTENTS | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_MAX_SIZE | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_PCT_INCREASE | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_FREELISTS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_FREELIST_GROUPS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_LOGGING | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_BUFFER_POOL | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_CELL_FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_PARAMETERS | VARCHAR2(1000) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INTERVAL | VARCHAR2(1000) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/18.ALL_PART_KEY_COLUMNS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/18.ALL_PART_KEY_COLUMNS.md deleted file mode 100644 index 2b0ce4b3f..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/18.ALL_PART_KEY_COLUMNS.md +++ /dev/null @@ -1,40 +0,0 @@ -ALL_PART_KEY_COLUMNS -========================================= - - - -功能 ------------ - -查看用户可访问的所有分区对象中分区键包含的列。 - -相关视图 -------------- - -* DBA_PART_KEY_COLUMNS - - - -* USER_PART_KEY_COLUMNS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|------------------------------------|----------------|----------------|----------------------------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 分区表或分区索引的拥有者 | -| NAME | VARCHAR2(128) | NO | 分区表或分区索引的名字 | -| OBJECT_TYPE | CHAR(5) | NO | 分区对象的类型: * TABLE * INDEX | -| COLUMN_NAME | VARCHAR2(4000) | NO | 列的名字 | -| COLUMN_POSITION | NUMBER | NO | 列在分区键中的位置 | -| COLLATED_COLUMN_ID | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/19.ALL_PART_TABLES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/19.ALL_PART_TABLES.md deleted file mode 100644 index e41779358..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/19.ALL_PART_TABLES.md +++ /dev/null @@ -1,66 +0,0 @@ -ALL_PART_TABLES -==================================== - - - -功能 ------------ - -查看当前用户可访问的分区表的分区信息。 - -相关视图 -------------- - -* DBA_PART_TABLES : 查看所有的分区表的分区信息 - - - -* USER_PART_TABLES : 查看属于当前用户的分区表的分区信息 - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|---------------------------|----------------|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 分区表的拥有者 | -| TABLE_NAME | VARCHAR2(128) | NO | 分区表的名字 | -| PARTITIONING_TYPE | VARCHAR2(9) | NO | 分区方式: * HASH * RANGE * LIST | -| SUBPARTITIONING_TYPE | VARCHAR2(9) | NO | 子分区的分区方式: * HASH * RANGE * LIST | -| PARTITION_COUNT | NUMBER | NO | 分区表中分区个数 | -| DEF_SUBPARTITION_COUNT | NUMBER | NO | 对于复合分区表,表示子分区的个数 | -| PARTITIONING_KEY_COUNT | NUMBER | NO | 分区键的数量 | -| SUBPARTITIONING_KEY_COUNT | NUMBER | NO | 对于复合分区表,表示子分区键的数量 | -| STATUS | VARCHAR2(8) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_TABLESPACE_NAME | VARCHAR2(30) | NO | 分区表所属的表空间名 | -| DEF_PCT_FREE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_PCT_USED | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_INI_TRANS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_MAX_TRANS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_INITIAL_EXTENT | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_NEXT_EXTENT | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_MIN_EXTENT | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_EXTENT | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_MAX_SIZE | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_PCT_INCREASE | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_FREELISTS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_FREELIST_GROUPS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_LOGGING | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| COMPRESSION | VARCHAR2(8) | NO | 是否开启压缩 | -| COMPRESS_FOR | VARCHAR2(12) | NO | 压缩方法 | -| DEF_BUFFER_POOL | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_CELL_FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| REF_PTN_CONSTRAINT_NAME | VARCHAR2(30) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INTERVAL | VARCHAR2(1000) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| IS_NESTED | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_SEGMENT_CREATED | VARCHAR2(4) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/2.ALL_ARGUMENTS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/2.ALL_ARGUMENTS.md deleted file mode 100644 index 46ebfb21c..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/2.ALL_ARGUMENTS.md +++ /dev/null @@ -1,56 +0,0 @@ -ALL_ARGUMENTS -================================== - - - -功能 ------------ - -列出数据库中可用的过程和函数的参数。 - -相关视图 -------------- - -* DBA_ARGUMENTS - - - -* USER_ARGUMENTS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------------|---------------|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 对象所属的拥有者 | -| OBJECT_NAME | VARCHAR2(128) | YES | 过程或者函数名 | -| PACKAGE_NAME | VARCHAR2(128) | YES | 包名 | -| OBJECT_ID | NUMBER | NO | 对象 ID | -| OVERLOAD | NUMBER | YES | 出现在包源文件中的第几次重载 | -| SUBPROGRAM_ID | NUMBER | YES | 出现在包中的顺序, 对于独立的过程或者函数该值为 1 | -| ARGUMENT_NAME | VARCHAR2(128) | YES | 参数名,该值为 NULL 说明是函数的返回值 | -| POSITION | NUMBER(38) | NO | 出现在参数列表中的位置 | -| SEQUENCE | NUMBER(38) | NO | 对于复杂类型,该值代表属性的序号 | -| DATA_LEVEL | NUMBER(38) | NO | 对于嵌套的复杂类型, 该值代表当前类型嵌套的层次 | -| DATA_TYPE | VARCHAR2(128) | YES | 参数的数据类型,对于嵌套的复杂类型,该值代表当前层的数据类型 | -| DEFAULTED | CHAR(2) | YES | 标识当前参数是否有默认值 | -| DATA_LENGTH | NUMBER(38) | YES | 数据类型的长度 | -| IN_OUT | VARCHAR2(5) | YES | 参数的输入输出属性(NULL 表示是返回值): * IN * OUT * IN OUT | -| DATA_PRECISION | NUMBER(38) | YES | 数值类型的最大长度 | -| DATA_SCALE | NUMBER(38) | YES | 数值类型小数点右边的数据长度 | -| CHARACTER_SET_NAME | VARCHAR2(7) | YES | 参数的字符集名 | -| COLLATION | VARCHAR2(18) | YES | 字符集排序规则 | -| TYPE_OWNER | NUMBER(38) | YES | 复杂数据类型的类型拥有者 | -| TYPE_NAME | VARCHAR2(128) | YES | 复杂数据类型的名字 | -| TYPE_SUBNAME | VARCHAR2(128) | YES | 如果是包中的类型, 该字段代表包名 | -| ORIGIN_CON_ID | NUMBER(38) | YES | 该字段当前代表租户 ID | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/20.ALL_PROCEDURES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/20.ALL_PROCEDURES.md deleted file mode 100644 index ca21a7ab7..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/20.ALL_PROCEDURES.md +++ /dev/null @@ -1,50 +0,0 @@ -ALL_PROCEDURES -=================================== - - - -功能 ------------ - -列出数据库中可用的过程和函数。 - -相关视图 -------------- - -* DBA_PROCEDURES - - - -* USER_PROCEDURES - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------------|---------------|----------------|------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 对象所属的拥有者 | -| OBJECT_NAME | VARCHAR2(128) | YES | 包名 | -| PROCEDURE_NAME | VARCHAR2(128) | NO | 过程或者函数名 | -| OBJECT_ID | NUMBER | NO | 对象 ID | -| SUBPROGRAM_ID | NUMBER | NO | 出现在包中的顺序, 对于独立的过程或者函数该值为 1 | -| OVERLOAD | NUMBER | NO | 出现在包源文件中的第几次重载 | -| OBJECT_TYPE | VARCHAR2(9) | NO | 对象的类型 | -| AGGREGATE | VARCHAR2(3) | NO | 表示该过程是否为聚合函数。目前暂不支持该字段,当前该字段默认为 NO | -| PIPELINED | VARCHAR2(3) | NO | 表示该过程是否为管道表函数 | -| IMPLTYPEOWNER | VARCHAR2(30) | NO | 实现类型所有者的名称。目前暂不支持该字段,当前该字段默认为 NULL | -| IMPLTYPENAME | VARCHAR2(30) | NO | 实现类型的名称。目前暂不支持该字段,当前该字段默认为 NULL | -| PARALLEL | VARCHAR2(3) | NO | 指示过程或功能是否是并行启用的 | -| INTERFACE | VARCHAR2(3) | NO | 过程/函数是使用 ODCI 接口实现的表函数。目前暂不支持该字段,当前该字段默认为 NULL | -| DETERMINISTIC | VARCHAR2(3) | NO | 该过程或功能被声明为确定性的 | -| AUTHID | VARCHAR2(12) | NO | INVOKER/DEFINER | -| ORIGIN_CON_ID | NUMBER(38) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/21.ALL_PROFILES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/21.ALL_PROFILES.md deleted file mode 100644 index 31ee19b7c..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/21.ALL_PROFILES.md +++ /dev/null @@ -1,38 +0,0 @@ -ALL_PROFILES -================================= - - - -功能 ------------ - -查看所有的简介和这些简介的限制。 - -相关视图 -------------- - -* DBA_PROFILES - - - -* USER_PROFILES - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|---------------|--------------|----------------|-----------------------------------| -| PROFILE | VARCHAR2(30) | NO | 简介的名称 | -| RESOURCE_NAME | VARCHAR2(32) | NO | 资源的名称 | -| RESOURCE_TYPE | VARCHAR2(8) | NO | 表明一个资源的简介是一个 KERNEL 还是一个 PASSWORD | -| LIMIT | VARCHAR2(40) | NO | 简介资源的限制 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/22.ALL_SCHEDULER_JOB_ARGS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/22.ALL_SCHEDULER_JOB_ARGS.md deleted file mode 100644 index 770808f6f..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/22.ALL_SCHEDULER_JOB_ARGS.md +++ /dev/null @@ -1,47 +0,0 @@ -ALL_SCHEDULER_JOB_ARGS -=========================================== - - -**说明** - - - -OceanBase 数据库暂未支持该视图。 - -功能 ------------ - -查看用户可查的调度作业参数信息。 - -相关视图 -------------- - -* USER_SCHEDULER_JOB_ARGS - - - -* DBA_SCHEDULER_JOB_ARGS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-----------------------|----------------|----------------|-------------------------| -| OWNER | VARCHAR2(30) | NO | 参数所属作业的拥有者 | -| JOB_NAME | VARCHAR2(30) | NO | 参数所属作业的名称 | -| ARGUMENT_NAME | VARCHAR2(30) | NO | 参数的可选名称 | -| ARGUMENT_POSITION | NUMBER | NO | 参数在参数列表中的位置 | -| ARGUMENT_TYPE | VARCHAR2(61) | NO | 参数的数据类型 | -| VALUE | VARCHAR2(4000) | NO | 如果参数是一个字符串类型,参数的默认值 | -| DEFAULT_ANYDATA_VALUE | VARCHAR2(128) | NO | 如果参数是 ANYDATA 类型,参数的默认值 | -| OUT_ARGUMENT | VARCHAR2(5) | NO | 保留字段 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/23.ALL_SCHEDULER_PROGRAM_ARGS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/23.ALL_SCHEDULER_PROGRAM_ARGS.md deleted file mode 100644 index 0c9841c69..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/23.ALL_SCHEDULER_PROGRAM_ARGS.md +++ /dev/null @@ -1,48 +0,0 @@ -ALL_SCHEDULER_PROGRAM_ARGS -=============================================== - - -**说明** - - - -OceanBase 数据库暂未支持该视图。 - -功能 ------------ - -查看用户可查的调度程序参数信息。 - -相关视图 -------------- - -* USER_SCHEDULER_PROGRAM_ARGS - - - -* DBA_SCHEDULER_PROGRAM_ARGS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-----------------------|----------------|----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(30) | NO | 参数所属程序的拥有者 | -| PROGRAM_NAME | VARCHAR2(30) | NO | 参数所属程序的名称 | -| ARGUMENT_NAME | VARCHAR2(30) | NO | 参数的可选名称 | -| ARGUMENT_POSITION | NUMBER | NO | 参数在参数列表中的位置 | -| ARGUMENT_TYPE | VARCHAR2(61) | NO | 参数的数据类型 | -| METADATA_ATTRIBUTE | VARCHAR2(19) | NO | 元数据的属性: * JOB_NAME * JOB_OWNER * JOB_START * WINDOW_START * WINDOW_END * JOB_SUBNAME * EVENT_MESSAGE * JOB_SCHEDULER_START | -| DEFAULT_VALUE | VARCHAR2(4000) | NO | 如果参数是一个字符串类型,参数的默认值 | -| DEFAULT_ANYDATA_VALUE | VARCHAR2(128) | YES | 如果参数是 ANYDATA 类型,参数的默认值 | -| OUT_ARGUMENT | VARCHAR2(5) | YES | 保留字段 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/24.ALL_SEQUENCES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/24.ALL_SEQUENCES.md deleted file mode 100644 index a69db8078..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/24.ALL_SEQUENCES.md +++ /dev/null @@ -1,43 +0,0 @@ -ALL_SEQUENCES -================================== - - - -功能 ------------ - -列出用户可访问的所有 SEQUENCE。 - -相关视图 -------------- - -* DBA_SEQUENCES - - - -* USER_SEQUENCES - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------|---------------|----------------|-------------------------| -| OWNER | VARCHAR2(128) | NO | 对象所属的拥有者 | -| OBJECT_NAME | VARCHAR2(128) | NO | SEQUENCE 名 | -| MIN_VALUE | NUMBER(28) | NO | SEQUENCE 可取的最小值(含) | -| MAX_VALUE | NUMBER(28) | NO | SEQUENCE 可取的最大值(含) | -| INCREMENT_BY | NUMBER(28) | NO | 每次取值的步长,可为正整数或负整数,不可为 0 | -| CYCLE_FLAG | CHAR(1) | NO | 是否可以循环取值 | -| ORDER_FLAG | CHAR(1) | NO | 取值是否保证全局有序 | -| CACHE_SIZE | NUMBER(28) | NO | 每个节点缓存值的数量 | -| LAST_NUMBER | NUMBER(38) | NO | 记录下一个可分配给节点的值 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/25.ALL_SOURCE.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/25.ALL_SOURCE.md deleted file mode 100644 index d0eec926b..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/25.ALL_SOURCE.md +++ /dev/null @@ -1,40 +0,0 @@ -ALL_SOURCE -=============================== - - - -功能 ------------ - -列出数据库中可用的过程和函数的源代码。 - -相关视图 -------------- - -* DBA_SOURCE - - - -* USER_SOURCE - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|---------------|--------------|----------------|-------------------| -| OWNER | VARCHAR2(30) | NO | 对象所属的拥有者 | -| NAME | VARCHAR2(30) | NO | 对象名 | -| TYPE | VARCHAR2(12) | NO | 对象类型 | -| LINE | NUMBER | NO | TEXT 字段对应的源代码中的行号 | -| TEXT | CLOB | NO | 当前行的源代码 | -| ORIGIN_CON_ID | NUMBER(38) | NO | 暂不支持该字段,字段默认为NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/26.ALL_SUBPARTITION_TEMPLATES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/26.ALL_SUBPARTITION_TEMPLATES.md deleted file mode 100644 index 0ef151cce..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/26.ALL_SUBPARTITION_TEMPLATES.md +++ /dev/null @@ -1,40 +0,0 @@ -ALL_SUBPARTITION_TEMPLATES -=============================================== - - - -功能 ------------ - -查看所有子分区模版描述信息。 - -相关视图 -------------- - -* DBA_SUBPARTITION_TEMPLATES - - - -* USER_SUBPARTITION_TEMPLATES - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-----------------------|----------------|----------------|-----------| -| TABLE_OWNER | VARCHAR2(128) | NO | 分区表的所有者 | -| TABLE_NAME | VARCHAR2(256) | NO | 分区表名 | -| SUBPARTITION_NAME | VARCHAR2(64) | NO | 子分区名 | -| SUBPARTITION_POSITION | NUMBER | YES | 子分区位置 | -| TABLESPACE_NAME | VARCHAR2(30) | NO | 分区所属的表空间名 | -| HIGH_BOUND | VARCHAR2(1024) | NO | 分区模板表达式 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/27.ALL_SUBPART_KEY_COLUMNS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/27.ALL_SUBPART_KEY_COLUMNS.md deleted file mode 100644 index 781a07a21..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/27.ALL_SUBPART_KEY_COLUMNS.md +++ /dev/null @@ -1,40 +0,0 @@ -ALL_SUBPART_KEY_COLUMNS -============================================ - - - -功能 ------------ - -查看用户可访问的所有分区对象中子分区键包含的列。 - -相关视图 -------------- - -* DBA_SUBPART_KEY_COLUMNS - - - -* USER_SUBPART_KEY_COLUMNS - - - - - - -字段说明 ----------------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|------------------------------------|----------------|----------------|----------------------------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 分区表或分区索引的拥有者 | -| NAME | VARCHAR2(128) | NO | 分区表或分区索引的名字 | -| OBJECT_TYPE | CHAR(5) | NO | 分区对象的类型: * TABLE * INDEX | -| COLUMN_NAME | VARCHAR2(4000) | NO | 列的名字 | -| COLUMN_POSITION | NUMBER | NO | 列在分区键中的位置 | -| COLLATED_COLUMN_ID | NUMBER | NO | 目前暂未支持该字段,当前该字段默认为NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/28.ALL_SYNONYMS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/28.ALL_SYNONYMS.md deleted file mode 100644 index c5b3fd0dc..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/28.ALL_SYNONYMS.md +++ /dev/null @@ -1,41 +0,0 @@ -ALL_SYNONYMS -================================= - - - -功能 ------------ - -查看用户可访问的所有同义词。 - -相关视图 -------------- - -* DBA_SYNONYMS - - - -* USER_SYNONYMS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------|---------------|----------------|----------------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 同义词的拥有者 | -| SYNONYM_NAME | VARCHAR2(128) | NO | 同义词名字 | -| TABLE_OWNER | VARCHAR2(128) | NO | 同义词引用对象的名字,这里的TABLE_NAME 仅仅是列名而已,同义词也可以是对其他对象(例如视图等)的同义词 | -| TABLE_NAME | VARCHAR2(128) | NO | 同义词引用的对象名字 | -| DB_LINK | VARCHAR2(128) | NO | 如果引用的是 DB Link,则表示 DB Link 的名字 | - - - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/29.ALL_TABLES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/29.ALL_TABLES.md deleted file mode 100644 index 2520629cb..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/29.ALL_TABLES.md +++ /dev/null @@ -1,89 +0,0 @@ -ALL_TABLES -=============================== - - - -功能 ------------ - -查看用户可访问的所有表。 - -相关视图 -------------- - -* DBA_TABLES - - - -* USER_TABLES - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|---------------------------|---------------|----------------|---------------------------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 表的拥有者 | -| TABLE_NAME | VARCHAR2(128) | NO | 表名 | -| TABLESPACE_NAME | VARCHAR2(30) | NO | 包含该表的表空间名字 | -| CLUSTER_NAME | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| IOT_NAME | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| STATUS | VARCHAR2(8) | NO | 表状态: * VALID * UNUSABLE | -| PCT_FREE | NUMBER | NO | 块的最小空闲空间比例 | -| PCT_USED | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INI_TRANS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_TRANS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INITIAL_EXTENT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NEXT_EXTENT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MIN_EXTENTS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_EXTENTS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| PCT_INCREASE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| FREELISTS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| FREELIST_GROUPS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| LOGGING | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| BACKED_UP | VARCHAR2(1) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NUM_ROWS | NUMBER | NO | 表行数 | -| BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| EMPTY_BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_SPACE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CHAIN_CNT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_ROW_LEN | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_SPACE_FREELIST_BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NUM_FREELIST_BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEGREE | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INSTANCES | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CACHE | VARCHAR2(20) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| TABLE_LOCK | VARCHAR2(8) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| SAMPLE_SIZE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| LAST_ANALYZED | DATE | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| PARTITIONED | VARCHAR2(3) | NO | 指定表是否是分区: * YES * NO | -| IOT_TYPE | VARCHAR2(12) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| TEMPORARY | VARCHAR2(1) | NO | 指定表是否是临时表 | -| SECONDARY | VARCHAR2(1) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NESTED | VARCHAR2(3) | NO | 指定表是否是嵌套表 * YES * NO | -| BUFFER_POOL | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CELL_FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| ROW_MOVEMENT | VARCHAR2(8) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| GLOBAL_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| USER_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DURATION | VARCHAR2(15) | NO | 指示临时表的持续时间 | -| SKIP_CORRUPT | VARCHAR2(8) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MONITORING | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CLUSTER_OWNER | VARCHAR2(30) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEPENDENCIES | VARCHAR2(8) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| COMPRESSION | VARCHAR2(8) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| COMPRESS_FOR | VARCHAR2(12) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DROPPED | VARCHAR2(3) | NO | 表示被删除表是否在回收站里 | -| READ_ONLY | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| SEGMENT_CREATED | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| RESULT_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/3.ALL_COL_COMMENTS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/3.ALL_COL_COMMENTS.md deleted file mode 100644 index e389ccda3..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/3.ALL_COL_COMMENTS.md +++ /dev/null @@ -1,40 +0,0 @@ -ALL_COL_COMMENTS -===================================== - - - -功能 ------------ - -查看用户可访问的视图和表的所有列注释。 - -相关视图 -------------- - -* USER_COL_COMMENTS - - - -* DBA_COL_COMMENTS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-------------|----------------|----------------|--------| -| OWNER | VARCHAR2(128) | NO | 对象的拥有者 | -| OBJECT_NAME | VARCHAR2(128) | NO | 对象名字 | -| COLUMN_NAME | VARCHAR2(128) | NO | 列名 | -| COMMENTS | VARCHAR2(4000) | YES | 列注释 | - - - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/30.ALL_TAB_COLS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/30.ALL_TAB_COLS.md deleted file mode 100644 index 46f62b5bc..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/30.ALL_TAB_COLS.md +++ /dev/null @@ -1,72 +0,0 @@ -ALL_TAB_COLS -================================= - - - -功能 ------------ - -查看当前用户可访问的的表、视图、集群的所有列。 - -这个视图与 ALL_TABLE_COLUMNS 的区别在于没有对隐藏列进行过滤。 - -相关视图 -------------- - -* DBA_TAB_COLS - - - -* USER_TAB_COLS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------------------|----------------|----------------|-------------------------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 表、视图的拥有者 | -| TABLE_NAME | VARCHAR2(128) | NO | 表、视图的名字 | -| COLUMN_NAME | VARCHAR2(128) | NO | 列名 | -| DATA_TYPE | VARCHAR2(128) | NO | 列类型 | -| DATA_TYPE_MOD | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DATA_TYPE_OWNER | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DATA_LENGTH | NUMBER | NO | 列长度,单位:bytes | -| DATA_PRECISION | NUMBER | NO | 数字数据类型的十进制精度;浮点数据类型的二进制精度;所有其他数据类型为空值 | -| DATA_SCALE | NUMBER | NO | 数值小数点右边的数字 | -| NULLABLE | VARCHAR2(1) | NO | 列是否允许为空 | -| COLUMN_ID | NUMBER | NO | 列序号 | -| DEFAULT_LENGTH | NUMBER | NO | 列默认长度 | -| DATA_DEFAULT | VARCHAR2(128) | NO | 列默认值 | -| NUM_DISTINCT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| LOW_VALUE | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| HIGH_VALUE | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DENSITY | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NUM_NULLS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NUM_BUCKETS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| LAST_ANALYZED | DATE | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| SAMPLE_SIZE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CHARACTER_SET_NAME | VARCHAR2(44) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CHAR_COL_DECL_LENGTH | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| GLOBAL_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| USER_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_COL_LEN | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CHAR_LENGTH | NUMBER | NO | 字符类型的列长度 | -| CHAR_USED | VARCHAR2(1) | NO | 表示列是按照字节长度还是字符长度 | -| V80_FMT_IMAGE | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DATA_UPGRADED | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| HIDDEN_COLUMN | VARCHAR2(3) | NO | 表示列是否是隐藏列: * YES * NO | -| VIRTUAL_COLUMN | VARCHAR2(3) | NO | 表示列是否是虚拟列: * YES * NO | -| SEGMENT_COLUMN_ID | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INTERNAL_COLUMN_ID | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| HISTOGRAM | VARCHAR2(15) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| QUALIFIED_COL_NAME | VARCHAR2(4000) | NO | 限定列名 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/31.ALL_TAB_COLUMNS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/31.ALL_TAB_COLUMNS.md deleted file mode 100644 index f40a5f6ad..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/31.ALL_TAB_COLUMNS.md +++ /dev/null @@ -1,65 +0,0 @@ -ALL_TAB_COLUMNS -==================================== - - - -功能 ------------ - -查看当前用户可访问的表、视图、集群的所有列。 - -相关视图 -------------- - -* DBA_TAB_COLUMNS - - - -* USER_TAB_COLUMNS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------------------|---------------|----------------|---------------------------------------| -| OWNER | VARCHAR2(128) | NO | 表、视图的拥有者 | -| TABLE_NAME | VARCHAR2(128) | NO | 表、视图的名字 | -| COLUMN_NAME | VARCHAR2(128) | NO | 列名 | -| DATA_TYPE | VARCHAR2(128) | NO | 列类型 | -| DATA_TYPE_MOD | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DATA_TYPE_OWNER | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DATA_LENGTH | NUMBER | NO | 列长度,单位:bytes | -| DATA_PRECISION | NUMBER | NO | 数字数据类型的十进制精度;浮点数据类型的二进制精度;所有其他数据类型为空值 | -| DATA_SCALE | NUMBER | NO | 数值小数点右边的数字 | -| NULLABLE | VARCHAR2(1) | NO | 列是否允许为空 | -| COLUMN_ID | NUMBER | NO | 列序号 | -| DEFAULT_LENGTH | NUMBER | NO | 列默认长度 | -| DATA_DEFAULT | VARCHAR2(128) | NO | 列默认值 | -| NUM_DISTINCT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| LOW_VALUE | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| HIGH_VALUE | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DENSITY | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NUM_NULLS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NUM_BUCKETS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| LAST_ANALYZED | DATE | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| SAMPLE_SIZE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CHARACTER_SET_NAME | VARCHAR2(44) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CHAR_COL_DECL_LENGTH | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| GLOBAL_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| USER_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_COL_LEN | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CHAR_LENGTH | NUMBER | NO | 字符类型的列长度 | -| CHAR_USED | VARCHAR2(1) | NO | 表示列是按照字节长度还是字符长度 | -| V80_FMT_IMAGE | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DATA_UPGRADED | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| HISTOGRAM | VARCHAR2(15) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/32.ALL_TAB_COMMENTS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/32.ALL_TAB_COMMENTS.md deleted file mode 100644 index 4cfb66b6e..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/32.ALL_TAB_COMMENTS.md +++ /dev/null @@ -1,38 +0,0 @@ -ALL_TAB_COMMENTS -===================================== - - - -功能 ------------ - -查看当前用户可访问的表、视图的注释。 - -相关视图 -------------- - -* DBA_TAB_COMMENTS - - - -* USER_TAB_COMMENTS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|------------|----------------|----------------|----------| -| OWNER | VARCHAR2(128) | NO | 表、视图的拥有者 | -| TABLE_NAME | VARCHAR2(128) | NO | 表、视图的名字 | -| TABLE_TYPE | VARCHAR2(11) | NO | 对象类型 | -| COMMENTS | VARCHAR2(4000) | NO | 对象注释 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/33.ALL_TAB_PARTITIONS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/33.ALL_TAB_PARTITIONS.md deleted file mode 100644 index d3800ee7d..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/33.ALL_TAB_PARTITIONS.md +++ /dev/null @@ -1,75 +0,0 @@ -ALL_TAB_PARTITIONS -======================================= - - - -功能 ------------ - -查看所有分区表的多级分区信息、分区存储参数和分区统计信息。 - -相关视图 -------------- - -* DBA_TAB_PARTITIONS - - - -* USER_TAB_PARTITIONS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|------------------------|----------------|----------------|-------------------------| -| TABLE_OWNER | VARCHAR2(128) | NO | 分区表所属的 USER | -| TABLE_NAME | VARCHAR2(128) | NO | 分区表名字 | -| COMPOSITE | VARCHAR2(3) | NO | 是否为多级分区 | -| PARTITION_NAME | VARCHAR2(128) | NO | 分区名 | -| SUBPARTITION_COUNT | NUMBER | YES | 子分区个数 | -| HIGH_VALUE | VARCHAR2(1024) | NO | 分区表达式 | -| HIGH_VALUE_LENGTH | NUMBER | NO | 分区表达式的长度 | -| PARTITION_POSITION | NUMBER | NO | 分区的位置 | -| TABLESPACE_NAME | VARCHAR2(30) | NO | 分区所属表空间的名字 | -| PCT_FREE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| PCT_USED | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INI_TRANS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_TRANS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INITIAL_EXTENT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NEXT_EXTENT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MIN_EXTENT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_EXTENT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_SIZE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| PCT_INCREASE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| FREELISTS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| FREELIST_GROUPS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| LOGGING | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| COMPRESSION | VARCHAR2(8) | NO | 是否开启压缩 | -| COMPRESS_FOR | VARCHAR2(12) | YES | 压缩方法 | -| NUM_ROWS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| EMPTY_BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_SPACE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CHAIN_CNT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_ROW_LEN | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| SAMPLE_SIZE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| LAST_ANALYZED | DATE | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| BUFFER_POOL | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CELL_FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| GLOBAL_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| USER_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| IS_NESTED | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| PARENT_TABLE_PARTITION | VARCHAR2(30) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INTERVAL | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| SEGMENT_CREATED | VARCHAR2(4) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/34.ALL_TAB_PRIVS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/34.ALL_TAB_PRIVS.md deleted file mode 100644 index ffe425899..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/34.ALL_TAB_PRIVS.md +++ /dev/null @@ -1,52 +0,0 @@ -ALL_TAB_PRIVS -================================== - - - -功能 ------------ - -ALL_TAB_PRIVS 列出了满足以下条件的对象权限: - -* 当前用户为对象的拥有者,或为对象权限的授予者,或为对象权限的被授予者。 - - - -* 对象权限的被授予者为已激活角色或 PUBLIC 角色。 - - - - - - -相关视图 -------------- - -* DBA_TAB_PRIVS - - - -* USER_TAB_PRIVS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------|---------------|----------------|-------------------------------| -| GRANTOR | VARCHAR2(128) | NO | 执行授权的用户名 | -| GRANTEE | VARCHAR2(128) | NO | 被授予访问权限的用户名 | -| TABLE_SCHEMA | VARCHAR2(128) | NO | 对象的模式 | -| TABLE_NAME | VARCHAR2(128) | NO | 对象名称 | -| PRIVILEGE | VARCHAR2(40) | NO | 对象的权限 | -| GRANTABLE | VARCHAR2(3) | NO | 指示是否能通过 GRANT OPTION 授予权限 | -| HIERARCHY | VARCHAR2(10) | NO | 指示是否能通过 HIERARCHY OPTION 授予权限 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/35.ALL_TAB_SUBPARTITIONS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/35.ALL_TAB_SUBPARTITIONS.md deleted file mode 100644 index b4a31f019..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/35.ALL_TAB_SUBPARTITIONS.md +++ /dev/null @@ -1,72 +0,0 @@ -ALL_TAB_SUBPARTITIONS -========================================== - - - -功能 ------------ - -ALL_TAB_SUBPARTITIONS 用于显示 DBMS_STATS 包为当前用户可访问的分区生成的分区级别的分区信息、分区存储参数和分区统计信息。 - -相关视图 -------------- - -* DBA_TAB_SUBPARTITIONS - - - -* USER_TAB_SUBPARTITIONS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-----------------------|---------------|----------------|-------------------------| -| TABLE_OWNER | VARCHAR2(128) | NO | 表的所有者 | -| TABLE_NAME | VARCHAR2(128) | NO | 表名 | -| PARTITION_NAME | VARCHAR2(128) | NO | 分区名称 | -| SUBPARTITION_NAME | VARCHAR2(128) | NO | 子分区名称 | -| HIGH_VALUE | NUMBER | NO | 子分区表达式 | -| HIGH_VALUE_LENGTH | NUMBER | NO | 子分区表达式的长度 | -| SUBPARTITION_POSITION | VARCHAR2(30) | NO | 子分区在分区中的位置 | -| TABLESPACE_NAME | NUMBER | NO | 包含子分区的表空间的名称 | -| PCT_FREE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| PCT_USED | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INI_TRANS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_TRANS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INITIAL_EXTENT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NEXT_EXTENT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MIN_EXTENT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_EXTENT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_SIZE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| PCT_INCREASE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| FREELISTS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| FREELIST_GROUPS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| LOGGING | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| COMPRESSION | VARCHAR2(8) | NO | 子分区是否压缩 | -| COMPRESS_FOR | VARCHAR2(12) | YES | 压缩方法 | -| NUM_ROWS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| EMPTY_BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_SPACE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CHAIN_CNT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_ROW_LEN | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| SAMPLE_SIZE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| LAST_ANALYZED | DATE | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| BUFFER_POOL | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| FLASH_CACHE | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CELL_FLASH_CACHE | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| GLOBAL_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| USER_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INTERVAL | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| SEGMENT_CREATED | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/36.ALL_TRIGGERS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/36.ALL_TRIGGERS.md deleted file mode 100644 index 91e370cbf..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/36.ALL_TRIGGERS.md +++ /dev/null @@ -1,55 +0,0 @@ -ALL_TRIGGERS -================================= - - - -功能 ------------ - -描述当前用户拥有的表上触发器与描述。如果用户具有 CREATE ANY TRIGGER权限,则该视图描述数据库中的所有触发器。 - -相关视图 -------------- - -* DBA_TRIGGERS - - - -* USER_TRIGGERS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-------------------|-----------------|----------------|------------------------------------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 触发器 OWNER | -| TRIGGER_NAME | VARCHAR2(128) | NO | 触发器名字 | -| TRIGGER_TYPE | VARCHAR2(16) | NO | 触发器类型: * BEFORE/AFTER * ROW/STMT | -| TRIGGERING_EVENT | VARCHAR2(246) | NO | 触发事件,当前 OceanBase 数据库仅支持 INSERT、UPDATE、DELETE等。 | -| TABLE_OWNER | VARCHAR2(128) | NO | 表 OWNER,触发对象类型为表时有效。 | -| BASE_OBJECT_TYPE | VARCHAR2(18) | NO | 触发对象类型,当前 OceanBase 数据库仅支持 TABLE。 | -| TABLE_NAME | VARCHAR2(256) | NO | 表名,触发对象类型为表时有效。 | -| COLUMN_NAME | VARCHAR2(4000) | NO | 列名,仅在触发对象为嵌套表时有效,其它情况为 NULL。 | -| REFERENCING_NAMES | VARCHAR2(422) | NO | REF 名,OLD 和 NEW 的别名。 | -| WHEN_CLAUSE | VARCHAR2(4000) | YES | 触发条件 | -| STATUS | VARCHAR2(8) | NO | 状态: * ENABLE * DISABLE | -| DESCRIPTION | VARCHAR2(65536) | NO | 触发器描述,包括名字、类型、事件信息。 当前 OceanBase 数据库包含的信息比 Oracle 更多。 | -| ACTION_TYPE | VARCHAR2(11) | NO | ACTION 类型,当前 OceanBase 数据库仅支持 PL/SQL。 | -| TRIGGER_BODY | VARCHAR2(65536) | NO | 触发器语句 当前 OceanBase 数据库包含的信息比 Oracle 更多。 | -| CROSSEDITION | VARCHAR2(7) | NO | 跨版本信息,当前 OceanBase 数据库不支持。 | -| BEFORE_STATEMENT | VARCHAR2(3) | NO | 语句前,YES/NO。表示组合触发器是否包含指定类型的 Section。 | -| BEFORE_ROW | VARCHAR2(3) | NO | 行前,YES/NO。表示组合触发器是否包含指定类型的 Section。 | -| AFTER_ROW | VARCHAR2(3) | NO | 行后,YES/NO。表示组合触发器是否包含指定类型的 Section。 | -| AFTER_STATEMENT | VARCHAR2(3) | NO | 语句后,YES/NO。表示组合触发器是否包含指定类型的 Section。 | -| INSTEAD_OF_ROW | VARCHAR2(3) | NO | 代替,YES/NO。表示组合触发器是否包含指定类型的 Section。 | -| FIRE_ONCE | VARCHAR2(3) | NO | 目前暂不支持该字段 | -| APPLY_SERVER_ONLY | VARCHAR2(3) | NO | 目前暂不支持该字段 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/37.ALL_TYPES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/37.ALL_TYPES.md deleted file mode 100644 index 1949ba964..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/37.ALL_TYPES.md +++ /dev/null @@ -1,49 +0,0 @@ -ALL_TYPES -============================== - - - -功能 ------------ - -列出数据库中可用的用户自定义类型。 - -相关视图 -------------- - -* DBA_TYPES - - - -* USER_TYPES - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|------------------|---------------|----------------|---------------------------| -| OWNER | VARCHAR2(128) | NO | 对象所属的拥有者 | -| TYPE_NAME | VARCHAR2(64) | NO | 类型名 | -| TYPE_OID | NUMBER(38) | NO | 类型 OID | -| TYPECODE | VARCHAR2(10) | NO | 代表对象的类型,例如 OBJECT、 COLL 等 | -| ATTRIBUTES | NUMBER(38) | NO | 类型包含的属性数 | -| METHODS | NUMBER(38) | NO | 类型包含的方法数 | -| PREDEFINED | CHAR(2) | NO | 是否是系统预定义类型 | -| INCOMPLETE | CHAR(2) | NO | 是否是不完整类型, 只有名字没有方法和属性 | -| FINAL | CHAR(3) | NO | 是否不可被继承 | -| INSTANTIABLE | CHAR(3) | NO | 是否可实例化 | -| SUPERTYPE_OWNER | VARCHAR2(30) | NO | 父类型的拥有者 | -| SUPERTYPE_NAME | VARCHAR2(30) | NO | 父类型名 | -| LOCAL_ATTRIBUTES | NUMBER(38) | NO | 本地属性数 | -| LOCAL_METHODS | NUMBER(38) | NO | 本地方法数 | -| TYPEID | NUMBER(38) | YES | 目前暂不支持该字段,当前字段默认为NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/38.ALL_TYPE_ATTRS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/38.ALL_TYPE_ATTRS.md deleted file mode 100644 index 1e62329dd..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/38.ALL_TYPE_ATTRS.md +++ /dev/null @@ -1,46 +0,0 @@ -ALL_TYPE_ATTRS -=================================== - - - -功能 ------------ - -列出数据库中可用的用户自定义类型的属性信息。 - -相关视图 -------------- - -* DBA_TYPE_ATTRS - - - -* USER_TYPE_ATTRS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------------|---------------|----------------|-------------------------| -| OWNER | VARCHAR2(128) | NO | 对象所属的拥有者 | -| TYPE_NAME | VARCHAR2(64) | NO | 类型名 | -| ATTR_NAME | VARCHAR2(64) | NO | 类型属性名 | -| ATTR_TYPE_MOD | VARCHAR2(7) | NO | 类型的 Modify 属性。目前暂未使用该字段 | -| ATTR_TYPE_OWNER | VARCHAR2(128) | NO | 属性的类型拥有者 | -| ATTR_TYPE_NAME | VARCHAR2(324) | NO | 属性的类型名 | -| LENGTH | NUMBER(38) | NO | 属性类型长度 | -| NUMBER_PRECISION | NUMBER(38) | NO | 属性数值类型的长度 | -| SCALE | NUMBER(38) | NO | 数值类型小数点右边的数据长度 | -| CHARACTER_SET_NAME | CHAR(7) | NO | 属性类型的字符集 | -| ATTR_NO | NUMBER(38) | NO | 属性编号 | -| INHERITED | CHAR(2) | NO | 该属性是否继承自父类型 | -| CHAR_USED | CHAR(1) | YES | 目前暂不支持该字段,该字段字段默认为NULL | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/39.ALL_TYPE_METHODS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/39.ALL_TYPE_METHODS.md deleted file mode 100644 index 257d7acff..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/39.ALL_TYPE_METHODS.md +++ /dev/null @@ -1,50 +0,0 @@ -ALL_TYPE_METHODS -===================================== - - -**说明** - - - -OceanBase 数据库暂未支持该视图。 - -功能 ------------ - -查看用户可以访问的对象类型的方法。 - -相关视图 -------------- - -* DBA_TYPE_METHODS - - - -* USER_TYPE_METHODS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------|--------------|----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(30) | NO | 类型的拥有者 | -| TYPE_NAME | VARCHAR2(30) | NO | 类型的名称 | -| METHOD_NAME | VARCHAR2(30) | NO | 方法的名称 | -| METHOD_NO | NUMBER | NO | 方法编号,为了区分重载方法 | -| METHOD_TYPE | VARCHAR2(6) | NO | 方法类型: * MAP * ORDER * PUBLIC | -| PARAMETERS | NUMBER | NO | 方法参数的个数 | -| RESULTS | NUMBER | NO | 方法返回结果的个数 | -| FINAL | VARCHAR2(3) | NO | 表明此方法是否为 FINAL: * YES * NO | -| INSTANTIABLE | VARCHAR2(3) | NO | 表明此方法是否可实例化: * YES * NO | -| OVERRIDING | VARCHAR2(3) | NO | 表明此方法是否重载一个超类型方法: * YES * NO | -| INHERITED | VARCHAR2(3) | NO | 表明此方法是否继承自一个超类型: * YES * NO | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/4.ALL_COLL_TYPES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/4.ALL_COLL_TYPES.md deleted file mode 100644 index 0737f46c8..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/4.ALL_COLL_TYPES.md +++ /dev/null @@ -1,47 +0,0 @@ -ALL_COLL_TYPES -=================================== - - - -功能 ------------ - -列出数据库中可用的用户自定义集合类型。其列与 DBA_COLL_TYPES 中的列相同。 - -相关视图 -------------- - -* DBA_COLL_TYPES - - - -* USER_COLL_TYPES - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------------|---------------|----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 对象所属的拥有者 | -| TYPE_NAME | VARCHAR2(64) | NO | 类型名 | -| COLL_TYPE | VARCHAR2(10) | NO | 集合类型: * VARYING * ARRAY * NESTED TABLE | -| UPPER_BOUND | NUMBER(38) | YES | 对于 VARYING,记录集合的最大大小 | -| ELEM_TYPE_MOD | VARCHAR2(7) | YES | 目前暂不支持该字段,当前字段默认为 NULL | -| ELEM_TYPE_OWNER | VARCHAR2(128) | YES | 集合元素类型的拥有者 | -| ELEM_TYPE_NAME | VARCHAR2(324) | YES | 集合元素类型名 | -| LENGTH | NUMBER(38) | YES | 集合元素类型长度 | -| NUMBER_PRECISION | NUMBER(38) | YES | 集合元素类型精度 | -| SCALE | NUMBER(38) | YES | 集合元素类型小数点右边数据的长度 | -| CHARACTER_SET_NAME | CHAR(7) | YES | 集合元素类型字符集 | -| ELEM_STORAGE | CHAR(3) | YES | 目前暂不支持该字段,当前字段默认为 NULL | -| NULLS_STORED | CHAR(1) | YES | 目前暂不支持该字段,当前字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/40.ALL_USERS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/40.ALL_USERS.md deleted file mode 100644 index 095592f7f..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/40.ALL_USERS.md +++ /dev/null @@ -1,28 +0,0 @@ -ALL_USERS -============================== - - - -功能 ------------ - -查看所有用户。 - -相关视图 -------------- - -DBA_USERS - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------|--------------|----------------|---------| -| USERNAME | VARCHAR2(30) | NO | 用户名 | -| USERID | NUMBER(38) | NO | 用户 ID | -| CREATED | DATE | NO | 创建用户的时间 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/41.ALL_VIEWS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/41.ALL_VIEWS.md deleted file mode 100644 index 14063e850..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/41.ALL_VIEWS.md +++ /dev/null @@ -1,44 +0,0 @@ -ALL_VIEWS -============================== - - - -功能 ------------ - -查看所有视图。 - -相关视图 -------------- - -* DBA_VIEWS - - - -* USER_VIEWS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-----------------|----------------|----------------|----------------------------------------------| -| OWNER | VARCHAR2(128) | NO | VIEW 所属的 USER | -| VIEW_NAME | VARCHAR2(128) | NO | 索引名字 | -| TEXT_LENGTH | NUMBER | NO | 视图定义长度。 | -| TEXT | VARCHAR2(4000) | NO | 视图正文 | -| OID_TEXT_LENGTH | NUMBER | NO | 类型视图的 WITH OID 子句的长度。目前暂不支持该字段,当前该字段默认为 NULL | -| OID_TEXT | VARCHAR2(4000) | NO | 类型视图的 WITH OID子句。目前暂不支持该字段,当前该字段默认为 NULL | -| VIEW_TYPE | VARCHAR2(30) | NO | 视图的类型(如果视图是类型视图)。目前暂不支持该字段,当前该字段默认为 NULL | -| SUPERVIEW_NAME | VARCHAR2(30) | NO | 超级视图的名称。目前暂不支持该字段,当前该字段默认为 NULL | -| EDITIONING_VIEW | VARCHAR2(1) | NO | 保留以备将来使用。 | -| READ_ONLY | VARCHAR2(1) | NO | 表示视图是否只读。目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/42.AUDIT_ACTIONS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/42.AUDIT_ACTIONS.md deleted file mode 100644 index eac06ece8..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/42.AUDIT_ACTIONS.md +++ /dev/null @@ -1,27 +0,0 @@ -AUDIT_ACTIONS -================================== - - - -功能 ------------ - -记录审计记录中 action id 和对应的名称。 - -相关视图 -------------- - -无 - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------|---------------|----------------|--------------------------| -| ACTION | NUMBER(38) | NO | 审计记录中的 Action ID | -| NAME | VARCHAR2(128) | NO | 审计记录中 Action ID 对应的 Name | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/43.ALL_DEPENDENCIES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/43.ALL_DEPENDENCIES.md deleted file mode 100644 index 9f577d45a..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/43.ALL_DEPENDENCIES.md +++ /dev/null @@ -1,41 +0,0 @@ -ALL_DEPENDENCIES -===================================== - - - -功能 ------------------------ - -`ALL_DEPENDENCIES` 视图用于展示数据库中所有对象之间的依赖关系。目前仅支持展示 PL 对象之间的依赖关系。 - -相关视图 -------------------------- - -* `DBA_DEPENDENCIES` - - - -* `USER_DEPENDENCIES` - - - - - - -字段说明 -------------------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------------------|---------------|----------------|-----------------| -| OWNER | VARCHAR2(128) | NO | 依赖者 Owner 的名称 | -| NAME | VARCHAR2(128) | NO | 依赖者的名称 | -| TYPE | VARCHAR2(23) | NO | 依赖者的类型 | -| REFERENCED_OWNER | VARCHAR2(128) | NO | 被依赖者的 Owner 名称 | -| REFERENCED_NAME | VARCHAR2(128) | NO | 被依赖者的名称 | -| REFERENCED_TYPE | VARCHAR2(18) | NO | 被依赖者的类型 | -| REFERENCED_LINK_NAME | VARCHAR2(128) | NO | 被依赖者的 Dblink 名称 | -| DEPENDENCY_TYPE | VARCHAR2(4) | NO | 指示该依赖为强依赖或者其他依赖 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/44.DBA_ALL_TABLES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/44.DBA_ALL_TABLES.md deleted file mode 100644 index de2e1df9b..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/44.DBA_ALL_TABLES.md +++ /dev/null @@ -1,92 +0,0 @@ -DBA_ALL_TABLES -=================================== - - - -功能 ------------ - -查看数据库中的对象表和关系表,它的字段与 ALL_ALL_TABLES 相同。 - -相关视图 -------------- - -* ALL_ALL_TABLES - - - -* USER_ALL_TABLES - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|---------------------------|---------------|----------------|---------------------------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 表的拥有者 | -| TABLE_NAME | VARCHAR2(128) | NO | 表名 | -| TABLESPACE_NAME | VARCHAR2(30) | NO | 包含该表的表空间名字 | -| CLUSTER_NAME | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| IOT_NAME | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| STATUS | VARCHAR2(8) | NO | 表状态: * VALID * UNUSABLE | -| PCT_FREE | NUMBER | NO | 块的最小空闲空间比例 | -| PCT_USED | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INI_TRANS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_TRANS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INITIAL_EXTENT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NEXT_EXTENT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MIN_EXTENTS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_EXTENTS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| PCT_INCREASE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| FREELISTS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| FREELIST_GROUPS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| LOGGING | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| BACKED_UP | VARCHAR2(1) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NUM_ROWS | NUMBER | NO | 表行数 | -| BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| EMPTY_BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_SPACE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CHAIN_CNT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_ROW_LEN | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_SPACE_FREELIST_BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NUM_FREELIST_BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEGREE | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INSTANCES | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CACHE | VARCHAR2(20) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| TABLE_LOCK | VARCHAR2(8) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| SAMPLE_SIZE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| LAST_ANALYZED | DATE | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| PARTITIONED | VARCHAR2(3) | NO | 指定表是否是分区: * YES * NO | -| IOT_TYPE | VARCHAR2(12) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| OBJECT_ID_TYPE | VARCHAR2(16) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| TABLE_TYPE_OWNER | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| TABLE_TYPE | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| TEMPORARY | VARCHAR2(1) | NO | 指定表是否是临时表 | -| SECONDARY | VARCHAR2(1) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NESTED | VARCHAR2(3) | NO | 指定表是否是嵌套表: * YES * NO | -| BUFFER_POOL | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CELL_FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| ROW_MOVEMENT | VARCHAR2(8) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| GLOBAL_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| USER_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DURATION | VARCHAR2(15) | NO | 指示临时表的持续时间 | -| SKIP_CORRUPT | VARCHAR2(8) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MONITORING | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CLUSTER_OWNER | VARCHAR2(30) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEPENDENCIES | VARCHAR2(8) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| COMPRESSION | VARCHAR2(8) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| COMPRESS_FOR | VARCHAR2(12) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DROPPED | VARCHAR2(3) | NO | 表示被删除表是否在回收站里 | -| READ_ONLY | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| SEGMENT_CREATED | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| RESULT_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/45.DBA_ARGUMENTS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/45.DBA_ARGUMENTS.md deleted file mode 100644 index b84fc4389..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/45.DBA_ARGUMENTS.md +++ /dev/null @@ -1,56 +0,0 @@ -DBA_ARGUMENTS -================================== - - - -功能 ------------ - -列出数据库中可用的过程和函数的参数。其列与 ALL_ARGUMENTS 中的列相同。 - -相关视图 -------------- - -* ALL_ARGUMENTS - - - -* USER_ARGUMENTS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------------|---------------|----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 对象所属的拥有者 | -| OBJECT_NAME | VARCHAR2(128) | YES | 过程或者函数名 | -| PACKAGE_NAME | VARCHAR2(128) | YES | 包名 | -| OBJECT_ID | NUMBER | NO | 对象 ID | -| OVERLOAD | NUMBER | YES | 出现在包源文件中的第几次重载 | -| SUBPROGRAM_ID | NUMBER | YES | 出现在包中的顺序,对于独立的过程或者函数该值为 1 | -| ARGUMENT_NAME | VARCHAR2(128) | YES | 参数名, 该值为 NULL 说明是函数的返回值 | -| POSITION | NUMBER(38) | NO | 出现在参数列表中的位置 | -| SEQUENCE | NUMBER(38) | NO | 对于复杂类型,该值代表属性的序号 | -| DATA_LEVEL | NUMBER(38) | NO | 对于嵌套的复杂类型,该值代表当前类型嵌套的层次 | -| DATA_TYPE | VARCHAR2(128) | YES | 参数的数据类型,对于嵌套的复杂类型, 该值代表当前层的数据类型 | -| DEFAULTED | CHAR(2) | YES | 标识当前参数是否有默认值 | -| DATA_LENGTH | NUMBER(38) | YES | 数据类型的长度 | -| IN_OUT | VARCHAR2(5) | YES | 参数的输入输出属性(NULL 表示是返回值) * IN * OUT * IN OUT | -| DATA_PRECISION | NUMBER(38) | YES | 数值类型的最大长度 | -| DATA_SCALE | NUMBER(38) | YES | 数值类型小数点右边的数据长度 | -| CHARACTER_SET_NAME | VARCHAR2(7) | YES | 参数的字符集名 | -| COLLATION | VARCHAR2(18) | YES | 字符集排序规则 | -| TYPE_OWNER | NUMBER(38) | YES | 复杂数据类型的类型拥有者 | -| TYPE_NAME | VARCHAR2(128) | YES | 复杂数据类型的名字 | -| TYPE_SUBNAME | VARCHAR2(128) | YES | 如果是包中的类型, 该字段代表包名 | -| ORIGIN_CON_ID | NUMBER(38) | YES | 该字段当前代表租户 ID | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/46.DBA_AUDIT_EXISTS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/46.DBA_AUDIT_EXISTS.md deleted file mode 100644 index dd28258ef..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/46.DBA_AUDIT_EXISTS.md +++ /dev/null @@ -1,50 +0,0 @@ -DBA_AUDIT_EXISTS -===================================== - - - -功能 ------------ - -显示 `AUDIT EXISTS` 和 `AUDIT NOT EXISTS` 产生的审计跟踪条目。 - -字段说明 -------------- - - - -| **字段名称** | **类型** | 是否可以为 NULL | **描述** | -|--------------------|-----------------------------|------------|-------------------------------------------------------| -| OS_USERNAME | VARCHAR2(255) | NO | 已审核其操作的用户的操作系统登录用户名。目前暂不支持该字段,当前该字段默认为 NULL | -| USERNAME | VARCHAR2(64) | NO | 审核其操作的用户的名称,不是 ID 号 | -| USERHOST | VARCHAR2(32) | NO | 客户端主机名。目前暂不支持该字段,当前该字段默认为 NULL | -| TERMINAL | VARCHAR2(255) | NO | 用户终端的标识符。目前暂不支持该字段,当前该字段默认为 NULL | -| TIMESTAMP | DATE | NO | 在本地数据库会话时区中创建审计跟踪条目的日期和时间(由审计会话创建的条目的用户登录日期和时间) | -| OWNER | VARCHAR2(64) | YES | 不存在对象的预定创造者 | -| OBJ_NAME | VARCHAR2(256) | YES | 受操作影响的对象的名称 | -| ACTION_NAME | VARCHAR2(128) | NO | 与 DBA_AUDIT_TRAIL 中操作列中的数字代码对应的操作类型的名称 | -| NEW_OWNER | VARCHAR2(64) | YES | 在 NEW_NAME 列中命名的对象的所有者 | -| NEW_NAME | VARCHAR2(256) | YES | 在重命名或基础对象的名称之后重新命名对象 | -| OBJ_PRIVILEGE | VARCHAR2(255) | NO | 由 GRANT 或 REVOKE语句授予或撤销的对象特权,待 Patch | -| SYS_PRIVILEGE | VARCHAR2(255) | NO | 由 GRANT 或 REVOKE 语句授予或撤消的系统特权,待 Patch | -| GRANTEE | VARCHAR2(128) | NO | GRANT 或 REVOKE 中指定的授予者名称,待 Patch | -| SESSIONID | NUMBER(38) | NO | 会话的数字 ID | -| ENTRYID | NUMBER(38) | NO | 会话中每个审计跟踪条目的数字 ID | -| STATEMENTID | NUMBER(38) | NO | 每个语句的数字 ID | -| RETURNCODE | NUMBER(38) | NO | 操作生成的错误代码。 | -| CLIENT_ID | VARCHAR2(40) | NO | 会话中的客户端标识符。目前暂不支持该字段,当前该字段默认为 NULL | -| ECONTEXT_ID | VARCHAR2(40) | NO | 应用程序执行上下文标识符。目前暂不支持该字段,当前该字段默认为 NULL | -| SESSION_CPU | NUMBER(38) | NO | 会话使用的 CPU 时间 | -| EXTENDED_TIMESTAMP | TIMESTAMP(6) WITH TIME ZONE | NO | 在 UTC 时区中创建审计跟踪条目的时间戳 | -| PROXY_SESSIONID | NUMBER(38) | NO | 代理会话序列号 | -| GLOBAL_UID | NUMBER(38) | NO | 用户的全局用户标识符 | -| INSTANCE_NUMBER | VARCHAR2(40) | NO | 实例编号由 INSTANCE_NUMBER 初始化参数指定。目前暂不支持该字段,当前该字段默认为 NULL | -| OS_PROCESS | VARCHAR2(40) | NO | 操作系统进程标识符。目前暂不支持该字段,当前该字段默认为 NULL | -| TRANSACTIONID | VARCHAR2(128) | NO | 在其中访问或修改对象的事务标识符 | -| SCN | NUMBER(38) | NO | 系统变更号(SCN)的查询。目前暂不支持该字段,当前该字段默认为 NULL | -| SQL_BIND | VARCHAR2(2000) | NO | 绑定查询的变量数据。目前暂不支持该字段,当前该字段默认为 NULL | -| SQL_TEXT | VARCHAR2(2000) | NO | 查询的 SQL 文本 | -| OBJ_EDITION_NAME | VARCHAR2(128) | NO | 预留字段,暂不支持 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/47.DBA_AUDIT_OBJECT.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/47.DBA_AUDIT_OBJECT.md deleted file mode 100644 index de38483b9..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/47.DBA_AUDIT_OBJECT.md +++ /dev/null @@ -1,59 +0,0 @@ -DBA_AUDIT_OBJECT -===================================== - - - -功能 ------------ - -显示数据库中所有对象的审计跟踪记录。 - -相关视图 -------------- - -* USER_AUDIT_OBJECT - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------------|-----------------------------|----------------|-------------------------------------------------------| -| OS_USERNAME | VARCHAR2(255) | NO | 操作被审计的用户的操作系统登录用户名。目前暂不支持该字段,当前该字段默认为 NULL | -| USERNAME | VARCHAR2(32) | NO | 操作被审计的用户的名称 | -| USERHOST | VARCHAR2(64) | NO | 客户端主机名称。目前暂不支持该字段,当前该字段默认为 NULL | -| TERMINAL | VARCHAR2(255) | NO | 用户终端的标识符。目前暂不支持该字段,当前该字段默认为 NULL | -| TIMESTAMP | DATE | NO | 在本地数据库会话时区中创建审计跟踪条目的日期和时间 | -| OWNER | VARCHAR2(64) | YES | 受操作影响的对象的创建者 | -| OBJ_NAME | VARCHAR2(256) | YES | 受操作影响的对象的名称 | -| ACTION_NAME | VARCHAR2(128) | NO | 与 DBA_AUDIT_TRAIL 中操作列中的数字代码对应的操作类型的名称 | -| NEW_OWNER | VARCHAR2(64) | YES | 在 NEW_NAME 列中命名的对象的所有者 | -| NEW_NAME | VARCHAR2(256) | YES | 对象在 RENAME 之后的新名称或基础对象的名称 | -| SES_ACTIONS | VARCHAR2(19) | NO | 会话摘要。目前暂不支持该字段,当前该字段默认为 NULL | -| COMMENT_TEXT | VARCHAR2(65536) | YES | 在审计跟踪上的文本注释 | -| SESSIONID | NUMBER(38) | NO | 会话的数字 ID | -| ENTRYID | NUMBER(38) | NO | 会话中每个审计跟踪条目的数字 ID | -| STATEMENTID | NUMBER(38) | NO | 每个语句的数字 ID | -| RETURNCODE | NUMBER(38) | NO | 操作生成的错误代码 | -| PRIV_USED | VARCHAR2(40) | NO | 用于执行操作的系统权限。目前暂不支持该字段,当前该字段默认为 NULL | -| CLIENT_ID | VARCHAR2(40) | NO | 会话中的客户端标识符。目前暂不支持该字段,当前该字段默认为 NULL | -| ECONTEXT_ID | VARCHAR2(40) | NO | 应用程序执行上下文标识符。目前暂不支持该字段,当前该字段默认为 NULL | -| SESSION_CPU | NUMBER(38) | NO | 会话使用的 CPU 时间 | -| EXTENDED_TIMESTAMP | TIMESTAMP(6) WITH TIME ZONE | NO | 在 UTC 时区中创建审计跟踪条目的时间戳 | -| PROXY_SESSIONID | NUMBER(38) | NO | 代理会话序列号 | -| GLOBAL_UID | NUMBER(38) | NO | 用户的全局用户标识符 | -| INSTANCE_NUMBER | VARCHAR2(40) | NO | 由 INSTANCE_NUMBER初始化参数指定的实例编号。目前暂不支持该字段,当前该字段默认为 NULL | -| OS_PROCESS | VARCHAR2(40) | NO | 进程的操作系统进程标识符。目前暂不支持该字段,当前该字段默认为 NULL | -| TRANSACTIONID | VARCHAR2(128) | NO | 在其中访问或修改对象的事务标识符 | -| SCN | NUMBER(38) | NO | 系统变更号(SCN)的查询。目前暂不支持该字段,当前该字段默认为 0 | -| SQL_BIND | VARCHAR2(2000) | YES | 绑定查询的变量数据。目前暂不支持该字段,当前该字段默认为 NULL | -| SQL_TEXT | VARCHAR2(2000) | YES | 查询的 SQL 文本 | -| OBJ_EDITION_NAME | VARCHAR2(128) | NO | 包含被审计对象的版本的名称。目前暂不支持该字段,当前该字段默认为 NULL | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/48.DBA_AUDIT_SESSION.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/48.DBA_AUDIT_SESSION.md deleted file mode 100644 index feae8d526..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/48.DBA_AUDIT_SESSION.md +++ /dev/null @@ -1,50 +0,0 @@ -DBA_AUDIT_SESSION -====================================== - - - -功能 ------------ - -显示所有关于 `CONNECT` 和 `DISCONNECT` 的审计跟踪记录。 - -相关视图 -------------- - -* USER_AUDIT_SESSION - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------------|-----------------------------|----------------|--------------------------------------------------------| -| OS_USERNAME | VARCHAR2(255) | NO | 操作被审计的用户的操作系统登录用户名。目前暂不支持该字段,当前该字段默认为 NULL | -| USERNAME | VARCHAR2(64) | NO | 操作被审计的用户的名称 | -| USERHOST | VARCHAR2(32) | NO | 客户端主机名称。目前暂不支持该字段,当前该字段默认为 NULL | -| TERMINAL | VARCHAR2(255) | NO | 用户终端的标识符。目前暂不支持该字段,当前该字段默认为 NULL | -| TIMESTAMP | DATE | NO | 在本地数据库会话时区中创建审计跟踪条目的日期和时间 | -| ACTION_NAME | VARCHAR2(128) | NO | 与 DBA_AUDIT_TRAIL 中操作列中的数字代码对应的操作类型的名称 | -| LOGOFF_TIME | DATE | NO | 用户注销的日期和时间 | -| LOGOFF_LREAD | NUMBER(38) | NO | 会话的逻辑读取 | -| LOGOFF_PREAD | NUMBER | NO | 会话的物理读取。目前暂不支持该字段,当前该字段默认为 NULL | -| LOGOFF_LWRITE | NUMBER | NO | 会话的逻辑写操作。目前暂不支持该字段,当前该字段默认为 NULL | -| LOGOFF_DLOCK | VARCHAR2(40) | NO | 在会话期间检测到的死锁。目前暂不支持该字段,当前该字段默认为 NULL | -| SESSIONID | NUMBER(38) | NO | 会话的数字 ID | -| RETURNCODE | NUMBER(38) | NO | 操作生成的错误代码 | -| CLIENT_ID | VARCHAR2(40) | NO | 每个会话中的客户端标识符 | -| SESSION_CPU | NUMBER(38) | NO | 会话使用的 CPU 时间 | -| EXTENDED_TIMESTAMP | TIMESTAMP(6) WITH TIME ZONE | NO | 在 UTC 时区中创建审计跟踪条目的时间戳 | -| PROXY_SESSIONID | NUMBER(38) | NO | 代理会话序列号 | -| GLOBAL_UID | NUMBER(38) | NO | 用户的全局用户标识符 | -| INSTANCE_NUMBER | VARCHAR2(40) | NO | 由 INSTANCE_NUMBER 初始化参数指定的实例编号。目前暂不支持该字段,当前该字段默认为 NULL | -| OS_PROCESS | VARCHAR2(40) | NO | 进程的操作系统进程标识符。目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/49.DBA_AUDIT_STATEMENT.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/49.DBA_AUDIT_STATEMENT.md deleted file mode 100644 index 3c7ea5a64..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/49.DBA_AUDIT_STATEMENT.md +++ /dev/null @@ -1,58 +0,0 @@ -DBA_AUDIT_STATEMENT -======================================== - - - -功能 ------------ - -DBA_AUDIT_STATEMENT 用于展示整个数据库中关于 `GRANT`、`REVOKE`、`AUDIT`、`NOAUDIT `和 `ALTER SYSTEM `语句的审计跟踪记录。 - -相关视图 -------------- - -USER_AUDIT_STATEMENT - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------------|-----------------------------|----------------|---------------------------------------------------------| -| OS_USERNAME | VARCHAR2(255) | NO | 操作被审计的用户的操作系统登录用户名。目前暂不支持该字段,当前该字段默认为 NULL。 | -| USERNAME | VARCHAR2(64) | NO | 操作被审计的用户的名称。 | -| USERHOST | VARCHAR2(32) | NO | 客户端主机名称。目前暂不支持该字段,当前该字段默认为 NULL。 | -| TERMINAL | VARCHAR2(255) | NO | 用户终端的标识符。目前暂不支持该字段,当前该字段默认为 NULL。 | -| TIMESTAMP | DATE | NO | 在本地数据库会话时区中创建审计跟踪条目的日期和时间。 | -| OWNER | VARCHAR2(64) | YES | 受行为影响的对象的创建者。 | -| OBJ_NAME | VARCHAR2(256) | YES | 受操作影响的对象的名称。 | -| ACTION_NAME | VARCHAR2(128) | NO | 与 DBA_AUDIT_TRAIL 中操作列中的数字代码对应的操作类型的名称。 | -| NEW_NAME | VARCHAR2(256) | YES | 对象在 RENAME 之后的新名称或基础对象的名称。 | -| OBJ_PRIVILEGE | VARCHAR2(255) | NO | 由 GRANT 或 REVOKE 语句授予或撤销的对象权限。 | -| SYS_PRIVILEGE | VARCHAR2(255) | NO | 由 GRANT 或 REVOKE 语句授予或撤消的系统权限。 | -| ADMIN_OPTION | VARCHAR2(1) | NO | 表示已使用 ADMIN 选项授予角色或系统特权。 | -| GRANTEE | VARCHAR2(128) | NO | GRANT 或 REVOKE 中指定的授予者名称。 | -| AUDIT_OPTION | VARCHAR2(40) | NO | 与 AUDIT 语句一起设置的审计选项。 | -| SES_ACTIONS | VARCHAR2(19) | NO | 会话摘要。目前暂不支持该字段,当前该字段默认为 NULL。 | -| COMMENT_TEXT | VARCHAR2(65536) | YES | 审核跟踪上的文本注释,由应用程序插入。 | -| SESSIONID | NUMBER(38) | NO | 会话的数字 ID。 | -| ENTRYID | NUMBER(38) | NO | 会话中每个审计跟踪条目的数字 ID。 | -| STATEMENTID | NUMBER(38) | NO | 每个语句的数字 ID。 | -| RETURNCODE | NUMBER(38) | NO | 操作生成的错误代码。 | -| PRIV_USED | VARCHAR2(40) | NO | 用于执行操作的系统权限。目前暂不支持该字段,当前该字段默认为 NULL。 | -| CLIENT_ID | VARCHAR2(40) | NO | 会话中的客户端标识符。目前暂不支持该字段,当前该字段默认为 NULL。 | -| ECONTEXT_ID | VARCHAR2(40) | NO | 应用程序执行上下文标识符。目前暂不支持该字段,当前该字段默认为 NULL。 | -| SESSION_CPU | NUMBER(38) | NO | 会话使用的 CPU 时间。 | -| EXTENDED_TIMESTAMP | TIMESTAMP(6) WITH TIME ZONE | NO | 在 UTC 时区中创建审计跟踪条目的时间戳。 | -| PROXY_SESSIONID | NUMBER(38) | NO | 代理会话序列号。 | -| GLOBAL_UID | NUMBER(38) | NO | 用户的全局用户标识符。 | -| INSTANCE_NUMBER | VARCHAR2(40) | NO | 由 INSTANCE_NUMBER 初始化参数指定的实例编号。目前暂不支持该字段,当前该字段默认为 NULL。 | -| OS_PROCESS | VARCHAR2(40) | NO | 进程的操作系统进程标识符。目前暂不支持该字段,当前该字段默认为 NULL。 | -| TRANSACTIONID | VARCHAR2(128) | NO | 在其中访问或修改对象的事务标识符。 | -| SCN | NUMBER(38) | NO | 系统变更号(SCN)的查询。目前暂不支持该字段,当前该字段默认为 NULL。 | -| SQL_BIND | VARCHAR2(2000) | YES | 绑定查询的变量数据。目前暂不支持该字段,当前该字段默认为 NULL。 | -| SQL_TEXT | VARCHAR2(2000) | YES | 查询的 SQL 文本。 | -| OBJ_EDITION_NAME | VARCHAR2(128) | NO | 包含被审计对象的版本的名称。目前暂不支持该字段,当前该字段默认为 NULL。 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/5.ALL_COL_PRIVS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/5.ALL_COL_PRIVS.md deleted file mode 100644 index 3b587c585..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/5.ALL_COL_PRIVS.md +++ /dev/null @@ -1,52 +0,0 @@ -ALL_COL_PRIVS -================================== - - - -功能 ------------ - -ALL_COL_PRIVS 描述以下类型的权限: - -* 当前用户为其对象所有者,授予者或被授予者的列对象权限 - - - -* 已启用角色或被授予者是 PUBLIC 的列对象权限 - - - - - - -相关视图 -------------- - -* DBA_COL_PRIV - - - -* USER_COL_PRIV - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-------------|---------------|----------------|---------------| -| GRANTOR | VARCHAR2(128) | NO | 执行授予的用户的名称 | -| GRANTEE | VARCHAR2(128) | NO | 被授予访问权限的用户的名称 | -| OWNER | VARCHAR2(128) | NO | 对象的拥有者 | -| TABLE_NAME | VARCHAR2(256) | NO | 对象的名称 | -| COLUMN_NAME | VARCHAR2(128) | NO | 列的名称 | -| PRIVILLEGE | VARCHAR2(40) | NO | 列的权限 | -| GRANTABLE | VARCHAR2(3) | NO | 是否使用授予选项 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/50.DBA_AUDIT_TRAIL.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/50.DBA_AUDIT_TRAIL.md deleted file mode 100644 index a76d575e6..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/50.DBA_AUDIT_TRAIL.md +++ /dev/null @@ -1,66 +0,0 @@ -DBA_AUDIT_TRAIL -==================================== - - - -功能 ------------ - -显示所有审计跟踪条目。 - -相关视图 -------------- - -USER_AUDIT_TRAIL - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------------|-----------------------------|----------------|-----------------------------------------------------------| -| OS_USERNAME | VARCHAR2(255) | NO | 操作被审计的用户的操作系统登录用户名。目前暂不支持该字段,当前该字段默认为 NULL | -| USERNAME | VARCHAR2(64) | NO | 操作被审计的用户的名称 | -| USERHOST | VARCHAR2(32) | NO | 客户端主机名称。目前暂不支持该字段,当前该字段默认为 NULL | -| TERMINAL | VARCHAR2(255) | NO | 用户终端的标识符。目前暂不支持该字段,当前该字段默认为 NULL | -| TIMESTAMP | DATE | NO | 在本地数据库会话时区中创建审计跟踪条目的日期和时间 | -| OWNER | VARCHAR2(64) | YES | 受行为影响的对象的创建者 | -| OBJ_NAME | VARCHAR2(256) | YES | 受操作影响的对象的名称 | -| ACTION | NUMBER(38) | NO | 数字操作类型代码。操作类型的对应名称在 ACTION_NAME 列中 | -| ACTION_NAME | VARCHAR2(128) | NO | 与 ACTION 列中的数字代码对应的操作类型的名称 | -| NEW_OWNER | VARCHAR2(64) | YES | 在 NEW_NAME 列中命名的对象的所有者 | -| NEW_NAME | VARCHAR2(256) | YES | 对象的新名称在 RENAME 之后或基础对象的名称之后 | -| OBJ_PRIVILEGE | VARCHAR2(255) | NO | 由 GRANT 或 REVOKE 语句授予或撤销的对象权限,待 Patch | -| SYS_PRIVILEGE | VARCHAR2(255) | NO | 由 GRANT 或 REVOKE 语句授予或撤消的系统权限,待 Patch | -| ADMIN_OPTION | VARCHAR2(1) | NO | 指示是否使用 ADMIN 选项授予角色或系统权限,待 Patch | -| GRANTEE | VARCHAR2(128) | NO | GRANT 或 REVOKE 中指定的授予者名称,待 Patch | -| AUDIT_OPTION | VARCHAR2(40) | NO | 审计选项与审计语句一起设置,待 Patch | -| SES_ACTIONS | VARCHAR2(19) | NO | 会话摘要。目前暂不支持该字段,当前该字段默认为 NULL | -| LOGOFF_TIME | DATE | NO | 用户注销的日期和时间 | -| LOGOFF_LREAD | NUMBER(38) | NO | 会话的逻辑读取 | -| LOGOFF_PREAD | NUMBER | NO | 会话的物理读取。目前暂不支持该字段,当前该字段默认为 NULL | -| LOGOFF_LWRITE | NUMBER | NO | 会话的逻辑写操作。目前暂不支持该字段,当前该字段默认为 NULL | -| LOGOFF_DLOCK | VARCHAR2(40) | NO | 在会话期间检测到死锁。目前暂不支持该字段,当前该字段默认为 NULL | -| COMMENT_TEXT | VARCHAR2(65536) | YES | 在审计跟踪条目上的文本注释 | -| SESSIONID | NUMBER(38) | NO | 会话的数字 ID | -| ENTRYID | NUMBER(38) | NO | 会话中每个审计跟踪条目的数字 ID | -| STATEMENTID | NUMBER(38) | NO | 每个语句的数字 ID | -| RETURNCODE | NUMBER(38) | NO | 操作生成的错误代码 | -| PRIV_USED | VARCHAR2(40) | NO | 用于执行操作的系统权限。目前暂不支持该字段,当前该字段默认为 NULL | -| CLIENT_ID | VARCHAR2(40) | NO | 会话中的客户端标识符。 OceanBase 数据库暂不支持该字段,默认为 NULL | -| ECONTEXT_ID | VARCHAR2(40) | NO | 应用程序执行上下文标识符。目前暂不支持该字段,当前该字段默认为 NULL | -| SESSION_CPU | NUMBER(38) | NO | 会话使用的 CPU 时间 | -| EXTENDED_TIMESTAMP | TIMESTAMP(6) WITH TIME ZONE | NO | 在 UTC 时区中创建审计跟踪条目的时间戳 | -| PROXY_SESSIONID | NUMBER(38) | NO | 代理会话序列号 | -| GLOBAL_UID | NUMBER(38) | NO | 用户的全局用户标识符 | -| INSTANCE_NUMBER | VARCHAR2(40) | NO | 由 INSTANCE_NUMBER 初始化参数指定的实例编号。目前暂不支持该字段,当前该字段默认为 NULL | -| OS_PROCESS | VARCHAR2(40) | NO | 操作系统进程标识符。目前暂不支持该字段,当前该字段默认为 NULL | -| TRANSACTIONID | VARCHAR2(128) | NO | 在其中访问或修改对象的事务标识符 | -| SCN | NUMBER(38) | NO | 系统变更号(SCN)的查询。目前暂不支持该字段,当前该字段默认为 0 | -| SQL_BIND | VARCHAR2(2000) | YES | 绑定查询的变量数据。目前暂不支持该字段,当前该字段默认为 NULL | -| SQL_TEXT | VARCHAR2(2000) | YES | 查询的 SQL 文本 | -| OBJ_EDITION_NAME | VARCHAR2(128) | NO | 包含被审计对象的版本的名称。目前暂不支持该字段,当前该字段默认为 NULL | -| DBID | NUMBER(38) | NO | 被审计数据库的数据库标识符 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/51.DBA_COLL_TYPES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/51.DBA_COLL_TYPES.md deleted file mode 100644 index 40e00948d..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/51.DBA_COLL_TYPES.md +++ /dev/null @@ -1,46 +0,0 @@ -DBA_COLL_TYPES -=================================== - - - -功能 ------------ - -列出数据库中可用的用户自定义集合类型。其列与 ALL_COLL_TYPES 中的列相同。 - -相关视图 -------------- - -* ALL_COLL_TYPES - - - -* USER_COLL_TYPES - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------------|---------------|----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 对象所属的拥有者 | -| TYPE_NAME | VARCHAR2(64) | NO | 类型名 | -| COLL_TYPE | VARCHAR2(10) | NO | 集合类型: * VARYING * ARRAY * NESTED TABLE | -| UPPER_BOUND | NUMBER(38) | YES | 对于 VARYING,记录集合的最大大小 | -| ELEM_TYPE_MOD | VARCHAR2(7) | YES | 目前暂不支持该字段,当前该字段默认为NULL | -| ELEM_TYPE_OWNER | VARCHAR2(128) | YES | 集合元素类型的拥有者 | -| ELEM_TYPE_NAME | VARCHAR2(324) | YES | 集合元素类型名 | -| LENGTH | NUMBER(38) | YES | 集合元素类型长度 | -| NUMBER_PRECISION | NUMBER(38) | YES | 集合元素类型精度 | -| SCALE | NUMBER(38) | YES | 集合元素类型小数点右边数据的长度 | -| CHARACTER_SET_NAME | CHAR(7) | YES | 集合元素类型字符集 | -| ELEM_STORAGE | CHAR(3) | YES | 目前暂不支持该字段,当前该字段默认为NULL | -| NULLS_STORED | CHAR(1) | YES | 目前暂不支持该字段,当前该字段默认为NULL | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/52.DBA_COL_COMMENTS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/52.DBA_COL_COMMENTS.md deleted file mode 100644 index 4792446c3..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/52.DBA_COL_COMMENTS.md +++ /dev/null @@ -1,38 +0,0 @@ -DBA_COL_COMMENTS -===================================== - - - -功能 ------------ - -查看数据库中所有的视图和表的所有列注释。 - -相关视图 -------------- - -* ALL_COL_COMMENTS - - - -* USER_COL_COMMENTS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-------------|----------------|----------------|--------| -| OWNER | VARCHAR2(128) | NO | 对象的拥有者 | -| OBJECT_NAME | VARCHAR2(128) | NO | 对象名字 | -| COLUMN_NAME | VARCHAR2(128) | NO | 列名 | -| COMMENTS | VARCHAR2(4000) | YES | 列注释 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/53.DBA_COL_PRIVS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/53.DBA_COL_PRIVS.md deleted file mode 100644 index 4b982be68..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/53.DBA_COL_PRIVS.md +++ /dev/null @@ -1,36 +0,0 @@ -DBA_COL_PRIVS -================================== - - - -功能 ------------ - -描述数据库中的所有列对象授予。 - -相关视图 -------------- - -* USER_COL_PRIVS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-------------|---------------|----------------|---------------| -| GRANTEE | VARCHAR2(128) | NO | 被授予访问权限的用户的名称 | -| OWNER | VARCHAR2(128) | NO | 对象的所有者 | -| TABLE_NAME | VARCHAR2(256) | NO | 对象的名称 | -| COLUMN_NAME | VARCHAR2(128) | NO | 列的名称 | -| GRANTOR | VARCHAR2(128) | NO | 执行授权的用户的名称 | -| PRIVILEGE | VARCHAR2(40) | NO | 列上的权限 | -| GRANTABLE | VARCHAR2(3) | NO | 指示是否使用授予选项 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/54.DBA_CONSTRAINTS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/54.DBA_CONSTRAINTS.md deleted file mode 100644 index f599ff76d..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/54.DBA_CONSTRAINTS.md +++ /dev/null @@ -1,54 +0,0 @@ -DBA_CONSTRAINTS -==================================== - - - -功能 ------------ - -查看数据库中所有表的约束信息。 - -相关视图 -------------- - -* USER_CONSTRAINT - - - -* ALL_CONSTRAINT - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-------------------|----------------|----------------|--------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 约束的拥有者 | -| CONSTRAINT_NAME | VARCHAR2(128) | NO | 约束名字 | -| CONSTRAINT_TYPE | VARCHAR2(1) | NO | 索引类型,目前只支持 NORMAL类型 | -| TABLE_NAME | VARCHAR2(128) | NO | 约束所在的表的名字 | -| SEARCH_CONDITION | VARCHAR2(4000) | NO | check 约束 search condition 的文本 | -| R_OWNER | VARCHAR2(128) | NO | 被引用约束的拥有者 | -| R_CONSTRAINT_NAME | VARCHAR2(128) | NO | 被引用约束的名字 | -| DELETE_RULE | VARCHAR2(9) | NO | 外键约束的级联删除规则 | -| STATUS | VARCHAR2(8) | NO | 表示约束是 ENABLE 还是 DISABLE | -| DEFERRABLE | VARCHAR2(14) | NO | 表示约束是 DEFERRABLE 还是 NOT DEFERRABLE | -| DEFERRED | VARCHAR2(9) | NO | 表示约束是 DEFERRED 还是 IMMEDIATE | -| VALIDATED | VARCHAR2(13) | NO | 表示约束是 VALIDATED 还是 NOT VALIDATED | -| GENERATED | VARCHAR2(14) | NO | 表示约束的名字是 USER NAME 还是 GENERATED NAME | -| BAD | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| RELY | VARCHAR2(4) | NO | 表示约束是否是 RELY 状态 | -| LAST_CHANGE | DATE | NO | 约束上一次被改为 ENABLE 或者 DISABLE 的时间 | -| INDEX_OWNER | VARCHAR2(128) | NO | 约束上索引的拥有者 | -| INDEX_NAME | VARCHAR2(128) | NO | 约束上索引的名字 | -| INVALID | VARCHAR2(7) | NO | 表示约束是否是 INVALIDATE 状态 | -| VIEW_RELATED | VARCHAR2(14) | NO | 表示约束是否创建在视图上 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/55.DBA_CONS_COLUMNS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/55.DBA_CONS_COLUMNS.md deleted file mode 100644 index caa84c64d..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/55.DBA_CONS_COLUMNS.md +++ /dev/null @@ -1,39 +0,0 @@ -DBA_CONS_COLUMNS -===================================== - - - -功能 ------------ - -查看数据库中所有表的约束中的列信息。 - -相关视图 -------------- - -* USER_CONS_COLUMNS - - - -* ALL_CONS_COLUMNS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-----------------|----------------|----------------|----------| -| OWNER | VARCHAR2(128) | NO | 约束的拥有者 | -| CONSTRAINT_NAME | VARCHAR2(128) | NO | 约束名字 | -| TABLE_NAME | VARCHAR2(128) | NO | 约束所在表的表名 | -| COLUMN_NAME | VARCHAR2(4000) | NO | 约束中的列名 | -| POSITION | NUMBER | NO | 列在约束中的位置 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/56.DBA_ERRORS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/56.DBA_ERRORS.md deleted file mode 100644 index 083fed28b..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/56.DBA_ERRORS.md +++ /dev/null @@ -1,48 +0,0 @@ -DBA_ERRORS -=============================== - - -**说明** - - - -OceanBase 数据库暂未支持该视图。 - -功能 ------------ - -查看数据库中的当前存储对象的错误。 - -相关视图 -------------- - -* ALL_ERRORS - - - -* USER_ERRORS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------------|----------------|----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 对象的拥有者 | -| NAME | VARCHAR2(128) | NO | 对象的名称 | -| TYPE | VARCHAR2(19) | NO | 对象的类型: * VIEW * PROCEDUCE * FUNCTION * PACKAGE * PACKAGE_BODY * TRIGGER * TYPE * TYPE BODY * LIBRARY * JAVA SOURCE * JAVA CLASS * DIMENSION | -| SEQUENCE | NUMBER | NO | 同一次编译多个错误的错误编号(为排序) | -| LINE | NUMBER | NO | 错误发生的行号 | -| POSITION | NUMBER | NO | 错误发生的列号 | -| TEXT | VARCHAR2(4000) | NO | 错误信息文本 | -| ATTRIBUTE | VARCHAR2(9) | NO | 表明是 ERROR 还是 WARNING | -| MESSAGE_NUMBER | NUMBER | NO | 错误编码 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/57.DBA_INDEXES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/57.DBA_INDEXES.md deleted file mode 100644 index d3eabb722..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/57.DBA_INDEXES.md +++ /dev/null @@ -1,92 +0,0 @@ -DBA_INDEXES -================================ - - - -功能 ------------ - -DBA_INDEXES 用于查看数据库所有表的索引信息。 - -相关视图 -------------- - -* USER_INDEXES - - - -* ALL_INDEXES - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-------------------------|----------------|----------------|-------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 索引所属的拥有者。 | -| INDEX_NAME | VARCHAR2(128) | NO | 索引名字。 | -| INDEX_TYPE | VARCHAR2(27) | YES | 索引的类型。 | -| TABLE_OWNER | VARCHAR2(128) | NO | 被索引对象的拥有者。 | -| TABLE_NAME | VARCHAR2(128) | NO | 被索引对象的名字。 | -| TABLE_TYPE | CHAR(5) | YES | 被索引对象的类型。 | -| UNIQUENESS | VARCHAR2(9) | YES | 表示索引是否是唯一的(UNIQUE)或不唯一的。 | -| COMPRESSION | VARCHAR2(8) | YES | 表示索引是否是被压缩的。 | -| PREFIX_LENGTH | NUMBER | YES | 表示在压缩索引中的前缀列数量。目前暂不支持该字段,当前该字段默认为 NULL。 | -| TABLESPACE_NAME | VARCHAR2(30) | YES | 索引所在的表空间名。 | -| INI_TRANS | NUMBER | YES | 表示初始事务数量。目前暂不支持该字段,当前该字段默认为 NULL。 | -| MAX_TRANS | NUMBER | YES | 表示最大事务数量。目前暂不支持该字段,当前该字段默认为 NULL。 | -| INITIAL_EXTENT | NUMBER | YES | 表示初始 extent 大小。目前暂不支持该字段,当前该字段默认为 NULL。 | -| NEXT_EXTENT | NUMBER | YES | 表示第二 extent 大小。目前暂不支持该字段,当前该字段默认为 NULL。 | -| MIN_EXTENTS | NUMBER | YES | 表示在段里允许的最小 extent 数量。目前暂不支持该字段,当前该字段默认为 NULL。 | -| MAX_EXTENTS | NUMBER | YES | 表示在段里允许的最大 extent 数量。目前暂不支持该字段,当前该字段默认为 NULL。 | -| PCT_INCREASE | NUMBER | YES | 表示 extent 大小的增长率。目前暂不支持该字段,当前该字段默认为 NULL。 | -| PCT_THRESHOLD | NUMBER | YES | 表示每个索引被允许占用的块空间百分比。目前暂不支持该字段,当前该字段默认为 NULL。 | -| INCLUDE_COLUMN | NUMBER | YES | 表示索引组织表的主键的最后一列的列编号。目前暂不支持该字段,当前该字段默认为 NULL。 | -| FREELISTS | NUMBER | YES | 表示被分配个段的进程 freelist 数量。目前暂不支持该字段,当前该字段默认为 NULL。 | -| FREELIST_GROUPS | NUMBER | YES | 表示被分配个段的 freelist 组数量。目前暂不支持该字段,当前该字段默认为 NULL。 | -| PCT_FREE | NUMBER | YES | 表示块中空余空间的最小百分比。目前暂不支持该字段,当前该字段默认为 NULL。 | -| LOGGING | VARCHAR2(3) | YES | 表示对索引的修改是否被记录了日志。目前暂不支持该字段,当前该字段默认为 NULL。 | -| BLEVEL | NUMBER | YES | 表示 B\*-Tree 的深度。目前暂不支持该字段,当前该字段默认为 NULL。 | -| LEAF_BLOCKS | NUMBER | YES | 表示索引中叶子块的数量。目前暂不支持该字段,当前该字段默认为 NULL。 | -| DISTINCT_KEYS | NUMBER | YES | 表示不同索引值的数量。目前暂不支持该字段,当前该字段默认为 NULL。 | -| AVG_LEAF_BLOCKS_PER_KEY | NUMBER | YES | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| AVG_DATA_BLOCKS_PER_KEY | NUMBER | YES | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| CLUSTERING_FACTOR | NUMBER | YES | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| STATUS | VARCHAR2(10) | YES | 指示未分区的索引是 VALID 还是 UNUSABLE。 | -| NUM_ROWS | NUMBER | YES | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| SAMPLE_SIZE | NUMBER | YES | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| LAST_ANALYZED | DATE | YES | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| DEGREE | VARCHAR2(40) | YES | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| INSTANCES | VARCHAR2(40) | YES | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| PARTITIONED | VARCHAR2(3) | YES | 表示索引是否是分区索引。 | -| TEMPORARY | VARCHAR2(1) | YES | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| GENERATED | VARCHAR2(1) | YES | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| SECONDARY | VARCHAR2(1) | YES | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| BUFFER_POOL | VARCHAR2(7) | YES | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| FLASH_CACHE | VARCHAR2(7) | YES | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| CELL_FLASH_CACHE | VARCHAR2(7) | YES | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| USER_STATS | VARCHAR2(3) | YES | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| DURATION | VARCHAR2(15) | YES | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| PCT_DIRECT_ACCESS | NUMBER | YES | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| ITYP_OWNER | VARCHAR2(30) | YES | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| ITYP_NAME | VARCHAR2(30) | YES | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| PARAMETERS | VARCHAR2(1000) | YES | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| GLOBAL_STATS | VARCHAR2(3) | YES | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| DOMIDX_STATUS | VARCHAR2(12) | YES | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| DOMIDX_OPSTATUS | VARCHAR2(6) | YES | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| FUNCIDX_STATUS | VARCHAR2(8) | YES | 基于函数的索引的状态。 | -| JOIN_INDEX | VARCHAR2(3) | YES | 指示索引是否为联接索引。 | -| IOT_REDUNDANT_PKEY_ELIM | VARCHAR2(3) | YES | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| DROPPED | VARCHAR2(9) | YES | 表示索引是否被删除并进了回收站。 | -| VISIBILITY | VARCHAR2(10) | YES | 表示索引对优化器是否可见。 | -| DOMIDX_MANAGEMENT | VARCHAR2(14) | YES | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| SEGMENT_CREATED | VARCHAR2(3) | YES | 目前暂不支持该字段,当前该字段默认为 NULL。 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/58.DBA_IND_COLUMNS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/58.DBA_IND_COLUMNS.md deleted file mode 100644 index c201a9f3d..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/58.DBA_IND_COLUMNS.md +++ /dev/null @@ -1,43 +0,0 @@ -DBA_IND_COLUMNS -==================================== - - - -功能 ------------ - -查看数据库所有表的索引的索引列信息。 - -相关视图 -------------- - -* USER_IND_COLUMNS - - - -* ALL_IND_COLUMNS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-----------------|----------------|----------------|------------------------------| -| INDEX_OWNER | VARCHAR2(128) | NO | 索引所属的拥有者 | -| INDEX_NAME | VARCHAR2(128) | NO | 索引名字 | -| TABLE_OWNER | VARCHAR2(128) | NO | 索引所在的表的拥有者 | -| TABLE_NAME | VARCHAR2(128) | NO | 索引所在的表的名字 | -| COLUMN_NAME | VARCHAR2(4000) | NO | 索引列的名字 | -| COLUMN_POSITION | NUMBER | NO | 索引列在索引中的位置 | -| COLUMN_LENGTH | NUMBER | NO | 索引列的长度 | -| CHAR_LENGTH | NUMBER | NO | 索引列的字符长度 | -| DESCEND | VARCHAR2(4) | NO | 表示索引列是按降序(DESC)排列还是升序(ASC)排列 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/59.DBA_IND_EXPRESSIONS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/59.DBA_IND_EXPRESSIONS.md deleted file mode 100644 index da0f01a6e..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/59.DBA_IND_EXPRESSIONS.md +++ /dev/null @@ -1,40 +0,0 @@ -DBA_IND_EXPRESSIONS -======================================== - - - -功能 ------------ - -查看数据库中所有 function-based 索引的信息。 - -相关视图 -------------- - -* ALL_IND_EXPRESSIONS - - - -* USER_IND_EXPRESSIONS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-------------------|----------------|----------------|----------------------| -| INDEX_OWNER | VARCHAR2(128) | NO | 索引所属的拥有者 | -| INDEX_NAME | VARCHAR2(128) | NO | 索引名字 | -| TABLE_OWNER | VARCHAR2(128) | NO | 索引所在表的拥有者 | -| TABLE_NAME | VARCHAR2(128) | NO | 索引所在表的名字 | -| COLUMN_EXPRESSION | VARCHAR2(1000) | NO | function-base 索引的表达式 | -| COLUMN_POSITION | NUMBER(38) | NO | 列所在索引的位置 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/6.ALL_CONSTRAINTS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/6.ALL_CONSTRAINTS.md deleted file mode 100644 index 6c061325a..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/6.ALL_CONSTRAINTS.md +++ /dev/null @@ -1,54 +0,0 @@ -ALL_CONSTRAINTS -==================================== - - - -功能 ------------ - -查看用户可访问的所有表的约束信息。 - -相关视图 -------------- - -* USER_CONSTRAINT - - - -* DBA_CONSTRAINT - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-------------------|----------------|----------------|--------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 约束的拥有者 | -| CONSTRAINT_NAME | VARCHAR2(128) | NO | 约束名字 | -| CONSTRAINT_TYPE | VARCHAR2(1) | NO | 索引类型,目前只支持 NORMAL 类型 | -| TABLE_NAME | VARCHAR2(128) | NO | 约束所在的表的名字 | -| SEARCH_CONDITION | VARCHAR2(4000) | NO | check 约束 search condition 的文本 | -| R_OWNER | VARCHAR2(128) | NO | 被引用约束的拥有者 | -| R_CONSTRAINT_NAME | VARCHAR2(128) | NO | 被引用约束的名字 | -| DELETE_RULE | VARCHAR2(9) | NO | 外键约束的级联删除规则 | -| STATUS | VARCHAR2(8) | NO | 表示约束是 ENABLE 还是 DISABLE | -| DEFERRABLE | VARCHAR2(14) | NO | 表示约束是 DEFERRABLE 还是NOT DEFERRABLE | -| DEFERRED | VARCHAR2(9) | NO | 表示约束是 DEFERRED 还是 IMMEDIATE | -| VALIDATED | VARCHAR2(13) | NO | 表示约束是 VALIDATED 还是 NOT VALIDATED | -| GENERATED | VARCHAR2(14) | NO | 表示约束的名字是 USER NAME 还是 GENERATED NAME | -| BAD | VARCHAR2(3) | NO | 目前暂不支持这个字段,当前该字段默认为 NULL | -| RELY | VARCHAR2(4) | NO | 表示约束是否是 RELY 状态 | -| LAST_CHANGE | DATE | NO | 约束上一次被改为 ENABLE 或者 DISABLE 的时间 | -| INDEX_OWNER | VARCHAR2(128) | NO | 约束上索引的拥有者 | -| INDEX_NAME | VARCHAR2(128) | NO | 约束上索引的名字 | -| INVALID | VARCHAR2(7) | NO | 表示约束是否是 INVALIDATE 状态 | -| VIEW_RELATED | VARCHAR2(14) | NO | 表示约束是否建在视图上 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/60.DBA_IND_PARTITIONS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/60.DBA_IND_PARTITIONS.md deleted file mode 100644 index 380a3f35b..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/60.DBA_IND_PARTITIONS.md +++ /dev/null @@ -1,76 +0,0 @@ -DBA_IND_PARTITIONS -======================================= - - - -功能 ------------ - -查看数据库中所有索引分区的信息。 - -相关视图 -------------- - -* ALL_IND_PARTITIONS - - - -* USER_IND_PARTITIONS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|---------------------------|----------------|----------------|---------------------------------------------------------------------------------------------------------------------------------------------------| -| INDEX_OWNER | VARCHAR2(128) | NO | 索引所属的拥有者 | -| INDEX_NAME | VARCHAR2(128) | NO | 索引名字 | -| COMPOSITE | VARCHAR2(3) | NO | 表示分区是否属于 composited-partition 表的本地索引(YSE) 或者(NO) | -| PARTITION_NAME | VARCHAR2(128) | NO | 索引名称 | -| SUBPARTITION_COUNT | NUMBER(38) | YES | 子分区个数 | -| HIGH_VALUE | VARCHAR2(1024) | NO | 分区绑定 Value 的表达式 | -| HIGH_VALUE_LENGTH | NUMBER | NO | 分区绑定 Value 表达式的长度 | -| PARTITION_POSITION | NUMBER | NO | 分区在索引中的位置 | -| STATUS | VARCHAR2(8) | NO | 指示索引分区是否可用 | -| TABLESPACE_NAME | VARCHAR2(30) | NO | 包含分区的表空间的名称 | -| PCT_FREE | NUMBER | NO | 块中最小可用空间百分比。目前暂不支持该字段,当前该字段默认为 NULL | -| INI_TRANS | NUMBER | NO | 初始交易数。目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_TRANS | NUMBER | NO | 最大交易数。目前暂不支持该字段,当前该字段默认为 NULL | -| INITIAL_EXTENT | NUMBER | NO | 初始范围的大小,单位:字节。目前暂不支持该字段,当前该字段默认为 NULL | -| NEXT_EXTENT | NUMBER | NO | 辅助扩展区的大小,单位:字节。目前暂不支持该字段,当前该字段默认为 NULL | -| MIN_EXTENT | NUMBER | NO | 段中允许的最小范围数。目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_EXTENT | NUMBER | NO | 段中允许的最大扩展数。目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_SIZE | NUMBER | NO | 段中允许的最大块数。目前暂不支持该字段,当前该字段默认为 NULL | -| PCT_INCREASE | NUMBER | NO | 范围大小的百分比增加。目前暂不支持该字段,当前该字段默认为 NULL | -| FREELISTS | NUMBER | NO | 在此段中分配的进程空闲列表数。目前暂不支持该字段,当前该字段默认为 NULL | -| FREELIST_GROUPS | NUMBER | NO | 在此段中分配的进程自由列表组数。目前暂不支持该字段,当前该字段默认为 NULL | -| LOGGING | VARCHAR2(7) | NO | 指示是否记录对索引的更改。目前暂不支持该字段,当前该字段默认为 NULL | -| COMPRESSION | VARCHAR2(8) | NO | 表示分区索引是否开启压缩: * 开启(ENABLE) * 未开启(DISABLE) | -| BLEVEL | NUMBER | NO | B\*- 树级别(从根块到叶块的索引深度)。深度为 0 表示根块和叶块相同。目前暂不支持该字段,当前该字段默认为 NULL | -| LEAF_BLOCKS | NUMBER | NO | 索引分区中的叶块数。目前暂不支持该字段,当前该字段默认为 NULL | -| DISTINCT_KEYS | NUMBER | NO | 索引分区中不同键的数量。目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_LEAF_BLOCKS_PER_KEY | NUMBER | NO | 出现索引中每个不同值的叶块的平均数目,四舍五入到最接近的整数。对于强制执行 UNIQUE 和 PRIMARY KEY 约束的索引,此值始终为 1。目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_DATA_BLOCKS_PER_KEY | NUMBER | NO | 表中由索引中不同值四舍五入到最接近的整数所指向的平均数据块数。此统计数据是包含行的数据块的平均数量,这些行包含给定索引列的给定值。目前暂不支持该字段,当前该字段默认为 NULL | -| CLUSTERING_FACTOR | NUMBER | NO | 指示基于索引值的表中行的数量。目前暂不支持该字段,当前该字段默认为 NULL | -| NUM_ROWS | NUMBER | NO | ANALYZE 语句返回的行数。目前暂不支持该字段,当前该字段默认为 NULL | -| SAMPLE_SIZE | NUMBER | NO | 分析此分区时使用的样本量。目前暂不支持该字段,当前该字段默认为 NULL | -| LAST_ANALYZED | DATE | NO | 最近对该分区进行分析的日期。目前暂不支持该字段,当前该字段默认为 NULL | -| BUFFER_POOL | VARCHAR2(7) | NO | 分区的实际缓冲池。目前暂不支持该字段,当前该字段默认为 NULL | -| FLASH_CACHE | VARCHAR2(7) | NO | 用于分区块的数据库智能闪存缓存提示。目前暂不支持该字段,当前该字段默认为 NULL | -| CELL_FLASH_CACHE | VARCHAR2(7) | NO | 单元闪存缓存提示用于分区块。目前暂不支持该字段,当前该字段默认为 NULL | -| USER_STATS | VARCHAR2(3) | NO | 指示是否由用户直接输入统计信息。目前暂不支持该字段,当前该字段默认为 NULL | -| PCT_DIRECT_ACCESS | NUMBER | NO | 如果在索引组织表上有二级索引,则用 VALID 猜测的行百分比。目前暂不支持该字段,当前该字段默认为 NULL | -| GLOBAL_STATS | VARCHAR2(3) | NO | 指示是针对整个分区收集分区的统计信息,还是根据基础子分区的统计信息进行估计。目前暂不支持该字段,当前该字段默认为 NULL | -| DOMIDX_OPSTATUS | VARCHAR2(6) | NO | 与索引上的操作状态。目前暂不支持该字段,当前该字段默认为 NULL | -| PARAMETERS | VARCHAR2(1000) | NO | 对于域索引,参数字符串。目前暂不支持该字段,当前该字段默认为 NULL | -| INTERVAL | VARCHAR2(3) | NO | 指示分区是否在间隔分区表的间隔部分中或分区是否在范围部分中。目前暂不支持该字段,当前该字段默认为 NULL | -| SEGMENT_CREATED | VARCHAR2(3) | NO | 指示是否已创建索引分区段。 N/A 表示该索引已细分,并且分区级别不存在任何段。目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/61.DBA_IND_SUBPARTITIONS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/61.DBA_IND_SUBPARTITIONS.md deleted file mode 100644 index e253b242e..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/61.DBA_IND_SUBPARTITIONS.md +++ /dev/null @@ -1,75 +0,0 @@ -DBA_IND_SUBPARTITIONS -========================================== - - - -功能 ------------ - -查看数据库中所有索引子分区的信息。 - -相关视图 -------------- - -* ALL_IND_SUBPARTITIONS - - - -* USER_IND_SUBPARTITIONS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|---------------------------|----------------|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| INDEX_OWNER | VARCHAR2(128) | NO | 索引所属的拥有者 | -| INDEX_NAME | VARCHAR2(128) | NO | 索引名字 | -| PARTITION_NAME | VARCHAR2(128) | NO | 分区名字 | -| SUBPARTITION_NAME | VARCHAR2(128) | NO | 子分区名字 | -| HIGH_VALUE | VARCHAR2(1024) | NO | 子分区绑定 Value 的表达式 | -| HIGH_VALUE_LENGTH | NUMBER | NO | 子分区绑定 Value 表达式的长度 | -| SUBPARTITION_POSITION | NUMBER | NO | 子分区在分区的位置 | -| STATUS | VARCHAR2(8) | NO | 指示索引分区是否可用 | -| TABLESPACE_NAME | VARCHAR2(30) | NO | 包含分区的表空间的名称 | -| PCT_FREE | NUMBER | NO | 块中最小可用空间百分比。目前暂不支持该字段,当前该字段默认为 NULL | -| INI_TRANS | NUMBER | NO | 初始交易数。目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_TRANS | NUMBER | NO | 最大交易数。目前暂不支持该字段,当前该字段默认为 NULL | -| INITIAL_EXTENT | NUMBER | NO | 初始范围的大小,单位:字节。目前暂不支持该字段,当前该字段默认为 NULL | -| NEXT_EXTENT | NUMBER | NO | 辅助扩展区的大小,单位:字节。目前暂不支持该字段,当前该字段默认为 NULL | -| MIN_EXTENT | NUMBER | NO | 段中允许的最小范围数。目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_EXTENT | NUMBER | NO | 段中允许的最大扩展数。目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_SIZE | NUMBER | NO | 段中允许的最大块数。目前暂不支持该字段,当前该字段默认为 NULL | -| PCT_INCREASE | NUMBER | NO | 范围大小的百分比增加。目前暂不支持该字段,当前该字段默认为 NULL | -| FREELISTS | NUMBER | NO | 在此段中分配的进程空闲列表数。目前暂不支持该字段,当前该字段默认为 NULL | -| FREELIST_GROUPS | NUMBER | NO | 在此段中分配的进程自由列表组数。目前暂不支持该字段,当前该字段默认为 NULL | -| LOGGING | VARCHAR2(7) | NO | 指示是否记录对索引的更改。目前暂不支持该字段,当前该字段默认为 NULL | -| COMPRESSION | VARCHAR2(8) | NO | 表示分区索引是否开启压缩: * 开启(ENABLE) * 未开启(DISABLE) | -| BLEVEL | NUMBER | NO | B 树级别(从根块到叶块的索引深度)。深度为 0 表示根块和叶块相同。目前暂不支持该字段,当前该字段默认为 NULL | -| LEAF_BLOCKS | NUMBER | NO | 索引中的叶块数。目前暂不支持该字段,当前该字段默认为 NULL | -| DISTINCT_KEYS | NUMBER | NO | 索引分区中不同键的数量。目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_LEAF_BLOCKS_PER_KEY | NUMBER | NO | 出现索引中每个不同值的叶块的平均数目,四舍五入到最接近的整数。对于强制执行 UNIQUE 和 PRIMARY KEY 约束的索引,此值始终为 1。目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_DATA_BLOCKS_PER_KEY | NUMBER | NO | 表中由索引中不同值四舍五入到最接近的整数所指向的平均数据块数。此统计数据是包含行的数据块的平均数量,这些行包含给定索引列的给定值。目前暂不支持该字段,当前该字段默认为 NULL | -| CLUSTERING_FACTOR | NUMBER | NO | 指示基于索引值的表中行的数量。目前暂不支持该字段,当前该字段默认为 NULL | -| NUM_ROWS | NUMBER | NO | 此索引子分区中的行数。目前暂不支持该字段,当前该字段默认为 NULL | -| SAMPLE_SIZE | NUMBER | NO | 分析此子分区时使用的样本量。目前暂不支持该字段,当前该字段默认为 NULL | -| LAST_ANALYZED | DATE | NO | 最近对该分区进行分析的日期。目前暂不支持该字段,当前该字段默认为 NULL | -| BUFFER_POOL | VARCHAR2(7) | NO | 子分区的默认缓冲池。目前暂不支持该字段,当前该字段默认为 NULL | -| FLASH_CACHE | VARCHAR2(7) | NO | 用于子分区块的数据库智能闪存缓存提示。目前暂不支持该字段,当前该字段默认为 NULL | -| CELL_FLASH_CACHE | VARCHAR2(7) | NO | 单元闪存缓存提示将用于子分区块。目前暂不支持该字段,当前该字段默认为 NULL | -| USER_STATS | VARCHAR2(3) | NO | 指示是否由用户直接输入统计信息。目前暂不支持该字段,当前该字段默认为 NULL | -| PCT_DIRECT_ACCESS | NUMBER | NO | 如果索引组织表上的二级索引,则具有有效猜测的行的百分比。目前暂不支持该字段,当前该字段默认为 NULL | -| GLOBAL_STATS | VARCHAR2(3) | NO | * 如果已收集统计信息,则GLOBAL_STATS 将为 YES * 如果未收集统计信息,则GLOBAL_STATS 将为 NO 目前暂不支持该字段,当前该字段默认为 NULL | -| DOMIDX_OPSTATUS | VARCHAR2(6) | VARCHAR2(6) | 域索引上的操作状态。目前暂不支持该字段,当前该字段默认为 NULL | -| PARAMETERS | VARCHAR2(1000) | VARCHAR2(1000) | 对于域索引,参数字符串。目前暂不支持该字段,当前该字段默认为 NULL | -| INTERVAL | VARCHAR2(3) | NO | 指示分区是否在间隔分区表的间隔部分中(是)或分区是否在范围部分中(否)。目前暂不支持该字段,当前该字段默认为 NULL | -| SEGMENT_CREATED | VARCHAR2(3) | NO | 指示是否已创建索引子分区段。N/A 表示该索引未分区。目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/62.DBA_METHOD_PARAMS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/62.DBA_METHOD_PARAMS.md deleted file mode 100644 index a507044f7..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/62.DBA_METHOD_PARAMS.md +++ /dev/null @@ -1,49 +0,0 @@ -DBA_METHOD_PARAMS -====================================== - - -**说明** - - - -OceanBase 数据库暂未支持该视图。 - -功能 ------------ - -查看数据库中的对象类型的方法参数。 - -相关视图 -------------- - -* ALL_METHOD_PARAMS - - - -* USER_METHOD_PARAMS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------------|--------------|----------------|-------------------------------------------------------------| -| OWNER | VARCHAR2(30) | NO | 类型的拥有者 | -| TYPE_NAME | VARCHAR2(30) | NO | 类型名称 | -| METHOD_NAME | VARCHAR2(30) | NO | 方法名称 | -| METHOD_NO | NUMBER | NO | 对于重载的方法,这个编号区分另一个名字相同的方法。不要将这个和对象id混淆。 | -| PARAM_NAME | VARCHAR2(30) | NO | 参数的名称 | -| PARAM_NO | NUMBER | NO | 参数编号(正数) | -| PARAM_MODE | VARCHAR2(6) | NO | 参数模式(IN, OUT, IN OUT) | -| PARAM_TYPE_MOD | VARCHAR2(7) | NO | 参数是否引用其他的对象 | -| PARAM_TYPE_OWNER | VARCHAR2(30) | NO | 参数类型的拥有者 | -| PARAM_TYPE_NAME | VARCHAR2(30) | NO | 参数类型的名称 | -| CHARACTER_SET_NAME | VARCHAR2(44) | NO | 方法的字符集是鼎昌的字符集(CHAR_CS)或者是鼎昌的自然字符集(NCHAR_CS),或者用户特殊指定的一个字符集。 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/63.DBA_OBJECTS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/63.DBA_OBJECTS.md deleted file mode 100644 index 6b4ca5040..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/63.DBA_OBJECTS.md +++ /dev/null @@ -1,48 +0,0 @@ -DBA_OBJECTS -================================ - - - -功能 ------------ - -查看数据库所有数据库对象,视图定义与 ALL_OBJECTS 一致。 - -相关视图 -------------- - -* ALL_OBJECTS - - - -* USER_OBJECTS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------------|---------------|----------------|---------------------------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 对象所属的拥有者 | -| OBJECT_NAME | VARCHAR2(128) | NO | 对象名字 | -| SUBOBJECT_NAME | VARCHAR2(128) | NO | 子对象名字(例如,partition) | -| OBJECT_ID | NUMBER(38) | NO | 对象的字典 ID 值 | -| DATA_OBJECT_ID | NUMBER | NO | 包含该对象 Segment 的字典 ID值 | -| OBJECT_TYPE | VARCHAR2(23) | NO | 对象类型,包括表、索引、分区、包、存储过程、同义词、序列等 | -| CREATED | DATE | NO | 对象创建时间 | -| LAST_DDL_TIME | DATE | NO | 对象最后一次 DDL 时间 | -| TIMESTAMP | VARCHAR2(256) | NO | 对象指定的时间戳,以字符形式输出 | -| STATUS | VARCHAR2(7) | NO | 对象状态: * VALID * INVALID | -| TEMPORARY | VARCHAR2(1) | NO | 表示该对象是一个临时对象 | -| GENERATED | VARCHAR2(1) | NO | 表示该对象的名字是否是由系统生成 | -| SECONDARY | VARCHAR2(1) | NO | 目前该字段暂未使用 | -| NAMESPACE | NUMBER | NO | 对象的命名空间 | -| EDITION_NAME | VARCHAR2(128) | NO | 保留字段 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/64.DBA_OBJ_AUDIT_OPTS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/64.DBA_OBJ_AUDIT_OPTS.md deleted file mode 100644 index 0ab15f0e9..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/64.DBA_OBJ_AUDIT_OPTS.md +++ /dev/null @@ -1,44 +0,0 @@ -DBA_OBJ_AUDIT_OPTS -======================================= - - - -功能 ------------ - -记录对象级别审计详细配置。 - -相关视图 -------------- - -ALL_DEF_AUDIT_OPTS - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-------------|---------------|----------------|-----------------------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 对象的 owner 名称 | -| OBJECT_NAME | VARCHAR2(128) | NO | 对象的名称 | -| OBJECT_TYPE | VARCHAR2(23) | NO | 对象的类型 | -| ALT | VARCHAR2(3) | NO | alter 操作 | -| AUD | VARCHAR2(3) | NO | audit 操作 | -| COM | VARCHAR2(3) | NO | comment 操作 | -| DEL | VARCHAR2(3) | NO | delete 操作 | -| GRA | VARCHAR2(3) | NO | grant 操作 | -| IND | VARCHAR2(3) | NO | index 操作 | -| INS | VARCHAR2(3) | NO | insert 操作 | -| LOC | VARCHAR2(3) | NO | lock 操作 | -| REN | VARCHAR2(3) | NO | rename 操作 | -| SEL | VARCHAR2(3) | NO | select 操作 | -| UPD | VARCHAR2(3) | NO | update 操作 | -| REF | VARCHAR2(3) | NO | refrences 操作 **说明** 该字段已不再使用。 | -| EXE | VARCHAR2(3) | NO | execute 操作 | -| WRI | VARCHAR2(3) | NO | write 操作 | -| REA | VARCHAR2(3) | NO | read 操作 | -| FBK | VARCHAR2(3) | NO | flashback 操作 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/65.DBA_PART_INDEXES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/65.DBA_PART_INDEXES.md deleted file mode 100644 index 17c3266f3..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/65.DBA_PART_INDEXES.md +++ /dev/null @@ -1,63 +0,0 @@ -DBA_PART_INDEXES -===================================== - - - -功能 ------------ - -查看所有的分区索引的分区信息。 - -相关视图 -------------- - -* DBA_PART_INDEXES - - - -* USER_PART_INDEXES - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|---------------------------|----------------|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 分区索引所有者 | -| INDEX_NAME | VARCHAR2(128) | NO | 分区索引的名字 | -| TABLE_NAME | VARCHAR2(128) | NO | 索引关联的表的名字 | -| PARTITIONING_TYPE | VARCHAR2(9) | NO | 分区方式: * HASH * RANGE * LIST | -| SUBPARTITIONING_TYPE | VARCHAR2(9) | NO | 子分区的分区方式: * HASH * RANGE * LIST | -| PARTITION_COUNT | NUMBER | NO | 索引中分区个数 | -| DEF_SUBPARTITION_COUNT | NUMBER | NO | 对于复合分区索引,默认为子分区的分区个数(如果指定) | -| PARTITIONING_KEY_COUNT | NUMBER | NO | 分区键中列的个数 | -| SUBPARTITIONING_KEY_COUNT | NUMBER | NO | 对于复合分区索引,子分区分区键个数 | -| LOCALITY | VARCHAR2(6) | NO | 分区索引是局部(LOCAL) 还是全局 (GLOBAL) | -| ALIGNMENT | VARCHAR2(12) | NO | 分区索引是前缀(PREFIXED)还是非前缀 (NON_PREFIXED) | -| DEF_TABLESPACE_NAME | VARCHAR2(30) | NO | 对于局部索引, 添加或分割表分区时默认的表空间 | -| DEF_PCT_FREE | NUMBER | NO | 对于局部索引, 添加表分区时默认 PCTFREE 值 | -| DEF_INI_TRANS | NUMBER | NO | 对于局部索引,添加表分区时默认 INITRANS 值 | -| DEF_MAX_TRANS | NUMBER | NO | 对于局部索引,添加表分区时默认 MAXTRANS 的值 | -| DEF_INITIAL_EXTENT | VARCHAR2(40) | NO | 对于局部索引,添加表分区时默认 INITIAL 值。如果未指定,值为 DEFAULT | -| DEF_NEXT_EXTENT | VARCHAR2(40) | NO | 对于局部索引,添加表分区时默认 NEXT 值;如果未指定,值为 DEFAULT | -| DEF_MIN_EXTENTS | VARCHAR2(40) | NO | 对于局部索引,添加表分区时默认 MINEXTENTS 值。如果未指定,值为 DEFAULT | -| DEF_MAX_EXTENTS | VARCHAR2(40) | NO | 对于局部索引,添加表分区时默认 MAXEXTENTS 值。如果未指定,值为 DEFAULT | -| DEF_MAX_SIZE | VARCHAR2(40) | NO | 对于局部索引,添加表分区时默认 MAXSIZE 值;如果未指定,值为 DEFAULT | -| DEF_PCT_INCREASE | VARCHAR2(40) | NO | 对于局部索引,添加表分区时默认 PCTINCREASE 值;如果未指定,值为 DEFAULT | -| DEF_FREELISTS | NUMBER | NO | 对于局部索引,添加表分区时默认 FREELISTS 的值 | -| DEF_FREELIST_GROUPS | NUMBER | NO | 对于局部索引,添加表分区时默认 FREELIST GROUPS 的值 | -| DEF_LOGGING | VARCHAR2(7) | NO | 对于局部索引,添加表分区时默认 LOGGING 参数。目前该字段暂未使用,当前该字段默认为 NULL | -| DEF_BUFFER_POOL | VARCHAR2(7) | NO | 对于局部索引,添加表分区时默认 buffer pool 。目前该字段暂未使用,当前该字段默认为 NULL | -| DEF_FLASH_CACHE | VARCHAR2(7) | NO | 对于局部索引,添加表分区时默认 Database Smart Flash Cache hint。目前该字段暂未使用,当前该字段默认为 NULL | -| DEF_CELL_FLASH_CACHE | VARCHAR2(7) | NO | 对于局部索引, 添加表分区时默认 cell flash cache hint。目前该字段暂未使用,当前该字段默认为 NULL | -| DEF_PARAMETERS | VARCHAR2(1000) | NO | 域索引的默认参数串 | -| INTERVAL | VARCHAR2(1000) | NO | 定义区间划分的字符串 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/66.DBA_PART_KEY_COLUMNS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/66.DBA_PART_KEY_COLUMNS.md deleted file mode 100644 index f8e6bfb62..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/66.DBA_PART_KEY_COLUMNS.md +++ /dev/null @@ -1,40 +0,0 @@ -DBA_PART_KEY_COLUMNS -========================================= - - - -功能 ------------ - -查看数据库中所有分区对象中分区键包含的列。 - -相关视图 -------------- - -* ALL_PART_KEY_COLUMNS - - - -* USER_PART_KEY_COLUMNS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------------|----------------|----------------|----------------------------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 分区表或分区索引的拥有者 | -| NAME | VARCHAR2(128) | NO | 分区表或分区索引的名字 | -| OBJECT_TYPE | CHAR(5) | NO | 分区对象的类型: * TABLE * INDEX | -| COLUMN_NAME | VARCHAR2(4000) | NO | 列的名字 | -| COLUMN_POSITION | NUMBER | NO | 列在分区键中的位置 | -| COLLATED_COLUMN_ID | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/67.DBA_PART_TABLES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/67.DBA_PART_TABLES.md deleted file mode 100644 index 4041bc340..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/67.DBA_PART_TABLES.md +++ /dev/null @@ -1,66 +0,0 @@ -DBA_PART_TABLES -==================================== - - - -功能 ------------ - -查看当前用户可访问的分区表的分区信息。 - -相关视图 -------------- - -* ALL_PART_TABLES:查看所有的分区表的分区信息 - - - -* USER_PART_TABLES:查看属于当前用户的分区表的分区信息 - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|---------------------------|----------------|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 分区表的拥有者 | -| TABLE_NAME | VARCHAR2(128) | NO | 分区表的名字 | -| PARTITIONING_TYPE | VARCHAR2(9) | NO | 分区方式: * HASH * RANGE * LIST | -| SUBPARTITIONING_TYPE | VARCHAR2(9) | NO | 子分区的分区方式: * HASH * RANGE * LIST | -| PARTITION_COUNT | NUMBER | NO | 分区表中分区个数 | -| DEF_SUBPARTITION_COUNT | NUMBER | NO | 对于复合分区表,表示子分区的个数 | -| PARTITIONING_KEY_COUNT | NUMBER | NO | 分区键的数量 | -| SUBPARTITIONING_KEY_COUNT | NUMBER | NO | 对于复合分区表,表示子分区键的数量 | -| STATUS | VARCHAR2(8) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_TABLESPACE_NAME | VARCHAR2(30) | NO | 分区表所属的表空间名 | -| DEF_PCT_FREE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_PCT_USED | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_INI_TRANS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_MAX_TRANS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_INITIAL_EXTENT | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_NEXT_EXTENT | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_MIN_EXTENT | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_EXTENT | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_MAX_SIZE | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_PCT_INCREASE | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_FREELISTS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_FREELIST_GROUPS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_LOGGING | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| COMPRESSION | VARCHAR2(8) | NO | 是否开启压缩 | -| COMPRESS_FOR | VARCHAR2(12) | NO | 压缩方法 | -| DEF_BUFFER_POOL | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_CELL_FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| REF_PTN_CONSTRAINT_NAME | VARCHAR2(30) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INTERVAL | VARCHAR2(1000) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| IS_NESTED | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_SEGMENT_CREATED | VARCHAR2(4) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/68.DBA_PROCEDURES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/68.DBA_PROCEDURES.md deleted file mode 100644 index 0a8fc230a..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/68.DBA_PROCEDURES.md +++ /dev/null @@ -1,50 +0,0 @@ -DBA_PROCEDURES -=================================== - - - -功能 ------------ - -列出数据库中可用的过程和函数。 - -相关视图 -------------- - -* ALL_PROCEDURES - - - -* USER_PROCEDURES - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------------|---------------|----------------|-------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 对象所属的拥有者 | -| OBJECT_NAME | VARCHAR2(128) | YES | 包名 | -| PROCEDURE_NAME | VARCHAR2(128) | NO | 过程或者函数名 | -| OBJECT_ID | NUMBER | NO | 对象 ID | -| SUBPROGRAM_ID | NUMBER | NO | 出现在包中的顺序, 对于独立的过程或者函数该值为 1 | -| OVERLOAD | NUMBER | NO | 出现在包源文件中的第几次重载 | -| OBJECT_TYPE | VARCHAR2(9) | NO | 对象的类型 | -| AGGREGATE | VARCHAR2(3) | NO | 表示该过程是否为聚合函数。目前暂不支持该字段,当前该字段默认为 NO | -| PIPELINED | VARCHAR2(3) | NO | 表示该过程是否为管道表函数 | -| IMPLTYPEOWNER | VARCHAR2(30) | NO | 实现类型所有者的名称。目前暂不支持该字段,当前该字段默认为 NULL | -| IMPLTYPENAME | VARCHAR2(30) | NO | 实现类型的名称。目前暂不支持该字段,当前该字段默认为 NULL | -| PARALLEL | VARCHAR2(3) | NO | 指示过程或功能是否是并行启用的 | -| INTERFACE | VARCHAR2(3) | NO | 过程/函数是使用 ODCI 接口实现的表函数。目前暂不支持该字段,当前该字段默认为 NULL | -| DETERMINISTIC | VARCHAR2(3) | NO | 该过程或功能被声明为确定性的 | -| AUTHID | VARCHAR2(12) | NO | * INVOKER * DEFINER | -| ORIGIN_CON_ID | NUMBER(38) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/69.DBA_PROFILES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/69.DBA_PROFILES.md deleted file mode 100644 index 92f5c13c7..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/69.DBA_PROFILES.md +++ /dev/null @@ -1,38 +0,0 @@ -DBA_PROFILES -================================= - - - -功能 ------------ - -查看所有的简介和这些简介的限制。 - -相关视图 -------------- - -* ALL_PROFILES - - - -* USER_PROFILES - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|---------------|--------------|----------------|----------------------------------| -| PROFILE | VARCHAR2(30) | NO | 简介的名称 | -| RESOURCE_NAME | VARCHAR2(32) | NO | 资源的名称 | -| RESOURCE_TYPE | VARCHAR2(8) | NO | 表明一个资源的简介是一个KERNEL 还是一个 PASSWORD | -| LIMIT | VARCHAR2(40) | NO | 简介资源的限制 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/7.ALL_CONS_COLUMNS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/7.ALL_CONS_COLUMNS.md deleted file mode 100644 index 80c02e9b1..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/7.ALL_CONS_COLUMNS.md +++ /dev/null @@ -1,39 +0,0 @@ -ALL_CONS_COLUMNS -===================================== - - - -功能 ------------ - -查看用户可访问的所有表的约束中的列信息。 - -相关视图 -------------- - -* USER_CONS_COLUMNS - - - -* DBA_CONS_COLUMNS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-----------------|----------------|----------------|----------| -| OWNER | VARCHAR2(128) | NO | 约束的拥有者 | -| CONSTRAINT_NAME | VARCHAR2(128) | NO | 约束名字 | -| TABLE_NAME | VARCHAR2(128) | NO | 约束所在表的表名 | -| COLUMN_NAME | VARCHAR2(4000) | NO | 约束中的列名 | -| POSITION | NUMBER | NO | 列在约束中的位置 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/70.DBA_ROLES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/70.DBA_ROLES.md deleted file mode 100644 index 420f5b59e..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/70.DBA_ROLES.md +++ /dev/null @@ -1,23 +0,0 @@ -DBA_ROLES -============================== - - - -功能 ------------ - -DBA_ROLES 列出数据库中存在的所有角色。 - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|---------------------|--------------|----------------|------------------------------------| -| ROLE | VARCHAR2(30) | NO | 角色名称 | -| PASSWORD_REQUIRED | VARCHAR2(8) | NO | 指示角色是否需要启用密码。目前支持角色密码功能,但该字段不能正确显示 | -| AUTHENTICATION_TYPE | VARCHAR2(11) | NO | 指示角色的身份验证机制。目前暂不支持该字段。 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/71.DBA_ROLE_PRIVS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/71.DBA_ROLE_PRIVS.md deleted file mode 100644 index cf3e8ff8f..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/71.DBA_ROLE_PRIVS.md +++ /dev/null @@ -1,29 +0,0 @@ -DBA_ROLE_PRIVS -=================================== - - - -功能 ------------ - -描述授予所有用户的角色和数据库中的角色。 - -相关视图 -------------- - -USER_ROLE_PRIVS - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------|--------------|----------------|-------------------| -| GRANTEE | VARCHAR2(30) | NO | 接收授予的用户或角色的名称 | -| GRANTED_ROLE | VARCHAR2(30) | NO | 授予角色名 | -| ADMIN_OPTION | VARCHAR2(3) | NO | 指示授权是否带有 ADMIN 选项 | -| DEFAULT_ROLE | VARCHAR2(3) | NO | 指示角色是否被指定为用户的默认角色 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/72.DBA_SCHEDULER_JOB_ARGS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/72.DBA_SCHEDULER_JOB_ARGS.md deleted file mode 100644 index 8f72f1068..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/72.DBA_SCHEDULER_JOB_ARGS.md +++ /dev/null @@ -1,47 +0,0 @@ -DBA_SCHEDULER_JOB_ARGS -=========================================== - - -**说明** - - - -OceanBase 数据库暂未支持该视图。 - -功能 ------------ - -查看数据库中的调度作业参数信息。 - -相关视图 -------------- - -* USER_SCHEDULER_JOB_ARGS - - - -* ALL_SCHEDULER_JOB_ARGS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-----------------------|----------------|----------------|-------------------------| -| OWNER | VARCHAR2(30) | NO | 参数所属作业的拥有者 | -| JOB_NAME | VARCHAR2(30) | NO | 参数所属作业的名称 | -| ARGUMENT_NAME | VARCHAR2(30) | NO | 参数的可选名称 | -| ARGUMENT_POSITION | NUMBER | NO | 参数在参数列表中的位置 | -| ARGUMENT_TYPE | VARCHAR2(61) | NO | 参数的数据类型 | -| VALUE | VARCHAR2(4000) | NO | 如果参数是一个字符串类型,参数的默认值 | -| DEFAULT_ANYDATA_VALUE | VARCHAR2(128) | NO | 如果参数是 ANYDATA 类型,参数的默认值 | -| OUT_ARGUMENT | VARCHAR2(5) | NO | 保留字段 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/73.DBA_SCHEDULER_PROGRAM_ARGS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/73.DBA_SCHEDULER_PROGRAM_ARGS.md deleted file mode 100644 index 987410694..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/73.DBA_SCHEDULER_PROGRAM_ARGS.md +++ /dev/null @@ -1,48 +0,0 @@ -DBA_SCHEDULER_PROGRAM_ARGS -=============================================== - - -**说明** - - - -OceanBase 数据库暂未支持该视图。 - -功能 ------------ - -查看数据库中的调度程序参数信息。 - -相关视图 -------------- - -* USER_SCHEDULER_PROGRAM_ARGS - - - -* DBA_SCHEDULER_PROGRAM_ARGS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-----------------------|----------------|----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(30) | NO | 参数所属程序的拥有者 | -| PROGRAM_NAME | VARCHAR2(30) | NO | 参数所属程序的名称 | -| ARGUMENT_NAME | VARCHAR2(30) | NO | 参数的可选名称 | -| ARGUMENT_POSITION | NUMBER | NO | 参数在参数列表中的位置 | -| ARGUMENT_TYPE | VARCHAR2(61) | NO | 参数的数据类型 | -| METADATA_ATTRIBUTE | VARCHAR2(19) | NO | 元数据的属性: * JOB_NAME * JOB_OWNER * JOB_START * WINDOW_START * WINDOW_END * JOB_SUBNAME * EVENT_MESSAGE * JOB_SCHEDULER_START | -| DEFAULT_VALUE | VARCHAR2(4000) | NO | 如果参数是一个字符串类型,参数的默认值 | -| DEFAULT_ANYDATA_VALUE | VARCHAR2(128) | NO | 如果参数是 ANYDATA 类型,参数的默认值 | -| OUT_ARGUMENT | VARCHAR2(5) | NO | 保留字段 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/74.DBA_SEGMENTS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/74.DBA_SEGMENTS.md deleted file mode 100644 index 5fa60b73f..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/74.DBA_SEGMENTS.md +++ /dev/null @@ -1,49 +0,0 @@ -DBA_SEGMENTS -================================= - - - -功能 ------------ - -查看数据库中所有段分配的存储信息。 - -相关视图 -------------- - -USER_SEGMENTS - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|------------------|---------------|----------------|-----------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 拥有者名称 | -| SEGMENT_NAME | VARCHAR2(128) | NO | 段名字(如果有) | -| PARTITION_NAME | VARCHAR2(128) | NO | 分区名字,如果是非分区对象,则为空值 NULL | -| SEGMENT_TYPE | VARCHAR2(18) | NO | 段类型 | -| SEGMENT_SUBTYPE | VARCHAR2(10) | NO | 大字段 LOB 段的子类型。目前暂不支持该字段,当前该字段默认为 NULL | -| TABLESPACE_NAME | VARCHAR2(30) | NO | 含有该段的表空间。目前暂不支持该字段,当前该字段默认为 NULL | -| HEADER_FILE | NUMBER | NO | 包含该段头的文件 ID。目前暂不支持该字段,当前该字段默认为 NULL | -| HEADER_BLOCK | NUMBER | NO | 包含段头的块 ID。目前暂不支持该字段,当前该字段默认为 NULL | -| BYTES | NUMBER(38) | NO | 段大小,单位:bytes | -| BLOCKS | NUMBER(38) | NO | 段块大小 | -| EXTENTS | NUMBER | NO | 段申请的簇数。目前暂不支持该字段,当前该字段默认为 NULL | -| INITIAL_EXTENT | NUMBER | NO | 段创建初始化时段簇的大小,单位:bytes。目前暂不支持该字段,当前该字段默认为 NULL | -| NEXT_EXTENT | NUMBER | NO | 段申请下一个簇的大小,单位:bytes。目前暂不支持该字段,当前该字段默认为 NULL | -| MIN_EXTENTS | NUMBER | NO | 段允许申请的最小簇数量。目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_EXTENTS | NUMBER | NO | 段允许申请的最大簇数量。目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_SIZE | NUMBER | NO | 段允许申请的最大块数量。目前暂不支持该字段,当前该字段默认为 NULL | -| RETENTION | VARCHAR2(7) | NO | SecureFile 的保留字段。目前暂不支持该字段,当前该字段默认为 NULL | -| MINRETENTION | NUMBER | NO | SecureFile 的最短保留时长。目前暂不支持该字段,当前该字段默认为 NULL | -| PCT_INCREASE | NUMBER | NO | 增加要分配的下一个数据块大小的百分比。目前暂不支持该字段,当前该字段默认为 NULL | -| FREELISTS | NUMBER | NO | 该段申请的空闲链表数。目前暂不支持该字段,当前该字段默认为 NULL | -| FREELIST_GROUPS | NUMBER | NO | 该段申请的空闲组数。目前暂不支持该字段,当前该字段默认为 NULL | -| RELATIVE_FNO | NUMBER | NO | 段头的相对文件号。目前暂不支持该字段,当前该字段默认为 NULL | -| BUFFER_POOL | VARCHAR2(7) | NO | 用于段块的缓冲池 | -| FLASH_CACHE | VARCHAR2(7) | NO | 用于段块的数据库智能闪存缓存提示 | -| CELL_FLASH_CACHE | VARCHAR2(7) | NO | 用于段块的单元闪存缓存提示 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/75.DBA_SEQUENCES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/75.DBA_SEQUENCES.md deleted file mode 100644 index edfaffe28..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/75.DBA_SEQUENCES.md +++ /dev/null @@ -1,43 +0,0 @@ -DBA_SEQUENCES -================================== - - - -功能 ------------ - -列出数据库中所有 SEQUENCE。 - -相关视图 -------------- - -* ALL_SEQUENCES - - - -* USER_SEQUENCES - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------|---------------|----------------|-------------------------| -| OWNER | VARCHAR2(128) | NO | 对象所属的拥有者 | -| OBJECT_NAME | VARCHAR2(128) | NO | SEQUENCE 名 | -| MIN_VALUE | NUMBER(28) | NO | SEQUENCE 可取的最小值(含) | -| MAX_VALUE | NUMBER(28) | NO | SEQUENCE 可取的最大值(含最大值) | -| INCREMENT_BY | NUMBER(28) | NO | 每次取值的步长,可为正整数或负整数,不可为 0 | -| CYCLE_FLAG | CHAR(1) | NO | 是否可以循环取值 | -| ORDER_FLAG | CHAR(1) | NO | 取值是否保证全局有序 | -| CACHE_SIZE | NUMBER(28) | NO | 每个节点缓存值的数量 | -| LAST_NUMBER | NUMBER(38) | NO | 记录下一个可分配给节点的值 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/76.DBA_SOURCE.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/76.DBA_SOURCE.md deleted file mode 100644 index 092dc7729..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/76.DBA_SOURCE.md +++ /dev/null @@ -1,40 +0,0 @@ -DBA_SOURCE -=============================== - - - -功能 ------------ - -列出数据库中可用的过程和函数的源代码。 - -相关视图 -------------- - -* ALL_SOURCE - - - -* USER_SOURCE - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|---------------|--------------|----------------|--------------------| -| OWNER | VARCHAR2(30) | NO | 对象所属的拥有者 | -| NAME | VARCHAR2(30) | NO | 对象名 | -| TYPE | VARCHAR2(12) | NO | 对象类型 | -| LINE | NUMBER | NO | TEXT 字段对应的源代码中的行号 | -| TEXT | CLOB | NO | 当前行的源代码 | -| ORIGIN_CON_ID | NUMBER(38) | NO | 暂不支持该字段,字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/77.DBA_STMT_AUDIT_OPTS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/77.DBA_STMT_AUDIT_OPTS.md deleted file mode 100644 index b8cdde6c4..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/77.DBA_STMT_AUDIT_OPTS.md +++ /dev/null @@ -1,30 +0,0 @@ -DBA_STMT_AUDIT_OPTS -======================================== - - - -功能 ------------ - -记录语句级别审计的详细配置。 - -相关视图 -------------- - -STMT_AUDIT_OPTION_MAP - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------|---------------|----------------|--------------------------------| -| USER_NAME | VARCHAR2(128) | NO | 被审计的用户名 | -| PROXY_NAME | VARCHAR2(128) | NO | 被审计的 Proxy 用户名,当前该字段的值始终为 NULL | -| AUDIT_OPTION | VARCHAR2(128) | NO | 语句级别审计的 Type ID | -| SUCCESS | VARCHAR2(10) | NO | 语句执行成功时的审计模式 | -| FAILURE | VARCHAR2(10) | NO | 语句执行失败时的审计模式 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/78.DBA_SUBPARTITION_TEMPLATES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/78.DBA_SUBPARTITION_TEMPLATES.md deleted file mode 100644 index 016f24798..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/78.DBA_SUBPARTITION_TEMPLATES.md +++ /dev/null @@ -1,40 +0,0 @@ -DBA_SUBPARTITION_TEMPLATES -=============================================== - - - -功能 ------------ - -查看所有子分区模版描述信息。 - -相关视图 -------------- - -* ALL_SUBPARTITION_TEMPLATES - - - -* USER_SUBPARTITION_TEMPLATES - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-----------------------|----------------|----------------|-----------| -| USER_NAME | VARCHAR2(128) | NO | 分区表的所有者 | -| TABLE_NAME | VARCHAR2(256) | NO | 分区表名 | -| SUBPARTITION_NAME | VARCHAR2(64) | NO | 子分区名 | -| SUBPARTITION_POSITION | NUMBER | YES | 子分区位置 | -| TABLESPACE_NAME | VARCHAR2(30) | NO | 分区所属的表空间名 | -| HIGH_BOUND | VARCHAR2(1024) | NO | 分区模板表达式 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/79.DBA_SUBPART_KEY_COLUMNS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/79.DBA_SUBPART_KEY_COLUMNS.md deleted file mode 100644 index 38d4b55d3..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/79.DBA_SUBPART_KEY_COLUMNS.md +++ /dev/null @@ -1,40 +0,0 @@ -DBA_SUBPART_KEY_COLUMNS -============================================ - - - -功能 ------------ - -查看数据库中所有分区对象中子分区键包含的列。 - -相关视图 -------------- - -* ALL_SUBPART_KEY_COLUMNS - - - -* USER_SUBPART_KEY_COLUMNS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------------|----------------|----------------|----------------------------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 分区表或分区索引的拥有者 | -| NAME | VARCHAR2(128) | NO | 分区表或分区索引的名字 | -| OBJECT_TYPE | CHAR(5) | NO | 分区对象的类型: * TABLE * INDEX | -| COLUMN_NAME | VARCHAR2(4000) | NO | 列的名字 | -| COLUMN_POSITION | NUMBER | NO | 列在分区键中的位置 | -| COLLATED_COLUMN_ID | NUMBER | NO | 目前暂未支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/8.ALL_DEF_AUDIT_OPTS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/8.ALL_DEF_AUDIT_OPTS.md deleted file mode 100644 index 64bde0a91..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/8.ALL_DEF_AUDIT_OPTS.md +++ /dev/null @@ -1,51 +0,0 @@ -ALL_DEF_AUDIT_OPTS -======================================= - - - -功能 ------------ - -记录任何对象默认被审计的审计条件。每列的取值如下: - -* `-/-`:默认不审计 - -* `S/-`: 只在语句执行成功时审计 - -* `-/S`: 只在语句执行失败时审计 - -* `S/S`: 语句执行无论成功还是失败时都审计 - - - - -相关视图 -------------- - -DBA_OBJ_AUDIT_OPTS - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------|-------------|----------------|-----------------------------------| -| ALT | VARCHAR2(3) | NO | ALTER 操作 | -| AUD | VARCHAR2(3) | NO | AUDIT 操作 | -| COM | VARCHAR2(3) | NO | COMMENT 操作 | -| DEL | VARCHAR2(3) | NO | DELETE 操作 | -| GRA | VARCHAR2(3) | NO | GRANT 操作 | -| IND | VARCHAR2(3) | NO | INDEX 操作 | -| INS | VARCHAR2(3) | NO | INSERT 操作 | -| LOC | VARCHAR2(3) | NO | LOCK 操作 | -| REN | VARCHAR2(3) | NO | RENAME 操作 | -| SEL | VARCHAR2(3) | NO | SELECT 操作 | -| UPD | VARCHAR2(3) | NO | UPDATE 操作 | -| REF | VARCHAR2(3) | NO | REFERENCE 操作,目前仅定义了但不支持,默认值为 NULL | -| EXE | VARCHAR2(3) | NO | EXECUTE 操作 | -| FBK | VARCHAR2(3) | NO | FLASHBACK 操作 | -| REA | VARCHAR2(3) | NO | READ 操作 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/80.DBA_SYNONYMS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/80.DBA_SYNONYMS.md deleted file mode 100644 index d31dd64f9..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/80.DBA_SYNONYMS.md +++ /dev/null @@ -1,39 +0,0 @@ -DBA_SYNONYMS -================================= - - - -功能 ------------ - -查看数据库中所有同义词。 - -相关视图 -------------- - -* ALL_SYNONYMS - - - -* USER_SYNONYMS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------|---------------|----------------|-------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 同义词的拥有者 | -| SYNONYM_NAME | VARCHAR2(128) | NO | 同义词名字 | -| TABLE_OWNER | VARCHAR2(128) | NO | 同义词引用对象的拥有者 | -| TABLE_NAME | VARCHAR2(128) | NO | 同义词引用的对象名字 | -| DB_LINK | VARCHAR2(128) | NO | 如果引用的是 DB Link,则表示 DB Link 名字。目前同义词暂不支持 DB LINK | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/81.DBA_SYS_PRIVS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/81.DBA_SYS_PRIVS.md deleted file mode 100644 index 13e1cf5af..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/81.DBA_SYS_PRIVS.md +++ /dev/null @@ -1,28 +0,0 @@ -DBA_SYS_PRIVS -================================== - - - -功能 ------------ - -描述授予用户和角色的系统特权。此视图不显示 `USERNAME` 列。 - -相关视图 -------------- - -USER_SYS_PRIVS - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------|---------------|----------------|------------------| -| GRANTEE | VARCHAR2(128) | NO | 接受授权的授予者名称、用户或角色 | -| PRIVILEGE | VARCHAR2(40) | NO | 系统权限 | -| ADMIN_OPTION | VARCHAR2(3) | NO | 授予管理选项 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/82.DBA_TABLES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/82.DBA_TABLES.md deleted file mode 100644 index fcecf8335..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/82.DBA_TABLES.md +++ /dev/null @@ -1,89 +0,0 @@ -DBA_TABLES -=============================== - - - -功能 ------------ - -查看数据库中的所有表。 - -相关视图 -------------- - -* ALL_TABLES - - - -* USER_TABLES - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|---------------------------|---------------|----------------|---------------------------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 表的拥有者 | -| TABLE_NAME | VARCHAR2(128) | NO | 表名 | -| TABLESPACE_NAME | VARCHAR2(30) | NO | 包含该表的表空间名字 | -| CLUSTER_NAME | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| IOT_NAME | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| STATUS | VARCHAR2(8) | NO | 表状态: * VALID * UNUSABLE | -| PCT_FREE | NUMBER | NO | 块的最小空闲空间比例 | -| PCT_USED | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INI_TRANS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_TRANS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INITIAL_EXTENT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NEXT_EXTENT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MIN_EXTENTS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_EXTENTS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| PCT_INCREASE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| FREELISTS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| FREELIST_GROUPS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| LOGGING | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| BACKED_UP | VARCHAR2(1) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NUM_ROWS | NUMBER | NO | 表行数 | -| BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| EMPTY_BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_SPACE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CHAIN_CNT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_ROW_LEN | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_SPACE_FREELIST_BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NUM_FREELIST_BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEGREE | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INSTANCES | VARCHAR2(40) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CACHE | VARCHAR2(20) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| TABLE_LOCK | VARCHAR2(8) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| SAMPLE_SIZE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| LAST_ANALYZED | DATE | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| PARTITIONED | VARCHAR2(3) | NO | 指定表是否是分区: * YES * NO | -| IOT_TYPE | VARCHAR2(12) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| TEMPORARY | VARCHAR2(1) | NO | 指定表是否是临时表 | -| SECONDARY | VARCHAR2(1) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NESTED | VARCHAR2(3) | NO | 指定表是否是嵌套表: * YES * NO | -| BUFFER_POOL | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CELL_FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| ROW_MOVEMENT | VARCHAR2(8) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| GLOBAL_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| USER_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DURATION | VARCHAR2(15) | NO | 指示临时表的持续时间 | -| SKIP_CORRUPT | VARCHAR2(8) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MONITORING | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CLUSTER_OWNER | VARCHAR2(30) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DEPENDENCIES | VARCHAR2(8) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| COMPRESSION | VARCHAR2(8) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| COMPRESS_FOR | VARCHAR2(12) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DROPPED | VARCHAR2(3) | NO | 表示被删除表是否在回收站里 | -| READ_ONLY | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| SEGMENT_CREATED | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| RESULT_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/83.DBA_TABLESPACES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/83.DBA_TABLESPACES.md deleted file mode 100644 index 1cc333fa0..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/83.DBA_TABLESPACES.md +++ /dev/null @@ -1,48 +0,0 @@ -DBA_TABLESPACES -==================================== - - - -功能 ------------ - -查看所有 tablespace。 - -相关视图 -------------- - -USER_TABLESPACES - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------------------|--------------|----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| TABLESPACE_NAME | VARCHAR2(30) | NO | 表空间的名称 | -| BLOCK_SIZE | NUMBER | NO | 表空间块大小。目前暂不支持该字段,当前该字段默认为 NULL | -| INITIAL_EXTENT | NUMBER | NO | 默认初始区段大小。目前暂不支持该字段,当前该字段默认为 NULL | -| NEXT_EXTENT | NUMBER | NO | 默认增量区段大小。目前暂不支持该字段,当前该字段默认为 NULL | -| MIN_EXTENTS | NUMBER | NO | 默认的最小扩展数。目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_EXTENTS | NUMBER | NO | 默认的最大扩展数。目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_SIZE | NUMBER | NO | 段的默认最大大小。目前暂不支持该字段,当前该字段默认为 NULL | -| PCT_INCREASE | NUMBER | NO | 区段大小的默认增加百分比。目前暂不支持该字段,当前该字段默认为 NULL | -| MIN_EXTLEN | NUMBER | NO | 此表空间的最小区段大小。目前暂不支持该字段,当前该字段默认为 NULL | -| STATUS | VARCHAR2(9) | NO | 表空间状态: * ONLINE * OFFLINE * READ ONLY 目前暂不支持该字段,当前该字段默认为 NULL | -| CONTENTS | VARCHAR2(9) | NO | 表内容: * UNDO * PERMANENT * TEMPORARY 目前暂不支持该字段,当前该字段默认为 NULL | -| LOGGING | VARCHAR2(9) | NO | 默认的日志记录属性: * LOGGING * NOLOGGING 目前暂不支持该字段,当前该字段默认为 NULL | -| FORCE_LOGGING | VARCHAR2(3) | NO | 指示表空间是否处于强制日志记录模式。目前暂不支持该字段,当前该字段默认为 NULL | -| EXTENT_MANAGEMENT | VARCHAR2(10) | NO | 指示表空间中的区段是字典管理的还是本地管理。目前暂不支持该字段,当前该字段默认为 NULL | -| ALLOCATION_TYPE | VARCHAR2(9) | NO | 表空间中有效的区段分配类型: * SYSTEM * UNIFORM * USER 目前暂不支持该字段,当前该字段默认为 NULL | -| PLUGGED_IN | VARCHAR2(3) | NO | 指示是否插入表空间。目前暂不支持该字段,当前该字段默认为 NULL | -| SEGMENT_SPACE_MANAGEMENT | VARCHAR2(6) | NO | 指示表空间中的空闲和使用的段空间是使用空闲列表还是位图来管理的。目前暂不支持该字段,当前该字段默认为 NULL | -| DEF_TAB_COMPRESSION | VARCHAR2(8) | NO | 指示是否启用默认表压缩 | -| RETENTION | VARCHAR2(11) | NO | 撤消表空间保留: * GUARANTEE * A RETENTION * NOGUARANTEE * NOT APPLY 目前暂不支持该字段,当前该字段默认为 NULL | -| BIGFILE | VARCHAR2(3) | NO | 指示表空间是大文件表空间还是小文件表空间。目前暂不支持该字段,当前该字段默认为 NULL | -| PREDICATE_EVALUATION | VARCHAR2(7) | NO | 指示谓词是由主机计算还是由存储计算。目前暂不支持该字段,当前该字段默认为 NULL | -| ENCRYPTED | VARCHAR2(3) | NO | 指示表空间是否加密或不加密。目前暂不支持该字段,当前该字段默认为 NULL | -| COMPRESS_FOR | VARCHAR2(12) | NO | 默认压缩操作的类型。目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/84.DBA_TAB_COLS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/84.DBA_TAB_COLS.md deleted file mode 100644 index adb8db427..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/84.DBA_TAB_COLS.md +++ /dev/null @@ -1,72 +0,0 @@ -DBA_TAB_COLS -================================= - - - -功能 ------------ - -查看数据库中的所有表、视图、集群的所有列。 - -这个视图与 DBA_TABLE_COLUMNS 的区别在于没有对隐藏列进行过滤。 - -相关视图 -------------- - -* ALL_TAB_COLS - - - -* USER_TAB_COLS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------------------|----------------|----------------|-------------------------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 表、视图的拥有者 | -| TABLE_NAME | VARCHAR2(128) | NO | 表、视图的名字 | -| COLUMN_NAME | VARCHAR2(128) | NO | 列名 | -| DATA_TYPE | VARCHAR2(128) | NO | 列类型 | -| DATA_TYPE_MOD | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DATA_TYPE_OWNER | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DATA_LENGTH | NUMBER | NO | 列长度,单位:bytes | -| DATA_PRECISION | NUMBER | NO | 数字数据类型的十进制精度;浮点数据类型的二进制精度;所有其他数据类型为空值 | -| DATA_SCALE | NUMBER | NO | 数值小数点右边的数字 | -| NULLABLE | VARCHAR2(1) | NO | 列是否允许为空 | -| COLUMN_ID | NUMBER | NO | 列序号 | -| DEFAULT_LENGTH | NUMBER | NO | 列默认长度 | -| DATA_DEFAULT | VARCHAR2(128) | NO | 列默认值 | -| NUM_DISTINCT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| LOW_VALUE | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| HIGH_VALUE | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DENSITY | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NUM_NULLS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NUM_BUCKETS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| LAST_ANALYZED | DATE | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| SAMPLE_SIZE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CHARACTER_SET_NAME | VARCHAR2(44) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CHAR_COL_DECL_LENGTH | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| GLOBAL_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| USER_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_COL_LEN | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CHAR_LENGTH | NUMBER | NO | 字符类型的列长度 | -| CHAR_USED | VARCHAR2(1) | NO | 表示列是按照字节长度还是字符长度 | -| V80_FMT_IMAGE | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DATA_UPGRADED | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| HIDDEN_COLUMN | VARCHAR2(3) | NO | 表示列是否是隐藏列: * YES * NO | -| VIRTUAL_COLUMN | VARCHAR2(3) | NO | 表示列是否是虚拟列 * YES * NO | -| SEGMENT_COLUMN_ID | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INTERNAL_COLUMN_ID | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| HISTOGRAM | VARCHAR2(15) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| QUALIFIED_COL_NAME | VARCHAR2(4000) | NO | 限定列名 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/85.DBA_TAB_COLUMNS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/85.DBA_TAB_COLUMNS.md deleted file mode 100644 index 539bcb2bc..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/85.DBA_TAB_COLUMNS.md +++ /dev/null @@ -1,65 +0,0 @@ -DBA_TAB_COLUMNS -==================================== - - - -功能 ------------ - -查看数据库中所有的表、视图、集群的所有列。 - -相关视图 -------------- - -* ALL_TAB_COLUMNS - - - -* USER_TAB_COLUMNS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------------------|---------------|----------------|---------------------------------------| -| OWNER | VARCHAR2(128) | NO | 表、视图的拥有者 | -| TABLE_NAME | VARCHAR2(128) | NO | 表、视图的名字 | -| COLUMN_NAME | VARCHAR2(128) | NO | 列名 | -| DATA_TYPE | VARCHAR2(128) | NO | 列类型 | -| DATA_TYPE_MOD | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DATA_TYPE_OWNER | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DATA_LENGTH | NUMBER | NO | 列长度,单位:bytes | -| DATA_PRECISION | NUMBER | NO | 数字数据类型的十进制精度;浮点数据类型的二进制精度;所有其他数据类型为空值 | -| DATA_SCALE | NUMBER | NO | 数值小数点右边的数字 | -| NULLABLE | VARCHAR2(1) | NO | 列是否允许为空 | -| COLUMN_ID | NUMBER | NO | 列序号 | -| DEFAULT_LENGTH | NUMBER | NO | 列默认长度 | -| DATA_DEFAULT | VARCHAR2(128) | NO | 列默认值 | -| NUM_DISTINCT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| LOW_VALUE | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| HIGH_VALUE | VARCHAR2(128) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DENSITY | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NUM_NULLS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NUM_BUCKETS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| LAST_ANALYZED | DATE | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| SAMPLE_SIZE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CHARACTER_SET_NAME | VARCHAR2(44) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CHAR_COL_DECL_LENGTH | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| GLOBAL_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| USER_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_COL_LEN | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CHAR_LENGTH | NUMBER | NO | 字符类型的列长度 | -| CHAR_USED | VARCHAR2(1) | NO | 表示列是按照字节长度还是字符长度 | -| V80_FMT_IMAGE | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DATA_UPGRADED | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| HISTOGRAM | VARCHAR2(15) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/86.DBA_TAB_COMMENTS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/86.DBA_TAB_COMMENTS.md deleted file mode 100644 index 29bb185ab..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/86.DBA_TAB_COMMENTS.md +++ /dev/null @@ -1,37 +0,0 @@ -DBA_TAB_COMMENTS -===================================== - - - -功能 ------------ - -查看数据库中所有表、视图的注释。 - -相关视图 -------------- - -* ALL_TAB_COMMENTS - - - -* USER_TAB_COMMENTS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|------------|----------------|----------------|----------| -| OWNER | VARCHAR2(128) | NO | 表、视图的拥有者 | -| TABLE_NAME | VARCHAR2(128) | NO | 表、视图的名字 | -| TABLE_TYPE | VARCHAR2(11) | NO | 对象类型 | -| COMMENTS | VARCHAR2(4000) | NO | 对象注释 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/87.DBA_TAB_PARTITIONS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/87.DBA_TAB_PARTITIONS.md deleted file mode 100644 index 6f21f6bad..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/87.DBA_TAB_PARTITIONS.md +++ /dev/null @@ -1,75 +0,0 @@ -DBA_TAB_PARTITIONS -======================================= - - - -功能 ------------ - -查看当前用户可访问的多级分区信息、分区存储参数和分区统计信息。 - -相关视图 -------------- - -* ALL_TAB_PARTITIONS - - - -* USER_TAB_PARTITIONS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|------------------------|----------------|----------------|-------------------------| -| TABLE_OWNER | VARCHAR2(128) | NO | 分区表所属的 USER | -| TABLE_NAME | VARCHAR2(128) | NO | 分区表名字 | -| COMPOSITE | VARCHAR2(3) | NO | 是否为多级分区 | -| PARTITION_NAME | VARCHAR2(128) | NO | 分区名 | -| SUBPARTITION_COUNT | NUMBER | YES | 子分区个数 | -| HIGH_VALUE | VARCHAR2(1024) | NO | 分区表达式 | -| HIGH_VALUE_LENGTH | NUMBER | NO | 分区表达式的长度 | -| PARTITION_POSITION | NUMBER | NO | 分区的位置 | -| TABLESPACE_NAME | VARCHAR2(30) | NO | 分区所属的表空间名 | -| PCT_FREE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| PCT_USED | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INI_TRANS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_TRANS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INITIAL_EXTENT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| NEXT_EXTENT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MIN_EXTENT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_EXTENT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| MAX_SIZE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| PCT_INCREASE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| FREELISTS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| FREELIST_GROUPS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| LOGGING | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| COMPRESSION | VARCHAR2(8) | NO | 是否开启压缩 | -| COMPRESS_FOR | VARCHAR2(12) | YES | 压缩方法 | -| NUM_ROWS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| EMPTY_BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_SPACE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CHAIN_CNT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| AVG_ROW_LEN | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| SAMPLE_SIZE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| LAST_ANALYZED | DATE | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| BUFFER_POOL | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| CELL_FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| GLOBAL_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| USER_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| IS_NESTED | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| PARENT_TABLE_PARTITION | VARCHAR2(30) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| INTERVAL | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| SEGMENT_CREATED | VARCHAR2(4) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/88.DBA_TAB_PRIVS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/88.DBA_TAB_PRIVS.md deleted file mode 100644 index 698f593a5..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/88.DBA_TAB_PRIVS.md +++ /dev/null @@ -1,31 +0,0 @@ -DBA_TAB_PRIVS -================================== - - - -功能 ------------ - -描述数据库中的所有对象授予。 - -相关视图 -------------- - -USER_TAB_PRIVS - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|------------|---------------|----------------|-----------------------| -| GRANTEE | VARCHAR2(128) | NO | 被授予访问权限的用户的名称 | -| OWNER | VARCHAR2(128) | NO | 对象的所有者 | -| TABLE_NAME | VARCHAR2(128) | NO | 对象的名称 | -| GRANTOR | VARCHAR2(128) | NO | 执行授权的用户的名称 | -| PRIVILEGE | VARCHAR2(40) | NO | 对象的特权 | -| GRANTABLE | VARCHAR2(3) | NO | 是否能使用 GRANT 授予权限 | -| HIERARCHY | VARCHAR2(3) | NO | 是否能使用 HIERARCHY 授予权限 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/89.DBA_TAB_SUBPARTITIONS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/89.DBA_TAB_SUBPARTITIONS.md deleted file mode 100644 index e9a89cea8..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/89.DBA_TAB_SUBPARTITIONS.md +++ /dev/null @@ -1,71 +0,0 @@ -DBA_TAB_SUBPARTITIONS -========================================== - - - -功能 ------------ - -`DBA_TAB_SUBPARTITIONS` 用于展示子分区名称、表和所属分区的名称、其存储属性以及 `DBMS_STATS` 包生成的统计信息。 - -相关视图 -------------- - -* ALL_TAB_SUBPARTITIONS - - - -* USER_TAB_SUBPARTITIONS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-----------------------|----------------|----------------|--------------------------| -| TABLE_OWNER | VARCHAR2(128) | NO | 表的所有者。 | -| TABLE_NAME | VARCHAR2(128) | NO | 表名。 | -| PARTITION_NAME | VARCHAR2(128) | NO | 分区名称。 | -| SUBPARTITION_NAME | VARCHAR2(128) | NO | 子分区名称。 | -| HIGH_VALUE | VARCHAR2(1024) | NO | 子分区表达式。 | -| HIGH_VALUE_LENGTH | NUMBER | NO | 子分区表达式的长度。 | -| SUBPARTITION_POSITION | NUMBER | NO | 子分区在分区中的位置。 | -| TABLESPACE_NAME | VARCHAR2(30) | NO | 包含子分区的表空间的名称。 | -| PCT_FREE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| PCT_USED | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| INI_TRANS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| MAX_TRANS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| INITIAL_EXTENT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| NEXT_EXTENT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| MIN_EXTENT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| MAX_EXTENT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| MAX_SIZE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| PCT_INCREASE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| FREELISTS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| FREELIST_GROUPS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| LOGGING | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| COMPRESSION | VARCHAR2(8) | NO | 子分区是否压缩。 | -| COMPRESS_FOR | VARCHAR2(12) | YES | 压缩方法。 | -| NUM_ROWS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| EMPTY_BLOCKS | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| AVG_SPACE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| CHAIN_CNT | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| AVG_ROW_LEN | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| SAMPLE_SIZE | NUMBER | NO | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| LAST_ANALYZED | DATE | NO | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| BUFFER_POOL | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| CELL_FLASH_CACHE | VARCHAR2(7) | NO | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| GLOBAL_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| USER_STATS | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| INTERVAL | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL。 | -| SEGMENT_CREATED | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL。 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/9.ALL_ERRORS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/9.ALL_ERRORS.md deleted file mode 100644 index 597055e54..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/9.ALL_ERRORS.md +++ /dev/null @@ -1,48 +0,0 @@ -ALL_ERRORS -=============================== - - -**说明** - - - -OceanBase 数据库暂未支持该视图的相关功能。 - -功能 ------------ - -查看用户可以访问的当前存储对象的错误。 - -相关视图 -------------- - -* DBA_ERRORS - - - -* USER_ERRORS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------------|----------------|----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 对象的拥有者 | -| NAME | VARCHAR2(128) | NO | 对象的名称 | -| TYPE | VARCHAR2(19) | NO | 对象的类型: * VIEW * PROCEDUCE * FUNCTION * PACKAGE * PACKAGE_BODY * TRIGGER * TYPE * TYPE BODY * LIBRARY * JAVA SOURCE * JAVA CLASS * DIMENSION | -| SEQUENCE | NUMBER | NO | 同一次编译有多条错误时的错误编号(未排序) | -| LINE | NUMBER | NO | 错误发生的行 | -| POSITION | NUMBER | NO | 错误发生的列 | -| TEXT | VARCHAR2(4000) | NO | 错误信息文本 | -| ATTRIBUTE | VARCHAR2(9) | NO | 表明是 ERROR 还是 WARNING | -| MESSAGE_NUMBER | number | NO | 错误编码 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/90.DBA_TRIGGERS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/90.DBA_TRIGGERS.md deleted file mode 100644 index 0f782238d..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/90.DBA_TRIGGERS.md +++ /dev/null @@ -1,55 +0,0 @@ -DBA_TRIGGERS -================================= - - - -功能 ------------ - -描述数据库中的所有触发器。 - -相关视图 -------------- - -* ALL_TRIGGERS - - - -* USER_TRIGGERS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-------------------|-----------------|----------------|------------------------------------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 触发器 OWNER | -| TRIGGER_NAME | VARCHAR2(128) | NO | 触发器名字 | -| TRIGGER_TYPE | VARCHAR2(16) | NO | 触发器类型: * BEFORE/AFTER * ROW/STMT | -| TRIGGERING_EVENT | VARCHAR2(246) | NO | 触发事件,当前 OceanBase 数据库仅支持 INSERT、UPDATE、DELETE等。 | -| TABLE_OWNER | VARCHAR2(128) | NO | 表 OWNER,触发对象类型为表时有效。 | -| BASE_OBJECT_TYPE | VARCHAR2(18) | NO | 触发对象类型,当前 OceanBase 数据库仅支持 TABLE。 | -| TABLE_NAME | VARCHAR2(256) | NO | 表名,触发对象类型为表时有效。 | -| COLUMN_NAME | VARCHAR2(4000) | YES | 列名,仅在触发对象为嵌套表时有效,其它情况为 NULL。 | -| REFERENCING_NAMES | VARCHAR2(422) | NO | REF 名,是 OLD 和 NEW 的别名。 | -| WHEN_CLAUSE | VARCHAR2(4000) | YES | 触发条件 | -| STATUS | VARCHAR2(8) | NO | 状态: * ENABLE * DISABLE | -| DESCRIPTION | VARCHAR2(65536) | NO | 触发器描述,包括名字、类型、事件信息。当前 OceanBase 包含的信息比 Oracle 更多。 | -| ACTION_TYPE | VARCHAR2(11) | NO | ACTION 类型,当前 OceanBase 数据库仅支持 PL/SQL。 | -| TRIGGER_BODY | VARCHAR2(65536) | NO | 触发器语句。当前 OceanBase 数据库包含的信息比 Oracle 更多。 | -| CROSSEDITION | VARCHAR2(7) | NO | 跨版本信息,目前暂不支持该字段。 | -| BEFORE_STATEMENT | VARCHAR2(3) | NO | 语句前,YES/NO。表示组合触发器是否包含指定类型的 Section。 | -| BEFORE_ROW | VARCHAR2(3) | NO | 行前,YES/NO。表示组合触发器是否包含指定类型的 Section。 | -| AFTER_ROW | VARCHAR2(3) | NO | 行后,YES/NO。表示组合触发器是否包含指定类型的 Section。 | -| AFTER_STATEMENT | VARCHAR2(3) | NO | 语句后,YES/NO。表示组合触发器是否包含指定类型的 Section。 | -| INSTEAD_OF_ROW | VARCHAR2(3) | NO | 代替,YES/NO。表示组合触发器是否包含指定类型的 Section。 | -| FIRE_ONCE | VARCHAR2(3) | NO | 目前暂不支持该字段。 | -| APPLY_SERVER_ONLY | VARCHAR2(3) | NO | 目前暂不支持该字段。 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/91.DBA_TYPES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/91.DBA_TYPES.md deleted file mode 100644 index b4ddf45ec..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/91.DBA_TYPES.md +++ /dev/null @@ -1,49 +0,0 @@ -DBA_TYPES -============================== - - - -功能 ------------ - -列出数据库中可用的用户自定义类型。 - -相关视图 -------------- - -* ALL_TYPES - - - -* USER_TYPES - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|------------------|---------------|----------------|---------------------------| -| OWNER | VARCHAR2(128) | NO | 对象所属的拥有者 | -| TYPE_NAME | VARCHAR2(64) | NO | 类型名 | -| TYPE_OID | NUMBER(38) | NO | 类型 OID | -| TYPECODE | VARCHAR2(10) | NO | 代表对象的类型,例如 OBJECT、 COLL 等 | -| ATTRIBUTES | NUMBER(38) | NO | 类型包含的属性数 | -| METHODS | NUMBER(38) | NO | 类型包含的方法数 | -| PREDEFINED | CHAR(2) | NO | 是否是系统预定义类型 | -| INCOMPLETE | CHAR(2) | NO | 是否是不完整类型, 只有名字没有方法和属性 | -| FINAL | CHAR(3) | NO | 是否不可被继承 | -| INSTANTIABLE | CHAR(3) | NO | 是否可实例化 | -| SUPERTYPE_OWNER | VARCHAR2(30) | NO | 父类型的拥有者 | -| SUPERTYPE_NAME | VARCHAR2(30) | NO | 父类型名 | -| LOCAL_ATTRIBUTES | NUMBER(38) | NO | 本地属性数 | -| LOCAL_METHODS | NUMBER(38) | NO | 本地方法数 | -| TYPEID | NUMBER(38) | YES | 目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/92.DBA_TYPE_ATTRS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/92.DBA_TYPE_ATTRS.md deleted file mode 100644 index 6a1df95ae..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/92.DBA_TYPE_ATTRS.md +++ /dev/null @@ -1,47 +0,0 @@ -DBA_TYPE_ATTRS -=================================== - - - -功能 ------------ - -列出数据库中可用的用户自定义类型的属性信息。 - -相关视图 -------------- - -* ALL_TYPE_ATTRS - - - -* USER_TYPE_ATTRS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------------|---------------|----------------|-------------------------| -| OWNER | VARCHAR2(128) | NO | 对象所属的拥有者 | -| TYPE_NAME | VARCHAR2(64) | NO | 类型名 | -| ATTR_NAME | VARCHAR2(64) | NO | 类型属性名 | -| ATTR_TYPE_MOD | VARCHAR2(7) | NO | 类型的 Modify 属性。当前暂未使用该字段 | -| ATTR_TYPE_OWNER | VARCHAR2(128) | NO | 属性的类型拥有者 | -| ATTR_TYPE_NAME | VARCHAR2(324) | NO | 属性的类型名 | -| LENGTH | NUMBER(38) | NO | 属性类型长度 | -| NUMBER_PRECISION | NUMBER(38) | NO | 属性数值类型的长度 | -| SCALE | NUMBER(38) | NO | 数值类型小数点右边的数据长度 | -| CHARACTER_SET_NAME | CHAR(7) | NO | 属性类型的字符集 | -| ATTR_NO | NUMBER(38) | NO | 属性编号 | -| INHERITED | CHAR(2) | NO | 该属性是否继承自父类型 | -| CHAR_USED | CHAR(1) | YES | 目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/93.DBA_TYPE_METHODS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/93.DBA_TYPE_METHODS.md deleted file mode 100644 index 062b7e769..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/93.DBA_TYPE_METHODS.md +++ /dev/null @@ -1,49 +0,0 @@ -DBA_TYPE_METHODS -===================================== - - -**说明** - - - -OceanBase 数据库暂未支持该视图。 - -功能 ------------ - -查看数据库中对象类型的方法。 - -相关视图 -------------- - -* ALL_TYPE_METHODS - - - -* USER_TYPE_METHODS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------|--------------|----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(30) | NO | 类型的拥有者 | -| TYPE_NAME | VARCHAR2(30) | NO | 类型的名称 | -| METHOD_NAME | VARCHAR2(30) | NO | 方法的名称 | -| METHOD_NO | NUMBER | NO | 方法编号,为了区分重载方法 | -| METHOD_TYPE | VARCHAR2(6) | NO | 方法类型: * MAP * ORDER * PUBLIC | -| PARAMETERS | NUMBER | NO | 方法参数的个数 | -| RESULTS | NUMBER | NO | 方法返回结果的个数 | -| FINAL | VARCHAR2(3) | NO | 表明此方法是否为 FINAL: * YES * NO | -| INSTANTIABLE | VARCHAR2(3) | NO | 表明此方法是否可实例化: * YES * NO | -| OVERRIDING | VARCHAR2(3) | NO | 表明此方法是否重载一个超类型方法: * YES * NO | -| INHERITED | VARCHAR2(3) | NO | 表明此方法是否继承自一个超类型: * YES * NO | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/94.DBA_USERS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/94.DBA_USERS.md deleted file mode 100644 index 9f32fb310..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/94.DBA_USERS.md +++ /dev/null @@ -1,36 +0,0 @@ -DBA_USERS -============================== - - - -功能 ------------ - -查看所有用户。 - -相关视图 -------------- - -ALL_USERS - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-----------------------------|----------------|----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| USERNAME | VARCHAR2(128) | NO | 用户名称 | -| USER_ID | NUMBER(38) | NO | 用户的身份证号 | -| PASSWORD | VARCHAR2(128) | NO | 此列不建议使用 AUTHENTICATION_TYPE 列 | -| ACCOUNT_STATUS | VARCHAR2(30) | NO | 帐户状态: * OPEN * EXPIRED * EXPIRED(GRACE) * LOCKED(TIMED) * LOCKED * EXPIRED \& LOCKED(TIMED) * EXPIRED(GRACE) \&LOCKED(TIMED) * EXPIRED \& LOCKED * EXPIRED(GRACE) \& LOCKED | -| LOCK_DATE | DATE | NO | 如果帐户状态被锁定,则锁定帐户的日期 | -| EXPIRY_DATE | DATE | NO | 账户到期日期 | -| DEFAULT_TABLESPACE | VARCHAR2(30) | NO | 数据的默认表空间 | -| TEMPORARY_TABLESPACE | VARCHAR2(30) | NO | 临时表的默认表空间的名称或表空间组的名称 | -| CREATED | DATE | NO | 用户创建日期 | -| INITIAL_RSRC_CONSUMER_GROUP | VARCHAR2(30) | NO | 用户的初始资源使用者组 | -| EXTERNAL_NAME | VARCHAR2(4000) | NO | 用户的外部名称 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/95.DBA_VIEWS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/95.DBA_VIEWS.md deleted file mode 100644 index b5db10ac1..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/95.DBA_VIEWS.md +++ /dev/null @@ -1,44 +0,0 @@ -DBA_VIEWS -============================== - - - -功能 ------------ - -查看所有视图。 - -相关视图 -------------- - -* ALL_VIEWS - - - -* USER_VIEWS - - - - - - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-----------------|----------------|----------------|-----------------------| -| OWNER | VARCHAR2(128) | NO | VIEW 所属的 USER | -| VIEW_NAME | VARCHAR2(128) | NO | 索引名字 | -| TEXT_LENGTH | NUMBER | NO | 视图定义长度 | -| TEXT | VARCHAR2(4000) | NO | 视图的文本 | -| OID_TEXT_LENGTH | NUMBER | NO | 类型化视图的 WITH OID 子句的长度 | -| OID_TEXT | VARCHAR2(4000) | NO | 类型化视图的 WITH OID子句 | -| VIEW_TYPE | VARCHAR2(30) | NO | 如果视图是有类型的视图,则视图的类型 | -| SUPERVIEW_NAME | VARCHAR2(30) | NO | 父视图的名称 | -| EDITIONING_VIEW | VARCHAR2(1) | NO | 留作将来使用 | -| READ_ONLY | VARCHAR2(1) | NO | 表示视图是否为只读 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/96.DBA_RECYCLEBIN.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/96.DBA_RECYCLEBIN.md deleted file mode 100644 index 44f92a906..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/96.DBA_RECYCLEBIN.md +++ /dev/null @@ -1,41 +0,0 @@ -DBA_RECYCLEBIN -=================================== - - - -功能 ------------------------ - -记录回收站的信息。 - -相关视图 -------------------------- - -USER_RECYCLEBIN - -字段说明 -------------------------- - - - -| 字段名称 | 类型 | 是否可以为 NULL | 描述 | -|----------------|---------------|------------|------------------------------------------------------------------------------------------------------------------------------------| -| OWNER | VARCHAR2(128) | NO | 对象原始所有者的名称 | -| OBJECT_NAME | VARCHAR2(128) | NO | 对象的新名称 | -| ORIGINAL_NAME | VARCHAR2(128) | NO | 对象的原始名称 | -| OPERATION | VARCHAR2(9) | NO | 暂不支持该字段,默认为 NULL | -| TYPE | VARCHAR2(25) | NO | 对象类型 | -| TS_NAME | VARCHAR2(30) | NO | 对象所属的表空间的名称 | -| CREATETIME | VARCHAR2(30) | NO | 创建对象的时间 | -| DROPTIME | VARCHAR2(30) | NO | 对象进入回收站的时间 | -| DROPSCN | NUMBER | NO | 暂不支持该字段,默认为 NULL | -| PARTITION_NAME | VARCHAR2(128) | NO | 暂不支持该字段,默认为 NULL | -| CAN_UNDROP | VARCHAR2(3) | NO | 是否可以将对象从回收站中恢复: * YES * NO | -| CAN_PURGE | VARCHAR2(3) | NO | 是否可以将对象清除: * YES * NO | -| RELATED | NUMBER | NO | 暂不支持该字段,默认为 NULL | -| BASE_OBJECT | NUMBER | NO | 暂不支持该字段,默认为 NULL | -| PURGE_OBJECT | NUMBER | NO | 暂不支持该字段,默认为 NULL | -| SPACE | NUMBER | NO | 暂不支持该字段,默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/97.DBA_DEPENDENCIES.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/97.DBA_DEPENDENCIES.md deleted file mode 100644 index 467df4a05..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/97.DBA_DEPENDENCIES.md +++ /dev/null @@ -1,41 +0,0 @@ -DBA_DEPENDENCIES -===================================== - - - -功能 ------------------------ - -`DBA_DEPENDENCIES` 视图用于展示数据库中各对象之间的所有依赖关系。目前仅支持展示 PL 对象之间的依赖关系。 - -相关视图 -------------------------- - -* `ALL_DEPENDENCIES` - - - -* `USER_DEPENDENCIES` - - - - - - -字段说明 -------------------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------------------|---------------|----------------|-------------------| -| OWNER | VARCHAR2(128) | NO | 依赖者 Owner 的名称 | -| NAME | VARCHAR2(128) | NO | 依赖者的名称 | -| TYPE | VARCHAR2(23) | NO | 依赖者的类型 | -| REFERENCED_OWNER | VARCHAR2(128) | NO | 被依赖者的 Owner 名称 | -| REFERENCED_NAME | VARCHAR2(128) | NO | 被依赖者的名称 | -| REFERENCED_TYPE | VARCHAR2(18) | NO | 被依赖者的类型 | -| REFERENCED_LINK_NAME | VARCHAR2(128) | NO | 被依赖者的 Dblink 名称 | -| DEPENDENCY_TYPE | VARCHAR2(4) | NO | 指示该依赖为强依赖或者其他依赖类型 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/98.DBA_RSRC_CONSUMER_GROUPS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/98.DBA_RSRC_CONSUMER_GROUPS.md deleted file mode 100644 index 2819dd69e..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/98.DBA_RSRC_CONSUMER_GROUPS.md +++ /dev/null @@ -1,38 +0,0 @@ -DBA_RSRC_CONSUMER_GROUPS -============================================= - - - -功能 ------------------------ - -`DBA_RSRC_CONSUMER_GROUPS` 视图用于展示数据库中所有资源组的信息。 - -相关视图 -------------------------- - -* `DBA_RSRC_GROUP_MAPPINGS` - - - - - - -字段说明 -------------------------- - - - -| 字段类型 | 类型 | 是否可以为 NULL | 描述 | -|-------------------|----------------|------------|--------------------------------------| -| CONSUMER_GROUP_ID | NUMBER(38) | NO | 资源组 ID。 | -| CONSUMER_GROUP | VARCHAR2(128) | NO | 用户绑定到的资源组的名称。 | -| CPU_METHOD | VARCHAR2(128) | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| MGMT_METHOD | VARCHAR2(128) | NO | 仅用于兼容,目前值固定为 `NULL`。 | -| INTERNAL_USE | VARCHAR2(3) | NO | 指示该资源组是否仅用于内部使用,仅用于兼容,目前值固定为 `NULL`。 | -| COMMENTS | VARCHAR2(2000) | YES | 对资源组的备注信息。 | -| CATEGORY | VARCHAR2(128) | NO | 资源组的类别,仅用于兼容,目前值固定为 `NULL`。 | -| STATUS | VARCHAR2(128) | NO | 资源组的状态,仅用于兼容,目前值固定为 `NULL`。 | -| MANDATORY | VARCHAR2(3) | NO | 指示该资源组是否为必填,仅用于兼容,目前值固定为 `NULL`。 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/99.DBA_RSRC_GROUP_MAPPINGS.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/99.DBA_RSRC_GROUP_MAPPINGS.md deleted file mode 100644 index e2dfed542..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/1.dictionary-view-1/99.DBA_RSRC_GROUP_MAPPINGS.md +++ /dev/null @@ -1,33 +0,0 @@ -DBA_RSRC_GROUP_MAPPINGS -============================================ - - - -功能 ------------------------ - -`DBA_RSRC_GROUP_MAPPINGS` 视图用于记录用户和资源组之间的绑定关系。 - -相关视图 -------------------------- - -* `DBA_RSRC_CONSUMER_GROUPS` - - - - - - -字段说明 -------------------------- - - - -| 字段类型 | 类型 | 是否可以为 NULL | 描述 | -|----------------|----------------|------------|-----------------------------------| -| ATTRIBUTE | VARCHAR2(128) | NO | 类别,当前版本仅支持 `ORACLE_USER`。 | -| VALUE | VARBINARY(128) | NO | 值,当类别为 `ORACLE_USER` 时,记录的是登录用户名。 | -| CONSUMER_GROUP | VARCHAR2(128) | YES | 用户绑定到的资源组的名称。 | -| STATUS | VARCHAR2(128) | NO | 资源组的状态,仅用于兼容,目前值固定为 `NULL`。 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/1.gv-lock-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/1.gv-lock-1.md deleted file mode 100644 index e5076683e..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/1.gv-lock-1.md +++ /dev/null @@ -1,31 +0,0 @@ -GV$LOCK -============================ - - - -功能 ------------ - -展示 OceanBase 数据库的行锁信息。 - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------|---------------|----------------|-------------------| -| SVR_IP | varchar(32) | NO | 服务器 IP | -| SVR_PORT | NUMBER(38) | NO | 服务器端口号 | -| TABLE_ID | NUMBER(38) | NO | 表 ID | -| ADDR | varchar(512) | NO | 被锁对象的地址 | -| KADDR | NUMBER(38) | NO | 锁地址 | -| SID | NUMBER(38) | NO | 会话持有的 ID | -| TYPE | NUMBER(38) | NO | 0(行锁) | -| LMODE | NUMBER(38) | NO | 0(写锁) | -| REQUEST | NUMBER | YES | Null | -| CTIME | NUMBER(38) | NO | 加锁耗时 | -| BLOCK | NUMBER(38) | NO | 最早被阻塞的 session_id | -| CON_ID | VARCHAR2(256) | NO | 租户 ID | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/10.gv-plan_cache_plan_explain-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/10.gv-plan_cache_plan_explain-1.md deleted file mode 100644 index c45dfc976..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/10.gv-plan_cache_plan_explain-1.md +++ /dev/null @@ -1,35 +0,0 @@ -GV$PLAN_CACHE_PLAN_EXPLAIN -=============================================== - - - -**功能** ---------------------------- - -该视图用于展示缓存在全部的 Server 中的计划缓存中的物理执行计划。 -**说明** - - - -该视图仅支持 get 操作,查询时需要指定 IP、PORT、TENANT_ID、PLAN_ID字段。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------|----------------|----------------|------------------| -| TENANT_ID | NUMBER(38) | NO | 租户 ID | -| SVR_IP | VARCHAR2(32) | NO | IP 地址 | -| SVR_PORT | NUMBER(38) | NO | 端口号 | -| PLAN_ID | NUMBER(38) | NO | 计划的 ID | -| PLAN_DEPTH | NUMBER(38) | NO | Operator 在展示时的深度 | -| PLAN_LINE_ID | NUMBER(38) | NO | Operator 的编号 | -| OPERATOR | VARCHAR2(128) | NO | Operator 的名称 | -| NAME | VARCHAR2(256) | NO | 表的名称 | -| ROWS | NUMBER(38) | NO | 预估的结果行数 | -| COST | NUMBER(38) | NO | 预估的代价 | -| PROPERTY | VARCHAR2(4096) | NO | 对应 Operator 的信息 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/11.gv-plan_cache_plan_stat-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/11.gv-plan_cache_plan_stat-1.md deleted file mode 100644 index 3e0eb02c5..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/11.gv-plan_cache_plan_stat-1.md +++ /dev/null @@ -1,81 +0,0 @@ -GV$PLAN_CACHE_PLAN_STAT -============================================ - - - -**功能** ---------------------------- - -该视图记录了当前租户在所有 Server 上的计划缓存中缓存的每一个缓存对象的状态。 -**注意** - - - -该表不仅缓存了 SQL 计划对象,也缓存了 PL 对象(如匿名块、PL Package以及PL Function),某些字段只在特定对象下有效。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-----------------------|-----------------------------------|----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| TENANT_ID | NUMBER(38) | NO | 租户 ID | -| SVR_IP | VARCHAR2(32) | NO | 机器的 IP | -| SVR_PORT | NUMBER(38) | NO | 机器端口号 | -| PLAN_ID | NUMBER(38) | NO | 缓存对象的 ID | -| SQL_ID | VARCHAR2(32) | NO | 缓存对象对应的 SQL ID,如果是 PL 对象,则该字段为 NULL | -| TYPE | NUMBER(38) | NO | 对于 SQL 计划的缓存,该字段表示计划的类型: * 1:表示本地计划 * 2:表示远程计划 * 3:表示分配计划 对于 PL 对象缓存,该字段表示PL对象的类型: * 1:表示程序 * 2:表示函数 * 3:表示包 * 4:表示匿名块 | -| DB_ID | NUMBER(38) | NO | 数据库的 ID | -| IS_BIND_SENSITIVE | NUMBER(38) | NO | 该计划是否需要打开 ACS | -| IS_BIND_AWARE | NUMBER(38) | NO | 该计划已经打开了 ACS | -| STATEMENT | VARCHAR2(65536) | NO | 对于 SQL 计划,该字段为参数化后的 SQL 语句;对于匿名块对象,该字段为参数化后的匿名块语句;其他对象该字段无效 | -| QUERY_SQL | VARCHAR2(65536) | NO | 对于 SQL 计划,字段为第一次加载计划时查询的原始 SQL 语句;对于匿名块字段,该字段为参数化后的匿名块语句 | -| SPECIAL_PARAMS | VARCHAR2(4096) | NO | 表示不可参数化的参数值 | -| PARAM_INFOS | VARCHAR2(65536) | NO | 表示参数化信息 | -| SYS_VARS | VARCHAR2(4096) | NO | 影响缓存对象的系统变量的值 | -| PLAN_HASH | NUMBER(38) | NO | SQL 计划的 Hash 值 | -| FIRST_LOAD_TIME | TIMESTAMP(6) WITH LOCAL TIME ZONE | NO | 第一次被加载时间 | -| SCHEMA_VERSION | NUMBER(38) | NO | Schema 版本号 | -| MERGED_VERSION | NUMBER(38) | NO | 当前缓存的计划对应的合并版本号 | -| LAST_ACTIVE_TIME | TIMESTAMP(6) WITH LOCAL TIME ZONE | NO | 上一次被执行时间 | -| AVG_EXE_USEC | NUMBER(38) | NO | 平均执行时间 | -| SLOWEST_EXE_TIME | TIMESTAMP(6) WITH LOCAL TIME ZONE | NO | 最慢执行时间戳 | -| SLOWEST_EXE_USEC | NUMBER(38) | NO | 最慢一次执行耗时 | -| SLOW_COUNT | NUMBER(38) | NO | 当前 SQL 计划成为慢查询的次数 | -| HIT_COUNT | NUMBER(38) | NO | 被命中次数 | -| PLAN_SIZE | NUMBER(38) | NO | 缓存对象占用的内存大小 | -| EXECUTIONS | NUMBER(38) | NO | 执行次数 | -| DISK_READS | NUMBER(38) | NO | 所有执行物理读的次数 | -| DIRECT_WRITES | NUMBER(38) | NO | 所有执行写盘的次数 | -| BUFFERS_GETS | NUMBER(38) | NO | 所有执行逻辑读的次数 | -| APPLICATION_WATI_TIME | NUMBER(38) | NO | 所有执行所有 application 类事件的总时间 | -| CONCURRENCY_WAIT_TIME | NUMBER(38) | NO | 所有执行所有 concurrency 类事件的总时间 | -| USER_IO_WAIT_TIME | NUMBER(38) | NO | 所有执行所有 user_io 类事件的总时间 | -| ROWS_PROCESSED | NUMBER(38) | NO | 所有执行选择的结果行数或执行更改表中的行数 | -| ELAPSED_TIME | NUMBER(38) | NO | 所有执行接收到请求到执行结束消耗时间 | -| CPU_TIME | NUMBER(38) | NO | 所有执行消耗的 CPU 时间 | -| LARGE_QUERYS | NUMBER(38) | NO | 被判断为大查询的次数 | -| DELAYED_LARGE_QUERYS | NUMBER(38) | NO | 被判断为大查询且被丢入大查询队列的次数 | -| DELAYED_PX_QUERYS | NUMBER(38) | NO | 并行查询被丢回队列重试的次数 | -| OUTLINE_VERSION | NUMBER(38) | NO | Outline 版本号 | -| OUTLINE_ID | NUMBER(38) | NO | Outline 的 ID,为 -1 表示不是通过绑定 Outline 生成的计划 | -| OUTLINE_DATA | VARCHAR2(65536) | NO | 计划对应的 Outline 信息 | -| HINTS_INFO | VARCHAR2(65536) | NO | SQL 计划的 Hint 信息 | -| HINTS_ALL_WORKED | NUMBER(38) | NO | SQL 计划中的 Hint 是否都已经生效 | -| ACS_SEL_INFO | VARCHAR2(65536) | NO | 当前 ACS 计划对应的选择率空间 | -| TABLE_SCAN | NUMBER(38) | NO | 表示该查询是否为主键扫描 | -| EVOLUTION | NUMBER(38) | NO | 表示该执行计划是否在演进中 | -| EVO_EXECUTIONS | NUMBER(38) | NO | 演进次数 | -| EVO_CPU_TIME | NUMBER(38) | NO | 演进过程中总的执行 CPU 时间 | -| TIMEOUT_COUNT | NUMBER(38) | NO | 超时次数 | -| PS_STMT_ID | NUMBER(38) | NO | prepare statement 的 ID | -| SESSID | NUMBER(38) | NO | 缓存对象所在的 Session ID | -| TEMP_TABLES | VARCHAR2(65536) | NO | SQL 计划中包含的临时表表名,如果没有临时表,字段为空 | -| IS_USE_JIT | NUMBER(38) | NO | SQL 计划是否开启了表达式编译执行 | -| OBJECT_TYPE | VARCHAR2(65536) | NO | 缓存对象的类型: * SQL_PLAN * PROCEDURE * FUNCTION * PACKAGE * ANONYMOUS | -| PL_SCHEMA_ID | NUMBER(38) | NO | 对于非匿名块的 PL 对象,字段为缓存对象的 Schema ID;对于匿名块,字段与 ps_stmt_id 相同;对于 SQL 计划,该字段无意义 | -| IS_BATCHED_MULTI_STMT | NUMBER(38) | NO | 表示是否为 batched multistmt 优化的计划 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/12.gv-plan_cache_stat-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/12.gv-plan_cache_stat-1.md deleted file mode 100644 index f8e1f7239..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/12.gv-plan_cache_stat-1.md +++ /dev/null @@ -1,31 +0,0 @@ -GV$PLAN_CACHE_STAT -======================================= - - - -功能 ------------------------ - -该视图记录当前租户在所有 Server 上的每个计划缓存整体的状态。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------|--------------|----------------|-----------------------------------| -| SVR_IP | VARCHAR2(32) | NO | 服务器的 IP 地址 | -| SVR_PORT | NUMBER(38) | NO | 端口号 | -| SQL_NUM | NUMBER(38) | NO | plan_cache 涉及 SQL 条数 | -| MEM_USED | NUMBER(38) | NO | plan_cache 已经使用的内存 | -| MEM_HOLD | NUMBER(38) | NO | plan_cache 持有的内存 | -| ACCESS_COUNT | NUMBER(38) | NO | 进行 plan_cache 的次数 | -| HIT_COUNT | NUMBER(38) | NO | 命中 plan_cache 的次数 | -| HIT_RATE | NUMBER(38) | NO | plan_cache 的命中率 | -| PLAN_NUM | NUMBER(38) | NO | plan 的个数 | -| MEM_LIMIT | NUMBER(38) | NO | plan_cache 的内存上限 | -| HASH_BUCKET | NUMBER(38) | NO | plan_cache hash map 中的 Bucket 的个数 | -| STMTKEY_NUM | NUMBER(38) | NO | plan_cache 中 stmt_key 的个数 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/13.gv-ps_item_info-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/13.gv-ps_item_info-1.md deleted file mode 100644 index 9da74f7c0..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/13.gv-ps_item_info-1.md +++ /dev/null @@ -1,30 +0,0 @@ -GV$PS_ITEM_INFO -==================================== - - - -**功能** ---------------------------- - -用于给 prepared statement 提供监控功能,包含 PS Cache 中所有 prepare statement 的基本信息。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|---------------------|-----------------|----------------|----------------------------| -| SVR_IP | VARCHAR2(32) | NO | 机器 IP | -| SVR_PORT | NUMBER(38) | NO | 机器端口号 | -| STMT_ID | NUMBER(38) | NO | ps cache 中对应语句的 stmt_id 信息 | -| DB_ID | NUMBER(38) | NO | prepare 语句涉及到的数据库 ID | -| PS_SQL | VARCHAR2(65536) | NO | prepare 的 SQL 信息 | -| PARAM_COUNT | NUMBER(38) | NO | prepare 的参数个数信息 | -| STMT_ITEM_REF_COUNT | NUMBER(38) | NO | stmt_item 的引用计数信息 | -| STMT_INFO_REF_COUNT | NUMBER(38) | NO | stmt_info 的引用计数信息 | -| MEM_HOLD | NUMBER(38) | NO | 该 prepare stmt 占用的内存大小 | -| STMT_TYPE | NUMBER(38) | NO | 该 prepare stmt 的类型信息 | -| CHECKSUM | NUMBER(38) | NO | 该 prepare stmt 的 checksum | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/14.gv-ps_stat-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/14.gv-ps_stat-1.md deleted file mode 100644 index 0bcb4eb77..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/14.gv-ps_stat-1.md +++ /dev/null @@ -1,25 +0,0 @@ -GV$PS_STAT -=============================== - - - -**功能** ---------------------------- - -监控 PS Cache 的整体状态,包括命中率、内存占用、缓存的 Item 数目。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------|--------------|----------------|---------------------| -| SVR_IP | VARCHAR2(32) | NO | 服务器的 IP | -| SVR_PORT | NUMBER(38) | NO | 服务器的端口号 | -| STMT_COUNT | NUMBER(38) | NO | PS Cache 中目前缓存了多少语句 | -| HIT_COUNT | NUMBER(38) | NO | PS Cache 总的命中次数 | -| ACCESS_COUNT | NUMBER(38) | NO | 访问 PS Cache 的总次数 | -| MEM_HOLD | NUMBER(38) | NO | PS Cache 占用了多少内存 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/15.gv-server_memstore-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/15.gv-server_memstore-1.md deleted file mode 100644 index 5b77d4faf..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/15.gv-server_memstore-1.md +++ /dev/null @@ -1,25 +0,0 @@ -GV$SERVER_MEMSTORE -======================================= - - - -**功能** ---------------------------- - -该视图用于展示当前服务器上 Memtable 的汇总占用信息。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------------|--------------|----------------|----------------------| -| SVR_IP | VARCHAR2(32) | NO | 服务器 IP | -| SVR_PORT | NUMBER(38) | NO | 服务器端口 | -| ACTIVE | NUMBER(38) | NO | 当前活跃 Memstore 所占内存 | -| TOTAL | NUMBER(38) | NO | 所有的 Memtable 的内存总大小 | -| FREEZE_TRIGGER | NUMBER(38) | NO | 触发 Memtable 冻结的内存总大小 | -| MEM_LIMIT | NUMBER(38) | NO | Memtable 的内存总限制 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/16.gv-session_wait-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/16.gv-session_wait-1.md deleted file mode 100644 index c32c50b82..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/16.gv-session_wait-1.md +++ /dev/null @@ -1,37 +0,0 @@ -GV$SESSION_WAIT -==================================== - - - -**功能** ---------------------------- - -该视图用于展示所有服务器上所有 Session 的当前或者上一次等待事件的一些信息,包括等待事件名称、等待耗时等。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | 是否可以为 NULL | **描述** | -|----------------------------|--------------|------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| SID | NUMBER(38) | NO | Session ID | -| CON_ID | NUMBER(38) | NO | 租户 ID | -| SVR_IP | VARCHAR2(32) | NO | 服务器的 IP | -| SVR_PORT | NUMBER(38) | NO | 服务器端口 | -| EVENT | VARCHAR2(64) | NO | 等待事件名称 | -| P1TEXT | VARCHAR2(64) | NO | 等待事件的第 1 个参数的描述 | -| P1 | NUMBER(38) | NO | 等待事件的第 1 个参数的值 | -| P2TEXT | VARCHAR2(64) | NO | 等待事件的第 2 个参数的描述 | -| P2 | NUMBER(38) | NO | 等待事件的第 2 个参数的值 | -| P3TEXT | VARCHAR2(64) | NO | 等待事件的第 3 个参数的描述 | -| P3 | NUMBER(38) | NO | 等待事件的第 3 个参数的值 | -| WAIT_CLASS_ID | NUMBER(38) | NO | 等待事件的类别 ID | -| WAIT_CLASS# | NUMBER(38) | NO | 等待事件的类别序号 | -| WAIT_CLASS | VARCHAR2(64) | NO | 等待事件的类别名称 | -| STATE | VARCHAR2(19) | NO | 当前等待事件的状态,包含四种状态: * Waiting:Session 正等待这个事件。 * Waited unknown time:由于设置了 timed_statistics 值为 false,导致不能得到时间信息。表示发生了等待,但时间很短 * Wait short time:表示发生了等待,但由于时间非常短不超过一个时间单位,所以没有记录 * Waited knnow time:如果 Session 等待然后得到了所需资源,那么将从 waiting 进入本状态 | -| WAIT_TIME_MICRO | NUMBER(38) | NO | 等待时间,单位为微秒。如果当前正在等待,表示已经等待的时长;如果当前没有等待,表示最后一次等待的总等待时长 | -| TIME_REMAINING_MICRO | NUMBER(38) | NO | * \> 0:表示最后一次等待时间,单位:毫秒,当前未在等待状态 * 0:Session 正在等待当前的事件 * -1:最后一次等待时间小于 1 个统计单位,当前未在等待状态 * -2:时间统计状态未置为可用,当前未在等待状态 | -| TIME_SINCE_LAST_WAIT_MICRO | NUMBER(38) | NO | 上一次等待结束到现在的时间,单位为毫秒,如果当前正在等待,其值为 0。 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/17.gv-session_wait_history-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/17.gv-session_wait_history-1.md deleted file mode 100644 index f9d3e3de3..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/17.gv-session_wait_history-1.md +++ /dev/null @@ -1,36 +0,0 @@ -GV$SESSION_WAIT_HISTORY -============================================ - - - -**功能** ---------------------------- - -该视图用于展示所有服务器上所有 Session 的最近 10 次等待事件的信息。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------------------------|--------------|----------------|------------------------| -| SID | NUMBER(38) | NO | Session ID | -| CON_ID | NUMBER(38) | NO | 租户 ID | -| SVR_IP | VARCHAR2(32) | NO | 服务器的 IP 地址 | -| SVR_PORT | NUMBER(38) | NO | 服务器端口 | -| SEQ# | NUMBER(38) | NO | 等待事件序列号 | -| EVENT# | NUMBER(38) | NO | 等待事件编号 | -| EVENT | VARCHAR2(64) | NO | 等待事件名称 | -| P1TEXT | VARCHAR2(64) | NO | 等待事件的第 1 个参数的描述 | -| P1 | NUMBER(38) | NO | 等待事件的第 1 个参数的值 | -| P2TEXT | VARCHAR2(64) | NO | 等待事件的第 2 个参数的描述 | -| P2 | NUMBER(38) | NO | 等待事件的第 2 个参数的值 | -| P3TEXT | VARCHAR2(64) | NO | 等待事件的第 3 个参数的描述 | -| P3 | NUMBER(38) | NO | 等待事件的第 3 个参数的值 | -| WAIT_TIME_MICRO | NUMBER(38) | NO | 等待事件的等待时间,单位为毫秒 | -| TIME_SINCE_LAST_WAIT_MICRO | NUMBER(38) | NO | 自上一次等待结束到当前等待的时间,单位为毫秒 | -| WAIT_TIME | NUMBER(38) | NO | 等待事件的等待时间,单位为百分之一秒 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/18.gv-sesstat-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/18.gv-sesstat-1.md deleted file mode 100644 index 6fedb648f..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/18.gv-sesstat-1.md +++ /dev/null @@ -1,25 +0,0 @@ -GV$SESSTAT -=============================== - - - -**功能** ---------------------------- - -该视图用于展示所有服务器上的 Session 级别的一些统计信息,其中, STATISTIC# 表示统计项编号,可以从 V$STATNAME 中查询到对应统计项编号的统计项名称及其含义。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|------------|--------------|----------------|------------| -| SID | NUMBER(38) | NO | Session 号 | -| CON_ID | NUMBER(38) | NO | 租户 ID | -| SVR_IP | VARCHAR2(32) | NO | 服务器的 IP 地址 | -| SVR_PORT | NUMBER(38) | NO | 服务器端口号 | -| STATISTIC# | NUMBER(38) | NO | 统计项编号 | -| VALUE | NUMBER(38) | NO | 统计项值 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/19.gv-sql_audit-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/19.gv-sql_audit-1.md deleted file mode 100644 index 6e14caa70..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/19.gv-sql_audit-1.md +++ /dev/null @@ -1,99 +0,0 @@ -GV$SQL_AUDIT -================================= - - - -**功能** ---------------------------- - -该视图用于展示所有 Server 上每一次 SQL 请求的来源、执行状态等统计信息。该视图是按照租户拆分的,除了系统租户,其他租户不能跨租户查询。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-------------------------|-----------------|----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| SVR_IP | VARCHAR2(32) | NO | IP 地址 | -| SVR_PORT | NUMBER(38) | NO | 端口号 | -| REQUEST_ID | NUMBER(38) | NO | 请求的 ID 号 | -| SQL_EXEC_ID | NUMBER(38) | NO | 本次执行的 ID | -| TRACE_ID | VARCHAR2(128) | NO | 该语句的 trace_id | -| SID | NUMBER(38) | NO | Session 连接 ID | -| CLIENT_IP | VARCHAR2(32) | NO | 发送请求的客户端 IP | -| CLIENT_PORT | NUMBER(38) | NO | 发送请求的客户端端口号 | -| TENANT_ID | NUMBER(38) | NO | 发送请求的租户 ID | -| EFFECTIVE_TENANT_ID | NUMBER(38) | NO | 租户 ID | -| TENANT_NAME | VARCHAR2(64) | NO | 发送请求的租户名称 | -| USER_ID | NUMBER(38) | NO | 发送请求的用户 ID | -| USER_NAME | VARCHAR2(64) | NO | 发送请求的用户名称 | -| USER_CLIENT_IP | VARCHAR2(32) | NO | 发送请求的客户端 IP | -| DB_ID | NUMBER(38) | NO | 数据库 ID | -| DB_NAME | VARCHAR2(128) | NO | 数据库名称 | -| SQL_ID | VARCHAR2(32) | NO | 该 SQL 的 ID | -| QUERY_SQL | VARCHAR2(65536) | NO | 实际的 SQL 语句 | -| PLAN_ID | NUMBER(38) | NO | 执行计划 ID | -| AFFECTED_ROWS | NUMBER(38) | NO | 影响行数 | -| RETURN_ROWS | NUMBER(38) | NO | 返回行数 | -| PARTITION_CNT | NUMBER(38) | NO | 该请求涉及的分区数 | -| RET_CODE | NUMBER(38) | NO | 执行结果返回码 | -| QC_ID | NUMBER(38) | NO | 并行执行场景下,调度器 ID | -| DFO_ID | NUMBER(38) | NO | 并行执行场景下,当前执行的子计划 ID | -| SQC_ID | NUMBER(38) | NO | 并行执行场景下,本地协调器 ID | -| WORKER_ID | NUMBER(38) | NO | 并行执行场景下,工作线程 ID | -| EVENT | VARCHAR2(64) | NO | 最长等待事件名称 | -| P1TEXT | VARCHAR2(64) | NO | 等待事件参数 1 | -| P1 | NUMBER(38) | NO | 等待事件参数 1 的值 | -| P2TEXT | VARCHAR2(64) | NO | 等待事件参数 2 | -| P2 | NUMBER(38) | NO | 等待事件参数 2 的值 | -| P3TEXT | VARCHAR2(64) | NO | 等待事件参数 3 | -| P3 | NUMBER(38) | NO | 等待事件参数 3 的值 | -| LEVEL | NUMBER(38) | NO | 等待事件的级别 | -| WAIT_CLASS_ID | NUMBER(38) | NO | 等待事件所属的 Class ID | -| WAIT_CLASS# | NUMBER(38) | NO | 等待事件所属的 Class 的下标 | -| WAIT_CLASS | VARCHAR2(64) | NO | 等待事件所属的 Class 名称 | -| STATE | VARCHAR2(19) | NO | 等待事件的状态 | -| WAIT_TIME_MICRO | NUMBER(38) | NO | 该等待事件所等待的时间,单位:微秒 | -| TOTAL_WAIT_TIME_MICRO | NUMBER(38) | NO | 执行过程所有等待的总时间,单位:微秒 | -| TOTAL_WAITS | NUMBER(38) | NO | 执行过程总等待的次数 | -| RPC_COUNT | NUMBER(38) | NO | 发送 RPC 个数 | -| PLAN_TYPE | NUMBER(38) | NO | 执行计划类型: * local * remote * distribute | -| IS_INNER_SQL | NUMBER(38) | NO | 是否为内部 SQL 请求 | -| IS_EXECUTOR_RPC | NUMBER(38) | NO | 当前请求是否为 RPC 请求 | -| IS_HIT_PLAN | NUMBER(38) | NO | 是否命中 plan_cache | -| REQUEST_TIME | NUMBER(38) | NO | 开始执行时间点 | -| ELAPSED_TIME | NUMBER(38) | NO | 接收到请求到执行结束所消耗的总时间 | -| NET_TIME | NUMBER(38) | NO | 发送 RPC 到接收到请求的时间 | -| NET_WAIT_TIME | NUMBER(38) | NO | 接收到请求到进入队列的时间 | -| QUEUE_TIME | NUMBER(38) | NO | 请求在队列的等待时间 | -| DECODE_TIME | NUMBER(38) | NO | 出队列后 Decode 的时间 | -| GET_PLAN_TIME | NUMBER(38) | NO | 开始 Process 到获得计划的时间 | -| EXECUTE_TIME | NUMBER(38) | NO | 计划执行所消耗的时间 | -| APPLICATION_WAIT_TIME | NUMBER(38) | NO | 所有 application 类事件的总时间 | -| CONCURRENCY_WAIT_TIME | NUMBER(38) | NO | 所有 Concurrency 类事件的总时间 | -| USER_IO_WAIT_TIME | NUMBER(38) | NO | 所有 user_io 类事件的总时间 | -| SCHEDULE_TIME | NUMBER(38) | NO | 所有 Schedule 类事件的时间 | -| ROW_CACHE_HIT | NUMBER(38) | NO | 行缓存命中次数 | -| BLOOM_FILTER_CACHE_HIT | NUMBER(38) | NO | Bloom Filter 缓存命中次数 | -| BLOCK_CACHE_HIT | NUMBER(38) | NO | 块缓存命中次数 | -| BLOCK_INDEX_CACHE_HIT | NUMBER(38) | NO | 块索引缓存命中次数 | -| DISK_READS | NUMBER(38) | NO | 物理读次数 | -| RETRY_CNT | NUMBER(38) | NO | 重试次数 | -| TABLE_SCAN | NUMBER(38) | NO | 判断该请求是否含全表扫描 | -| CONSISTENCY_LEVEL | NUMBER(38) | NO | 一致性级别 | -| MEMSTORE_READ_ROW_COUNT | NUMBER(38) | NO | Memstore 中的读行数 | -| SSSTORE_READ_ROW_COUNT' | NUMBER(38) | NO | Ssstore 中连读的行数 | -| REQUEST_MEMORY_USED | NUMBER(38) | NO | 该请求消耗的内存 | -| EXPECT_WORKER_COUNT | NUMBER(38) | NO | 请求期望的工作线程数 | -| USED_WORKER_COUNT | NUMBER(38) | NO | 请求实际使用的工作线程数 | -| SCHED_INFO | VARCHAR2(16384) | YES | 请求的调度信息 | -| PS_STMT_ID | NUMBER(38) | NO | 请求对应的 Prepare ID | -| TRANSACTION_HASH | NUMBER(38) | NO | 请求对应的事务的 Hash 值 | -| REQUEST_TYPE | NUMBER(38) | NO | 请求对应的类型: * 0:表示非法 * 1:表示是一个内部请求 * 2:表示是一个本地请求,例如,Local 计划 * 3:表示远程请求 * 4:表示分布式请求 * 5:表示 SQL 的 Prepare 请求 * 6:表示 SQL 得到 execute stmt 请求 | -| IS_BATCHED_MULTI_STMT | NUMBER(38) | NO | 是否进行 batch multi stmt 的优化 | -| OB_TRACE_INFO | VARCHAR2(4096) | NO | 用户设置的 Trace 信息 | -| PLAN_HASH | NUMBER(38) | NO | 执行计划的 Hash 值 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/2.gv-global_transaction.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/2.gv-global_transaction.md deleted file mode 100644 index 6004bbb81..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/2.gv-global_transaction.md +++ /dev/null @@ -1,32 +0,0 @@ -GV$GLOBAL_TRANSACTION -========================================== - - - -功能 ------------ - -该视图用于展示所有服务器上当前活跃的全局事务(主要包括 XA 事务)的信息。 - -字段说明 -------------- - - - -| **字段** | **类型** | **是否可以为NULL** | **说明** | -|--------------|--------------|---------------|--------------------------------------------| -| SVR_IP | RAW(64) | NO | 服务器 IP | -| SVR_PORT | NUMBER | NO | 服务器端口号 | -| FORMATID | NUMBER | NO | 全局事务格式标识符 | -| GLOBALID | RAW(64) | NO | 全局事务事务标识符 | -| BRANCHID | RAW(64) | NO | 全局事务分支限定符 | -| BRANCHES | NUMBER | NO | 该全局事务中分支总数 | -| REFCOUNT | NUMBER | NO | 该全局事务中分支总数 | -| PREPARECOUNT | NUMBER | NO | 该全局事务中已 PREPARED 的分支总数 | -| STATE | VARCHAR2(38) | NO | 该分支的状态 | -| FLAGS | NUMBER | NO | 该分支状态的数字表示 | -| COUPLING | VARCHAR2(15) | NO | 分支间的关系(TIGHTLY COUPLED 或者 LOOSELY COUPLED) | -| CON_ID | NUMBER | NO | 租户 ID | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/20.gv-sql_workarea-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/20.gv-sql_workarea-1.md deleted file mode 100644 index 1f76a193e..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/20.gv-sql_workarea-1.md +++ /dev/null @@ -1,43 +0,0 @@ -GV$SQL_WORKAREA -==================================== - - - -**功能** ---------------------------- - -之前受 SQL 自动内存管理负责执行的所有 Operator 的 workarea 统计信息。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|------------------------|--------------|----------------|---------------------------------------------------------------------------------------------------------------------------------------| -| ADDRESS | RAW(8) | NO | SQL 对应的 Handle 地址。目前暂不支持该字段,当前该字段默认为 NULL | -| HASH_VALUE | NUMBER | NO | 语句的 Hash Value 的值。目前暂不支持该字段,当前该字段默认为 NULL | -| SQL_ID | VARCHAR2(32) | NO | SQL 语句的 SQL 唯一标示 | -| CHILD_NUMBER | NUMBER | NO | 该 Cursor 的数量。目前暂不支持该字段,当前该字段默认为 NULL | -| WORKAREA_ADDRESS | RAW(8) | NO | workarea 的地址。目前暂不支持该字段,当前该字段默认为 NULL | -| OPERATION_TYPE | VARCHAR2(40) | NO | workarea 的操作符类型,例如 Sort、Hash Join、Group by等 | -| OPERATION_ID | NUMBER(38) | NO | 计划树中识别操作符的唯一标识 | -| POLICY | VARCHAR2(10) | NO | workarea 的策略: * MANUAL * AUTO | -| ESTIMATED_OPTIMAL_SIZE | NUMBER(38) | NO | 在最优情况下执行操作符的估算内存大小,单位:bytes | -| ESTIMATED_ONEPASS_SIZE | NUMBER(38) | NO | 在 one pass 场景下,执行操作符估算内存大小,单位:bytes | -| LAST_MEMORY_USED | NUMBER(38) | NO | 游标在上次执行使用的内存大小,单位:bytes | -| LAST_EXECUTION | VARCHAR2(10) | NO | 上次执行时 workarea 选择的是 optimal、one pass 还是 multi passes | -| LAST_DEGREE | NUMBER(38) | NO | 上次执行并行度 | -| TOTAL_EXECUTIONS | NUMBER(38) | NO | 总共执行使用 workarea 的次数 | -| OPTIMAL_EXECUTIONS | NUMBER(38) | NO | 最优场景下执行的次数 | -| ONEPASS_EXECUTIONS | NUMBER(38) | NO | one pass 场景执行的次数 | -| MULTIPASSES_EXECUTIONS | NUMBER(38) | NO | multi passes 场景执行的次数 | -| ACTIVE_TIME | NUMBER(38) | NO | workarea 活跃时的平均时间,单位:s | -| MAX_TEMPSEG_SIZE | NUMBER(38) | NO | work area 使用时最大的临时磁盘空间,单位:bytes;如果是 NULL,则表示未使用临时空间 | -| LAST_TEMPSEG_SIZE | NUMBER(38) | NO | workarea 上次执行时使用的临时磁盘空间;如果是 NULL,表示未使用临时空间 | -| CON_ID | NUMBER(38) | NO | 租户 ID | - - - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/21.gv-sql_workarea_active.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/21.gv-sql_workarea_active.md deleted file mode 100644 index 3a004b006..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/21.gv-sql_workarea_active.md +++ /dev/null @@ -1,42 +0,0 @@ -GV$SQL_WORKAREA_ACTIVE -=========================================== - - - -**功能** ---------------------------- - -当前活跃 Operator 的 workarea 信息。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|------------------|--------------|----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| SQL_HASH_VALUE | NUMBER | NO | 被执行语句的 Hash 值。目前暂不支持该字段,当前该字段默认为 NULL | -| SQL_ID | VARCHAR2(32) | NO | SQL 语句的 SQL 唯一标示 | -| SQL_EXEC_START | DATE | NO | SQL 开始执行时间。目前暂不支持该字段,当前该字段默认为 NULL | -| SQL_EXEC_ID | NUMBER(38) | NO | SQL 执行唯一标示 | -| WORKAREA_ADDRESS | RAW(8) | NO | workarea 地址。目前暂不支持该字段,当前该字段默认为 NULL | -| OPERATION_TYPE | VARCHAR2(40) | NO | workarea 操作符类型,例如 Sort、Hash Join、Group by 等 | -| OPERATION_ID | NUMBER(38) | NO | 计划树中识别操作符的唯一标示 | -| POLICY | VARCHAR2(6) | NO | workarea 的策略: * MANUAL * AUTO | -| SID | NUMBER(38) | NO | Session 的唯一标示 | -| QCINST_ID | NUMBER | NO | 查询协调者的实例 ID。目前暂不支持该字段,当前该字段默认为 NULL | -| QCSID | NUMBER | NO | 查询协调者 Session 标示 ID。目前暂不支持该字段,当前该字段默认为 NULL | -| ACTIVE_TIME | NUMBER(38) | NO | workarea 活跃时平均时间,单位:ms | -| WORK_AREA_SIZE | NUMBER | NO | 操作符使用 workarea 最大大小,单位:bytes | -| EXPECT_SIZE | NUMBER(38) | NO | workarea 期望的大小,单位:bytes | -| ACTUAL_MEM_USED | NUMBER(38) | NO | 申请 workarea 的内存量,单位:bytes | -| MAX_MEM_USED | NUMBER(38) | NO | 使用 workarea 最大的内存使用量,单位:bytes | -| NUMBER_PASSES | NUMBER(38) | NO | workarea 在哪个模式下下运行: * 0:optimal 模式 * 1:one pass 模式 * \>=2:multi pass 模式 | -| TEMPSEG_SIZE | NUMBER(38) | NO | workarea 使用的临时空间大小,单位:bytes;如果为 NULL 则表示没有发生写临时文件 | -| TABLESPACE | VARCHAR2(20) | NO | 写临时文件的表命名空间;如果为 NULL,表示没有发生写临时文件。目前暂不支持该字段,当前该字段默认为 NULL | -| SEGRFNO# | NUMBER | NO | 写临时文件相关的文件数量;NULL 表示没有发生写临时文件。目前暂不支持该字段,当前该字段默认为 NULL | -| SEGBLK# | NUMBER | NO | workarea 创建临时文件的 block 数量;NULL 表示没有发生写临时文件。目前暂不支持该字段,当前该字段默认为 NULL | -| CON_ID | NUMBER(38) | NO | 租户 ID | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/22.gv-sql_workarea_histogram-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/22.gv-sql_workarea_histogram-1.md deleted file mode 100644 index 6c38204ef..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/22.gv-sql_workarea_histogram-1.md +++ /dev/null @@ -1,26 +0,0 @@ -GV$SQL_WORKAREA_HISTOGRAM -============================================== - - - -**功能** ---------------------------- - -展示之前所有 work area 执行的统计信息,例如在区间 1M~2M 之间全 in-memory 处理的次数、one-pass 次数等。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|------------------------|------------|----------------|------------------------------------------| -| LOW_OPTIMAL_SIZE | NUMBER(38) | NO | workarea 在 optimal 模式下最低内存量 | -| HIGH_OPTIMAL_SIZE | NUMBER(38) | NO | workarea 在 optimal 模式下最高内存量 | -| OPTIMAL_EXECUTIONS | NUMBER(38) | NO | workarea 在最低和最高区间的最优模式下执行的次数 | -| ONEPASS_EXECUTIONS | NUMBER(38) | NO | workarea 在最低和最高区间的 one pass 模式下执行的次数 | -| MULTIPASSES_EXECUTIONS | NUMBER(38) | NO | workarea 在最低和最高区间的 multi passes 模式下执行的次数 | -| TOTAL_EXECUTIONS | NUMBER(38) | NO | workarea 总共执行的次数 | -| CON_ID | NUMBER(38) | NO | 租户 ID | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/23.gv-sysstat-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/23.gv-sysstat-1.md deleted file mode 100644 index 89acb6d7a..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/23.gv-sysstat-1.md +++ /dev/null @@ -1,40 +0,0 @@ -GV$SYSSTAT -=============================== - - - -**功能** ---------------------------- - -该视图用于展示所有服务器上系统级别的一些统计信息。 - -其中: - -* STATISTIC# 表示统计项编号,同一统计项的编号在不同 OBServer 版本中可能会发生变化。 - - - -* STAT_ID 表示统计项 ID,同一统计项的 ID 在不同 OBServer 版本中保证相同。 - - - - - - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|------------|--------------|----------------|--------| -| CON_ID | NUMBER(38) | NO | 租户 ID | -| SVR_IP | VARCHAR2(32) | NO | 服务器 IP | -| SVR_PORT | NUMBER(38) | NO | 服务器端口号 | -| STATISTIC# | NUMBER(38) | NO | 统计项编号 | -| VALUE | NUMBER(38) | NO | 统计项值 | -| STAT_ID | NUMBER(38) | NO | 统计项 ID | -| NAME | VARCHAR2(64) | NO | 统计项名称 | -| CLASS | NUMBER(38) | NO | 统计项类别 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/24.gv-system_event-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/24.gv-system_event-1.md deleted file mode 100644 index e55845cb0..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/24.gv-system_event-1.md +++ /dev/null @@ -1,32 +0,0 @@ -GV$SYSTEM_EVENT -==================================== - - - -**功能** ---------------------------- - -该视图用于展示所有服务器上租户系统级别的一些等待事件,统计每一类等待事件的发生次数、等待时间、超时次数等。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-------------------|--------------|----------------|-----------------| -| CON_ID | NUMBER(38) | NO | 租户 ID | -| SVR_IP | VARCHAR2(32) | NO | 服务器 IP 地址 | -| SVR_PORT | NUMBER(38) | NO | 服务器端口号 | -| EVENT_ID | NUMBER(38) | NO | 等待事件 ID | -| EVENT | VARCHAR2(64) | NO | 等待事件名称 | -| WAIT_CLASS_ID | NUMBER(38) | NO | 等待事件类别 ID | -| WAIT_CLASS# | NUMBER(38) | NO | 等待事件类别编号 | -| WAIT_CLASS | VARCHAR2(64) | NO | 得到事件类别名称 | -| TOTAL_WAITS | NUMBER(38) | NO | 总等待次数 | -| TOTAL_TIMEOUTS | NUMBER(38) | NO | 等待超时次数 | -| TIME_WAITED | NUMBER(38) | NO | 总等待时间,单位为百分之一秒 | -| AVERAGE_WAIT | NUMBER(38) | NO | 平均等待时间,单位为百分之一秒 | -| TIME_WAITED_MICRO | NUMBER(38) | NO | 总等待时间,单位为微秒 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/25.gv-global_transaction-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/25.gv-global_transaction-1.md deleted file mode 100644 index ddc0835c6..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/25.gv-global_transaction-1.md +++ /dev/null @@ -1,32 +0,0 @@ -GV$GLOBAL_TRANSACTION -========================================== - - - -**功能** ---------------------------- - -显示当前活跃的全局事务的信息。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------|----------------|----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| FORMATID | NUMBER(38) | NO | 全局事务的格式标识符 | -| SVR_IP | VARCHAR2(128) | NO | 服务器 IP | -| SVR_PORT | NUMBER(38) | NO | 服务器端口号 | -| GLOBALID | VARCHAR2(256 ) | NO | 全局事务的标识符 | -| BRANCHID | VARCHAR2(256 ) | NO | 全局事务的分支资格 | -| BRANCHES | NUMBER(38) | NO | 全局事务中的分支机构总数 | -| REFCOUNT | NUMBER(38) | NO | 全局事务的同级数,必须与分支机构相同 | -| PREPARECOUNT | NUMBER | NO | 已准备的全局事务分支机构数 | -| STATE | CHAR(6) | NO | 全局事务分支的状态: * ACTIVE * COLLECTING * FINALIZED * FAILED * RECOVERING * UNASSOCIATED * FORGOTTEN * READY FOR RECOVERY * NO-READONLY FAILED * SIBLING INFO WRITTEN * \[ORACLE COORDINATED\]ACTIVE * \[ORACLE COORDINATED\]COLLECTING * \[ORACLE COORDINATED\]FINALIZED * \[ORACLE COORDINATED\]FAILED * \[ORACLE COORDINATED\]RECOVERING * \[ORACLE COORDINATED\]UNASSOCIATED * \[ORACLE COORDINATED\]FORGOTTEN * \[ORACLE COORDINATED\]READY FOR RECOVERY * \[ORACLE COORDINATED\]NO-READONLY FAILED * \[MULTINODE\]ACTIVE * \[MULTINODE\]COLLECTING * \[MULTINODE\]FINALIZED * \[MULTINODE\]FAILED * \[MULTINODE\]RECOVERING * \[MULTINODE\]UNASSOCIATED * \[MULTINODE\]FORGOTTEN * \[MULTINODE\]READY FOR RECOVERY * \[MULTINODE\]NO-READONLY FAILED * \[MULTINODE\]SIBLING INFO WRITTEN * COMBINATION | -| FLAGS | NUMBER | NO | 状态的数字表示 | -| COUPLING | CHAR(15) | NO | 表示分支是自由(FREE),松散耦合(LOOSELY COUPLED)还是紧密耦合(TIGHTLY COUPLED) | -| CON_ID | VARCHAR2(256) | NO | 租户 ID | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/26.gv-open_cursor.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/26.gv-open_cursor.md deleted file mode 100644 index fd0b98bb4..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/26.gv-open_cursor.md +++ /dev/null @@ -1,30 +0,0 @@ -GV$OPEN_CURSOR -=================================== - - - -功能 ------------------------ - -`GV$OPEN_CURSOR` 视图用于展示被缓存在 Plan Cache 中的执行计划的信息。 - -字段说明 -------------------------- - - - -| 字段名称 | 类型 | 是否可以为 NULL | 描述 | -|----------------------|--------------|------------|------------------------------------------------| -| SVR_IP | VARCHAR2(46) | NO | 本机的 IP 地址 | -| SVR_PORT | NUMBER(38) | NO | 本机的端口号 | -| SADDR | VARCHAR2(8) | NO | Session 所在的内存地址。 | -| SID | NUMBER(38) | NO | Session ID。 | -| USER_NAME | VARCHAR2(30) | NO | 用户名。 | -| ADDRESS | VARCHAR2(8) | NO | SQL 地址,与 SQL 的 Hash 值一起唯一定位一个 SQL,目前值为 `NULL`。 | -| HASH_VALUE | NUMBER(38) | NO | SQL 的 Hash 值。 | -| SQL_ID | VARCHAR2(32) | NO | SQL ID。 | -| SQL_TEXT | VARCHAR2(60) | NO | SQL 的文本的前 60 个字符。 | -| LAST_SQL_ACTIVE_TIME | DATE | NO | 最后一次执行 SQL 计划的时间。 | -| SQL_EXEC_ID | NUMBER(38) | NO | 如果 SQL 计划正在被执行,则显示对应的 SQL ID。 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/27.gv-sstable-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/27.gv-sstable-1.md deleted file mode 100644 index ed4e109b4..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/27.gv-sstable-1.md +++ /dev/null @@ -1,43 +0,0 @@ -GV$SSTABLE -=============================== - - - -功能 ------------------------ - -`GV$SSTABLE` 视图用于展示租户的 SSTable 信息。 - -字段说明 -------------------------- - - - -| 字段名称 | 类型 | 是否可以为 NULL | 描述 | -|--------------------------------|---------------|------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------| -| SVR_IP | VARCHAR2(46) | NO | 服务器的 IP 地址 | -| SVR_PORT | NUMBER(38) | NO | 服务器的端口号 | -| TABLE_TYPE | NUMBER(38) | NO | 表的类型 | -| TABLE_ID | NUMBER(38) | NO | 表 ID | -| TABLE_NAME | VARCHAR2(256) | NO | 表名 | -| TENANT_ID | NUMBER(38) | NO | 租户 ID | -| PARTITION_ID | NUMBER(38) | NO | 分区 ID | -| INDEX_ID | NUMBER(38) | NO | 主表或索引表的 ID | -| BASE_VERSION | NUMBER(38) | NO | 该表中存储数据的 `trans_version` 范围的最小值 | -| MULTI_VERSION_START | NUMBER(38) | NO | 该表中多版本数据的起始 `trans_version` | -| SNAPSHOT_VERSION | NUMBER(38) | NO | 该表中存储数据的 `trans_version` 范围的最大值 | -| START_LOG_TS | NUMBER(38) | NO | 该表中数据的日志时间戳范围的左边界 | -| END_LOG_TS | NUMBER(38) | NO | 该表中数据的日志时间戳范围的右边界 | -| MAX_LOG_TS | NUMBER(38) | NO | 该表中数据的日志时间戳范围的最大值 | -| VERSION | NUMBER(38) | NO | 该表的版本 | -| LOGICAL_DATA_VERSION | NUMBER(38) | NO | 该表的逻辑数据版本 | -| SIZE | NUMBER(38) | NO | 该表的大小 | -| IS_ACTIVE | NUMBER(38) | NO | 该表是否处于活跃状态 | -| REF | NUMBER(38) | NO | 该表引用的计数 | -| WRITE_REF | NUMBER(38) | NO | 该表写引用的计数 | -| TRX_COUNT | NUMBER(38) | NO | 该表上活跃事务的数量 | -| PENDING_LOG_PERSISTING_ROW_CNT | NUMBER(38) | NO | 持久化 Redo Log 的回收数量 | -| UPPER_TRANS_VERSION | NUMBER(38) | NO | 该表中存储数据的 `trans_version` 的上限 | -| CONTAIN_UNCOMMITTED_ROW | NUMBER(38) | NO | 该表是否包含未提交的事务行: * 0:表示该表不包含未提交的事务行 * 1:表示该表包含未提交的事务行 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/28.v-instance.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/28.v-instance.md deleted file mode 100644 index 31ce0e94b..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/28.v-instance.md +++ /dev/null @@ -1,42 +0,0 @@ -V$INSTANCE -=============================== - - - -**功能** ---------------------------- - -该视图展示了当前数据库实例的状态。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|------------------|--------------|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| INST_ID | NUMBER | NO | 数据库实例对应的 ID | -| INSTANCE_NUMBER | NUMBER | NO | 用于注册实例的 instance number。目前暂不支持该字段,当前该字段默认为 NULL | -| INSTANCE_NAME | VARCHAR2(16) | NO | 实例的名字。目前暂不支持该字段,当前该字段默认为 NULL | -| HOST_NAME | VARCHAR2(64) | NO | 实例所在的 Server 地址 | -| VERSION | VARCHAR2(17) | NO | 数据库实例的版本 | -| STARTUP_TIME | DATE | NO | 实例的启动时间。目前暂不支持该字段,当前该字段默认为 NULL | -| STATUS | VARCHAR2(12) | NO | 实例的状态。目前暂不支持该字段,当前该字段默认为 NULL | -| PARALLEL | VARCHAR2(3) | NO | 实例是否挂载在一个 cluster database 上,字段值为 YES 或者 NO。目前暂不支持该字段,当前该字段默认为 NULL | -| THREAD# | NUMBER | NO | Redo 线程数。目前暂不支持该字段,当前该字段默认为 NULL | -| ARCHIVER | VARCHAR2(7 | NO | Archiver 日志存储状态,有以下三个状态: * STOPPED * STARTED * FAILED 目前暂不支持该字段,当前该字段默认为 NULL | -| LOG_SWITCH_WAIT | VARCHAR2(15) | NO | 日志切换所等到的事件。目前暂不支持该字段,当前该字段默认为 NULL | -| LOGINS | VARCHAR2(10) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| SHUTDOWN_PENDING | VARCHAR2(3) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| DATABASE_STATUS | VARCHAR2(17) | NO | 数据库的状态 | -| INSTANCE_ROLE | VARCHAR2(18) | NO | 实例的角色: * PIMARY_INSTANCE * SECONDARY_INSTANCE * UNKNWON 目前暂不支持该字段,当前该字段默认为 NULL | -| ACTIVE_STATE | VARCHAR2(9) | NO | 实例的静默状态。目前暂不支持该字段,当前该字段默认为 NULL | -| BLOCKED | VARCHAR2(2) | NO | 是否所有的请求都被阻塞了: * YES * NO 目前暂不支持该字段,当前该字段默认为 NULL | -| CON_ID | NUMBER | NO | 数据所在的 Container ID。目前暂不支持该字段,当前该字段默认为 NULL | -| INSTANCE_MODE | VARCHAR2(11) | NO | 实例的模式: * READ-WRITE * READ-ONLY * READ-MOSTLY 目前暂不支持该字段,当前该字段默认为 NULL | -| EDITION | VARCHAR2(7) | NO | 实例的商业版本。目前暂不支持该字段,当前该字段默认为 NULL | -| FAMILY | VARCHAR2(80) | NO | 仅限内部使用。目前暂不支持该字段,当前该字段默认为 NULL | -| DATABASE_TYPE | VARCHAR2(15) | NO | 数据库实例的类型。目前暂不支持该字段,当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/29.v-memory-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/29.v-memory-1.md deleted file mode 100644 index c5007f1dc..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/29.v-memory-1.md +++ /dev/null @@ -1,25 +0,0 @@ -V$MEMORY -============================= - - - -**功能** ---------------------------- - -展示租户级别的内存统计信息。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-------------|---------------|----------------|-------------------------------------| -| CON_ID | NUMBER(38) | NO | 租户 ID | -| CONTEXT | VARCHAR2(256) | NO | 内存所属 mod 名称 | -| COUNT | NUMBER | NO | alloc 与 free 的差值,当前该 mod 使用中的内存单元个数 | -| USED | NUMBER | NO | 该 mod 当前使用的内存数值,单位:Byte | -| ALLOC_COUNT | NUMBER | NO | 内存申请的总个数 | -| FREE_COUNT | NUMBER | NO | 内存释放的总个数 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/3.gv-concurrent_limit_sql-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/3.gv-concurrent_limit_sql-1.md deleted file mode 100644 index c0525db70..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/3.gv-concurrent_limit_sql-1.md +++ /dev/null @@ -1,30 +0,0 @@ -GV$CONCURRENT_LIMIT_SQL -============================================ - - - -功能 ------------ - -展示当前租户的所有限流信息。 - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-------------------|-----------------|----------------|----------------------------------------| -| TENANT_ID | NUMBER(38) | NO | 租户 ID | -| DATABASE_ID | NUMBER(38) | NO | 数据库 ID | -| OUTLINE_ID | NUMBER(38) | NO | 限流对应的 Outline ID | -| DATABASE_NAME | VARCHAR2(128) | NO | 数据库名称 | -| OUTLINE_NAME | VARCHAR2(128) | NO | 限流对应的 Outline 名称 | -| OUTLINE_CONTENT | VARCHAR2(65536) | NO | 限流对应的 Outline 内容,可以为空 | -| VISIBLE_SIGNATURE | VARCHAR2(65536) | NO | Signature 的反序列化结果,为了便于查看 Signature 的信息 | -| SQL_TEXT | VARCHAR2(65536) | NO | 创建 Outline 时,在子句中指定的 SQL | -| CONCURRENT_NUM | NUMBER(38) | NO | 当前 SQL 限制的并发数 | -| LIMIT_TARGET | VARCHAR2(65536) | NO | 被限流的 SQL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/30.v-memstore-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/30.v-memstore-1.md deleted file mode 100644 index 02eb2d4f2..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/30.v-memstore-1.md +++ /dev/null @@ -1,25 +0,0 @@ -V$MEMSTORE -=============================== - - - -**功能** ---------------------------- - -该视图用于展示当前服务器上所有租户的 Memtable 的内存使用状况。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------------|------------|----------------|------------------------------| -| TENANT_ID | NUMBER(38) | NO | 租户 ID | -| ACTIVE | NUMBER(38) | NO | 当前活跃的 Memtable 的内存占用大小,单位:字节 | -| TOTAL | NUMBER(38) | NO | 当前所有 Memtable 的内存占用大小,单位:字节 | -| FREEZE_TRIGGER | NUMBER(38) | NO | 触发 Memtable 冻结的内存大小,单位:字节 | -| MEM_LIMIT | NUMBER(38) | NO | Memtable 的内存大小限制,单位:字节 | -| FREEZE_CNT | NUMBER(38) | NO | 冻结次数 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/31.v-memstore_info-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/31.v-memstore_info-1.md deleted file mode 100644 index 0cf392124..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/31.v-memstore_info-1.md +++ /dev/null @@ -1,30 +0,0 @@ -V$MEMSTORE_INFO -==================================== - - - -**功能** ---------------------------- - -该视图用于展示当前服务器上所有租户的所有分区的 memtable 的明细信息。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|---------------------|---------------|----------------|----------------| -| CON_ID | NUMBER(38) | NO | 租户 ID | -| PARTITION_ID | NUMBER(38) | NO | 分区 ID | -| VERSION | VARCHAR2(128) | NO | 冻结版本号 | -| BASE_VERSION | NUMBER(38) | NO | 数据的快照版本号的左边界 | -| MULTI_VERSION_START | NUMBER(38) | NO | 最小的老版本数据的快照版本号 | -| SNAPSHOT_VERSION | NUMBER(38) | NO | 数据的快照版本号的右边界 | -| IS_ACTIVE | NUMBER(38) | NO | 是否是活跃的 | -| USED | NUMBER(38) | NO | 使用的内存大小,单位为字节 | -| HASH_ITEMS | NUMBER(38) | NO | Hash 索引中记录的行数 | -| BTREE_ITEMS | NUMBER(38) | NO | Btree 索引中记录的行数 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/32.v-nls_parameters.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/32.v-nls_parameters.md deleted file mode 100644 index 446f36294..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/32.v-nls_parameters.md +++ /dev/null @@ -1,68 +0,0 @@ -V$NLS_PARAMETERS -===================================== - - - -**功能** ---------------------------- - -查看 Session 级别的 NLS 参数。 - -**相关视图** ------------------------------ - -* NLS_INSTANCE_PARAMETERS - - - -* NLS_DATABASE_PARAMETERS - - - -* NLS_SESSION_PARAMETERS - - - - - - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-----------|-----------------|----------------|--------| -| PARAMETER | VARCHAR2(128) | NO | 参数名称 | -| VALUE | VARCHAR2(65536) | YES | 参数取值 | -| CON_ID | NUMBER | NO | 无实际含义 | - - - -**示例** ---------------------------- - -```sql -obclient> select * from V$NLS_PARAMETERS; -+-------------------------+----------------------------------+--------+ -| PARAMETER | VALUE | CON_ID | -+-------------------------+----------------------------------+--------+ -| NLS_DATE_FORMAT | YYYY-MM-DD HH24:MI:SS | 0 | -| NLS_TIMESTAMP_FORMAT | YYYY-MM-DD HH24:MI:SS.FF | 0 | -| NLS_TIMESTAMP_TZ_FORMAT | YYYY-MM-DD HH24:MI:SS.FF TZR TZD | 0 | -| NLS_LANGUAGE | AMERICAN | 0 | -| NLS_TERRITORY | AMERICA | 0 | -| NLS_SORT | BINARY | 0 | -| NLS_COMP | BINARY | 0 | -| NLS_CHARACTERSET | AL32UTF8 | 0 | -| NLS_NCHAR_CHARACTERSET | AL16UTF16 | 0 | -| NLS_DATE_LANGUAGE | AMERICAN | 0 | -| NLS_LENGTH_SEMANTICS | BYTE | 0 | -| NLS_NCHAR_CONV_EXCP | FALSE | 0 | -| NLS_CALENDAR | GREGORIAN | 0 | -| NLS_NUMERIC_CHARACTERS | ., | 0 | -+-------------------------+----------------------------------+--------+ -14 rows in set (0.01 sec) -``` - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/33.v-ob_sql_workarea_memory_info-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/33.v-ob_sql_workarea_memory_info-1.md deleted file mode 100644 index dbbb553be..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/33.v-ob_sql_workarea_memory_info-1.md +++ /dev/null @@ -1,28 +0,0 @@ -V$OB_SQL_WORKAREA_MEMORY_INFO -================================================== - - - -**功能** ---------------------------- - -用于查询 SQL workarea总体的一些信息,包括最大可用内存、当前使用内存、当前 hold 内存等。通过该视图可以知道当前租户下 workarea 的使用情况,例如内存利用率等。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|------------------------|------------|----------------|-------------------------------------------------------------------------------------------------------------------------| -| MAX_WORKAREA_SIZE | NUMBER(38) | NO | 最大 workarea 内存,由参数决定可以使用多少内存。 | -| WORKAREA_HOLD_SIZE | NUMBER(38) | NO | workarea 当前的 hold 内存大小 **说明** 由于具体的使用量无法从内存管理模块获取到,故只能获取 hold 值。 | -| MAX_AUTO_WORKAREA_SIZE | NUMBER(38) | NO | auto 时,预计最大可用内存大小可以简单认为最大可用内存会根据公式 `max_work_area_size - hold + total_mem_used` 进行计算得到,表示当前 workarea 情况下 auto 管理的最大内存大小 | -| MEM_TARGET | NUMBER(38) | NO | 当前 workarea 可用内存的目标大小,与 max_auto_work_area 的区别在于该值是 max_auto_work_area 的一定比例 | -| TOTAL_MEM_USED | NUMBER(38) | NO | 当前 auto 内存使用大小,这里是由 SQL 自动内存管理模块统计的大小,不是真正使用大小 | -| GLOBAL_MEM_BOUND | NUMBER(38) | NO | auto 模式下,全局最大可用内存大小 | -| DRIFT_SIZE | NUMBER(38) | NO | 当前需求内存变化大小,主要用来当波动一定范围,会自动触发重新计算 global bound size | -| WORKAREA_COUNT | NUMBER(38) | NO | 注册的 operator profile 个数 | -| MANUAL_CALC_COUNT | NUMBER(38) | NO | 非定时触发的计算 global bound size 次数 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/34.v-plan_cache_plan_explain-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/34.v-plan_cache_plan_explain-1.md deleted file mode 100644 index 5f8098fe4..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/34.v-plan_cache_plan_explain-1.md +++ /dev/null @@ -1,36 +0,0 @@ -V$PLAN_CACHE_PLAN_EXPLAIN -============================================== - - - -**功能** ---------------------------- - -该视图用于展示缓存在当前 Server 的计划缓存中的物理执行计划。 -**说明** - - - -该视图只支持get操作,查询时需要指定 TENANT_ID、LAN_ID 字段。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------|----------------|----------------|------------------| -| TENANT_ID | NUMBER(38) | NO | 租户 ID | -| SVR_IP | VARCHAR2(32) | NO | IP 地址 | -| SVR_PORT | NUMBER(38) | NO | 端口号 | -| PLAN_ID | NUMBER(38) | NO | 计划的 ID | -| PLAN_DEPTH | NUMBER(38) | NO | Operator 在展示时的深度 | -| PLAN_LINE_ID | NUMBER(38) | NO | Operator 的编号 | -| OPERATOR | VARCHAR2(128) | NO | Operator 的名称 | -| NAME | VARCHAR2(256) | NO | 表的名称 | -| ROWS | NUMBER(38) | NO | 预估的结果行数 | -| COST | NUMBER(38) | NO | 预估的代价 | -| PROPERTY | VARCHAR2(4096) | NO | 对应 Operator 的信息 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/35.v-plan_cache_plan_stat-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/35.v-plan_cache_plan_stat-1.md deleted file mode 100644 index 1a13fbeb2..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/35.v-plan_cache_plan_stat-1.md +++ /dev/null @@ -1,81 +0,0 @@ -V$PLAN_CACHE_PLAN_STAT -=========================================== - - - -**功能** ---------------------------- - -该视图记录了当前租户在当前 Server 上的计划缓存中缓存的每一个缓存对象的状态。 -**注意** - - - -该表不仅缓存了 SQL 计划对象,也缓存了 PL 对象,例如匿名块、PL Package 以及 PL Function 等,某些字段仅在特定对象下有效。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-----------------------|-----------------------------------|----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| TENANT_ID | NUMBER(38) | NO | 租户 ID | -| SVR_IP | VARCHAR2(32) | NO | 机器 IP | -| SVR_PORT | NUMBER(38) | NO | 机器端口号 | -| PLAN_ID | NUMBER(38) | NO | 缓存对象的 ID | -| SQL_ID | VARCHAR2(32) | NO | 缓存对象对应的 SQL ID,如果是 PL 对象,该字段为 NULL | -| TYPE | NUMBER(38) | NO | 对于 SQL 计划缓存,字段表示计划的类型: * 1:表示 local plan * 2:表示 remote plan * 3:表示 distribute plan 对于 PL 对象缓存,字段表示 PL 对象的类型: * 1:表示 Procedure * 2:表示 Function * 3:表示 Package * 4:表示 Anonymous Block | -| IS_BIND_SENSITIVE | NUMBER(38) | NO | 该计划是否需要打开 ACS | -| IS_BIND_AWARE | NUMBER(38) | NO | 该计划已经打开了 ACS | -| DB_ID | NUMBER(38) | NO | 数据库的 ID | -| STATEMENT | VARCHAR2(65536) | NO | 对于 SQL 计划,该字段为参数化后的 SQL 语句;对于匿名块对象,该字段为参数化后的匿名块语句;其他对象该字段无效 | -| QUERY_SQL | VARCHAR2(65536) | NO | 对于 SQL 计划,字段为第一次加载计划时查询的原始 SQL 语句;对于匿名块字段,该字段为参数化后的匿名块语句 | -| SPECIAL_PARAMS | VARCHAR2(4096) | NO | 表示不可参数化的参数值 | -| PARAM_INFOS | VARCHAR2(65536) | NO | 表示参数化信息 | -| SYS_VARS | VARCHAR2(4096) | NO | 影响缓存对象的系统变量的值 | -| PLAN_HASH | NUMBER(38) | NO | SQL 计划的 Hash 值 | -| FIRST_LOAD_TIME | TIMESTAMP(6) WITH LOCAL TIME ZONE | NO | 第一次被加载时间 | -| SCHEMA_VERSION | NUMBER(38) | NO | Schema 版本号 | -| MERGED_VERSION | NUMBER(38) | NO | 当前缓存的计划对应的合并版本号 | -| LAST_ACTIVE_TIME | TIMESTAMP(6) WITH LOCAL TIME ZONE | NO | 上一次被执行时间 | -| AVG_EXE_USEC | NUMBER(38) | NO | 平均执行时间 | -| SLOWEST_EXE_TIME | TIMESTAMP(6) WITH LOCAL TIME ZONE | NO | 最慢执行时间戳 | -| SLOWEST_EXE_USEC | NUMBER(38) | NO | 最慢一次执行耗时 | -| SLOW_COUNT | NUMBER(38) | NO | 当前 SQL 计划成为慢查询的次数 | -| HIT_COUNT | NUMBER(38) | NO | 被命中次数 | -| PLAN_SIZE | NUMBER(38) | NO | 缓存对象占用的内存大小 | -| EXECUTIONS | NUMBER(38) | NO | 执行次数 | -| DISK_READS | NUMBER(38) | NO | 所有执行物理读次数 | -| DIRECT_WRITES | NUMBER(38) | NO | 所有执行写盘的次数 | -| BUFFERS_GETS | NUMBER(38) | NO | 所有执行逻辑读次数 | -| APPLICATION_WATI_TIME | NUMBER(38) | NO | 所有执行所有 application 类事件的总时间 | -| CONCURRENCY_WAIT_TIME | NUMBER(38) | NO | 所有执行所有 concurrency 类事件的总时间 | -| USER_IO_WAIT_TIME | NUMBER(38) | NO | 所有执行所有 user_io 类事件的总时间 | -| ROWS_PROCESSED | NUMBER(38) | NO | 所有执行选择的结果行数或执行更改表中的行数 | -| ELAPSED_TIME | NUMBER(38) | NO | 所有执行接收到请求到执行结束消耗时间 | -| CPU_TIME | NUMBER(38) | NO | 所有执行消耗的 CPU 时间 | -| LARGE_QUERYS | NUMBER(38) | NO | 被判断为大查询的次数 | -| DELAYED_LARGE_QUERYS | NUMBER(38) | NO | 被判断为大查询且被丢入大查询队列的次数 | -| DELAYED_PX_QUERYS | NUMBER(38) | NO | 并行查询被丢回队列重试的次数 | -| OUTLINE_VERSION | NUMBER(38) | NO | Outline 的版本号 | -| OUTLINE_ID | NUMBER(38) | NO | Outline 的 ID,为 -1 表示不是通过绑定 Outline 生成的计划 | -| OUTLINE_DATA | VARCHAR2(65536) | NO | 计划对应的 OUTLINE 信息 | -| HINTS_INFO | VARCHAR2(65536) | NO | SQL 计划的 Hint 信息 | -| HINTS_ALL_WORKED | NUMBER(38) | NO | SQL 计划中的 Hint 是否都已经生效 | -| ACS_SEL_INFO | VARCHAR2(65536) | NO | 当前 ACS 计划对应的选择率空间 | -| TABLE_SCAN | NUMBER(38) | NO | 表示该查询是否为主键扫描 | -| EVOLUTION | NUMBER(38) | NO | 表示该执行计划是否在演进中 | -| EVO_EXECUTIONS | NUMBER(38) | NO | 演进次数 | -| EVO_CPU_TIME | NUMBER(38) | NO | 演进过程中总的执行 CPU 时间 | -| TIMEOUT_COUNT | NUMBER(38) | NO | 超时次数 | -| PS_STMT_ID | NUMBER(38) | NO | prepare statement id | -| SESSID | NUMBER(38) | NO | 缓存对象所在的 Session ID | -| TEMP_TABLES | VARCHAR2(65536) | NO | SQL 计划中包含的临时表表名,如果没有临时表,字段为空 | -| IS_USE_JIT | NUMBER(38) | NO | SQL 计划是否开启了表达式编译执行 | -| OBJECT_TYPE | VARCHAR2(65536) | NO | 缓存对象的类型: * SQL_PLAN * PROCEDURE * FUNCTION * PACKAGE * ANONYMOUS | -| PL_SCHEMA_ID | NUMBER(38) | NO | 对于非匿名块的 PL 对象,该字段为缓存对象的 schema id;对于匿名块,该字段为 prepare statement id;对于 SQL 计划,该字段无意义 | -| IS_BATCHED_MULTI_STMT | NUMBER(38) | NO | 表示是否为 batched multistmt 优化的计划 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/36.v-plan_cache_stat-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/36.v-plan_cache_stat-1.md deleted file mode 100644 index 2361bf638..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/36.v-plan_cache_stat-1.md +++ /dev/null @@ -1,29 +0,0 @@ -V$PLAN_CACHE_STAT -====================================== - - - -**功能** ---------------------------- - -该视图记录当前租户在当前 Server 的计划缓存整体的状态。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------|------------|----------------|-----------------------------------| -| SQL_NUM | NUMBER(38) | NO | plan_cache 涉及 SQL 的条数 | -| MEM_USED | NUMBER(38) | NO | plan_cache 已经使用的内存 | -| MEM_HOLD | NUMBER(38) | NO | plan_cache 持有的内存 | -| ACCESS_COUNT | NUMBER(38) | NO | 进行 plan_cache 的次数 | -| HIT_COUNT | NUMBER(38) | NO | 命中 plan_cache 的次数 | -| HIT_RATE | NUMBER(38) | NO | plan_cache 的命中率 | -| PLAN_NUM | NUMBER(38) | NO | 计划的个数 | -| MEM_LIMIT | NUMBER(38) | NO | plan_cache 的内存上限 | -| HASH_BUCKET | NUMBER(38) | NO | plan_cache hash map 中的 Bucket 的个数 | -| STMTKEY_NUM | NUMBER(38) | NO | plan_cache 中 stmt_key 的个数 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/37.v-ps_item_info-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/37.v-ps_item_info-1.md deleted file mode 100644 index a05058fd2..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/37.v-ps_item_info-1.md +++ /dev/null @@ -1,30 +0,0 @@ -V$PS_ITEM_INFO -=================================== - - - -**功能** ---------------------------- - -用于给 prepared statement 提供监控功能,包含 PS Cache 中所有 prepare statement 的基本信息。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|---------------------|-----------------|----------------|--------------------------------------| -| SVR_IP | VARCHAR2(32) | NO | 机器 IP | -| SVR_PORT | NUMBER(38) | NO | 机器端口号 | -| STMT_ID | NUMBER(38) | NO | PS Cache 中对应语句的 stmt_id 信息 | -| DB_ID | NUMBER(38) | NO | prepare 语句涉及到的数据库 ID | -| PS_SQL | VARCHAR2(65536) | NO | prepare 的 SQL 信息 | -| PARAM_COUNT | NUMBER(38) | NO | prepare 的参数个数信息 | -| STMT_ITEM_REF_COUNT | NUMBER(38) | NO | stmt_item 的引用计数信息 | -| STMT_INFO_REF_COUNT | NUMBER(38) | NO | stmt_info 的引用计数信息 | -| MEM_HOLD | NUMBER(38) | NO | 该 prepare stmt 占用的内存大小 | -| STMT_TYPE | NUMBER(38) | NO | 该 prepare stmt 的类型信息 | -| CHECKSUM | NUMBER(38) | NO | 该 prepare stmt 的 checksum | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/38.v-ps_stat-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/38.v-ps_stat-1.md deleted file mode 100644 index 95f2c3857..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/38.v-ps_stat-1.md +++ /dev/null @@ -1,26 +0,0 @@ -V$PS_STAT -============================== - - - -**功能** ---------------------------- - -监控 PS Cache 的整体状态,包括命中率、内存占用、缓存的 Item 数目。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------|--------------|----------------|---------------------| -| SVR_IP | VARCHAR2(32) | NO | 机器 IP | -| SVR_PORT | NUMBER(38) | NO | 机器端口号 | -| STMT_COUNT | NUMBER(38) | NO | PS Cache 中目前缓存了多少语句 | -| HIT_COUNT | NUMBER(38) | NO | PS Cache 总的命中次数 | -| ACCESS_COUNT | NUMBER(38) | NO | 访问 PS Cache 的总次数 | -| MEM_HOLD | NUMBER(38) | NO | PS Cache 占用了多少内存 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/39.v-session_wait-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/39.v-session_wait-1.md deleted file mode 100644 index aa08130f3..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/39.v-session_wait-1.md +++ /dev/null @@ -1,38 +0,0 @@ -V$SESSION_WAIT -=================================== - - - -**功能** ---------------------------- - -该视图用于展示当前服务器上所有 Session 的当前或者上一次等待事件的信息,包括等待事件名称、等待耗时等。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------------------------|--------------|----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| SID | NUMBER(38) | NO | Session ID | -| CON_ID | NUMBER(38) | NO | 租户 ID | -| EVENT | NUMBER(38) | NO | 等待事件名称 | -| P1TEXT | VARCHAR2(64) | NO | 等待事件的第 1 个参数的描述 | -| P1 | NUMBER(38) | NO | 等待事件的第 1 个参数的值 | -| P2TEXT | VARCHAR2(64) | NO | 等待事件的第 2 个参数的描述 | -| P2 | NUMBER(38) | NO | 等待事件的第 2 个参数的值 | -| P3TEXT | VARCHAR2(64) | NO | 等待事件的第 3 个参数的描述 | -| P3 | NUMBER(38) | NO | 等待事件的第 3 个参数的值 | -| WAIT_CLASS_ID | NUMBER(38) | NO | 等待事件的类别 ID | -| WAIT_CLASS# | NUMBER(38) | NO | 等待事件的类别序号 | -| WAIT_CLASS | VARCHAR2(64) | NO | 等待事件的类别名称 | -| STATE | VARCHAR2(19) | NO | 当前等待事件的状态,包含四种状态: * Waiting:Session 正等待这个事件 * Waited unknown time:由于设置了 timed_statistics 值为 false,导致不能得到时间信息。表示发生了等待,但时间很短 * Wait short time:表示发生了等待,但由于时间非常短不超过一个时间单位,所以没有记录 * Waited knnow time:如果 Session 等待然后得到了所需资源,那么将从 waiting 进入本状态 | -| WAIT_TIME_MICRO | NUMBER(38) | NO | 等待时间,单位为微秒。如果当前正在等待,表示已经等待的时长;如果当前没有等待,表示最后一次等待的总等待时长 | -| TIME_REMAINING_MICRO | NUMBER(38) | NO | * \>0:表示最后一次等待时间,单位:毫秒,当前未在等待状态 * 0:表示 Session 正在等待当前的事件 * -1:表示最后一次等待时间小于 1个统计单位,当前未在等待状态 * -2:表示时间统计状态未置为可用,当前未在等待状态 | -| TIME_SINCE_LAST_WAIT_MICRO | NUMBER(38) | NO | 上一次等待结束到现在的时间,单位:毫秒,如果当前正在等待,其值为 0 | - - - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/4.gv-instance.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/4.gv-instance.md deleted file mode 100644 index 3f4ab29e4..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/4.gv-instance.md +++ /dev/null @@ -1,43 +0,0 @@ -GV$INSTANCE -================================ - - - -功能 ------------ - -该视图展示了当前数据库实例的状态。 - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为NULL** | **描述** | -|------------------|--------------|---------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| | | | | -| INST_ID | NUMBER | NO | 数据库实例对应的 ID | -| INSTANCE_NUMBER | NUMBER | NO | 用于注册实例的 instance number。目前暂不支持该字段,且当前该字段默认为 NULL | -| INSTANCE_NAME | VARCHAR2(16) | NO | 实例的名字。目前暂不支持该字段,且当前该字段默认为 NULL | -| HOST_NAME | VARCHAR2(64) | NO | 实例所在的 Server 地址 | -| VERSION | VARCHAR2(17) | NO | 数据库实例的版本 | -| STARTUP_TIME | DATE | NO | 实例的启动时间。目前暂不支持该字段,且当前该字段默认为 NULL | -| STATUS | VARCHAR2(12) | NO | 实例的状态。目前暂不支持该字段,且当前该字段默认为 NULL | -| PARALLEL | VARCHAR2(3) | NO | 实例是否挂载在一个 cluster database 上,字段值为 yes 或者 no。目前暂不支持该字段,且当前该字段默认为 NULL | -| THREAD# | NUMBER | NO | redo 线程数。目前暂不支持该字段,且当前该字段默认为 NULL | -| ARCHIVER | VARCHAR2(7 | NO | Archiver 日志存储状态,有以下三个状态: * STOPPED * STARTED * FAILED 目前暂不支持该字段,且当前该字段默认为 NULL | -| LOG_SWITCH_WAIT | VARCHAR2(15) | NO | 日志切换所等到的事件。目前暂不支持该字段,且当前该字段默认为 NULL | -| LOGINS | VARCHAR2(10) | NO | * ALLOWED * RESTRICTED 目前暂不支持该字段,且当前该字段默认为 NULL | -| SHUTDOWN_PENDING | VARCHAR2(3) | NO | YES 或 NO。目前暂不支持该字段,且当前该字段默认为 NULL | -| DATABASE_STATUS | VARCHAR2(17) | NO | 数据库的状态 | -| INSTANCE_ROLE | VARCHAR2(18) | NO | 实例的角色: * PIMARY_INSTANCE * SECONDARY_INSTANCE * UNKNWON 目前暂不支持该字段,且当前该字段默认为 NULL | -| ACTIVE_STATE | VARCHAR2(9) | NO | 实例的静默状态。目前暂不支持该字段,且当前该字段默认为 NULL | -| BLOCKED | VARCHAR2(2) | NO | 是否所有的请求都被阻塞了 * YES * NO 目前暂不支持该字段,且当前该字段默认为 NULL | -| CON_ID | NUMBER | NO | 数据所在的 Container ID。目前暂不支持该字段,且当前该字段默认为 NULL | -| INSTANCE_MODE | VARCHAR2(11) | NO | 实例的模式: * READ-WRITE * READ-ONLY * READ-MOSTLY 目前暂不支持该字段,且当前该字段默认为 NULL | -| EDITION | VARCHAR2(7) | NO | 实例的商业版本。目前暂不支持该字段,且当前该字段默认为 NULL | -| FAMILY | VARCHAR2(80) | NO | 仅限内部使用。目前暂不支持该字段,且当前该字段默认为 NULL | -| DATABASE_TYPE | VARCHAR2(15) | NO | 数据库实例的类型。目前暂不支持该字段,且当前该字段默认为 NULL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/40.v-session_wait_history-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/40.v-session_wait_history-1.md deleted file mode 100644 index db15955c2..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/40.v-session_wait_history-1.md +++ /dev/null @@ -1,34 +0,0 @@ -V$SESSION_WAIT_HISTORY -=========================================== - - - -**功能** ---------------------------- - -该视图用于展示当前服务器上所有 Session 的最近 10 次等待事件的信息。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------------------------|--------------|----------------|------------------------| -| SID | NUMBER(38) | NO | Ssession ID | -| CON_ID | NUMBER(38) | NO | 租户 ID | -| SEQ# | NUMBER(38) | NO | 等待事件序列号 | -| EVENT# | NUMBER(38) | NO | 等待事件编号 | -| EVENT | VARCHAR2(64) | NO | 等待事件名称 | -| P1TEXT | VARCHAR2(64) | NO | 等待事件的第一个参数的描述 | -| P1 | NUMBER(38) | NO | 等待事件的第一个参数的值 | -| P2TEXT | VARCHAR2(64) | NO | 等待事件的第二个参数的描述 | -| P2 | NUMBER(38) | NO | 等待事件的第二个参数的值 | -| P3TEXT | VARCHAR2(64) | NO | 等待事件的第三个参数的描述 | -| P3 | NUMBER(38) | NO | 等待事件的第三个参数的值 | -| WAIT_TIME_MICRO | NUMBER(38) | NO | 等待事件的等待时间,单位为毫秒 | -| TIME_SINCE_LAST_WAIT_MICRO | NUMBER(38) | NO | 自上一次等待结束到当前等待的时间,单位为毫秒 | -| WAIT_TIME | NUMBER(38) | NO | 等待事件的等待时间,单位为百分之一秒 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/41.v-sesstat-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/41.v-sesstat-1.md deleted file mode 100644 index b543cda15..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/41.v-sesstat-1.md +++ /dev/null @@ -1,25 +0,0 @@ -V$SESSTAT -============================== - - - -**功能** ---------------------------- - -该视图用于展示 Session 级别的一些统计信息。 - -其中,STATISTIC# 表示统计项编号,可以从 V$STATNAME 中查询到对应统计项编号的统计项名称及其含义。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|------------|------------|----------------|-----------| -| SID | NUMBER(38) | NO | Session 号 | -| CON_ID | NUMBER(38) | NO | 租户 ID | -| STATISTIC# | NUMBER(38) | NO | 统计项编号 | -| VALUE | NUMBER(38) | NO | 统计项值 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/42.v-sql_audit-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/42.v-sql_audit-1.md deleted file mode 100644 index eeb24b9e1..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/42.v-sql_audit-1.md +++ /dev/null @@ -1,101 +0,0 @@ -V$SQL_AUDIT -================================ - - - -**功能** ---------------------------- - -该视图用于展示当前 Server 的每一次 SQL 请求的来源、执行状态等统计信息。该视图是按照租户拆分的,除了系统租户,其他租户不能跨租户查询。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-------------------------|-----------------|----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| SVR_IP | VARCHAR2(32) | NO | IP 地址 | -| SVR_PORT | NUMBER(38) | NO | 端口号 | -| REQUEST_ID | NUMBER(38) | NO | 请求的 ID 号 | -| SQL_EXEC_ID | NUMBER(38) | NO | 本次执行的 ID | -| TRACE_ID | NUMBER(38) | NO | 该语句的 trace_id | -| SID | NUMBER(38) | NO | Session 连接 ID | -| CLIENT_IP | VARCHAR2(32) | NO | 发送请求的客户端 IP | -| CLIENT_PORT | NUMBER(38) | NO | 发送请求的客户端端口号 | -| TENANT_ID | NUMBER(38) | NO | 发送请求的租户 ID | -| EFFECTIVE_TENANT_ID | NUMBER(38) | NO | 租户 ID | -| TENANT_NAME | VARCHAR2(64) | NO | 发送请求的租户名称 | -| USER_ID | NUMBER(38) | NO | 发送请求的用户 ID | -| USER_NAME | VARCHAR2(64) | NO | 发送请求的用户名称 | -| USER_CLIENT_IP | VARCHAR2(32) | NO | 发送请求的客户端 IP | -| DB_ID | NUMBER(38) | NO | 数据库 ID | -| DB_NAME | VARCHAR2(128) | NO | 数据库名称 | -| SQL_ID | VARCHAR2(32) | NO | 该 SQL 的 ID | -| QUERY_SQL | VARCHAR2(65536) | NO | 实际的 SQL 语句 | -| PLAN_ID | NUMBER(38) | NO | 执行计划 ID | -| AFFECTED_ROWS | NUMBER(38) | NO | 影响行数 | -| RETURN_ROWS | NUMBER(38) | NO | 返回行数 | -| PARTITION_CNT | NUMBER(38) | NO | 该请求涉及的分区数 | -| RET_CODE | NUMBER(38) | NO | 执行结果返回码 | -| DFO_ID | NUMBER(38) | NO | 并行执行场景下,当前执行的子计划 ID | -| SQC_ID | NUMBER(38) | NO | 并行执行场景下,本地协调器 ID | -| WORKER_ID | NUMBER(38) | NO | 并行执行场景下,工作线程 ID | -| EVENT | VARCHAR2(64) | NO | 最长等待事件名称 | -| P1TEXT | VARCHAR2(64) | NO | 等待事件参数 1 | -| P1 | NUMBER(38) | NO | 等待事件参数 1 的值 | -| P2TEXT | VARCHAR2(64) | NO | 等待事件参数 2 | -| P2 | NUMBER(38) | NO | 等待事件参数 2 的值 | -| P3TEXT | VARCHAR2(64) | NO | 等待事件参数 3 | -| P3 | NUMBER(38) | NO | 等待事件参数 3 的值 | -| LEVEL | NUMBER(38) | NO | 等待事件的级别 | -| WAIT_CLASS_ID | NUMBER(38) | NO | 等待事件所属的 Class ID | -| WAIT_CLASS# | NUMBER(38) | NO | 等待事件所属的 Class 的下标 | -| WAIT_CLASS | VARCHAR2(64) | NO | 等待事件所属的 Class 名称 | -| STATE | VARCHAR2(19) | NO | 等待事件的状态 | -| WAIT_TIME_MICRO | NUMBER(38) | NO | 该等待事件所等待的时间,单位:微秒 | -| TOTAL_WAIT_TIME_MICRO | NUMBER(38) | NO | 执行过程所有等待的总时间,单位:微秒 | -| TOTAL_WAITS | NUMBER(38) | NO | 执行过程总等待的次数 | -| RPC_COUNT | NUMBER(38) | NO | 发送 RPC 个数 | -| PLAN_TYPE | NUMBER(38) | NO | 执行计划类型: * local * remote * distribute | -| IS_INNER_SQL | NUMBER(38) | NO | 是否内部 SQL 请求 | -| IS_EXECUTOR_RPC | NUMBER(38) | NO | 当前请求是否为 RPC 请求 | -| IS_HIT_PLAN | NUMBER(38) | NO | 是否命中 plan_cache | -| REQUEST_TIME | NUMBER(38) | NO | 开始执行时间点 | -| ELAPSED_TIME | NUMBER(38) | NO | 接收到请求到执行结束消耗总时间 | -| NET_TIME | NUMBER(38) | NO | 发送 RPC 到接收到请求的时间 | -| NET_WAIT_TIME | NUMBER(38) | NO | 接收到请求到进入队列的时间 | -| QUEUE_TIME | NUMBER(38) | NO | 请求在队列等待事件 | -| DECODE_TIME | NUMBER(38) | NO | 出队列后 Decode 时间 | -| GET_PLAN_TIME | NUMBER(38) | NO | 开始 Process 到获得计划的时间 | -| EXECUTE_TIME | NUMBER(38) | NO | 计划执行所消耗的时间 | -| APPLICATION_WAIT_TIME | NUMBER(38) | NO | 所有 Application 类事件的总时间 | -| CONCURRENCY_WAIT_TIME | NUMBER(38) | NO | 所有 Concurrency 类事件的总时间 | -| USER_IO_WAIT_TIME | NUMBER(38) | NO | 所有 user_io 类事件的总时间 | -| SCHEDULE_TIME | NUMBER(38) | NO | 所有 Schedule 类事件的时间 | -| ROW_CACHE_HIT | NUMBER(38) | NO | 行缓存命中次数 | -| BLOOM_FILTER_CACHE_HIT | NUMBER(38) | NO | Bloom Filter 缓存命中次数 | -| BLOCK_CACHE_HIT | NUMBER(38) | NO | 块缓存命中次数 | -| BLOCK_INDEX_CACHE_HIT | NUMBER(38) | NO | 块索引缓存命中次数 | -| DISK_READS | NUMBER(38) | NO | 物理读次数 | -| RETRY_CNT | NUMBER(38) | NO | 重试次数 | -| TABLE_SCAN | NUMBER(38) | NO | 判断该请求是否含全表扫描 | -| CONSISTENCY_LEVEL | NUMBER(38) | NO | 一致性级别 | -| MEMSTORE_READ_ROW_COUNT | NUMBER(38) | NO | Memstore 中的读行数 | -| SSSTORE_READ_ROW_COUNT' | NUMBER(38) | NO | Ssstore 中连读的行数 | -| REQUEST_MEMORY_USED | NUMBER(38) | NO | 该请求消耗的内存 | -| EXPECT_WORKER_COUNT | NUMBER(38) | NO | 请求期望的工作线程数 | -| USED_WORKER_COUNT | NUMBER(38) | NO | 请求实际使用的工作线程数 | -| SCHED_INFO | VARCHAR2(16384) | NO | 请求的调度信息 | -| FUSE_ROW_CACHE_HIT | NUMBER(38) | NO | 目前暂不支持该字段,当前该字段默认为 NULL | -| PS_STMT_ID | NUMBER(38) | NO | 请求对应的 Prepare ID | -| TRANSACTION_HASH | NUMBER(38) | NO | 请求对应的事务的 Hash 值 | -| REQUEST_TYPE | NUMBER(38) | NO | 请求对应的类型: * 0:表示非法 * 1:表示是一个内部请求 * 2:表示是一个本地请求,例如,Local 计划 * 3:表示远程请求 * 4:表示分布式请求 * 5:表示 SQL 的 prepare 请求 * 6:表示 SQL 得到 execute stmt 请求 | -| IS_BATCHED_MULTI_STMT | NUMBER(38) | NO | 表示是否进行了 batch multi stmt 的优化 | -| OB_TRACE_INFO | VARCHAR2(4096) | NO | 用户设置的 trace info 信息 | -| PLAN_HASH | NUMBER(38) | NO | 执行计划 Hash 值 | - - - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/43.v-sql_workarea-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/43.v-sql_workarea-1.md deleted file mode 100644 index b5fbbfe24..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/43.v-sql_workarea-1.md +++ /dev/null @@ -1,41 +0,0 @@ -V$SQL_WORKAREA -=================================== - - - -**功能** ---------------------------- - -统计之前受 SQL 自动内存管理负责执行过的所有 Operator 的 workarea 统计信息。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|------------------------|--------------|----------------|---------------------------------------------------------------------------------------------------------------------------------------| -| ADDRESS | RAW(8) | NO | SQL 对应的 Handle 地址,目前未指定值。目前暂不支持该字段,当前该字段默认为 NULL | -| HASH_VALUE | NUMBER | NO | 语句的 Hash Value 值。目前暂不支持该字段,当前该字段默认为 NULL | -| SQL_ID | VARCHAR2(32) | NO | SQL 语句的 SQL 唯一标示 | -| CHILD_NUMBER | NUMBER | NO | 该 Cursor 的数量。目前暂不支持该字段,当前该字段默认为 NULL | -| WORKAREA_ADDRESS | RAW(8) | NO | workarea地址 暂不支持该字段,目前该字段默认为 NULL | -| OPERATION_TYPE | VARCHAR2(40) | NO | workarea 操作符类型,例如 Sort、Hash Join、Group by 等 | -| OPERATION_ID | NUMBER(38) | NO | 计划树中识别操作符的唯一标示 | -| POLICY | VARCHAR2(10) | NO | workarea 的策略: * MANUAL * AUTO | -| ESTIMATED_OPTIMAL_SIZE | NUMBER(38) | NO | 在最优情况下执行操作符的估算内存大小,单位:bytes | -| ESTIMATED_ONEPASS_SIZE | NUMBER(38) | NO | one pass 场景下,执行操作符估算内存大小,单位:bytes | -| LAST_MEMORY_USED | NUMBER(38) | NO | 游标在上次执行使用的内存大小,单位:bytes | -| LAST_EXECUTION | VARCHAR2(10) | NO | 上次执行时 workarea 选择的是 optimal、one pass 还是 multi passes | -| LAST_DEGREE | NUMBER(38) | NO | 上次执行并行度 | -| TOTAL_EXECUTIONS | NUMBER(38) | NO | 总共执行使用 workarea 的次数 | -| OPTIMAL_EXECUTIONS | NUMBER(38) | NO | 最优场景下执行的次数 | -| ONEPASS_EXECUTIONS | NUMBER(38) | NO | one pass 场景执行的次数 | -| MULTIPASSES_EXECUTIONS | NUMBER(38) | NO | multi passes 场景执行的次数 | -| ACTIVE_TIME | NUMBER(38) | NO | workarea 活跃时的平均时间,单位:s | -| MAX_TEMPSEG_SIZE | NUMBER(38) | NO | work area使用时最大的临时磁盘空间,单位:bytes;如果是 NULL,则表示未使用临时空间 | -| LAST_TEMPSEG_SIZE | NUMBER(38) | NO | workarea 上次执行时使用的临时磁盘空间;如果是 NULL,则表示未使用临时空间 | -| CON_ID | NUMBER(38) | NO | 租户 ID | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/44.v-sql_workarea_active-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/44.v-sql_workarea_active-1.md deleted file mode 100644 index 7340cc7dc..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/44.v-sql_workarea_active-1.md +++ /dev/null @@ -1,42 +0,0 @@ -V$SQL_WORKAREA_ACTIVE -========================================== - - - -**功能** ---------------------------- - -当前活跃 Operator 的 workarea 信息。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|------------------|--------------|----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| SQL_HASH_VALUE | NUMBER | NO | 被执行语句的 Hash 值。目前暂不支持该字段,当前该字段默认为 NULL | -| SQL_ID | VARCHAR2(32) | NO | SQL 语句的 SQL 唯一标示 | -| SQL_EXEC_START | DATE | NO | SQL 开始执行时间。目前暂不支持该字段,当前该字段默认为 NULL | -| SQL_EXEC_ID | NUMBER(38) | NO | SQL 执行唯一标示 | -| WORKAREA_ADDRESS | RAW(8) | NO | workarea 地址。目前暂不支持该字段,当前该字段默认为 NULL | -| OPERATION_TYPE | VARCHAR2(40) | NO | workarea操作符类型,例如 Sort、Hash Join、Group by 等 | -| OPERATION_ID | NUMBER(38) | NO | 计划树中识别操作符的唯一标示 | -| POLICY | VARCHAR2(6) | NO | workarea 的策略: * MANUAL * AUTO | -| SID | NUMBER(38) | NO | Session 的唯一标识 | -| QCINST_ID | NUMBER | NO | 查询协调者的实例 ID。目前暂不支持该字段,当前该字段默认为 NULL | -| QCSID | NUMBER | NO | 查询协调者 Session 标识 ID。目前暂不支持该字段,当前该字段默认为 NULL | -| ACTIVE_TIME | NUMBER(38) | NO | workarea 活跃时平均时间,单位:ms | -| WORK_AREA_SIZE | NUMBER | NO | 操作符使用 workarea 最大大小,单位:bytes | -| EXPECT_SIZE | NUMBER | NO | workarea 期望的大小,单位:bytes | -| ACTUAL_MEM_USED | NUMBER(38) | NO | 申请 workarea 的内存量,单位:bytes | -| MAX_MEM_USED | NUMBER(38) | NO | 使用 workarea 最大的内存使用量,单位:bytes | -| NUMBER_PASSES | NUMBER(38) | NO | workarea 在哪个模式下运行: * 0:optimal 模式 * 1:one pass 模式 * \>=2:multi passes 模式 | -| TEMPSEG_SIZE | NUMBER(38) | NO | workarea 使用的临时空间大小,单位:bytes;如果为 NULL,则表示没有发生写临时文件 | -| TABLESPACE | VARCHAR2(20) | NO | 写临时文件的表命名空间;如果为 NULL,表示没有发生写临时文件。目前暂不支持该字段,当前该字段默认为 NULL | -| SEGRFNO# | NUMBER | NO | 写临时文件相关的文件数量;NULL 标示没有发生写临时文件。目前暂不支持该字段,当前该字段默认为 NULL | -| SEGBLK# | NUMBER | NO | workarea 创建临时文件的 block 数量;NULL 表示没有发生写临时文件。目前暂不支持该字段,当前该字段默认为 NULL | -| CON_ID | NUMBER(38) | NO | 租户 ID | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/45.v-sql_workarea_histogram-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/45.v-sql_workarea_histogram-1.md deleted file mode 100644 index 4ad67e2d5..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/45.v-sql_workarea_histogram-1.md +++ /dev/null @@ -1,27 +0,0 @@ -V$SQL_WORKAREA_HISTOGRAM -============================================= - - - -**功能** ---------------------------- - -展示之前所有 workarea 执行的统计信息,包括在区间 1M~2M 之间全 in-memory 处理的次数、one-pass 次数等。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|------------------------|------------|----------------|------------------------------------------| -| LOW_OPTIMAL_SIZE | NUMBER(38) | NO | workarea 在 optimal 模式下最低内存量 | -| HIGH_OPTIMAL_SIZE | NUMBER(38) | NO | workarea 在 optimal 模式下最高内存量 | -| OPTIMAL_EXECUTIONS | NUMBER(38) | NO | workarea 在最低和最高区间的最优模式下执行的次数 | -| ONEPASS_EXECUTIONS | NUMBER(38) | NO | workarea 在最低和最高区间的 one pass 模式下执行的次数 | -| MULTIPASSES_EXECUTIONS | NUMBER(38) | NO | workarea 在最低和最高区间的 multi passes 模式下执行的次数 | -| TOTAL_EXECUTIONS | NUMBER(38) | NO | workarea 总共执行的次数 | -| CON_ID | NUMBER(38) | NO | 租户 ID | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/46.v-sysstat-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/46.v-sysstat-1.md deleted file mode 100644 index ed7f58aad..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/46.v-sysstat-1.md +++ /dev/null @@ -1,39 +0,0 @@ -V$SYSSTAT -============================== - - - -**功能** ---------------------------- - -该视图用于展示当前服务器上系统级别的一些统计信息。 - -其中: - -* STATISTIC# 表示统计项编号,同一统计项的编号在不同 OBServer 版本中可能会发生变化。 - - - -* STAT_ID 表示统计项 ID,同一统计项的 ID 在不同 OBServer 版本中保证相同。 - - - - - - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|------------|--------------|----------------|--------| -| CON_ID | NUMBER(38) | NO | 租户 ID | -| STATISTIC# | NUMBER(38) | NO | 统计项编号 | -| VALUE | NUMBER(38) | NO | 统计项值 | -| STAT_ID | NUMBER(38) | NO | 统计项 ID | -| NAME | VARCHAR2(64) | NO | 统计项名称 | -| CLASS | NUMBER(38) | NO | 统计项类别 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/47.v-system_event-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/47.v-system_event-1.md deleted file mode 100644 index b863ea894..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/47.v-system_event-1.md +++ /dev/null @@ -1,31 +0,0 @@ -V$SYSTEM_EVENT -=================================== - - - -**功能** ---------------------------- - -该视图用于展示当前服务器上租户系统级别的一些等待事件,统计每一类等待事件的发生次数、等待时间、超时次数等。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-------------------|--------------|----------------|-----------------| -| CON_ID | NUMBER(38) | NO | 租户ID | -| EVENT_ID | NUMBER(38) | NO | 等待事件 ID | -| EVENT | VARCHAR2(64) | NO | 等待事件名称 | -| WAIT_CLASS_ID | NUMBER(38) | NO | 等待事件类别 ID | -| WAIT_CLASS# | NUMBER(38) | NO | 等待事件类别编号 | -| WAIT_CLASS | VARCHAR2(64) | NO | 得到事件类别名称 | -| TOTAL_WAITS | NUMBER(38) | NO | 总等待次数 | -| TOTAL_TIMEOUTS | NUMBER(38) | NO | 等待超时次数 | -| TIME_WAITED | NUMBER(38) | NO | 总等待时间,单位为百分之一秒 | -| AVERAGE_WAIT | NUMBER(38) | NO | 平均等待时间,单位为百分之一秒 | -| TIME_WAITED_MICRO | NUMBER(38) | NO | 总等待时间,单位为微秒 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/48.v-version.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/48.v-version.md deleted file mode 100644 index 3dc285bb5..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/48.v-version.md +++ /dev/null @@ -1,36 +0,0 @@ -V$VERSION -============================== - - - -**功能** ---------------------------- - -查看数据库产品所有组件的名称和版本信息。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------|-----------------|----------------|-----------| -| BANNER | VARCHAR2(65536) | YES | 产品的名字及版本号 | -| CON_ID | NUMBER | NO | 容器 ID | - - - -示例 ------------------------ - -```sql -obclient> SELECT * FROM V$VERSION; -+---------------------------------------------------------------------------------------------+--------+ -| BANNER | CON_ID | -+---------------------------------------------------------------------------------------------+--------+ -| OceanBase 2.2.30 (r1-f2fc546f0eb229d2c1cb9cf957b481db2b52bb4d) (Built Oct 21 2019 21:23:43) | 0 | -+---------------------------------------------------------------------------------------------+--------+ -1 row in set (0.03 sec) -``` - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/49.v-sql_monitor_statname-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/49.v-sql_monitor_statname-1.md deleted file mode 100644 index 527078293..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/49.v-sql_monitor_statname-1.md +++ /dev/null @@ -1,31 +0,0 @@ -V$SQL_MONITOR_STATNAME -=========================================== - - - -**功能** ---------------------------- - -本表用于解释 GV$SQL_PLAN_MONITOR 的 OTHERSTAT_X_ID 字段中数字的含义。 - -**相关视图或表** -------------------------------- - -GV$SQL_PLAN_MONITOR - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-------------|---------------|----------------|--------------------------| -| CON_ID | NULL | NO | 租户 ID | -| ID | NUMBER(38) | NO | 字段 ID | -| GROUP_ID | NUMBER(38) | NO | 字段分类 ID 。同一类算子会共享一个分类 ID | -| NAME | VARCHAR2(40) | NO | 字段名称 | -| DESCRIPTION | VARCHAR2(200) | NO | 字段详细描述 | -| TYPE | NUMBER | NO | 保留字段 | -| FLAGS | NUMBER | NO | 保留字段 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/5.gv-memory-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/5.gv-memory-1.md deleted file mode 100644 index d898672a5..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/5.gv-memory-1.md +++ /dev/null @@ -1,28 +0,0 @@ -GV$MEMORY -============================== - - - -功能 ------------ - -该视图用于展示所有服务器上每个租户的内存使用状况。 - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-------------|----------------|----------------|-------------------------------------| -| CON_ID | NUMBER(38) | NO | 租户 ID | -| SVR_IP | VARCHAR2(32) | NO | 服务器的 IP 地址 | -| SVR_PORT | NUMBER(38) | NO | 服务器端口号 | -| CONTEXT | VARCHAR2(256) | NO | 内存模块名称 | -| COUNT | decimal(20, 0) | NO | alloc 与 free 的差值,当前该 mod 使用中的内存单元个数 | -| USED | decimal(20, 0) | NO | 该 mod 当前使用的内存数值,单位:Byte | -| ALLOC_COUNT | decimal(20, 0) | NO | 内存申请的总个数 | -| FREE_COUNT | decimal(20, 0) | NO | 内存释放的总个数 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/50.v-restore_point-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/50.v-restore_point-1.md deleted file mode 100644 index 2dde4c608..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/50.v-restore_point-1.md +++ /dev/null @@ -1,23 +0,0 @@ -V$RESTORE_POINT -==================================== - - - -**功能** ---------------------------- - -显示有关还原点的信息。 - -**字段说明** ------------------------------ - - - -| 字段名称 | 类型 | **是否可以为 NULL** | **描述** | -|-----------|-----------------------------------|----------------|----------------| -| TENANT_ID | NUMBER(38) | YES | 租户 ID | -| SCN | NUMBER(38) | NO | 创建还原点时的数据库 SCN | -| TIME | TIMESTAMP(6) WITH LOCAL TIME ZONE | NO | 创建还原点时的时间 | -| NAME | VARCHAR2(512) | YES | 还原点名称 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/51.v-global_transaction.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/51.v-global_transaction.md deleted file mode 100644 index 277bc7ce3..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/51.v-global_transaction.md +++ /dev/null @@ -1,30 +0,0 @@ -V$GLOBAL_TRANSACTION -========================================= - - - -**功能** ---------------------------- - -显示当前活跃的全局事务的信息。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|--------------|---------------|----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| FORMATID | NUMBER(38) | NO | 全局事务的格式标识符 | -| GLOBALID | VARCHAR2(256) | NO | 服务器 IP | -| BRANCHID | VARCHAR2(256) | NO | 服务器端口号 | -| BRANCHES | NUMBER(38) | NO | 全局事务的标识符 | -| REFCOUNT | NUMBER(38) | NO | 全局事务的分支资格 | -| PREPARECOUNT | NUMBER | NO | 全局事务中的分支机构总数 | -| STATE | CHAR(6) | NO | 全局事务的同级数,必须与分支机构相同 | -| FLAGS | NUMBER | NO | 已准备的全局事务分支机构数 | -| COUPLING | CHAR(15) | NO | 全局事务分支的状态: * ACTIVE * COLLECTING * FINALIZED * FAILED * RECOVERING * UNASSOCIATED * FORGOTTEN * READY FOR RECOVERY * NO-READONLY FAILED * SIBLING INFO WRITTEN * \[ORACLE COORDINATED\]ACTIVE * \[ORACLE COORDINATED\]COLLECTING * \[ORACLE COORDINATED\]FINALIZED * \[ORACLE COORDINATED\]FAILED * \[ORACLE COORDINATED\]RECOVERING * \[ORACLE COORDINATED\]UNASSOCIATED * \[ORACLE COORDINATED\]FORGOTTEN * \[ORACLE COORDINATED\]READY FOR RECOVERY * \[ORACLE COORDINATED\]NO-READONLY FAILED * \[MULTINODE\]ACTIVE * \[MULTINODE\]COLLECTING * \[MULTINODE\]FINALIZED * \[MULTINODE\]FAILED * \[MULTINODE\]RECOVERING * \[MULTINODE\]UNASSOCIATED * \[MULTINODE\]FORGOTTEN * \[MULTINODE\]READY FOR RECOVERY * \[MULTINODE\]NO-READONLY FAILED * \[MULTINODE\]SIBLING INFO WRITTEN * COMBINATION | -| CON_ID | VARCHAR2(256) | NO | 状态的数字表示 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/52.v-timezone_names.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/52.v-timezone_names.md deleted file mode 100644 index 6e851fb47..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/52.v-timezone_names.md +++ /dev/null @@ -1,22 +0,0 @@ -V$TIMEZONE_NAMES -===================================== - - - -**功能** ---------------------------- - -显示有效的时区名称。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------|---------------|----------------|----------------| -| TZNAME | varchar(64) | NO | 时区区域 | -| TZABBREV | varchar(8) | NO | 相对时间缩写(例如,PDT) | -| CON_ID | decimal(38,0) | NO | 租户 ID | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/53.v-nls_parameters-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/53.v-nls_parameters-1.md deleted file mode 100644 index 95a538483..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/53.v-nls_parameters-1.md +++ /dev/null @@ -1,22 +0,0 @@ -V$NLS_PARAMETERS -===================================== - - - -**功能** ---------------------------- - -查看租户级别的 NLS 参数。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-----------|----------------|----------------|-----------------| -| PARAMETER | varchar(128) | NO | 参数名称 | -| VALUE | varchar(65536) | YES | 参数取值 | -| CON_ID | bigint(1) | NO | 容器 ID。目前该字段暂未使用 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/54.v-lock-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/54.v-lock-1.md deleted file mode 100644 index 4378facbf..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/54.v-lock-1.md +++ /dev/null @@ -1,29 +0,0 @@ -V$LOCK -=========================== - - - -**功能** ---------------------------- - -展示 OceanBase 数据库的行锁信息。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------|---------------|----------------|-------------------| -| TABLE_ID | NUMBER(38) | NO | 表 ID | -| ADDR | varchar(512) | NO | 被锁对象的地址 | -| KADDR | NUMBER(38) | NO | 锁地址 | -| SID | NUMBER(38) | NO | 会话持有的 ID | -| TYPE | NUMBER(38) | NO | 0(行锁) | -| LMODE | NUMBER(38) | NO | 0(写锁) | -| REQUEST | NUMBER | YES | Null | -| CTIME | NUMBER(38) | NO | 加锁耗时 | -| BLOCK | NUMBER(38) | NO | 最早被阻塞的 session_id | -| CON_ID | VARCHAR2(256) | NO | 租户 ID | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/55.v-encrypted_tables-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/55.v-encrypted_tables-1.md deleted file mode 100644 index 943e5482f..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/55.v-encrypted_tables-1.md +++ /dev/null @@ -1,29 +0,0 @@ -V$ENCRYPTED_TABLES -======================================= - - - -功能 ------------------------ - -V$ENCRYPTED_TABLES 用于展示开启加密功能的表的加密状态。 - -字段说明 -------------------------- - - - -| **字段名称** | **类型** | **是否可以为空** | **描述** | -|------------------|---------------|------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| TABLE_ID | NUMBER(38) | NO | 表 ID | -| TABLE_NAME | VARCHAR2(256) | NO | 表名称 | -| TABLESPACE_ID | NUMBER(38) | NO | 表空间 ID | -| ENCRYPTIONALG | VARCHAR2(30) | NO | 加密算法名: * AES-128 * AES-192 * AES-256 * SM4 | -| ENCRYPTED | VARCHAR2(3) | NO | 是否完成加密: * YES * NO | -| ENCRYPTEDKEY | VARCHAR2(32) | NO | 经过主密钥加密后的加密密钥 | -| MASTERKEYID | NUMBER(38) | NO | 主密钥版本 | -| BLOCKS_ENCRYPTED | NUMBER | NO | 加密宏块的数量 | -| BLOCKS_DECRYPTED | NUMBER | NO | 未加密宏块的数量 | -| STATUS | VARCHAR2(10) | NO | 加密状态: * NORMAL:正常状态 * ENCRYPTING:加密中 * DECRYPTING:解密中 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/56.v-encrypted_tablespaces-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/56.v-encrypted_tablespaces-1.md deleted file mode 100644 index 8498688f5..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/56.v-encrypted_tablespaces-1.md +++ /dev/null @@ -1,27 +0,0 @@ -V$ENCRYPTED_TABLESPACES -============================================ - - - -功能 ------------------------ - -V$ENCRYPTED_TABLESPACES 用于展示开启加密功能的表空间的加密状态。 - -字段说明 -------------------------- - - - -| **字段名称** | **类型** | **是否可以为空** | **描述** | -|------------------|--------------|------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| TABLESPACE_ID | NUMBER(38) | NO | 表空间 ID | -| ENCRYPTIONALG | VARCHAR2(30) | NO | 加密算法名: * AES-128 * AES-192 * AES-256 * SM4 | -| ENCRYPTED | VARCHAR2(3) | NO | 是否完成加密: * YES * NO | -| ENCRYPTEDKEY | VARCHAR2(32) | NO | 经过主密钥加密后的加密密钥 | -| MASTERKEYID | NUMBER(38) | NO | 主密钥版本 | -| BLOCKS_ENCRYPTED | NUMBER | NO | 加密宏块的数量 | -| BLOCKS_DECRYPTED | NUMBER | NO | 未加密宏块的数量 | -| STATUS | VARCHAR2(10) | NO | 加密状态: * NORMAL:正常状态 * ENCRYPTING:加密中 * DECRYPTING:解密中 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/57.v-global_transaction-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/57.v-global_transaction-1.md deleted file mode 100644 index 6bc0ca78a..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/57.v-global_transaction-1.md +++ /dev/null @@ -1,32 +0,0 @@ -V$GLOBAL_TRANSACTION -========================================= - - - -功能 ------------ - -该视图用于展示当前服务器上当前活跃的全局事务(主要包括 XA 事务)的信息。 - -字段说明 -------------- - - - -| **字段** | **类型** | **是否可以为NULL** | **说明** | -|--------------|--------------|---------------|------------------------------------------| -| SVR_IP | RAW(64) | NO | 服务器 IP | -| SVR_PORT | NUMBER | NO | 服务器端口号 | -| FORMATID | NUMBER | NO | 全局事务格式标识符 | -| GLOBALID | RAW(64) | NO | 全局事务事务标识符 | -| BRANCHID | RAW(64) | NO | 全局事务分支限定符 | -| BRANCHES | NUMBER | NO | 该全局事务中分支总数 | -| REFCOUNT | NUMBER | NO | 同上 | -| PREPARECOUNT | NUMBER | NO | 该全局事务中已 PREPARED 的分支总数 | -| STATE | VARCHAR2(38) | NO | 该分支的状态 | -| FLAGS | NUMBER | NO | 该分支状态的数字表示 | -| COUPLING | VARCHAR2(15) | NO | 分支间的关系(TIGHTLY COUPLED或者LOOSELY COUPLED) | -| CON_ID | NUMBER | NO | 租户 ID | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/58.v-rsrc_plan.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/58.v-rsrc_plan.md deleted file mode 100644 index c6b973e8e..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/58.v-rsrc_plan.md +++ /dev/null @@ -1,27 +0,0 @@ -V$RSRC_PLAN -================================ - - - -功能 ------------------------ - -`V$RSRC_PLAN` 视图用于展示当前活跃租户的资源管理计划。 - -字段说明 -------------------------- - - - -| 字段名称 | 类型 | 是否可以为 NULL | 描述 | -|----------------------------|---------------|------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| ID | NUMBER | NO | 资源计划 ID,全局唯一。 | -| NAME | VARCHAR2(128) | NO | 资源计划名称。 | -| IS_TOP_PLAN | VARCHAR2(5) | NO | 当前资源计划是否为当前设定的顶层计划: * `TRUE`:表示当前资源计划是当前设定的顶层计划 * `FLASE`:表示当前资源计划是当前顶层计划的子计划 目前,OceanBase 数据库中该值固定为 `TRUE`。 | -| CPU_MANAGED | VARCHAR2(3) | NO | 当前资源计划是否设置了参数来管理 CPU 的使用率: * `ON`:已设置 * `OFF`:未设置 目前,OceanBase 数据库中该值固定为 `ON`。 | -| INSTANCE_CAGING | VARCHAR2(3) | NO | 仅用于兼容,目前该值固定为 `NULL`。 | -| PARALLEL_SERVERS_ACTIVE | NUMBER | NO | 仅用于兼容,目前该值固定为 `NULL`。 | -| PARALLEL_SERVERS_TOTAL | NUMBER | NO | 仅用于兼容,目前该值固定为 `NULL`。 | -| PARALLEL_EXECUTION_MANAGED | VARCHAR2(32) | NO | 仅用于兼容,目前该值固定为 `NULL`。 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/59.v-open_cursor.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/59.v-open_cursor.md deleted file mode 100644 index 7e7366c78..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/59.v-open_cursor.md +++ /dev/null @@ -1,28 +0,0 @@ -V$OPEN_CURSOR -================================== - - - -功能 ------------------------ - -`V$OPEN_CURSOR` 视图用于展示被缓存在 Plan Cache 中的执行计划的信息。 - -字段说明 -------------------------- - - - -| 字段名称 | 类型 | 是否可以为 NULL | 描述 | -|----------------------|--------------|------------|------------------------------------------------| -| SADDR | VARCHAR2(8) | NO | Session 所在的内存地址。 | -| SID | NUMBER(38) | NO | Session ID。 | -| USER_NAME | VARCHAR2(30) | NO | 用户名。 | -| ADDRESS | VARCHAR2(8) | NO | SQL 地址,与 SQL 的 Hash 值一起唯一定位一个 SQL,目前值为 `NULL`。 | -| HASH_VALUE | NUMBER(38) | NO | SQL 的 Hash 值。 | -| SQL_ID | VARCHAR2(32) | NO | SQL ID。 | -| SQL_TEXT | VARCHAR2(60) | NO | SQL 的文本的前 60 个字符。 | -| LAST_SQL_ACTIVE_TIME | DATE | NO | 最后一次执行 SQL 计划的时间。 | -| SQL_EXEC_ID | NUMBER(38) | NO | 如果 SQL 计划正在被执行,则显示对应的 SQL ID。 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/6.gv-memstore-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/6.gv-memstore-1.md deleted file mode 100644 index ef5f76da3..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/6.gv-memstore-1.md +++ /dev/null @@ -1,28 +0,0 @@ -GV$MEMSTORE -================================ - - - -功能 ------------ - -该视图用于展示所有服务器上所有租户的 Memtable 的内存使用状况。 - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|----------------|--------------|----------------|------------------------------| -| CON_ID | NUMBER(38) | NO | 租户 ID | -| SVR_IP | VARCHAR2(32) | NO | 服务器的 IP | -| SVR_PORT | NUMBER(38) | NO | 服务器端口 | -| ACTIVE | NUMBER(38) | NO | 当前活跃的 Memtable 的内存占用大小,单位为字节 | -| TOTAL | NUMBER(38) | NO | 当前所有 Memtable 的内存占用大小,单位为字节 | -| FREEZE_TRIGGER | NUMBER(38) | NO | 触发 Memtable 冻结的内存大小,单位为字节 | -| MEM_LIMIT | NUMBER(38) | NO | Memtable 的内存大小限制,单位为字节 | -| FREEZE_CNT | NUMBER(38) | NO | Memtable 的冻结次数 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/60.v-sstable-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/60.v-sstable-1.md deleted file mode 100644 index 996e1c766..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/60.v-sstable-1.md +++ /dev/null @@ -1,40 +0,0 @@ -V$SSTABLE -============================== - - - -功能 ------------------------ - -`V$SSTABLE` 视图用于展示租户的 SSTable 信息。 - -字段说明 -------------------------- - - - -| 字段名称 | 类型 | 是否可以为 NULL | 描述 | -|--------------------------------|---------------|------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------| -| TABLE_TYPE | NUMBER(38) | NO | 表的类型 | -| TABLE_ID | NUMBER(38) | NO | 表 ID | -| TABLE_NAME | VARCHAR2(256) | NO | 表名 | -| TENANT_ID | NUMBER(38) | NO | 租户 ID | -| PARTITION_ID | NUMBER(38) | NO | 分区 ID | -| INDEX_ID | NUMBER(38) | NO | 主表或索引表的 ID | -| BASE_VERSION | NUMBER(38) | NO | 该表中存储数据的 `trans_version` 范围的最小值 | -| MULTI_VERSION_START | NUMBER(38) | NO | 该表中多版本数据的起始 `trans_version` | -| SNAPSHOT_VERSION | NUMBER(38) | NO | 该表中存储数据的 `trans_version` 范围的最大值 | -| START_LOG_TS | NUMBER(38) | NO | 该表中数据的日志时间戳范围的左边界 | -| END_LOG_TS | NUMBER(38) | NO | 该表中数据的日志时间戳范围的右边界 | -| MAX_LOG_TS | NUMBER(38) | NO | 该表中数据的日志时间戳范围的最大值 | -| VERSION | NUMBER(38) | NO | 该表的版本 | -| SIZE | NUMBER(38) | NO | 该表的大小 | -| IS_ACTIVE | NUMBER(38) | NO | 该表是否处于活跃状态 | -| REF | NUMBER(38) | NO | 该表引用的计数 | -| WRITE_REF | NUMBER(38) | NO | 该表写引用的计数 | -| TRX_COUNT | NUMBER(38) | NO | 该表上活跃事务的数量 | -| PENDING_LOG_PERSISTING_ROW_CNT | NUMBER(38) | NO | 持久化 Redo Log 的回收数量 | -| UPPER_TRANS_VERSION | NUMBER(38) | NO | 该表中存储数据的 `trans_version` 的上限 | -| CONTAIN_UNCOMMITTED_ROW | NUMBER(38) | NO | 该表是否包含未提交的事务行: * 0:表示该表中不包含未提交的事务行 * 1:表示该表中包含未提交的事务行 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/7.gv-memstore_info-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/7.gv-memstore_info-1.md deleted file mode 100644 index 5e7d680ca..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/7.gv-memstore_info-1.md +++ /dev/null @@ -1,32 +0,0 @@ -GV$MEMSTORE_INFO -===================================== - - - -功能 ------------ - -该视图用于展示所有服务器上所有租户的所有分区的 Memtable 的详细信息。 - -字段说明 -------------- - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|---------------------|---------------|----------------|----------------| -| CON_ID | NUMBER(38) | NO | 租户 ID | -| SVR_IP | VARCHAR2(32) | NO | 服务器的 IP | -| SVR_PORT | NUMBER(38) | NO | 服务器端口 | -| TABLE_ID | NUMBER(38) | NO | 表 ID | -| PARTITION_ID | NUMBER(38) | NO | 分区 ID | -| VERSION | VARCHAR2(128) | NO | 冻结版本号 | -| BASE_VERSION | NUMBER(38) | NO | 数据的快照版本号的左边界 | -| MULTI_VERSION_START | NUMBER(38) | NO | 最小的老版本数据的快照版本号 | -| SNAPSHOT_VERSION | NUMBER(38) | NO | 数据的快照版本号的右边界 | -| IS_ACTIVE | NUMBER(38) | NO | 是否是活跃的 | -| USED | NUMBER(38) | NO | 使用的内存大小,单位为字节 | -| HASH_ITEMS | NUMBER(38) | NO | Hash 索引中记录的行数 | -| BTREE_ITEMS | NUMBER(38) | NO | Btree 索引中记录的行数 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/8.gv-ob_sql_workarea_memory_info-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/8.gv-ob_sql_workarea_memory_info-1.md deleted file mode 100644 index a9daa70cd..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/8.gv-ob_sql_workarea_memory_info-1.md +++ /dev/null @@ -1,29 +0,0 @@ -GV$OB_SQL_WORKAREA_MEMORY_INFO -=================================================== - - - -**功能** ---------------------------- - -表示查询 SQL workarea 总体的一些信息,包括最大可用内存、当前使用内存、当前 hold 内存等。通过该视图可以知道当前租户下 workarea 的使用情况,例如内存利用率等。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|------------------------|------------|----------------|--------------------------------------------------------------------------------------------------------------------------------------| -| MAX_WORKAREA_SIZE | NUMBER(38) | NO | 最大 workarea 内存,由参数决定可以使用多少内存 | -| WORKAREA_HOLD_SIZE | NUMBER(38) | NO | workarea 当前 hold 内存大小 **说明** 由于具体的使用量无法从内存管理模块获取到,故只能获取 hold 值。 | -| MAX_AUTO_WORKAREA_SIZE | NUMBER(38) | NO | auto 时,预计最大可用内存大小 可以简单认为最大可用内存会根据公式 `max_work_area_size - hold + total_mem_used `计算得到,表示当前workarea情况下,auto 管理的最大内存大小 | -| MEM_TARGET | NUMBER(38) | NO | 当前 workarea 可用内存的目标大小,与max_auto_work_area 的区别在于该值是 max_auto_work_area 的一定比例 | -| TOTAL_MEM_USED | NUMBER(38) | NO | 当前 auto 内存的使用大小,这里是由 SQL 自动内存管理模块统计的大小,不是真正使用大小 | -| GLOBAL_MEM_BOUND | NUMBER(38) | NO | auto 模式下,全局最大可用内存大小 | -| DRIFT_SIZE | NUMBER(38) | NO | 当前需求内存变化大小,主要用来当波动一定范围,会自动触发重新计算 global bound size | -| WORKAREA_COUNT | NUMBER(38) | NO | 注册的 operator profile 个数 | -| MANUAL_CALC_COUNT | NUMBER(38) | NO | 非定时触发的计算 global bound size 次数 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/9.gv-outline-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/9.gv-outline-1.md deleted file mode 100644 index 020009b9e..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/1.system-view-1/2.performance-view-1/9.gv-outline-1.md +++ /dev/null @@ -1,29 +0,0 @@ -GV$OUTLINE -=============================== - - - -**功能** ---------------------------- - -展示当前租户的 Outline 信息。 - -**字段说明** ------------------------------ - - - -| **字段名称** | **类型** | **是否可以为 NULL** | **描述** | -|-------------------|-----------------|----------------|---------------------------------------| -| TENANT_ID | NUMBER(38) | NO | 租户 ID | -| DATABASE_ID | NUMBER(38) | NO | 数据库 ID | -| OUTLINE_ID | NUMBER(38) | NO | Outline ID | -| DATABASE_NAME | VARCHAR2(128) | NO | 数据库名称 | -| OUTLINE_NAME | VARCHAR2(128) | NO | Outline 名称 | -| VISIBLE_SIGNATURE | VARCHAR2(65536) | NO | Signature 的反序列化结果,为了便于查看signature 的信息 | -| SQL_TEXT | VARCHAR2(65536) | NO | 创建 Outline 时,在 on clause 中指定的 SQL | -| OUTLINE_TARGET | VARCHAR2(65536) | NO | 创建 Outline 时,在 to clause 中指定的 SQL | -| OUTLINE_SQL | VARCHAR2(65536) | NO | 具有完整 Outline 信息的 SQL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/1.overview-of-system-variables-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/1.overview-of-system-variables-1.md deleted file mode 100644 index ef516960d..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/1.overview-of-system-variables-1.md +++ /dev/null @@ -1,35 +0,0 @@ -系统变量概述 -=========================== - - - -OceanBase 数据库的系统变量主要分为全局变量和 Session 变量: - -* 全局变量:表示 Global 级别的修改,数据库同一租户内的不同用户共享全局变量。全局变量的修改不会随会话的退出而失效。此外,全局变量修改后,对当前已打开的 Session 不生效,需要重新建立 Session 才能生效。 - - - -* Session 变量:表示 Session 级别的修改。当客户端连接到数据库后,数据库会复制全局变量来自动生成 Session 变量。Session 变量的修改仅对当前 Session 生效。 - - - - - - -与系统配置项对比 ------------------------------ - - - -| 对比项 | 系统配置项 | 系统变量 | -|------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 生效范围 | 分为集群、Zone、机器和租户。 | 分为租户的 Global 或 Session 级别。 | -| 生效方式 | * 动态生效:`edit_level` 为`dynamic_effective`。 * 重启生效:`edit_level` 为 `static_effective` 。 | * 设置 Session 级别的变量仅对当前 Session 有效,对其他 Session 无效。 * 设置 Global 级别的变量对当前 Session 无效,需要重新登录建立新的 Session 才会生效。 | -| 修改方式 | * 支持通过 SQL 语句修改,示例如下: ```sql obclient> Alter SYSTEM SET schema_history_expire_time='1h' ``` * 支持通过启动参数修改,示例如下: ```sql cd /home/admin && ./bin/observer -o "schema_history_expire_time='1h'" ``` | 仅支持通过 SQL 语句修改,示例如下: * MySQL 模式 ```sql obclient> SET ob_query_timeout = 20000000; obclient> SET GLOBAL ob_query_timeout = 20000000; ``` * Oracle 模式 ```sql obclient> SET ob_query_timeout = 20000000; obclient> ALTER SYSTEM SET ob_query_timeout = 20000000; ``` | -| 持久化 | 持久化到内部表与配置文件,可以在 `/home/admin/oceanbase/etc/observer.config.bin` 与 `/home/admin/oceanbase/etc/observer.config.bin.history` 文件中查询该配置项。 | 仅 GLOBAL 级别的变量会持久化,SESSION 级别的变量不会进行持久化。 | -| 生命周期 | 长,从进程启动到退出。 | 短,需要租户的 Schema 创建成功以后才生效。 | -| 查询方式 | 可以使用 `SHOW PARAMETERS` 语句查询。 | 可以使用 `SHOW [GLOBAL] VARIABLES` 语句查询。 | - - - -本章主要介绍 OceanBase 数据库中的所有系统变量及其缺省值说明(包括参数含义、取值范围和使用说明等)。系统变量的查看和设置相关操作,请参见 [租户管理变量](../../6.administrator-guide/3.basic-database-management/5.tenants/9.tenant-management-variables.md)章节。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/10.collation_connection-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/10.collation_connection-1.md deleted file mode 100644 index 828e60b5e..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/10.collation_connection-1.md +++ /dev/null @@ -1,18 +0,0 @@ -collation_connection -========================================= - -collation_connection 用于设置连接使用的字符集和字符序。 - - -| **属性** | **描述** | -|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | string | -| 默认值 | utf8mb4_general_ci | -| 取值范围 | * utf8mb4_general_ci * utf8mb4_bin * utf8mb4_unicode_ci * gbk_bin * gbk_chinese_ci * gb18030_bin * gb18030_chinese_ci * utf16_general_ci * utf16_bin * utf16_unicode_ci * binary | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | -| 是否影响计划生成 | 是 | -| 是否可以为空 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/100.ob_reserved_meta_memory_percentage-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/100.ob_reserved_meta_memory_percentage-1.md deleted file mode 100644 index 3fda67f04..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/100.ob_reserved_meta_memory_percentage-1.md +++ /dev/null @@ -1,15 +0,0 @@ -ob_reserved_meta_memory_percentage -======================================================= - -ob_reserved_meta_memory_percentage 用于设置租户预留内存的比例,主要存储 Meta 相关的结构信息。 - - -| **属性** | **描述** | -|---------|----------| -| 参数类型 | int | -| 默认值 | 10 | -| 取值范围 | \[1,100) | -| 生效范围 | GLOBAL | -| 是否参与序列化 | 是 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/101.nls_date_format.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/101.nls_date_format.md deleted file mode 100644 index 1d77bfb58..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/101.nls_date_format.md +++ /dev/null @@ -1,15 +0,0 @@ -nls_date_format -==================================== - -nls_date_format 用于控制 date 类型转 str 的格式,以及 str 隐式转 date 的格式。 - - -| **属性** | **描述** | -|---------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | varchar | -| 默认值 | DD-MON-RR | -| 取值范围 | NULL | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/102.nls_timestamp_format.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/102.nls_timestamp_format.md deleted file mode 100644 index fc25d7176..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/102.nls_timestamp_format.md +++ /dev/null @@ -1,15 +0,0 @@ -nls_timestamp_format -========================================= - -nls_timestamp_format 用于控制 timestamp 或 timestamp ltz 类型转 str 的格式,以及 str 隐式转 timestamp 或 timestamp ltz 的格式。 - - -| **属性** | **描述** | -|---------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | varchar | -| 默认值 | DD-MON-RR HH.MI.SSXFF AM | -| 取值范围 | NULL | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/103.nls_timestamp_tz_format.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/103.nls_timestamp_tz_format.md deleted file mode 100644 index f815e1230..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/103.nls_timestamp_tz_format.md +++ /dev/null @@ -1,15 +0,0 @@ -nls_timestamp_tz_format -============================================ - -nls_timestamp_tz_format 用于控制 timestamp tz 类型转 str 的格式,以及 str 隐式转 timestamp tz 的格式。 - - -| **属性** | **描述** | -|---------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | varchar | -| 默认值 | DD-MON-RR HH.MI.SSXFF AM TZR | -| 取值范围 | NULL | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/104.nls_language.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/104.nls_language.md deleted file mode 100644 index 2cff5941f..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/104.nls_language.md +++ /dev/null @@ -1,16 +0,0 @@ -nls_language -================================= - -nls_language 表示数据库国际化支持中的默认语言,用于提示信息、日期、月份名以及 NLS_SORT 和NLS_DATE_LANGUAGE 的默认值。 - - -| **属性** | **描述** | -|---------|---------| -| 参数类型 | varchar | -| 默认值 | AMERICA | -| 取值范围 | AMERICA | -| 生效范围 | SESSION | -| 是否参与序列化 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/105.nls_territory.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/105.nls_territory.md deleted file mode 100644 index 42ba77275..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/105.nls_territory.md +++ /dev/null @@ -1,16 +0,0 @@ -nls_territory -================================== - -nls_territory 表示数据库国际化支持中的当前地域,与 nls_language 结合使用。 - - -| **属性** | **描述** | -|---------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | varchar | -| 默认值 | AMERICA | -| 取值范围 | AMERICA | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/106.nls_sort.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/106.nls_sort.md deleted file mode 100644 index 6b4b08e59..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/106.nls_sort.md +++ /dev/null @@ -1,17 +0,0 @@ -nls_sort -============================= - -nls_sort 表示字符串值的排序规则。 - - -| **属性** | **描述** | -|----------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | varchar | -| 默认值 | BINARY | -| 取值范围 | BINARY | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | -| 是否影响计划生成 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/107.nls_comp.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/107.nls_comp.md deleted file mode 100644 index d23e74b47..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/107.nls_comp.md +++ /dev/null @@ -1,17 +0,0 @@ -nls_comp -============================= - -nls_comp 表示字符串值的比较规则。 - - -| **属性** | **描述** | -|----------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | varchar | -| 默认值 | BINARY | -| 取值范围 | BINARY | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | -| 是否影响计划生成 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/108.nls_characterset.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/108.nls_characterset.md deleted file mode 100644 index 9d66215d1..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/108.nls_characterset.md +++ /dev/null @@ -1,18 +0,0 @@ -nls_characterset -===================================== - -nls_characterset 表示数据库默认字符集,用于 CHAR、VARCHAR2、LONG、CLOB 等数据类型。 - - -| **属性** | **描述** | -|----------|----------| -| 参数类型 | varchar | -| 默认值 | AL32UTF8 | -| 取值范围 | AL32UTF8 | -| 生效范围 | GLOBAL | -| 是否参与序列化 | 是 | -| 是否影响计划生成 | 是 | -| 是否可修改 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/109.nls_nchar_characterset.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/109.nls_nchar_characterset.md deleted file mode 100644 index 4b06c0e6d..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/109.nls_nchar_characterset.md +++ /dev/null @@ -1,17 +0,0 @@ -nls_nchar_characterset -=========================================== - -nls_nchar_characterset 表示数据库默认字符集,用于 NCHAR、NVARCHAR2、NCLOB 等数据类型。 - - -| **属性** | **描述** | -|----------|-----------| -| 参数类型 | varchar | -| 默认值 | AL16UTF16 | -| 取值范围 | AL16UTF16 | -| 生效范围 | GLOBAL | -| 是否参与序列化 | 是 | -| 是否影响计划生成 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/11.collation_database-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/11.collation_database-1.md deleted file mode 100644 index 896b93e2c..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/11.collation_database-1.md +++ /dev/null @@ -1,16 +0,0 @@ -collation_database -======================================= - -collation_database 设置创建数据库默认字符集和字符序。 - - -| **属性** | **描述** | -|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | string | -| 默认值 | utf8mb4_general_ci | -| 取值范围 | * utf8mb4_general_ci * utf8mb4_bin * utf8mb4_unicode_ci * gbk_bin * gbk_chinese_ci * gb18030_bin * gb18030_chinese_ci * utf16_general_ci * utf16_bin * utf16_unicode_ci * binary | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | -| 是否可以为空 | 是 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/110.nls_date_language.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/110.nls_date_language.md deleted file mode 100644 index 4a138fd84..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/110.nls_date_language.md +++ /dev/null @@ -1,16 +0,0 @@ -nls_date_language -====================================== - -nls_date_language 表示数据库国际化支持中的日期默认语言。用于 TO_DATE 和 TO_CHAR 输入或返回的日期、月份、上下午、公元前后等信息。 - - -| **属性** | **描述** | -|---------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | varchar | -| 默认值 | AMERICAN | -| 取值范围 | AMERICAN | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/111.nls_length_semantics.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/111.nls_length_semantics.md deleted file mode 100644 index ba5bb2864..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/111.nls_length_semantics.md +++ /dev/null @@ -1,17 +0,0 @@ -nls_length_semantics -========================================= - -nls_length_semantics 表示 char、varchar2 类型 的 length 语义。 - - -| **属性** | **描述** | -|----------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | varchar | -| 默认值 | BYTE | -| 取值范围 | * BYTE * CHAR | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | -| 是否影响计划生成 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/112.nls_calendar.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/112.nls_calendar.md deleted file mode 100644 index 183353125..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/112.nls_calendar.md +++ /dev/null @@ -1,16 +0,0 @@ -nls_calendar -================================= - -nls_calendar 用于控制数据库使用的日历系统。 - - -| **属性** | **描述** | -|---------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | varchar | -| 默认值 | GREGORIAN | -| 取值范围 | GREGORIAN | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/113.nls_nchar_conv_excp.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/113.nls_nchar_conv_excp.md deleted file mode 100644 index 0b944928e..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/113.nls_nchar_conv_excp.md +++ /dev/null @@ -1,17 +0,0 @@ -nls_nchar_conv_excp -======================================== - -nls_nchar_conv_excp 用于控制 NCHAR/NVARCHAR2 与 CHAR/VARCHAR2 之间转换丢失数据时是否报错。 - - -| **属性** | **描述** | -|----------|-------------------------------------------------------------------------------------------------------------------| -| 参数类型 | bool | -| 默认值 | FALSE | -| 取值范围 | * TRUE:表示报错 * FALSE:表示不报错 | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | -| 是否影响计划生成 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/114.nls_numeric_characters.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/114.nls_numeric_characters.md deleted file mode 100644 index 3df205dfc..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/114.nls_numeric_characters.md +++ /dev/null @@ -1,16 +0,0 @@ -nls_numeric_characters -=========================================== - -nls_numeric_characters 用于控制 number 和字符串转换中字符串中小数分隔符和千分位分隔符的字符。 - - -| **属性** | **描述** | -|---------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | varchar | -| 默认值 | 空字符串 | -| 取值范围 | NULL | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/115.tracefile_identifier-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/115.tracefile_identifier-1.md deleted file mode 100644 index 56c383e0e..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/115.tracefile_identifier-1.md +++ /dev/null @@ -1,17 +0,0 @@ -tracefile_identifier -========================================= - -tracefile_identifier 用于在日志中增加指定内容,便于筛选行迭代跟踪日志。 - - -| **属性** | **描述** | -|---------|---------| -| 参数类型 | varchar | -| 默认值 | 空字符串 | -| 取值范围 | NULL | -| 生效范围 | SESSION | -| 是否参与序列化 | 是 | - - - -使用 TRACING、STAT 两个 HINT 能够指示执行器在算子执行过程中打印每一行内容,为了让这些内容易于搜索识别,可以使用 tracefile_identifier 指定一个字符串,例如 `XXXYYYZZZ` 、 `MY_TRACE` 等和行内容一起输出到日志中,易于搜索。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/116.transaction_isolation-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/116.transaction_isolation-1.md deleted file mode 100644 index d5d9be484..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/116.transaction_isolation-1.md +++ /dev/null @@ -1,15 +0,0 @@ -transaction_isolation -========================================== - -transaction_isolation 用于设置事务的隔离级别。 - - -| **属性** | **描述** | -|---------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | varchar | -| 默认值 | READ-COMMITTED | -| 取值范围 | * READ-UNCOMMITTED * READ-COMMITTED * REPEATABLE-READ * SERIALIZABLE | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/117.ob_trx_lock_timeout-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/117.ob_trx_lock_timeout-1.md deleted file mode 100644 index 3e82ea3c3..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/117.ob_trx_lock_timeout-1.md +++ /dev/null @@ -1,15 +0,0 @@ -ob_trx_lock_timeout -======================================== - -ob_trx_lock_timeout 用于设置事务的等锁超时时长,单位为微秒。 - - -| **属性** | **描述** | -|---------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | int | -| 默认值 | -1 | -| 取值范围 | 有效取值范围:\[0,+∞) | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/118.ob_trace_info-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/118.ob_trace_info-1.md deleted file mode 100644 index 08339e179..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/118.ob_trace_info-1.md +++ /dev/null @@ -1,15 +0,0 @@ -ob_trace_info -================================== - -ob_trace_info 用于透传 trace 信息,该信息最终可透持久化到 REDO 日志中。 - - -| **属性** | **描述** | -|--------|-------------------| -| 参数类型 | varchar | -| 默认值 | 空字符串 | -| 取值范围 | 字符串长度为\[0, 4096\] | -| 生效范围 | SESSION | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/119.secure_file_priv-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/119.secure_file_priv-1.md deleted file mode 100644 index 1e5168218..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/119.secure_file_priv-1.md +++ /dev/null @@ -1,35 +0,0 @@ -secure_file_priv -===================================== - -secure_file_priv 控制导入或导出到文件时可以访问的路径。仅 DBA 可以设置该变量,其他人无法设置。 - - -| **属性** | **描述** | -|-----------|---------| -| 参数类型 | varchar | -| 默认值 | NULL | -| 取值范围 | ALL | -| 生效范围 | GLOBAL | -| 是否影响计划的生成 | 是 | -| 是否可为空 | 是 | - - - -对于该变量的值: - -* 如果设置为空串,则表示没有限制,任意路径均可以访问。 - - - -* 如果设置为路径名,则仅该路径下的文件可以被导入或导出。 - - - -* 如果设置为 `NULL`,则表示导入、导出被禁用。 - - - - - - -新建租户时,默认值将被设为 `NULL`,即导入、导出被禁用。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/12.collation_server-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/12.collation_server-1.md deleted file mode 100644 index 5b2575988..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/12.collation_server-1.md +++ /dev/null @@ -1,16 +0,0 @@ -collation_server -===================================== - -collation_server 用于设置服务器默认字符集和字符序。 - - -| **属性** | **描述** | -|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | string | -| 默认值 | utf8mb4_general_ci | -| 取值范围 | * utf8mb4_general_ci * utf8mb4_bin * utf8mb4_unicode_ci * gbk_bin * gbk_chinese_ci * gb18030_bin * gb18030_chinese_ci * utf16_general_ci * utf16_bin * utf16_unicode_ci * binary | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | -| 是否可以为空 | 是 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/120.ob_pl_block_timeout-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/120.ob_pl_block_timeout-1.md deleted file mode 100644 index a4f1445ce..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/120.ob_pl_block_timeout-1.md +++ /dev/null @@ -1,15 +0,0 @@ -ob_pl_block_timeout -======================================== - -ob_pl_block_timeout 用于设置 PL 的最大超时时间,单位 us。 - - -| 属性 | 描述 | -|---------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | int | -| 默认值 | 3216672000000000 | -| 取值范围 | \[0, 9223372036854775807\] | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/121.performance_schema-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/121.performance_schema-1.md deleted file mode 100644 index f783416bc..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/121.performance_schema-1.md +++ /dev/null @@ -1,15 +0,0 @@ -performance_schema -======================================= - -performance_schema 用于向客户端声明是否支持 performance 信息的查询。 - - -| 属性 | 描述 | -|--------|-----------------------------------------------------------------------------------------------------------| -| 参数类型 | bool | -| 默认值 | OFF | -| 取值范围 | * ON:支持 * OFF:不支持 | -| 生效范围 | GLOBAL | -| 是否重启生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/122.transaction_read_only-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/122.transaction_read_only-1.md deleted file mode 100644 index b8c65696f..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/122.transaction_read_only-1.md +++ /dev/null @@ -1,23 +0,0 @@ -transaction_read_only -========================================== - -transaction_read_only 配置项用于控制是否只允许开启只读事务。 -**注意** - - - -当前该变量暂未启用,即设置后不会生效。 - - -| 属性 | 描述 | -|---------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | bool | -| 默认值 | False | -| 取值范围 | * True * False | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是,即远程执行、分布式执行场景下,变量会参与序列化 | -| 是否重启生效 | 否 | - - - -当 transaction_read_only 设置为 `True` 时,不允许执行 DML 语句。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/123.nls_currency.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/123.nls_currency.md deleted file mode 100644 index 13e5bbbc6..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/123.nls_currency.md +++ /dev/null @@ -1,16 +0,0 @@ -nls_currency -================================= - -`nls_currency` 用于设置数字格式元素 `L` 的本地货币符号。 - - -| 属性 | 描述 | -|---------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | varchar | -| 默认值 | $ | -| 取值范围 | N/A | -| 生效范围 | * Global * Session | -| 是否参与序列化 | 是,即远程执行、分布式执行场景下,变量会参与序列化. | -| 是否重启生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/124.nls_iso_currency.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/124.nls_iso_currency.md deleted file mode 100644 index 66ad6cb6a..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/124.nls_iso_currency.md +++ /dev/null @@ -1,16 +0,0 @@ -nls_iso_currency -===================================== - -`nls_iso_currency` 用于设置数字格式元素 `C` 的本地货币符号。 - - -| 属性 | 描述 | -|---------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | varchar | -| 默认值 | AMERICA | -| 取值范围 | N/A | -| 生效范围 | * Global * Session | -| 是否参与序列化 | 是,即远程执行、分布式执行场景下,变量会参与序列化。 | -| 是否重启生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/125.nls_dual_currency.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/125.nls_dual_currency.md deleted file mode 100644 index e0bb2e691..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/125.nls_dual_currency.md +++ /dev/null @@ -1,16 +0,0 @@ -nls_dual_currency -====================================== - -`nls_dual_currency` 用于设置数字格式元素 `U` 的本地货币符号。 - - -| 属性 | 描述 | -|---------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | varchar | -| 默认值 | $ | -| 取值范围 | N/A | -| 生效范围 | * Global * Session | -| 是否参与序列化 | 是,即远程执行、分布式执行场景下,变量会参与序列化。 | -| 是否重启生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/126.resource_manager_plan-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/126.resource_manager_plan-1.md deleted file mode 100644 index a6c64aafa..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/126.resource_manager_plan-1.md +++ /dev/null @@ -1,17 +0,0 @@ -resource_manager_plan -========================================== - -`resource_manager_plan` 用于激活资源管理计划,以适当的参数限制不同负载使用 CPU 的额度。 - - -| 属性 | 描述 | -|--------|---------------| -| 参数类型 | varchar | -| 默认值 | "" | -| 取值范围 | N/A | -| 生效范围 | GLOBAL | -| 是否重启生效 | 否,设置后 10s 内生效 | - - - -租户内的普通线程和并行执行线程会相互抢占 CPU 资源,通过为租户指定资源隔离计划,可以控制资源抢占策略,限制资源的使用量。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/13.interactive_timeout-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/13.interactive_timeout-1.md deleted file mode 100644 index 7026fb806..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/13.interactive_timeout-1.md +++ /dev/null @@ -1,14 +0,0 @@ -interactive_timeout -======================================== - -interactive_timeout 用于设置服务器关闭交互式连接前等待活动的秒数。交互式客户端定义为在 mysql_real_connect() 中使用 CLIENT_INTERACTIVE 选项的客户端。 - - -| **属性** | **描述** | -|--------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | int | -| 默认值 | 28800 | -| 取值范围 | \[1, 31536000\] | -| 生效范围 | * GLOBAL * SESSION | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/14.last_insert_id-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/14.last_insert_id-1.md deleted file mode 100644 index 49e5caf01..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/14.last_insert_id-1.md +++ /dev/null @@ -1,14 +0,0 @@ -last_insert_id -=================================== - -last_insert_id 用于返回本 Session 最后一次插入的自增字段值。 - - -| **属性** | **描述** | -|--------|-----------------------------| -| 参数类型 | unit | -| 默认值 | 0 | -| 取值范围 | \[0, 18446744073709551615\] | -| 生效范围 | SESSION | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/15.max_allowed_packet-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/15.max_allowed_packet-1.md deleted file mode 100644 index 4c39d7e6c..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/15.max_allowed_packet-1.md +++ /dev/null @@ -1,23 +0,0 @@ -max_allowed_packet -======================================= - -max_allowed_packet 用于设置最大网络包大小,单位是 Byte。 - - -| **属性** | **描述** | -|---------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | int | -| 默认值 | 4194304 | -| 取值范围 | \[1024,1073741824\] | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | - - - - -**说明** - - - -该变量不能通过 `ALTER SESSION SET xxx = yyy; `语句的方式使其仅在当前 Session 生效,只能通过 `SET GLOBAL xxx = yyy` 语句这种全局生效的修改方式。 使用时一般客户端与 Server 端均需要调整。 - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/16.sql_mode-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/16.sql_mode-1.md deleted file mode 100644 index f6583d061..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/16.sql_mode-1.md +++ /dev/null @@ -1,14 +0,0 @@ -sql_mode -============================= - -sql_mode 用于设置 SQL 模式,不同的 SQL 模式对于插入等行为有很大影响。 - - -| **属性** | **描述** | -|--------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | varchar | -| 默认值 | STRICT_ALL_TABLES | -| 取值范围 | * STRICT_ALL_TABLES * STRICT_TRANS_TABLES * ONLY_FULL_GROUP_BY * PAD_CHAR_TO_FULL_LENGTH | -| 生效范围 | * GLOBAL * SESSION | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/17.time_zone-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/17.time_zone-1.md deleted file mode 100644 index 401b26265..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/17.time_zone-1.md +++ /dev/null @@ -1,15 +0,0 @@ -time_zone -============================== - -time_zone 用于设置当前租户会话使用的时区,支持 `'+08:00' `的 offset 形式和 `Asia/Shanghai `的地域形式取值。 - - -| **属性** | **描述** | -|---------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | varchar | -| 默认值 | +8:00 | -| 取值范围 | -12:59 \~ +13:00 | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/18.tx_isolation-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/18.tx_isolation-1.md deleted file mode 100644 index be72aefe6..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/18.tx_isolation-1.md +++ /dev/null @@ -1,16 +0,0 @@ -tx_isolation -================================= - -tx_isolation 用于设置事务隔离级别。 - - -| **属性** | **描述** | -|---------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | varchar | -| 默认值 | READ-COMMITTED | -| 取值范围 | * READ-UNCOMMITTED * READ-COMMITTED * REPEATABLE-READ * SERIALIZABLE | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/19.version_comment-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/19.version_comment-1.md deleted file mode 100644 index eb6204219..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/19.version_comment-1.md +++ /dev/null @@ -1,16 +0,0 @@ -version_comment -==================================== - -version_comment 用于设置 OBServer 的版本信息。 - - -| **属性** | **描述** | -|--------|-----------------| -| 参数类型 | varchar | -| 默认值 | OceanBase 1.0.0 | -| 取值范围 | N/A | -| 生效范围 | GLOBAL | -| 是否可修改 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/2.auto_increment_increment-2.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/2.auto_increment_increment-2.md deleted file mode 100644 index 35abfa223..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/2.auto_increment_increment-2.md +++ /dev/null @@ -1,16 +0,0 @@ -auto_increment_increment -============================================= - -auto_increment_increment 用于设置自增步长,仅用于 MySQL 客户端登录。 - - -| **属性** | **描述** | -|---------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | uint | -| 默认值 | 1 | -| 取值范围 | \[1, 65535\] | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/20.wait_timeout-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/20.wait_timeout-1.md deleted file mode 100644 index c4c1c95a1..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/20.wait_timeout-1.md +++ /dev/null @@ -1,16 +0,0 @@ -wait_timeout -================================= - -wait_timeout 用于设置服务器关闭非交互连接之前等待活动的秒数。 - - -| **属性** | **描述** | -|--------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | int | -| 默认值 | 28800 | -| 取值范围 | \[1, 31536000\] | -| 生效范围 | * GLOBAL * SESSION | - - - -在会话启动时,会根据全局 wait_timeout 的值或全局 interactive_timeout 的值来初始化会话 wait_timeout 的值,具体根据全局 wait_timeout 的值还是全局 interactive_timeout 的值取决于客户端类型。客户端类型由 `mysql_real_connect()` 的连接选项 CLIENT_INTERACTIVE 定义。 interactive_timeout 变量相关信息请参见 **[](gi9a68)** [interactive_timeout](../../14.reference-guide-oracle-mode/2.system-variable-1/13.interactive_timeout-1.md)。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/21.binlog_row_image-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/21.binlog_row_image-1.md deleted file mode 100644 index 6d6b69b81..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/21.binlog_row_image-1.md +++ /dev/null @@ -1,25 +0,0 @@ -binlog_row_image -===================================== - -binlog_row_image 用于控制是否记录全列日志。 - -全列日志与非全列日志的定义如下: - -对于 update/delete 的 DML 语句,如果 OBServer 同时记录了所有列的新值和旧值,则称之为全列日志;如果 OBServer 只记录了新值而没有旧值,则为非全列日志。 - - -| **属性** | **描述** | -|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | enum | -| 默认值 | FULL | -| 取值范围 | * FULL:表示记录所有列 * MINIMAL:表示只记录 DML 操作中修改的列,提升主从复制吞吐量,减少 binlog 大小、网络资源和服务器内存占用 * NOBLOB:目前暂不支持 | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与消息序列化 | 是 | -| 是否影响 SQL 执行计划生成 | 是 | - - -**说明** - - - -通过 `SET GLOBAL binlog_row_image= 'xxx' `命令修改变量后,不会影响已连接的 Session,包括发起修改的 Session。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/22.character_set_filesystem-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/22.character_set_filesystem-1.md deleted file mode 100644 index 41342b809..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/22.character_set_filesystem-1.md +++ /dev/null @@ -1,15 +0,0 @@ -character_set_filesystem -============================================= - -character_set_filesystem 用于设置文件系统字符集类型。 - - -| **属性** | **描述** | -|--------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | string | -| 默认值 | BINARY | -| 取值范围 | BINARY | -| 生效范围 | * GLOBAL * SESSION | -| 是否可以为空 | 是 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/23.connect_timeout-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/23.connect_timeout-1.md deleted file mode 100644 index 8a1f54b06..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/23.connect_timeout-1.md +++ /dev/null @@ -1,14 +0,0 @@ -connect_timeout -==================================== - -connect_timeout 用于设置连接超时时间,单位为微妙。 - - -| **属性** | **描述** | -|--------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | int | -| 默认值 | 10 | -| 取值范围 | \[2, 31536000\] | -| 生效范围 | * GLOBAL * SESSION | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/24.datadir-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/24.datadir-1.md deleted file mode 100644 index e59f9c1bb..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/24.datadir-1.md +++ /dev/null @@ -1,20 +0,0 @@ -datadir -============================ - -datadir 用于设置数据存储的本地磁盘路径。 -**说明** - - - -该变量仅用于兼容,OceanBase 数据库当前暂未实现该变量的功能。 - - -| **属性** | **描述** | -|--------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | varchar | -| 默认值 | /usr/local/mysql/data/ | -| 取值范围 | N/A | -| 生效范围 | * GLOBAL * SESSION | -| 是否可修改 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/25.debug_sync-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/25.debug_sync-1.md deleted file mode 100644 index 59ee95e64..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/25.debug_sync-1.md +++ /dev/null @@ -1,21 +0,0 @@ -debug_sync -=============================== - -debug_sync 用于在 debug 时设置同步点,与 MySQL 兼容。 -**说明** - - - -只有 debug_sync_timeout 配置项的值不为 0 时,该变量的设置才有效。 - - -| **属性** | **描述** | -|--------|------------| -| 参数类型 | varchar | -| 默认值 | 空字符串 | -| 取值范围 | 无 | -| 生效范围 | SESSION | -| 是否可见 | 否,所有租户均不可见 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/26.div_precision_increment-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/26.div_precision_increment-1.md deleted file mode 100644 index 404cdab52..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/26.div_precision_increment-1.md +++ /dev/null @@ -1,17 +0,0 @@ -div_precision_increment -============================================ - -div_precision_increment 用于设置除法结果精度在被除数精度基础上的增量,是 MySQL 兼容功能。 - - -| **属性** | **描述** | -|----------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | int | -| 默认值 | 4 | -| 取值范围 | \[0, 30\] | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | -| 是否影响计划生成 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/27.group_concat_max_len-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/27.group_concat_max_len-1.md deleted file mode 100644 index da9aac0a7..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/27.group_concat_max_len-1.md +++ /dev/null @@ -1,15 +0,0 @@ -group_concat_max_len -========================================= - -group_concat_max_len 用于设置允许的 GROUP_CONCAT() 函数结果的最大长度,单位为字节。 - - -| **属性** | **描述** | -|---------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | uint | -| 默认值 | 1024 | -| 取值范围 | \[4, 18446744073709551615\] | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/28.identity-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/28.identity-1.md deleted file mode 100644 index c38800d96..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/28.identity-1.md +++ /dev/null @@ -1,15 +0,0 @@ -identity -============================= - -identity 和变量 last_insert_id 是同义词,可以通过 `select @@identity` 查询。 - - -| **属性** | **描述** | -|--------|-----------------------------| -| 参数类型 | uint | -| 默认值 | 0 | -| 取值范围 | \[0, 18446744073709551615\] | -| 生效范围 | SESSION | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/29.lower_case_table_names-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/29.lower_case_table_names-1.md deleted file mode 100644 index 66f3aeac1..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/29.lower_case_table_names-1.md +++ /dev/null @@ -1,21 +0,0 @@ -lower_case_table_names -=========================================== - -lower_case_table_names 用于设置是否对大小写敏感。 - - -| **属性** | **描述** | -|---------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | int | -| 默认值 | 1 | -| 取值范围 | * 0:表示表名将按指定存储,并且比较区分大小写 * 1:表示表名以小写形式存储在磁盘上,并且比较不区分大小写 * 2:表示表名按指定存储,但以小写形式进行比较 | -| 生效范围 | GLOBAL | -| 是否参与序列化 | 是 | -| 是否可修改 | 否,仅在 OBServer 启动的命令行上指定,启动后不能再通过 SQL 语句修改。 | - - -**说明** - - - -该变量仅在 MySQL 模式下对 DataBase 和 Table 对象名生效。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/3.auto_increment_offset-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/3.auto_increment_offset-1.md deleted file mode 100644 index 408714a20..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/3.auto_increment_offset-1.md +++ /dev/null @@ -1,15 +0,0 @@ -auto_increment_offset -========================================== - -auto_increment_offset 用于确定 AUTO_INCREMENT 列值的起点。 - - -| **属性** | **描述** | -|--------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | uint | -| 默认值 | 1 | -| 取值范围 | \[1, 65535\] | -| 生效范围 | * GLOBAL * SESSION | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/30.net_read_timeout-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/30.net_read_timeout-1.md deleted file mode 100644 index 05c768e12..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/30.net_read_timeout-1.md +++ /dev/null @@ -1,32 +0,0 @@ -net_read_timeout -===================================== - -net_read_timeout 用于中断读之前等待连接的其它数据的秒数。 -**说明** - - - -该变量仅用于兼容,OceanBase 数据库当前暂未实现该变量的功能。 - - -| **属性** | **描述** | -|--------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | int | -| 默认值 | 30 | -| 取值范围 | \[1, 31536000\] | -| 生效范围 | * GLOBAL * SESSION | - - - -其中: - -* 当服务器从客户端读数时,net_read_timeout 指控制何时中断的超时值。 - - - -* 当服务器向客户端写时,net_write_timeout 指控制何时中断的超时值。 - - - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/31.net_write_timeout-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/31.net_write_timeout-1.md deleted file mode 100644 index 7d96ee1d0..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/31.net_write_timeout-1.md +++ /dev/null @@ -1,32 +0,0 @@ -net_write_timeout -====================================== - -net_write_timeout 用于设置中断写之前等待块写入连接的秒数。 -**说明** - - - -该变量仅用于兼容,OceanBase 数据库当前暂未实现该变量的功能。 - - -| **属性** | **描述** | -|--------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | int | -| 默认值 | 60 | -| 取值范围 | \[1, 31536000\] | -| 生效范围 | * GLOBAL * SESSION | - - - -其中: - -* 当服务器从客户端读数时,net_read_timeout 指控制何时中断的超时值。 - - - -* 当服务器向客户端写时,net_write_timeout 指控制何时中断的超时值。 - - - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/32.read_only-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/32.read_only-1.md deleted file mode 100644 index 312eefb09..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/32.read_only-1.md +++ /dev/null @@ -1,19 +0,0 @@ -read_only -============================== - -read_only 用于设置租户是否为只读模式。 - - -| **属性** | **描述** | -|--------|-----------------------------------------------------------------------------------------------------------------| -| 参数类型 | bool | -| 默认值 | 0 | -| 取值范围 | * 1:租户为只读模式 * 0:租户为读写模式 | -| 生效范围 | GLOBAL | - - -**说明** - - - -设置后,会影响该租户下的所有普通用户,不影响 root 权限用户。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/33.sql_auto_is_null-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/33.sql_auto_is_null-1.md deleted file mode 100644 index f63fd6bbc..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/33.sql_auto_is_null-1.md +++ /dev/null @@ -1,28 +0,0 @@ -sql_auto_is_null -===================================== - -sql_auto_is_null 会被一些特殊的驱动程序,例如 ODBC 使用,用于获取最后插入行的自增列值。 - - -| **属性** | **描述** | -|----------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | bool | -| 默认值 | OFF | -| 取值范围 | * OFF * ON | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | -| 是否影响计划生成 | 是 | - - - -当 sql_auto_is_null 为 `ON` 时,与下面两条语句等价: - -```sql -// CREATE TABLE t1 (auto_inc_column auto_increment, j int); -obclient> SELECT * FROM t1 WHERE auto_inc_column is null; - -obclient> SELECT * FROM t1 WHERE auto_inc_column = last_insert_id(); -``` - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/34.sql_select_limit-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/34.sql_select_limit-1.md deleted file mode 100644 index 941771c26..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/34.sql_select_limit-1.md +++ /dev/null @@ -1,16 +0,0 @@ -sql_select_limit -===================================== - -sql_select_limit 用于设置一个 select 查询允许返回的最大行数。如果一个 select 中包含了 limit 语句,那么 limit 的值比 sql_select_limit 的优先级高,默认不限制 select 返回的行数。 - - -| **属性** | **描述** | -|---------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | int | -| 默认值 | 9223372036854775807 | -| 取值范围 | \[0, 9223372036854775807\] | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/35.timestamp-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/35.timestamp-1.md deleted file mode 100644 index 5178c843f..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/35.timestamp-1.md +++ /dev/null @@ -1,15 +0,0 @@ -timestamp -============================== - -TIMESTAMP 是时间戳,单位为秒,该变量影响 `select now(6) `的结果。 - - -| **属性** | **描述** | -|--------|--------------------| -| 参数类型 | numeric | -| 默认值 | 0 | -| 取值范围 | \[0, 253402272000) | -| 生效范围 | SESSION | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/36.tx_read_only-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/36.tx_read_only-1.md deleted file mode 100644 index 1ef72cb2d..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/36.tx_read_only-1.md +++ /dev/null @@ -1,20 +0,0 @@ -tx_read_only -================================= - -tx_read_only 用于设置是否为只读事务。 - - -| **属性** | **描述** | -|---------|-------------------------------------------------------------------------------------------------------------| -| 参数类型 | int | -| 默认值 | 0 | -| 取值范围 | * 1:只读事务 * 0:不是只读事务 | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | - - -**说明** - - - -设置后,仅影响该用户,不影响其他用户。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/37.version-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/37.version-1.md deleted file mode 100644 index 65e715b47..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/37.version-1.md +++ /dev/null @@ -1,16 +0,0 @@ -version -============================ - -version 用于设置服务器的版本号。 - - -| **属性** | **描述** | -|--------|---------| -| 参数类型 | varchar | -| 默认值 | 5.6.25 | -| 取值范围 | N/A | -| 生效范围 | GLOBAL | -| 是否可修改 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/38.sql_warnings-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/38.sql_warnings-1.md deleted file mode 100644 index f46123253..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/38.sql_warnings-1.md +++ /dev/null @@ -1,15 +0,0 @@ -sql_warnings -================================= - -sql_warnings 用于在出现告警时控制单行 INSERT 语句是否生成信息字符串。 - - -| **属性** | **描述** | -|--------|-----------------------------------------------------------------------------------------------------------------------| -| 参数类型 | bool | -| 默认值 | OFF | -| 取值范围 | * ON:生成一个信息字符串 * OFF:不生成信息字符串 | -| 生效范围 | * GLOBAL * SESSION | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/39.max_user_connections-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/39.max_user_connections-1.md deleted file mode 100644 index 40ac4b7f0..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/39.max_user_connections-1.md +++ /dev/null @@ -1,19 +0,0 @@ -max_user_connections -========================================= - -max_user_connections 用于指定单个用户可以向 OBServer 建立的连接数,设置为 0 时表示不限制连接数。 - - -| **属性** | **描述** | -|--------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | uint | -| 默认值 | 0 | -| 取值范围 | \[0, 4294967295\] | -| 生效范围 | * GLOBAL * SESSION | - - -**说明** - - - -该变量不能通过 `alter session set xxx = yyy; `语句的方式使其仅在当前 Session 生效,只能通过 `set global xxx = yyy` 语句的方式使全局生效。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/4.autocommit-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/4.autocommit-1.md deleted file mode 100644 index 52a5be13e..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/4.autocommit-1.md +++ /dev/null @@ -1,16 +0,0 @@ -autocommit -=============================== - -autocommit 用于设置是否自动提交事务。 - - -| **属性** | **描述** | -|---------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | bool | -| 默认值 | 1 | -| 取值范围 | * 1:自动提交 * 0:不自动提交 | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/40.init_connect-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/40.init_connect-1.md deleted file mode 100644 index d666b2c5e..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/40.init_connect-1.md +++ /dev/null @@ -1,14 +0,0 @@ -init_connect -================================= - -init_connect 用于设置服务器为每个连接的客户端执行的字符串,该字符串由一条或多条 SQL 语句组成,用分号分隔。 - - -| **属性** | **描述** | -|--------|---------| -| 参数类型 | varchar | -| 默认值 | N/A | -| 取值范围 | N/A | -| 生效范围 | GLOBAL | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/41.license-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/41.license-1.md deleted file mode 100644 index ebefcc82b..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/41.license-1.md +++ /dev/null @@ -1,16 +0,0 @@ -license -============================ - -license 用于设置 license 的类型。 - - -| **属性** | **描述** | -|--------|---------| -| 参数类型 | varchar | -| 默认值 | 空字符串 | -| 取值范围 | N/A | -| 生效范围 | GLOBAL | -| 是否可修改 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/42.net_buffer_length-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/42.net_buffer_length-1.md deleted file mode 100644 index b2200aa2c..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/42.net_buffer_length-1.md +++ /dev/null @@ -1,19 +0,0 @@ -net_buffer_length -====================================== - -net_buffer_length 用于设置 OBServer 能接受的 SQL Query 的大小。 - - -| **属性** | **描述** | -|--------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | int | -| 默认值 | 16384 | -| 取值范围 | \[1024, 1048576\] | -| 生效范围 | * GLOBAL * SESSION | - - -**说明** - - - -该变量不能通过 `alter session set xxx = yyy; `语句的方式使其仅在当前 Session 生效,只能通过 `set global xxx = yyy` 语句的方式使全局生效。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/43.system_time_zone-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/43.system_time_zone-1.md deleted file mode 100644 index 91cd4f6d3..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/43.system_time_zone-1.md +++ /dev/null @@ -1,17 +0,0 @@ -system_time_zone -===================================== - -system_time_zone 用于设置服务器机器系统时区。 - - -| **属性** | **描述** | -|---------|-------------------------------------------| -| 参数类型 | varchar | -| 默认值 | CST | -| 取值范围 | N/A | -| 生效范围 | GLOBAL | -| 是否可修改 | 否,仅在 OBServer 启动的命令行上指定,启动后不能再通过 SQL 语句修改 | -| 是否参与序列化 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/44.query_cache_size-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/44.query_cache_size-1.md deleted file mode 100644 index 694129dbf..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/44.query_cache_size-1.md +++ /dev/null @@ -1,15 +0,0 @@ -query_cache_size -===================================== - -query_cache_size 用于设置分配给存储历史查询结果的内存,即尚未使用的内存,单位为 Byte。 - - -| **属性** | **描述** | -|--------|-----------------------------| -| 参数类型 | uint | -| 默认值 | 1048576 | -| 取值范围 | \[0, 18446744073709551615\] | -| 生效范围 | GLOBAL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/45.query_cache_type-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/45.query_cache_type-1.md deleted file mode 100644 index e099f15de..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/45.query_cache_type-1.md +++ /dev/null @@ -1,15 +0,0 @@ -query_cache_type -===================================== - -query_cache_type 用于查询缓存类型。 - - -| **属性** | **描述** | -|--------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | varchar | -| 默认值 | OFF | -| 取值范围 | * OFF:不缓存或检索结果。 * ON:缓存除了 `SELECT SQL_NO_CACHE ...`查询的所有结果。 * DEMAND:只缓存 `SELECT SQL_CACHE ... `查询的结果。 | -| 生效范围 | * GLOBAL * SESSION | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/46.sql_quote_show_create-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/46.sql_quote_show_create-1.md deleted file mode 100644 index 6fd327afe..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/46.sql_quote_show_create-1.md +++ /dev/null @@ -1,14 +0,0 @@ -sql_quote_show_create -========================================== - -sql_quote_show_create 用于设置是否为 `SHOW CREATE TABLE` 和 `SHOW CREATE DATABASE` 语句启动引用标识符。 - - -| **属性** | **描述** | -|--------|---------------------------------------------------------------------------------------------------------------| -| 参数类型 | bool | -| 默认值 | true | -| 取值范围 | * true:启用 * false:不启用 | -| 生效范围 | * GLOBAL * SESSION | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/47.max_sp_recursion_depth-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/47.max_sp_recursion_depth-1.md deleted file mode 100644 index c5733675b..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/47.max_sp_recursion_depth-1.md +++ /dev/null @@ -1,15 +0,0 @@ -max_sp_recursion_depth -=========================================== - -max_sp_recursion_depth 用于设置可以递归调用任一指定存储过程的最大层次。默认值为 0 ,表示当前存储过程不可递归调用。 - - -| **属性** | **描述** | -|---------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | int | -| 默认值 | 0 | -| 取值范围 | \[0, 255\] | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/48.ob_proxy_partition_hit-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/48.ob_proxy_partition_hit-1.md deleted file mode 100644 index 6202c17a2..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/48.ob_proxy_partition_hit-1.md +++ /dev/null @@ -1,17 +0,0 @@ -ob_proxy_partition_hit -=========================================== - -ob_proxy_partition_hit 用于设置 OBProxy 是否将 SQL 语句请求的数据发送到这些数据主 Partition 所在的 OBServer 上。 - - -| **属性** | **描述** | -|--------|-----------------------------------------------------------------------------------------------------| -| 参数类型 | bool | -| 默认值 | 1 | -| 取值范围 | * 1:是 * 0:否 | -| 生效范围 | SESSION | -| 是否可修改 | 否 | -| 是否可见 | 否,所有租户均不可见 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/49.ob_log_level-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/49.ob_log_level-1.md deleted file mode 100644 index c422db784..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/49.ob_log_level-1.md +++ /dev/null @@ -1,15 +0,0 @@ -ob_log_level -================================= - -ob_log_level 用于设置 Session 级的日志级别,如果不指定则使用系统中的日志级别。 - - -| **属性** | **描述** | -|--------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | varchar | -| 默认值 | disabled | -| 取值范围 | * trace * info * warn * error | -| 生效范围 | * GLOBAL * SESSION | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/5.character_set_client-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/5.character_set_client-1.md deleted file mode 100644 index 2e6b8f576..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/5.character_set_client-1.md +++ /dev/null @@ -1,17 +0,0 @@ -character_set_client -========================================= - -character_set_client 用于设置客户端发送语句的字符集。 - - -| **属性** | **描述** | -|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | string | -| 默认值 | utf8mb4 | -| 取值范围 | * utf8mb4 * binary * gbk | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | -| 是否可以为空 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/50.ob_max_parallel_degree-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/50.ob_max_parallel_degree-1.md deleted file mode 100644 index a8ec77e74..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/50.ob_max_parallel_degree-1.md +++ /dev/null @@ -1,15 +0,0 @@ -ob_max_parallel_degree -=========================================== - -ob_max_parallel_degree 用于设置每次请求最大的并发数。 - - -| **属性** | **描述** | -|--------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | int | -| 默认值 | 16 | -| 取值范围 | NULL | -| 生效范围 | * GLOBAL * SESSION | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/51.ob_query_timeout-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/51.ob_query_timeout-1.md deleted file mode 100644 index f46f5e0ad..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/51.ob_query_timeout-1.md +++ /dev/null @@ -1,16 +0,0 @@ -ob_query_timeout -===================================== - -ob_query_timeout 用于设置查询超时时间,单位是微秒。 - - -| **属性** | **描述** | -|---------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | int | -| 默认值 | 10000000 | -| 取值范围 | NULL | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/52.ob_read_consistency-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/52.ob_read_consistency-1.md deleted file mode 100644 index c5f6cbcd3..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/52.ob_read_consistency-1.md +++ /dev/null @@ -1,17 +0,0 @@ -ob_read_consistency -======================================== - -ob_read_consistency 用于设置读一致性级别。 - - -| **属性** | **描述** | -|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | enum | -| 默认值 | 3 | -| 取值范围 | * 0:空字符串 * 1:FROZEN * 2:WEAK * 3:STRONG | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | -| 是否影响计划生成 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/53.ob_enable_transformation-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/53.ob_enable_transformation-1.md deleted file mode 100644 index ebd72673c..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/53.ob_enable_transformation-1.md +++ /dev/null @@ -1,17 +0,0 @@ -ob_enable_transformation -============================================= - -ob_enable_transformation 用于设置是否开启 SQL 优化器的改写功能。 - - -| **属性** | **描述** | -|----------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | bool | -| 默认值 | 1 | -| 取值范围 | * 0:不开启 * 1:开启 | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | -| 是否影响计划生成 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/54.ob_trx_timeout-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/54.ob_trx_timeout-1.md deleted file mode 100644 index beeb5641f..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/54.ob_trx_timeout-1.md +++ /dev/null @@ -1,16 +0,0 @@ -ob_trx_timeout -=================================== - -ob_trx_timeout 用于设置事务超时时间,单位为微秒。 - - -| **属性** | **描述** | -|---------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | int | -| 默认值 | 100000000 | -| 取值范围 | NULL | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/55.ob_enable_plan_cache-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/55.ob_enable_plan_cache-1.md deleted file mode 100644 index a4b2a8eef..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/55.ob_enable_plan_cache-1.md +++ /dev/null @@ -1,16 +0,0 @@ -ob_enable_plan_cache -========================================= - -ob_enable_plan_cache 用于设置是否打开 Plan Cache。 - - -| **属性** | **描述** | -|---------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | bool | -| 默认值 | 1 | -| 取值范围 | * 0:关闭 * 1:打开 | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/56.ob_enable_index_direct_select-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/56.ob_enable_index_direct_select-1.md deleted file mode 100644 index 5f75ca1c4..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/56.ob_enable_index_direct_select-1.md +++ /dev/null @@ -1,17 +0,0 @@ -ob_enable_index_direct_select -================================================== - -ob_enable_index_direct_select 用于设置是否允许用户直接查询索引表。 - - -| **属性** | **描述** | -|----------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | bool | -| 默认值 | 0 | -| 取值范围 | * 0:不允许 * 1:允许 | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | -| 是否影响计划生成 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/57.ob_proxy_set_trx_executed-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/57.ob_proxy_set_trx_executed-1.md deleted file mode 100644 index d6b46da94..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/57.ob_proxy_set_trx_executed-1.md +++ /dev/null @@ -1,17 +0,0 @@ -ob_proxy_set_trx_executed -============================================== - -ob_proxy_set_trx_executed 用于设置用户是否通过 OBProxy 发送 `START TRANSACTION Syntax` 给 OBServer。 - - -| **属性** | **描述** | -|--------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | bool | -| 默认值 | 0 | -| 取值范围 | * 0:不发送 * 1:发送 | -| 生效范围 | SESSION | -| 是否可修改 | 否 | -| 是否可见 | 否,所有租户均不可见 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/58.ob_enable_aggregation_pushdown-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/58.ob_enable_aggregation_pushdown-1.md deleted file mode 100644 index eac829e7f..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/58.ob_enable_aggregation_pushdown-1.md +++ /dev/null @@ -1,16 +0,0 @@ -ob_enable_aggregation_pushdown -=================================================== - -ob_enable_aggregation_pushdown 用于设置是否允许聚合操作下压。 - - -| **属性** | **描述** | -|----------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | bool | -| 默认值 | 1 | -| 取值范围 | * 0:不允许 * 1:允许 | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | -| 是否影响计划生成 | 是 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/59.ob_last_schema_version-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/59.ob_last_schema_version-1.md deleted file mode 100644 index 129c4f8d4..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/59.ob_last_schema_version-1.md +++ /dev/null @@ -1,16 +0,0 @@ -ob_last_schema_version -=========================================== - -ob_last_schema_version 用于设置该 Session 中最新使用的 Schema 版本号。 - -当 Proxy 的同一个连接对应到多个 Server 时,需要使用该系统变量进行 Schema 同步,故该变量只在 Session 级别生效。 - - -| **属性** | **描述** | -|--------|----------------------------| -| 参数类型 | int | -| 默认值 | 0 | -| 取值范围 | \[0, 9223372036854775807\] | -| 生效范围 | SESSION | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/6.character_set_connection-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/6.character_set_connection-1.md deleted file mode 100644 index 6749765c0..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/6.character_set_connection-1.md +++ /dev/null @@ -1,17 +0,0 @@ -character_set_connection -============================================= - -character_set_connection 用于设置收到语句后应转换的字符集。 - - -| **属性** | **描述** | -|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | string | -| 默认值 | utf8mb4 | -| 取值范围 | * utf8mb4 * binary * gbk | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | -| 是否可以为空 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/60.ob_global_debug_sync-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/60.ob_global_debug_sync-1.md deleted file mode 100644 index e03ea533a..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/60.ob_global_debug_sync-1.md +++ /dev/null @@ -1,15 +0,0 @@ -ob_global_debug_sync -========================================= - -ob_global_debug_sync 用于 debug 时设置同步点,与 debug_sync 不同,设置此变量会影响所有 Session。只有 debug_sync_timeout 配置项的值不为 0 时,该设置才有效。 - - -| **属性** | **描述** | -|--------|------------| -| 参数类型 | varchar | -| 默认值 | 空字符串 | -| 取值范围 | 无 | -| 生效范围 | SESSION | -| 是否可见 | 否,所有租户均不可见 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/61.ob_proxy_global_variables_version-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/61.ob_proxy_global_variables_version-1.md deleted file mode 100644 index 8d3e6561b..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/61.ob_proxy_global_variables_version-1.md +++ /dev/null @@ -1,18 +0,0 @@ -ob_proxy_global_variables_version -====================================================== - -ob_proxy_global_variables_version 用于设置 OBServer 返回给 OBproxy 所需的全局变量的最新版本信息。 - - -| **属性** | **描述** | -|--------|-----------------| -| 参数类型 | int | -| 默认值 | 5 | -| 取值范围 | \[0, INT64_MAX) | -| 生效范围 | SESSION | -| 是否可修改 | 否 | -| 是否可见 | 否,所有租户均不可见 | - - - -执行 `select @@ob_proxy_global_variables_version` 语句时将返回当前全局变量的最新版本号。默认值为 0,用户不可修改。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/62.ob_enable_trace_log-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/62.ob_enable_trace_log-1.md deleted file mode 100644 index 13727d894..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/62.ob_enable_trace_log-1.md +++ /dev/null @@ -1,16 +0,0 @@ -ob_enable_trace_log -======================================== - -ob_enable_trace_log 用于设置是否使用 trace 日志。 - - -| **属性** | **描述** | -|---------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | bool | -| 默认值 | 0 | -| 取值范围 | * 0:不使用 * 1:使用 | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/63.ob_enable_hash_group_by-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/63.ob_enable_hash_group_by-1.md deleted file mode 100644 index 3ac93e381..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/63.ob_enable_hash_group_by-1.md +++ /dev/null @@ -1,17 +0,0 @@ -ob_enable_hash_group_by -============================================ - -ob_enable_hash_group_by 用于设置是否打开 Hash Group by 的路径。 - - -| **属性** | **描述** | -|----------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | bool | -| 默认值 | 1 | -| 取值范围 | * 0:不允许 * 1:允许 | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | -| 是否影响计划生成 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/64.ob_enable_blk_nestedloop_join-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/64.ob_enable_blk_nestedloop_join-1.md deleted file mode 100644 index 512e67c65..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/64.ob_enable_blk_nestedloop_join-1.md +++ /dev/null @@ -1,17 +0,0 @@ -ob_enable_blk_nestedloop_join -================================================== - -ob_enable_blk_nestedloop_join 用于设置是否允许打开 block nested loop join。 - - -| **属性** | **描述** | -|----------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | bool | -| 默认值 | 0 | -| 取值范围 | * 0:不允许 * 1:允许 | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | -| 是否影响计划生成 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/65.ob_bnl_join_cache_size-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/65.ob_bnl_join_cache_size-1.md deleted file mode 100644 index 65bd8c90e..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/65.ob_bnl_join_cache_size-1.md +++ /dev/null @@ -1,16 +0,0 @@ -ob_bnl_join_cache_size -=========================================== - -ob_bnl_join_cache_size 用于设置 batch nest loop join 一次 cache 多少数据做一次 batch。 - - -| **属性** | **描述** | -|----------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | int | -| 默认值 | 10485760 | -| 取值范围 | \[1, 9223372036854775807\] | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | -| 是否影响计划生成 | 是 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/66.ob_org_cluster_id-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/66.ob_org_cluster_id-1.md deleted file mode 100644 index 7e700e857..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/66.ob_org_cluster_id-1.md +++ /dev/null @@ -1,18 +0,0 @@ -ob_org_cluster_id -====================================== - -ob_org_cluster_id 用于设置 OceanBase 集群的 CLUSTER_ID。 - -通常情况下不需要设置 ob_org_cluster_id 变量,OceanBase 数据库生成日志(clog)时会使用缺省值(即每一个 OceanBase 集群的 CLUSTER_ID)。DRC 在复制数据写入目标集群时,需要在 Session 中将该变量设置为日志中所带的 CLUSTER_ID,以免数据被循环复制。 - - -| **属性** | **描述** | -|---------|-------------------| -| 参数类型 | int | -| 默认值 | 0 | -| 取值范围 | \[0, 4294967295\] | -| 生效范围 | SESSION | -| 是否参与序列化 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/67.ob_plan_cache_percentage-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/67.ob_plan_cache_percentage-1.md deleted file mode 100644 index 5ffa012b3..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/67.ob_plan_cache_percentage-1.md +++ /dev/null @@ -1,15 +0,0 @@ -ob_plan_cache_percentage -============================================= - -ob_plan_cache_percentage 用于设置计划缓存可以使用的租户内存资源的百分比。 - - -| **属性** | **描述** | -|---------|------------| -| 参数类型 | int | -| 默认值 | 5 | -| 取值范围 | \[0, 100\] | -| 生效范围 | GLOBAL | -| 是否参与序列化 | 是 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/68.ob_plan_cache_evict_high_percentage-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/68.ob_plan_cache_evict_high_percentage-1.md deleted file mode 100644 index 95be9ac06..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/68.ob_plan_cache_evict_high_percentage-1.md +++ /dev/null @@ -1,16 +0,0 @@ -ob_plan_cache_evict_high_percentage -======================================================== - -ob_plan_cache_evict_high_percentage 用于设置触发计划缓存逐出的计划缓存限制的内存使用百分比。 - - -| **属性** | **描述** | -|---------|------------| -| 参数类型 | int | -| 默认值 | 90 | -| 取值范围 | \[0, 100\] | -| 生效范围 | GLOBAL | -| 是否参与序列化 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/69.ob_plan_cache_evict_low_percentage-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/69.ob_plan_cache_evict_low_percentage-1.md deleted file mode 100644 index 6bed8d75c..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/69.ob_plan_cache_evict_low_percentage-1.md +++ /dev/null @@ -1,15 +0,0 @@ -ob_plan_cache_evict_low_percentage -======================================================= - -ob_plan_cache_evict_low_percentage 用于设置停止计划缓存逐出的计划缓存限制的内存使用百分比。 - - -| **属性** | **描述** | -|---------|------------| -| 参数类型 | int | -| 默认值 | 50 | -| 取值范围 | \[0, 100\] | -| 生效范围 | GLOBAL | -| 是否参与序列化 | 是 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/7.character_set_results-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/7.character_set_results-1.md deleted file mode 100644 index a82715aa8..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/7.character_set_results-1.md +++ /dev/null @@ -1,16 +0,0 @@ -character_set_results -========================================== - -character_set_results 用于设置服务器在将结果集或错误消息发送回客户端之前应转换为的字符集。 - - -| **属性** | **描述** | -|--------|-----------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | string | -| 默认值 | utf8mb4 | -| 取值范围 | * utf8mb4 * binary * gbk | -| 生效范围 | * GLOBAL * SESSION | -| 是否可以为空 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/70.recyclebin-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/70.recyclebin-1.md deleted file mode 100644 index f8b24190f..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/70.recyclebin-1.md +++ /dev/null @@ -1,16 +0,0 @@ -recyclebin -=============================== - -recyclebin 用于设置是否开启回收站功能。 - - -| **属性** | **描述** | -|--------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | bool | -| 默认值 | 0 | -| 取值范围 | * 0:不开启 * 1:开启 | -| 生效范围 | * GLOBAL * SESSION | - - - -启用回收站后,删除的表及其依赖对象将放置在回收站中;当禁用回收站时,删除的表及其依赖对象不会放置在回收站中,会直接删除。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/71.ob_capability_flag-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/71.ob_capability_flag-1.md deleted file mode 100644 index 8199ccc37..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/71.ob_capability_flag-1.md +++ /dev/null @@ -1,17 +0,0 @@ -ob_capability_flag -======================================= - -ob_capability_flag 是 OBServer 能够提供的能力,用于和 Proxy 连接时进行能力协商,告知 Proxy 当前 OBServer 支持哪些功能,不支持哪些功能。 - - -| **属性** | **描述** | -|--------|----------------------------| -| 参数类型 | uint | -| 默认值 | 0 | -| 取值范围 | \[0,18446744073709551615\] | -| 生效范围 | SESSION | -| 是否可修改 | 否 | -| 是否可见 | 否,对所有租户均不可见 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/72.ob_stmt_parallel_degree-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/72.ob_stmt_parallel_degree-1.md deleted file mode 100644 index bfde17660..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/72.ob_stmt_parallel_degree-1.md +++ /dev/null @@ -1,17 +0,0 @@ -ob_stmt_parallel_degree -============================================ - -ob_stmt_parallel_degree 用于设置查询的并行度,即可以并行运行的任务数。 - - -| **属性** | **描述** | -|----------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | int | -| 默认值 | 1 | -| 取值范围 | \[1, 10240\] | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | -| 是否影响计划生成 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/73.is_result_accurate-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/73.is_result_accurate-1.md deleted file mode 100644 index 4a9cc53f7..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/73.is_result_accurate-1.md +++ /dev/null @@ -1,16 +0,0 @@ -is_result_accurate -======================================= - -当查询带有 topk 提示时,is_result_accurate 表示结果是否正确。 - - -| **属性** | **描述** | -|---------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | bool | -| 默认值 | 1 | -| 取值范围 | * 0:不正确 * 1:正确 | -| 生效范围 | SESSION | -| 是否参与序列化 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/74.error_on_overlap_time-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/74.error_on_overlap_time-1.md deleted file mode 100644 index 981dcad35..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/74.error_on_overlap_time-1.md +++ /dev/null @@ -1,16 +0,0 @@ -error_on_overlap_time -========================================== - -error_on_overlap_time 是动态参数,用于设置夏令时重叠区时间发生歧义时是否作报错处理。 - - -| **属性** | **描述** | -|---------|-------------------------------------------------------------------------------------------------------------------| -| 参数类型 | bool | -| 默认值 | OFF | -| 取值范围 | * ON:进行报错处理 * OFF:不进行报错处理 | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/75.ob_compatibility_mode-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/75.ob_compatibility_mode-1.md deleted file mode 100644 index 92739c65d..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/75.ob_compatibility_mode-1.md +++ /dev/null @@ -1,17 +0,0 @@ -ob_compatibility_mode -========================================== - -ob_compatibility_mode 用于指定租户的兼容模式。该系统变量只能在创建租户时指定,租户创建好之后则无法修改。 - - -| **属性** | **描述** | -|---------|---------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | enum | -| 默认值 | MYSQL | -| 取值范围 | * MYSQL:表示兼容 MYSQL * ORACLE:表示兼容 ORACLE | -| 生效范围 | * GLOBAL * SESSION | -| 是否可修改 | 否 | -| 是否参与序列化 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/76.ob_create_table_strict_mode-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/76.ob_create_table_strict_mode-1.md deleted file mode 100644 index 7c4f5dc27..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/76.ob_create_table_strict_mode-1.md +++ /dev/null @@ -1,14 +0,0 @@ -ob_create_table_strict_mode -================================================ - -`ob_create_table_strict_mode` 是动态变量,用于设置建表的严格模式。 - - -| **属性** | **描述** | -|--------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | bool | -| 默认值 | 1 | -| 取值范围 | * 1:表示会严格按照 Locality 建立副本,任何副本建立失败,则建表失败。 * 0:表示全类型副本至少有 1 个,Paxos 成员组副本达到多数,则建表成功。 | -| 生效范围 | * GLOBAL * SESSION | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/77.ob_sql_work_area_percentage-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/77.ob_sql_work_area_percentage-1.md deleted file mode 100644 index 5f06a240e..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/77.ob_sql_work_area_percentage-1.md +++ /dev/null @@ -1,14 +0,0 @@ -ob_sql_work_area_percentage -================================================ - -ob_sql_work_area_percentage 用于 SQL 执行的租户内存百分比限制。 - - -| **属性** | **描述** | -|--------|------------| -| 参数类型 | int | -| 默认值 | 5 | -| 取值范围 | \[0, 100\] | -| 生效范围 | GLOBAL | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/78.ob_safe_weak_read_snapshot-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/78.ob_safe_weak_read_snapshot-1.md deleted file mode 100644 index f38df2d26..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/78.ob_safe_weak_read_snapshot-1.md +++ /dev/null @@ -1,17 +0,0 @@ -ob_safe_weak_read_snapshot -=============================================== - -ob_safe_weak_read_snapshot 用于 Proxy 向数据库同步弱读一致性读快照。 - - -| **属性** | **描述** | -|---------|----------------------------| -| 参数类型 | int | -| 默认值 | 1 | -| 取值范围 | \[0, 9223372036854775807\] | -| 生效范围 | SESSION | -| 是否参与序列化 | 是 | -| 是否可见 | 否,对所有租户均不可见 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/79.ob_route_policy-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/79.ob_route_policy-1.md deleted file mode 100644 index 7664cca2d..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/79.ob_route_policy-1.md +++ /dev/null @@ -1,16 +0,0 @@ -ob_route_policy -==================================== - -ob_route_policy 用于设置 OBProxy 或 Java 客户端与 OBServer 内部重试的路由策略。 - - -| **属性** | **描述** | -|----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | enum | -| 默认值 | 1 | -| 取值范围 | * 1:READONLY_ZONE_FIRST * 2:ONLY_READONLY_ZONE * 3:UNMERGE_ZONE_FIRST * 4:UNMERGE_FOLLOWER_FIRST | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | -| 是否影响计划生成 | 是 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/8.character_set_server-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/8.character_set_server-1.md deleted file mode 100644 index 262c56957..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/8.character_set_server-1.md +++ /dev/null @@ -1,15 +0,0 @@ -character_set_server -========================================= - -character_set_server 用于设置服务器字符集。 - - -| **属性** | **描述** | -|--------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | string | -| 默认值 | utf8mb4 | -| 取值范围 | * utf8mb4 * binary * gbk * gb18030 * utf16 | -| 生效范围 | * GLOBAL * SESSION | -| 是否可以为空 | 是 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/80.ob_enable_transmission_checksum-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/80.ob_enable_transmission_checksum-1.md deleted file mode 100644 index 62a27b7b3..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/80.ob_enable_transmission_checksum-1.md +++ /dev/null @@ -1,16 +0,0 @@ -ob_enable_transmission_checksum -==================================================== - -ob_enable_transmission_checksum 用于设置 Proxy 和 Server 之间是否进行数据包校验和,设置后实时生效。 - - -| **属性** | **描述** | -|---------|--------------------------------------------------------------------------------------------------------------| -| 参数类型 | bool | -| 默认值 | 1 | -| 取值范围 | * 0:不进行校验和 * 1:进行校验和 | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/81.foreign_key_checks-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/81.foreign_key_checks-1.md deleted file mode 100644 index 8000b7556..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/81.foreign_key_checks-1.md +++ /dev/null @@ -1,17 +0,0 @@ -foreign_key_checks -================== - -foreign_key_checks 用于设置是否在 DML 中检查外建约束。 - -| **属性** | **描述** | -|---------|------------------------| -| 参数类型 | bool | -| 默认值 | 1 | -| 取值范围 | * 0:不检查外键约束 * 1:检查外键约束 | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | - -**说明** - -说明:该变量设置后,仅对 DML 操作有效,DDL 操作不受影响。 - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/82.ob_enable_truncate_flashback-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/82.ob_enable_truncate_flashback-1.md deleted file mode 100644 index 54dcc1c8c..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/82.ob_enable_truncate_flashback-1.md +++ /dev/null @@ -1,15 +0,0 @@ -ob_enable_truncate_flashback -================================================= - -ob_enable_truncate_flashback 用于设置是否启用表截断的闪回。 - - -| **属性** | **描述** | -|--------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | bool | -| 默认值 | 0 | -| 取值范围 | * 0:不启用 * 1:启用 | -| 生效范围 | * GLOBAL * SESSION | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/83.ob_tcp_invited_nodes-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/83.ob_tcp_invited_nodes-1.md deleted file mode 100644 index d0ad7eda5..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/83.ob_tcp_invited_nodes-1.md +++ /dev/null @@ -1,14 +0,0 @@ -ob_tcp_invited_nodes -========================================= - -`ob_tcp_invited_nodes` 用于设置租户的 IP 白名单,支持百分号(%) 、短横线(_) 和 IP(多个 IP 之间用逗号分隔),支持 IP 列表匹配、掩码匹配和模糊匹配。 - - -| **属性** | **描述** | -|--------|---------------| -| 参数类型 | varchar | -| 默认值 | 127.0.0.1,::1 | -| 取值范围 | 字符串长度小于 1024 | -| 生效范围 | GLOBAL | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/84.sql_throttle_current_priority-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/84.sql_throttle_current_priority-1.md deleted file mode 100644 index 29e18e2cf..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/84.sql_throttle_current_priority-1.md +++ /dev/null @@ -1,15 +0,0 @@ -sql_throttle_current_priority -================================================== - -sql_throttle_current_priority 用于设置限流优先级,只有 sql_throttle_current_priority 小于 sql_throttle_priority 的那些 Session 上的请求才会被限流。 - - -| **属性** | **描述** | -|--------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | int | -| 默认值 | 100 | -| 取值范围 | 无取值范围,推荐值100 | -| 生效范围 | * GLOBAL * SESSION | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/85.sql_throttle_priority-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/85.sql_throttle_priority-1.md deleted file mode 100644 index 3c372cc7f..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/85.sql_throttle_priority-1.md +++ /dev/null @@ -1,20 +0,0 @@ -sql_throttle_priority -========================================== - -sql_throttle_priority 用于设置限流优先级。只有 sql_throttle_current_priority 小于 sql_throttle_priority 的那些 Session 上的请求才会被限流。 - - -| **属性** | **描述** | -|--------|---------------------------------------------------| -| 参数类型 | int | -| 默认值 | -1 | -| 取值范围 | 无取值范围,实际使用时与 sql_throttle_current_priority 的取值相关 | -| 生效范围 | GLOBAL | - - -**说明** - - - -如果查询的优先级小于此值,则可能不允许执行查询。 - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/86.sql_throttle_rt-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/86.sql_throttle_rt-1.md deleted file mode 100644 index d0b2a89fe..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/86.sql_throttle_rt-1.md +++ /dev/null @@ -1,15 +0,0 @@ -sql_throttle_rt -==================================== - -sql_throttle_rt 用于指定 RT 值,单位为微秒。如果查询的 RT 值不小于该值,则不允许执行该查询。 - - -| **属性** | **描述** | -|--------|-----------------| -| 参数类型 | numeric | -| 默认值 | -1 | -| 取值范围 | 无取值范围,与实际业务负载相关 | -| 生效范围 | GLOBAL | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/87.sql_throttle_network-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/87.sql_throttle_network-1.md deleted file mode 100644 index 7fc734b2b..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/87.sql_throttle_network-1.md +++ /dev/null @@ -1,14 +0,0 @@ -sql_throttle_network -========================================= - -sql_throttle_network 用于指定请求排队时间,如果请求排队时间大于或等于该值,则不允许执行查询。 - - -| **属性** | **描述** | -|--------|---------------| -| 参数类型 | numeric | -| 默认值 | -1 | -| 取值范围 | 与系统负载相关,单位 us | -| 生效范围 | GLOBAL | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/88.auto_increment_cache_size-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/88.auto_increment_cache_size-1.md deleted file mode 100644 index ce6fb7475..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/88.auto_increment_cache_size-1.md +++ /dev/null @@ -1,16 +0,0 @@ -auto_increment_cache_size -============================================== - -auto_increment_cache_size 用于设置缓存的自增值个数。 - - -| **属性** | **描述** | -|---------|------------------| -| 参数类型 | int | -| 默认值 | 1000000 | -| 取值范围 | \[1, 100000000\] | -| 生效范围 | GLOBAL | -| 是否参与序列化 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/89.ob_enable_jit-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/89.ob_enable_jit-1.md deleted file mode 100644 index 711f388dc..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/89.ob_enable_jit-1.md +++ /dev/null @@ -1,17 +0,0 @@ -ob_enable_jit -================================== - -ob_enable_jit 用于设置 JIT 执行引擎模式。 - - -| **属性** | **描述** | -|----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | enum | -| 默认值 | OFF | -| 取值范围 | * OFF:当前 Session 不开启表达式编译执行。 * AUTO:当前 Session 表达式编译执行只有在 SQL 执行平均 RT 大于 1s 时才开启。 * FORCE:当前 Session 强制开启表达式编译执行功能。 | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | -| 是否影响计划生成 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/9.character_set_system-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/9.character_set_system-1.md deleted file mode 100644 index 376bcb466..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/9.character_set_system-1.md +++ /dev/null @@ -1,15 +0,0 @@ -character_set_system -========================================= - -character_set_system 设置服务器使用的字符集。 - - -| **属性** | **描述** | -|--------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | string | -| 默认值 | utf8mb4 | -| 取值范围 | utf8mb4 | -| 生效范围 | * GLOBAL * SESSION | -| 是否可以修改 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/90.ob_timestamp_service-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/90.ob_timestamp_service-1.md deleted file mode 100644 index 44e74cfad..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/90.ob_timestamp_service-1.md +++ /dev/null @@ -1,15 +0,0 @@ -ob_timestamp_service -========================================= - -ob_timestamp_service 用于指定使用何种时间戳服务。 - - -| **属性** | **描述** | -|---------|-------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | enum | -| 默认值 | GTS | -| 取值范围 | * LTS * GTS * HA_GTS | -| 生效范围 | GLOBAL | -| 是否参与序列化 | 是 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/91.plugin_dir-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/91.plugin_dir-1.md deleted file mode 100644 index 3e2105e8e..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/91.plugin_dir-1.md +++ /dev/null @@ -1,14 +0,0 @@ -plugin_dir -=============================== - -plugin_dir 用于设置存放插件 DLL 的路径。 - - -| **属性** | **描述** | -|--------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | varchar | -| 默认值 | ./plugin_dir/ | -| 取值范围 | NULL | -| 生效范围 | * GLOBAL * SESSION | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/92.undo_retention-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/92.undo_retention-1.md deleted file mode 100644 index f8552efe4..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/92.undo_retention-1.md +++ /dev/null @@ -1,39 +0,0 @@ -undo_retention -=================================== - -`undo_retention` 表示系统应保留的多版本数据范围,单位为秒,在转储时控制多版本数据的回收。 - - -| **属性** | **描述** | -|--------|-------------| -| 参数类型 | int | -| 默认值 | 0 | -| 取值范围 | \[0, 2^32^) | -| 生效范围 | GLOBAL | - - - -OceanBase 数据库转储的数据会保留多个版本的历史数据行,您可以通过 `undo_retention `来控制转储中保留的多版本数据范围。 - -其中: - -* 当 `undo_retention` 的值为 `0` 时,表示未开启多版本转储,即转储文件仅保留当前最新版本的行数据。 - - - - - - - - -* 当 `undo_retention` 的值大于 `0` 时,表示开启多版本转储,并且转储文件保留这段时间(多少秒)以内的多版本行数据。 - - - - - -**注意** - - - -租户开启多版本转储后,大版本合并会保留对应的增量转储文件,但 Major SSTable 中不会存放多版本数据。建议该参数不要设置过大,防止因参数过大而导致保留的 SSTable 数量超限。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/93.ob_sql_audit_percentage-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/93.ob_sql_audit_percentage-1.md deleted file mode 100644 index 99d400b05..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/93.ob_sql_audit_percentage-1.md +++ /dev/null @@ -1,15 +0,0 @@ -ob_sql_audit_percentage -============================================ - -ob_sql_audit_percentage 用于设置 SQL Audit 内存上限占当前租户内存的百分比。 - - -| **属性** | **描述** | -|---------|------------| -| 参数类型 | int | -| 默认值 | 10 | -| 取值范围 | \[0, 100\] | -| 生效范围 | GLOBAL | -| 是否参与序列化 | 是 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/94.ob_enable_sql_audit-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/94.ob_enable_sql_audit-1.md deleted file mode 100644 index 0cdd4f11e..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/94.ob_enable_sql_audit-1.md +++ /dev/null @@ -1,17 +0,0 @@ -ob_enable_sql_audit -======================================== - -ob_enable_sql_audit 用于控制当前租户是否开启 SQL Audit 功能。 - - -| **属性** | **描述** | -|---------|------------------------------------------------------------------------------------------------------------------| -| 参数类型 | bool | -| 默认值 | true | -| 取值范围 | * true:表示开启 * false:表示关闭 | -| 生效范围 | GLOBAL | -| 是否参与序列化 | 是 | - - - -enable_sql_audit 为 false 时,全部的租户均不会开启 sql audit 功能。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/95.optimizer_use_sql_plan_baselines-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/95.optimizer_use_sql_plan_baselines-1.md deleted file mode 100644 index 210b522d7..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/95.optimizer_use_sql_plan_baselines-1.md +++ /dev/null @@ -1,15 +0,0 @@ -optimizer_use_sql_plan_baselines -===================================================== - -`optimizer_use_sql_plan_baselines` 用于控制优化器是否会使用 Plan Baseline 计划。 - - -| **属性** | **描述** | -|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | bool | -| 默认值 | 1 | -| 取值范围 | * 0:表示在新生成计划时,不再考虑 Plan Baseline 中的计划,直接使用优化器生成新计划并执行。 * 1: 表示在新生成计划时,优化器会优先使用Plan Baseline 计划,对于新的不同计划则验证通过后才使用。 | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/96.optimizer_capture_sql_plan_baselines-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/96.optimizer_capture_sql_plan_baselines-1.md deleted file mode 100644 index fe45e4f0c..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/96.optimizer_capture_sql_plan_baselines-1.md +++ /dev/null @@ -1,15 +0,0 @@ -optimizer_capture_sql_plan_baselines -========================================================= - -`optimizer_capture_sql_plan_baselines` 用于控制是否自动捕获新计划到 Plan Baseline。 - - -| **属性** | **描述** | -|---------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | bool | -| 默认值 | 1 | -| 取值范围 | * 0:表示不自动捕获新计划到 plan baseline中。 * 1:表示对于新生成的计划,如果该 SQL 没有对应的 Plan Baseline,则将该计划加入到 SQL Plan Baseline, 已有 Plan Baseline 且与新计划不同, 则会触发计划演进进行验证,确定是否需要将新计划替换老的 Plan Baseline。 | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/97.parallel_max_servers-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/97.parallel_max_servers-1.md deleted file mode 100644 index 6bbcb43d6..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/97.parallel_max_servers-1.md +++ /dev/null @@ -1,16 +0,0 @@ -parallel_max_servers -========================================= - -parallel_max_servers 用于设置每个 Server 上并行执行(Parallel eXecution,PX)线程池的大小。 - - -| **属性** | **描述** | -|---------|-------------| -| 参数类型 | int | -| 默认值 | 0 | -| 取值范围 | \[0, 1800\] | -| 生效范围 | GLOBAL | -| 是否参与序列化 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/98.parallel_servers_target-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/98.parallel_servers_target-1.md deleted file mode 100644 index e202a2493..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/98.parallel_servers_target-1.md +++ /dev/null @@ -1,14 +0,0 @@ -parallel_servers_target -============================================ - -parallel_servers_target 用于设置每个 Server 上的大查询排队条件。当并行执行(Parallel eXecution,PX)线程池中有指定的空闲线程数时才调度新查询。 - - -| **属性** | **描述** | -|--------|----------------------------| -| 参数类型 | int | -| 默认值 | 0 | -| 取值范围 | \[0, 9223372036854775807\] | -| 生效范围 | GLOBAL | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/99.ob_trx_idle_timeout-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/99.ob_trx_idle_timeout-1.md deleted file mode 100644 index 5887fedf3..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/2.system-variable-1/99.ob_trx_idle_timeout-1.md +++ /dev/null @@ -1,16 +0,0 @@ -ob_trx_idle_timeout -======================================== - -ob_trx_idle_timeout 用于设置事务空闲超时时间,即事务中两条语句之间的执行间隔超过该值时超时,单位为微秒。 - - -| **属性** | **描述** | -|---------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | int | -| 默认值 | 120s | -| 取值范围 | \[100s,+∞) | -| 生效范围 | * GLOBAL * SESSION | -| 是否参与序列化 | 是 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/1.system-configuration-items-overview-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/1.system-configuration-items-overview-1.md deleted file mode 100644 index 83c8279a4..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/1.system-configuration-items-overview-1.md +++ /dev/null @@ -1,71 +0,0 @@ -系统配置项概述 -============================ - -OceanBase 数据库的配置项对应 OceanBase 数据库的集群参数,通过配置项可以控制集群的负载均衡、合并时间、合并方式、资源分配和模块开关等。 - -生效方式 -------------------------- - -配置项一般分为动态生效和重启生效两种方式,大部分配置项为动态生效方式,即不需要重启 OBServer 即可生效。 - -参数级别 -------------------------- - -OceanBase 数据库的配置项分为集群级别和租户级别。 - -查询某个配置项为集群级别还是租户级别的方法如下: - -```sql -obclient> SHOW PARAMETERS LIKE 'max_syslog_file_count'; -+-------+----------+----------------+----------+-----------------------+-----------+-------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+ -| zone | svr_type | svr_ip | svr_port | name | data_type | value | info - | section | scope | source | edit_level | -+-------+----------+----------------+----------+-----------------------+-----------+-------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+ -| zone2 | observer | -xx.xx.xx.xx - | 2882 | max_syslog_file_count | NULL | 0 | specifies the maximum number of the log files that can co-exist before the log file recycling kicks in. Each log file can occupy at most 256MB disk space. When this value is set to 0, no log file will be removed. Range: [0, +∞) in integer | OBSERVER | CLUSTER | DEFAULT | DYNAMIC_EFFECTIVE | -| zone2 | observer | xx.xx.xx.xx | 2882 | max_syslog_file_count | NULL | 0 | specifies the maximum number of the log files that can co-exist before the log file recycling kicks in. Each log file can occupy at most 256MB disk space. When this value is set to 0, no log file will be removed. Range: [0, +∞) in integer | OBSERVER | CLUSTER | DEFAULT | DYNAMIC_EFFECTIVE | -| zone3 | observer | xx.xx.xx.xx | 2882 | max_syslog_file_count | NULL | 0 | specifies the maximum number of the log files that can co-exist before the log file recycling kicks in. Each log file can occupy at most 256MB disk space. When this value is set to 0, no log file will be removed. Range: [0, +∞) in integer | OBSERVER | CLUSTER | DEFAULT | DYNAMIC_EFFECTIVE | -| zone1 | observer | xx.xx.xx.xx | 2882 | max_syslog_file_count | NULL | 0 | specifies the maximum number of the log files that can co-exist before the log file recycling kicks in. Each log file can occupy at most 256MB disk space. When this value is set to 0, no log file will be removed. Range: [0, +∞) in integer | OBSERVER | CLUSTER | DEFAULT | DYNAMIC_EFFECTIVE | -| zone1 | observer | xx.xx.xx.xx | 2882 | max_syslog_file_count | NULL | 0 | specifies the maximum number of the log files that can co-exist before the log file recycling kicks in. Each log file can occupy at most 256MB disk space. When this value is set to 0, no log file will be removed. Range: [0, +∞) in integer | OBSERVER | CLUSTER | DEFAULT | DYNAMIC_EFFECTIVE | -+-------+----------+----------------+----------+-----------------------+-----------+-------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+ -5 rows in set (0.02 sec) -``` - - - -其中,`scope` 列对应的值为 `CLUSTER` 表示该配置项为集群级别;如果 `scope` 列对应的值为 `TENANT`,则表示该配置项为租户级别。 - -管理权限 -------------------------- - -配置项的管理遵循以下管理规则: - -* 系统租户可以查看和设置所有其他租户(包括系统租户)的配置项。 - - - -* 普通租户只能查看和设置本租户的配置项。 - - - - - - -当 OBServer 启动后,如果未指定配置项,则系统会使用指定配置项的默认值。更多配置项的查看和设置操作请参见 [集群参数管理](../../6.administrator-guide/3.basic-database-management/1.oceanbase-cluster-management/7.cluster-parameter-management/1.overview-of-cluster-parameter-management.md) 章节。 - -与系统变量对比 ----------------------------- - - - -| 对比项 | 系统配置项 | 系统变量 | -|------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 生效范围 | 分为集群、Zone、机器和租户。 | 分为租户的 Global 或 Session 级别。 | -| 生效方式 | * 动态生效:`edit_level` 为`dynamic_effective`。 * 重启生效:`edit_level` 为 `static_effective` 。 | * 设置 Session 级别的变量仅对当前 Session 有效,对其他 Session 无效。 * 设置 Global 级别的变量对当前 Session 无效,需要重新登录建立新的 Session 才会生效。 | -| 修改方式 | * 支持通过 SQL 语句修改,示例如下: ```sql obclient> Alter SYSTEM SET schema_history_expire_time='1h' ``` * 支持通过启动参数修改,示例如下: ```sql cd /home/admin && ./bin/observer -o "schema_history_expire_time='1h'" ``` | 仅支持通过 SQL 语句修改,示例如下: * MySQL 模式 ```sql obclient> SET ob_query_timeout = 20000000; obclient> SET GLOBAL ob_query_timeout = 20000000; ``` * Oracle 模式 ```sql obclient> SET ob_query_timeout = 20000000; obclient> ALTER SYSTEM SET ob_query_timeout = 20000000; ``` | -| 持久化 | 持久化到内部表与配置文件,可以在 `/home/admin/oceanbase/etc/observer.config.bin` 与 `/home/admin/oceanbase/etc/observer.config.bin.history` 文件中查询该配置项。 | 仅 GLOBAL 级别的变量会持久化,SESSION 级别的变量不会进行持久化。 | -| 生命周期 | 长,从进程启动到退出。 | 短,需要租户的 Schema 创建成功以后才生效。 | -| 查询方式 | 可以使用 `SHOW PARAMETERS` 语句查询。 | 可以使用 `SHOW [GLOBAL] VARIABLES` 语句查询。 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/10.balancer_timeout_check_interval-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/10.balancer_timeout_check_interval-1.md deleted file mode 100644 index 612730057..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/10.balancer_timeout_check_interval-1.md +++ /dev/null @@ -1,14 +0,0 @@ -balancer_timeout_check_interval -==================================================== - -balancer_timeout_check_interval 用于设置检查负载均衡等后台任务超时的时间间隔。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 时间类型 | -| 默认值 | 1m,表示 1 分钟 | -| 取值范围 | \[1s, +∞) | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/100.index_clog_cache_priority-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/100.index_clog_cache_priority-1.md deleted file mode 100644 index aaa377718..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/100.index_clog_cache_priority-1.md +++ /dev/null @@ -1,15 +0,0 @@ -index_clog_cache_priority -============================================== - -index_clog_cache_priority 用于设置事务日志索引在缓存系统中的优先级。 - - -| **属性** | **描述** | -|------------------|----------| -| 参数类型 | 整型 | -| 默认值 | 1 | -| 取值范围 | \[1, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/101.index_info_block_cache_priority-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/101.index_info_block_cache_priority-1.md deleted file mode 100644 index cccf2103e..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/101.index_info_block_cache_priority-1.md +++ /dev/null @@ -1,14 +0,0 @@ -index_info_block_cache_priority -==================================================== - -index_info_block_cache_priority 用于设置块索引在缓存系统中的优先级。 - - -| **属性** | **描述** | -|------------------|----------| -| 参数类型 | 整型 | -| 默认值 | 1 | -| 取值范围 | \[1, +∞) | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/102.internal_sql_execute_timeout-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/102.internal_sql_execute_timeout-1.md deleted file mode 100644 index 297a7eb21..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/102.internal_sql_execute_timeout-1.md +++ /dev/null @@ -1,14 +0,0 @@ -internal_sql_execute_timeout -================================================= - -internal_sql_execute_timeout 用于设置系统内部 DML 请求的时间间隔。 - - -| **属性** | **描述** | -|------------------|-------------------| -| 参数类型 | 时间类型 | -| 默认值 | 30s | -| 取值范围 | \[1000us, 10min\] | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/103.large_query_worker_percentage-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/103.large_query_worker_percentage-1.md deleted file mode 100644 index 1f467551a..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/103.large_query_worker_percentage-1.md +++ /dev/null @@ -1,15 +0,0 @@ -large_query_worker_percentage -================================================== - -large_query_worker_percentage 用于设置预留给处理大查询的工作线程百分比。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 双精度浮点数 | -| 默认值 | 30 | -| 取值范围 | \[0, 100\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/104.large_query_threshold-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/104.large_query_threshold-1.md deleted file mode 100644 index 93cd07ad4..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/104.large_query_threshold-1.md +++ /dev/null @@ -1,15 +0,0 @@ -large_query_threshold -========================================== - -large_query_threshold 用于设置查询执行时间的阈值。超过时间的请求可能被暂停,暂停后自动被判断为大查询,执行大查询调度策略。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 时间类型 | -| 默认值 | 5s | -| 取值范围 | \[1ms, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/105.leak_mod_to_check-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/105.leak_mod_to_check-1.md deleted file mode 100644 index 713e9b9c4..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/105.leak_mod_to_check-1.md +++ /dev/null @@ -1,15 +0,0 @@ -leak_mod_to_check -====================================== - -leak_mod_to_check 用于内存泄露检查,是属于内部调试的功能。 - - -| **属性** | **描述** | -|------------------|--------| -| 参数类型 | 字符串 | -| 默认值 | none | -| 取值范围 | NULL | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/106.lease_time-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/106.lease_time-1.md deleted file mode 100644 index f97f0f66a..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/106.lease_time-1.md +++ /dev/null @@ -1,16 +0,0 @@ -lease_time -=============================== - -lease_time 用于设置心跳租约时长。 - - -| **属性** | **描述** | -|------------------|--------------| -| 参数类型 | 时间类型 | -| 默认值 | 10s | -| 取值范围 | \[1s, 5min\] | -| 是否重启 OBServer 生效 | 否 | - - - -RootService 在心跳租约时长内未收到 OBServer 的心跳信息,则认为 OBServer 为脱机状态。 一般不建议修改该配置项。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/107.location_cache_cpu_quota-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/107.location_cache_cpu_quota-1.md deleted file mode 100644 index 2d800884d..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/107.location_cache_cpu_quota-1.md +++ /dev/null @@ -1,14 +0,0 @@ -location_cache_cpu_quota -============================================= - -location_cache_cpu_quota 用于设置位置缓存模块使用的 CPU 配额。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 双精度浮点数 | -| 默认值 | 5 | -| 取值范围 | \[0, 10\] | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/108.location_cache_expire_time-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/108.location_cache_expire_time-1.md deleted file mode 100644 index 98bff25e6..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/108.location_cache_expire_time-1.md +++ /dev/null @@ -1,15 +0,0 @@ -location_cache_expire_time -=============================================== - -location_cache_expire_time 用于设置分区位置缓存中分区位置信息的过期时长。不建议修改。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 时间类型 | -| 默认值 | 600s | -| 取值范围 | \[1s, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/109.location_cache_priority-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/109.location_cache_priority-1.md deleted file mode 100644 index ec415af95..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/109.location_cache_priority-1.md +++ /dev/null @@ -1,15 +0,0 @@ -location_cache_priority -============================================ - -location_cache_priority 用于设置位置缓存在系统缓存服务中的优先级。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 整型 | -| 默认值 | 1000 | -| 取值范围 | \[1s, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/11.balancer_task_timeout-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/11.balancer_task_timeout-1.md deleted file mode 100644 index b1f91723f..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/11.balancer_task_timeout-1.md +++ /dev/null @@ -1,14 +0,0 @@ -balancer_task_timeout -========================================== - -balancer_task_timeout 用于设置负载均衡等后台任务的超时时间。 - - -| **属性** | **描述** | -|------------------|--------------| -| 参数类型 | 时间类型 | -| 默认值 | 20m,表示 20 分钟 | -| 取值范围 | \[1s, +∞) | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/110.location_cache_refresh_min_interval-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/110.location_cache_refresh_min_interval-1.md deleted file mode 100644 index 63ab8d15c..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/110.location_cache_refresh_min_interval-1.md +++ /dev/null @@ -1,15 +0,0 @@ -location_cache_refresh_min_interval -======================================================== - -location_cache_refresh_min_interval 用于设置位置缓存刷新请求的最小间隔,防止产生过多刷新请求造成系统压力过大。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 时间类型 | -| 默认值 | 100ms | -| 取值范围 | \[0s, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/111.location_fetch_concurrency-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/111.location_fetch_concurrency-1.md deleted file mode 100644 index 16401c614..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/111.location_fetch_concurrency-1.md +++ /dev/null @@ -1,14 +0,0 @@ -location_fetch_concurrency -=============================================== - -location_fetch_concurrency 用于设置单机 location_cache 刷新的最大并发数。 - - -| **属性** | **描述** | -|------------------|-------------| -| 参数类型 | 整型 | -| 默认值 | 20 | -| 取值范围 | \[1, 1000\] | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/112.location_refresh_thread_count-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/112.location_refresh_thread_count-1.md deleted file mode 100644 index 8a60091fe..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/112.location_refresh_thread_count-1.md +++ /dev/null @@ -1,15 +0,0 @@ -location_refresh_thread_count -================================================== - -location_refresh_thread_count 用于设置 OBServer 从 RootService 中获取分区位置信息的线程数量。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 整型 | -| 默认值 | 4 | -| 取值范围 | \[2, 64\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/113.log_archive_checkpoint_interval-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/113.log_archive_checkpoint_interval-1.md deleted file mode 100644 index 0f6faf054..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/113.log_archive_checkpoint_interval-1.md +++ /dev/null @@ -1,14 +0,0 @@ -log_archive_checkpoint_interval -==================================================== - -log_archive_checkpoint_interval 用于设置冷数据的日志归档检查点的时间间隔。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 时间类型 | -| 默认值 | 30s | -| 取值范围 | \[5s, 1h\] | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/114.log_archive_concurrency-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/114.log_archive_concurrency-1.md deleted file mode 100644 index 3524cd692..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/114.log_archive_concurrency-1.md +++ /dev/null @@ -1,14 +0,0 @@ -log_archive_concurrency -============================================ - -log_archive_concurrency 用于设置日志归档的并发度。 - - -| **属性** | **描述** | -|------------------|----------| -| 参数类型 | 整型 | -| 默认值 | 0 | -| 取值范围 | \[0, +∞) | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/115.log_restore_concurrency-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/115.log_restore_concurrency-1.md deleted file mode 100644 index c157c8673..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/115.log_restore_concurrency-1.md +++ /dev/null @@ -1,14 +0,0 @@ -log_restore_concurrency -============================================ - -log_restore_concurrency 用于设置恢复日志的并发度。 - - -| **属性** | **描述** | -|------------------|----------| -| 参数类型 | 整型 | -| 默认值 | 10 | -| 取值范围 | \[1, +∞) | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/116.major_freeze_duty_time-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/116.major_freeze_duty_time-1.md deleted file mode 100644 index 3cba8505c..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/116.major_freeze_duty_time-1.md +++ /dev/null @@ -1,15 +0,0 @@ -major_freeze_duty_time -=========================================== - -major_freeze_duty_time 用于设置每日定时冻结和合并的触发时刻。 - - -| **属性** | **描述** | -|------------------|------------------| -| 参数类型 | 时刻 | -| 默认值 | 02:00 | -| 取值范围 | \[00:00, 23:59\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/117.max_kept_major_version_number-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/117.max_kept_major_version_number-1.md deleted file mode 100644 index 2c69ae0ab..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/117.max_kept_major_version_number-1.md +++ /dev/null @@ -1,15 +0,0 @@ -max_kept_major_version_number -================================================== - -max_kept_major_version_number 用于设置数据保留的冻结版本数量。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 整型 | -| 默认值 | 2 | -| 取值范围 | \[1, 16\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/118.max_string_print_length-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/118.max_string_print_length-1.md deleted file mode 100644 index 1d760670b..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/118.max_string_print_length-1.md +++ /dev/null @@ -1,15 +0,0 @@ -max_string_print_length -============================================ - -max_string_print_length 用于设置打印系统日志时,单行日志最大长度。 - - -| **属性** | **描述** | -|------------------|----------| -| 参数类型 | 整型 | -| 默认值 | 500 | -| 取值范围 | \[0, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/119.max_syslog_file_count-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/119.max_syslog_file_count-1.md deleted file mode 100644 index ea70390f6..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/119.max_syslog_file_count-1.md +++ /dev/null @@ -1,16 +0,0 @@ -max_syslog_file_count -========================================== - -max_syslog_file_count 用于设置在回收日志文件之前可以容纳的日志文件数量。 - - -| **属性** | **描述** | -|------------------|----------| -| 参数类型 | 整型 | -| 默认值 | 0 | -| 取值范围 | \[0, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - -每个日志文件最多可以占用 256 MB 的磁盘空间。 当该配置项的值为 0 时,不会删除任何日志文件。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/12.balancer_tolerance_percentage-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/12.balancer_tolerance_percentage-1.md deleted file mode 100644 index 511b10ff0..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/12.balancer_tolerance_percentage-1.md +++ /dev/null @@ -1,14 +0,0 @@ -balancer_tolerance_percentage -================================================== - -balancer_tolerance_percentage 用于设置负载均衡策略中,租户内多个 UNIT 间磁盘不均衡程度的宽容度,如果在均值 + 或 - 宽容度范围之内,不会触发执行均衡动作。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 整型 | -| 默认值 | 10 | -| 取值范围 | \[1, 99\] | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/120.merge_stat_sampling_ratio-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/120.merge_stat_sampling_ratio-1.md deleted file mode 100644 index ae79ad3c0..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/120.merge_stat_sampling_ratio-1.md +++ /dev/null @@ -1,14 +0,0 @@ -merge_stat_sampling_ratio -============================================== - -merge_stat_sampling_ratio 用于设置合并时候数据列统计信息的采样率。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 整型 | -| 默认值 | 100 | -| 取值范围 | \[0, 100\] | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/121.major_compact_trigger-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/121.major_compact_trigger-1.md deleted file mode 100644 index 82ca308b8..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/121.major_compact_trigger-1.md +++ /dev/null @@ -1,16 +0,0 @@ -major_compact_trigger -========================================== - -major_compact_trigger 用于设置多少次小合并触发一次全局合并。 - - -| **属性** | **描述** | -|------------------|--------------| -| 参数类型 | 整型 | -| 默认值 | 5 | -| 取值范围 | \[0, 65535\] | -| 是否重启 OBServer 生效 | 否 | - - - -当 major_compact_trigger 配置项的取值为 0 时,表示关闭小合并。该配置项与配置项 minor_freeze_times 的功能相同。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/122.memory_chunk_cache_size-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/122.memory_chunk_cache_size-1.md deleted file mode 100644 index 56d8f1d35..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/122.memory_chunk_cache_size-1.md +++ /dev/null @@ -1,16 +0,0 @@ -memory_chunk_cache_size -============================================ - -memory_chunk_cache_size 用于设置内存分配器缓存的内存块容量。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 容量单位 | -| 默认值 | 0M | -| 取值范围 | \[0M, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - -当 memory_chunk_cache_size 配置项的值为 0 时,表示系统自适应。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/123.memory_limit-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/123.memory_limit-1.md deleted file mode 100644 index 0cb45a9c7..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/123.memory_limit-1.md +++ /dev/null @@ -1,48 +0,0 @@ -memory_limit -================================= - -memory_limit 表示可用的总内存大小。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 容量单位 | -| 默认值 | 0 | -| 取值范围 | \[0M, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - -memory_limit 的默认值为 0。如果该值不为 0,则系统会忽略 memory_limit_percentage 的设置而优先使用 memory_limit 配置的值。例如,一台物理机的内存为 100 G,memory_limit_percentage 设置为 80,表示使用 80% 的内存,而 memory_limit 参数设置为 90G,则实际物理机上 OceanBase 数据库可分配的内存使用 memory_limit 的配置,即 90 G。 - -使用注意事项: - -* memory_limit 的默认单位为 MB。 - - 例如,`memory_limit='40G' `表示设置 OceanBase 数据库进程的使用内存上限是40 GB。由于默认单位为 MB,则 `memory_limit=40960 `与 `memory_limit='40G' `设置的值相同。 - - -* memory_limit 的值目前无上限。如果设置的内存最大上限超过了实际的物理内存总和,则会导致系统中其他按总内存计算的值偏大。 - - - -* 如果希望限制运行中的 OceanBase 数据库的内存大小,可以直接修改 memory_limit 的值,使其达到预期。设置后,后台参数 Reload 线程会使其动态生效,无需重启。但是在设置时,需要保证 memory_limit 的值小于系统总 hold 值。 - - - **注意** - - - - `memory_limit `的值必须大于 OBServer 实际已使用的内存。 - - 查询当前已使用的内存数(单位:GB)的方法如下: - - ```sql - obclient> SELECT value/1024/1024/1024 used_gb FROM v$sysstat WHERE name LIKE '%observer memory%' AND con_id = 1 AND stat_id=140008 AND name='observer memory used size'; - ``` - - - - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/124.memory_limit_percentage-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/124.memory_limit_percentage-1.md deleted file mode 100644 index 69168b64c..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/124.memory_limit_percentage-1.md +++ /dev/null @@ -1,15 +0,0 @@ -memory_limit_percentage -============================================ - -memory_limit_percentage 用于设置系统总可用内存大小占总内存大小的百分比。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 整型 | -| 默认值 | 80 | -| 取值范围 | \[10, 90\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/125.memory_reserved-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/125.memory_reserved-1.md deleted file mode 100644 index 520b243dd..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/125.memory_reserved-1.md +++ /dev/null @@ -1,15 +0,0 @@ -memory_reserved -==================================== - -memory_reserved 用于设置系统预留内存的大小。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 容量单位 | -| 默认值 | 500M | -| 取值范围 | \[10M, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/126.merge_thread_count-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/126.merge_thread_count-1.md deleted file mode 100644 index 69965508f..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/126.merge_thread_count-1.md +++ /dev/null @@ -1,16 +0,0 @@ -merge_thread_count -======================================= - -`merge_thread_count` 用于设置每日合并工作的线程数。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 整型 | -| 默认值 | 0 | -| 取值范围 | \[0, 256\] | -| 是否重启 OBServer 生效 | 否 | - - - -该配置项的值为 `0` 时,合并的工作进程数的计算方式为 `min{10,cpu_cnt*0.3}`,其中 `cpu_cnt` 为系统 CPU 的数量。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/127.merger_check_interval-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/127.merger_check_interval-1.md deleted file mode 100644 index 0db8acc3b..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/127.merger_check_interval-1.md +++ /dev/null @@ -1,15 +0,0 @@ -merger_check_interval -========================================== - -merger_check_interval 用于设置合并状态检查线程的调度间隔。 - - -| **属性** | **描述** | -|------------------|--------------| -| 参数类型 | 时间类型 | -| 默认值 | 10m,表示 10 分钟 | -| 取值范围 | \[10s, 60m\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/128.merger_completion_percentage-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/128.merger_completion_percentage-1.md deleted file mode 100644 index df43011cf..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/128.merger_completion_percentage-1.md +++ /dev/null @@ -1,15 +0,0 @@ -merger_completion_percentage -================================================= - -merger_completion_percentage 用于设置合并完成副本数的百分比阈值,达到该阈值则认为本轮合并完成调度。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 整型 | -| 默认值 | 100 | -| 取值范围 | \[5, 100\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/129.merger_switch_leader_duration_time-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/129.merger_switch_leader_duration_time-1.md deleted file mode 100644 index 9c8e996f6..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/129.merger_switch_leader_duration_time-1.md +++ /dev/null @@ -1,15 +0,0 @@ -merger_switch_leader_duration_time -======================================================= - -merger_switch_leader_duration_time 用于设置每日合并时批量切主的时间间隔。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 时间类型 | -| 默认值 | 3m,表示 3 分钟 | -| 取值范围 | \[0s, 30\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/13.balancer_emergency_percentage-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/13.balancer_emergency_percentage-1.md deleted file mode 100644 index 33b88539f..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/13.balancer_emergency_percentage-1.md +++ /dev/null @@ -1,15 +0,0 @@ -balancer_emergency_percentage -================================================== - -balancer_emergency_percentage 用于设置 UNIT 负载阈值,即当 UNIT 负载超过该阈值时,允许开启副本向外迁移,即使在合并期间也执行负载均衡。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 整型 | -| 默认值 | 80 | -| 取值范围 | \[1, 100\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/130.merger_warm_up_duration_time-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/130.merger_warm_up_duration_time-1.md deleted file mode 100644 index fc5160917..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/130.merger_warm_up_duration_time-1.md +++ /dev/null @@ -1,15 +0,0 @@ -merger_warm_up_duration_time -================================================= - -merger_warm_up_duration_time 用于设置合并时,新版基线数据的预热时间。 - - -| **属性** | **描述** | -|------------------|-------------| -| 参数类型 | 时间类型 | -| 默认值 | 0s | -| 取值范围 | \[0s, 60m\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/131.max_px_worker_count-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/131.max_px_worker_count-1.md deleted file mode 100644 index 79fe90bf9..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/131.max_px_worker_count-1.md +++ /dev/null @@ -1,15 +0,0 @@ -max_px_worker_count -======================================== - -max_px_worker_count 用于设置 SQL 并行查询引擎使用的最大线程数。 - - -| **属** **性** | **描述** | -|------------------|--------------| -| 参数类型 | 整型 | -| 默认值 | 64 | -| 取值范围 | \[0, 65535\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/132.migration_disable_time-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/132.migration_disable_time-1.md deleted file mode 100644 index b3eb26810..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/132.migration_disable_time-1.md +++ /dev/null @@ -1,15 +0,0 @@ -migration_disable_time -=========================================== - -migration_disable_time 用于设置因磁盘满等原因导致某个节点数据迁入失败时的暂停迁入时长。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 时间类型 | -| 默认值 | 3600s | -| 取值范围 | \[1s, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/133.min_observer_version-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/133.min_observer_version-1.md deleted file mode 100644 index 1c94be0ed..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/133.min_observer_version-1.md +++ /dev/null @@ -1,15 +0,0 @@ -min_observer_version -========================================= - -`min_observer_version` 用于设置本集群最低的 OBServer 应用程序版本号。 - - -| **属性** | **描述** | -|------------------|--------| -| 参数类型 | 字符串 | -| 默认值 | 3.1.0 | -| 取值范围 | NULL | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/134.minor_deferred_gc_time-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/134.minor_deferred_gc_time-1.md deleted file mode 100644 index 966dcf0f6..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/134.minor_deferred_gc_time-1.md +++ /dev/null @@ -1,15 +0,0 @@ -minor_deferred_gc_time -=========================================== - -minor_deferred_gc_time 用于设置合并之后 SSTable 延迟回收的时间间隔。 - - -| **属性** | **描述** | -|------------------|-------------| -| 参数类型 | 时间类型 | -| 默认值 | 0s | -| 取值范围 | \[0s, 24h\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/135.minor_freeze_times-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/135.minor_freeze_times-1.md deleted file mode 100644 index 512d341ff..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/135.minor_freeze_times-1.md +++ /dev/null @@ -1,19 +0,0 @@ -minor_freeze_times -======================================= - -minor_freeze_times 用于设置多少次小合并触发一次全局合并。值为 0 时,表示关闭小合并。 - - -| **属性** | **描述** | -|------------------|--------------| -| 参数类型 | 整型 | -| 默认值 | 5 | -| 取值范围 | \[0, 65535\] | -| 是否重启 OBServer 生效 | 否 | - - -**说明** - - - -minor_freeze_times 配置项与 major_compact_trigger 配置项具有相同功能。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/136.minor_warm_up_duration_time-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/136.minor_warm_up_duration_time-1.md deleted file mode 100644 index 267ecdd4c..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/136.minor_warm_up_duration_time-1.md +++ /dev/null @@ -1,16 +0,0 @@ -minor_warm_up_duration_time -================================================ - -minor_warm_up_duration_time 用于设置小合并产生新转储文件的预热时间。 - - -| **属性** | **描述** | -|------------------|-------------| -| 参数类型 | 时间类型 | -| 默认值 | 30s | -| 取值范围 | \[0s, 60m\] | -| 是否重启 OBServer 生效 | 否 | - - - -当 minor_warm_up_duration_time 配置项的值为 0s 时,表示不进行预热。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/137.mysql_port-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/137.mysql_port-1.md deleted file mode 100644 index b9a7d5346..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/137.mysql_port-1.md +++ /dev/null @@ -1,15 +0,0 @@ -mysql_port -=============================== - -mysql_port 用于设置 SQL 服务协议端口号。 - - -| **属性** | **描述** | -|------------------|-----------------| -| 参数类型 | 整型 | -| 默认值 | 2880 | -| 取值范围 | \[1025, 65535\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/138.minor_merge_concurrency-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/138.minor_merge_concurrency-1.md deleted file mode 100644 index 4cf41f71c..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/138.minor_merge_concurrency-1.md +++ /dev/null @@ -1,14 +0,0 @@ -minor_merge_concurrency -============================================ - -minor_merge_concurrency 用于设置小合并时的并发线程数。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 整型 | -| 默认值 | 0 | -| 取值范围 | \[0, 64\] | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/139.multiblock_read_gap_size-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/139.multiblock_read_gap_size-1.md deleted file mode 100644 index c00f22438..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/139.multiblock_read_gap_size-1.md +++ /dev/null @@ -1,14 +0,0 @@ -multiblock_read_gap_size -============================================= - -multiblock_read_gap_size 用于设置一次 IO 聚合读取块缓存的最大容量。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 容量单位 | -| 默认值 | 0K | -| 取值范围 | \[0k, 2M\] | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/14.balance_blacklist_failure_threshold-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/14.balance_blacklist_failure_threshold-1.md deleted file mode 100644 index 8e953d73e..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/14.balance_blacklist_failure_threshold-1.md +++ /dev/null @@ -1,14 +0,0 @@ -balance_blacklist_failure_threshold -======================================================== - -balance_blacklist_failure_threshold 用于设置副本迁移等后台任务连续失败次数的阈值。副本迁移等后台任务连续失败次数超过该阈值后,将被放入黑名单。 - - -| **属性** | **描述** | -|------------------|-------------| -| 参数类型 | 整型 | -| 默认值 | 5 | -| 取值范围 | \[0, 1000\] | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/140.multiblock_read_size-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/140.multiblock_read_size-1.md deleted file mode 100644 index eb2d0f9f2..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/140.multiblock_read_size-1.md +++ /dev/null @@ -1,15 +0,0 @@ -multiblock_read_size -========================================= - -multiblock_read_size 用于设置读取数据时 IO 聚合大小。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 容量单位 | -| 默认值 | 128k | -| 取值范围 | \[0K, 2M\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/141.micro_block_merge_verify_level-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/141.micro_block_merge_verify_level-1.md deleted file mode 100644 index 859ae6602..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/141.micro_block_merge_verify_level-1.md +++ /dev/null @@ -1,14 +0,0 @@ -micro_block_merge_verify_level -=================================================== - -micro_block_merge_verify_level 用于设置合并时宏块的校验级别。 - - -| **属性** | **描述** | -|------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | 整型 | -| 默认值 | 2 | -| 取值范围 | * 0:表示不做校验 * 1:表示验证编码算法,将读取编码后的微块以确保数据正确 * 2:表示验证编码和压缩算法,除编码验证外,还将对压缩块进行解压缩以确保数据正确 * 3:表示验证编码,压缩算法和丢失写保护 | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/142.migrate_concurrency-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/142.migrate_concurrency-1.md deleted file mode 100644 index ed2291ef5..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/142.migrate_concurrency-1.md +++ /dev/null @@ -1,14 +0,0 @@ -migrate_concurrency -======================================== - -migrate_concurrency 用于控制控制内部数据迁移的并发度。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 整型 | -| 默认值 | 10 | -| 取值范围 | \[0, 64\] | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/143.minor_compact_trigger-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/143.minor_compact_trigger-1.md deleted file mode 100644 index 7b09cfec9..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/143.minor_compact_trigger-1.md +++ /dev/null @@ -1,16 +0,0 @@ -minor_compact_trigger -========================================== - -minor_compact_trigger 用于控制分层转储触发向下一层下压的阈值。当该层的 Mini SSTable 总数达到设定的阈值时,所有 SSTable 都会被下压到下一层,组成新的 Minor SSTable。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 整型 | -| 默认值 | 2 | -| 取值范围 | \[0, 16\] | -| 是否重启 OBServer 生效 | 否 | - - - -当 minor_compact_trigger 的值为 0 时,OceanBase 数据库仍会进行分层转储,即此时 MemTable 仍然会 Dump 为 Mini SSTable,但后续会立即调度下压合并生成新的 Minor SSTable,替代原有的 Minor SSTable。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/144.memstore_limit_percentage-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/144.memstore_limit_percentage-1.md deleted file mode 100644 index 876ee244b..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/144.memstore_limit_percentage-1.md +++ /dev/null @@ -1,20 +0,0 @@ -memstore_limit_percentage -============================================== - -memstore_limit_percentage 用于设置租户使用 memstore 的内存占其总可用内存的百分比。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 整型 | -| 默认值 | 50 | -| 取值范围 | \[1, 99\] | -| 是否重启 OBServer 生效 | 否 | - - - -memstore_limit_percentage 配置项用于计算 Memstore_limit 的值: - -memstore_limit_percentage = memstore_limit / min_memory - -其中,min_memory 为创建租户时指定的值。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/145.net_thread_count-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/145.net_thread_count-1.md deleted file mode 100644 index 4c27f58d7..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/145.net_thread_count-1.md +++ /dev/null @@ -1,16 +0,0 @@ -net_thread_count -===================================== - -net_thread_count 用于设置网络 I/O 线程数。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 整型 | -| 默认值 | 12 | -| 取值范围 | \[1, 100\] | -| 是否重启 OBServer 生效 | 否 | - - - -当 net_thread_count 配置项值为 8 时,表示 RPC 和 MySQL 的 libeasy 的 I/O 线程各为 8 个线程。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/146.obconfig_url-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/146.obconfig_url-1.md deleted file mode 100644 index 794a606dd..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/146.obconfig_url-1.md +++ /dev/null @@ -1,15 +0,0 @@ -obconfig_url -================================= - -obconfig_url 用于设置 OBConfig 服务的 URL 地址。OBServer 从指定 URL 获取 RootService 的地址。 - - -| **属性** | **描述** | -|------------------|--------| -| 参数类型 | 字符串类型 | -| 默认值 | 空值 | -| 取值范围 | NULL | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/147.ob_enable_batched_multi_statement-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/147.ob_enable_batched_multi_statement-1.md deleted file mode 100644 index 00ea52931..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/147.ob_enable_batched_multi_statement-1.md +++ /dev/null @@ -1,14 +0,0 @@ -ob_enable_batched_multi_statement -====================================================== - -ob_enable_batched_multi_statement 用于设置是否启用批处理多条语句的功能。 - - -| **属性** | **描述** | -|------------------|---------------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | False | -| 取值范围 | * False:不启用 * True:启用 | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/148.partition_table_check_interval-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/148.partition_table_check_interval-1.md deleted file mode 100644 index 709ce7b0e..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/148.partition_table_check_interval-1.md +++ /dev/null @@ -1,15 +0,0 @@ -partition_table_check_interval -=================================================== - -partition_table_check_interval 用于设置 OBServer 从分区表中删除不存在的副本的时间间隔。 - - -| **属性** | **描述** | -|------------------|--------------| -| 参数类型 | 时间类型 | -| 默认值 | 30m,表示 30 分钟 | -| 取值范围 | \[1m, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/149.partition_table_scan_batch_count-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/149.partition_table_scan_batch_count-1.md deleted file mode 100644 index 3191bd294..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/149.partition_table_scan_batch_count-1.md +++ /dev/null @@ -1,15 +0,0 @@ -partition_table_scan_batch_count -===================================================== - -partition_table_scan_batch_count 用于设置批量读取分区表信息的数量。 - - -| **属性** | **描述** | -|------------------|--------------| -| 参数类型 | 整型 | -| 默认值 | 999 | -| 取值范围 | \[1, 65536\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/15.balance_blacklist_retry_interval-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/15.balance_blacklist_retry_interval-1.md deleted file mode 100644 index c0fdbee49..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/15.balance_blacklist_retry_interval-1.md +++ /dev/null @@ -1,15 +0,0 @@ -balance_blacklist_retry_interval -===================================================== - -balance_blacklist_retry_interval 用于设置副本迁移等后台任务被放入黑名单后的重试时间间隔。 - - -| **属性** | **描述** | -|------------------|--------------| -| 参数类型 | 时间类型 | -| 默认值 | 30m,表示 30 分钟 | -| 取值范围 | \[0s, 180m\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/150.plan_cache_evict_interval-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/150.plan_cache_evict_interval-1.md deleted file mode 100644 index 58952d0f7..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/150.plan_cache_evict_interval-1.md +++ /dev/null @@ -1,15 +0,0 @@ -plan_cache_evict_interval -============================================== - -plan_cache_evict_interval 用于设置执行计划缓存的淘汰时间间隔。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 时间类型 | -| 默认值 | 30s | -| 取值范围 | \[0s, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/151.px_task_size-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/151.px_task_size-1.md deleted file mode 100644 index 737452cbc..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/151.px_task_size-1.md +++ /dev/null @@ -1,15 +0,0 @@ -px_task_size -================================= - -px_task_size 用于设置 SQL 并行查询引擎每个任务处理的数据量大小。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 容量单位 | -| 默认值 | 2M | -| 取值范围 | \[2M, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/152.px_workers_per_cpu_quota-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/152.px_workers_per_cpu_quota-1.md deleted file mode 100644 index f37ddc478..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/152.px_workers_per_cpu_quota-1.md +++ /dev/null @@ -1,14 +0,0 @@ -px_workers_per_cpu_quota -============================================= - -px_workers_per_cpu_quota 用于设置并行执行工作线程数的比例。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 整型 | -| 默认值 | 10 | -| 取值范围 | \[0, 20\] | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/153.replica_safe_remove_time-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/153.replica_safe_remove_time-1.md deleted file mode 100644 index d21577a75..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/153.replica_safe_remove_time-1.md +++ /dev/null @@ -1,15 +0,0 @@ -replica_safe_remove_time -============================================= - -replica_safe_remove_time 用于设置已删除副本可以被清理的安全保留时间。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 时间类型 | -| 默认值 | 2h | -| 取值范围 | \[1m, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/154.resource_hard_limit-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/154.resource_hard_limit-1.md deleted file mode 100644 index 54686e811..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/154.resource_hard_limit-1.md +++ /dev/null @@ -1,30 +0,0 @@ -resource_hard_limit -======================================== - -resource_hard_limit 用于分配 unit 。 - - -| **属性** | **描述** | -|------------------|--------------| -| 参数类型 | 整型 | -| 默认值 | 100 | -| 取值范围 | \[1, 10000\] | -| 是否重启 OBServer 生效 | 否 | - - - -resource_hard_limit 与 resource_soft_limit 配置项一起配合使用。 - -* 如果 Server 的资源占用比少于 resource_soft_limit,则按 best_fit 来分配 Unit; - - - -* 如果 Server 的资源占用比大于 resource_soft_limit,则按照 leaset_load 来分配 Unit。 - - - - - - -在分配 CPU 和内存等资源时,资源总量是实际数量乘以该百分比的值。最终 Server 资源占比不能超过 resource_hard_limit。 - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/155.resource_soft_limit-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/155.resource_soft_limit-1.md deleted file mode 100644 index da9624b90..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/155.resource_soft_limit-1.md +++ /dev/null @@ -1,16 +0,0 @@ -resource_soft_limit -======================================== - -resource_soft_limit 用于设置是否开启 Unit 均衡。 - - -| **属性** | **描述** | -|------------------|--------------| -| 参数类型 | 整型 | -| 默认值 | 50 | -| 取值范围 | \[1, 10000\] | -| 是否重启 OBServer 生效 | 否 | - - - -当 resource_soft_limit 配置项取值小于 100 时, 表示 Unit 均衡开关打开;当时 resource_soft_limit 配置项取值大于等于 100 时,表示 Unit 均衡开关关闭。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/156.rootservice_async_task_queue_size-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/156.rootservice_async_task_queue_size-1.md deleted file mode 100644 index 15cb38db8..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/156.rootservice_async_task_queue_size-1.md +++ /dev/null @@ -1,15 +0,0 @@ -rootservice_async_task_queue_size -====================================================== - -rootservice_async_task_queue_size 用于设置 RootService 内部异步任务队列的大小。 - - -| **属性** | **描述** | -|------------------|---------------| -| 参数类型 | 整型 | -| 默认值 | 16384 | -| 取值范围 | \[8, 131072\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/157.rootservice_async_task_thread_count-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/157.rootservice_async_task_thread_count-1.md deleted file mode 100644 index 092f4dd11..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/157.rootservice_async_task_thread_count-1.md +++ /dev/null @@ -1,15 +0,0 @@ -rootservice_async_task_thread_count -======================================================== - -rootservice_async_task_thread_count 用于设置 RootService 内部异步任务使用的线程池大小。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 整型 | -| 默认值 | 4 | -| 取值范围 | \[1, 10\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/158.rootservice_list-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/158.rootservice_list-1.md deleted file mode 100644 index 5a8ddff94..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/158.rootservice_list-1.md +++ /dev/null @@ -1,15 +0,0 @@ -rootservice_list -===================================== - -rootservice_list 用于显示 RootService 及其副本所在的机器列表。 - - -| **属性** | **描述** | -|------------------|--------| -| 参数类型 | 字符串 | -| 默认值 | 空值 | -| 取值范围 | NULL | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/159.rootservice_ready_check_interval-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/159.rootservice_ready_check_interval-1.md deleted file mode 100644 index 34331a145..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/159.rootservice_ready_check_interval-1.md +++ /dev/null @@ -1,15 +0,0 @@ -rootservice_ready_check_interval -===================================================== - -rootservice_ready_check_interval 用于设置 RootService 启动后等待和检查集群状态的时间间隔。 - - -| **属性** | **描述** | -|------------------|------------------| -| 参数类型 | 时间类型 | -| 默认值 | 3s | -| 取值范围 | \[100000us, 1m\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/16.backup_concurrency-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/16.backup_concurrency-1.md deleted file mode 100644 index 31c5f3233..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/16.backup_concurrency-1.md +++ /dev/null @@ -1,15 +0,0 @@ -backup_concurrency -======================================= - -backup_concurrency 用于设置备份时写文件系统的并发数量。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 整型 | -| 默认值 | 0 | -| 取值范围 | \[0, 100\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/160.row_compaction_update_limit-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/160.row_compaction_update_limit-1.md deleted file mode 100644 index 7c78c40da..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/160.row_compaction_update_limit-1.md +++ /dev/null @@ -1,15 +0,0 @@ -row_compaction_update_limit -================================================ - -row_compaction_update_limit 用于设置触发内存中行内数据合并的修改次数。 - - -| **属性** | **描述** | -|------------------|-------------| -| 参数类型 | 整型 | -| 默认值 | 6 | -| 取值范围 | \[1, 6400\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/161.row_purge_thread_count-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/161.row_purge_thread_count-1.md deleted file mode 100644 index ab333bb25..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/161.row_purge_thread_count-1.md +++ /dev/null @@ -1,15 +0,0 @@ -row_purge_thread_count -=========================================== - -row_purge_thread_count 用于设置执行内存中行内数据合并的最大工作线程数。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 整型 | -| 默认值 | 4 | -| 取值范围 | \[1, 64\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/162.rpc_port-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/162.rpc_port-1.md deleted file mode 100644 index 1f4c3c2e0..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/162.rpc_port-1.md +++ /dev/null @@ -1,14 +0,0 @@ -rpc_port -============================= - -rpc_port 用于设置远程访问的协议端口号。 - - -| **属性** | **描述** | -|------------------|-----------------| -| 参数类型 | 整型 | -| 默认值 | 2500 | -| 取值范围 | \[1025, 65535\] | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/163.rpc_timeout-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/163.rpc_timeout-1.md deleted file mode 100644 index f1b83fb0c..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/163.rpc_timeout-1.md +++ /dev/null @@ -1,15 +0,0 @@ -rpc_timeout -================================ - -rpc_timeout 用于设置集群内部请求的超时时间。 - - -| **属性** | **描述** | -|------------------|----------| -| 参数类型 | 时间类型 | -| 默认值 | 2s | -| 取值范围 | \[0, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/164.restore_concurrency-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/164.restore_concurrency-1.md deleted file mode 100644 index bc37b4303..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/164.restore_concurrency-1.md +++ /dev/null @@ -1,15 +0,0 @@ -restore_concurrency -======================================== - -restore_concurrency 用于设置从备份恢复租户数据时的最大并发度。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 整型 | -| 默认值 | 0 | -| 取值范围 | \[0, 512\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/165.rootservice_memory_limit-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/165.rootservice_memory_limit-1.md deleted file mode 100644 index 0ca6a8cbf..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/165.rootservice_memory_limit-1.md +++ /dev/null @@ -1,15 +0,0 @@ -rootservice_memory_limit -============================================= - -rootservice_memory_limit 用于设置 RootService 的最大内存容量限制。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 容量单位 | -| 默认值 | 2G | -| 取值范围 | \[2G, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/166.rebuild_replica_data_lag_threshold-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/166.rebuild_replica_data_lag_threshold-1.md deleted file mode 100644 index 2b7135082..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/166.rebuild_replica_data_lag_threshold-1.md +++ /dev/null @@ -1,17 +0,0 @@ -rebuild_replica_data_lag_threshold -======================================================= - -rebuild_replica_data_lag_threshold 用于设置备副本的事务日志和主副本差距的阈值,当超过该阈值时,会触发副本重建。 - - -| **属性** | **描述** | -|------------------|----------| -| 参数类型 | 容量单位 | -| 默认值 | 50GB | -| 取值范围 | \[0, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - -rebuild_replica_data_lag_threshold 配置项的值为 0 时,表示不触发副本重建。 - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/167.schema_history_expire_time.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/167.schema_history_expire_time.md deleted file mode 100644 index aedd0c8d0..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/167.schema_history_expire_time.md +++ /dev/null @@ -1,14 +0,0 @@ -schema_history_expire_time -=============================================== - -schema_history_expire_time 用于设置元数据历史数据过期时间。 - - -| **属性** | **描述** | -|------------------|-------------| -| 参数类型 | 时间类型 | -| 默认值 | 7d,d 表示天 | -| 取值范围 | \[1h, 30d\] | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/168.ssl_client_authentication-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/168.ssl_client_authentication-1.md deleted file mode 100644 index 57c270888..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/168.ssl_client_authentication-1.md +++ /dev/null @@ -1,19 +0,0 @@ -ssl_client_authentication -============================================== - -ssl_client_authentication 用于设置是否开启 SSL 连接功能。 - - -| **属性** | **描述** | -|------------------|---------------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | False | -| 取值范围 | * False:不开启 * True:开启 | -| 是否重启 OBServer 生效 | 是 | - - -**注意** - - - -ssl_client_authentication 配置后,仅在服务器重新启动所有 ca、cert、key 等文件后才生效。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/169.server_check_interval-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/169.server_check_interval-1.md deleted file mode 100644 index 550cf3001..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/169.server_check_interval-1.md +++ /dev/null @@ -1,15 +0,0 @@ -server_check_interval -========================================== - -server_check_interval 用于设置 Server 表一致性检查的时间间隔。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 时间类型 | -| 默认值 | 30s | -| 取值范围 | \[1s, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/17.backup_dest-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/17.backup_dest-1.md deleted file mode 100644 index 0e7963013..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/17.backup_dest-1.md +++ /dev/null @@ -1,19 +0,0 @@ -backup_dest -================================ - -backup_dest 用于设置基线备份和日志归档的路径。 - - -| **属性** | **描述** | -|------------------|--------| -| 参数类型 | 字符串 | -| 默认值 | 空值 | -| 取值范围 | NULL | -| 是否重启 OBServer 生效 | 否 | - - -**注意** - - - -备份进行过程中不可修改 backup_dest 配置项。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/170.server_data_copy_in_concurrency-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/170.server_data_copy_in_concurrency-1.md deleted file mode 100644 index 75c1eb948..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/170.server_data_copy_in_concurrency-1.md +++ /dev/null @@ -1,15 +0,0 @@ -server_data_copy_in_concurrency -==================================================== - -server_data_copy_in_concurrency 用于设置单个节点迁入数据的最大并发数。 - - -| **属性** | **描述** | -|------------------|-------------| -| 参数类型 | 整型 | -| 默认值 | 2 | -| 取值范围 | \[1, 1000\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/171.server_data_copy_out_concurrency-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/171.server_data_copy_out_concurrency-1.md deleted file mode 100644 index 5f7ada349..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/171.server_data_copy_out_concurrency-1.md +++ /dev/null @@ -1,15 +0,0 @@ -server_data_copy_out_concurrency -===================================================== - -server_data_copy_out_concurrency 用于设置单个节点迁出数据的最大并发数。 - - -| **属性** | **描述** | -|------------------|-------------| -| 参数类型 | 整型 | -| 默认值 | 2 | -| 取值范围 | \[1, 1000\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/172.server_permanent_offline_time-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/172.server_permanent_offline_time-1.md deleted file mode 100644 index 2fb33f5d9..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/172.server_permanent_offline_time-1.md +++ /dev/null @@ -1,38 +0,0 @@ -server_permanent_offline_time -================================================== - -server_permanent_offline_time 用于设置节点心跳中断的时间阈值,即节点心跳中断多久后认为其被永久下线,永久下线的节点上的数据副本需要被自动补足。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 时间类型 | -| 默认值 | 3600s | -| 取值范围 | \[20s, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - -通过设置该配置项,可以避免不必要的副本复制,仅当副本丢失超出该时长后系统才启动永久下线节点上数据副本的复制。 - -该配置项的适用场景及建议值如下: - -* OceanBase 数据库版本升级场景:建议将该配置项的值设置为 `72h` - - **说明** - - - - 在使用 OCP V2.3.5 及以上版本对 OceanBase 数据库 V2.1.2 及以上版本进行升级时,系统会自动将该配置项的值设置为 `72h`。 - - -* OBServer 硬件更换场景:建议将该配置项的值设置为 `4h` - - - -* OBServer 清空上线场景:建议将该配置项的值设置为 `10m`,使集群快速上线 - - - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/173.stack_size-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/173.stack_size-1.md deleted file mode 100644 index 72359f755..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/173.stack_size-1.md +++ /dev/null @@ -1,15 +0,0 @@ -stack_size -=============================== - -stack_size 用于设置程序函数调用栈的大小。 - - -| **属性** | **描述** | -|------------------|---------------| -| 参数类型 | 容量单位 | -| 默认值 | 1M | -| 取值范围 | \[512K, 20M\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/174.server_balance_critical_disk_waterlevel-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/174.server_balance_critical_disk_waterlevel-1.md deleted file mode 100644 index dec0aa5f8..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/174.server_balance_critical_disk_waterlevel-1.md +++ /dev/null @@ -1,15 +0,0 @@ -server_balance_critical_disk_waterlevel -============================================================ - -server_balance_critical_disk_waterlevel 用于设置磁盘空间的负载均衡功能的水位线。当磁盘水位线超过阈值时,负载均衡策略将倾向于优先考虑磁盘均衡。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 整型 | -| 默认值 | 80 | -| 取值范围 | \[0, 100\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/175.server_balance_disk_tolerance_percent-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/175.server_balance_disk_tolerance_percent-1.md deleted file mode 100644 index b98b3b1da..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/175.server_balance_disk_tolerance_percent-1.md +++ /dev/null @@ -1,15 +0,0 @@ -server_balance_disk_tolerance_percent -========================================================== - -server_balance_disk_tolerance_percent 用于设置节点间磁盘负载均衡策略中不均衡程度的容忍度。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 整型 | -| 默认值 | 1 | -| 取值范围 | \[1, 100\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/176.system_memory-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/176.system_memory-1.md deleted file mode 100644 index 9a3c1b170..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/176.system_memory-1.md +++ /dev/null @@ -1,19 +0,0 @@ -system_memory -================================== - -`system_memory` 用于设置系统预留的内存容量。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 容量单位 | -| 默认值 | 30G | -| 取值范围 | \[0M, +∞) | -| 是否重启 OBServer 生效 | 否 | - - -**注意** - - - -系统预留内存不能分配给普通租户使用。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/177.server_balance_cpu_mem_tolerance_percent-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/177.server_balance_cpu_mem_tolerance_percent-1.md deleted file mode 100644 index 8557a6efc..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/177.server_balance_cpu_mem_tolerance_percent-1.md +++ /dev/null @@ -1,15 +0,0 @@ -server_balance_cpu_mem_tolerance_percent -============================================================= - -server_balance_cpu_mem_tolerance_percent 在节点负载均衡策略中,用于设置 CPU 和内存资源不均衡的容忍度。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 整型 | -| 默认值 | 5 | -| 取值范围 | \[1, 100\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/178.server_cpu_quota_max-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/178.server_cpu_quota_max-1.md deleted file mode 100644 index 236faa2e8..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/178.server_cpu_quota_max-1.md +++ /dev/null @@ -1,14 +0,0 @@ -server_cpu_quota_max -========================================= - -server_cpu_quota_max 用于设置系统可以使用的最大 CPU 配额。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 双精度浮点数 | -| 默认值 | 5 | -| 取值范围 | \[0, 16\] | -| 是否重启 OBServer 生效 | 是 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/179.server_cpu_quota_min-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/179.server_cpu_quota_min-1.md deleted file mode 100644 index f6cf061dc..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/179.server_cpu_quota_min-1.md +++ /dev/null @@ -1,14 +0,0 @@ -server_cpu_quota_min -========================================= - -server_cpu_quota_min 用于设置系统可以使用的最小 CPU 配额,系统会自动预留。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 双精度浮点数 | -| 默认值 | 2.5 | -| 取值范围 | \[0, 16\] | -| 是否重启 OBServer 生效 | 是 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/18.backup_net_limit-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/18.backup_net_limit-1.md deleted file mode 100644 index 09d944a74..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/18.backup_net_limit-1.md +++ /dev/null @@ -1,15 +0,0 @@ -backup_net_limit -===================================== - -backup_net_limit 用于设置集群备份的总带宽。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 容量单位 | -| 默认值 | 0M | -| 取值范围 | \[0M, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/180.sql_audit_memory_limit-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/180.sql_audit_memory_limit-1.md deleted file mode 100644 index 829164d3c..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/180.sql_audit_memory_limit-1.md +++ /dev/null @@ -1,15 +0,0 @@ -sql_audit_memory_limit -=========================================== - -sql_audit_memory_limit 用于设置 SQL 审计数据可占用的最大内存。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 容量单位 | -| 默认值 | 3G | -| 取值范围 | \[64M, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/181.sys_bkgd_io_high_percentage-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/181.sys_bkgd_io_high_percentage-1.md deleted file mode 100644 index ccbca6e8e..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/181.sys_bkgd_io_high_percentage-1.md +++ /dev/null @@ -1,15 +0,0 @@ -sys_bkgd_io_high_percentage -================================================ - -sys_bkgd_io_high_percentage 用于设置系统后台 IO 最高占用百分比。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 整型 | -| 默认值 | 90 | -| 取值范围 | \[1, 100\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/182.sys_bkgd_io_low_percentage-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/182.sys_bkgd_io_low_percentage-1.md deleted file mode 100644 index 5e5fc01b7..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/182.sys_bkgd_io_low_percentage-1.md +++ /dev/null @@ -1,16 +0,0 @@ -sys_bkgd_io_low_percentage -=============================================== - -sys_bkgd_io_low_percentage 用于设置系统后台 IO 最少占用的百分比。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 整型 | -| 默认值 | 0 | -| 取值范围 | \[0, 100\] | -| 是否重启 OBServer 生效 | 否 | - - - -当 sys_bkgd_io_low_percentage 的值为 0 时,系统根据环境自动配置比例。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/183.sys_bkgd_io_timeout-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/183.sys_bkgd_io_timeout-1.md deleted file mode 100644 index efea2d4f2..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/183.sys_bkgd_io_timeout-1.md +++ /dev/null @@ -1,14 +0,0 @@ -sys_bkgd_io_timeout -======================================== - -sys_bkgd_io_timeout 系统后台 IO 请求超时时间。 - - -| **属性** | **描述** | -|------------------|--------------| -| 参数类型 | 时间类型 | -| 默认值 | 120s | -| 取值范围 | \[5s, 600s\] | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/184.sys_bkgd_net_percentage-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/184.sys_bkgd_net_percentage-1.md deleted file mode 100644 index 3b7894f6f..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/184.sys_bkgd_net_percentage-1.md +++ /dev/null @@ -1,15 +0,0 @@ -sys_bkgd_net_percentage -============================================ - -sys_bkgd_net_percentage 用于设置后台系统任务可占用网络带宽百分比。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 整型 | -| 默认值 | 60 | -| 取值范围 | \[0, 100\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/185.sys_bkgd_migration_change_member_list_timeout-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/185.sys_bkgd_migration_change_member_list_timeout-1.md deleted file mode 100644 index 9d396901a..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/185.sys_bkgd_migration_change_member_list_timeout-1.md +++ /dev/null @@ -1,15 +0,0 @@ -sys_bkgd_migration_change_member_list_timeout -================================================================== - -sys_bkgd_migration_change_member_list_timeout 用于设置副本迁移时变更 Paxos 成员组操作的超时时间。 - - -| **属性** | **描述** | -|------------------|--------------| -| 参数类型 | 时间类型 | -| 默认值 | 1h | -| 取值范围 | \[0s, 24 h\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/186.sys_bkgd_migration_retry_num-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/186.sys_bkgd_migration_retry_num-1.md deleted file mode 100644 index 388ee5f42..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/186.sys_bkgd_migration_retry_num-1.md +++ /dev/null @@ -1,15 +0,0 @@ -sys_bkgd_migration_retry_num -================================================= - -sys_bkgd_migration_retry_num 用于设置副本迁移失败时最多重试次数。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 整型 | -| 默认值 | 3 | -| 取值范围 | \[3, 100\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/187.syslog_level-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/187.syslog_level-1.md deleted file mode 100644 index 4e51eaa4b..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/187.syslog_level-1.md +++ /dev/null @@ -1,15 +0,0 @@ -syslog_level -================================= - -syslog_level 用于设置系统日志级别。 - - -| **属性** | **描述** | -|------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | 字符串 | -| 默认值 | INFO | -| 取值范围 | * DEBUG * TRACE * INFO * WARN * USER_ERR * ERROR\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/188.switchover_process_thread_count-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/188.switchover_process_thread_count-1.md deleted file mode 100644 index 0fb06b5f6..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/188.switchover_process_thread_count-1.md +++ /dev/null @@ -1,15 +0,0 @@ -switchover_process_thread_count -==================================================== - -switchover_process_thread_count 用于设置主备库切换相关线程池的大小。 - - -| **属性** | **描述** | -|------------------|-------------| -| 参数类型 | 整型 | -| 默认值 | 6 | -| 取值范围 | \[1, 1000\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/189.system_cpu_quota-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/189.system_cpu_quota-1.md deleted file mode 100644 index ad5c30f5d..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/189.system_cpu_quota-1.md +++ /dev/null @@ -1,15 +0,0 @@ -system_cpu_quota -===================================== - -system_cpu_quota 用于设置系统租户可使用的 CPU 配额。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 双精度浮点数 | -| 默认值 | 10 | -| 取值范围 | \[0, 16\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/19.backup_recovery_window-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/19.backup_recovery_window-1.md deleted file mode 100644 index 254a1bfcb..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/19.backup_recovery_window-1.md +++ /dev/null @@ -1,19 +0,0 @@ -backup_recovery_window -=========================================== - -backup_recovery_window 用于设置备份数据可以恢复的时间。 - - -| **属性** | **描述** | -|------------------|----------| -| 参数类型 | 整型 | -| 默认值 | 0 | -| 取值范围 | \[0, +∞) | -| 是否重启 OBServer 生效 | 否 | - - -**说明** - - - -备份数据恢复的时间单位为天,默认值为 0,表示不自动清理。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/190.sys_cpu_limit_trigger-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/190.sys_cpu_limit_trigger-1.md deleted file mode 100644 index 31a664b67..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/190.sys_cpu_limit_trigger-1.md +++ /dev/null @@ -1,15 +0,0 @@ -sys_cpu_limit_trigger -========================================== - -sys_cpu_limit_trigger 用于设置 CPU 利用率阈值,即当 CPU 利用率超过该阈值时,将暂停系统后台任务的执行。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 整型 | -| 默认值 | 80 | -| 取值范围 | \[50, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/191.syslog_io_bandwidth_limit-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/191.syslog_io_bandwidth_limit-1.md deleted file mode 100644 index 9c0823dd2..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/191.syslog_io_bandwidth_limit-1.md +++ /dev/null @@ -1,15 +0,0 @@ -syslog_io_bandwidth_limit -============================================== - -syslog_io_bandwidth_limit 用于设置系统日志所能占用的磁盘 IO 带宽上限,超过带宽上限容量的系统日志将被丢弃。 - - -| **属性** | **描述** | -|------------------|--------| -| 参数类型 | 容量单位 | -| 默认值 | 30MB | -| 取值范围 | NULL | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/192.tablet_size-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/192.tablet_size-1.md deleted file mode 100644 index ee18f238e..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/192.tablet_size-1.md +++ /dev/null @@ -1,16 +0,0 @@ -tablet_size -================================ - -tablet_size 用于设置分区内部并行处理(合并、查询等)时每个分片的大小。 - - -| **属性** | **描述** | -|------------------|----------| -| 参数类型 | 容量单位 | -| 默认值 | 128M | -| 取值范围 | \[0, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - -tablet_size 的默认取值必须为 2M 的倍数,数值为 0 时,表示不采用分区内并行处理。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/193.tableapi_transport_compress_func-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/193.tableapi_transport_compress_func-1.md deleted file mode 100644 index 886c6c568..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/193.tableapi_transport_compress_func-1.md +++ /dev/null @@ -1,15 +0,0 @@ -tableapi_transport_compress_func -===================================================== - -`tableapi_transport_compress_func` 用于设置 tableAPI 查询结果传输使用的压缩算法。 - - -| **属性** | **描述** | -|------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | 字符串类型 | -| 默认值 | none | -| 取值范围 | * none * lz4_1.0 * snappy_1.0 * zlib_1.0 * zstd_1.0 * zstd 1.3.8 | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/194.tenant_task_queue_size-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/194.tenant_task_queue_size-1.md deleted file mode 100644 index 2d011e30d..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/194.tenant_task_queue_size-1.md +++ /dev/null @@ -1,15 +0,0 @@ -tenant_task_queue_size -=========================================== - -tenant_task_queue_size 用于设置每个租户的请求队列大小。 - - -| **属性** | **描述** | -|------------------|-------------| -| 参数类型 | 整型 | -| 默认值 | 65536 | -| 取值范围 | \[1024, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/195.tenant_groups-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/195.tenant_groups-1.md deleted file mode 100644 index ac54b479d..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/195.tenant_groups-1.md +++ /dev/null @@ -1,15 +0,0 @@ -tenant_groups -================================== - -tenant_groups 用于设置负载均衡策略中使用的租户组。 - - -| **属性** | **描述** | -|------------------|--------| -| 参数类型 | 字符串类型 | -| 默认值 | 空值 | -| 取值范围 | NULL | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/196.trace_log_slow_query_watermark-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/196.trace_log_slow_query_watermark-1.md deleted file mode 100644 index 5b912d9da..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/196.trace_log_slow_query_watermark-1.md +++ /dev/null @@ -1,15 +0,0 @@ -trace_log_slow_query_watermark -=================================================== - -trace_log_slow_query_watermark 用于设置查询的执行时间阈值,如果查询的执行时间超过该阈值,则被认为是慢查询,慢查询的追踪日志会被打印到系统日志中。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 时间类型 | -| 默认值 | 100ms | -| 取值范围 | \[1ms, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/197.trace_log_sampling_interval-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/197.trace_log_sampling_interval-1.md deleted file mode 100644 index 7d81a3a2f..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/197.trace_log_sampling_interval-1.md +++ /dev/null @@ -1,16 +0,0 @@ -trace_log_sampling_interval -================================================ - -trace_log_sampling_interval 用于设置定期打印跟踪日志信息的时间。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 时间类型 | -| 默认值 | 10ms | -| 取值范围 | \[0ms, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - -当 enable_record_trace_log 设置为 false 时,由 trace_log_sampling_interval 决定打印慢查询和白名单信息的时间间隔。enable_record_trace_log 配置项相关信息请参见 [enable_record_trace_log](../../14.reference-guide-oracle-mode/3.system-configuration-items-1/66.enable_record_trace_log-1.md)。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/198.trx_2pc_retry_interval-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/198.trx_2pc_retry_interval-1.md deleted file mode 100644 index cb9f0a210..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/198.trx_2pc_retry_interval-1.md +++ /dev/null @@ -1,15 +0,0 @@ -trx_2pc_retry_interval -=========================================== - -trx_2pc_retry_interval 用于设置两阶段提交失败时候自动重试的时间间隔。 - - -| **属性** | **描述** | -|------------------|-----------------| -| 参数类型 | 时间类型 | -| 默认值 | 100ms | -| 取值范围 | \[1ms, 5000ms\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/199.trx_force_kill_threshold-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/199.trx_force_kill_threshold-1.md deleted file mode 100644 index c0a503951..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/199.trx_force_kill_threshold-1.md +++ /dev/null @@ -1,15 +0,0 @@ -trx_force_kill_threshold -============================================= - -trx_force_kill_threshold 用于设置因冻结或切主需要杀事务时的最长等待时间。 - - -| **属性** | **描述** | -|------------------|--------------| -| 参数类型 | 时间类型 | -| 默认值 | 100ms | -| 取值范围 | \[1ms, 10s\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/2.redundancy_level-not-available-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/2.redundancy_level-not-available-1.md deleted file mode 100644 index 9aa3514b6..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/2.redundancy_level-not-available-1.md +++ /dev/null @@ -1,33 +0,0 @@ -redundancy_level(暂勿使用) -=========================================== - - - -redundancy_level 用于设置 OceanBase 数据库内置本地磁盘 RAID 特性。 - - -| **属性** | **描述** | -|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | 字符串 | -| 默认值 | NORMAL | -| 取值范围 | * EXTERNAL * NORMAL * HIGH | -| 是否重启 OBServer 生效 | 否 | - - - -redundancy_level 配置参数取值含义如下: - -* EXTERNAL 表示使用外部冗余 - - - -* NORMAL 表示允许一个磁盘故障 - - - -* HIGH 表示如果磁盘数量足够,则允许两个磁盘故障 - - - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/20.backup_region-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/20.backup_region-1.md deleted file mode 100644 index 21b0303bc..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/20.backup_region-1.md +++ /dev/null @@ -1,15 +0,0 @@ -backup_region -================================== - -backup_region 用于设置用户建议执行备份的地域。 - - -| **属性** | **描述** | -|------------------|--------| -| 参数类型 | 字符串类型 | -| 默认值 | 空值 | -| 取值范围 | NULL | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/200.tde_method-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/200.tde_method-1.md deleted file mode 100644 index 3eea30a43..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/200.tde_method-1.md +++ /dev/null @@ -1,14 +0,0 @@ -tde_method -=============================== - -tde_method 用于设置透明表空间加密的方式。 - - -| **属性** | **描述** | -|------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | 字符串类型 | -| 默认值 | none | -| 取值范围 | * none:表示无法使用透明表空间加密 * internal:表示透明加密采用内部表的形式 * bkmi:表示透明加密采用外部 bkmi 的形式 | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/201.token_reserved_percentage-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/201.token_reserved_percentage-1.md deleted file mode 100644 index 2469985de..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/201.token_reserved_percentage-1.md +++ /dev/null @@ -1,14 +0,0 @@ -token_reserved_percentage -============================================== - -token_reserved_percentage 在控制租户 CPU 调度中,用于设置每次预留多少比例的空闲 token 数给租户。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 双精度浮点数 | -| 默认值 | 30 | -| 取值范围 | \[0, 100\] | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/202.unit_balance_resource_weight-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/202.unit_balance_resource_weight-1.md deleted file mode 100644 index b37aeb712..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/202.unit_balance_resource_weight-1.md +++ /dev/null @@ -1,28 +0,0 @@ -unit_balance_resource_weight -================================================= - -unit_balance_resource_weight 用于设置 UNIT 均衡策略中使用的资源权重,一般不需要手工配置。 - - -| **属性** | **描述** | -|------------------|--------| -| 参数类型 | 字符串类型 | -| 默认值 | 空值 | -| 取值范围 | NULL | -| 是否重启 OBServer 生效 | 否 | - - -**注意** - - - -* 默认值为空。 如果设置,所有权重的总和必须为100。 - - - -* 当打开 enable_unit_balance_resource_weight 时, unit_balance_resource_weight 配置才能生效。 - - - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/203.user_block_cache_priority-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/203.user_block_cache_priority-1.md deleted file mode 100644 index 87daded34..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/203.user_block_cache_priority-1.md +++ /dev/null @@ -1,15 +0,0 @@ -user_block_cache_priority -============================================== - -user_block_cache_priority 用于设置数据块缓存在缓存系统中的优先级。 - - -| **属性** | **描述** | -|------------------|----------| -| 参数类型 | 整型 | -| 默认值 | 1 | -| 取值范围 | \[1, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/204.user_row_cache_priority-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/204.user_row_cache_priority-1.md deleted file mode 100644 index 786cc953c..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/204.user_row_cache_priority-1.md +++ /dev/null @@ -1,14 +0,0 @@ -user_row_cache_priority -============================================ - -user_row_cache_priority 用于设置基线数据行缓存在缓存系统中的优先级。 - - -| **属性** | **描述** | -|------------------|----------| -| 参数类型 | 整型 | -| 默认值 | 1 | -| 取值范围 | \[1, +∞) | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/205.user_tab_col_stat_cache_priority-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/205.user_tab_col_stat_cache_priority-1.md deleted file mode 100644 index 70afeda3d..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/205.user_tab_col_stat_cache_priority-1.md +++ /dev/null @@ -1,15 +0,0 @@ -user_tab_col_stat_cache_priority -===================================================== - -user_tab_col_stat_cache_priority 用于设置统计数据缓存在缓存系统中的优先级。 - - -| **属性** | **描述** | -|------------------|----------| -| 参数类型 | 整型 | -| 默认值 | 1 | -| 取值范围 | \[1, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/206.user_iort_up_percentage-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/206.user_iort_up_percentage-1.md deleted file mode 100644 index 77e76835c..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/206.user_iort_up_percentage-1.md +++ /dev/null @@ -1,14 +0,0 @@ -user_iort_up_percentage -============================================ - -user_iort_up_percentage 用于设置用户磁盘 IO 时延阈值,即用户磁盘 IO 时延超过该阈值后,系统后台 IO 任务将被限流。 - - -| **属性** | **描述** | -|------------------|----------| -| 参数类型 | 整型 | -| 默认值 | 100 | -| 取值范围 | \[0, +∞) | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/207.use_large_pages-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/207.use_large_pages-1.md deleted file mode 100644 index fc786f4a0..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/207.use_large_pages-1.md +++ /dev/null @@ -1,14 +0,0 @@ -use_large_pages -==================================== - -use_large_pages 用于管理数据库使用的内存大页。 - - -| **属性** | **描述** | -|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | 字符串 | -| 默认值 | false | -| 取值范围 | * false * true * only | -| 是否重启 OBServer 生效 | 是 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/208.virtual_table_location_cache_expire_time-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/208.virtual_table_location_cache_expire_time-1.md deleted file mode 100644 index 81bd81276..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/208.virtual_table_location_cache_expire_time-1.md +++ /dev/null @@ -1,15 +0,0 @@ -virtual_table_location_cache_expire_time -============================================================= - -virtual_table_location_cache_expire_time 用于设置虚拟表的位置信息缓存过期时间。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 时间类型 | -| 默认值 | 8s | -| 取值范围 | \[1s, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/209.workers_per_cpu_quota-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/209.workers_per_cpu_quota-1.md deleted file mode 100644 index 1abc1b532..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/209.workers_per_cpu_quota-1.md +++ /dev/null @@ -1,29 +0,0 @@ -workers_per_cpu_quota -========================================== - -`workers_per_cpu_quota` 用于设置分配给每个 CPU 配额的工作线程数量。 - - -| **属性** | **描述** | -|-------------------------|-----------| -| 参数类型 | 整型 | -| 默认值 | 10 | -| 取值范围 | \[2, 20\] | -| 是否重启 OBServer 生效 | 否 | - - - -租户中可同时处理的线程数由 `cpu_quota_concurrency` 与 `workers_per_cpu_quota` 2 个配置项控制,且设置时需要满足 `workers_per_cpu_quota > cpu_quota_concurrency`。 - -其中: - -* `workers_per_cpu_quota` 表示租户在每个 CPU 上能分配的最大工作线程数。 - - - -* `cpu_quota_concurrency` 表示租户在每个 CPU 上活跃的工作线程数,也即并发数。`cpu_quota_concurrency` 配置项的详细信息,请参见 [cpu_quota_concurrency](../../14.reference-guide-oracle-mode/3.system-configuration-items-1/35.cpu_quota_concurrency-1.md)。 - - - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/21.builtin_db_data_verify_cycle-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/21.builtin_db_data_verify_cycle-1.md deleted file mode 100644 index d37712a1b..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/21.builtin_db_data_verify_cycle-1.md +++ /dev/null @@ -1,15 +0,0 @@ -builtin_db_data_verify_cycle -================================================= - -builtin_db_data_verify_cycle 用于设置数据坏块自检周期,单位为天。当值为 0 时表示不检查。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 整型 | -| 默认值 | 20 | -| 取值范围 | \[0, 360\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/210.wait_leader_batch_count-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/210.wait_leader_batch_count-1.md deleted file mode 100644 index ee0e09623..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/210.wait_leader_batch_count-1.md +++ /dev/null @@ -1,15 +0,0 @@ -wait_leader_batch_count -============================================ - -wait_leader_batch_count 用于设置 RootService 每次发送切主命令的最大分区个数。 - - -| **属性** | **描述** | -|------------------|---------------| -| 参数类型 | 整型 | -| 默认值 | 1024 | -| 取值范围 | \[128, 5000\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/211.writing_throttling_maximum_duration-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/211.writing_throttling_maximum_duration-1.md deleted file mode 100644 index 25261e9f5..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/211.writing_throttling_maximum_duration-1.md +++ /dev/null @@ -1,15 +0,0 @@ -writing_throttling_maximum_duration -======================================================== - -write_throttling_maximum_duration 通过控制内存分配进度,控制写入速度。即指定在触发写入限速后,剩余 memstore 内存分配完所需的时间。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 时间类型 | -| 默认值 | 1h | -| 取值范围 | \[1s, 3d\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/212.writing_throttling_trigger_percentage-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/212.writing_throttling_trigger_percentage-1.md deleted file mode 100644 index d1d2bf80c..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/212.writing_throttling_trigger_percentage-1.md +++ /dev/null @@ -1,16 +0,0 @@ -writing_throttling_trigger_percentage -========================================================== - -write_throttling_trigger_percentage 用于设置写入速度的阈值。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 整型 | -| 默认值 | 100 | -| 取值范围 | \[0, 100\] | -| 是否重启 OBServer 生效 | 否 | - - - -当 memstore 已使用的内存达到该阈值时,触发写入限速。当该配置项的值为 100 时,表示关闭写入限速机制。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/213.weak_read_version_refresh_interval-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/213.weak_read_version_refresh_interval-1.md deleted file mode 100644 index 76a10556b..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/213.weak_read_version_refresh_interval-1.md +++ /dev/null @@ -1,20 +0,0 @@ -weak_read_version_refresh_interval -======================================================= - -weak_read_version_refresh_interval 用于设置弱一致性读版本号的刷新周期,影响弱一致性读数据的延时。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 时间类型 | -| 默认值 | 50ms | -| 取值范围 | \[0ms, +∞) | -| 是否重启 OBServer 生效 | 否 | - - -**说明** - - - -weak_read_version_refresh_interval 值为 0 时,表示不再刷新弱一致性读版本号,不提供单调读功能。 - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/214.workarea_size_policy-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/214.workarea_size_policy-1.md deleted file mode 100644 index 38cc4fa97..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/214.workarea_size_policy-1.md +++ /dev/null @@ -1,14 +0,0 @@ -workarea_size_policy -========================================= - -`workarea_size_policy` 用于设置手动或者自动调整 SQL 工作区大小的策略。 - - -| **属性** | **描述** | -|------------------|-----------------------------------------------------------------------------------------------------------------------| -| 参数类型 | 字符串类型 | -| 默认值 | AUTO | -| 取值范围 | * MANUAL:表示手动调整 * AUTO:表示自动调整 | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/215.zone-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/215.zone-1.md deleted file mode 100644 index b7b7023c2..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/215.zone-1.md +++ /dev/null @@ -1,15 +0,0 @@ -zone -========================= - -zone 用于设置节点所在的 Zone 的名字。该配置项一般不需要配置。 - - -| **属性** | **描述** | -|------------------|--------| -| 参数类型 | 字符串类型 | -| 默认值 | 空值 | -| 取值范围 | NULL | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/216.zone_merge_concurrency-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/216.zone_merge_concurrency-1.md deleted file mode 100644 index 78ca4a0bf..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/216.zone_merge_concurrency-1.md +++ /dev/null @@ -1,15 +0,0 @@ -zone_merge_concurrency -=========================================== - -zone_merge_concurrency 用于设置在合并时,支持多少个 Zone 并发。当值为 0 时,由系统根据部署情况自动选择最佳并发度。 - - -| **属性** | **描述** | -|------------------|----------| -| 参数类型 | 整型 | -| 默认值 | 1 | -| 取值范围 | \[0, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/217.zone_merge_order-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/217.zone_merge_order-1.md deleted file mode 100644 index 30b44c83f..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/217.zone_merge_order-1.md +++ /dev/null @@ -1,14 +0,0 @@ -zone_merge_order -===================================== - -zone_merge_order 用于设置 Zone 的轮转合并顺序。不指定时,由系统自动决定。 - - -| **属性** | **描述** | -|------------------|--------| -| 参数类型 | 字符串类型 | -| 默认值 | 空值 | -| 取值范围 | NULL | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/218.zone_merge_timeout-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/218.zone_merge_timeout-1.md deleted file mode 100644 index 63606d178..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/218.zone_merge_timeout-1.md +++ /dev/null @@ -1,15 +0,0 @@ -zone_merge_timeout -======================================= - -zone_merge_timeout 用于设置单个 zone 的合并超时时间。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 时间类型 | -| 默认值 | 3h | -| 取值范围 | \[1s, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/219.ob_ssl_invited_common_names-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/219.ob_ssl_invited_common_names-1.md deleted file mode 100644 index 539a3dd67..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/219.ob_ssl_invited_common_names-1.md +++ /dev/null @@ -1,41 +0,0 @@ -ob_ssl_invited_common_names -================================================ - -ob_ssl_invited_common_names 用于记录当前租户运行的应用身份列表,该身份来自 SSL 双向认证中 Client 端证书 subject 中的 `cn` 字段(common name)。 - - -| 属性 | 描述 | -|------------------|------| -| 参数类型 | 字符串 | -| 默认值 | NONE | -| 取值范围 | 无 | -| 是否重启 OBServer 生效 | 否 | - - - -在用户登录 Server 的密码校验完成后,检查如果同时满足以下三个条件,则限制登录: - -* Client 开启了 SSL,并且 Client 端的 CA、证书或私钥使用的是双向认证。 - - - -* Server 端配置了应用白名单,即白名单不为空。 - - - -* Client 证书 subject 的 `cn` 字段不在白名单内。 - - - - - - -若以上三个条件任何一个都不满足,则白名单检查失效,忽略检查。 - -使用示例如下: - -```sql -obclient> ALTER SYSTEM SET ob_ssl_invited_common_names = 'ALIPAY'; -``` - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/22.bf_cache_miss_count_threshold-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/22.bf_cache_miss_count_threshold-1.md deleted file mode 100644 index 676a1d3c3..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/22.bf_cache_miss_count_threshold-1.md +++ /dev/null @@ -1,15 +0,0 @@ -bf_cache_miss_count_threshold -================================================== - -bf_cache_miss_count_threshold 用于控制 bloomfilter cache 的触发次数,当宏块未命中次数达到该值时,创建 bloomfilter 缓存。值为 0 时表示关闭。 - - -| **属性** | **描述** | -|------------------|----------| -| 参数类型 | 整型 | -| 默认值 | 100 | -| 取值范围 | \[0, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/220.ssl_external_kms_info-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/220.ssl_external_kms_info-1.md deleted file mode 100644 index 37fbb07ea..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/220.ssl_external_kms_info-1.md +++ /dev/null @@ -1,119 +0,0 @@ -ssl_external_kms_info -========================================== - -ssl_external_kms_info 配置项用于记录 OceanBase 数据库 SSL 功能运行依赖的一些信息,通过 json 字符串方式记录不同 SSL 使用方式下依赖的相关配置,json 中至少包含类型 ssl_mode 字段。 - - -| 属性 | 描述 | -|------------------|------| -| 参数类型 | 字符串 | -| 默认值 | 空字符串 | -| 取值范围 | 无 | -| 是否重启 OBServer 生效 | 否 | - - - -使用说明: - -* 该配置项的默认值为空字符串。当 SSL 开关打开后,SSL 使用密钥将取值默认路径下的默认文件。 - - - -* 该配置项取值必须为有效 json,否则配置项设置会检查失败。 - - - -* 该配置项当前仅 ssl_mode 的取值有两种:file 和 bkmi。 - - * 指定为 file 时, json 字符串中不需要其他内容。 - - - - * 指定为 bkmi 时,运行时向 bkmi 获取 SSL 文件,本地不持久化存储。同时,json 字符串还需要提供完整的应用名、bkmi url、bkmi 根证书、身份秘钥、身份秘钥口令、SSL 私钥名称、SSL 私钥版本号、SSL 证书名称等。并且这些信息确实有效可用,即能通过这些从 bkmi 中获取私钥和证书,否则会报响应错误码。 - - - - - - - - - -为了支持外部其他各自的证书颁发体系,ssl_external_kms_info 还可以定制扩展为其他内容 json 串。 - -示例如下: - -```sql -obclient> ALTER SYSTEM SET external_ssl_info = ' -{ -"ssl_mode":"file" -}'; - -obclient> ALTER SYSTEM SET external_ssl_info = ' -{ -"ssl_mode":"bkmi", -"kms_host":"http://bkmi.test.alipay.net/bkmi/api", -"root_cert": -"-----BEGIN CERTIFICATE----- -MIIDqTCCApGgAwIBAgIHBXbH+VUEQTANBgkqhkiG9w0BAQsFADBaMSwwKgYDVQQD -DCNBbnQgRmluYW5hY2lhbCBJbnRyYW5ldCBDQSBSb290IFJTQTEXMBUGA1UECgwO -QW50IEZpbmFuYWNpYWwxETAPBgNVBAsMCEludHJhbmV0MB4XDTE4MDkyNjE1MzUz -N1oXDTQ4MDkyNjE1MzUzN1owWjEsMCoGA1UEAwwjQW50IEZpbmFuYWNpYWwgSW50 -cmFuZXQgQ0EgUm9vdCBSU0ExFzAVBgNVBAoMDkFudCBGaW5hbmFjaWFsMREwDwYD -VQQLDAhJbnRyYW5ldDCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAJlz -hgCvUVB7wE4/V4Oj9Gq0Qji5dlIF2AyQ/L6xG/aM2cXmhxm7hhschhb6ERgf5z70 -lX5G22XLkH97mkZbX19aCH6xMmvVUaWpKpC1vrW+ZL8nLzWl8UXVONgqa1NvkIz2 -qUJNdGVgFXaSlH4EaK9FzklpHj1uo8KJdC6m33z8eoFpLREycbSkxISATseQF1y0 -WhpvZ0qB6aRft7OM4B1G0tu1+dlZ3Sh6rrCwR+yCw8vfYR4cUA9e8WFU7YciuTXK -l/1q3LfzU8LCe0Gtv29Ahk8Zb6lG7/XHwHG8diuKvyq4qlTNp/SjCJbuUx6RSBjD -zP1nRacRuKrxI9ybZ8MCAwEAAaN0MHIwHwYDVR0jBBgwFoAUmtzqDGWl1NWKvUAi -yR877VbODwAwHQYDVR0OBBYEFJrc6gxlpdTVir1AIskfO+1Wzg8AMA8GA1UdEwEB -/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMA8GA1UdJQQIMAYGBFUdJQAwDQYJKoZI -hvcNAQELBQADggEBAEa4NJ8y4OJLpbCC7SCGrGGTJ+ssbVIJdji21F3dn5yIPQfd -M/PM84y2cy6Tp9cvaDjOtagZ2e1Et5TeGZHiUeqlAjWDtY5lgGvJ80VwpxAUDhKn -LGfSMZo1v1gKKVxgh+iaof2L1UCtep5ETsYKeXLkgWsHYBFzqBlhiAZGuQVzaH7T -I66rtw6gOAmJuWoJlJyhVxg0vCgcl0ExaK3LRhkodzGHIonyaEtRCynpgJ4DmIjH -1I7OVqjdHhdt98U2A8oZVNcuwHLkfyXIC6Iu3GVs5IsQudiQwTW/kIOR+Chvu/lC -b/VmGj0MhvmYYc494vWdcNcfED/HPNshio66aiU= ------END CERTIFICATE----- -", -"private_key": -"-----BEGIN RSA PRIVATE KEY----- -Proc-Type: 4,ENCRYPTED -DEK-Info: AES-128-CBC,D1CE2F7C3BD77CB130E563CDECB4AB5E -NyTth6D4/xeeQ59tn7pGDBhxbGaAsQpTowATdRRnK3Xn4M7lFo1khTUgfKL+eKPz -5RRf85LfIl4P8/VCgpEsExnaIR/M5FoP3vYIMy3u9cyowG3ioMaQ1ZA/zFdq8jWb -4H5/GL8Zi7B/nj8dCy7L1gLC5KOpGZLq3wvyxHMl5+X5fbHvb9KJjsW2eFPL9KEI -yKMRpXET7F0JIBNVHKMX+cUvzXLxH1klHRYSzAWfvoW+wXweKveSvn7wFAxoBjsk -UtnQ/tZvdfqOYMyfwfb4yNGaQjvN0pfYKWvGu1mqajpPNVJ96n9onArV40I7/Q2D -51eDFQ8op/0sygZiU1rurTQnvrvZnvgASrqIDdUQBPJaYLQmDIxc7Wo1Qr6cFKMv -kLNCihBNMar5+LsigyTdb+0VlwgcYtVMUlh8O282LqC11NkVJfAAvDYxZq+SFF1a -hm7D0n9DFT4A2eeXerwNXyk2fAaw8KX12TpXWanRaB1NW2cX9XmzjMQuk04xNLVK -DDMHKUDctBBvYHaBAjkUQT2smRH4ETosiQHcI91iuj2DZ6u/T0uUG3N7gHV3KSOX -DWUBtr/Xok9YuBICJ4gE/tIvH4gaqAqSEWb9TeeSCrX5VdQw03tPWUYKcr9M08Zj -LOMFdlmMOhRbmsglZy9/D+HVShp343DoZqKIO1A1aGYrzDV6izwI1K1an1ugOF3X -2czjyeuMtcz2ZFEhuGYekRiTx+ifu2scRnx2vndi9+RESUhh37BeseQgsENIsaw+ -5SVJlRgxk8N2hSiA8AWAJ/xpgyhYNL3KjAfh2tfH+jUtrN48kaa4JPeYykpk2kDi -OwQD0VhxjAT0ggyeBDbVNat+0w42i9oxpafBx2pCAbnK+WDnnLbUzgobz296fkO1 -H0UUqKBmi28Jntq3ubbg989LRH3VdvOXFvvgI3k2nqKLjzSCZt4MkAH+fo6cFtTf -q2S+geomeYBCGCSF/bgmk1Q/o9e2qPU4XuYcbM0T2ALwW4vYqv9DmORAfXZV/pg4 -myt1tgsnsUig5UMNIW/g7Q9hnVFzUjOKRwLff+sGKhXwmNHKpJVGaWNaESJ0YAAe -ESMMOrEW5kiqRqIbZx52NVwb85rb6ozkm8vR4ApLNNqQ/ylAd4H3zA3bByXn3uTx -7tfksErzsD8seL3yvQV5hkbB8PkQIXCTyL+zbp4+bNk8v3zj9/7BRqpQl0eMJ4oS -0vjkYgzkhBsQY3tvRH3PkodUy1yhc+1ZOjOcmX4lAMW1+vP5XsESM+GESDp3Czp6 -DlfiHbAlGBouWisY63hQtxVQtOboLzWmXwBGv2ENCf5NdW8tT2rWdxVcWOCW/1YE -dZ3/Q43GK0rqQw/j6MN4xOY7JuiBftZiBkLv57UIxUH1owIMR501QLnhq7Olgz+V -Edli5gWpO6OFNGYFhHc8B4FmTq+UUX4bdya/ajbVL/JWH6fjBJsvculQaJGV+Po6 -0Ythfdurd/V0H/s9IkA3XGGckN+XacKpsgr+25kAG5SrdnnZkTVeg1+O/VHiupQw -OkKlD717/MrLYCZvy2D30oCTDF33VUOxSusc9zeJP29ye+WuNG3gX9CVaYbx1I2d ------END RSA PRIVATE KEY-----", -"PRIVATE_KEY_PHRASE":"123456", -"SCENE":"ANT", -"CALLER":"ob_ssl_crypt", -"CERT_NAME":"ob_yanhua_test", -"PRIVATE_KEY_NAME":"ob_yanhua_test-app-id-authn-RSA-2048-private", -"KEY_VERSION":"1" -}'; -``` - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/221.ob_event_history_recycle_interval-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/221.ob_event_history_recycle_interval-1.md deleted file mode 100644 index 96e7b0610..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/221.ob_event_history_recycle_interval-1.md +++ /dev/null @@ -1,15 +0,0 @@ -ob_event_history_recycle_interval -====================================================== - -ob_event_history_recycle_interval 用于控制历史事件的回收间隔。 - - -| 属性 | 描述 | -|------------------|--------------| -| 参数类型 | 时间类型 | -| 默认值 | 7d,表示 7 天 | -| 取值范围 | \[1d, 180d\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/222.backup_backup_dest-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/222.backup_backup_dest-1.md deleted file mode 100644 index 317632cb4..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/222.backup_backup_dest-1.md +++ /dev/null @@ -1,14 +0,0 @@ -backup_backup_dest -======================================= - -backup_backup_dest 用于设置备份数据备份的目的端。 - - -| 属性 | 描述 | -|------------------|-------| -| 参数类型 | 字符串类型 | -| 默认值 | 空字符串 | -| 取值范围 | 无 | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/223.backup_log_archive_checkpoint_interval-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/223.backup_log_archive_checkpoint_interval-1.md deleted file mode 100644 index dd4cb2efa..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/223.backup_log_archive_checkpoint_interval-1.md +++ /dev/null @@ -1,14 +0,0 @@ -backup_log_archive_checkpoint_interval -=========================================================== - -backup_log_archive_checkpoint_interval 用于设置备份数据备份 archivelog 的时间间隔。 - - -| 属性 | 描述 | -|------------------|-------------| -| 参数类型 | 时间类型 | -| 默认值 | 0 | -| 取值范围 | \[0s, 24h\] | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/224.plsql_ccflags-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/224.plsql_ccflags-1.md deleted file mode 100644 index 6d74b487c..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/224.plsql_ccflags-1.md +++ /dev/null @@ -1,29 +0,0 @@ -plsql_ccflags -================================== - -plsql_ccflags 用于定义 PL 编译器的编译常量。 - - -| 属性 | 描述 | -|------------------|-----------------| -| 参数类型 | 字符串类型 | -| 默认值 | 空字符串 | -| 取值范围 | 符合 PL 编译器规范的字符串 | -| 是否重启 OBServer 生效 | 否 | - - -**说明** - - - -该配置项可以任意定义变量,建议用于控制条件编译。 - -使用示例如下: - -```sql -obclient> ALTER SESSION SET PLSQL_CCFLAGS = 'DeBug:TRUE'; - -obclient> ALTER SYSTEM SET PLSQL_CCFLAGS = 'DeBug:TRUE'; -``` - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/225.plsql_code_type-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/225.plsql_code_type-1.md deleted file mode 100644 index 6eaab2f8a..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/225.plsql_code_type-1.md +++ /dev/null @@ -1,22 +0,0 @@ -plsql_code_type -==================================== - -plsql_code_type 用于指定 PL/SQL 代码的编译类型。 - - -| 属性 | 描述 | -|------------------|--------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | 字符串类型 | -| 默认值 | NATIVE | -| 取值范围 | * INTERPETED:解析型 * NATIVE:二进制可执行 | -| 是否重启 OBServer 生效 | 否 | - - - -使用示例如下: - -```sql -obclient> ALTER SESSION SET plsql_code_type='INTERPRETED'; -``` - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/226.plsql_debug-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/226.plsql_debug-1.md deleted file mode 100644 index 2e296d95c..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/226.plsql_debug-1.md +++ /dev/null @@ -1,22 +0,0 @@ -plsql_debug -================================ - -plsql_debug 用于指定是否编译成 debug 版本。 - - -| 属性 | 描述 | -|------------------|------------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | False | -| 取值范围 | * True:是 * False:否 | -| 是否重启 OBServer 生效 | 否 | - - - -使用示例如下: - -```sql -obclient> ALTER SESSION SET plsql_debug=false; -``` - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/227.plsql_optimize_level-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/227.plsql_optimize_level-1.md deleted file mode 100644 index ed53e85dc..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/227.plsql_optimize_level-1.md +++ /dev/null @@ -1,22 +0,0 @@ -plsql_optimize_level -========================================= - -plsql_optimize_level 用于指定编译优化级别。 - - -| 属性 | 描述 | -|------------------|------------------------------------| -| 参数类型 | 整数类型 | -| 默认值 | 1 | -| 取值范围 | 0:表示不开启优化 1:表示开启优化 | -| 是否重启 OBServer 生效 | 否 | - - - -使用示例如下: - -```sql -obclient> ALTER SESSION SET plsql_optimize_level=1; -``` - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/228.plsql_v2_compatibility-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/228.plsql_v2_compatibility-1.md deleted file mode 100644 index c9d2a8c4a..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/228.plsql_v2_compatibility-1.md +++ /dev/null @@ -1,22 +0,0 @@ -plsql_v2_compatibility -=========================================== - -plsql_v2_compatibility 用于指定 Oracle 8 的兼容功能。 - - -| 属性 | 描述 | -|------------------|---------------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | False | -| 取值范围 | * True:兼容 * False:不兼容 | -| 是否重启 OBServer 生效 | 否 | - - - -使用示例如下: - -```sql -obclient> ALTER SESSION SET plsql_v2_compatibility=false; -``` - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/229.plsql_warnings-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/229.plsql_warnings-1.md deleted file mode 100644 index 35ed11853..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/229.plsql_warnings-1.md +++ /dev/null @@ -1,74 +0,0 @@ -plsql_warnings -=================================== - -`plsql_warnings` 用于控制 PL/SQL 编译器的报错行为,可以指定某类型或某个 `warning` 码的状态为` enable`、`disable` 或 `error`。 - - -| 属性 | 描述 | -|------------------|------------| -| 参数类型 | varchar | -| 默认值 | ENABLE:ALL | -| 取值范围 | 符合规范的字符串 | -| 是否重启 OBServer 生效 | 否 | - - - -使用语法如下: - -```sql -PLSQL_WARNINGS = 'value_clause' [, 'value_clause' ] -value_clause::= -{ ENABLE | DISABLE | ERROR }: -{ ALL -| WARN -| DEBUG -| { integer -| (integer [, integer ] ...) -} -} -``` - - - -其中: - -* `ENABLE`:表示打开指定的 Warnings。 - - - -* `DISABLE`:表示关闭指定的 Warnings。 - - - -* `ERROR`:表示将指定的 Warning 作为 Errors。 - - - -* `ALL`:表示应用到所有的 Warning Messages。 - - - -* `DEBUG`:表示应用到 Debug。 - - - -* `WARN`:表示应用到 Warning。 - - - - - - -使用示例如下: - -```sql -PLSQL_WARNINGS = 'ENABLE:DEBUG', 'DISABLE:WARN'; - -PLSQL_WARNINGS = 'DISABLE:ALL'; - -PLSQL_WARNINGS = 'DISABLE:5000', 'ENABLE:5001','ERROR:5002'; - -PLSQL_WARNINGS = 'ENABLE:(5000,5001,5002)','DISABLE:(6000,6001)'; -``` - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/23.bf_cache_priority-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/23.bf_cache_priority-1.md deleted file mode 100644 index 2bbefc20a..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/23.bf_cache_priority-1.md +++ /dev/null @@ -1,15 +0,0 @@ -bf_cache_priority -====================================== - -bf_cache_priority 用于设置 Bloom Filter 缓存优先级。 - - -| **属性** | **描述** | -|------------------|----------| -| 参数类型 | 整型 | -| 默认值 | 1 | -| 取值范围 | \[1, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/230.recyclebin_object_expire_time-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/230.recyclebin_object_expire_time-1.md deleted file mode 100644 index 6568294e0..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/230.recyclebin_object_expire_time-1.md +++ /dev/null @@ -1,59 +0,0 @@ -recyclebin_object_expire_time -================================================== - -recyclebin_object_expire_time 用于自动 Purge 回收站中过期的 Schema对象。 - -描述 ------------------------ - - - -| 属性 | 描述 | -|------------------|-----------| -| 参数类型 | 时间类型 | -| 默认值 | 0s | -| 取值范围 | \[0s, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - -recyclebin_object_expire_time 配置项的取值说明如下: - -* 当其值为 0s 时,表示关闭自动 Purge 回收站功能。 - - - -* 当其值为非 0s 时,表示回收一段时间前进入回收站的 Schema 对象。 - - - - - - -示例 ------------------------ - -* 关闭自动 Purge 回收站功能 - - ```sql - obclient> ALTER SYSTEM SET recyclebin_object_expire_time = "0s"; - ``` - - - - - - - - -* 打开自动 Purge 回收站功能,并回收 7 天前进入回收站的 Schema 对象 - - ```sql - obclient> ALTER SYSTEM SET recyclebin_object_expire_time = "7d"; - ``` - - - - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/231.log_archive_batch_buffer_limit-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/231.log_archive_batch_buffer_limit-1.md deleted file mode 100644 index d4d468758..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/231.log_archive_batch_buffer_limit-1.md +++ /dev/null @@ -1,27 +0,0 @@ -log_archive_batch_buffer_limit -=================================================== - -当物理备份开启时,log_archive_batch_buffer_limit 用于控制日志归档单机的最大内存使用量。 - -描述 ------------------------ - - - -| 属性 | 描述 | -|------------------|-----------| -| 参数类型 | 容量类型 | -| 默认值 | 1G | -| 取值范围 | \[2M, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - -示例 ------------------------ - -```sql -obclient> ALTER SYSTEM SET log_archive_batch_buffer_limit = 1GB; -``` - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/232.clog_disk_utilization_threshold-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/232.clog_disk_utilization_threshold-1.md deleted file mode 100644 index 21e0ceedd..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/232.clog_disk_utilization_threshold-1.md +++ /dev/null @@ -1,27 +0,0 @@ -clog_disk_utilization_threshold -==================================================== - -clog_disk_utilization_threshold 配置项用于控制 clog 或 ilog 磁盘空间复用的水位值。 - -描述 ------------------------ - - - -| 属性 | 描述 | -|------------------|------------| -| 参数类型 | 整型 | -| 默认值 | 80 | -| 取值范围 | \[10, 100) | -| 是否重启 OBServer 生效 | 否 | - - - -示例 ------------------------ - -```sql -obclient> ALTER SYSTEM SET clog_disk_utilization_threshold=80; -``` - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/233.backup_backup_archive_log_batch_count-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/233.backup_backup_archive_log_batch_count-1.md deleted file mode 100644 index 5c79f1dc8..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/233.backup_backup_archive_log_batch_count-1.md +++ /dev/null @@ -1,14 +0,0 @@ -backup_backup_archive_log_batch_count -========================================================== - -backup_backup_archive_log_batch_count 用于设置备份备份日志的任务的批次数量。 - - -| 属性 | 描述 | -|------------------|------------| -| 参数类型 | 整型 | -| 默认值 | 0 | -| 取值范围 | \[0,1024\] | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/234.backup_backup_archivelog_retry_interval-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/234.backup_backup_archivelog_retry_interval-1.md deleted file mode 100644 index 7adca5fe0..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/234.backup_backup_archivelog_retry_interval-1.md +++ /dev/null @@ -1,14 +0,0 @@ -backup_backup_archivelog_retry_interval -============================================================ - -backup_backup_archivelog_retry_interval 用于设置备份备份日志的任务的重试间隔。 - - -| 属性 | 描述 | -|------------------|-----------| -| 参数类型 | 时间类型 | -| 默认值 | 0s | -| 取值范围 | \[0s,1h\] | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/235.backup_backupset_batch_count-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/235.backup_backupset_batch_count-1.md deleted file mode 100644 index 20f5df2de..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/235.backup_backupset_batch_count-1.md +++ /dev/null @@ -1,14 +0,0 @@ -backup_backupset_batch_count -================================================= - -backup_backupset_batch_count 用于设置备份备份基线的任务的批次数量。 - - -| 属性 | 描述 | -|------------------|------------| -| 参数类型 | 整型 | -| 默认值 | 0 | -| 取值范围 | \[0,1024\] | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/236.backup_backupset_retry_interval-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/236.backup_backupset_retry_interval-1.md deleted file mode 100644 index 0c1ff8169..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/236.backup_backupset_retry_interval-1.md +++ /dev/null @@ -1,14 +0,0 @@ -backup_backupset_retry_interval -==================================================== - -backup_backupset_retry_interval 用于设置备份备份基线的任务的重试间隔。 - - -| 属性 | 描述 | -|------------------|-----------| -| 参数类型 | 时间类型 | -| 默认值 | 0s | -| 取值范围 | \[0s,1h\] | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/237.open_cursors-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/237.open_cursors-1.md deleted file mode 100644 index 2d8500e3d..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/237.open_cursors-1.md +++ /dev/null @@ -1,14 +0,0 @@ -open_cursors -================================= - -open_cursors 用于限制单个 Session 可以同时打开的游标数量。 - - -| 属性 | 描述 | -|------------------|-------------| -| 参数类型 | 整型 | -| 默认值 | 50 | -| 取值范围 | \[0,65535\] | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/238.fast_recovery_concurrency-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/238.fast_recovery_concurrency-1.md deleted file mode 100644 index 0d4913a2d..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/238.fast_recovery_concurrency-1.md +++ /dev/null @@ -1,14 +0,0 @@ -fast_recovery_concurrency -============================================== - -`fast_recovery_concurrency` 用于控制 RootService 调度的快速恢复任务在 OBServer 上执行的并发数。 - - -| 属性 | 描述 | -|------------------|------------| -| 参数类型 | 整型 | -| 默认值 | 10 | -| 取值范围 | \[1,1000\] | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/239.clog_ofs_usage_limit_size-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/239.clog_ofs_usage_limit_size-1.md deleted file mode 100644 index 352992daa..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/239.clog_ofs_usage_limit_size-1.md +++ /dev/null @@ -1,25 +0,0 @@ -clog_ofs_usage_limit_size -============================================== - -`clog_ofs_usage_limit_size` 用于控制单台 OBServer 存储 Clog 日志文件的最大空间使用量。 - - -| 属性 | 描述 | -|------------------|---------| -| 参数类型 | 容量类型 | -| 默认值 | 2TB | -| 取值范围 | \[0,+∞) | -| 是否重启 OBServer 生效 | 否 | - - - -`clog_usage_limit_size` 用于控制单台 OBServer 中 Clog 日志文件使用空间的上限,当 Clog 日志文件的使用空间超出上限后,需要及时回收 Clog 日志文件。 - -示例 ------------------------ - -```sql -obclient> ALTER SYSTEM SET clog_usage_limit_size = 2TB; -``` - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/24.cache_wash_threshold-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/24.cache_wash_threshold-1.md deleted file mode 100644 index 205e59ae4..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/24.cache_wash_threshold-1.md +++ /dev/null @@ -1,15 +0,0 @@ -cache_wash_threshold -========================================= - -cache_wash_threshold 用于设置触发缓存清理的容量阈值。如果内存空间小于指定值时,内存空间将被清理。 - - -| **属性** | **描述** | -|------------------|----------| -| 参数类型 | 容量单位 | -| 默认值 | 4GB | -| 取值范围 | \[0, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/240.ofs_list-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/240.ofs_list-1.md deleted file mode 100644 index f477be02e..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/240.ofs_list-1.md +++ /dev/null @@ -1,18 +0,0 @@ -ofs_list -============================= - -`ofs_list` 保存了每个 Zone 的 OFS 列表,主要用于 OFS(Object File System)部署模式下,`__all_core_table` 副本选主时跨 Zone 读取其他 Zone 内 `__all_core_table` 副本的地址。 - - -| 属性 | 描述 | -|---------------------|--------------------------| -| 参数类型 | 字符串类型 | -| 默认值 | 部署时 OFS 的列表 | -| 取值范围 | 格式为: `[zone]@[ofs_url];` | -| 是否重启 OBServer 生效 | 否 | - - - -OceanBase 数据库在 OFS 三 Zone 的部署模式下,单个 Zone 的存储会对应 OFS 的一个 Zone。Zone 内的数据文件在 OBServer 间是共享的。因此,单个 Zone 内的 `__all_core_table` 副本不再与某个 OBServer 绑定。每个 Zone 内成功加载了 `__all_core_table` 数据文件的 OBServer,会将自己的 Server IP 和 Port,通过重命名的方式注册到 Zone 内某个唯一文件的文件名中。例如,`z1` 内的 OBServer `127.1.2.3:45` 加载了 `__all_core_table` 副本,那么它会在对应的 OFS Zone 目录下,重命名为文件:`/appname/zone_data/core_table_127.1.2.3:45`。这样,在集群启动初期,`__all_core_table` 三副本在进行选主时,各副本可以通过解析其他 Zone 内的 `core_table` 文件名,获取其他副本的 OBServer 列表,然后发起投票。 - -集群启动前,`ofs_list` 默认从每台 OBServer 自身的 `config` 文件中读取值。在修改该配置项的值时,需要执行有效性检查,防止 OFS 地址出错。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/25.clog_cache_priority-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/25.clog_cache_priority-1.md deleted file mode 100644 index 4895aca35..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/25.clog_cache_priority-1.md +++ /dev/null @@ -1,14 +0,0 @@ -clog_cache_priority -======================================== - -clog_cache_priority 用于设置事务日志占用缓存的优先级。 - - -| **属性** | **描述** | -|------------------|----------| -| 参数类型 | 整型 | -| 默认值 | 1 | -| 取值范围 | \[1, +∞) | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/26.clog_sync_time_warn_threshold-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/26.clog_sync_time_warn_threshold-1.md deleted file mode 100644 index fda006d3c..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/26.clog_sync_time_warn_threshold-1.md +++ /dev/null @@ -1,15 +0,0 @@ -clog_sync_time_warn_threshold -================================================== - -clog_sync_time_warn_threshold 用于设置事务日志同步耗时告警阈值,同步耗时超过该值产生 WARN 日志。 - - -| **属性** | **描述** | -|------------------|------------------| -| 参数类型 | 时间类型 | -| 默认值 | 100ms | -| 取值范围 | \[1ms, 10000ms\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/27.clog_disk_usage_limit_percentage-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/27.clog_disk_usage_limit_percentage-1.md deleted file mode 100644 index c9278b345..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/27.clog_disk_usage_limit_percentage-1.md +++ /dev/null @@ -1,15 +0,0 @@ -clog_disk_usage_limit_percentage -===================================================== - -clog_disk_usage_limit_percentage 用于设置事务日志的磁盘 I/O 最大使用百分比。 - - -| **属性** | **描述** | -|------------------|-------------| -| 参数类型 | 整型 | -| 默认值 | 95 | -| 取值范围 | \[80, 100\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/28.clog_transport_compress_all-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/28.clog_transport_compress_all-1.md deleted file mode 100644 index 377f5bd2c..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/28.clog_transport_compress_all-1.md +++ /dev/null @@ -1,14 +0,0 @@ -clog_transport_compress_all -================================================ - -clog_transport_compress_all 用于设置事务日志传输时是否压缩。 - - -| **属性** | **描述** | -|------------------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | False | -| 取值范围 | * False * True | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/29.clog_transport_compress_func-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/29.clog_transport_compress_func-1.md deleted file mode 100644 index fcdf74263..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/29.clog_transport_compress_func-1.md +++ /dev/null @@ -1,15 +0,0 @@ -clog_transport_compress_func -================================================= - -`clog_transport_compress_func` 用于设置事务日志内部传输时使用的压缩算法。 - - -| **属性** | **描述** | -|------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | 字符串类型 | -| 默认值 | lz4_1.0 | -| 取值范围 | * none * lz4_1.0 * snappy_1.0 * zlib_1.0 * zstd_1.0 * stream_lz4_1.0 * stream_zstd_1.0 * zstd_1.3.8 * stream_zstd_1.3.8 | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/3.auto_leader_switch_interval-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/3.auto_leader_switch_interval-1.md deleted file mode 100644 index 2336b3c05..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/3.auto_leader_switch_interval-1.md +++ /dev/null @@ -1,17 +0,0 @@ -auto_leader_switch_interval -================================================ - -auto_leader_switch_interval 用于设置自动切主后台线程工作间隔时间。 - - -| **属性** | **描述** | -|----------------|----------| -| 参数类型 | 时间类型 | -| 默认值 | 30s | -| 取值范围 | \[1s,+∞) | -| 是否需要重启OBserver | 否 | - - - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/30.clog_persistence_compress_func-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/30.clog_persistence_compress_func-1.md deleted file mode 100644 index 09fe64160..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/30.clog_persistence_compress_func-1.md +++ /dev/null @@ -1,15 +0,0 @@ -clog_persistence_compress_func -=================================================== - -clog_persistence_compress_func 用于设置事务日志落盘压缩算法。 - - -| **属性** | **描述** | -|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | 字符串 | -| 默认值 | lz4_1.0 | -| 取值范围 | * none * lz4_1.0 * zstd_1.0 * zstd_1.3.8 | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/31.clog_max_unconfirmed_log_count-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/31.clog_max_unconfirmed_log_count-1.md deleted file mode 100644 index 36f9b7926..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/31.clog_max_unconfirmed_log_count-1.md +++ /dev/null @@ -1,15 +0,0 @@ -clog_max_unconfirmed_log_count -=================================================== - -clog_max_unconfirmed_log_count 用于设置事务模块中未确认日志的最大数量。 - - -| **属性** | **描述** | -|------------------|----------------| -| 参数类型 | 整型 | -| 默认值 | 1500 | -| 取值范围 | \[100, 50000\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/32.cluster-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/32.cluster-1.md deleted file mode 100644 index bc71789e4..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/32.cluster-1.md +++ /dev/null @@ -1,15 +0,0 @@ -cluster -============================ - -cluster 用于设置本 OceanBase 集群名。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 字符串 | -| 默认值 | obcluster | -| 取值范围 | NULL | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/33.cluster_id-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/33.cluster_id-1.md deleted file mode 100644 index 067083b44..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/33.cluster_id-1.md +++ /dev/null @@ -1,15 +0,0 @@ -cluster_id -=============================== - -cluster_id 用于设置本 OceanBase 集群 ID。 - - -| **属性** | **描述** | -|------------------|-------------------| -| 参数类型 | 整型 | -| 默认值 | 0 | -| 取值范围 | \[1, 4294901759\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/34.cpu_count-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/34.cpu_count-1.md deleted file mode 100644 index f32d477c6..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/34.cpu_count-1.md +++ /dev/null @@ -1,14 +0,0 @@ -cpu_count -============================== - -cpu_count 用于设置系统 CPU 总数。如果设置为 0,系统将自动检测 CPU 数量。 - - -| **属性** | **描述** | -|------------------|----------| -| 参数类型 | 整型 | -| 默认值 | 0 | -| 取值范围 | \[0, +∞) | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/35.cpu_quota_concurrency-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/35.cpu_quota_concurrency-1.md deleted file mode 100644 index 7a48f07a2..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/35.cpu_quota_concurrency-1.md +++ /dev/null @@ -1,35 +0,0 @@ -cpu_quota_concurrency -========================================== - -cpu_quota_concurrency 用于设置租户的每个 CPU 配额所允许的最大并发数。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 双精度浮点数 | -| 默认值 | 4 | -| 取值范围 | \[1, 10\] | -| 是否重启 OBServer 生效 | 否 | - - - -租户中可同时处理的线程数由 cpu_quota_concurrency 与 workers_per_cpu_quota 2个配置项控制,且设置时需要满足: - -`workers_per_cpu_quota > cpu_quota_concurrency` - -* `workers_per_cpu_quota`表示租户在每个cpu上能分配的最大 worker 数 - - workers_per_cpu_quota 配置项详细信息,请参见 [workers_per_cpu_quota](../../14.reference-guide-oracle-mode/3.system-configuration-items-1/209.workers_per_cpu_quota-1.md)。 - - -* `cpu_quota_concurrency`表示租户在每个cpu上活跃的 worker 数,也即并发数 - - - - - -**说明** - - - -当物理机 CPU 足够多时,可以适当调大 `cpu_quota_concurrency `的值;如果物理机 CPU 较少,则调大`cpu_quota_concurrency `的值会存在风险。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/36.cpu_reserved-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/36.cpu_reserved-1.md deleted file mode 100644 index db0b3b9c5..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/36.cpu_reserved-1.md +++ /dev/null @@ -1,14 +0,0 @@ -cpu_reserved -================================= - -cpu_reserved 用于设置系统预留的 CPU 数量,其余 CPU 将被 OceanBase 数据库独占使用。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 整型 | -| 默认值 | 2 | -| 取值范围 | \[0, 15\] | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/37.config_additional_dir-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/37.config_additional_dir-1.md deleted file mode 100644 index 6faf1bbe6..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/37.config_additional_dir-1.md +++ /dev/null @@ -1,15 +0,0 @@ -config_additional_dir -========================================== - -config_additional_dir 用于设置本地存储配置文件的多个目录,为了冗余存储多份配置文件。 - - -| **属性** | **描述** | -|------------------|-------------------------------------------------------------------------------------------------------| -| 参数类型 | 字符串列表 | -| 默认值 | * etc2 * etc3 | -| 取值范围 | NULL | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/38.data_copy_concurrency-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/38.data_copy_concurrency-1.md deleted file mode 100644 index 64fb27f72..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/38.data_copy_concurrency-1.md +++ /dev/null @@ -1,15 +0,0 @@ -data_copy_concurrency -========================================== - -data_copy_concurrency 用于设置系统中并发执行的数据迁移复制任务的最大并发数。 - - -| **属性** | **描述** | -|--------|----------| -| 参数类型 | 整型 | -| 默认值 | 20 | -| 取值范围 | \[1, +∞) | -| 是否需要重启 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/39.data_dir-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/39.data_dir-1.md deleted file mode 100644 index 29c6bb938..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/39.data_dir-1.md +++ /dev/null @@ -1,15 +0,0 @@ -data_dir -============================= - -data_dir 用于设置存储 sstable 等数据的目录。 - - -| **属性** | **描述** | -|--------|--------| -| 参数类型 | 字符串 | -| 默认值 | store | -| 取值范围 | NULL | -| 是否可修改 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/4.auto_delete_expired_backup-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/4.auto_delete_expired_backup-1.md deleted file mode 100644 index b711d294f..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/4.auto_delete_expired_backup-1.md +++ /dev/null @@ -1,14 +0,0 @@ -auto_delete_expired_backup -=============================================== - -auto_delete_expired_backup 用于设置是否开启自动删除过期备份的功能。 - - -| **属性** | **描述** | -|------------------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | False | -| 取值范围 | * False * True | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/40.datafile_disk_percentage-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/40.datafile_disk_percentage-1.md deleted file mode 100644 index d5b6419d3..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/40.datafile_disk_percentage-1.md +++ /dev/null @@ -1,15 +0,0 @@ -datafile_disk_percentage -============================================= - -datafile_disk_percentage 表示占用 data_dir 所在磁盘(磁盘 data_dir 所在磁盘将被OceanBase 数据库系统初始化用于存储数据)总空间的百分比。 - - -| **属性** | **描述** | -|--------|----------| -| 参数类型 | 整型 | -| 默认值 | 90 | -| 取值范围 | \[5,99\] | -| 是否可修改 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/41.dtl_buffer_size-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/41.dtl_buffer_size-1.md deleted file mode 100644 index 1655cd909..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/41.dtl_buffer_size-1.md +++ /dev/null @@ -1,15 +0,0 @@ -dtl_buffer_size -==================================== - -dtl_buffer_size 用于设置 SQL 数据传输模块使用的缓存大小。 - - -| **属性** | **描述** | -|------------------|-------------| -| 参数类型 | 容量单位 | -| 默认值 | 64K | -| 取值范围 | \[4K, 2 M\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/42.datafile_size-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/42.datafile_size-1.md deleted file mode 100644 index 4df9e68fd..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/42.datafile_size-1.md +++ /dev/null @@ -1,15 +0,0 @@ -datafile_size -================================== - -datafile_size 用于设置数据文件的大小。一般不需要设置。 - - -| **属性** | **描述** | -|--------|-----------| -| 参数类型 | 容量单位 | -| 默认值 | 0M | -| 取值范围 | \[0M, +∞) | -| 是否可修改 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/43.debug_sync_timeout-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/43.debug_sync_timeout-1.md deleted file mode 100644 index ec229d132..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/43.debug_sync_timeout-1.md +++ /dev/null @@ -1,20 +0,0 @@ -debug_sync_timeout -======================================= - -debug_sync_timeout 用于打开 debug sync 调试开关,并设置其超时时间。 - - -| **属性** | **描述** | -|------------------|----------| -| 参数类型 | 时间类型 | -| 默认值 | 0 | -| 取值范围 | \[0, +∞) | -| 是否重启 OBServer 生效 | 否 | - - -**说明** - - - -debug_sync_timeout 的值为 0 时,表示关闭 debug sync 调试。 - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/44.default_compress_func-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/44.default_compress_func-1.md deleted file mode 100644 index c76047370..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/44.default_compress_func-1.md +++ /dev/null @@ -1,15 +0,0 @@ -default_compress_func -========================================== - -`default_compress_func` 用于设置表数据的默认压缩算法,也可以在建表的时候指定其他压缩算法。 - - -| **属性** | **描述** | -|------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | 字符串 | -| 默认值 | zstd_1.3.8 | -| 取值范围 | * none * lz4_1.0 * snappy_1.0 * zlib_1.0 * zstd_1.0 * zstd_1.3.8 | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/45.default_compress-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/45.default_compress-1.md deleted file mode 100644 index fb4e48c56..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/45.default_compress-1.md +++ /dev/null @@ -1,15 +0,0 @@ -default_compress -===================================== - -default_compress 用于设置在 Oracle 模式下,建表时使用的默认压缩策略。 - - -| **属性** | **描述** | -|------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | 字符串类型 | -| 默认值 | ARCHIVE | -| 取值范围 | * NOCOMPRESS * BASIC * OLTP * QUERY * ARCHIVE | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/46.default_progressive_merge_num-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/46.default_progressive_merge_num-1.md deleted file mode 100644 index 8b725f269..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/46.default_progressive_merge_num-1.md +++ /dev/null @@ -1,35 +0,0 @@ -default_progressive_merge_num -================================================== - -default_progressive_merge_num 用于设置新建一张表时默认的渐进合并次数。 - - -| **属性** | **描述** | -|------------------|----------| -| 参数类型 | 整型 | -| 默认值 | 60 | -| 取值范围 | \[0, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - -OceanBase 数据库支持对表数据进行渐进合并,即在对表执行需要重写数据的 DDL 操作后,可以将表数据的重写分散到多次合并中,一次合并中只进行部分数据的重写。您可以通过表级属性`progressive_merge_num`来控制合并行为,也可以通过`default_progressive_merge_num`配置项来设置新建一张表时默认的渐进合并次数。 - -当您未对新建表指定`progressive_merge_num`属性时,系统会将表级属性`progressive_merge_num`的值设置为`default_progressive_merge_num`的值。 - -`progressive_merge_num`属性的取值含义如下: - -* 0 :表示执行渐进合并,且渐进合并的次数为 100。 - - - -* 1:表示强制执行全量合并,不执行渐进合并。 - - - -* 大于 1 :表示发生 Schema 变更时按照指定轮次做渐进合并。 - - - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/47.default_row_format-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/47.default_row_format-1.md deleted file mode 100644 index 77fb71bd7..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/47.default_row_format-1.md +++ /dev/null @@ -1,15 +0,0 @@ -default_row_format -======================================= - -default_row_format 用于设置在 MySQL 模式下,建表时使用的默认行格式。 - - -| **属性** | **描述** | -|------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | 字符串 | -| 默认值 | DYNAMIC | -| 取值范围 | * REDUNDANT * COMPAT * DYNAMIC * COMPRESSED | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/48.devname-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/48.devname-1.md deleted file mode 100644 index d057c1801..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/48.devname-1.md +++ /dev/null @@ -1,15 +0,0 @@ -devname -============================ - -devname 用于设置服务进程绑定的网卡设备名。 - - -| **属性** | **描述** | -|------------------|--------| -| 参数类型 | 字符串 | -| 默认值 | bond0 | -| 取值范围 | NULL | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/49.data_disk_usage_limit_percentage-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/49.data_disk_usage_limit_percentage-1.md deleted file mode 100644 index 7353ca0cd..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/49.data_disk_usage_limit_percentage-1.md +++ /dev/null @@ -1,15 +0,0 @@ -data_disk_usage_limit_percentage -===================================================== - -data_disk_usage_limit_percentage 用于设置数据文件最大可以写入的百分比,超过这个阈值后,禁止数据迁入。 - - -| **属性** | **描述** | -|------------------|-------------| -| 参数类型 | 整型 | -| 默认值 | 90 | -| 取值范围 | \[50, 100\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/5.autoinc_cache_refresh_interval-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/5.autoinc_cache_refresh_interval-1.md deleted file mode 100644 index 951df1862..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/5.autoinc_cache_refresh_interval-1.md +++ /dev/null @@ -1,15 +0,0 @@ -autoinc_cache_refresh_interval -=================================================== - -autoinc_cache_refresh_interval 用于设置自增列缓存的刷新间隔。 - - -| **属性** | **描述** | -|------------------|--------------| -| 参数类型 | 时间类型 | -| 默认值 | 3600s | -| 取值范围 | \[100ms, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/50.disk_io_thread_count-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/50.disk_io_thread_count-1.md deleted file mode 100644 index bd3341fc3..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/50.disk_io_thread_count-1.md +++ /dev/null @@ -1,14 +0,0 @@ -disk_io_thread_count -========================================= - -disk_io_thread_count 用于设置磁盘 IO 线程数。必须为偶数。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 整型 | -| 默认值 | 8 | -| 取值范围 | \[2, 32\] | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/51.dead_socket_detection_timeout-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/51.dead_socket_detection_timeout-1.md deleted file mode 100644 index c7dcb2779..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/51.dead_socket_detection_timeout-1.md +++ /dev/null @@ -1,27 +0,0 @@ -dead_socket_detection_timeout -================================================== - -dead_socket_detection_timeout 用于设置检测失效 Socket 的时间间隔。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 时间类型 | -| 默认值 | 10s | -| 取值范围 | \[0s, 2h\] | -| 是否重启 OBServer 生效 | 否 | - - - -其中: - -* 当 dead_socket_detection_timeout 的值为 0 时,表示禁用 Socket 级故障检测。 - - - -* 当 dead_socket_detection_timeout 的值大于 0 时,表示启用 Socket 级故障检测,且当发送端有数据超过 设置的时间还未收到对方的应答,则认为当前 Socket 不可用。 - - - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/52.enable_clog_persistence_compress-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/52.enable_clog_persistence_compress-1.md deleted file mode 100644 index 205523e06..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/52.enable_clog_persistence_compress-1.md +++ /dev/null @@ -1,15 +0,0 @@ -enable_clog_persistence_compress -===================================================== - -enable_clog_persistence_compress 用于设置是否开启事务日志落盘压缩。 - - -| **属性** | **描述** | -|------------------|--------| -| 参数类型 | 字符串类型 | -| 默认值 | false | -| 取值范围 | NULL | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/53.election_cpu_quota-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/53.election_cpu_quota-1.md deleted file mode 100644 index f4acd44ec..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/53.election_cpu_quota-1.md +++ /dev/null @@ -1,15 +0,0 @@ -election_cpu_quota -======================================= - -election_cpu_quota 用于设置给副本选举相关的后台工作分配的 CPU 配额。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 双精度浮点数 | -| 默认值 | 3 | -| 取值范围 | \[0, 10\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/54.enable_one_phase_commit-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/54.enable_one_phase_commit-1.md deleted file mode 100644 index 6fbdbef33..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/54.enable_one_phase_commit-1.md +++ /dev/null @@ -1,15 +0,0 @@ -enable_one_phase_commit -============================================ - -enable_one_phase_commit 用于设置是否开启事务提交一阶段优化的功能。 - - -| **属性** | **描述** | -|------------------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | True | -| 取值范围 | * True * False | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/55.enable_sys_unit_standalone-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/55.enable_sys_unit_standalone-1.md deleted file mode 100644 index 674ba5977..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/55.enable_sys_unit_standalone-1.md +++ /dev/null @@ -1,35 +0,0 @@ -enable_sys_unit_standalone -=============================================== - -enable_sys_unit_standalone 用于设置系统租户的 Unit 是否独占节点。 - - -| **属性** | **描述** | -|------------------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | False | -| 取值范围 | * True * False | -| 是否重启 OBServer 生效 | 否 | - - - -当该配置项设置为`True`时,会产生以下影响: - -* 在创建资源池或增加资源池数量时,需要考虑系统租户的 Unit,即不能将普通租户的 Unit 与系统租户的 Unit 部署在同一个 Server 上。 - - - -* 系统会将与系统租户的 Unit 在同一个 Server 上的其他 Unit 迁移走。 - - - -* 永久下线或删除 Server 时,系统会先迁移系统租户的 Unit,再迁移其他租户的 Unit,且其他租户的 Unit 不能与系统租户的 Unit 在同一个 Server 上。 - - - -* 在进行 Tenant groups 均衡时,系统会将系统租户 Unit 所在的 Server 从 tenant groups 的可用机器中过滤掉,即 Tenant groups 的 Unit 会平铺到除了系统租户 Unit 所在 Server 的其他 Server上去。 - - - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/56.enable_pg-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/56.enable_pg-1.md deleted file mode 100644 index dbdf2fe7b..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/56.enable_pg-1.md +++ /dev/null @@ -1,14 +0,0 @@ -enable_pg -============================== - -enable_pg 用于设置是否开启分区组功能。 - - -| 属性 | 描述 | -|------------------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | False | -| 取值范围 | * True * False | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/57.enable_smooth_leader_switch-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/57.enable_smooth_leader_switch-1.md deleted file mode 100644 index bb67d6ccb..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/57.enable_smooth_leader_switch-1.md +++ /dev/null @@ -1,14 +0,0 @@ -enable_smooth_leader_switch -================================================ - -enable_smooth_leader_switch 是平滑切主特性的开关。 - - -| **属性** | **描述** | -|------------------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | True | -| 取值范围 | * True * False | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/58.election_blacklist_interval-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/58.election_blacklist_interval-1.md deleted file mode 100644 index 507af114f..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/58.election_blacklist_interval-1.md +++ /dev/null @@ -1,21 +0,0 @@ -election_blacklist_interval -================================================ - -election_blacklist_interval 用于设置主副本被废除后不允许再被选为主的时间间隔。 - - -| 属性 | 描述 | -|------------------|-------------| -| 参数类型 | 时间类型 | -| 默认值 | 1800s | -| 取值范围 | \[0s, 24h\] | -| 是否重启 OBServer 生效 | 否 | - - - -OceanBase 数据库通过 election_blacklist_interval 配置项实现了黑名单功能。当 Leader 主动发生卸任后,从当前时间开始计时,在 election_blacklist_interval 配置项设置的时间内,该副本保证不会再被改选为 Leader,即该副本加入了选举黑名单。 -**注意** - - - -仅当主副本发生主动卸任,且 observer 进程不重启时,该副本才会加入黑名单。observer 进程重启后,黑名单状态会丢失。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/59.enable_election_group-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/59.enable_election_group-1.md deleted file mode 100644 index d40a6ee3a..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/59.enable_election_group-1.md +++ /dev/null @@ -1,15 +0,0 @@ -enable_election_group -========================================== - -enable_election_group 用于设置是否打开选举组策略。 - - -| 属性 | 描述 | -|------------------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | True | -| 取值范围 | * True * False | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/6.audit_sys_operations-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/6.audit_sys_operations-1.md deleted file mode 100644 index fe9edcb3f..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/6.audit_sys_operations-1.md +++ /dev/null @@ -1,15 +0,0 @@ -audit_sys_operations -========================================= - -audit_sys_operations 用于设置是否追踪系统用户的操作行为。 - - -| **属性** | **描述** | -|------------------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | False | -| 取值范围 | * False * True | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/60.enable_auto_leader_switch-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/60.enable_auto_leader_switch-1.md deleted file mode 100644 index 82d3aadff..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/60.enable_auto_leader_switch-1.md +++ /dev/null @@ -1,14 +0,0 @@ -enable_auto_leader_switch -============================================== - -enable_auto_leader_switch 用于设置是否开启自动切主。 - - -| **属性** | **描述** | -|------------------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | True | -| 取值范围 | * True * False | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/61.enable_global_freeze_trigger-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/61.enable_global_freeze_trigger-1.md deleted file mode 100644 index 6ecdd3713..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/61.enable_global_freeze_trigger-1.md +++ /dev/null @@ -1,22 +0,0 @@ -enable_global_freeze_trigger -================================================= - -enable_global_freeze_trigger 用于设置是否开启自动触发全局冻结。 - - -| **属性** | **描述** | -|------------------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | False | -| 取值范围 | * True * False | -| 是否重启 OBServer 生效 | 否 | - - - - -**说明** - - - -该配置项保持保持默认值即可,不推荐使用。 - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/62.enable_manual_merge-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/62.enable_manual_merge-1.md deleted file mode 100644 index 90f1ac25a..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/62.enable_manual_merge-1.md +++ /dev/null @@ -1,16 +0,0 @@ -enable_manual_merge -======================================== - -enable_manual_merge 用于设置是否开启手工合并。 - - -| **属性** | **描述** | -|------------------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | False | -| 取值范围 | * True * False | -| 是否重启 OBServer 生效 | 否 | - - - -enable_manual_merge 用于 DBA 管理错峰是否暂停,只有在 enable_manual_merge 为 True 时,max_merge_duration_time 才有效。如果这个值为 True,则认为 DBA 关闭自动合并。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/63.enable_merge_by_turn-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/63.enable_merge_by_turn-1.md deleted file mode 100644 index b4b598e3d..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/63.enable_merge_by_turn-1.md +++ /dev/null @@ -1,15 +0,0 @@ -enable_merge_by_turn -========================================= - -enable_merge_by_turn 用于设置是否开启轮转合并策略。 - - -| **属性** | **描述** | -|------------------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | True | -| 取值范围 | * True * False | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/64.enable_perf_event-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/64.enable_perf_event-1.md deleted file mode 100644 index ad2b65667..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/64.enable_perf_event-1.md +++ /dev/null @@ -1,15 +0,0 @@ -enable_perf_event -====================================== - -enable_perf_event 用于设置是否开启性能事件的信息收集功能。 - - -| **属性** | **描述** | -|------------------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | True | -| 取值范围 | * True * False | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/65.enable_rebalance-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/65.enable_rebalance-1.md deleted file mode 100644 index 1298d152d..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/65.enable_rebalance-1.md +++ /dev/null @@ -1,14 +0,0 @@ -enable_rebalance -===================================== - -enable_rebalance 用于设置是否开启自动负载均衡的功能。 - - -| **属性** | **描述** | -|------------------|---------------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | True | -| 取值范围 | * True:开启 * False:不开启 | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/66.enable_record_trace_log-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/66.enable_record_trace_log-1.md deleted file mode 100644 index 43e17ecd9..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/66.enable_record_trace_log-1.md +++ /dev/null @@ -1,14 +0,0 @@ -enable_record_trace_log -============================================ - -enable_record_trace_log 用于设置是否记录追踪日志。 - - -| **属性** | **描述** | -|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | False | -| 取值范围 | * True:表示只要出现错误,就一定打印 trace log。 * False:表示每隔 trace_log_sampling_interval 会打印一次慢查询或白名单错误码日志。 | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/67.enable_record_trace_id-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/67.enable_record_trace_id-1.md deleted file mode 100644 index c6402456e..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/67.enable_record_trace_id-1.md +++ /dev/null @@ -1,15 +0,0 @@ -enable_record_trace_id -=========================================== - -enable_record_trace_id 用于设置是否记录应用端设置的追踪 ID。 - - -| **属性** | **描述** | -|------------------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | True | -| 取值范围 | * True * False | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/68.enable_early_lock_release-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/68.enable_early_lock_release-1.md deleted file mode 100644 index 13df54c6b..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/68.enable_early_lock_release-1.md +++ /dev/null @@ -1,14 +0,0 @@ -enable_early_lock_release -============================================== - -enable_early_lock_release 用于设置是否开启提前解行锁的功能。 - - -| **属性** | **描述** | -|------------------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | False | -| 取值范围 | * True * False | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/69.enable_rereplication-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/69.enable_rereplication-1.md deleted file mode 100644 index 2fea277e7..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/69.enable_rereplication-1.md +++ /dev/null @@ -1,19 +0,0 @@ -enable_rereplication -========================================= - -enable_rereplication 用于设置是否开启自动补副本的功能。 - - -| 属性 | 描述 | -|------------------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | True | -| 取值范围 | * True * False | -| 是否重启 OBServer 生效 | 否 | - - -**说明** - - - -如果不开启 enable_rereplication,即使分区的副本数小于设置的 ob_default_replica_num,也不会进行复制。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/7.audit_trail-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/7.audit_trail-1.md deleted file mode 100644 index baa0b18ba..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/7.audit_trail-1.md +++ /dev/null @@ -1,15 +0,0 @@ -audit_trail -================================ - -audit_trail 用于设置是否启用数据库审核。 - - -| 属性 | 描述 | -|------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | 字符串 | -| 默认值 | NONE | -| 取值范围 | * NONE * OS * DB * DB,EXTENDED * DB_EXTENDED | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/70.enable_rich_error_msg-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/70.enable_rich_error_msg-1.md deleted file mode 100644 index 99f22366e..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/70.enable_rich_error_msg-1.md +++ /dev/null @@ -1,14 +0,0 @@ -enable_rich_error_msg -========================================== - -enable_rich_error_msg 用于设置是否在客户端消息中添加服务器地址、时间、追踪 ID 等调试信息。 - - -| **属性** | **描述** | -|------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | False | -| 取值范围 | * True:表示会在错误消息前添加 OBServer 的 `ip:port`、出错时间和日志 Trace ID。 * False:表示保持文本错误消息内容不变。 | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/71.enable_rootservice_standalone-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/71.enable_rootservice_standalone-1.md deleted file mode 100644 index 98a8b2b7a..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/71.enable_rootservice_standalone-1.md +++ /dev/null @@ -1,14 +0,0 @@ -enable_rootservice_standalone -================================================== - -enable_rootservice_standalone 用于设置是否让系统租户和 RootService 独占 OBServer 节点。 - - -| **属性** | **描述** | -|------------------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | False | -| 取值范围 | * True * False | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/72.enable_sql_audit-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/72.enable_sql_audit-1.md deleted file mode 100644 index 8f6ffe73d..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/72.enable_sql_audit-1.md +++ /dev/null @@ -1,14 +0,0 @@ -enable_sql_audit -===================================== - -enable_sql_audit 用于设置是否开启 SQL 审计功能。 - - -| **属性** | **描述** | -|------------------|---------------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | True | -| 取值范围 | * True:开启 * False:不开启 | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/73.enable_sql_operator_dump-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/73.enable_sql_operator_dump-1.md deleted file mode 100644 index 6935acecf..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/73.enable_sql_operator_dump-1.md +++ /dev/null @@ -1,14 +0,0 @@ -enable_sql_operator_dump -============================================= - -enable_sql_operator_dump 用于设置是否允许 SQL 处理过程的中间结果写入磁盘以释放内存。 - - -| **属性** | **描述** | -|------------------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | True | -| 取值范围 | * True * False | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/74.enable_async_syslog-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/74.enable_async_syslog-1.md deleted file mode 100644 index 6607a7d16..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/74.enable_async_syslog-1.md +++ /dev/null @@ -1,15 +0,0 @@ -enable_async_syslog -======================================== - -enable_async_syslog 用于设置是否启用系统日志异步写。 - - -| **属性** | **描述** | -|------------------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | True | -| 取值范围 | * True * False | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/75.enable_syslog_recycle-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/75.enable_syslog_recycle-1.md deleted file mode 100644 index 51c4ce73a..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/75.enable_syslog_recycle-1.md +++ /dev/null @@ -1,15 +0,0 @@ -enable_syslog_recycle -========================================== - -enable_syslog_recycle 用于设置是否开启回收系统日志的功能。 - - -| **属性** | **描述** | -|------------------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | False | -| 取值范围 | * True * False | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/76.enable_syslog_wf-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/76.enable_syslog_wf-1.md deleted file mode 100644 index 065e17e43..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/76.enable_syslog_wf-1.md +++ /dev/null @@ -1,15 +0,0 @@ -enable_syslog_wf -===================================== - -enable_syslog_wf 用于设置是否把 WARN 以上级别的系统日志打印到一个单独的日志文件中。 - - -| **属性** | **描述** | -|------------------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | True | -| 取值范围 | * True * False | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/77.enable_upgrade_mode-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/77.enable_upgrade_mode-1.md deleted file mode 100644 index 3309eed15..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/77.enable_upgrade_mode-1.md +++ /dev/null @@ -1,16 +0,0 @@ -enable_upgrade_mode -======================================== - -enable_upgrade_mode 用于设置是否开启升级模式。在升级模式中,会暂停部分系统后台功能。 - - -| **属性** | **描述** | -|------------------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | False | -| 取值范围 | * True * False | -| 是否重启 OBServer 生效 | 否 | - - - -在升级前,对于需要禁止的功能(例如, DDL 操作),您可以统一通过该系统配置项来控制,使升级流程更简单。升级前将 enable_upgrade_mode 设置为 True,升级后将其设置为 False。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/78.enable_separate_sys_clog-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/78.enable_separate_sys_clog-1.md deleted file mode 100644 index 61a5577e6..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/78.enable_separate_sys_clog-1.md +++ /dev/null @@ -1,15 +0,0 @@ -enable_separate_sys_clog -============================================= - -enable_separate_sys_clog 用于设置是否把系统事务日志与用户事务日志分开存储。 - - -| **属性** | **描述** | -|------------------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | False | -| 取值范围 | * True * False | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/79.enable_ddl-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/79.enable_ddl-1.md deleted file mode 100644 index f8a9164a9..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/79.enable_ddl-1.md +++ /dev/null @@ -1,15 +0,0 @@ -enable_ddl -=============================== - -enable_ddl 用于设置是否允许执行 DDL。 - - -| **属性** | 描述 | -|------------------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | True | -| 取值范围 | * True * False | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/8.balancer_idle_time-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/8.balancer_idle_time-1.md deleted file mode 100644 index 0897aa7b3..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/8.balancer_idle_time-1.md +++ /dev/null @@ -1,14 +0,0 @@ -balancer_idle_time -======================================= - -balancer_idle_time 用于设置负载均衡等后台任务线程空闲时的唤醒间隔时间。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 时间类型 | -| 默认值 | 5m,表示 5 分钟 | -| 取值范围 | \[10s, +∞) | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/80.enable_major_freeze-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/80.enable_major_freeze-1.md deleted file mode 100644 index e89e565c3..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/80.enable_major_freeze-1.md +++ /dev/null @@ -1,15 +0,0 @@ -enable_major_freeze -======================================== - -enable_major_freeze 用于设置是否开启自动全局冻结的功能。 - - -| **属性** | **描述** | -|------------------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | True | -| 取值范围 | * True * False | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/81.enable_rebuild_on_purpose-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/81.enable_rebuild_on_purpose-1.md deleted file mode 100644 index c5f5a1d19..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/81.enable_rebuild_on_purpose-1.md +++ /dev/null @@ -1,14 +0,0 @@ -enable_rebuild_on_purpose -============================================== - -enable_rebuild_on_purpose 在备副本日志落后过多时,设置是否开启主动触发副本重建操作。 - - -| **属性** | **描** **述** | -|------------------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | False | -| 取值范围 | * True * False | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/82.enable_log_archive-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/82.enable_log_archive-1.md deleted file mode 100644 index 26f90c225..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/82.enable_log_archive-1.md +++ /dev/null @@ -1,15 +0,0 @@ -enable_log_archive -======================================= - -enable_log_archive 用于设置是否开启日志归档功能。 - - -| **属性** | **描述** | -|------------------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | False | -| 取值范围 | * True * False | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/83.enable_monotonic_weak_read-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/83.enable_monotonic_weak_read-1.md deleted file mode 100644 index 87032236e..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/83.enable_monotonic_weak_read-1.md +++ /dev/null @@ -1,15 +0,0 @@ -enable_monotonic_weak_read -=============================================== - -enable_monotonic_weak_read 用于设置是否开启单调读。 - - -| **属性** | **描述** | -|------------------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | False | -| 取值范围 | * True * False | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/84.external_kms_info-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/84.external_kms_info-1.md deleted file mode 100644 index 6859db8ee..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/84.external_kms_info-1.md +++ /dev/null @@ -1,16 +0,0 @@ -external_kms_info -====================================== - -external_kms_info 用于存储一些密钥管理信息。 - - -| **属性** | **描述** | -|------------------|--------| -| 参数类型 | 字符串类型 | -| 默认值 | 空值 | -| 取值范围 | NULL | -| 是否重启 OBServer 生效 | 否 | - - - -使用外部密钥管理中心时,external_kms_info 将存储一些密钥管理信息。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/85.freeze_trigger_percentage-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/85.freeze_trigger_percentage-1.md deleted file mode 100644 index 168c53a4b..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/85.freeze_trigger_percentage-1.md +++ /dev/null @@ -1,16 +0,0 @@ -freeze_trigger_percentage -============================================== - -freeze_trigger_percentage 用于设置触发全局冻结的租户使用内存阈值。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 整型 | -| 默认值 | 70 | -| 取值范围 | \[1, 99\] | -| 是否重启 OBServer 生效 | 否 | - - - -详细信息请参见 [enable_global_freeze_trigger](../../14.reference-guide-oracle-mode/3.system-configuration-items-1/61.enable_global_freeze_trigger-1.md)。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/86.flush_log_at_trx_commit-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/86.flush_log_at_trx_commit-1.md deleted file mode 100644 index 2872d46d0..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/86.flush_log_at_trx_commit-1.md +++ /dev/null @@ -1,31 +0,0 @@ -flush_log_at_trx_commit -============================================ - -flush_log_at_trx_commit 用于设置事务提交时写事务日志策略。 - - -| **属性** | **描述** | -|------------------|----------| -| 参数类型 | 整型 | -| 默认值 | 1 | -| 取值范围 | \[0, 2\] | -| 是否重启 OBServer 生效 | 否 | - - - -flush_log_at_trx_commit 配置项的取值含义如下: - -* 取值为 0 表示不等待日志写入缓冲区。 - - - -* 取值为 1 表示等待日志写入磁盘。 - - - -* 取值为 2 表示等待日志写入缓冲区而不等落盘。 - - - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/87.fuse_row_cache_priority-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/87.fuse_row_cache_priority-1.md deleted file mode 100644 index c800bb60f..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/87.fuse_row_cache_priority-1.md +++ /dev/null @@ -1,14 +0,0 @@ -fuse_row_cache_priority -============================================ - -fuse_row_cache_priority 用于设置融合行缓存在缓存系统中的优先级。 - - -| **属性** | **描述** | -|------------------|----------| -| 参数类型 | 整型 | -| 默认值 | 1 | -| 取值范围 | \[1, +∞) | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/88.force_refresh_location_cache_interval-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/88.force_refresh_location_cache_interval-1.md deleted file mode 100644 index 8da7686e0..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/88.force_refresh_location_cache_interval-1.md +++ /dev/null @@ -1,14 +0,0 @@ -force_refresh_location_cache_interval -========================================================== - -force_refresh_location_cache_interval 用于设置刷新位置缓存的最大时间间隔。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 时间类型 | -| 默认值 | 2h,表示 2 小时 | -| 取值范围 | \[1s, +∞) | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/89.force_refresh_location_cache_threshold-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/89.force_refresh_location_cache_threshold-1.md deleted file mode 100644 index 195ec0025..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/89.force_refresh_location_cache_threshold-1.md +++ /dev/null @@ -1,15 +0,0 @@ -force_refresh_location_cache_threshold -=========================================================== - -force_refresh_location_cache_threshold 用于设置刷新位置缓存时每秒最多刷新次数的阈值,超过该阈值会被限流。 - - -| **属性** | **描述** | -|------------------|----------| -| 参数类型 | 整型 | -| 默认值 | 100 | -| 取值范围 | \[1, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/9.balancer_log_interval-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/9.balancer_log_interval-1.md deleted file mode 100644 index a0e31d595..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/9.balancer_log_interval-1.md +++ /dev/null @@ -1,15 +0,0 @@ -balancer_log_interval -========================================== - -balancer_log_interval 用于负载均衡等后台任务线程打印统计日志的间隔时间。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 时间类型 | -| 默认值 | 1m,表示 1 分钟 | -| 取值范围 | \[1s, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/90.get_leader_candidate_rpc_timeout-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/90.get_leader_candidate_rpc_timeout-1.md deleted file mode 100644 index 56e43194b..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/90.get_leader_candidate_rpc_timeout-1.md +++ /dev/null @@ -1,15 +0,0 @@ -get_leader_candidate_rpc_timeout -===================================================== - -get_leader_candidate_rpc_timeout 用于设置自动切主策略获取切主候选者的内部请求超时时间。 - - -| **属性** | **描述** | -|------------------|--------------| -| 参数类型 | 时间类型 | -| 默认值 | 9s | -| 取值范围 | \[2s, 180s\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/91.global_major_freeze_residual_memory-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/91.global_major_freeze_residual_memory-1.md deleted file mode 100644 index be9684716..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/91.global_major_freeze_residual_memory-1.md +++ /dev/null @@ -1,21 +0,0 @@ -global_major_freeze_residual_memory -======================================================== - -global_major_freeze_residual_memory 用于设置触发全局冻结的剩余内存阈值。即当剩余内存小于这个百分比时,触发全局冻结。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 整型 | -| 默认值 | 40 | -| 取值范围 | \[1, 99\] | -| 是否重启 OBServer 生效 | 否 | - - - -global_major_freeze_residual_memory 配置项是百分比,百分比基数是 memory_limit - system_memory,即除去为 OceanBase 数据库内部 500 租户预留的内存。已经冻结的 memstore 在 merge 完成后,内存就可以释放,所以冻结的 memstore 占用的内存在这里被看作是 active_memstore 可以使用的内存,blockcache 可以挤占的那部分内存也被看作是 memstore 可以使用的内存。 -**说明** - - - -global_major_freeze_residual_memory 配置项取值需要比 global_write_halt_residual_memory 大,否则全局 freeze trigger 实际不生效,只能依靠 tenant 触发全局冻结。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/92.global_write_halt_residual_memory-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/92.global_write_halt_residual_memory-1.md deleted file mode 100644 index e3351b679..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/92.global_write_halt_residual_memory-1.md +++ /dev/null @@ -1,16 +0,0 @@ -global_write_halt_residual_memory -====================================================== - -global_write_halt_residual_memory 用于设置触发暂停普通租户写入(sys 租户不受影响)的全局剩余内存阈值。即当全局剩余内存小于这个百分比时,暂停普通租户写入(sys 租户不受影响)。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 整型 | -| 默认值 | 30 | -| 取值范围 | \[1, 99\] | -| 是否重启 OBServer 生效 | 否 | - - - -global_write_halt_residual_memory 配置项的值为百分比,百分比基数为 memory_limit - system_memory,即除去为 OceanBase 数据库内部 500 租户预留的内存。计算剩余内存的时候,blockcache 可以挤占的那部分内存看作 memstore 可以使用的内存。 diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/93.ignore_replay_checksum_error-1-2.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/93.ignore_replay_checksum_error-1-2.md deleted file mode 100644 index 3d1896acb..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/93.ignore_replay_checksum_error-1-2.md +++ /dev/null @@ -1,14 +0,0 @@ -ignore_replay_checksum_error -================================================= - -ignore_replay_checksum_error 用于设置是否忽略回放事务日志时发生的校验和错误。 - - -| **属性** | **描述** | -|------------------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | False | -| 取值范围 | * True * False | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/94.gts_refresh_interval-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/94.gts_refresh_interval-1.md deleted file mode 100644 index 4712e80da..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/94.gts_refresh_interval-1.md +++ /dev/null @@ -1,14 +0,0 @@ -gts_refresh_interval -========================================= - -gts_refresh_interval 用于获取刷新全局时间戳服务的时间间隔。 - - -| **属性** | **描述** | -|------------------|--------------| -| 参数类型 | 时间类型 | -| 默认值 | 100us | -| 取值范围 | \[10us, 1s\] | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/95.global_index_build_single_replica_timeout-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/95.global_index_build_single_replica_timeout-1.md deleted file mode 100644 index 7184408f5..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/95.global_index_build_single_replica_timeout-1.md +++ /dev/null @@ -1,15 +0,0 @@ -global_index_build_single_replica_timeout -============================================================== - -global_index_build_single_replica_timeout 用于建全局索引时,设置每个副本构建的超时时间。 - - -| **属性** | **描述** | -|------------------|-----------| -| 参数类型 | 时间类型 | -| 默认值 | 48h | -| 取值范围 | \[1h, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/96.high_priority_net_thread_count-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/96.high_priority_net_thread_count-1.md deleted file mode 100644 index 177428803..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/96.high_priority_net_thread_count-1.md +++ /dev/null @@ -1,15 +0,0 @@ -high_priority_net_thread_count -=================================================== - -high_priority_net_thread_count 用于设置高优先级网络线程数,值为 0 时,表示关闭该功能。 - - -| **属性** | **描述** | -|------------------|------------| -| 参数类型 | 整型 | -| 默认值 | 0 | -| 取值范围 | \[0, 100\] | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/97.ignore_replica_checksum_error-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/97.ignore_replica_checksum_error-1.md deleted file mode 100644 index fe87015f7..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/97.ignore_replica_checksum_error-1.md +++ /dev/null @@ -1,14 +0,0 @@ -ignore_replica_checksum_error -================================================== - -ignore_replica_checksum_error 用于设置是否忽略多副本间校验和检查发生的错误。 - - -| **属性** | **描述** | -|------------------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | False | -| 取值范围 | * True * False | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/98.ignore_replay_checksum_error-1-2-3.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/98.ignore_replay_checksum_error-1-2-3.md deleted file mode 100644 index 3d1896acb..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/98.ignore_replay_checksum_error-1-2-3.md +++ /dev/null @@ -1,14 +0,0 @@ -ignore_replay_checksum_error -================================================= - -ignore_replay_checksum_error 用于设置是否忽略回放事务日志时发生的校验和错误。 - - -| **属性** | **描述** | -|------------------|--------------------------------------------------------------------------------------------------------| -| 参数类型 | 布尔类型 | -| 默认值 | False | -| 取值范围 | * True * False | -| 是否重启 OBServer 生效 | 否 | - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/99.index_cache_priority-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/99.index_cache_priority-1.md deleted file mode 100644 index 77c5efbfc..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/3.system-configuration-items-1/99.index_cache_priority-1.md +++ /dev/null @@ -1,15 +0,0 @@ -index_cache_priority -========================================= - -index_cache_priority 用于设置索引在缓存系统中的优先级。 - - -| **属性** | **描述** | -|------------------|----------| -| 参数类型 | 整型 | -| 默认值 | 10 | -| 取值范围 | \[1, +∞) | -| 是否重启 OBServer 生效 | 否 | - - - diff --git a/docs/docs/docs-cn/14.reference-guide-oracle-mode/4.reserved-keywords-1.md b/docs/docs/docs-cn/14.reference-guide-oracle-mode/4.reserved-keywords-1.md deleted file mode 100644 index 6139aa14c..000000000 --- a/docs/docs/docs-cn/14.reference-guide-oracle-mode/4.reserved-keywords-1.md +++ /dev/null @@ -1,62 +0,0 @@ -预留关键字 -========================== - - - -目前,OceanBase 数据库 Oracle 模式下的预留关键字如下所示。 - - -|------------|------------|------------|-----------|---------| -| A ||||| -| ACCESS | ADD | ALL | ALTER | AND | -| ANY | AS | ASC | AUDIT || -| B ||||| -| BETWEEN | BY |||| -| C ||||| -| CHAR | CHECK | CLUSTER | COLUMN | COMMENT | -| COMPRESS | CONNECT | CREATE | CURRENT | CASE | -| CONNECT_BY_ROOT ||||| -| D ||||| -| DATE | DECIMAL | DEFAULT | DELETE | DESC | -| DISTINCT | DROP | DUAL ||| -| E ||||| -| ELSE | EXCLUSIVE | EXISTS ||| -| F ||||| -| FILE | FLOAT | FOR | FROM || -| G ||||| -| GRANT | GROUP |||| -| H ||||| -| HAVING ||||| -| I ||||| -| IDENTIFIED | IMMEDIATE | IN | INCREMENT | INDEX | -| INITIAL | INSERT | INTEGER | INTERSECT | INTO | -| IS ||||| -| L ||||| -| LEVEL | LIKE | LOCK | LONG || -| M ||||| -| MAXEXTENTS | MINUS | MODE | MODIFY || -| N ||||| -| NOAUDIT | NOCOMPRESS | NOT | NOTFOUND | NOWAIT | -| NULL | NUMBER |||| -| O ||||| -| OF | OFFLINE | ON | ONLINE | OPTION | -| OR | ORDER |||| -| P ||||| -| PCTFREE | PRIOR | PRIVILEGES | PUBLIC | RAW | -| R ||||| -| RENAME | RESOURCE | REVOKE | ROW | ROWID | -| ROWLABEL | ROWNUM | ROWS ||| -| S ||||| -| START | SELECT | SESSION | SET | SHARE | -| SIZE | SMALLINT | SUCCESSFUL | SYNONYM | SYSDATE | -| SQL_CALC_FOUND_ROWS ||||| -| T ||||| -| TABLE | THEN | TO | TRIGGER || -| U ||||| -| UID | UNION | UNIQUE | UPDATE | USER | -| V ||||| -| VALIDATE | VALUES | VARCHAR | VARCHAR2 | VIEW | -| W ||||| -| WHENEVER | WHERE | WITH ||| - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/1.about-oceanbase-database-developers-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/1.about-oceanbase-database-developers-1.md deleted file mode 100644 index 8acb7853f..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/1.about-oceanbase-database-developers-1.md +++ /dev/null @@ -1,6 +0,0 @@ -关于 OceanBase 数据库开发者 -======================================== - - - -OceanBase 数据库开发人员负责创建或维护使用 OceanBase 相关产品的应用程序的数据库组件。OceanBase 数据库开发人员要么基于 OceanBase 数据库开发新应用程序,要么将现有应用程序转换到 OceanBase 数据库环境中运行。 diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/2.about-this-document-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/2.about-this-document-1.md deleted file mode 100644 index 1065ba55e..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/2.about-this-document-1.md +++ /dev/null @@ -1,17 +0,0 @@ -关于本文档 -========================== - - - -本文档是为应用程序开发人员准备的 OceanBase 数据库文档的入门文档,它包含如下内容: - -* 解释了 OceanBase 数据库开发背后的基本概念。 - - - -* 展示并示例如何使用 OceanBase 数据库的 Oracle 租户的功能,如 SQL、存储过程和包等。 - - - - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/3.about-oceanbase-databases-1/1.apsaradb-for-oceanbase-cluster-overview-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/3.about-oceanbase-databases-1/1.apsaradb-for-oceanbase-cluster-overview-1.md deleted file mode 100644 index 39e0b656d..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/3.about-oceanbase-databases-1/1.apsaradb-for-oceanbase-cluster-overview-1.md +++ /dev/null @@ -1,53 +0,0 @@ -OceanBase 集群简介 -=================================== - - - -OceanBase 集群通常由运维人员管理,OceanBase 数据库集群将多个机器资源聚合成一个大的资源池之后再分配给不同租户(也称为实例)。OceanBase 不同租户之间彼此资源隔离,数据访问也是完全隔离的。 - -相关概念 -------------- - -* OceanBase 集群的多副本架构 - - OceanBase 集群通常是三副本架构,少数场景可能会使用五副本。在三副本架构下,OceanBase 集群的节点数通常是三的倍数,集群节点会分为三个区域( Zone )。每个 Zone 的节点数通常保持相等,可以有 1 或多个节点。每个租户的数据也会分布在这三个 Zone 里,但不一定用尽每个 Zone 的所有节点,这取决于租户资源池属性的设置,由运维人员确定。 - - - - - - - -* OceanBase 集群的高可用能力 - - 在三副本架构的 OceanBase 集群里,默认每份数据也有三份,分布在三个 Zone 中。这个数据表示的最小粒度叫分区。分区是表的子集,有关表的详细介绍请参见 [创建表](#-创建表)。OceanBase 集群的高可用的粒度就是分区,故障切换时的切换粒度也是分区。所以 OceanBase 集群节点故障时,应用可能是部分数据访问中断,并且会自动恢复访问。当故障节点内部分区非常多的时候,不同数据的恢复时间可能有细微的区别。 - - - - - - - -* OceanBase 集群的参数设置 - - OceanBase 数据库支持通过参数(parameters)来影响集群和租户的功能、性能等。集群参数通常是在sys租户里设置,影响范围是整个集群,也包括集群里的租户。同时OceanBase针对租户也支持用变量(variables)来设置,影响范围是当前租户。有关 OceanBase 数据库常用的参数和变量请参考附录[OceanBase 常用参数变量](#-OceanBase常用参数变量)。 - - - - - - - -* OceanBase 集群的写特点 - - 当第一次向 OceanBase 数据库的表中修改一笔数据时,OceanBase 数据库会将该记录所在的块读入到内存中的一块只读区域中,然后在另外一块内存区域记录一笔修改记录。前者称为基线数据(SSTable),后者称为增量数据(MemTable),对应的内存称为增量内存。无论是插入、更新还是删除,OceanBase 数据库都不会对 SSTable 进行修改,而是在原来的增量基础上追加(append)新的增量。这种设计使得OceanBase 数据库的写产生的 IO 非常少,性能很好。增量会一直在内存中不落盘,直到增量内存使用率超过一定阈值后触发冻结事件(Minor freeze),此时会生成新的 MemTable 供后续写入。老的增量 MemTable 会直接转储到磁盘上,或者直接跟磁盘里的 SSTable 进行合并(Major freeze)。 - - - - -**说明** - - - -默认设置下,OceanBase 数据库的增量和基线数据合并操作会在凌晨 2 点进行。由于 OceanBase 数据库的内存写这个特点,开发和运维都需要关注自己的业务对数据库内存的消耗速度。如果增量内存写入速度远快于增量转储或合并释放内存的速度,增量内存有可能会消耗完导致后续写入报错。此时需要在应用或数据库端做内存写入速度限流操作,或者对数据库实例内存进行扩容。 - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/3.about-oceanbase-databases-1/2.introduction-to-oceanbase-tenants-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/3.about-oceanbase-databases-1/2.introduction-to-oceanbase-tenants-1.md deleted file mode 100644 index 5e053744b..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/3.about-oceanbase-databases-1/2.introduction-to-oceanbase-tenants-1.md +++ /dev/null @@ -1,16 +0,0 @@ -OceanBase 租户简介 -=================================== - - - -租户目前有两种兼容模式,兼容 Oracle 或 MySQL,不同兼容模式的实例再按照相应的方式把相关的业务数据组织在一起。在 Oracle 兼容模式的租户下,这个组织方式叫模式(Schema);在 MySQL 兼容模式的租户下,这个组织方式叫数据库(DataBase)。当通过用户名、密码和 IP 连接 OceanBase 数据库时,您指定了相应的 OceanBase 集群名、租户名以及租户下的模式或者用户,以表明您是这些数据的所有者。在 Oracle 租户下,用户名和用户访问的模式名默认是相同的;在 MySQL 租户下,用户名和用户访问的数据库名默认可以不同。 - -OceanBase 集群默认会有一个租户(兼容 MySQL),租户名是 **sys** ,里面存储的是集群元数据信息。sys 租户主要是集群内部管理需要,运维人员经常访问使用。sys 租户下不建议建表存储数据。OceanBase 集群除去 sys 租户占用的资源外都是未分配资源,留给业务租户使用。业务使用 OceanBase 数据库需要先创建一个业务租户。 - -创建租户的工作通常由数据库运维人员完成,可以在 sys 租户下直接创建租户,或者在 OCP(OceanBase Cloud Platform)中"新建实例"。 -**说明** - - - -租户和实例是同义词。 - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/3.about-oceanbase-databases-1/3.mysql-based-tenant-database-objects-of-oceanbase-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/3.about-oceanbase-databases-1/3.mysql-based-tenant-database-objects-of-oceanbase-1.md deleted file mode 100644 index 1baa98ccd..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/3.about-oceanbase-databases-1/3.mysql-based-tenant-database-objects-of-oceanbase-1.md +++ /dev/null @@ -1,33 +0,0 @@ -OceanBase 的 MySQL 租户数据库对象 -============================================== - - - -由于 sys 租户是一个 MySQL 租户,所以这里也简单介绍一些基本的数据库对象。 - -在 MySQL 租户下,每个数据库对象只属于一个数据库(DataBase),数据库名跟用户名没有直接关系,每个用户可以访问的数据库跟用户的权限有关系。用户访问数据库对象通常还需要切换到该数据库下,否则对象前面就要带上数据库对象所属的数据库名。 - -数据库下支持的数据库对象有: - -* 表(Tables) - - 表是 OceanBase 数据库最基本的存储单元,容纳用户的数据。每个表包含很多行(rows),每行表示独立的数据记录(records)。每一行包含很多列(columns),每列表示记录的一个字段(fields)。 - - - - - - - -* 索引(Indexes 或 Keys) - - - -* 视图(Views) - - - - - - -有关 MySQL 租户的使用方法请参考《开发者指南(MySQL模式)》。 diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/3.about-oceanbase-databases-1/4.oracle-tenant-database-objects-of-oceanbase.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/3.about-oceanbase-databases-1/4.oracle-tenant-database-objects-of-oceanbase.md deleted file mode 100644 index f0d2b5c0a..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/3.about-oceanbase-databases-1/4.oracle-tenant-database-objects-of-oceanbase.md +++ /dev/null @@ -1,57 +0,0 @@ -OceanBase 的 Oracle 租户数据库对象 -=============================================== - - - -在 Oracle 租户下,每个数据库对象只属于一个模式(Schema),Schema 名称唯一,通常就是用户名。默认每个用户只能访问同名的 Schema 下的数据库对象,访问其他 Schema 下的数据库对象需要在对象名前加上相应的 Schema 名,并且前提是有相应的访问权限。 - -Schema 下的支持的数据库对象有: - -* 表(Tables) - - 表是 OceanBase 数据库最基本的存储单元,容纳用户的数据。每个表包含很多行(rows),每行表示独立的数据记录(records)。每一行包含很多列(columns),每列表示记录的一个字段(fields)。 - - - - - - - -* 索引(Indexes) - - 索引用于提升表的数据查询性能。每个表可以有零个、一个或者多个索引对象。 - - - - - - - -* 视图(Views) - - 视图用于将一个或多个表的部分或全部数据在一个对象里展示。视图也可以依赖表和其他视图。 - - - - - - - -* 序列(Sequences) - - 当表所有记录必须互不相同时,可以用序列为表的数值列(如ID列)生成一序列不重复的数字,每个数字用于表示每行记录的ID列。序列是独立的对象,不属于表的列。序列的取值用于表的ID列的取值。 - - - - - - - -* 同义词(Synonyms) - - 同义词是数据库对象的别名。为了访问安全和方便,您可以使用同义词。例如,隐藏对象的所有者或简化SQL语句。 - - - - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/3.about-oceanbase-databases-1/5.about-oceanbase-database-access-methods-1/1.introduction-to-the-mysql-client-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/3.about-oceanbase-databases-1/5.about-oceanbase-database-access-methods-1/1.introduction-to-the-mysql-client-1.md deleted file mode 100644 index 2d8117223..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/3.about-oceanbase-databases-1/5.about-oceanbase-database-access-methods-1/1.introduction-to-the-mysql-client-1.md +++ /dev/null @@ -1,22 +0,0 @@ -关于 MySQL 客户端(mysql) -======================================== - - - -OceanBase 的系统租户 sys 是兼容 MySQL 的,可以使用 mysql 客户端访问。 - -mysql 命令是 MySQL 数据库命令行下客户端,需要单独安装。OceanBase 的租户兼容类型支持 MySQL 和 Oracle。当租户兼容 MySQL 时,可以通过 mysql 命令连接。 -**说明** - -OceanBase 当前版本支持的 MySQL 客户端版本只有:5.5、5.6、5.7。 - -连接上 OceanBase 数据库后,在 mysql 命令行环境里,可以运行一些 mysql 运维命令、SQL 语句来执行下面这些任务: - -* 计算、存储和打印查询结果 - -* 创建数据库对象、检查和修改对象定义 - -* 执行数据库管理,修改参数等 - - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/3.about-oceanbase-databases-1/5.about-oceanbase-database-access-methods-1/2.introduction-to-the-oceanbase-client-obclient-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/3.about-oceanbase-databases-1/5.about-oceanbase-database-access-methods-1/2.introduction-to-the-oceanbase-client-obclient-1.md deleted file mode 100644 index 009d8b602..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/3.about-oceanbase-databases-1/5.about-oceanbase-database-access-methods-1/2.introduction-to-the-oceanbase-client-obclient-1.md +++ /dev/null @@ -1,29 +0,0 @@ -关于 OceanBase 客户端(obclient) -=============================================== - - - -obclient 是一个交互式和批处理查询工具,需要单独安装。它是一个命令行用户界面,在连接到数据库时充当客户端,支持 OceanBase 的 Oracle 租户和 MySQL 租户。 - -obclient 运行时需要指定 OceanBase 租户的连接信息,具体方法请参考 [通过 obclient 连接 OceanBase 租户](../../../../8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/1.connect-to-an-oceanbase-tenant-by-using-obclient-1.md)。 - -连接上 OceanBase 数据库后,在 obclient 里,可以运行一些 obclient 命令(包含常用的 MySQL 命令)、SQL 语句来执行下面这些任务: - -* 计算、存储和打印查询结果 - - - -* 创建数据库对象、检查和修改对象定义 - - - -* 开发和运行批处理脚本 - - - -* 执行数据库管理,修改参数等 - - - - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/3.about-oceanbase-databases-1/5.about-oceanbase-database-access-methods-1/3.about-oceanbase-developer-center-client.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/3.about-oceanbase-databases-1/5.about-oceanbase-database-access-methods-1/3.about-oceanbase-developer-center-client.md deleted file mode 100644 index 4578d50f7..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/3.about-oceanbase-databases-1/5.about-oceanbase-database-access-methods-1/3.about-oceanbase-developer-center-client.md +++ /dev/null @@ -1,10 +0,0 @@ -关于 OceanBase 开发者中心客户端 -========================================== - - - -OceanBase 开发者中心(OceanBase Developer Center,ODC)是 OceanBase 团队开发的一款OceanBase图形化客户端,下载地址:https://help.aliyun.com/document_detail/142073.html - -如果是公有云客户,请下载公有云包;其他客户,请下载专有云包。 - -ODC 支持 OceanBase 的 MySQL 和 Oracle 租户,可以查看数据库表、视图、函数和存储过程等。有关 ODC的详细介绍和使用指南请参考 ODC 产品文档。 diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/3.about-oceanbase-databases-1/5.about-oceanbase-database-access-methods-1/4.about-structured-query-language-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/3.about-oceanbase-databases-1/5.about-oceanbase-database-access-methods-1/4.about-structured-query-language-1.md deleted file mode 100644 index bce6dc06c..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/3.about-oceanbase-databases-1/5.about-oceanbase-database-access-methods-1/4.about-structured-query-language-1.md +++ /dev/null @@ -1,6 +0,0 @@ -关于结构化查询语言 -========= - -结构化查询语言(SQL)是一种基于集合和关系代数理论的高级计算机语言,所有程序和用户都可以使用 SQL 访问 OceanBase 数据库中的数据。 - -SQL 是一种声明性的或非程序性的语言,也就是说,它描述了该做什么,而不是如何做。您指定所需的结果集(例如,当前员工的名称),但不指定如何获取它。不过通过一些 SQL 写法或 SQL Hint 可以对 SQL 获取数据的执行计划施加一定的影响,从而提升 SQL 的执行性能。 diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/3.about-oceanbase-databases-1/5.about-oceanbase-database-access-methods-1/5.java-database-connection-driver-jdbc-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/3.about-oceanbase-databases-1/5.about-oceanbase-database-access-methods-1/5.java-database-connection-driver-jdbc-1.md deleted file mode 100644 index b46f5fcb3..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/3.about-oceanbase-databases-1/5.about-oceanbase-database-access-methods-1/5.java-database-connection-driver-jdbc-1.md +++ /dev/null @@ -1,6 +0,0 @@ -Java 数据库连接驱动(JDBC) -================== - -Java 数据库连接(JDBC)是一种 API,它使 Java 能够将 SQL 语句发送到对象关系数据库,如 Oracle、MySQL 数据库。JDBC 支持为 Java 暴露 SQL 数据类型,并快速访问 SQL 数据。 - -OceanBase 的 MySQL 租户兼容 MySQL 的连接协议,使用标准的 MySQL JDBC 可以连接 OceanBase 的 MySQL 租户。但 JDBC 默认不支持 Oracle 租户的连接协议。 diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/3.about-oceanbase-databases-1/5.about-oceanbase-database-access-methods-1/6.oceanbase-java-database-connection-driver-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/3.about-oceanbase-databases-1/5.about-oceanbase-database-access-methods-1/6.oceanbase-java-database-connection-driver-1.md deleted file mode 100644 index b9f24a990..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/3.about-oceanbase-databases-1/5.about-oceanbase-database-access-methods-1/6.oceanbase-java-database-connection-driver-1.md +++ /dev/null @@ -1,18 +0,0 @@ -OceanBase Java 数据库连接驱动 -=========================================== - - - -OceanBase 实现了自己的 JDBC 驱动,使 Java 能够将 SQL 语句发送到 OceanBase 的 MySQL 租户和 Oracle 租户。OceanBase JDBC 支持为 Java 暴露 SQL 数据类型、STORED PROCEDURE 对象,并快速访问 SQL 数据。 - -OceanBase JDBC 驱动文件名为:oceanbase-client-\[版本号\].jar,可以联系 OceanBase 技术支持工程师获取。 -**说明** - - - -OceanBase 数据库驱动文件1.0 相关版本的类名为:com.alipay.oceanbase.obproxy.mysql.jdbc.Driver 。 - -OceanBase数据库驱动文件从1.1.0 后类名更改为:com.alipay.oceanbase.jdbc.Driver ,原类名会保留,但是不推荐使用。 - - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/4.about-the-sample-database-tpcc-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/4.about-the-sample-database-tpcc-1.md deleted file mode 100644 index 0e4472866..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/1.preface-1/4.about-the-sample-database-tpcc-1.md +++ /dev/null @@ -1,21 +0,0 @@ -关于示例数据库TPCC -================================ - - - -示例数据库安装脚本可以安装在 OceanBase 的 Oracle 租户或者 MySQL 租户上。如果是 Oracle 租户,需要先创建一个用户和 schema,然后登录这个用户执行脚本;如果是 MySQ 租户,需要先创建一个 DataBase,然后进入这个数据库下执行脚本。 - -脚本分为三部分: - -* 数据库建表语句,文件名"create_oracle_tables.sql",创建业务表和视图,适用于 MySQL 和 Oracle 租户。 - -* 数据库存储过程和视图语句,文件名"create_oracle_procedures.sql",创建业务相关存储过程,仅适用于 Oracle租户。 - -* 数据初始化语句,文件名"init_data.sql",初始化相关表数据,适用于 MySQL 和 Oracle 租户。 - - - - -示例数据库的业务是由国际事务性能委员会(TPC)制定的TPC-C标准,定义了商品销售的订单创建和订单支付等的基准测试标准,是数据库联机交易处理系统(OLTP)的权威基准测试标准。 - -示例数据库可以从https://github.com/obpilot/ob-samples免费下载。 diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/1.connect-to-an-oceanbase-tenant-by-using-obclient-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/1.connect-to-an-oceanbase-tenant-by-using-obclient-1.md deleted file mode 100644 index 68ae3fa17..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/1.connect-to-an-oceanbase-tenant-by-using-obclient-1.md +++ /dev/null @@ -1,113 +0,0 @@ -通过 obclient 连接 OceanBase 租户 -================================================ - - - -obclient 是 OceanBase 专用的命令行客户端工具,通过 obclient 您可以连接 OceanBase 的 MySQL 和 ORACLE 租户。 - -操作步骤 -------------- - -1. 打开一个命令行终端。 - - - -2. 参照下面格式提供 obclient 的运行参数: - - - - - - -```javascript -$ obclient -h192.168.1.101 -usys@t_oracle0_91#obdoc -P2883 -pabcABC123 -c -A sys -``` - - -**说明** - - - -* -h:提供 OceanBase 数据库连接的 IP,通常是一个 OBProxy 地址。 - - - -* -u:提供租户的连接帐户,格式有两种:"用户名@租户名#集群名"或者"集群名:租户名:用户名"。Oracle 租户的管理员用户名默认是 sys。 - - - -* -P:提供 OceanBase 数据库连接端口,也是 OBProxy 的监听端口,默认是 2883,可以自定义;如果不通过 OBProxy 连接 OceanBase 数据库,而是通过 obclient 直连 OBserver(即 -u 参数中不加"#集群名"),则默认端口是 2881。 - - - -* -p:提供帐户密码。为了安全可以不提供,改为在后面提示符下输入,密码文本不可见。 - - - -* -c:表示在将 SQL 语句中的注释发往数据库端。 - - - -* -A:表示在连接数据库时不去获取全部表信息,可以使登录数据库速度最快。 - - - -* sys:访问的数据库名,可以改为业务数据库。 - - - - - - -3. 连接成功后,默认会有如下命令行提示符。 - - - - - - -```javascript -obclient> -``` - - - -4. 如果要退出 OceanBase 命令行,输入 exit 后回车,或者按快捷键 ctrl + d。 - - - - - - - - -示例 ------------ - -通过 obclient 连接 OceanBase 数据库的 Oracle 租户。 - -```javascript -$obclient -h192.168.1.101 -usys@t_oracle0_91#obdoc -P2883 -pabcABC123 -c -A sys -obclient: [Warning] Using a password on the command line interface can be insecure. -Welcome to the OceanBase monitor. Commands end with ; or \g. -Your OceanBase connection id is 64621 -Server version: 5.6.25 OceanBase 2.2.20 (...) (Built Aug 10 2019 15:27:33) - -<省略> - -Type 'help;' or '\h' for help. Type '\c' to clear the current input statement. - -obclient> select sysdate from dual; -+---------------------+ -| SYSDATE | -+---------------------+ -| 2020-04-01 21:53:22 | -+---------------------+ -1 row in set (0.00 sec) - -obclient> exit -Bye -``` - - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/2.connect-to-the-oceanbase-database-through-odc-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/2.connect-to-the-oceanbase-database-through-odc-1.md deleted file mode 100644 index 79cc83f1d..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/2.connect-to-the-oceanbase-database-through-odc-1.md +++ /dev/null @@ -1,37 +0,0 @@ -通过 ODC 连接 OceanBase 数据库 -============================================ - - - -操作步骤 -------------- - -1. 登录ODC。ODC第一次运行时,加载时间会比较长,请耐心等待。 - - - - -![image.png](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/0475055061/p148887.png "image.png") - -2. ODC启动完成后,会提示创建连接。 - - - - -![image.png](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/0475055061/p148888.png "image.png") - -3. 点击 **新建连接** ,在新建连接页面选择 **连接模式** 为 O **racle,在页面中输入 连接名称、主机名** 、 **端口** 、 **集群** 、 **租户** 、 **数据库用户名** 和 **数据库密码** ,点击 **保存** ,如果可以保存成功,说明连接数据库成功。![](https://cdn.nlark.com/yuque/0/2020/png/177325/1600748167156-722bcd34-9a22-4402-8d19-aed64ee63d11.png)​ - - - - - - - - -4. 连接创建成功后,会显示如下界面,双击该连接面板就可以打开连接。​​![](https://cdn.nlark.com/yuque/0/2020/png/177325/1600748140317-1788f8b5-1832-4331-a01b-52d3abb9a8f4.png)​ - - - - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/3.create-oceanbase-sample-database-tpcc-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/3.create-oceanbase-sample-database-tpcc-1.md deleted file mode 100644 index 073c55b8c..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/3.create-oceanbase-sample-database-tpcc-1.md +++ /dev/null @@ -1,143 +0,0 @@ -创建 OceanBase 示例数据库 TPCC -============================================ - - - -默认情况 OceanBase 没有创建示例数据库 TPCC,需要手动创建。示例数据库必须在业务租户下创建。有关示例数据库介绍请参考 [关于示例数据库TPCC](../../8.developer-guide-oracle-mode/1.preface-1/4.about-the-sample-database-tpcc-1.md)。 - -租户创建好后,需要创建相应的 Schema 来存放示例数据库的对象,还要分配相应的用户和访问权限。 - -示例 ------------ - -1. 通过 obclient 连接 Oracle 租户。具体方法请参考 [通过 obclient 连接 OceanBase 租户](../../8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/1.connect-to-an-oceanbase-tenant-by-using-obclient-1.md)。 - - - - -```javascript -$obclient -h192.168.1.101 -usys@t_oracle0_91#obdoc -P2883 -pabcABC123 sys -obclient: [Warning] Using a password on the command line interface can be insecure. -Welcome to the OceanBase monitor. Commands end with ; or \g. -Your OceanBase connection id is 58725 -Server version: 5.6.25 OceanBase 2.2.20 (...) (Built Aug 10 2019 15:27:33) - -<...省略...> - -Type 'help;' or '\h' for help. Type '\c' to clear the current input statement. - -obclient> -``` - - - -2. 创建一个 Schema,即用户。 - - - - - - -```javascript -obclient> create user tpcc identified by 123456; -Query OK, 0 rows affected (0.02 sec) - -obclient> grant all privileges on tpcc.* to tpcc; -Query OK, 0 rows affected (0.02 sec) - -obclient> grant create,drop,select on *.* to tpcc; -Query OK, 0 rows affected (0.01 sec) - -obclient> grant select on sys.* to tpcc; -Query OK, 0 rows affected (0.02 sec) - -obclient> show grants for tpcc; -+---------------------------------------------+ -| Grants for TPCC@% | -+---------------------------------------------+ -| GRANT CREATE, DROP, SELECT ON *.* TO 'TPCC' | -| GRANT SELECT ON "SYS".* TO 'TPCC' | -| GRANT ALL PRIVILEGES ON "TPCC".* TO 'TPCC' | -+---------------------------------------------+ -3 rows in set (0.00 sec) -``` - - - -3. 通过用户 tpcc 登录到 tpcc 模式下。 - - - - - - -```javascript -$obclient -h192.168.1.101 -utpcc@t_oracle0_91#obdoc -P2883 -p123456 tpcc -``` - - - -4. 创建数据库对象 - - - - - - -```javascript -obclient> source create_tables_oracle.sql -Query OK, 0 rows affected (0.21 sec) - -<...省略...> - -Query OK, 0 rows affected (0.07 sec) - -+-----------+------------+-------------+-----------+ -| SYSDATE | TABLE_NAME | PARTITIONED | TEMPORARY | -+-----------+------------+-------------+-----------+ -| 01-APR-20 | CUST | YES | N | -| 01-APR-20 | DIST | YES | N | -| 01-APR-20 | HIST | YES | N | -| 01-APR-20 | ITEM | NO | N | -| 01-APR-20 | LOAD_HIST | NO | N | -| 01-APR-20 | LOAD_PROC | NO | N | -| 01-APR-20 | NORD | YES | N | -| 01-APR-20 | ORDL | YES | N | -| 01-APR-20 | ORDR | YES | N | -| 01-APR-20 | STOK | YES | N | -| 01-APR-20 | WARE | YES | N | -+-----------+------------+-------------+-----------+ -11 rows in set (0.02 sec) -``` - - - -5. 初始化表数据。 - -```javascript -obclient> source init_data.sql -Query OK, 0 rows affected (0.01 sec) -<...省略...> -Query OK, 0 rows affected (0.01 sec) - -Query OK, 1 row affected (0.00 sec) - -Query OK, 0 rows affected (0.03 sec) - -+------------+----------+ -| TABLE_NAME | ROWS_CNT | -+------------+----------+ -| WARE | 2 | -| DIST | 20 | -| NORD | 40 | -| ORDR | 60 | -| HIST | 240 | -| ITEM | 622 | -| ORDL | 626 | -| CUST | 1040 | -| STOK | 1244 | -+------------+----------+ -9 rows in set (0.03 sec) -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/4.explore-the-oceanbase-oracle-tenant-by-using-obclient.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/4.explore-the-oceanbase-oracle-tenant-by-using-obclient.md deleted file mode 100644 index d4206fef1..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/4.explore-the-oceanbase-oracle-tenant-by-using-obclient.md +++ /dev/null @@ -1,130 +0,0 @@ -通过 obclient 探索 OceanBase Oracle 租户 -======================================================= - - - -在 obclient 命令行环境里,可以通过一些命令或者 SQL 查看数据库对象或者表属性和数据。 - -示例 ------------ - -* 通过 obclient 查看 Oracle 租户下 TPCC 模式下的数据库对象。 - - - - - - -```javascript -$obclient -h192.168.1.101 -utpcc@t_oracle0_91#obdoc -P2883 -p123456 tpcc -obclient> select object_type,count(*) from user_objects group by object_type; -+-----------------+----------+ -| OBJECT_TYPE | COUNT(*) | -+-----------------+----------+ -| TABLE | 15 | -| INDEX | 2 | -| VIEW | 1 | -| TABLE PARTITION | 48 | -| PROCEDURE | 5 | -+-----------------+----------+ -5 rows in set (0.01 sec) -``` - - - -* 通过 obclient 查看 TPCC 模式下的表属性 - - - - - - -```javascript -obclient> desc ordl; -+----------------+-------------+------+-----+---------+-------+ -| FIELD | TYPE | NULL | KEY | DEFAULT | EXTRA | -+----------------+-------------+------+-----+---------+-------+ -| OL_W_ID | NUMBER(38) | NO | PRI | NULL | NULL | -| OL_D_ID | NUMBER(38) | NO | PRI | NULL | NULL | -| OL_O_ID | NUMBER(38) | NO | PRI | NULL | NULL | -| OL_NUMBER | NUMBER(38) | NO | PRI | NULL | NULL | -| OL_DELIVERY_D | DATE | YES | NULL | NULL | NULL | -| OL_AMOUNT | NUMBER(6,2) | YES | NULL | NULL | NULL | -| OL_I_ID | NUMBER(38) | YES | NULL | NULL | NULL | -| OL_SUPPLY_W_ID | NUMBER(38) | YES | NULL | NULL | NULL | -| OL_QUANTITY | NUMBER(38) | YES | NULL | NULL | NULL | -| OL_DIST_INFO | CHAR(24) | YES | NULL | NULL | NULL | -+----------------+-------------+------+-----+---------+-------+ -10 rows in set (0.00 sec) - -obclient> show create table ordl\G -*************************** 1. row *************************** - TABLE: ORDL -CREATE TABLE: CREATE TABLE "ORDL" ( - "OL_W_ID" NUMBER(38) NOT NULL, - "OL_D_ID" NUMBER(38) NOT NULL, - "OL_O_ID" NUMBER(38) NOT NULL, - "OL_NUMBER" NUMBER(38) NOT NULL, - "OL_DELIVERY_D" DATE, - "OL_AMOUNT" NUMBER(6,2), - "OL_I_ID" NUMBER(38), - "OL_SUPPLY_W_ID" NUMBER(38), - "OL_QUANTITY" NUMBER(38), - "OL_DIST_INFO" CHAR(24), - CONSTRAINT "ORDL_OBPK_1581557270705134" PRIMARY KEY ("OL_W_ID", "OL_D_ID", "OL_O_ID", "OL_NUMBER") -) COMPRESS FOR QUERY REPLICA_NUM = 3 BLOCK_SIZE = 16 USE_BLOOM_FILTER = FALSE TABLET_SIZE = 134217728 PCTFREE = 0 TABLEGROUP = 'TPCC_GROUP' - partition by hash(ol_w_id) partitions 6 - -1 row in set (0.00 sec) - -obclient> show create tablegroup TPCC_GROUP\G -*************************** 1. row *************************** - TABLEGROUP: TPCC_GROUP -CREATE TABLEGROUP: CREATE TABLEGROUP "TPCC_GROUP" BINDING = FALSE - partition by hash partitions 6 - -1 row in set (0.00 sec) -``` - - - -* 通过 obclient 查看 TPCC 模式下的表数据 - - - - - - -```javascript -obclient> select * from ordr where rownum<3; -+--------+--------+------+--------+--------------+----------+-------------+-----------+ -| O_W_ID | O_D_ID | O_ID | O_C_ID | O_CARRIER_ID | O_OL_CNT | O_ALL_LOCAL | O_ENTRY_D | -+--------+--------+------+--------+--------------+----------+-------------+-----------+ -| 2 | 1 | 2100 | 2360 | 10 | 8 | 1 | 15-FEB-20 | -| 2 | 1 | 2101 | 2101 | NULL | 14 | 1 | 15-FEB-20 | -+--------+--------+------+--------+--------------+----------+-------------+-----------+ -2 rows in set (0.00 sec) - -obclient> select * from ordr where rownum<3\G -*************************** 1. row *************************** - O_W_ID: 2 - O_D_ID: 1 - O_ID: 2100 - O_C_ID: 2360 -O_CARRIER_ID: 10 - O_OL_CNT: 8 - O_ALL_LOCAL: 1 - O_ENTRY_D: 2020-02-15 18:58:22 -*************************** 2. row *************************** - O_W_ID: 2 - O_D_ID: 1 - O_ID: 2101 - O_C_ID: 2101 -O_CARRIER_ID: NULL - O_OL_CNT: 14 - O_ALL_LOCAL: 1 - O_ENTRY_D: 2020-02-15 18:58:22 -2 rows in set (0.00 sec) -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/5.explore-the-oceanbase-oracle-tenant-with-odc.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/5.explore-the-oceanbase-oracle-tenant-with-odc.md deleted file mode 100644 index 7d0d16d7d..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/5.explore-the-oceanbase-oracle-tenant-with-odc.md +++ /dev/null @@ -1,30 +0,0 @@ -通过 ODC 探索 OceanBase Oracle 租户 -================================================== - - - -通过 ODC 浏览 OceanBase Oracle 数据库对象 ------------------------------------------ - -1. 在 ODC 中打开一个连接后,左侧面板会有 **表** 、 **视图** 、 **函数** 、 **存储过程** ,点击 **表** ,会展示所有的表。双击其中一个表,可以打开该表的属性,包括 **列** 、 **索引** 、 **分区** 、 **DDL** 。 - - - - - - -![image.png](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/6901155061/p148891.png "image.png") - -2. 点击左侧的存储过程,可以展示所有的存储过程。双击其中一个存储过程,可以显示该存储过程的属性、参数、定义等信息。 - - - - -![image.png](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/6901155061/p148892.png "image.png") - -通过 ODC SQL 窗口查询 OcenaBase Oracle 数据库数据 ------------------------------------------------ - -在 ODC 中打开一个连接后,默认会开启一个 SQL 窗口,可以在里面输入 SQL 语句,并点击 **运行** 。 - -![image.png](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/6901155061/p148893.png "image.png") diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/1.about-query-statements-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/1.about-query-statements-1.md deleted file mode 100644 index 0b72e3465..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/1.about-query-statements-1.md +++ /dev/null @@ -1,42 +0,0 @@ -关于查询语句 -=========================== - - - -一个查询,指一个SELECT SQL 语句,从一个或多个表或者视图里查询数据。 - -最简单的SQL语句格式是: - -```javascript -SELECT select_list FROM table_list -``` - - - -* *select_list指定的可以是后面* - -* *table_list 里的列,也可以是函数值、字符常量、计算变量等。* - -* *table_list 指定的是包含所查数据的表或者视图。* - - - - -上面是简单的查询语句格式,实际 table_list 还可以是一个子查询语句,同时还可以带上 where 条件以限定返回的结果要符合某种条件。 - -需要注意的是,在Oracle租户里,table_list 也可以用空表 dual 代替,这样 select_list 就不是具体的列,而是常量或者变量值。如下面这个SQL: - -```javascript -$obclient -h192.168.1.101 -utpcc@t_oracle0_91#obdoc -P2883 -p123456 tpcc -obclient> select '中', 6*6 from dual; -+-------+-----+ -| '中' | 6*6 | -+-------+-----+ -| 中 | 36 | -+-------+-----+ -1 row in set (0.01 sec) -``` - - - -关于查询语句的详细用法请参考《OceanBase SQL参考(Oracle模式)》。 diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/10.about-flashback-queries.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/10.about-flashback-queries.md deleted file mode 100644 index fa6b6d686..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/10.about-flashback-queries.md +++ /dev/null @@ -1,81 +0,0 @@ -关于闪回查询 -=========================== - - - -闪回查询(Flashback Query)是 OceanBase 数据库提供的一种可以查看记录某个历史版本数据的能力。默认的查询 SQL 返回的是当前事务隔离级别下允许查询的已提交的版本数据,如果要查询历史上提交的版本,可以在表后指定历史时间信息。 - -**示例:闪回查询历史记录** - -```javascript -obclient> create table t1 (id number not null primary key, name varchar2(50) not null, gmt_create timestamp default CURRENT_TIMESTAMP ); -Query OK, 0 rows affected (0.06 sec) - -obclient> create sequence seq_t1 start with 1; -Query OK, 0 rows affected (0.02 sec) - -obclient> insert into t1 (id, name) values(seq_t1.nextval, 'A');commit; -Query OK, 1 row affected (0.01 sec) - -Query OK, 0 rows affected (0.00 sec) - -obclient> insert into t1 (id, name) values(seq_t1.nextval, 'B');commit; -Query OK, 1 row affected (0.00 sec) - -Query OK, 0 rows affected (0.00 sec) - -obclient> insert into t1 (id, name) values(seq_t1.nextval, 'C');commit; -Query OK, 1 row affected (0.00 sec) - -Query OK, 0 rows affected (0.01 sec) - -obclient> insert into t1 (id, name) values(seq_t1.nextval, 'D');commit; -Query OK, 1 row affected (0.00 sec) - -Query OK, 0 rows affected (0.00 sec) - -obclient> select * from t1; -+----+------+---------------------+ -| ID | NAME | GMT_CREATE | -+----+------+---------------------+ -| 1 | A | 2020-04-02 17:41:51 | -| 2 | B | 2020-04-02 17:41:57 | -| 3 | C | 2020-04-02 17:42:04 | -| 4 | D | 2020-04-02 17:42:10 | -+----+------+---------------------+ -4 rows in set (0.00 sec) - -obclient> select * from t1 as of timestamp to_timestamp('2020-04-02 17:41:57','YYYY-MM-DD HH24:MI:SS'); -+----+------+---------------------+ -| ID | NAME | GMT_CREATE | -+----+------+---------------------+ -| 1 | A | 2020-04-02 17:41:51 | -| 2 | B | 2020-04-02 17:41:57 | -+----+------+---------------------+ -2 rows in set (0.00 sec) -``` - - - -闪回查询对能查询的最早时间有个限制,受变量 undo_retention 控制。如果 undo_retention 未设置或设置为 0,则可以查询集群上次 major freeze 之后最后一次 minor freeze 之后的历史数据。变量 undo_retention 的修改需要有租户的管理员权限,通过 set global 命令修改,并且只对修改之后的会话产生的数据生效。 - -```javascript -obclient> show variables like 'undo_retention'; -+----------------+-------+ -| VARIABLE_NAME | VALUE | -+----------------+-------+ -| undo_retention | 0 | -+----------------+-------+ -1 row in set (0.00 sec) -``` - - - -当集群发生 minor freeze 事件后,再查询这个历史时间点数据,会报错。 - -```javascript -obclient> select * from t1 as of timestamp to_timestamp('2020-04-02 17:41:57','YYYY-MM-DD HH24:MI:SS'); -ORA-08186: invalid timestamp -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/2.run-queries-in-odc-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/2.run-queries-in-odc-1.md deleted file mode 100644 index 603e838ec..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/2.run-queries-in-odc-1.md +++ /dev/null @@ -1,34 +0,0 @@ -在 ODC 中运行查询 -================================ - - - -本节展示如何在 ODC 中通过 SQL 编辑器执行查询语句。 - -前提条件 -------------------------- - -已在 ODC 中创建了到 OceanBase 数据库的连接。 - -操作步骤 -------------------------- - -1. 进入 ODC,找到创建好的数据库连接,单击进入对应的数据库管理页面。 - - - -2. 单击上方导航栏中的 **工作台** ,在弹出的下拉菜单中选择 **SQL 窗口** 。 - - - -3. 在打开的 **SQL 窗口** 中输入查询语句,如果有多条查询语句,每个语句都以";"结尾。单击 **运行** 或 **运行当前语句** 按钮。 - - - -4. 下面 **结果** 栏会顺序显示查询结果,如果有多条查询语句,每条查询语句对应一个结果栏。![](https://cdn.nlark.com/yuque/0/2020/png/177325/1600310020517-1f4570ae-b378-4c75-b9f7-fb3deefdaf5e.png?x-oss-process=image%2Fresize%2Cw_1500)​ - - - - - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/3.you-can-call-this-operation-to-query-the-data-that-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/3.you-can-call-this-operation-to-query-the-data-that-1.md deleted file mode 100644 index 5f4c86ea3..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/3.you-can-call-this-operation-to-query-the-data-that-1.md +++ /dev/null @@ -1,38 +0,0 @@ -查询表里符合特定搜索条件的数据 -==================================== - - - -当要查询满足特定搜索条件的数据时,给 SELECT 查询语句增加一个 WHERE 子句即可。SQL 语句格式如下: - -```javascript -SELECT select_list FROM table_list -WHERE query_condition -``` - - - -以"在 ODC 中运行查询"页面的图为例,查询 2 号仓库第 5 区的订单,SQL 语句如下: - -```javascript -SELECT * FROM ordr WHERE o_w_id=2 and o_d_id=5 ; -``` - - - -在 ODC 中的查询结果如下图所示:​![](https://cdn.nlark.com/yuque/0/2020/png/177325/1600321391023-212d9311-c76a-4e87-93c6-872dee97b8e9.png?x-oss-process=image%2Fresize%2Cw_1500)​ - -执行结果如下: - -```unknow -+--------+--------+------+--------+--------------+----------+-------------+------------+ -| o_w_id | o_d_id | o_id | o_c_id | o_carrier_id | o_ol_cnt | o_all_local | o_entry_d | -+--------+--------+------+--------+--------------+----------+-------------+------------+ -| 2 | 5 | 2100 | 2100 | 5 | 12 | 1 | 2020-02-15 | -| 2 | 5 | 2101 | 4 | NULL | 11 | 1 | 2020-02-15 | -| 2 | 5 | 2102 | 440 | NULL | 7 | 1 | 2020-02-15 | -+--------+--------+------+--------+--------------+----------+-------------+------------+ -3 rows in set (0.01 sec) -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/4.sort-the-results-of-the-query-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/4.sort-the-results-of-the-query-1.md deleted file mode 100644 index 22ce318f9..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/4.sort-the-results-of-the-query-1.md +++ /dev/null @@ -1,91 +0,0 @@ -对查询的结果进行排序 -=============================== - - - -查询结果返回的顺序可能是任意顺序,如果想要根据特定字段排序返回结果集,需要在 SELECT 语句最后面增加 ORDER BY 子句指定返回顺序。SQL 语句格式如下: - -```javascript -SELECT select_list FROM table_list -WHERE query_condition -ORDER BY column_list -``` - - - -如查看 2 号仓库第 5 区的客户,按姓名排序,SQL 语句如下: - -```javascript -SELECT c_id, c_last,c_first,c_middle, c_w_id, c_d_id, c_credit, c_since - FROM cust - WHERE c_w_id=2 AND c_d_id=5 - ORDER BY c_last, c_first; -``` - - - -在 ODC 中查询结果如下:​![](https://cdn.nlark.com/yuque/0/2020/png/177325/1600322284246-b1d44a8d-2532-414e-ab8d-93e40ee6a047.png?x-oss-process=image%2Fresize%2Cw_1500)​ - -执行结果如下: - -```unknow -+------+----------------+------------------+----------+--------+--------+----------+------------+ -| c_id | c_last | c_first | c_middle | c_w_id | c_d_id | c_credit | c_since | -+------+----------------+------------------+----------+--------+--------+----------+------------+ -| 202 | ABLEBAROUGHT | omHvv5eG | OE | 2 | 5 | GC | 2020-02-15 | -| 272 | ABLECALLYOUGHT | x0ikkFsuG | OE | 2 | 5 | GC | 2020-02-15 | -| 2106 | ABLECALLYPRI | Hksk96bvVRAZ | OE | 2 | 5 | GC | 2020-02-15 | -| 2813 | ABLEPRESEING | GxtYNqeRZFIaWmN | OE | 2 | 5 | GC | 2020-02-15 | -| 2360 | ANTIATIONATION | BcIWNvikBc | OE | 2 | 5 | GC | 2020-02-15 | -| 2500 | ANTIEINGCALLY | WXBmhcRTWe | OE | 2 | 5 | GC | 2020-02-15 | -| 658 | ANTIESECALLY | ONPLFp6Htl | OE | 2 | 5 | BC | 2020-02-15 | -| 1085 | ANTIOUGHTABLE | SstdwQNJJ | OE | 2 | 5 | GC | 2020-02-15 | -| 2247 | ANTIPRIOUGHT | R1VEFjdPlOioo | OE | 2 | 5 | GC | 2020-02-15 | -| 2100 | ATIONABLEESE | PzFg81YvfBC | OE | 2 | 5 | BC | 2020-02-15 | -| 2196 | ATIONATIONBAR | ReFiFtMxfo1qG5 | OE | 2 | 5 | GC | 2020-02-15 | -| 871 | ATIONCALLYBAR | W7ZNcPqp5sBWNi | OE | 2 | 5 | GC | 2020-02-15 | -| 2999 | ATIONCALLYPRI | eQbIWEimKcM80xNB | OE | 2 | 5 | GC | 2020-02-15 | -| 849 | ATIONPRESATION | Z6V2PdM8B0b9hQ8d | OE | 2 | 5 | GC | 2020-02-15 | -| 8 | BARBARCALLY | jXrw6CCdzcamEi | OE | 2 | 5 | GC | 2020-02-15 | -| 4 | BARBARPRI | KKvDumYX9AwHuxX | OE | 2 | 5 | GC | 2020-02-15 | -| 1983 | BAROUGHTANTI | XeYW3WKpfBITC1aB | OE | 2 | 5 | GC | 2020-02-15 | -| 1590 | BAROUGHTCALLY | Y886PI3rFsHCSMbF | OE | 2 | 5 | GC | 2020-02-15 | -| 1529 | BAROUGHTPRI | pyP6QQj7FB | OE | 2 | 5 | GC | 2020-02-15 | -| 34 | BARPRIPRI | gXmuxvj2R | OE | 2 | 5 | GC | 2020-02-15 | -| 1785 | CALLYABLEESE | LsWK1Zs1pm | OE | 2 | 5 | GC | 2020-02-15 | -| 2765 | CALLYABLEOUGHT | b0maEo4Nm2JgW2j | OE | 2 | 5 | GC | 2020-02-15 | -| 2102 | CALLYABLEOUGHT | wPS9EgAgztLRvSuZ | OE | 2 | 5 | GC | 2020-02-15 | -| 798 | CALLYEINGCALLY | Z9T8FivHqeaO | OE | 2 | 5 | GC | 2020-02-15 | -| 2793 | CALLYEINGOUGHT | eVQqIPDaGOb7N3EN | OE | 2 | 5 | GC | 2020-02-15 | -| 1370 | CALLYESEEING | J8Cakezt | OE | 2 | 5 | GC | 2020-02-15 | -| 2660 | CALLYPRESPRES | FgxeQplwu | OE | 2 | 5 | GC | 2020-02-15 | -| 2401 | CALLYPRIANTI | fJjIGGGH7Fdn1Kp | OE | 2 | 5 | BC | 2020-02-15 | -| 926 | EINGABLEESE | NZLtbu8Jb7Qi | OE | 2 | 5 | GC | 2020-02-15 | -| 2970 | EINGABLEOUGHT | PLnJDvKTwR0ireM | OE | 2 | 5 | GC | 2020-02-15 | -| 2137 | EINGANTIEING | bDPeSSyD7 | OE | 2 | 5 | GC | 2020-02-15 | -| 1334 | EINGBAREING | ep86qqrvFlD | OE | 2 | 5 | GC | 2020-02-15 | -| 993 | EINGEINGABLE | mxu2u3eo | OE | 2 | 5 | GC | 2020-02-15 | -| 956 | EINGESEESE | q02t2c9oR7 | OE | 2 | 5 | GC | 2020-02-15 | -| 916 | EINGOUGHTESE | ungAvrh8dWoGlQlP | OE | 2 | 5 | GC | 2020-02-15 | -| 569 | ESEANTIATION | xIZPuIwBJXxVIER | OE | 2 | 5 | GC | 2020-02-15 | -| 1433 | ESEBARESE | jpTpJk5diH | OE | 2 | 5 | GC | 2020-02-15 | -| 2405 | ESEBARESE | ZXKb7eR96iGg | OE | 2 | 5 | GC | 2020-02-15 | -| 2101 | ESEPRESATION | DQUk9dys | OE | 2 | 5 | GC | 2020-02-15 | -| 2348 | OUGHTCALLYANTI | w0rDw8txdIPfeElQ | OE | 2 | 5 | GC | 2020-02-15 | -| 1093 | OUGHTCALLYESE | GBx3akVCEuTPLa | OE | 2 | 5 | BC | 2020-02-15 | -| 193 | OUGHTEINGABLE | ImIEJkCzrYtEpaV4 | OE | 2 | 5 | GC | 2020-02-15 | -| 1318 | PRESATIONEING | uT4TGkIdWf | OE | 2 | 5 | GC | 2020-02-15 | -| 1813 | PRESATIONESE | SsF8v3NE | OE | 2 | 5 | GC | 2020-02-15 | -| 1991 | PRESESEANTI | GhytcH1EQhY | OE | 2 | 5 | GC | 2020-02-15 | -| 414 | PRESOUGHTPRI | vTsmW2XU | OE | 2 | 5 | GC | 2020-02-15 | -| 1979 | PRESPRESANTI | GGsWcgaTLXjtXAN | OE | 2 | 5 | GC | 2020-02-15 | -| 1184 | PRESPRESEING | hs5Bd47ZlZghuD8 | OE | 2 | 5 | GC | 2020-02-15 | -| 440 | PRESPRIEING | O4Vjdc3hmk4DT | OE | 2 | 5 | GC | 2020-02-15 | -| 1766 | PRIABLEEING | hqPJlwGx6Qt0FXy | OE | 2 | 5 | GC | 2020-02-15 | -| 372 | PRICALLYOUGHT | HpbvP0rDZM3 | OE | 2 | 5 | GC | 2020-02-15 | -| 356 | PRIESEESE | lZlbGnZhIlYH6nP | OE | 2 | 5 | GC | 2020-02-15 | -+------+----------------+------------------+----------+--------+--------+----------+------------+ -52 rows in set (0.01 sec) -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/5.query-data-from-multiple-tables-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/5.query-data-from-multiple-tables-1.md deleted file mode 100644 index 41517f1c6..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/5.query-data-from-multiple-tables-1.md +++ /dev/null @@ -1,92 +0,0 @@ -从多个表里查询数据 -============================== - - - -如果要查询的数据需要从多个表中取时,需要在 SELECT 语句中 FROM 关键字后用 JOIN... ON 将多个表关联起来查询。通常这多个表在业务上是有联系的,如某些字段值的定义和数据相同,这个联系条件就是连接条件,会体现在 ON 后面的括号里,ON 里也可以包括过滤条件。SQL 语法格式如下: - -```javascript -SELECT select_list FROM table_name1 [INNER] JOIN table_name2 ON ( join_condition ) -WHERE query_condition -ORDER BY column_list -``` - - - - - -返回满足连接条件的多个表数据 ------------------------ - -默认 JOIN 返回的结果会满足 ON 后面的连接条件,这个又叫内连接(INNER JOIN),通常关键字 INNER 省略了就表示内连接。JOIN 前后的表分别称之为左表和右表,ON 里的条件描述的是左表和右表的连接条件和过滤条件。如果没有ON 子句,那 INNER JOIN 返回的就是左表和右表的全部数据,这个也称为笛卡儿积。 - -SQL 返回的结果会在 JOIN 结果上再经过 WHERE 后的查询条件过滤以及根据 ORDER BY 后的列排序。 - -**示例:** **使用** **JOIN从多个表里查询数据** - -```javascript -obclient> create table t1(id number not null primary key, name varchar(50)); -Query OK, 0 rows affected (0.08 sec) - -obclient> create table t2(id number not null primary key, name varchar(50)); -Query OK, 0 rows affected (0.06 sec) - -obclient> insert into t1 values(1,'A1'),(2,'B1'),(4,'D1'),(6,'F1'),(8,'H1'),(10,'J1'); -Query OK, 6 rows affected (0.01 sec) -Records: 6 Duplicates: 0 Warnings: 0 - -obclient> insert into t2 values(1,'B2'),(3,'C2'),(6,'F2'),(9,'I2'); -Query OK, 4 rows affected (0.01 sec) -Records: 4 Duplicates: 0 Warnings: 0 - -obclient> select t1.id, t1.name, t2.id, t2.name from t1 join t2 on (t1.id=t2.id) ; -+----+------+----+------+ -| ID | NAME | ID | NAME | -+----+------+----+------+ -| 1 | A1 | 1 | B2 | -| 6 | F1 | 6 | F2 | -+----+------+----+------+ -2 rows in set (0.01 sec) -``` - - - - - -返回包含不满足连续条件的多个表数据 --------------------------- - -当需要 JOIN 返回的数据除了符合连接条件和过滤条件的数据外,还包括左表里满足左表的过滤条件但不满足连接条件的数据时,就可以使用左外连接(LEFT OUTER JOIN),也可以简写为左连接(LEFT JOIN)。左连接返回的结果里属于右表的数据如果不存在,则该列返回 NULL。 - -反之,如果 JOIN 返回的数据除了符合连接条件和过滤条件的数据外,还包括右表里满足右表的过滤条件但不满足连接条件的数据时,就可以使用右外连接(RIGHT OUTER JOIN),或简写为右连接(RIGHT JOIN)。右连接返回的结果里属于左表的数据如果不存在,则该列返回 NULL。 - -**示例:LEFT JOIN和RIGHT JOIN示例** - -```javascript -obclient> select t1.id, t1.name, t2.id, t2.name from t1 left join t2 on (t1.id=t2.id) ; -+----+------+----+------+ -| ID | NAME | ID | NAME | -+----+------+----+------+ -| 1 | A1 | 1 | B2 | -| 2 | B1 | NULL | NULL | -| 4 | D1 | NULL | NULL | -| 6 | F1 | 6 | F2 | -| 8 | H1 | NULL | NULL | -| 10 | J1 | NULL | NULL | -+----+------+----+------+ -6 rows in set (0.01 sec) - -obclient> select t1.id, t1.name, t2.id, t2.name from t1 right join t2 on (t1.id=t2.id) ; -+----+------+----+------+ -| ID | NAME | ID | NAME | -+----+------+----+------+ -| 1 | A1 | 1 | B2 | -| NULL | NULL | 3 | C2 | -| 6 | F1 | 6 | F2 | -| NULL | NULL | 9 | I2 | -+----+------+----+------+ -4 rows in set (0.00 sec) -``` - - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/1.use-arithmetic-operators-in-queries-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/1.use-arithmetic-operators-in-queries-1.md deleted file mode 100644 index 13f327d9c..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/1.use-arithmetic-operators-in-queries-1.md +++ /dev/null @@ -1,40 +0,0 @@ -查询中使用算术操作符 -=============================== - - - -算术操作符包括:+(加)、-(减)、\*(乘)、/(除)、-(取反)、MOD(取模)。这些操作符可以作用在数值列上。 - -如"从多个表里查询数据" 页面的示例查询出客户购买的每个商品的数量和价格,其中数量乘以价格就是每类商品的支付总额。所以 select_list 可以增加一列 t3.ol_quantity \* t4.i_price item_sum_price 。 - -```javascript - sql" commentTypeId="39" timestamp="2021-04-30T16:37:00+08:00" authorId="11968" uuid="860ac150-5fa4-47e5-96af-b84a3dd922ea" id="comment-bzn-ufo-zt2">SELECT t1.c_first, t1.c_last, t1.c_credit, t2.o_ol_cnt, t2.o_entry_d, t3.ol_number, t3.ol_quantity, t4.i_name, t4.i_price, t3.ol_quantity * t4.i_price item_sum_price -FROM cust t1 - JOIN ordr t2 ON (t1.c_id=t2.o_id AND t1.c_w_id=t2.o_w_id AND t1.c_d_id=t2.o_d_id) - JOIN ordl t3 ON (t2.o_id=t3.ol_o_id AND t2.o_w_id=t3.ol_w_id AND t2.o_d_id=t3.ol_d_id) - JOIN item t4 ON (t4.i_id=t3.ol_i_id ) -WHERE t1.c_w_id=2 AND t1.c_d_id=5 and t1.c_last LIKE 'CALLY%' -ORDER BY t1.c_id, t2.o_id, t3.ol_number -; -``` - - - -查询结果如下: - -```unknow -+------------------+----------------+----------+----------+------------+-----------+-------------+--------------------------+---------+----------------+ -| c_first | c_last | c_credit | o_ol_cnt | o_entry_d | ol_number | ol_quantity | i_name | i_price | item_sum_price | -+------------------+----------------+----------+----------+------------+-----------+-------------+--------------------------+---------+----------------+ -| wPS9EgAgztLRvSuZ | CALLYABLEOUGHT | GC | 7 | 2020-02-15 | 1 | 5 | FJT8fkxaUh2aUbI | 79.95 | 399.75 | -| wPS9EgAgztLRvSuZ | CALLYABLEOUGHT | GC | 7 | 2020-02-15 | 2 | 5 | kiMk43vd9HidvmwG8x | 58.59 | 292.95 | -| wPS9EgAgztLRvSuZ | CALLYABLEOUGHT | GC | 7 | 2020-02-15 | 3 | 5 | JnJEOLUCjunrKkt4Z1pL | 85.26 | 426.30 | -| wPS9EgAgztLRvSuZ | CALLYABLEOUGHT | GC | 7 | 2020-02-15 | 4 | 5 | CrFVAZW3OhyekdDNc2rPH | 22.30 | 111.50 | -| wPS9EgAgztLRvSuZ | CALLYABLEOUGHT | GC | 7 | 2020-02-15 | 5 | 5 | fJpsyG11EjWIceJWaB | 41.39 | 206.95 | -| wPS9EgAgztLRvSuZ | CALLYABLEOUGHT | GC | 7 | 2020-02-15 | 6 | 5 | shseF8WI1VSPbWfswSsIuNC | 30.04 | 150.20 | -| wPS9EgAgztLRvSuZ | CALLYABLEOUGHT | GC | 7 | 2020-02-15 | 7 | 5 | prjdpUDOxRvAn5WiMVoT85B1 | 18.55 | 92.75 | -+------------------+----------------+----------+----------+------------+-----------+-------------+--------------------------+---------+----------------+ -7 rows in set (0.01 sec) -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/10.use-the-decode-function-in-the-query.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/10.use-the-decode-function-in-the-query.md deleted file mode 100644 index 402c8a4c4..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/10.use-the-decode-function-in-the-query.md +++ /dev/null @@ -1,26 +0,0 @@ -查询中使用 Decode 函数 -==================================== - - - -Decode 函数可以将一个表达式跟多个搜索条件进行比较。当某个搜索条件得到满足时,就返回相应的结果;如果所有搜索条件都不满足,就返回默认值(如果定义了)或者NULL(未定义默认值)。Decode 表达式的作用跟CASE 表达式类似。 - -**示例:查询中使用 Decode 函数** - -```javascript -obclient> SELECT id, abbr, decode(abbr, 'US','America', 'UK', 'English', 'CN', 'China', 'UNKOWN') full_name - FROM t_case; -+----+------+-----------+ -| ID | ABBR | FULL_NAME | -+----+------+-----------+ -| 1 | US | America | -| 2 | UK | English | -| 3 | CN | China | -| 4 | JP | UNKOWN | -+----+------+-----------+ -4 rows in set (0.00 sec) - -obclient> -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/11.use-complex-analysis-functions-in-queries.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/11.use-complex-analysis-functions-in-queries.md deleted file mode 100644 index 90f400f59..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/11.use-complex-analysis-functions-in-queries.md +++ /dev/null @@ -1,99 +0,0 @@ -查询中使用复杂的分析函数 -================================= - - - -OceanBase Oracle 租户支持一些复杂的分析函数,分析函数通常用于计算累积、移动、居中和报告汇总。OceanBase Oracle 租户支持的分析函数如下表所示: - - -| **函数名** | **功能描述** | -|-----------------|-------------------| -| AVG | 求平均 | -| SUM | 求和 | -| MAX | 求最大 | -| MIN | 求最小 | -| COUNT | 计数 | -| CUME_DIST | 求累积分布 | -| RANK | 求排名(不连续) | -| DENSE_RANK | 求行组中行的秩 | -| PEERCENT_RANK | 求累积分布值(百分比) | -| FIRST_VALUE | 求有序值中第一个值 | -| LAST_VALUE | 求有序值中最后一个值 | -| LAG | | -| LEAD | 对一组行的集合进行计算并返回多个值 | -| LISTAGG | 列转行 | -| NTH_VALUE | 求窗口中第N行满足表达式的值 | -| NTILE | 对序号进行分组处理 | -| RATIO_TO_REPORT | 计算一个值与一组值之和的比率 | -| ROW_NUMBER | 为每一行分配一个不重复的数字 | -| STDDEV | 求总体标准差 | -| STDDEV_POP | 求总体标准差 | -| STDDEV_SAMP | 求样本标准差 | -| VARIANCE | 求指定参数列的方差 | - - - - - -复杂的分析函数语法格式简单描述如下: - -```javascript -analytic_function ( [ arguments ] ) -OVER -( - [ - PARTITION BY { expr [, expr] ... } - [ -ORDER [ SIBLINGS ] BY - { expr | position | c_alias } - [ ASC | DESC ] - [ NULLS FIRST | NULLS LAST ] - [, { expr | position | c_alias } - [ ASC | DESC ] - [ NULLS FIRST | NULLS LAST ] - ] ... - - [ - { ROWS | RANGE } -{ BETWEEN - { UNBOUNDED PRECEDING | CURRENT ROW | value_expr -{ PRECEDING | FOLLOWING } -} AND -{ UNBOUNDED FOLLOWING | CURRENT ROW | value_expr { PRECEDING | FOLLOWING } -} -| -{ UNBOUNDED PRECEDING | CURRENT ROW| value_expr PRECEDING -} -} -] -]  - ) -``` - - - - - -**示例:用分析函数查询** - -```javascript -SELECT * FROM ( - SELECT o_w_id, o_d_id, o_ol_cnt, o_entry_d, rank() OVER (PARTITION BY o_w_id order BY o_entry_d) entry_order - FROM ordr - ORDER BY o_w_id , entry_order -) WHERE entry_order <=5; - - -SELECT * FROM ( - SELECT o_w_id, o_d_id, o_ol_cnt, o_entry_d, dense_rank() OVER (PARTITION BY o_w_id order BY o_entry_d) entry_order - FROM ordr - ORDER BY o_w_id , entry_order -) WHERE entry_order <=5; - - -SELECT o_w_id, o_d_id, o_ol_cnt, o_entry_d, first_value(o_c_id) OVER (PARTITION BY o_w_id order BY o_entry_d) first_cid - FROM ordr - ORDER BY o_w_id ; -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/2.use-numeric-functions-in-queries-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/2.use-numeric-functions-in-queries-1.md deleted file mode 100644 index 74abbcfcb..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/2.use-numeric-functions-in-queries-1.md +++ /dev/null @@ -1,48 +0,0 @@ -查询中使用数值函数 -============================== - - - -常用数值函数有:sum(求和)、avg(求平均)、ceil(向上取整)、floor(向下取整)、trunc(数值取整)、round(n)(四舍五入保留n位小数)。 - -如求历史表中每个仓库和区域的总销售额和平均每单销售额,SQL 如下: - -```javascript -SELECT h_w_id, h_d_id, sum(h_amount) sum_h_amount , avg(h_amount) avg_h_amount -FROM hist -GROUP BY h_w_id, h_d_id ; -``` - - - -查询结果如下:​![](https://cdn.nlark.com/yuque/0/2020/png/177325/1600322751147-f4c62008-34ca-45b9-ba40-92fb2d44ceba.png?x-oss-process=image%2Fresize%2Cw_1500)​ - -```unknow -​+--------+--------+--------------+--------------+ -| h_w_id | h_d_id | sum_h_amount | avg_h_amount | -+--------+--------+--------------+--------------+ -| 1 | 1 | 120.00 | 10.000000 | -| 1 | 2 | 120.00 | 10.000000 | -| 1 | 3 | 120.00 | 10.000000 | -| 1 | 4 | 120.00 | 10.000000 | -| 1 | 5 | 120.00 | 10.000000 | -| 1 | 6 | 120.00 | 10.000000 | -| 1 | 7 | 120.00 | 10.000000 | -| 1 | 8 | 120.00 | 10.000000 | -| 1 | 9 | 120.00 | 10.000000 | -| 1 | 10 | 120.00 | 10.000000 | -| 2 | 1 | 120.00 | 10.000000 | -| 2 | 2 | 120.00 | 10.000000 | -| 2 | 3 | 120.00 | 10.000000 | -| 2 | 4 | 120.00 | 10.000000 | -| 2 | 5 | 120.00 | 10.000000 | -| 2 | 6 | 120.00 | 10.000000 | -| 2 | 7 | 120.00 | 10.000000 | -| 2 | 8 | 120.00 | 10.000000 | -| 2 | 9 | 120.00 | 10.000000 | -| 2 | 10 | 120.00 | 10.000000 | -+--------+--------+--------------+--------------+ -20 rows in set (0.01 sec) -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/3.use-a-string-connector-in-a-query-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/3.use-a-string-connector-in-a-query-1.md deleted file mode 100644 index 093c009f3..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/3.use-a-string-connector-in-a-query-1.md +++ /dev/null @@ -1,15 +0,0 @@ -查询中使用字符串连接符 -================================ - - - -字符串连接符,Oracle 租户通常使用 \`\|\|\` 作为字符串连接符。 - -如查看 Oracle 租户下的客户姓名,SQL 语句如下: - -```javascript -SELECT c_first || ' ' || c_last full_name FROM cust ORDER BY c_last; -``` - - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/4.use-string-functions-in-queries-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/4.use-string-functions-in-queries-1.md deleted file mode 100644 index 641a6961f..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/4.use-string-functions-in-queries-1.md +++ /dev/null @@ -1,30 +0,0 @@ -查询中使用字符串函数 -=============================== - - - -常用的字符串函数有求字符串长度(length)、字符串截取(substr)、字符串拼接、 字符串转大小写(upper lower)、字符串删除前后缀(ltrim rtrim trim)。 - -需要注意的是,在 Oracle 租户里,字符串长度函数(length)长度单位是字符,length 的字符串长度单位是字节,并且跟字符集有关。如求汉字'中'的字符串长度: - -```javascript -$obclient -h192.168.1.101 -utpcc@obbmsql#obdemo -P2883 -p123456 -c -A tpcc - -obclient> select length('中'), lengthb('中') from dual; -+---------------+----------------+ -| LENGTH('中') | LENGTHB('中') | -+---------------+----------------+ -| 1 | 3 | -+---------------+----------------+ -1 row in set (0.00 sec) - -obclient> select * from sys.nls_database_parameters where parameter='NLS_CHARACTERSET'; -+------------------+----------+ -| PARAMETER | VALUE | -+------------------+----------+ -| NLS_CHARACTERSET | AL32UTF8 | -+------------------+----------+ -1 row in set (0.01 sec) -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/5.use-time-functions-in-queries-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/5.use-time-functions-in-queries-1.md deleted file mode 100644 index c6cfc615f..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/5.use-time-functions-in-queries-1.md +++ /dev/null @@ -1,115 +0,0 @@ -查询中使用时间函数 -============================== - - - -Oracle 租户常用的时间类型有 date 和 timestamp、 interval 等,更多时间类型用法,请参考《OceanBase SQL参考(Oracle模式)》。 - -Oracle 租户常用的取数据库时间函数是 sysdate 和 systimestamp ,二者默认展现格式由参数 NLS_DATE_FORMAT 和 NLS_TIMESTAMP_FORMAT 确定。针对 interval 类型的时间函数有 numtodsinterval , numtoyminterval ,可以在数字和 interval 类型之间转换。 - -* 示例:格式化时间显示 - - - - -Oracle 租户调整时间类型显示的格式,可以用 to_char 函数,SQL 如下: - -```javascript -obclient> select sysdate, to_char(sysdate,'YYYY/MM/DD HH24:MI:SS') new_date from dual; -+-----------+---------------------+ -| SYSDATE | NEW_DATE | -+-----------+---------------------+ -| 01-APR-20 | 2020/04/01 22:17:07 | -+-----------+---------------------+ -1 row in set (0.00 sec) -``` - - - -* 示例:提取时间中的年/月/日/时/分/秒 - - - - -Orale 租户从时间中提取年/月/日/时/分/秒,可以用 to_char 函数,SQL如下: - -```javascript -SELECT sysdate - , to_char(sysdate,'yyyy') d_year - , to_char(sysdate,'mm') d_month - , to_char(sysdate,'dd') d_day - , to_char(sysdate,'hh24') d_hour24 - , to_char(sysdate,'mi') d_min - ,to_char(sysdate,'ss') d_sec -FROM dual; - -+-----------+--------+---------+-------+----------+-------+-------+ -| SYSDATE | D_YEAR | D_MONTH | D_DAY | D_HOUR24 | D_MIN | D_SEC | -+-----------+--------+---------+-------+----------+-------+-------+ -| 01-APR-20 | 2020 | 04 | 01 | 22 | 17 | 24 | -+-----------+--------+---------+-------+----------+-------+-------+ -1 row in set (0.00 sec) -``` - - - -* 示例:时间类型加减 - - - - -Oracle 租户对时间进行加减,可以直接加减(单位是天),也可以借助函数 NUMTODSINTERVAL **、** add_months 函数。 - -```javascript -SELECT sysdate - , sysdate+1 t0 - , sysdate + numtodsinterval(1,'hour') t1 - , sysdate + numtodsinterval(1,'minute') t2 - , sysdate + numtodsinterval(1,'second') t3 - , add_months(sysdate, 1) t4 - , add_months(sysdate, -1) t5 -FROM dual\G - -*************************** 1. row *************************** -SYSDATE: 2020-03-27 17:59:40 - T0: 2020-03-28 17:59:40 - T1: 2020-03-27 18:59:40 - T2: 2020-03-27 18:00:40 - T3: 2020-03-27 17:59:41 - T4: 2020-04-27 17:59:40 - T5: 2020-02-27 17:59:40 -1 row in set (0.01 sec) - -obclient> -``` - - - -* 示例:interval 相关的时间函数 - - - - -```javascript -select sysdate, systimestamp - ,numtoyminterval(100,'YEAR') interval_year - ,numtoyminterval(100,'MONTH') interval_mon - ,numtodsinterval(100,'DAY') interval_day - ,numtodsinterval(100,'HOUR') interval_hour - ,numtodsinterval(100,'MINUTE') interval_min - ,numtodsinterval(100,'SECOND') interval_sec -from dual \G - -*************************** 1. row *************************** - SYSDATE: 2020-04-06 08:34:50 - SYSTIMESTAMP: 2020-04-06 08:34:50.434602 +08:00 -INTERVAL_YEAR: +000000100-00 - INTERVAL_MON: +000000008-04 - INTERVAL_DAY: +000000100 00:00:00.000000000 -INTERVAL_HOUR: +000000004 04:00:00.000000000 - INTERVAL_MIN: +000000000 01:40:00.000000000 - INTERVAL_SEC: +000000000 00:01:40.000000000 -1 row in set (0.01 sec) -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/6.use-type-conversion-functions-in-queries-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/6.use-type-conversion-functions-in-queries-1.md deleted file mode 100644 index 927ac133c..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/6.use-type-conversion-functions-in-queries-1.md +++ /dev/null @@ -1,55 +0,0 @@ -查询中使用类型转换函数 -================================ - - - -类型转换函数可以将一种数据类型转换为另外一种数据类型,如数值类型和时间类型到字符串类型的相互转换。 - -* 示例:时间字符串转换为时间类型 - - Oracle 租户中,时间字符串可以通过函数 to_date 转换为时间类型,to_date 的第二个参数表示时间的格式,必须跟实际时间制匹配。SQL语句如下: - - - - - -```javascript -SELECT to_date('Feb 20, 2020', 'Mon dd, YYYY') t1 - , to_date('18:30:45', 'HH24:MI:SS') t2 - , to_date('2020/11/11 00:30:00', 'YYYY/MM/DD HH24:MI:SS') t3 -FROM dual \G - -*************************** 1. row *************************** -T1: 2020-02-20 00:00:00 -T2: 2020-03-01 18:30:45 -T3: 2020-11-11 00:30:00 -1 row in set (0.00 sec) -``` - - - -Oracle 租户中时间类型转换为字符串类型,可以使用函数 to_char。 - - - -* 示例:数值类型和字符串类型互相转换 - - Oracle 租户中,数值类型转换为字符串类型,可以用函数 to_char ,可以指定转换格式。字符串类型转换为数值类型,可以使用函数 to_number 。 - - - - - -```javascript -SELECT to_number('3.14') n1, to_number('-3.14') n2, to_char(3.14159,'99.99') c1 -FROM DUAL; - -+------+-------+--------+ -| N1 | N2 | C1 | -+------+-------+--------+ -| 3.14 | -3.14 | 3.14 | -+------+-------+--------+ -1 row in set (0.01 sec) -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/7.use-aggregate-functions-in-queries-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/7.use-aggregate-functions-in-queries-1.md deleted file mode 100644 index 85ba7a376..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/7.use-aggregate-functions-in-queries-1.md +++ /dev/null @@ -1,46 +0,0 @@ -查询中使用聚合函数 -============================== - - - -聚合函数扫描一组记录,然后返回单行记录。这组记录可以是一个表或者视图、或者一个子查询的结果。OceanBase 支持的聚合函数详情请参考《OceanBase SQL参考(Oracle模式)》。 - -聚合函数通常跟 GROUP BY 子句一起使用,按照一个或多个列的值分组,然后每组返回单笔记录。 - -**示例:分组统计每个仓库的销售额** - -Oracle 租户中,聚合函数跟 GROUP BY 子句一起使用时,select_list 中需要严格包含 GROUP BY 后面的列;否则会报错。SQL查询如下: - -```javascript -SELECT ol_w_id - , count(*) order_count - , sum(ol_amount) sum_amount - , round(avg(ol_amount),2) avg_amount - , min(ol_amount) min_amount - ,max(ol_amount) max_amount -FROM ordl -GROUP BY ol_w_id ORDER BY ol_w_id ; - -+---------+-------------+------------+------------+------------+------------+ -| OL_W_ID | ORDER_COUNT | SUM_AMOUNT | AVG_AMOUNT | MIN_AMOUNT | MAX_AMOUNT | -+---------+-------------+------------+------------+------------+------------+ -| 1 | 297 | 917174.33 | 3088.13 | 0 | 9876.11 | -| 2 | 329 | 1153354.23 | 3505.64 | 0 | 9979.34 | -+---------+-------------+------------+------------+------------+------------+ -2 rows in set (0.01 sec) - -SELECT ol_w_id, ol_d_id - , count(*) order_count - , sum(ol_amount) sum_amount - , round(avg(ol_amount),2) avg_amount - , min(ol_amount) min_amount - ,max(ol_amount) max_amount -FROM ordl -GROUP BY ol_w_id -ORDER BY ol_w_id; - -ERROR-00979: 'TPCC.ORDL.OL_D_ID' not a GROUP BY expression -obclient> -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/8.use-null-related-functions-in-queries-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/8.use-null-related-functions-in-queries-1.md deleted file mode 100644 index bfa0d81fb..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/8.use-null-related-functions-in-queries-1.md +++ /dev/null @@ -1,32 +0,0 @@ -查询中使用 NULL 相关函数 -==================================== - - - -NULL 相关的函数用于处理 NULL 值。NULL 值的特点是任何数值都不能等于 NULL 或不等于 NULL,可以通过 IS NULL 判断,也可以使用 NVL 函数将 NULL 值转换为可识别的字符串。下面示例如何识别和转换 NULL 值。 - -**示例:NULL 值转换** - -Oracle 租户中,如果一个列可能有 NULL 值,可以使用 NVL 或 NVL2 函数探测并转换为特殊字符。SQL 查询如下:​![](https://cdn.nlark.com/yuque/0/2020/png/177325/1600417223665-f6b58f25-69f9-472a-8e87-72fbaa8cec86.png?x-oss-process=image%2Fresize%2Cw_1500) - -```unknow -obclient> CREATE TABLE t_null(id number NOT NULL PRIMARY KEY, name varchar(10)); -Query OK, 0 rows affected (0.09 sec) - -obclient> INSERT INTO t_null(id, name) values(1,'A'), (2,NULL), (3,'NULL'); -Query OK, 3 rows affected (0.18 sec) -Records: 3 Duplicates: 0 Warnings: 0 - -obclient> SELECT id, name, nvl(name, 'NOT APPLICABLE') n_name, nvl2(name, 'NOT NULL', 'NOT APPLICABLE') n2_name - -> FROM t_null; -+----+------+----------------+----------------+ -| ID | NAME | N_NAME | N2_NAME | -+----+------+----------------+----------------+ -| 1 | A | A | NOT NULL | -| 2 | NULL | NOT APPLICABLE | NOT APPLICABLE | -| 3 | NULL | NULL | NOT NULL | -+----+------+----------------+----------------+ -3 rows in set (0.03 sec) -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/9.use-the-case-function-in-a-query-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/9.use-the-case-function-in-a-query-1.md deleted file mode 100644 index e4917d063..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/6.use-operators-and-functions-in-queries-1/9.use-the-case-function-in-a-query-1.md +++ /dev/null @@ -1,92 +0,0 @@ -查询中使用 CASE 函数 -================================== - - - -CASE 表达式可以实现类似"IF...ELSE...THEN"的逻辑而不用调用子程序。CASE 表达式有两种使用方法,简单的和带搜索条件的。 - -* 示例:在查询中使用简单的 CASE 表达式,将国家代码缩写翻译为全称。 - - - - -```javascript -obclient> CREATE TABLE t_case(id number NOT NULL PRIMARY KEY, abbr varchar(5)); -Query OK, 0 rows affected (0.06 sec) - -obclient> INSERT INTO t_case(id, abbr) VALUES (1,'US'),(2,'UK'),(3,'CN'),(4,'JP'); -Query OK, 4 rows affected (0.03 sec) -Records: 4 Duplicates: 0 Warnings: 0 - -obclient> -obclient> SELECT id, abbr, - CASE abbr - WHEN 'US' THEN 'America' - WHEN 'UK' THEN 'English' - WHEN 'CN' THEN 'China' - ELSE 'UNKOWN' - END full_name - FROM t_case ; -+----+------+-----------+ -| ID | ABBR | FULL_NAME | -+----+------+-----------+ -| 1 | US | America | -| 2 | UK | English | -| 3 | CN | China | -| 4 | JP | UNKOWN | -+----+------+-----------+ -4 rows in set (0.00 sec) - -obclient> -``` - - - - - -* 示例:在查询中使用带搜索条件的 CASE 表达式 - - - - -```javascript -obclient> CREATE TABLE t_case2(id number NOT NULL PRIMARY KEY, c_date date ); -Query OK, 0 rows affected (0.07 sec) - -obclient> INSERT INTO t_case2(id,c_date) -VALUES (1,to_date('2019-03-01','yyyy-mm-dd')) - ,(2,to_date('2019-05-08','yyyy-mm-dd')) - ,(3,to_date('2019-07-07','yyyy-mm-dd')) - ,(4,to_date('2019-10-11','yyyy-mm-dd')) - ,(5,to_date('2019-12-12','yyyy-mm-dd')) - ,(6,to_date('2020-01-05','yyyy-mm-dd')); -Query OK, 6 rows affected (0.01 sec) -Records: 6 Duplicates: 0 Warnings: 0 - -obclient> SELECT id, c_date, - CASE - WHEN months_between(sysdate, c_date) > 12 THEN 'More than one year ago' - WHEN months_between(sysdate, c_date) > 9 THEN 'More than three quarters ago' - WHEN months_between(sysdate, c_date) > 6 THEN 'More than half a year ago' - WHEN months_between(sysdate, c_date) > 3 THEN 'More than a quarter ago' - WHEN months_between(sysdate, c_date) >= 0 THEN 'Within a quarter' - ELSE 'Illegal' - END "Duration" - FROM t_case2; - -+----+-----------+------------------------------+ -| ID | C_DATE | Duration | -+----+-----------+------------------------------+ -| 1 | 01-MAR-19 | More than one year ago | -| 2 | 08-MAY-19 | More than three quarters ago | -| 3 | 07-JUL-19 | More than half a year ago | -| 4 | 11-OCT-19 | More than a quarter ago | -| 5 | 12-DEC-19 | More than a quarter ago | -| 6 | 05-JAN-20 | Within a quarter | -+----+-----------+------------------------------+ -6 rows in set (0.00 sec) - -obclient> -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/7.view-the-query-execution-plan-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/7.view-the-query-execution-plan-1.md deleted file mode 100644 index 9e694e3f1..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/7.view-the-query-execution-plan-1.md +++ /dev/null @@ -1,48 +0,0 @@ -查看查询执行计划 -============================= - - - -OceanBase 的 SQL 引擎支持执行计划解析和缓存技术,可以通过分析查询语句的执行计划来分析查询性能。执行计划查看的语法格式如下: - -```javascript -explain query_statment ; -``` - - - - - -**示例:查看查询执行计划** - -```javascript -obclient> EXPLAIN select count(*) from stok \G -*************************** 1. row *************************** -Query Plan: ======================================================== -|ID|OPERATOR |NAME |EST. ROWS|COST | --------------------------------------------------------- -|0 |SCALAR GROUP BY | |1 |600337| -|1 | PX COORDINATOR | |1 |485729| -|2 | EXCHANGE OUT DISTR |:EX10000|1 |485729| -|3 | MERGE GROUP BY | |1 |485729| -|4 | PX PARTITION ITERATOR| |600000 |371122| -|5 | TABLE SCAN |stok |600000 |371122| -======================================================== - -Outputs & filters: -------------------------------------- - 0 - output([T_FUN_COUNT_SUM(T_FUN_COUNT(*))]), filter(nil), - group(nil), agg_func([T_FUN_COUNT_SUM(T_FUN_COUNT(*))]) - 1 - output([T_FUN_COUNT(*)]), filter(nil) - 2 - output([T_FUN_COUNT(*)]), filter(nil), dop=1 - 3 - output([T_FUN_COUNT(*)]), filter(nil), - group(nil), agg_func([T_FUN_COUNT(*)]) - 4 - output([stok.s_i_id]), filter(nil) - 5 - output([stok.s_i_id]), filter(nil), - access([stok.s_i_id]), partitions(p[0-5]) - -1 row in set (0.01 sec) -``` - - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/8.use-sql-hints-in-queries-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/8.use-sql-hints-in-queries-1.md deleted file mode 100644 index cdea56995..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/8.use-sql-hints-in-queries-1.md +++ /dev/null @@ -1,78 +0,0 @@ -在查询中使用 SQL Hint -==================================== - - - -初次使用 OceanBase 的用户,经常会用大表测试各种查询,有时会感觉性能不是很快,此时需要在查询中使用 SQL Hint。 - -关于 SQL Hint --------------------- - -OceanBase SQL 的执行性能跟 SQL 的执行计划有关,执行计划跟表的连接方式、查询条件和表的索引都有关系,通常这是数据库的 SQL 引擎内部逻辑。通过在 SQL 里添加注释,您可能改变执行计划的内容,从而改变 SQL 的执行性能。SQL Hint的格式是: - -```javascript -/*+ hint_text */ -``` - - - -常用 SQL Hint 有: - -* **read_consistency(weak)** :弱一致性读,指引SQL读取相关表的分区的备副本。 - -* **index** ( *table_name* , *index_name* ):指引SQL使用某个表的某个索引读取数据。 - -* **query_timeout(int_num):** 设置当前SQL的查询超时时间,单位是us。 - - - - -其他常用 SQL Hints请参考附录"OceanBase 常用 SQL Hints"。 - -使用 SQL Hint --------------------- - -SQL Hint 通常用在 SQL 里,并不限于查询 SQL。这里以查询 SQL 为例,简单的语法格式如下: - -```javascript -SELECT /*+ hint_text [, hint_text] */ select_items FROM table_name -``` - - - - -**注意** - - - -* 多个 SQL Hint可以叠加使用,注意功能不要冲突。 - - - -* 在 obclient 命令行环境下,默认会忽略注释语法,导致 SQL Hint 不起作用,所以启动 obclient 时需要增加参数"-c"。 - - - - - - - - -示例:在查询 SQL 中使用 SQL Hint,下面 SQL 指定查询超时时间为 10 秒。 - -```javascript -obclient> select /*+ query_timeout(10000000) */ o_id,o_c_id,o_carrier_id,o_ol_cnt,o_all_local,o_entry_d -from ordr partition (p5) -where o_w_id=1 and o_d_id=2 and o_id=2100; -+------+--------+--------------+----------+-------------+---------------------+ -| O_ID | O_C_ID | O_CARRIER_ID | O_OL_CNT | O_ALL_LOCAL | O_ENTRY_D | -+------+--------+--------------+----------+-------------+---------------------+ -| 2100 | 8 | 8 | 11 | 1 | 2020-02-15 18:57:10 | -+------+--------+--------------+----------+-------------+---------------------+ -1 row in set (0.01 sec) - -obclient> -obclient> SELECT /*+ parallel(16) */ count(*) FROM big_table ; -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/9.about-query-timeout-design-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/9.about-query-timeout-design-1.md deleted file mode 100644 index c0e2206d2..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/2.connect-to-the-oceanbase-database-1/6.query-table-data-1/9.about-query-timeout-design-1.md +++ /dev/null @@ -1,41 +0,0 @@ -关于查询超时设计 -============================= - - - -OceanBase 租户内部执行查询的工作线程数跟租户的 CPU 个数相关,所以工作线程是很稀有的资源。如果查询长时间不返回,就会一直占用这个工作线程资源。OceanBase 为避免长时间不返回的查询长期占用工作线程资源以及可能占用 CPU 资源,设计了查询超时功能。这个超时时间默认由租户变量 ob_query_timeout 控制,默认值是100000000(单位微秒)。当查询时间超过这个变量值后,会返回错误-4012(HY000): Timeout 。 - -默认的超时参数对于 OLTP 类业务来说是合理的,但是对于 OLAP 类业务就不一定。此时可以选择在会话级别调整租户变量的值,或者使用 SQL Hint 设置超时参数。 - -**示例:设置查询超时** - -```javascript -#obclient -h127.1 -utpcc@obbmsql#obdemo -P2883 -p123456 -c -A tpcc - -obclient> show variables like 'ob_query_timeout'; -+------------------+-----------+ -| VARIABLE_NAME | VALUE | -+------------------+-----------+ -| ob_query_timeout | 100000000 | -+------------------+-----------+ -1 row in set (0.00 sec) - -obclient> set session ob_query_timeout=1000000; -Query OK, 0 rows affected (0.00 sec) - -obclient> select count(*) from hist a, hist b , hist c; -ERROR-00600: internal error code, arguments: -4012, Timeout -obclient> -obclient> select /*+ query_timeout(100000000) */ count(*) from hist a, hist b , hist c; -+----------+ -| COUNT(*) | -+----------+ -| 13824000 | -+----------+ -1 row in set (3.34 sec) - -obclient> -``` - - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/3.about-dml-statements-and-transactions-1/1.about-dml-statements-1/1.dml-statement-overview-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/3.about-dml-statements-and-transactions-1/1.about-dml-statements-1/1.dml-statement-overview-1.md deleted file mode 100644 index 3c1952a92..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/3.about-dml-statements-and-transactions-1/1.about-dml-statements-1/1.dml-statement-overview-1.md +++ /dev/null @@ -1,27 +0,0 @@ -DML 语句概述 -============================= - - - -DML(Data Manipulation Language,数据操作语言)语句可以操作表中的数据,如增加、修改、删除等。 -**说明** - - - -* 在 obclient 命令行环境下,可以在"SQL 提示符(默认为 obclient)\>"后输入 DML 语句; - - - - - - - - -* 在 ODC 的 SQL 编辑器窗口,也可以输入 DML 语句。 - - - - - - -DML 语句对数据的修改效果只有在提交事务时才永久生效。一个事务是一序列被 OceanBase 数据库当作整体的多个 SQL 语句,要么全部执行成功,要么全部不成功。单个 DML 语句也可以是一个事务。事务在没有提交之前,还可以回滚事务。 diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/3.about-dml-statements-and-transactions-1/1.about-dml-statements-1/2.insert-statement-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/3.about-dml-statements-and-transactions-1/1.about-dml-statements-1/2.insert-statement-1.md deleted file mode 100644 index 0240945ca..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/3.about-dml-statements-and-transactions-1/1.about-dml-statements-1/2.insert-statement-1.md +++ /dev/null @@ -1,118 +0,0 @@ -关于 INSERT 语句 -================================= - - - -INSERT 语句用来向表中插入行记录。 - -最简单的 INSERT 语句语法格式如下: - -```javascript -INSERT INTO table_name (list_of_columns) VALUES (list_of_values); -``` - - - -其中,list_of_columns 指定表的 table_name 列,list_of_values 是 list_of_columns 提到的列的对应值,必须一一对应。因此,在向一个表插入记录之前,需要了解这个表所有的列信息,以及列类型和有效值、是否允许为空等。在 obclient 命令行环境下,可以直接用 DESC 命令查看列属性,如下所示: - -```javascript -obclient> desc ordl; -+----------------+-------------+------+-----+---------+-------+ -| FIELD | TYPE | NULL | KEY | DEFAULT | EXTRA | -+----------------+-------------+------+-----+---------+-------+ -| OL_W_ID | NUMBER(38) | NO | PRI | NULL | NULL | -| OL_D_ID | NUMBER(38) | NO | PRI | NULL | NULL | -| OL_O_ID | NUMBER(38) | NO | PRI | NULL | NULL | -| OL_NUMBER | NUMBER(38) | NO | PRI | NULL | NULL | -| OL_DELIVERY_D | DATE | YES | NULL | NULL | NULL | -| OL_AMOUNT | NUMBER(6,2) | YES | NULL | NULL | NULL | -| OL_I_ID | NUMBER(38) | YES | NULL | NULL | NULL | -| OL_SUPPLY_W_ID | NUMBER(38) | YES | NULL | NULL | NULL | -| OL_QUANTITY | NUMBER(38) | YES | NULL | NULL | NULL | -| OL_DIST_INFO | CHAR(24) | YES | NULL | NULL | NULL | -+----------------+-------------+------+-----+---------+-------+ -10 rows in set (0.01 sec) -``` - - - -在 INSERT 语句中,您不需要知道表的所有列的值,但需要知道所有列属性为 NOT NULL 的列的值。如果列属性为NOT NULL 有默认值时,您可以不指定该列的值;如果列为 NULL,您也可以不指定该列的值, OceanBase 数据库会在该列上插入一个 NULL 值。 - -当插入多条件记录时,可以分多条 INSERT 语句,也可以用一个 INSERT 多个 VALUES 语句。 - -示例:当所有列信息都知道时,使用 INSERT 语句 ------------------------------------ - -如下示例创建有默认值列的表,SQL 插入两笔记录,所有字段信息都有值。 - -```javascript -obclient> CREATE TABLE t_insert( - id number NOT NULL PRIMARY KEY - , name varchar(10) NOT NULL, value number - , gmt_create date NOT NULL DEFAULT sysdate - ); -Query OK, 0 rows affected (0.07 sec) - -obclient> INSERT INTO t_insert(id, name, value, gmt_create) - values(1,'CN',10001, sysdate); -Query OK, 1 row affected (0.01 sec) -``` - - - -示例:当不是所有列信息都知道时,使用 INSERT 语句 -------------------------------------- - -下面 SQL 插入两笔记录,gmt_create 字段没有提供。两笔记录使用一个 INSERT 多个 VALUES 子句。 - -```javascript -obclient> INSERT INTO t_insert(id, name, value) -VALUES (2,'US', 10002) ,(3,'EN', 10003); -Query OK, 2 rows affected (0.00 sec) -Records: 2 Duplicates: 0 Warnings: 0 -``` - - - -示例:使用INSERT语句违反唯一约束冲突 ------------------------------- - -当表上有唯一性约束的时候,插入相同的记录,数据库会报错,提示 key 'xxx' violated。 - -```javascript -obclient> INSERT INTO t_insert(id, name, value) -VALUES (3,'UK', 10003) - ,(4, 'JP', 10004); -ORA-00001: unique constraint '3' for key 'PRIMARY' violated -``` - - - -这个报错可以通过 MERGE INTO 避免,详细用法请参考 [关于 MERGE 语句](../../../8.developer-guide-oracle-mode/3.about-dml-statements-and-transactions-1/1.about-dml-statements-1/4.about-the-merge-statement.md)。 - -示例:使用查询语句充当 INSERT 的 values 子句 ---------------------------------------- - -当需要备份一个表的备份或者全部记录时,可以使用 `INSERT INTO ... SELECT ... FROM` 语句。 - -```javascript -obclient> create table ware_bak( - w_id int - , w_ytd decimal(12,2) - , w_tax decimal(4,4) - , w_name varchar(10) - , w_street_1 varchar(20) - , w_street_2 varchar(20) - , w_city varchar(20) - , w_state char(2) - , w_zip char(9) - , primary key(w_id) -); -Query OK, 0 rows affected (0.17 sec) - -obclient> insert into ware_bak select * from ware; -Query OK, 2 rows affected (0.02 sec) -Records: 2 Duplicates: 0 Warnings: 0 -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/3.about-dml-statements-and-transactions-1/1.about-dml-statements-1/3.about-update-statements-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/3.about-dml-statements-and-transactions-1/1.about-dml-statements-1/3.about-update-statements-1.md deleted file mode 100644 index 725212e18..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/3.about-dml-statements-and-transactions-1/1.about-dml-statements-1/3.about-update-statements-1.md +++ /dev/null @@ -1,48 +0,0 @@ -关于 UPDATE 语句 -================================= - - - -UPDATE 语句用来更新表的行记录。 - -简单的 UPDATE 语句语法格式如下: - -```javascript -UPDATE table_name -SET column_name = value [, column_name = value]... -[ WHERE condition ]; -``` - - - -其中,column_name 是要更新的列,等号后面的 value 是要更新的目标值,必须符合列的类型定义。WHERE 条件子句指定要更新的行记录必须满足的条件,没有 WHERE 条件子句就是更新表对应列的所有记录。 - -示例:更新所有记录 ------------------- - -```javascript -obclient> update t_insert set value=value+1 ; -Query OK, 3 rows affected (0.01 sec) -Rows matched: 3 Changed: 3 Warnings: 0 -``` - - -**说明** - - - -不带条件更新的时候,如果记录数达到几十万或者几百万,会有大事务产生,可能会失败。所以 UPDATE 要注意控制事务不要太大。 - -示例:更新部分记录,违反约束报错 -------------------------- - -```javascript -obclient> create unique index uk_name on t_insert(name); -Query OK, 0 rows affected (1.99 sec) - -obclient> update t_insert set name='US' where id=3; -ORA-00001: unique constraint 'US' for key 'UK_NAME' violated -``` - - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/3.about-dml-statements-and-transactions-1/1.about-dml-statements-1/4.about-the-merge-statement.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/3.about-dml-statements-and-transactions-1/1.about-dml-statements-1/4.about-the-merge-statement.md deleted file mode 100644 index 58ca7073d..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/3.about-dml-statements-and-transactions-1/1.about-dml-statements-1/4.about-the-merge-statement.md +++ /dev/null @@ -1,62 +0,0 @@ -关于 MERGE 语句 -================================ - - - -在批处理任务中,可能需要对目标表进行大量 INSERT 或 UPDATE。如果需求是记录不存在就 INSERT,存在就 UPDATE,此时可以使用 MERGE 语句。 - -MERGE 语句的语法简单描述如下: - -```javascript -MERGE INTO table_name alias1 -USING (table|view|sub_query) alias2 -ON (join condition) -WHEN MATCHED THEN - UPDATE table_name - SET col1 = col_val1 , - col2 = col2_val -WHEN NOT MATCHED THEN - INSERT (column_list) VALUES (column_values); -``` - - - -使用示例如下: - -```javascript -obclient> CREATE TABLE t_merge( - id number NOT NULL PRIMARY KEY, - name varchar2(50) NOT NULL, - value number NOT NULL, - gmt_create date NOT NULL DEFAULT sysdate, - gmt_modified date NOT NULL DEFAULT sysdate -); -Query OK, 0 rows affected (0.06 sec) - -obclient> INSERT INTO t_merge(id,name,value) values(1,'CN',1),(2,'US',2); -Query OK, 2 rows affected (0.01 sec) -Records: 2 Duplicates: 0 Warnings: 0 - -obclient> MERGE INTO t_merge t2 - USING (SELECT id,name,value,gmt_create FROM t_insert ) t1 - ON (t2.id=t1.id) - WHEN MATCHED THEN - UPDATE SET t2.name=t1.name, t2.value=t1.value, t2.gmt_modified=sysdate - WHEN NOT MATCHED THEN - INSERT (t2.id,t2.name,t2.value) values(t1.id, t1.name, t1.value) - ; -Query OK, 3 rows affected (0.01 sec) - -obclient> select * from t_merge; -+----+------+-------+---------------------+---------------------+ -| ID | NAME | VALUE | GMT_CREATE | GMT_MODIFIED | -+----+------+-------+---------------------+---------------------+ -| 1 | CN | 10001 | 2020-04-02 17:51:59 | 2020-04-02 17:52:52 | -| 2 | US | 10002 | 2020-04-02 17:51:59 | 2020-04-02 17:52:52 | -| 3 | EN | 10003 | 2020-04-02 17:52:52 | 2020-04-02 17:52:52 | -+----+------+-------+---------------------+---------------------+ -3 rows in set (0.01 sec) -``` - - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/3.about-dml-statements-and-transactions-1/1.about-dml-statements-1/5.about-the-delete-statement-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/3.about-dml-statements-and-transactions-1/1.about-dml-statements-1/5.about-the-delete-statement-1.md deleted file mode 100644 index d64598e7d..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/3.about-dml-statements-and-transactions-1/1.about-dml-statements-1/5.about-the-delete-statement-1.md +++ /dev/null @@ -1,26 +0,0 @@ -关于 DELETE 语句 -================================= - - - -DELETE 语句用来删除表中的记录。 - -简单的 DELETE 语句格式如下: - -```javascript -DELETE FROM table_name [ WHERE condition ] ; -``` - - - -其中,WHERE 条件子句是可选的,如果没有提供就全表删除。如果表记录数多达几百万以上,会形成大事务,可能会有性能问题。建议带上 WHERE 条件分批删除;或者使用 TRUNCATE TABLE 语句。 - -示例:删除表中数据 ------------------- - -```javascript -delete from ordr where o_w_id=2; -``` - - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/3.about-dml-statements-and-transactions-1/2.about-transactional-control-statements-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/3.about-dml-statements-and-transactions-1/2.about-transactional-control-statements-1.md deleted file mode 100644 index ffc2099aa..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/3.about-dml-statements-and-transactions-1/2.about-transactional-control-statements-1.md +++ /dev/null @@ -1,41 +0,0 @@ -关于事务控制语句 -============================= - - - -事务指的是一序列 SQL 语句,OceanBase 数据库将这组 SQL 语句当作一个整体,要么全部执行成功,要么全部不成功;不存在部分 SQL 语句执行成功,或者部分 SQL 没有执行成功的情形。 - -举个例子,当一个客户下单购买了一批商品时,订单表会新增几行记录购买信息和金额,库存表会更新这批商品的库存数量(扣减库存)。应用程序中为这个业务做设计时,就需要把 INSERT 和 UPDATE 语句放到一个事务里。 - -通常事务中的 SQL 会包含 DML 语句,也会包含查询语句。如果一个事务中的 SQL 只有查询语句,这个事务通常称为只读事务。 - -基本的事务控制语句有: - -* BEGIN,显式开启一个事务。这个命令是可选的,如果租户会话的参数 autocommit 值是 off (关闭自动提交),就不需要显式发出这个命令;如果参数值是 on (开启自动提交),那每条 SQL 就是一个独立的事务;如果要多个 SQL 组成一个事务,需要显式发起 BEGIN 命令。 - - - -* SAVEPOINT,在事务过程中标记一个"保存点",事务可以事后选择回滚到这个点。保存点是可选的,一个事务过程中也可以有多个保存点。 - - - -* COMMIT,结束当前事务,让事务所有修改持久化并生效,清除所有保存点和释放事务持有的锁。 - - - -* ROLLBACK,回滚整个事务已做的修改或者只回滚某个保存点之后事务已做的修改,清除回滚部分包含的所有保存点和释放事务持有的锁。 - - - - - - -在 obclient 命令环境下,可以在 SQL 提示符后发起事务控制命令,也可以修改会话级别的 autocommit 变量。如果是修改租户级别的 autocommit 变量,需要断开会话重新连接才会生效。 - -在图形化客户端工具中,如 ODC,SQL 编辑窗口里可以发出命令,或者工具栏上有提交和回滚的图标。 -**说明** - - - -如果会话的 autocommit 变量值是 off 时,并且没有显式的提交事务,程序异常中断时,OceanBase 数据库会自动回滚最后一个未提交的事务。建议显式的提交事务或者回滚事务。 - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/3.about-dml-statements-and-transactions-1/3.submit-transaction-4.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/3.about-dml-statements-and-transactions-1/3.submit-transaction-4.md deleted file mode 100644 index d75c65dd2..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/3.about-dml-statements-and-transactions-1/3.submit-transaction-4.md +++ /dev/null @@ -1,69 +0,0 @@ -提交事务 -========================= - - - -提交一个事务会让事务的修改持久化生效,清除保存点并释放事务所持有的所有锁。 - -要显式的提交事务,使用 COMMIT 语句或者使用提交按钮(在图形化客户端工具中)。 -**说明** - - - -OceanBase 数据库会在 DDL 语句前和后隐式的发起一个 COMMIT 语句,这个也会提交事务。 - -在您提交事务之前: - -* 您的修改只对当前会话可见,对其他数据库会话是不可见的。 - - - -* 您的修改没有持久化,所以不是最终的,可以用 ROLLBACK 语句回滚这些修改。 - - - - - - -在您提交事务之后: - -* 您的修改对所有数据库会话可见。 - - - -* 您的修改持久化成功,不可以用 ROLLBACK 语句回滚这些修改。 - - - - - - -示例:提交事务 ----------------- - -```javascript -obclient> insert into t_insert(id,name) values(4,'JP'); -Query OK, 1 row affected (0.01 sec) - -obclient> commit; -Query OK, 0 rows affected (0.00 sec) - -obclient> ^Bye - -[qing.meiq@h07g12088.sqa.eu95 /home/qing.meiq/bmsql] -$obclient -h192.168.1.101 -utpcc@obbmsql#obdemo -P2883 -p123456 TPCC -Type 'help;' or '\h' for help. Type '\c' to clear the current input statement. - -obclient> select * from t_insert; -+----+------+-------+---------------------+ -| ID | NAME | VALUE | GMT_CREATE | -+----+------+-------+---------------------+ -| 1 | CN | 10001 | 2020-04-02 17:52:31 | -| 2 | US | 10002 | 2020-04-02 17:52:38 | -| 3 | EN | 10003 | 2020-04-02 17:52:38 | -| 4 | JP | NULL | 2020-04-02 17:53:34 | -+----+------+-------+---------------------+ -4 rows in set (0.00 sec) -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/3.about-dml-statements-and-transactions-1/4.roll-back-transactions-4.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/3.about-dml-statements-and-transactions-1/4.roll-back-transactions-4.md deleted file mode 100644 index 04113f641..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/3.about-dml-statements-and-transactions-1/4.roll-back-transactions-4.md +++ /dev/null @@ -1,86 +0,0 @@ -回滚事务 -========================= - - - -回滚一个事务指将事务的修改全部撤销。可以回滚当前整个未提交事务,也可以回滚到事务中任意一个保存点。如果要回滚到某个保存点,必须结合使用 ROLLBACK 和 TO SAVEPOINT 语句。 - -如果回滚整个事务: - -* 事务会结束。 - -* 所有的修改会被丢弃。 - -* 清除所有保存点。 - -* 释放事务持有的所有锁。 - - - - - - -如果回滚到某个保存点: - -* 事务不会结束。 - -* 保存点之前的修改被保留,保存点之后的修改被丢弃。 - -* 清除保存点之后的保存点(不包括保存点自身)。 - -* 释放保存点之后事务持有的所有锁。 - - - - - - -示例:ROLLBACK 回滚事务的全部修改 ------------------------------- - -```javascript -obclient> select * from t_insert; -+----+------+-------+---------------------+ -| ID | NAME | VALUE | GMT_CREATE | -+----+------+-------+---------------------+ -| 1 | CN | 10001 | 2020-04-02 17:52:31 | -| 2 | US | 10002 | 2020-04-02 17:52:38 | -| 3 | EN | 10003 | 2020-04-02 17:52:38 | -+----+------+-------+---------------------+ -3 rows in set (0.00 sec) - -obclient> insert into t_insert(id, name, value) values(4,'JP',10004); -Query OK, 1 row affected (0.00 sec) - -obclient> insert into t_insert(id, name, value) values(5,'FR',10005),(6,'RU',10006); -Query OK, 2 rows affected (0.00 sec) -Records: 2 Duplicates: 0 Warnings: 0 - -obclient> select * from t_insert; -+----+------+-------+---------------------+ -| ID | NAME | VALUE | GMT_CREATE | -+----+------+-------+---------------------+ -| 1 | CN | 10001 | 2020-04-02 17:52:31 | -| 2 | US | 10002 | 2020-04-02 17:52:38 | -| 3 | EN | 10003 | 2020-04-02 17:52:38 | -| 4 | JP | NULL | 2020-04-02 17:53:34 | -| 5 | FR | 10005 | 2020-04-02 17:54:53 | -| 6 | RU | 10006 | 2020-04-02 17:54:53 | -+----+------+-------+---------------------+ -6 rows in set (0.00 sec) - -obclient> rollback; -Query OK, 0 rows affected (0.00 sec) - -obclient> select * from t_insert; -+----+------+-------+---------------------+ -| ID | NAME | VALUE | GMT_CREATE | -+----+------+-------+---------------------+ -| 1 | CN | 10001 | 2020-04-02 17:52:31 | -| 2 | US | 10002 | 2020-04-02 17:52:38 | -| 3 | EN | 10003 | 2020-04-02 17:52:38 | -+----+------+-------+---------------------+ -3 rows in set (0.00 sec) -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/3.about-dml-statements-and-transactions-1/5.transaction-savepoints-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/3.about-dml-statements-and-transactions-1/5.transaction-savepoints-1.md deleted file mode 100644 index ea2b02493..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/3.about-dml-statements-and-transactions-1/5.transaction-savepoints-1.md +++ /dev/null @@ -1,137 +0,0 @@ -事务保存点 -========================== - - - -SAVEPOINT 语句可以在事务过程中标记一个"保存点",事务可以选择回滚到这个点。保存点是可选的,一个事务过程中也可以有多个保存点。 - -示例:将一个事务回滚到一个保存点 -------------------------- - -下面示例展示了一个事务中包含多个 DML 语句和多个保存点,然后回滚到其中一个保存点,只丢弃了保存点后面的那部份修改。 - -* 查看表当前记录 - - - - -```javascript -obclient> select * from t_insert; -+----+------+-------+---------------------+ -| ID | NAME | VALUE | GMT_CREATE | -+----+------+-------+---------------------+ -| 1 | CN | 10001 | 2020-04-02 17:52:31 | -| 2 | US | 10002 | 2020-04-02 17:52:38 | -| 3 | EN | 10003 | 2020-04-02 17:52:38 | -| 4 | JP | NULL | 2020-04-02 17:53:34 | -| 5 | DE | NULL | 2020-04-02 17:58:31 | -+----+------+-------+---------------------+ -5 rows in set (0.00 sec) -``` - - - -* 开启一个事务,设置多个保存点信息。 - - - - -```javascript -obclient> insert into t_insert(id, name) values(6,'FR'); -Query OK, 1 row affected (0.00 sec) - -obclient> savepoint fr; -Query OK, 0 rows affected (0.00 sec) - -obclient> insert into t_insert(id, name) values(7,'RU'); -Query OK, 1 row affected (0.00 sec) - -obclient> savepoint ru; -Query OK, 0 rows affected (0.00 sec) - -obclient> insert into t_insert(id, name) values(8,'CA'); -Query OK, 1 row affected (0.00 sec) - -obclient> savepoint ca; -Query OK, 0 rows affected (0.00 sec) -``` - - - -* 当前会话能看到事务未提交的所有修改。 - - - - -```javascript -obclient> select * from t_insert; -+----+------+-------+---------------------+ -| ID | NAME | VALUE | GMT_CREATE | -+----+------+-------+---------------------+ -| 1 | CN | 10001 | 2020-04-02 17:52:31 | -| 2 | US | 10002 | 2020-04-02 17:52:38 | -| 3 | EN | 10003 | 2020-04-02 17:52:38 | -| 4 | JP | NULL | 2020-04-02 17:53:34 | -| 5 | DE | NULL | 2020-04-02 17:58:31 | -| 6 | FR | NULL | 2020-04-02 17:58:59 | -| 7 | RU | NULL | 2020-04-02 17:59:09 | -| 8 | CA | NULL | 2020-04-02 17:59:19 | -+----+------+-------+---------------------+ -8 rows in set (0.00 sec) -``` - - - -* 回滚事务到其中一个保存点。 - - - - -```javascript -obclient> rollback to savepoint ru; -Query OK, 0 rows affected (0.00 sec) - -obclient> select * from t_insert; -+----+------+-------+---------------------+ -| ID | NAME | VALUE | GMT_CREATE | -+----+------+-------+---------------------+ -| 1 | CN | 10001 | 2020-04-02 17:52:31 | -| 2 | US | 10002 | 2020-04-02 17:52:38 | -| 3 | EN | 10003 | 2020-04-02 17:52:38 | -| 4 | JP | NULL | 2020-04-02 17:53:34 | -| 5 | DE | NULL | 2020-04-02 17:58:31 | -| 6 | FR | NULL | 2020-04-02 17:58:59 | -| 7 | RU | NULL | 2020-04-02 17:59:09 | -+----+------+-------+---------------------+ -7 rows in set (0.00 sec) -``` - - - -* 提交事务,确认表最新修改包含保存点之前的修改。 - - - - -```javascript -obclient> commit; -Query OK, 0 rows affected (0.00 sec) -obclient> select * from t_insert; -+----+------+-------+---------------------+ -| ID | NAME | VALUE | GMT_CREATE | -+----+------+-------+---------------------+ -| 1 | CN | 10001 | 2020-04-02 17:52:31 | -| 2 | US | 10002 | 2020-04-02 17:52:38 | -| 3 | EN | 10003 | 2020-04-02 17:52:38 | -| 4 | JP | NULL | 2020-04-02 17:53:34 | -| 5 | DE | NULL | 2020-04-02 17:58:31 | -| 6 | FR | NULL | 2020-04-02 17:58:59 | -| 7 | RU | NULL | 2020-04-02 17:59:09 | -+----+------+-------+---------------------+ -7 rows in set (0.00 sec) - -obclient> -``` - - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/3.about-dml-statements-and-transactions-1/6.about-transaction-timeout-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/3.about-dml-statements-and-transactions-1/6.about-transaction-timeout-1.md deleted file mode 100644 index cdafdb75c..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/3.about-dml-statements-and-transactions-1/6.about-transaction-timeout-1.md +++ /dev/null @@ -1,144 +0,0 @@ -关于事务超时 -=========================== - - - -OceanBase 数据库为了避免事务长时间不提交持有锁影响其他会话,设计了两个超时逻辑。一个是事务空闲超时,一个是事务未提交超时。分别由租户变量 ob_trx_idle_timeout 和 ob_trx_timeout 控制,默认值分别是 120 秒和 100 秒。通常只会有一个超时机制被触发。有关变量 ob_trx_idle_timeout 和 ob_trx_timeout 的详细介绍,请参考《参考指南(Oracle 模式)》中的 **系统变量** 章节。 -**说明** - - - -建议变量 ob_trx_idle_timeout 使用默认值。 - -```javascript -obclient> show variables where variable_name in ('ob_trx_idle_timeout','ob_trx_timeout'); -+---------------------+-----------+ -| VARIABLE_NAME | VALUE | -+---------------------+-----------+ -| ob_trx_idle_timeout | 120000000 | -| ob_trx_timeout | 100000000 | -+---------------------+-----------+ -2 rows in set (0.00 sec) -``` - - - - - -关于事务空闲超时 ------------------ - -OceanBase 数据库的事务空闲时间超过一段时间还没有提交时,会自动断开连接并回滚事务,此时会话需要重新连接。 - -会话事务空闲超时时间阈值由租户变量 ob_trx_idle_timeout 控制,这个参数值建议建议使用默认值 120 秒,实际空闲会话断开的时间会是在 \[100s, 100s + ob_trx_idle_timeout \] 之间。 - -#### 示例:事务空闲超时报错 - -下面示例先设置事务空闲超时时间为 120 秒,事务未提交超时时间为 1000 秒。当事务空闲时间超过 120 秒后,连接会被自动断开,事务也自动被 ROLLBACK 了。 - -```javascript -obclient> select sysdate, t.* from t_insert t; -+---------------------+----+------+-------+---------------------+ -| SYSDATE | ID | NAME | VALUE | GMT_CREATE | -+---------------------+----+------+-------+---------------------+ -| 2020-04-02 18:03:14 | 1 | CN | 10001 | 2020-04-02 17:52:31 | -| 2020-04-02 18:03:14 | 2 | US | 10002 | 2020-04-02 17:52:38 | -| 2020-04-02 18:03:14 | 3 | EN | 10003 | 2020-04-02 17:52:38 | -+---------------------+----+------+-------+---------------------+ -3 rows in set (0.00 sec) - -obclient> set session ob_trx_timeout=1000000000; -Query OK, 0 rows affected (0.00 sec) - -obclient> set session ob_trx_idle_timeout=120000000; -Query OK, 0 rows affected (0.00 sec) - -obclient> update t_insert set gmt_create=sysdate where id=3; -Query OK, 1 row affected (0.00 sec) -Rows matched: 1 Changed: 1 Warnings: 0 - -<<等 120 秒不操作>> - -obclient> select sysdate, t.* from t_insert t; -ERROR-02013: Lost connection to MySQL server during query -obclient> select sysdate, t.* from t_insert t; -ERROR-02006: MySQL server has gone away -No connection. Trying to reconnect... -Connection id: 53246 -Current database: TPCC - -+---------------------+----+------+-------+---------------------+ -| SYSDATE | ID | NAME | VALUE | GMT_CREATE | -+---------------------+----+------+-------+---------------------+ -| 2020-04-02 18:07:51 | 1 | CN | 10001 | 2020-04-02 17:52:31 | -| 2020-04-02 18:07:51 | 2 | US | 10002 | 2020-04-02 17:52:38 | -| 2020-04-02 18:07:51 | 3 | EN | 10003 | 2020-04-02 17:52:38 | -+---------------------+----+------+-------+---------------------+ -3 rows in set (0.00 sec) -``` - - - - - -关于事务未提交超时 ------------------- - -OceanBase 数据库的事务持续时间超过一段时间还没有提交,会报超时错误。此时会话需要明确发出 ROLLBACK 命令才可以继续在会话里执行 SQL。 - -会话事务的未提交超时时间阈值是由租户变量 ob_trx_timeout 控制。 - -#### 示例:事务未提交超时报错 - -下面示例先设置事务空闲超时时间为 120 秒,事务超时时间为 100 秒。当一个事务未提交时间持续到 100 秒时,事务内部状态就变为超时状态,同时锁会释放。此后会话需要显式发出 ROLLBACK 语句。 - -```javascript -obclient> set session ob_trx_timeout=100000000; -Query OK, 0 rows affected (0.00 sec) - -obclient> set session ob_trx_idle_timeout=120000000; -Query OK, 0 rows affected (0.00 sec) - -obclient> update t_insert set gmt_create=sysdate where id=3; -Query OK, 1 row affected (0.00 sec) -Rows matched: 1 Changed: 1 Warnings: 0 - -obclient> select sysdate, t.* from t_insert t ; -+---------------------+----+------+-------+---------------------+ -| SYSDATE | ID | NAME | VALUE | GMT_CREATE | -+---------------------+----+------+-------+---------------------+ -| 2020-04-02 18:08:54 | 1 | CN | 10001 | 2020-04-02 17:52:31 | -| 2020-04-02 18:08:54 | 2 | US | 10002 | 2020-04-02 17:52:38 | -| 2020-04-02 18:08:54 | 3 | EN | 10003 | 2020-04-02 18:08:47 | -+---------------------+----+------+-------+---------------------+ -3 rows in set (0.01 sec) - -<<等 100 秒不操作>> - -obclient> select sysdate, t.* from t_insert t ; -ERROR-00600: internal error code, arguments: -6210, Transaction is timeout -obclient> commit; -ERROR-00600: internal error code, arguments: -6210, Transaction is timeout -obclient> rollback; -Query OK, 0 rows affected (0.00 sec) - -obclient> select sysdate, t.* from t_insert t ; -+---------------------+----+------+-------+---------------------+ -| SYSDATE | ID | NAME | VALUE | GMT_CREATE | -+---------------------+----+------+-------+---------------------+ -| 2020-04-02 18:09:21 | 1 | CN | 10001 | 2020-04-02 17:52:31 | -| 2020-04-02 18:09:21 | 2 | US | 10002 | 2020-04-02 17:52:38 | -| 2020-04-02 18:09:21 | 3 | EN | 10003 | 2020-04-02 17:52:38 | -+---------------------+----+------+-------+---------------------+ -3 rows in set (0.00 sec) -``` - - -**说明** - - - -建议不要将事务未提交超时参数设置小于 1 秒。 - - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/1.about-ddl-statements-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/1.about-ddl-statements-1.md deleted file mode 100644 index 0b68761f4..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/1.about-ddl-statements-1.md +++ /dev/null @@ -1,54 +0,0 @@ -关于 DDL 语句 -============================== - - - -DDL(Data Definition Language,数据定义语言)语句用来创建、修改和删除数据库对象。在 DDL 开始之前和之后,OceanBase 数据库会发出一个隐式的 COMMIT 语句,所以不可以回滚 DDL 语句。 -**说明** - - - -在 obclient 命令行环境下,可以在"SQL 提示符(默认是 obclient)\>"后输入 DDL 语句。 - -在 ODC 的 SQL 编辑器窗口,也可以输入 DDL 语句。 - -OceanBase DDL 支持的数据库对象有: - -* 表,包括约束、索引 - - - -* 视图 - - - -* 序列 - - - -* 同义词 - - - -* 自定义函数 - - - -* 存储过程 - - - -* 触发器 - - - -* 包和包体 - - - -* 其他对象 - - - - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/2.create-and-manage-tables-1/1.about-sql-data-types-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/2.create-and-manage-tables-1/1.about-sql-data-types-1.md deleted file mode 100644 index 637d4399d..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/2.create-and-manage-tables-1/1.about-sql-data-types-1.md +++ /dev/null @@ -1,32 +0,0 @@ -关于 SQL 数据类型 -================================ - - - -当您创建表的时候,必须指定表记录行的每一列的数据类型,数据类型定义了该列存储数据的合法格式。比如说一个 DATE 类型的列,能存储值"2020-02-20",但是不能存储值为 2 的数字或者字符串"hello"。 - -有关 SQL 数据类型的详细描述,请参考《SQL参考(Oracle模式)》,这里介绍一些常用的数据类型。 - - -| **分类** | **类型** | **备注** | -|--------|-------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 数值类型 | number\[(p \[, s\])\] | p(precision)为精度,最大值为 38;s(scale)表示小数点右边的数字个数,scale 的取值范围为 \[-84, 127\]。 * p 和 s 都有表示定点数。 * s 为 0 表示整型。 * p 和 s 都不指定,表示浮点数,最大精度 38。 | -| 数值类型 | float\[(p)\] | float(p) 是 NUMBER 类型的子类型,精度是按二进制有效位数计算的,范围为 1\~126,小数位数不可自定义。 | -| 数值类型 | binary_float | 32 位的浮点数,4 个字节。 | -| 数值类型 | binary_double | 64 位的浮点数,8 个字节。 | -| 字符串类型 | char(N) | 最大长度为 2000 个字节。 | -| 字符串类型 | varchar2(N) | 最大长度为 32767 个字节。 | -| 字符串类型 | nchar(N) | 最大长度为 2000 个字节。 | -| 字符串类型 | nvarchar2(N) | 最大长度为 32767 个字节。 | -| 时间类型 | date | YYYY-MM-DD,只包含日期。 | -| 时间类型 | timestamp | 日期时间(不考虑时区)。 | -| 时间类型 | timestamp with timezone | 日期时间(考虑时区)。 | -| 时间类型 | timestamp with local timezone | 日期时间(考虑时区)。 | -| 时间类型 | interval year to month | 以年和月为单位的时间段。 | -| 时间类型 | interval day to second | 以天、小时、分钟和秒为单位的时间段。 | -| RAW类型 | raw(N) | raw 二进制数据,大小位 N Bytes。 | -| 大对象 | blob | 最大 48M 字节。 | -| 大对象 | clob | 最大 48M 字节。 | - - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/2.create-and-manage-tables-1/2.create-a-table-2.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/2.create-and-manage-tables-1/2.create-a-table-2.md deleted file mode 100644 index 342491577..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/2.create-and-manage-tables-1/2.create-a-table-2.md +++ /dev/null @@ -1,286 +0,0 @@ -创建表 -======================== - - - -可以通过执行 DDL 语句 CREATE TABLE 来创建一个表。 - -使用 CREATE TABLE 语句建表 ------------------------------ - -* 下面示例对 Oracle 模式内建类型的支持。 - - - - - - -```javascript -CREATE TABLE t_data_types( - id number NOT NULL PRIMARY KEY - ,c_char char(100) - ,c_varchar varchar2(100) - ,c_nchar nchar(100) - ,c_nvarchar nvarchar2(100) - ,c_numeric numeric(10,2) - ,c_int int - ,c_float float(2) - ,c_binary_float binary_float - ,c_binary_double binary_double - ,c_date date - ,c_timestamp timestamp - ,c_timestamp2 timestamp WITH time ZONE - ,c_timestamp3 timestamp WITH LOCAL time zone - ,c_interval_year INTERVAL YEAR TO MONTH - ,c_interval_day INTERVAL DAY TO SECOND -,c_raw raw(2000) - ,c_blob blob - ,c_clob clob -); -Query OK, 0 rows affected (0.14 sec) -``` - - - -创建后可以通过DESC命令查看列属性。 - -```unknow -+-----------------+-----------------------------------+------+-----+---------+-------+ -| FIELD | TYPE | NULL | KEY | DEFAULT | EXTRA | -+-----------------+-----------------------------------+------+-----+---------+-------+ -| ID | NUMBER | NO | PRI | NULL | NULL | -| C_CHAR | CHAR(100) | YES | NULL | NULL | NULL | -| C_VARCHAR | VARCHAR2(100) | YES | NULL | NULL | NULL | -| C_NCHAR | NCHAR(100) | YES | NULL | NULL | NULL | -| C_NVARCHAR | NVARCHAR2(100) | YES | NULL | NULL | NULL | -| C_NUMERIC | NUMBER(10,2) | YES | NULL | NULL | NULL | -| C_INT | NUMBER(38) | YES | NULL | NULL | NULL | -| C_FLOAT | FLOAT(2) | YES | NULL | NULL | NULL | -| C_BINARY_FLOAT | BINARY_FLOAT | YES | NULL | NULL | NULL | -| C_BINARY_DOUBLE | BINARY_DOUBLE | YES | NULL | NULL | NULL | -| C_DATE | DATE | YES | NULL | NULL | NULL | -| C_TIMESTAMP | TIMESTAMP(6) | YES | NULL | NULL | NULL | -| C_TIMESTAMP2 | TIMESTAMP(6) WITH TIME ZONE | YES | NULL | NULL | NULL | -| C_TIMESTAMP3 | TIMESTAMP(6) WITH LOCAL TIME ZONE | YES | NULL | NULL | NULL | -| C_INTERVAL_YEAR | INTERVAL YEAR (2) TO MONTH | YES | NULL | NULL | NULL | -| C_INTERVAL_DAY | INTERVAL DAY (2) TO SECOND (6) | YES | NULL | NULL | NULL | -| C_RAW | RAW(2000) | YES | NULL | NULL | NULL | -| C_BLOB | BLOB | YES | NULL | NULL | NULL | -| C_CLOB | CLOB | YES | NULL | NULL | NULL | -+-----------------+-----------------------------------+------+-----+---------+-------+ -19 rows in set (0.01 sec) -``` - - - -* 下面示例使用 CREATE TABLE 语句创建订单表 ware 和 cust 表。 - - - - - - -```javascript -obclient> create table ware(w_id int - , w_ytd decimal(12,2) - , w_tax decimal(4,4) - , w_name varchar(10) - , w_street_1 varchar(20) - , w_street_2 varchar(20) - , w_city varchar(20) - , w_state char(2) - , w_zip char(9) - , unique(w_name, w_city) - , primary key(w_id) -); -Query OK, 0 rows affected (0.09 sec) - -obclient> create table cust (c_w_id int NOT NULL - , c_d_id int NOT null - , c_id int NOT null - , c_discount decimal(4, 4) - , c_credit char(2) - , c_last varchar(16) - , c_first varchar(16) - , c_middle char(2) - , c_balance decimal(12, 2) - , c_ytd_payment decimal(12, 2) - , c_payment_cnt int - , c_credit_lim decimal(12, 2) - , c_street_1 varchar(20) - , c_street_2 varchar(20) - , c_city varchar(20) - , c_state char(2) - , c_zip char(9) - , c_phone char(16) - , c_since date - , c_delivery_cnt int - , c_data varchar(500) - , index icust(c_last, c_d_id, c_w_id, c_first, c_id) - , FOREIGN KEY (c_w_id) REFERENCES ware(w_id) - , primary key (c_w_id, c_d_id, c_id) -); -Query OK, 0 rows affected (0.10 sec) -``` - - -**说明** - - - -建议建表的时候为表设计主键或者唯一键,这样对性能或者后期维护都很有益。如果没有合适的字段作为主键,可以为表增加一个数值列作为主键,使用 OceanBase Oracle 租户的序列为这一列填充值。有关序列介绍请参见 [创建和管理序列](../../../8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/6.create-and-manage-sequences/1.overview-6.md)。 - -由于 ALTER TABLE 语法不支持后期增加主键,所以在建表的时候设置主键就更加有必要了。 - -使用 CREATE TABLE 复制表数据 ------------------------------- - -Oracle 租户不支持 CREATE TABLE LIKE 复制表结构的方法,所以完全的复制表结构必须拿到源表的 DDL,更改名字重新创建新表。 - -Oracle 租户支持 CREATE TABLE AS SELECT 复制表的基本数据类型和数据,但不包含约束、索引和非空等属性。 - -```javascript -obclient> show create table t3\G -*************************** 1. row *************************** - TABLE: T3 -CREATE TABLE: CREATE TABLE "T3" ( - "ID" NUMBER NOT NULL, - "NAME" VARCHAR2(50), - "GMT_CREATE" DATE DEFAULT sysdate NOT NULL, - CONSTRAINT "T3_OBPK_1582718853302518" PRIMARY KEY ("ID"), - CONSTRAINT "T3_UK" UNIQUE ("NAME", "ID") -) COMPRESS FOR ARCHIVE REPLICA_NUM = 1 BLOCK_SIZE = 16384 USE_BLOOM_FILTER = FALSE TABLET_SIZE = 134217728 PCTFREE = 10 - partition by hash(id) partitions 8 - -1 row in set (0.01 sec) - -obclient> create table t3_like like t3; -ERROR-00900: You have an error in your SQL syntax; check the manual that corresponds to your OceanBase version for the right syntax to use near 'like t3' at line 1 - -obclient> create table t3_copy as select * from t3; -Query OK, 0 rows affected (0.10 sec) - -obclient> show create table t3_copy\G -*************************** 1. row *************************** - TABLE: T3_COPY -CREATE TABLE: CREATE TABLE "T3_COPY" ( - "ID" NUMBER, - "NAME" VARCHAR2(50), - "GMT_CREATE" DATE -) COMPRESS FOR ARCHIVE REPLICA_NUM = 1 BLOCK_SIZE = 16384 USE_BLOOM_FILTER = FALSE TABLET_SIZE = 134217728 PCTFREE = 10 -1 row in set (0.00 sec) -``` - - - - - -关于表和分区 ---------------- - -在 OceanBase 数据库中,数据存储在表中,而数据表示的最小粒度是分区。普通的非分区表,就只有一个分区;而分区表,通常有多个分区,分区名默认以 p 开头,按数字顺序从 0 开始编号。所以分区是表的子集。 - -通常分区对用户的应用是透明的,应用只需要使用 SQL 读写表即可。只有某些场景下,为了提升分区表的查询性能,应用也可以使用 SQL 直接访问某个具体的分区,SQL 语法格式是: - -```javascript -SELECT ... FROM parted_table PARTITION (pN) WHERE query_condition ; -``` - - - -* 示例:通过 SQL 直接访问分区表的分区 - - - - - - -```javascript -obclient> select o_id,o_c_id,o_carrier_id,o_ol_cnt,o_all_local,o_entry_d from ordr partition (p5) where o_w_id=1 and o_d_id=2 and o_id=2100; -+------+--------+--------------+----------+-------------+---------------------+ -| O_ID | O_C_ID | O_CARRIER_ID | O_OL_CNT | O_ALL_LOCAL | O_ENTRY_D | -+------+--------+--------------+----------+-------------+---------------------+ -| 2100 | 8 | 8 | 11 | 1 | 2020-02-15 18:57:10 | -+------+--------+--------------+----------+-------------+---------------------+ -1 row in set (0.00 sec) - -obclient> select ol_o_id, ol_number,ol_delivery_d,ol_amount,ol_i_id,ol_supply_w_id,ol_quantity from ordl partition (p5) where ol_w_id=1 and ol_d_id=2 and ol_o_id=2100; -+---------+-----------+---------------------+-----------+---------+----------------+-------------+ -| OL_O_ID | OL_NUMBER | OL_DELIVERY_D | OL_AMOUNT | OL_I_ID | OL_SUPPLY_W_ID | OL_QUANTITY | -+---------+-----------+---------------------+-----------+---------+----------------+-------------+ -| 2100 | 1 | 2020-02-15 18:57:10 | 0 | 87133 | 1 | 5 | -| 2100 | 2 | 2020-02-15 18:57:10 | 0 | 47413 | 1 | 5 | -| 2100 | 3 | 2020-02-15 18:57:10 | 0 | 9115 | 1 | 5 | -| 2100 | 4 | 2020-02-15 18:57:10 | 0 | 42985 | 1 | 5 | -| 2100 | 5 | 2020-02-15 18:57:10 | 0 | 43621 | 1 | 5 | -| 2100 | 6 | 2020-02-15 18:57:10 | 0 | 5787 | 1 | 5 | -| 2100 | 7 | 2020-02-15 18:57:10 | 0 | 62576 | 1 | 5 | -| 2100 | 8 | 2020-02-15 18:57:10 | 0 | 91592 | 1 | 5 | -| 2100 | 9 | 2020-02-15 18:57:10 | 0 | 34452 | 1 | 5 | -| 2100 | 10 | 2020-02-15 18:57:10 | 0 | 13792 | 1 | 5 | -| 2100 | 11 | 2020-02-15 18:57:10 | 0 | 94326 | 1 | 5 | -+---------+-----------+---------------------+-----------+---------+----------------+-------------+ -11 rows in set (0.01 sec) -``` - - -**说明** - - - -如果是组合分区,可以访问更细粒度的分区,详细描述请参考 [分区路由](../../../8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/3.create-and-manage-partition-table-1/2.partition-routing-1.md)。 - -在 OceanBase 数据库里,节点间的数据迁移的最小粒度是分区,每个分区在集群里有三个副本,内容保持同步,角色上有区分。三副本会有一个主副本(Leader 副本)和两个备副本(Follower 副本),只有主副本可以提供写服务,默认也只有主副本可以提供读服务。主副本上的事务提交时会将事务日志同步到两个备副本,三副本使用 Paxos 协议表决事务是否提交成功。有时候为了不影响主副本,可以让备副本承担部分读请求,这就是应用常用的读写分离的解决方案, - -这种读备称为 **弱一致性读** 。使用这种方案,应用读需要承担读延时的风险,这个延时最大允许值会通过参数(max_stale_time_for_weak_consistency)控制。 - -* 示例:使用 SQL Hint 实现读写分离。 - - 弱一致读的 Hint 语法是 /\*+ read_consistency(weak) \*/ 。通常的读默认是强一致性读,就不用 Hint 了。 - - - - - -```javascript -obclient> select /*+ read_consistency(weak) */ o_id,o_c_id,o_carrier_id,o_ol_cnt,o_all_local,o_entry_d from ordr partition (p5) where o_w_id=1 and o_d_id=2 and o_id=2100; -+------+--------+--------------+----------+-------------+---------------------+ -| O_ID | O_C_ID | O_CARRIER_ID | O_OL_CNT | O_ALL_LOCAL | O_ENTRY_D | -+------+--------+--------------+----------+-------------+---------------------+ -| 2100 | 8 | 8 | 11 | 1 | 2020-02-15 18:57:10 | -+------+--------+--------------+----------+-------------+---------------------+ -1 row in set (0.00 sec) -``` - - - -复制表 ------------- - -复制表是分布式数据库 OceanBase 的高级优化手段。 - -通常 OceanBase 集群是三副本架构,默认每个表的每个分区在 OceanBase 集群中会有三个副本数据,角色上分为一个主副本(Leader 副本)和两个备副本(Follower副本),默认提供读写服务的是主副本。 - -复制表可以指定在租户的每台机器上都有一个备副本,并且主副本跟所有备份的数据使用全同步策略保持强同步。这样做的目的是为了让业务有些 SQL 关联查询时能在同一节点内部执行,以获取更好的性能。 - -复制表的语法是在 CREATE TABLE 语句后增加 `DUPLICATE_SCOPE` 选项。 - -* 示例:创建复制表。 - - - - - - -```javascript -obclient> create table item (i_id int - , i_name varchar(24) - , i_price decimal(5,2) - , i_data varchar(50) - , i_im_id int - , primary key(i_id)) COMPRESS FOR QUERY pctfree=0 BLOCK_SIZE=16384 - duplicate_scope='cluster' locality='F@zone1, F@zone2,R{all_server}@zone3' primary_zone='zone1'; -Query OK, 0 rows affected (0.10 sec) -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/2.create-and-manage-tables-1/3.about-auto-increment-columns-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/2.create-and-manage-tables-1/3.about-auto-increment-columns-1.md deleted file mode 100644 index 07e15fb44..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/2.create-and-manage-tables-1/3.about-auto-increment-columns-1.md +++ /dev/null @@ -1,8 +0,0 @@ -关于自增列 -========================== - - - -如果创建表时需要某个数值列的值不重复并且保持递增,这就是自增列。 - -Oracle 租户的自增列是通过 INSERT 语句中使用序列(sequence)实现的,有关序列详情请参考"创建和管理序列"章节。 diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/2.create-and-manage-tables-1/4.about-column-constraint-types-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/2.create-and-manage-tables-1/4.about-column-constraint-types-1.md deleted file mode 100644 index 90db8961c..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/2.create-and-manage-tables-1/4.about-column-constraint-types-1.md +++ /dev/null @@ -1,89 +0,0 @@ -关于列的约束类型 -============================= - - - -为了确保表里的数据符合业务规则,可以在列上定义约束。 - -约束定义在列上,限制了列里存储的值。当尝试在该列上写入或更新为违反约束定义的值时,会触发一个错误并回滚这个操作;当尝试在已有的表的列上加上一个跟现有数据相冲突的约束时,也会触发一个错误并回滚这个操作。 - -约束的类型有: - -* 非空约束(NOT NULL),不允许约束包含的列的值包含 NULL。 - - 如 ware 表的 w_name 列类型后面有 not null 约束,表示业务约束每个仓库必须有个名称。有非空约束的列,在 INSERT 语句中必须指明该列的值,除非该列还定义了默认值。如 cust 表的列 c_discount 定义了默认值 0.99,即业务上每个人默认折扣是 0.99。 - - - - - - - -* 唯一约束(UNIQUE),不允许约束包含的列的值有重复值,但是可以有多个 NULL 值。 - - 如 ware 表的 (w_name, w_city) 列上有个唯一约束,表示每个城市里仓库的名称必须是不重复的。 - - - - - - - -* 主键约束(PRIMARY KEY),是 NOT NULL 约束和唯一约束的组合。 - - 如 ware 表和 cust 表都有个主键 w_id 和 c_id ,这两列不允许为 NULL 并且必须是不重复的。 - - - - - - - -* 外键约束(FOREIGN KEY),要求约束的列的值取自于另外一个表的主键列。 - - 如 cust 表的 c_w_id 上有个外键约束引用了 ware 表的 w_id 列,表示业务上顾客归属的仓库必须是属于仓库表里的仓库。 - - -* CHECK 约束,要求数据库中某列的值符合指定的条件。 - - - - - - -外键约束和 CHECK 约束可以被启用或禁用,通过命令 `ALTER TABLE table_name MODIFY CONSTRAINT constrain_name ENABLE | DISABLE` 控制。默认情况下,约束创建后状态是启用的。 - -OceanBase 数据库默认是开启外键约束的,通过租户变量 foreign_key_checks 控制。 - -关于时间列的默认时间设置 ---------------------- - -当列上有 NOT NULL 约束时,通常建议设置默认值。当列类型是日期或时间类型时,可以设置默认值为数据库当前时间。 - -* 示例:为表的时间列设置默认值,可以使用 sysdate 或 systimestamp 函数。 - - - - - - -```javascript -obclient> create table t1(id number not null primary key, gmt_create date not null default sysdate, gmt_Modified date not null default sysdate); -Query OK, 0 rows affected (0.08 sec) - -obclient> insert into t1(id) values(1),(2),(3); -Query OK, 3 rows affected (0.01 sec) -Records: 3 Duplicates: 0 Warnings: 0 - -obclient> select * from t1; -+----+---------------------+---------------------+ -| ID | GMT_CREATE | GMT_MODIFIED | -+----+---------------------+---------------------+ -| 1 | 2020-04-02 18:16:45 | 2020-04-02 18:16:45 | -| 2 | 2020-04-02 18:16:45 | 2020-04-02 18:16:45 | -| 3 | 2020-04-02 18:16:45 | 2020-04-02 18:16:45 | -+----+---------------------+---------------------+ -3 rows in set (0.01 sec) -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/2.create-and-manage-tables-1/5.about-table-indexes-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/2.create-and-manage-tables-1/5.about-table-indexes-1.md deleted file mode 100644 index e7b2338d1..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/2.create-and-manage-tables-1/5.about-table-indexes-1.md +++ /dev/null @@ -1,119 +0,0 @@ -关于表的索引 -=========================== - - - -可以在表的一个或多个列上创建索引以加速表上的 SQL 语句执行速度。索引使用正确的话,可以减少物理 IO 或者逻辑 IO。 - -如果创建表时同时设置了主键,OceanBase 数据库会默认创建一个唯一索引。以下面的 SQL 为例: - -```javascript -obclient> create table t1(id number not null primary key, name varchar2(50)); -Query OK, 0 rows affected (0.05 sec) - -obclient> SELECT index_name,index_type,table_owner,table_name,uniqueness FROM user_indexes WHERE table_name='T1'; -+--------------------------+------------+-------------+------------+------------+ -| INDEX_NAME | INDEX_TYPE | TABLE_OWNER | TABLE_NAME | UNIQUENESS | -+--------------------------+------------+-------------+------------+------------+ -| T1_OBPK_1585822641424088 | NORMAL | TPCC | T1 | UNIQUE | -+--------------------------+------------+-------------+------------+------------+ -1 row in set (0.02 sec) -``` - - - -新增索引 -------------- - -为表增加索引可以通过 CREATE INDEX 语句。OceanBase 数据库能在普通表和分区表上创建索引,索引可以是本地索引或者全局索引。同时索引可以是唯一索引或者普通索引,如果是分区表的唯一索引,唯一索引必须包含表分区的拆分键。 - -创建索引的 SQL 语法格式如下: - -```javascript -CREATE [UNIQUE] INDEX index_name ON table_name ( column_list ) [LOCAL | GLOBAL] [ PARTITION BY column_list PARTITIONS N ] ; -``` - - - -Oracle 租户里,索引名称在租户范围内不能重复。索引可以从系统视图里查看,Oracle 租户查看索引的视图有:USER_INDEXES、ALL_INDEXES、DBA_INDEXES。 - -* 示例:为普通表创建普通索引 - - - - - - -```javascript -obclient> create index t1_name_ind on t1(name); -Query OK, 0 rows affected (0.43 sec) -obclient> SELECT index_name,index_type,table_owner,table_name,uniqueness FROM user_indexes where table_name='T1'; -+--------------------------+------------+-------------+------------+------------+ -| INDEX_NAME | INDEX_TYPE | TABLE_OWNER | TABLE_NAME | UNIQUENESS | -+--------------------------+------------+-------------+------------+------------+ -| T1_OBPK_1585822641424088 | NORMAL | TPCC | T1 | UNIQUE | -| T1_NAME_IND | NORMAL | TPCC | T1 | NONUNIQUE | -+--------------------------+------------+-------------+------------+------------+ -2 rows in set (0.02 sec) -``` - - - -* 示例:为分区表创建唯一的本地索引、普通的全局索引 - - 分区表的唯一索引必须包含分区表的分区键,分区表的全局索引要求分区表必须有主键。 - - - - - -```javascript -obclient> create table t3(id number not null primary key, name varchar2(50), gmt_create date not null default sysdate) partition by hash(id) partitions 8; -Query OK, 0 rows affected (0.09 sec) - -obclient> create unique index t3_uk on t3(name) local; -ERROR-00600: internal error code, arguments: -5261, A UNIQUE INDEX must include all columns in the table's partitioning function - -obclient> create unique index t3_uk on t3(name, id) local; -Query OK, 0 rows affected (2.32 sec) - -obclient> create index t3_ind2 on t3(gmt_create) global ; -Query OK, 0 rows affected (12.48 sec) - -obclient> SELECT index_name,index_type,table_owner,table_name,uniqueness,partitioned FROM user_indexes where table_name='T3'; -+--------------------------+------------+-------------+------------+------------+-------------+ -| INDEX_NAME | INDEX_TYPE | TABLE_OWNER | TABLE_NAME | UNIQUENESS | PARTITIONED | -+--------------------------+------------+-------------+------------+------------+-------------+ -| T3_OBPK_1585822748793678 | NORMAL | TPCC | T3 | UNIQUE | NO | -| T3_UK | NORMAL | TPCC | T3 | UNIQUE | YES | -| T3_IND2 | NORMAL | TPCC | T3 | NONUNIQUE | NO | -+--------------------------+------------+-------------+------------+------------+-------------+ -3 rows in set (0.03 sec) -``` - - - -删除索引 -------------- - -删除索引的语法格式如下: - -```javascript -DROP INDEX index_name ; -``` - - - -* 示例:删除表的索引 - - - - - - -```javascript -obclient> drop index t3_ind2; -Query OK, 0 rows affected (0.02 sec) -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/2.create-and-manage-tables-1/6.flashback-deleted-table-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/2.create-and-manage-tables-1/6.flashback-deleted-table-1.md deleted file mode 100644 index b17311f7e..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/2.create-and-manage-tables-1/6.flashback-deleted-table-1.md +++ /dev/null @@ -1,68 +0,0 @@ -闪回被删除的表 -============================ - - - -OceanBase 数据库支持回收站功能,通过回收站可以闪回已删除的表。默认回收站是开启的,回收站是否开启由租户变量 recyclebin 控制。 - -开启/关闭回收站的语法是: - -```javascript -set global recyclebin = ON | OFF ; -``` - - - -修改回收站的开启状态后,只对后续新连接会话生效。 - -* 示例:闪回被删除的表。 - - - - - - -```javascript -obclient> create table t1(id number not null primary key, gmt_create date not null default sysdate); -Query OK, 0 rows affected (0.09 sec) - -obclient> insert into t1(id) values(1),(2),(3); -Query OK, 3 rows affected (0.02 sec) -Records: 3 Duplicates: 0 Warnings: 0 - -obclient> select * from t1; -+----+---------------------+ -| ID | GMT_CREATE | -+----+---------------------+ -| 1 | 2020-04-02 18:20:49 | -| 2 | 2020-04-02 18:20:49 | -| 3 | 2020-04-02 18:20:49 | -+----+---------------------+ -3 rows in set (0.00 sec) - -obclient> drop table t1; -Query OK, 0 rows affected (0.03 sec) - -obclient> show recyclebin; -+-------------------------------------+------------------------------------+-------+----------------------------+ -| OBJECT_NAME | ORIGINAL_NAME | TYPE | CREATETIME | -+-------------------------------------+------------------------------------+-------+----------------------------+ -| RECYCLE_$_20200102_1585822884952336 | T1 | TABLE | 2020-04-02 18:21:24.952475 | -+-------------------------------------+------------------------------------+-------+----------------------------+ -1 rows in set (0.01 sec) - -obclient> flashback table RECYCLE_$_20200102_1585822884952336 to before drop rename to t1; -Query OK, 0 rows affected (0.02 sec) - -obclient> select * from t1; -+----+---------------------+ -| ID | GMT_CREATE | -+----+---------------------+ -| 1 | 2020-04-02 18:20:49 | -| 2 | 2020-04-02 18:20:49 | -| 3 | 2020-04-02 18:20:49 | -+----+---------------------+ -3 rows in set (0.00 sec) -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/3.create-and-manage-partition-table-1/1.partition-overview.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/3.create-and-manage-partition-table-1/1.partition-overview.md deleted file mode 100644 index 61a1f7fa1..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/3.create-and-manage-partition-table-1/1.partition-overview.md +++ /dev/null @@ -1,6 +0,0 @@ -分区概述 -========================= - - - -分区技术(Partitioning)是 OceanBase 非常重要的分布式能力之一,它能解决大表的容量问题和高并发访问时性能问题,主要思想就是将大表拆分为更多更小的结构相同的独立对象,即分区。普通的表只有一个分区,可以看作分区表的特例。每个分区只能存在于一个节点内部,分区表的不同分区可以分散在不同节点上。 diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/3.create-and-manage-partition-table-1/2.partition-routing-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/3.create-and-manage-partition-table-1/2.partition-routing-1.md deleted file mode 100644 index f0d17cef3..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/3.create-and-manage-partition-table-1/2.partition-routing-1.md +++ /dev/null @@ -1,36 +0,0 @@ -分区路由 -========================= - - - -OceanBase 的分区表是内建功能,您只需要在建表的时候指定分区策略和分区数即可。分区表的查询 SQL 跟普通表是一样的,OceanBase 的 OBProxy 或 OBServer 会自动将用户 SQL 路由到相应节点内,因此,分区表的分区细节对业务是透明的。 - -如果知道要读取的数据所在的分区号,可以通过 SQL 直接访问分区表的某个分区。简单语法格式如下: - -```javascript -part_table partition ( p[0,1,...][sp[0,1,...]] ) -``` - - - -默认情况下,除非表定义了分区名,分区名都是按一定规则编号,例如: - -* 一级分区名为:p0 , p1 , p2 , ... - -* 二级分区名为:p0sp0 , p0sp1 , p0sp2 , ... ; p1sp0 , p1sp1 , p1sp2 , ... - - - - - - -示例:访问分区表的具体分区。 - -```javascript -select * from t_log partition (p0) ; - -select * from t_log partition (p5sp0) ; -``` - - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/3.create-and-manage-partition-table-1/3.partitioning-policy-2.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/3.create-and-manage-partition-table-1/3.partitioning-policy-2.md deleted file mode 100644 index 80edebf25..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/3.create-and-manage-partition-table-1/3.partitioning-policy-2.md +++ /dev/null @@ -1,222 +0,0 @@ -分区策略 -========================= - - - -OceanBase 数据库支持多种分区策略: - -* 范围(RANGE)分区 - - - -* 列表(LIST)分区 - - - -* 哈希(HASH)分区 - - - -* 组合分区 - - - - - - -范围(RANGE)分区 --------------------- - -RANGE 分区根据分区表定义时为每个分区建立的分区键值范围,将数据映射到相应的分区中。它是常见的分区类型,经常跟日期类型一起使用。比如说,可以将业务日志表按日/周/月分区。 - -当使用 RANGE 分区时,需要遵守如下几个规则: - -* 每个分区都有一个 VALUES LESS THAN 子句,它为分区指定一个非包含的上限值。分区键的任何值等于或大于这个值时将被映射到下一个分区中。 - - - -* 除第一个分区外,所有分区都隐含一个下限值,即上一个分区的上限值。 - - - -* 允许且只允许最后一个分区上限定义为 MAXVALUE ,这个值没有具体的数值,比其他所有分区的上限都要大,也包含空值。 - - - - - - -示例:创建一个 RANGE 分区表。 - -```javascript -obclient> CREATE TABLE t_log_part_by_range ( - log_id number NOT NULL - , log_value varchar2(50) - , log_date date NOT NULL DEFAULT sysdate -) PARTITION BY RANGE(log_date) -( - PARTITION M202001 VALUES LESS THAN(TO_DATE('2020/02/01','YYYY/MM/DD')) - , PARTITION M202002 VALUES LESS THAN(TO_DATE('2020/03/01','YYYY/MM/DD')) - , PARTITION M202003 VALUES LESS THAN(TO_DATE('2020/04/01','YYYY/MM/DD')) - , PARTITION M202004 VALUES LESS THAN(TO_DATE('2020/05/01','YYYY/MM/DD')) - , PARTITION M202005 VALUES LESS THAN(TO_DATE('2020/06/01','YYYY/MM/DD')) - , PARTITION M202006 VALUES LESS THAN(TO_DATE('2020/07/01','YYYY/MM/DD')) - , PARTITION M202007 VALUES LESS THAN(TO_DATE('2020/08/01','YYYY/MM/DD')) - , PARTITION M202008 VALUES LESS THAN(TO_DATE('2020/09/01','YYYY/MM/DD')) - , PARTITION M202009 VALUES LESS THAN(TO_DATE('2020/10/01','YYYY/MM/DD')) - , PARTITION M202010 VALUES LESS THAN(TO_DATE('2020/11/01','YYYY/MM/DD')) - , PARTITION M202011 VALUES LESS THAN(TO_DATE('2020/12/01','YYYY/MM/DD')) - , PARTITION M202012 VALUES LESS THAN(TO_DATE('2021/01/01','YYYY/MM/DD')) - , PARTITION MMAX VALUES LESS THAN (MAXVALUE) -); -``` - - - -RANGE 分区可以新增、删除分区。如果最后一个 RANGE 分区指定了 MAXVALUE ,则不能新增分区。 - -列表(LIST)分区 -------------------- - -LIST 分区使得您可以显式的控制记录行如何映射到分区,具体方法是为每个分区的分区键指定一组离散值列表,这点跟 RANGE 分区和 HASH 分区都不同。LIST 分区的优点是可以方便的对无序或无关的数据集进行分区。 - -示例:创建一个 LIST 分区表。 - -```javascript -obclient> CREATE TABLE t_log_part_by_list ( - log_id number NOT NULL - , log_value varchar2(50) - , log_date date NOT NULL DEFAULT sysdate - , PRIMARY key(log_id, log_value) -) PARTITION BY list(log_value) -( - PARTITION P01 VALUES ( '01' ) - , PARTITION P02 VALUES ( '02' ) - , PARTITION P03 VALUES ( '03' ) - , PARTITION P04 VALUES ( '04' ) - , PARTITION P05 VALUES ( '05' ) -); -Query OK, 0 rows affected (0.10 sec) - -obclient> INSERT INTO t_log_part_by_list(log_id, log_value) values(1,'01'),(2,'02'),(3,'03'),(4,'04'),(5,'05'),(6,'01'); -Query OK, 6 rows affected (0.01 sec) -Records: 6 Duplicates: 0 Warnings: 0 -``` - - - -LIST 分区可以新增分区,指定新的不重复的列表。 - -哈希(HASH)分区 -------------------- - -HASH 分区适合于对不能用 RANGE 分区、LIST 分区方法的场景,它的实现方法简单,通过对分区键上的 HASH 函数值来散列记录到不同分区中。如果您的数据符合下列特点,使用 HASH 分区是个很好的选择: - -* 不能指定数据的分区键的列表特征。 - - - -* 不同范围内的数据大小相差非常大,并且很难手动调整均衡。 - - - -* 使用 RANGE 分区后数据聚集严重。 - - - -* 并行 DML、分区剪枝和分区连接等性能非常重要。 - - - - - - -示例:创建一个 HASH 分区表。 - -```javascript -obclient> CREATE TABLE ware( - w_id number - , w_ytd number(12,2) - , w_tax number(4,4) - , w_name varchar(10) - , w_street_1 varchar(20) - , w_street_2 varchar(20) - , w_city varchar(20) - , w_state char(2) - , w_zip char(9) - , primary key(w_id) -) PARTITION by hash(w_id) partitions 60; -``` - - - -HASH 分区不适合做删除操作。 - -组合分区 -------------- - -组合分区通常是先使用一种分区策略,然后在子分区再使用另外一种分区策略,适合于业务表的数据量非常大时。使用组合分区能发挥多种分区策略的优点。 - -在指定二级分区分区策略细节时,可以使用 SUBPARTITION TEMPLATE 子句。OceanBase 数据库目前支持模板化二级分区和非模板化二级分区。 - -示例:创建组合分区表。 - -```javascript -obclient> CREATE TABLE t_ordr_part_by_hash_range (o_w_id int -, o_d_id int -, o_id int -, o_c_id int -, o_carrier_id int -, o_ol_cnt int -, o_all_local int -, o_entry_d date -, index idx_ordr(o_w_id, o_d_id, o_c_id, o_id) LOCAL -, primary key ( o_w_id, o_d_id, o_id, o_entry_d ) -) -PARTITION BY hash(o_w_id) -SUBPARTITION BY RANGE(o_entry_d) -SUBPARTITION template -( - SUBPARTITION M202001 VALUES LESS THAN(TO_DATE('2020/02/01','YYYY/MM/DD')) - , SUBPARTITION M202002 VALUES LESS THAN(TO_DATE('2020/03/01','YYYY/MM/DD')) - , SUBPARTITION M202003 VALUES LESS THAN(TO_DATE('2020/04/01','YYYY/MM/DD')) - , SUBPARTITION M202004 VALUES LESS THAN(TO_DATE('2020/05/01','YYYY/MM/DD')) - , SUBPARTITION M202005 VALUES LESS THAN(TO_DATE('2020/06/01','YYYY/MM/DD')) - , SUBPARTITION M202006 VALUES LESS THAN(TO_DATE('2020/07/01','YYYY/MM/DD')) - , SUBPARTITION M202007 VALUES LESS THAN(TO_DATE('2020/08/01','YYYY/MM/DD')) - , SUBPARTITION M202008 VALUES LESS THAN(TO_DATE('2020/09/01','YYYY/MM/DD')) - , SUBPARTITION M202009 VALUES LESS THAN(TO_DATE('2020/10/01','YYYY/MM/DD')) - , SUBPARTITION M202010 VALUES LESS THAN(TO_DATE('2020/11/01','YYYY/MM/DD')) - , SUBPARTITION M202011 VALUES LESS THAN(TO_DATE('2020/12/01','YYYY/MM/DD')) - , SUBPARTITION M202012 VALUES LESS THAN(TO_DATE('2021/01/01','YYYY/MM/DD')) - , SUBPARTITION MMAX VALUES LESS THAN (MAXVALUE) -) -partitions 16; -Query OK, 0 rows affected (1.36 sec) - -obclient> CREATE TABLE t_log_part_by_range_hash ( - log_id number NOT NULL - , log_value varchar2(50) - , log_date date NOT NULL DEFAULT sysdate - , PRIMARY key(log_id, log_date) -) PARTITION BY RANGE(log_date) -SUBPARTITION BY HASH(log_id) SUBPARTITIONS 16 -( - PARTITION M202001 VALUES LESS THAN(TO_DATE('2020/02/01','YYYY/MM/DD')) - , PARTITION M202002 VALUES LESS THAN(TO_DATE('2020/03/01','YYYY/MM/DD')) - , PARTITION M202003 VALUES LESS THAN(TO_DATE('2020/04/01','YYYY/MM/DD')) - , PARTITION M202004 VALUES LESS THAN(TO_DATE('2020/05/01','YYYY/MM/DD')) - , PARTITION M202005 VALUES LESS THAN(TO_DATE('2020/06/01','YYYY/MM/DD')) - , PARTITION M202006 VALUES LESS THAN(TO_DATE('2020/07/01','YYYY/MM/DD')) - , PARTITION M202007 VALUES LESS THAN(TO_DATE('2020/08/01','YYYY/MM/DD')) - , PARTITION M202008 VALUES LESS THAN(TO_DATE('2020/09/01','YYYY/MM/DD')) - , PARTITION M202009 VALUES LESS THAN(TO_DATE('2020/10/01','YYYY/MM/DD')) - , PARTITION M202010 VALUES LESS THAN(TO_DATE('2020/11/01','YYYY/MM/DD')) - , PARTITION M202011 VALUES LESS THAN(TO_DATE('2020/12/01','YYYY/MM/DD')) - , PARTITION M202012 VALUES LESS THAN(TO_DATE('2021/01/01','YYYY/MM/DD')) - , PARTITION MMAX VALUES LESS THAN (MAXVALUE) -); -Query OK, 0 rows affected (1.09 sec) -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/3.create-and-manage-partition-table-1/4.partition-table-index-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/3.create-and-manage-partition-table-1/4.partition-table-index-1.md deleted file mode 100644 index fbe913e4f..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/3.create-and-manage-partition-table-1/4.partition-table-index-1.md +++ /dev/null @@ -1,33 +0,0 @@ -分区表的索引 -=========================== - - - -分区表的查询性能跟 SQL 中条件有关。当 SQL 中带上拆分键时,OceanBase 数据库会根据条件做分区剪枝,只用搜索特定的分区即可;如果没有拆分键,则要扫描所有分区。 - -分区表也可以通过创建索引来提升性能。跟分区表一样,分区表的索引也可以分区或者不分区。 - -* 如果分区表的索引不分区,就是一个全局索引(GLOBAL),是一个独立的分区,索引数据覆盖整个分区表。 - - - -* 如果分区表的索引分区了,根据分区策略又可以分为两类。一是跟分区表保持一致的分区策略,则每个索引分区的索引数据覆盖相应的分区表的分区,这个索引又叫本地索引(LOCAL)。 - - - - - - -建议尽可能的使用本地索引,只有在有必要的时候才使用全局索引。其原因是全局索引会降低 DML 的性能,DML 可能会因此产生分布式事务。 - -通常创建索引时默认都是全局索引,本地索引需要在后面增加关键字 LOCAL 。 - -示例:创建分区表的本地索引。 - -```javascript -obclient> CREATE INDEX idx_log_date ON t_log_part_by_range_hash(log_date) LOCAL; -Query OK, 0 rows affected (5.16 sec) -``` - - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/3.create-and-manage-partition-table-1/5.use-of-partition-table-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/3.create-and-manage-partition-table-1/5.use-of-partition-table-1.md deleted file mode 100644 index 25d914e56..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/3.create-and-manage-partition-table-1/5.use-of-partition-table-1.md +++ /dev/null @@ -1,121 +0,0 @@ -分区表使用建议 -============================ - - - -通常当表的数据量非常大,以致于可能使数据库空间紧张,或者由于表非常大导致相关 SQL 查询性能变慢时,可以考虑使用分区表。 - -唯一索引和拆分键 ------------------ - -使用分区表时要选择合适的拆分键以及拆分策略。如果是日志类型的大表,根据时间类型的列做 RANGE 分区是最合适的。如果是并发访问非常高的表,结合业务特点选择能满足绝大部分核心业务查询的列作为拆分键是最合适的。无论选哪个列做为分区键,都不大可能满足所有的查询性能。 - -分区表中的全局唯一性需求可以通过主键约束和唯一约束实现。OceanBase 数据库的分区表的主键约束和唯一键约束必须包含拆分键。唯一约束也是一个全局索引。全局唯一的需求也可以通过本地唯一索引实现,只需要在唯一索引里包含拆分键。 - -示例:创建有唯一性需求的分区表 - -```javascript -obclient> CREATE TABLE account( - id number NOT NULL PRIMARY KEY - , name varchar2(50) NOT NULL UNIQUE - , value number NOT NULL - , gmt_create date DEFAULT sysdate NOT NULL - , gmt_modified date DEFAULT sysdate NOT NULL -) PARTITION BY HASH(id) PARTITIONS 16; -Query OK, 0 rows affected (0.22 sec) - -obclient> CREATE TABLE account2( - id number NOT NULL PRIMARY KEY - , name varchar2(50) NOT NULL - , value number NOT NULL - , gmt_create date DEFAULT sysdate NOT NULL - , gmt_modified date DEFAULT sysdate NOT NULL -) PARTITION BY HASH(id) PARTITIONS 16; -Query OK, 0 rows affected (0.14 sec) - -obclient> CREATE UNIQUE INDEX account2_uk ON account2(name, id) LOCAL ; -Query OK, 0 rows affected (0.75 sec) - -obclient> SELECT table_Name,index_name,uniqueness,partitioned FROM user_Indexes WHERE table_name LIKE 'ACCOUNT%'; -+------------+-----------------------------------+------------+-------------+ -| TABLE_NAME | INDEX_NAME | UNIQUENESS | PARTITIONED | -+------------+-----------------------------------+------------+-------------+ -| ACCOUNT | ACCOUNT_OBPK_1585823071504331 | UNIQUE | NO | -| ACCOUNT | ACCOUNT_OBUNIQUE_1585823071505517 | UNIQUE | NO | -| ACCOUNT2 | ACCOUNT2_OBPK_1585823071631837 | UNIQUE | NO | -| ACCOUNT2 | ACCOUNT2_UK | UNIQUE | YES | -+------------+-----------------------------------+------------+-------------+ -4 rows in set (0.03 sec) - -obclient> SELECT table_name, constraint_name, constraint_type, status, index_name FROM user_constraints t WHERE table_name LIKE 'ACCOUNT%'\G -*************************** 1. row *************************** - TABLE_NAME: ACCOUNT -CONSTRAINT_NAME: ACCOUNT_OBUNIQUE_1585385880987688 -CONSTRAINT_TYPE: U - STATUS: NULL - INDEX_NAME: ACCOUNT_OBUNIQUE_1585385880987688 -*************************** 2. row *************************** - TABLE_NAME: ACCOUNT2 -CONSTRAINT_NAME: ACCOUNT2_UK -CONSTRAINT_TYPE: U - STATUS: NULL - INDEX_NAME: ACCOUNT2_UK -*************************** 3. row *************************** - TABLE_NAME: ACCOUNT -CONSTRAINT_NAME: ACCOUNT_OBPK_1585385880986752 -CONSTRAINT_TYPE: P - STATUS: ENABLED - INDEX_NAME: ACCOUNT_OBPK_1585385880986752 -*************************** 4. row *************************** - TABLE_NAME: ACCOUNT2 -CONSTRAINT_NAME: ACCOUNT2_OBPK_1585386277230890 -CONSTRAINT_TYPE: P - STATUS: ENABLED - INDEX_NAME: ACCOUNT2_OBPK_1585386277230890 -4 rows in set (0.01 sec) -``` - - - -更新分区键 --------------- - -在针对分区表做 UPDATE 时,如果更新了分区键,理论上记录有可能需要从一个分区移动到另外一个分区。如果系统检测到 UPDATE 操作会导致分区移动,则会禁止这种更新。 - -```javascript -obclient> create table t_part(id number not null , c1 varchar2(10) not null, c2 varchar2(100), primary key(id,c1)) partition by hash(c1) partitions 8; -Query OK, 0 rows affected (0.29 sec) - -obclient> insert into t_part(id,c1,c2) values(1,'A','aaaaaaaa'),(2,'B','bbbbbbbbb'),(3,'C','ccccccccc'),(4,'D','dddddddd'); -Query OK, 4 rows affected (0.04 sec) -Records: 4 Duplicates: 0 Warnings: 0 - -obclient> select * from t_part; -+----+----+-----------+ -| ID | C1 | C2 | -+----+----+-----------+ -| 3 | C | ccccccccc | -| 2 | B | bbbbbbbbb | -| 4 | D | dddddddd | -| 1 | A | aaaaaaaa | -+----+----+-----------+ -4 rows in set (0.05 sec) - -obclient> update t_part set c1='CC' where c1='C*'; -ORA-14402: updating partition key column would cause a partition change -``` - - - -如果分区键的值没有变化,建议不要更新它。如果分区键的值有变化,则需要开启表的如下属性: - -```javascript -obclient> alter table t_part enable row movement; -Query OK, 0 rows affected (0.02 sec) - -obclient> update t_part set c1='CC' where c1='C'; -Query OK, 1 row affected (0.00 sec) -Rows matched: 1 Changed: 1 Warnings: 0 -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/4.create-and-manage-table-groups-1/1.about-table-groups-2.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/4.create-and-manage-table-groups-1/1.about-table-groups-2.md deleted file mode 100644 index c179cb5a4..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/4.create-and-manage-table-groups-1/1.about-table-groups-2.md +++ /dev/null @@ -1,19 +0,0 @@ -关于表组 -========================= - - - -表组是表的属性,会影响多个表的分区在 OBServer 上的分布特征。 - -不同表的分区有可能分布在不同的节点上,当两个表做表连接查询时,OceanBase 数据库会跨节点请求数据,执行时间就跟节点间请求延时有关。在 SQL 调优时,OceanBase 数据库建议对业务上关系密切的表,设置相同的表组。OceanBase 数据库对于同一个表组中的表的同号分区会管理为一个分区组。同一个分区组中的分区,OceanBase 数据库会将其尽可能的分配到同一个节点内部,这样就可以规避跨节点的请求。 - -创建表组时,首先要规划好表组的用途。如果是用于普通表的属性,表组就不用分区;如果是用于分区表的属性,表组就要指定分区策略,并且要跟分区表的分区策略保持一致。 - -示例:创建表组 - -```javascript -obclient> create tablegroup tpcc_group partition by hash partitions 6 ; -Query OK, 0 rows affected (0.03 sec) -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/4.create-and-manage-table-groups-1/2.specify-a-table-group-when-creating-a-table-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/4.create-and-manage-table-groups-1/2.specify-a-table-group-when-creating-a-table-1.md deleted file mode 100644 index aa3676f8d..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/4.create-and-manage-table-groups-1/2.specify-a-table-group-when-creating-a-table-1.md +++ /dev/null @@ -1,50 +0,0 @@ -创建表时指定表组 -============================= - - - -表组可以在创建表的时候指定,SQL 查询语法格式如下: - -```javascript -CREATE TABLE table_name ( -column_name data_type [, column_name data_type] -) TABLEGROUP tablegroup_name ; -``` - - - -示例:创建表时指定表组。 - -如下创建订单表和订单明细表,业务上这两个表经常要关联查询,所以建议放到同一个表组中。 - -```javascript -obclient> create table ordr ( - o_w_id int - , o_d_id int - , o_id int - , o_c_id int - , o_carrier_id int - , o_ol_cnt int - , o_all_local int - , o_entry_d date - , index iordr(o_w_id, o_d_id, o_c_id, o_id) local - , primary key ( o_w_id, o_d_id, o_id ) -)tablegroup tpcc_group partition by hash(o_w_id) partitions 6; -Query OK, 0 rows affected (0.13 sec) - -obclient> create table ordl ( - ol_w_id int - , ol_d_id int - , ol_o_id int - , ol_number int - , ol_delivery_d date - , ol_amount decimal(6, 2) - , ol_i_id int - , ol_supply_w_id int - , ol_quantity int - , ol_dist_info char(24) - , primary key (ol_w_id, ol_d_id, ol_o_id, ol_number ) -)tablegroup tpcc_group partition by hash(ol_w_id) partitions 6; -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/4.create-and-manage-table-groups-1/3.view-table-group-information-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/4.create-and-manage-table-groups-1/3.view-table-group-information-1.md deleted file mode 100644 index 5c2dadcf8..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/4.create-and-manage-table-groups-1/3.view-table-group-information-1.md +++ /dev/null @@ -1,36 +0,0 @@ -查看表组信息 -=========================== - - - -使用命令 SHOW TABLEGROUPS 和 SHOW CREATE TABLE 来查看表组信息。 - -示例:查看表组信息和定义 - -```javascript -obclient> show tablegroups; -+-----------------+------------+---------------+ -| TABLEGROUP_NAME | TABLE_NAME | DATABASE_NAME | -+-----------------+------------+---------------+ -| TPCC_GROUP | CUST | TPCC | -| TPCC_GROUP | DIST | TPCC | -| TPCC_GROUP | HIST | TPCC | -| TPCC_GROUP | NORD | TPCC | -| TPCC_GROUP | ORDL | TPCC | -| TPCC_GROUP | ORDR | TPCC | -| TPCC_GROUP | STOK | TPCC | -| TPCC_GROUP | WARE | TPCC | -| oceanbase | NULL | NULL | -+-----------------+------------+---------------+ -9 rows in set (0.02 sec) - -obclient> show create tablegroup tpcc_group\G -*************************** 1. row *************************** - TABLEGROUP: TPCC_GROUP -CREATE TABLEGROUP: CREATE TABLEGROUP "TPCC_GROUP" BINDING = FALSE - partition by hash partitions 6 - -1 row in set (0.00 sec) -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/4.create-and-manage-table-groups-1/4.add-table-to-table-group-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/4.create-and-manage-table-groups-1/4.add-table-to-table-group-1.md deleted file mode 100644 index 22859fc48..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/4.create-and-manage-table-groups-1/4.add-table-to-table-group-1.md +++ /dev/null @@ -1,51 +0,0 @@ -向表组中增加表 -============================ - - - -如果表创建的时候没有指定表组,也可以事后加入到表组中。有两种方法:一是修改表的表组属性,二是使用 ALTER TABLEGROUP ADD 语法。 - -* 示例:修改表的表组属性 - - - - - -**注意** - - - -修改表的表组属性时名字不用单引号,否则会区分大小写。 - -```javascript -obclient> alter table ordr tablegroup=tpcc_group; -Query OK, 0 rows affected (0.04 sec) - -obclient> alter table ordl tablegroup=tpcc_group; -Query OK, 0 rows affected (0.04 sec) -``` - - - -* 示例:向表组中加入表 - - - - -向表组中加入表的前提是表的分区策略跟表组的分区策略保持一致。 - -```javascript -obclient> alter table ordr tablegroup=''; -Query OK, 0 rows affected (0.04 sec) - -obclient> alter table ordl tablegroup=''; -Query OK, 0 rows affected (0.03 sec) - -obclient> alter tablegroup tpcc_group add ordr, ordl ; -Query OK, 0 rows affected (0.03 sec) - -obclient> -``` - - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/4.create-and-manage-table-groups-1/5.delete-a-table-group-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/4.create-and-manage-table-groups-1/5.delete-a-table-group-1.md deleted file mode 100644 index b7ccb467a..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/4.create-and-manage-table-groups-1/5.delete-a-table-group-1.md +++ /dev/null @@ -1,6 +0,0 @@ -删除表组 -========================= - - - -如果要删除表组,得先确认表组中没有表。具体方法就是从表组中删除表,或者将相关表的表组属性清空。 diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/5.create-and-manage-views-1/1.create-a-view-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/5.create-and-manage-views-1/1.create-a-view-1.md deleted file mode 100644 index 88ac71655..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/5.create-and-manage-views-1/1.create-a-view-1.md +++ /dev/null @@ -1,22 +0,0 @@ -创建视图 -========================= - - - -可以使用 CREATE VIEW 语句来创建视图。 - -示例:创建视图 stock_item,该视图内容取自 stock 和 item 两张表,两张表做表连接就得到这个视图。 - -```javascript -obclient> CREATE VIEW stock_item - AS - SELECT /*+ leading(s) use_merge(i) */ - i_price, i_name, i_data, s_i_id, s_w_id, s_order_cnt, s_ytd, s_remote_cnt, s_quantity, s_data, s_dist_01, s_dist_02, s_dist_03, s_dist_04, s_dist_05, s_dist_06, s_dist_07, s_dist_08, s_dist_09, s_dist_10 - FROM stok s, item i - WHERE s.s_i_id = i.i_id; -Query OK, 0 rows affected (0.01 sec) -``` - - - -查看更多创建视图的选项,请参见《SQL参考(MySQL模式)》。 diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/5.create-and-manage-views-1/2.modify-view-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/5.create-and-manage-views-1/2.modify-view-1.md deleted file mode 100644 index 0e3c194f0..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/5.create-and-manage-views-1/2.modify-view-1.md +++ /dev/null @@ -1,21 +0,0 @@ -修改视图 -========================= - - - -可以使用 CREATE OR REPLACE VIEW 语句来对视图进行修改。 - -示例:修改视图 stock_item。 - -```javascript -obclient> CREATE OR REPLACE VIEW stock_item - AS - SELECT /*+ leading(s) use_merge(i) */ - i_price, i_name, i_data, s_i_id, s_w_id, s_order_cnt, s_ytd, s_remote_cnt, s_quantity, s_data, s_dist_01, s_dist_02, s_dist_03, s_dist_04, s_dist_05, s_dist_06, s_dist_07, s_dist_08, s_dist_09, s_dist_10 - FROM stok s, item i - WHERE s.s_i_id = i.i_id; -Query OK, 0 rows affected (0.02 sec) -``` - - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/5.create-and-manage-views-1/3.delete-a-view-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/5.create-and-manage-views-1/3.delete-a-view-1.md deleted file mode 100644 index 81066c2ae..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/5.create-and-manage-views-1/3.delete-a-view-1.md +++ /dev/null @@ -1,8 +0,0 @@ -删除视图 -========================= - - - -删除视图使用 DROP VIEW 语句。 - -删除视图并不会删除视图引用的表。如果视图被其他视图所引用,视图删除后将会导致依赖当前视图的其他视图查询失败。 diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/6.create-and-manage-sequences/1.overview-6.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/6.create-and-manage-sequences/1.overview-6.md deleted file mode 100644 index 28aa59616..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/6.create-and-manage-sequences/1.overview-6.md +++ /dev/null @@ -1,6 +0,0 @@ -概述 -======================= - - - -序列(Sequence)是 Oracle 租户的数据库对象,可以产生不重复的有顺序的值,在表需要不重复的列做主键时很有用。序列可以提供两个伪列 CURRVAL 和 NEXTVAL ,每次查询会返回当前的序列值和下一个序列值。每当查询 NEXTVAL 都会推进 CURRVAL 值。 diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/6.create-and-manage-sequences/2.creating-and-using-sequences.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/6.create-and-manage-sequences/2.creating-and-using-sequences.md deleted file mode 100644 index f8cb608ef..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/6.create-and-manage-sequences/2.creating-and-using-sequences.md +++ /dev/null @@ -1,72 +0,0 @@ -创建序列和使用序列 -============================== - - - -CREATE SEQUENCE 语句用来创建序列,语法格式如下: - -```javascript -CREATE SEQUENCE sequence_name -[MINVALUE value | NOMINVALUE] -[MAXVALUE value | NOMAXVALUE] -[START WITH value] -[INCREMENT BY value] -[CACHE value | NOCACHE] -[ORDER | NOORDER] -[CYCLE | NOCYCLE]; -``` - - - -其中,MINVALUE 和 MAXVALUE 指定最小值和最大值;START WITH 指定起始值;INCREMENT BY 指定步长,可以为负数,默认是1;CACHE 是为了性能缓存部分序列值,并发高的时候使用;CYCLE 指定序列值是否循环,如果循环,需要指定最大值或最小值。 - -示例:创建序列,实现表的列自增。 - -```javascript -obclient> create table t1(id number not null primary key, name varchar(50) , gmt_create date not null default sysdate); -Query OK, 0 rows affected (0.07 sec) - -obclient> create sequence seq_t1 start with 10000 increment by 1 cache 50 nocycle; -Query OK, 0 rows affected (0.04 sec) - -obclient> insert into t1(id,name) values(seq_t1.nextval, 'A'); -Query OK, 1 row affected (0.02 sec) - -obclient> insert into t1(id,name) values(seq_t1.nextval, 'B'); -Query OK, 1 row affected (0.00 sec) - -obclient> insert into t1(id,name) values(seq_t1.nextval, 'C'); -Query OK, 1 row affected (0.00 sec) - -obclient> select * from t1; -+-------+------+---------------------+ -| ID | NAME | GMT_CREATE | -+-------+------+---------------------+ -| 10000 | A | 2020-04-02 18:30:29 | -| 10001 | B | 2020-04-02 18:30:34 | -| 10002 | C | 2020-04-02 18:30:39 | -+-------+------+---------------------+ -3 rows in set (0.01 sec) -``` - - - -序列创建成功后,可以通过 USER_SEQUENCES、ALL_SEQUENCES、DBA_SEQUENCES 视图查看自己创建的序列。 - -```javascript -obclient> select * from user_sequences \G -*************************** 1. row *************************** -SEQUENCE_NAME: SEQ_T1 - MIN_VALUE: 1 - MAX_VALUE: 9999999999999999999999999999 - INCREMENT_BY: 1 - CYCLE_FLAG: N - ORDER_FLAG: N - CACHE_SIZE: 50 - LAST_NUMBER: 10100 -1 row in set (0.00 sec) -obclient> -``` - - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/6.create-and-manage-sequences/3.modify-sequence-properties.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/6.create-and-manage-sequences/3.modify-sequence-properties.md deleted file mode 100644 index 236ad2e71..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/6.create-and-manage-sequences/3.modify-sequence-properties.md +++ /dev/null @@ -1,18 +0,0 @@ -修改序列属性 -=========================== - - - -ALTER SEQUENCE 语句用来修改序列的属性。序列的起始值不能修改,其他属性如最小值、最大值、步长、循环属性都可以修改。语法格式如下: - -```javascript -ALTER SEQUENCE sequence_name -[MINVALUE value | NOMINVALUE] -[MAXVALUE value | NOMAXVALUE] -[INCREMENT BY value] -[CACHE value | NOCACHE] -[ORDER | NOORDER] -[CYCLE | NOCYCLE]; -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/6.create-and-manage-sequences/4.delete-sequence.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/6.create-and-manage-sequences/4.delete-sequence.md deleted file mode 100644 index 9aa6e20a4..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/6.create-and-manage-sequences/4.delete-sequence.md +++ /dev/null @@ -1,13 +0,0 @@ -删除序列 -========================= - - - -DROP SEQUENCE 语句用来删除序列,语法格式如下: - -```javascript -DROP SEQUENCE sequence_name; -``` - - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/7.create-and-manage-synonyms/1.overview-7.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/7.create-and-manage-synonyms/1.overview-7.md deleted file mode 100644 index 02d1c5af1..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/7.create-and-manage-synonyms/1.overview-7.md +++ /dev/null @@ -1,6 +0,0 @@ -概述 -======================= - - - -同义词是一个 Oracle 租户数据库对象的别名。使用同义词通常是为了管理权限方便,因为同义词可以隐藏另外一个数据对象的所有者权限。 diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/7.create-and-manage-synonyms/2.create-a-synonym.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/7.create-and-manage-synonyms/2.create-a-synonym.md deleted file mode 100644 index 71e8f4f6a..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/7.create-and-manage-synonyms/2.create-a-synonym.md +++ /dev/null @@ -1,83 +0,0 @@ -创建同义词 -========================== - - - -同义词的所有者跟目标数据库对象的所有者通常是不一样的,也可以一样。当所有者不一样的时候,需要确保同义词的所有者有权限访问实际对象所有者对应的表。 - -CREATE SYNONYM 语句用来创建同义词,语法格式如下: - -```javascript -CREATE SYNONYM synonym_name FOR [owner.]object_name ; -``` - - - -示例:创建跨数据库所有者的同义词 - -创建单独的用户 tpcc_ro ,对用户 tpcc 赋权允许使用 grant 命令。 - -```javascript -obclient> create user tpcc_ro identified by 123456; -Query OK, 0 rows affected (0.04 sec) - -obclient> grant all privileges on tpcc_ro.* to tpcc_ro; -Query OK, 0 rows affected (0.02 sec) - -obclient> grant create synonym on *.* to tpcc_ro ; -Query OK, 0 rows affected (0.02 sec) - -obclient> grant select on sys.* to tpcc_ro ; -Query OK, 0 rows affected (0.01 sec) - -obclient> grant all privileges on tpcc.* to tpcc with grant option; -Query OK, 0 rows affected (0.02 sec) -``` - - - -登录 tpcc 用户,授权用户 tpcc_ro 读取表 ordr 、ordl。 - -```javascript -$obclient -h127.1 -utpcc@oracle0_85#obv22_stable -P2883 -p123456 tpcc - -Type 'help;' or '\h' for help. Type '\c' to clear the current input statement. - -obclient> grant select on ordr to tpcc_ro; -Query OK, 0 rows affected (0.02 sec) - -obclient> grant select on ordl to tpcc_ro; -Query OK, 0 rows affected (0.01 sec) -``` - - - -登录 tpcc_ro 用户,创建同义词。 - -```javascript -obclient> create synonym ordr for tpcc.ordr; -Query OK, 0 rows affected (0.02 sec) - -obclient> create synonym ordl for tpcc.ordl; -Query OK, 0 rows affected (0.01 sec) - -obclient> select count(*) from ordr t1 join ordl t2 on (t1.o_w_id=t2.ol_w_id and t1.o_d_id=t2.ol_d_id and t1.o_id=t2.ol_o_id); -+----------+ -| COUNT(*) | -+----------+ -| 626 | -+----------+ -1 row in set (0.02 sec) - -obclient> select * from user_synonyms; -+--------------+-------------+------------+---------+ -| SYNONYM_NAME | TABLE_OWNER | TABLE_NAME | DB_LINK | -+--------------+-------------+------------+---------+ -| ORDR | TPCC | ORDR | NULL | -| ORDL | TPCC | ORDL | NULL | -| WARE | TPCC | WARE | NULL | -+--------------+-------------+------------+---------+ -3 rows in set (0.02 sec) -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/7.create-and-manage-synonyms/3.delete-a-synonym.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/7.create-and-manage-synonyms/3.delete-a-synonym.md deleted file mode 100644 index 753b94d67..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/4.create-and-manage-database-objects-1/7.create-and-manage-synonyms/3.delete-a-synonym.md +++ /dev/null @@ -1,13 +0,0 @@ -删除同义词 -========================== - - - -DROP SYNONYM 语句用来删除同义词,语法格式如下: - -```javascript -DROP SYNONYM synonym_name ; -``` - - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/5.working-in-a-global-environment/1.features-of-globalization-support.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/5.working-in-a-global-environment/1.features-of-globalization-support.md deleted file mode 100644 index fd13a9a34..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/5.working-in-a-global-environment/1.features-of-globalization-support.md +++ /dev/null @@ -1,94 +0,0 @@ -关于全球化支持的特性 -=============================== - - - -OceanBase 数据库的国际化支持特性目标是确保您可以部署能运行在任意国家的多语言程序。应用程序可以使用用户的母语和区域设置首选项呈现用户界面的内容,并处理数据。当前 OceanBase 数据库在展现界面时只支持英语。 - -在过去,ORACLE 数据库将全球化支持称为国家语言支持(National Language Support, NLS),NLS 实际是全球化支持的一个子集。OceanBase 数据库的 Oralce 模式兼容 ORACLE 数据库,继续沿用这个称呼。 NLS 是使用特定字符集选择国家语言和存储数据的能力,用一序列 NLS 参数实现。 - -关于语言支持 ---------------- - -OceanBase 数据库存储数据时使用 UTF8MB4 字符集,可以存储绝大部分语言的字符。但是在本地消息、货币、时间日期等区域化展示方面,OceanBase 数据库当前版本只支持英语。客户端连接环境的 NLS_LANG 设置目前对 OceanBase 数据库连接没有影响。 - -关于地区支持 ---------------- - -OceanBase 数据库当前版本对地区只支持美国英语地区,默认值为 AMERICA 。默认的本地时间格式、日期格式、数字和货币格式都取决于该地区的设置。 - -关于日期和时间格式 ------------------- - -OceanBase 数据库当前版本对日期和时间格式只支持美国英语地区的日期和时间格式。默认的日期格式是:DD-MON-RR,默认的时间戳格式是:DD-MON-RR HH.MI.SSXFF AM 或 DD-MON-RR HH.MI.SSXFF AM TZR 。OceanBase 数据库支持通过更改会话参数或者实例参数调整日期和时间格式。 - -### 关于日历格式 - -OceanBase 数据库当前版本对日历格式只支持格列高利历(GREGORIAN ,又叫公历)。 - -关于数值和金额格式 ------------------- - -不同的国家使用不同的数值和货币约定格式。OceanBase 数据库当前版本暂不支持货币格式设置,支持默认的数值分隔符是:., 。 - -关于字符串比较和排序 -------------------- - -OceanBase 数据库当前版本只支持按 BINARY 比较和排序字符串,不支持修改。 - -关于长度语义 ---------------- - -如果要以字节为单位计算字符串的长度,您需要知道在所使用的字符集中每个字符占多少个字节。 - -在单字节字符集中,字符串的字节数跟字符数是一致的;在多字节字符集中,一个字符会包含一到多个字节。特别是在变宽字符集中,很难根据字节长度计算字符数。以字节为单位计算列长称为 **字节语义** ,而以字符为单位计算列长称为 **字符语义** 。 - -字符语义用于指定不同宽度的多字符串的存储需求。例如,在 Unicode 数据库(AL32UTF8)中,假设您必须有一个 VARCHAR2 列,它可以存储最多五个汉字和五个英文字符。使用字节语义,此列要求汉字 15 个字节(每个汉字字长 3 个字节),英文字符 5 个字节(每个英文字长 1 个字节),共 20 个字节。如果使用字符语义,该列需要 10 个字符。 - -OceanBase 数据库的 Oracle 模式默认使用字节语义。 - -关于 Unicode 和 SQL 国家字符数据类型 ----------------------------------- - -Unicode 是个编码系统,定义世界上大部分语言的字符。在 Unicode 中,每个字符都有一个唯一的编码,与平台、程序或语言无关。 - -在 OceanBase 数据库的 Oracle 模式中,有两种方式存储 Unicode 字符: - -* 可以创建租户时指定字符集为 UTF8,这样您可以在 SQL 的字符类型(CHAR , VARCHAR2 , CLOB 和 LONG)数据中存储 UTF-8 编码的字符。 - - - -* 可以声明和使用 SQL 国家字符类型的列和变量。 - - - - - - -SQL 国家字符类型包括 NCHAR,NVARCHAR2 和 NCLOB(OceanBase 数据库当前版本还不支持 NCLOB),它们也被称为 Unicode 数据类型,因为仅用于存储 Unicode 数据。 - -Unicode 数据使用的是国家字符集,在创建实例时指定。OceanBase 数据库支持两种国家字符集:UTF8 或 AL6UTF16(默认)。 - -当声明一个列或变量类型为 NCHAR 或 NVARCHAR2 , 指定的长度就是它可以存储的最大的字符个数,不是字节数。长度语义设置不影响国家字符。如下示例所示: - -```javascript -obclient> create table t1(id number not null primary key, s1 varchar2(16), s2 nvarchar2(16)); -Query OK, 0 rows affected (0.05 sec) - -obclient> insert into t1 values(1,'中中中','中中中中中中'); -Query OK, 1 row affected (0.00 sec) - -obclient> commit; -Query OK, 0 rows affected (0.00 sec) - -obclient> select id,s1,dump(s1,16) s1_d, s2,dump(s2,16) s2_d from t1\G -*************************** 1. row *************************** - ID: 1 - S1: 中中中 -S1_D: Typ=22 Len=6: d6,d0,d6,d0,d6,d0 - S2: 中中中中中中 -S2_D: Typ=43 Len=12: 4e,2d,4e,2d,4e,2d,4e,2d,4e,2d,4e,2d -1 row in set (0.00 sec) -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/5.working-in-a-global-environment/2.about-initial-nls-parameters.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/5.working-in-a-global-environment/2.about-initial-nls-parameters.md deleted file mode 100644 index 0b937f272..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/5.working-in-a-global-environment/2.about-initial-nls-parameters.md +++ /dev/null @@ -1,28 +0,0 @@ -关于初始的 NLS 参数 -================================= - - - -OceanBase 的 Oracle 租户在数据库级别有默认的 NLS 参数设置,客户端会话通常会默认读取这些配置。不过,某些图形化客户端也可以自己设定会话的 NLS 参数。 - -OceanBase 的 Oracle 租户默认的 NLS 参数如下表所示,可以通过查看视图 sys.nls_database_parameters 获取。 - - -| **PARAMETER** | **VALUE** | -|-------------------------|--------------------------------| -| NLS_DATE_FORMAT | DD-MON-RR | -| NLS_TIMESTAMP_FORMAT | DD-MON-RR HH.MI.SSXFF AM | -| NLS_TIMESTAMP_TZ_FORMAT | DD-MON-RR HH.MI.SSXFF AM TZR | -| NLS_TERRITORY | AMERICA | -| NLS_SORT | BINARY | -| NLS_COMP | BINARY | -| NLS_CHARACTERSET | AL32UTF8 | -| NLS_NCHAR_CHARACTERSE | AL16UTF16 | -| NLS_DATE_LANGUAGE | AMERICAN | -| NLS_LENGTH_SEMANTICS | BYTE | -| NLS_NCHAR_CONV_EXCP | FALSE | -| NLS_CALENDAR | GREGORIAN | -| NLS_NUMERIC_CHARACTERS | ., | - - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/5.working-in-a-global-environment/3.view-nls-parameters.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/5.working-in-a-global-environment/3.view-nls-parameters.md deleted file mode 100644 index ae2730c48..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/5.working-in-a-global-environment/3.view-nls-parameters.md +++ /dev/null @@ -1,145 +0,0 @@ -查看 NLS 参数 -============================== - - - -NLS 参数有数据库级别的和会话级别的。 - -数据库级别的 NLS 参数 ----------------------- - -查看数据库级别的 NLS 参数有两个方法: - -* 通过 sys.nls_database_parameters 视图查看 - - - - - - -```javascript -obclient> select * from nls_database_parameters; -+-------------------------+------------------------------+ -| PARAMETER | VALUE | -+-------------------------+------------------------------+ -| NLS_DATE_FORMAT | DD-MON-RR | -| NLS_TIMESTAMP_FORMAT | DD-MON-RR HH.MI.SSXFF AM | -| NLS_TIMESTAMP_TZ_FORMAT | DD-MON-RR HH.MI.SSXFF AM TZR | -| NLS_TERRITORY | AMERICA | -| NLS_SORT | BINARY | -| NLS_COMP | BINARY | -| NLS_CHARACTERSET | AL32UTF8 | -| NLS_NCHAR_CHARACTERSET | AL16UTF16 | -| NLS_DATE_LANGUAGE | AMERICAN | -| NLS_LENGTH_SEMANTICS | BYTE | -| NLS_NCHAR_CONV_EXCP | FALSE | -| NLS_CALENDAR | GREGORIAN | -| NLS_NUMERIC_CHARACTERS | ., | -+-------------------------+------------------------------+ -13 rows in set (0.00 sec) -``` - - - -* 使用 show global variables 方法 - - - - - - -```javascript -obclient> show global variables like 'nls_%'; -+-------------------------+------------------------------+ -| VARIABLE_NAME | VALUE | -+-------------------------+------------------------------+ -| nls_calendar | GREGORIAN | -| nls_characterset | AL32UTF8 | -| nls_comp | BINARY | -| nls_date_format | DD-MON-RR | -| nls_date_language | AMERICAN | -| nls_length_semantics | BYTE | -| nls_nchar_characterset | AL16UTF16 | -| nls_nchar_conv_excp | FALSE | -| nls_numeric_characters | ., | -| nls_sort | BINARY | -| nls_territory | AMERICA | -| nls_timestamp_format | DD-MON-RR HH.MI.SSXFF AM | -| nls_timestamp_tz_format | DD-MON-RR HH.MI.SSXFF AM TZR | -+-------------------------+------------------------------+ -13 rows in set (0.01 sec) -``` - - - -OceanBase 的 Oracle 租户的数据库级别的 NLS 参数是该租户的每个会话的 NLS 参数的初始值。如果会话自己不修改 NLS 参数的话,就沿用了数据库级别的 NLS 参数。 - -数据库级别的 NLS 参数也可以修改。不同租户的 NLS 参数可以不同,互不影响。 - -会话级别的 NLS 参数 ---------------------- - -查看会话级别的 NLS 参数有两种方法: - -* 通过 sys.nls_session_parameters 视图查看 - - - - - - -```javascript -obclient> select * from nls_session_parameters; -+-------------------------+------------------------------+ -| PARAMETER | VALUE | -+-------------------------+------------------------------+ -| NLS_DATE_FORMAT | DD-MON-RR | -| NLS_TIMESTAMP_FORMAT | DD-MON-RR HH.MI.SSXFF AM | -| NLS_TIMESTAMP_TZ_FORMAT | DD-MON-RR HH.MI.SSXFF AM TZR | -| NLS_LANGUAGE | AMERICAN | -| NLS_TERRITORY | AMERICA | -| NLS_SORT | BINARY | -| NLS_COMP | BINARY | -| NLS_DATE_LANGUAGE | AMERICAN | -| NLS_LENGTH_SEMANTICS | BYTE | -| NLS_NCHAR_CONV_EXCP | FALSE | -| NLS_CALENDAR | GREGORIAN | -| NLS_NUMERIC_CHARACTERS | ., | -+-------------------------+------------------------------+ -12 rows in set (0.00 sec) -``` - - - -* 通过 show session variables 方法 - - - - - - -```unknow -obclient> show session variables like 'nls_%'; -+-------------------------+------------------------------+ -| VARIABLE_NAME | VALUE | -+-------------------------+------------------------------+ -| nls_calendar | GREGORIAN | -| nls_characterset | AL32UTF8 | -| nls_comp | BINARY | -| nls_date_format | DD-MON-RR | -| nls_date_language | AMERICAN | -| nls_language | AMERICAN | -| nls_length_semantics | BYTE | -| nls_nchar_characterset | AL16UTF16 | -| nls_nchar_conv_excp | FALSE | -| nls_numeric_characters | ., | -| nls_sort | BINARY | -| nls_territory | AMERICA | -| nls_timestamp_format | DD-MON-RR HH.MI.SSXFF AM | -| nls_timestamp_tz_format | DD-MON-RR HH.MI.SSXFF AM TZR | -+-------------------------+------------------------------+ -14 rows in set (0.00 sec) -``` - - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/5.working-in-a-global-environment/4.modify-nls-parameters.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/5.working-in-a-global-environment/4.modify-nls-parameters.md deleted file mode 100644 index ae3969781..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/5.working-in-a-global-environment/4.modify-nls-parameters.md +++ /dev/null @@ -1,148 +0,0 @@ -修改 NLS 参数 -============================== - - - -NLS 参数中跟数据库字符集有关的参数 NLS_CHARACTER 和 NLS_NCHAR_CHARACTER 在租户创建好后就不能修改,目前仅支持修改跟时间和日期格式相关的 NLS 参数。 - -修改 NLS 参数分为修改数据库级别的 NLS 参数和修改会话级别的 NLS 参数,前者需要租户的管理员权限用户(默认用户 sys)才可以。 - -修改数据库级别的 NLS 参数 ------------------------- - -修改一个数据库级别的 NLS 参数通常是在所属的 Oracle 租户内部,有两种方法: - -* 通过 ALTER SYSTEM SET 命令修改数据库级别 NLS 参数。 - -* 通过 SET GLOBAL 命令修改数据库级别 NLS 参数。 - - - - - - -**示例:修改数据库级别的 NLS 参数** - -```javascript -obclient> select * from nls_database_parameters where parameter in ('NLS_DATE_FORMAT','NLS_TIMESTAMP_FORMAT','NLS_TIMESTAMP_TZ_FORMAT'); - -+-------------------------+------------------------------+ -| PARAMETER | VALUE | -+-------------------------+------------------------------+ -| NLS_DATE_FORMAT | DD-MON-RR | -| NLS_TIMESTAMP_FORMAT | DD-MON-RR HH.MI.SSXFF AM | -| NLS_TIMESTAMP_TZ_FORMAT | DD-MON-RR HH.MI.SSXFF AM TZR | -+-------------------------+------------------------------+ -3 rows in set (0.00 sec) - -obclient> alter system set nls_date_format='YYYY-MM-DD'; -Query OK, 0 rows affected (0.01 sec) - -obclient> set global nls_timestamp_format='YYYY-MM-DD HH24:MI:SSXFF'; -Query OK, 0 rows affected (0.01 sec) - -obclient> set global nls_timestamp_tz_format='YYYY-MM-DD HH24:MI:SSXFF'; -Query OK, 0 rows affected (0.01 sec) - -obclient> select * from nls_database_parameters where parameter in ('NLS_DATE_FORMAT','NLS_TIMESTAMP_FORMAT','NLS_TIMESTAMP_TZ_FORMAT'); -+-------------------------+--------------------------+ -| PARAMETER | VALUE | -+-------------------------+--------------------------+ -| NLS_DATE_FORMAT | YYYY-MM-DD | -| NLS_TIMESTAMP_FORMAT | YYYY-MM-DD HH24:MI:SSXFF | -| NLS_TIMESTAMP_TZ_FORMAT | YYYY-MM-DD HH24:MI:SSXFF | -+-------------------------+--------------------------+ -3 rows in set (0.00 sec) - -obclient> select * from nls_session_parameters where parameter in ('NLS_DATE_FORMAT','NLS_TIMESTAMP_FORMAT','NLS_TIMESTAMP_TZ_FORMAT'); - -+-------------------------+------------------------------+ -| PARAMETER | VALUE | -+-------------------------+------------------------------+ -| NLS_DATE_FORMAT | DD-MON-RR | -| NLS_TIMESTAMP_FORMAT | DD-MON-RR HH.MI.SSXFF AM | -| NLS_TIMESTAMP_TZ_FORMAT | DD-MON-RR HH.MI.SSXFF AM TZR | -+-------------------------+------------------------------+ -3 rows in set (0.00 sec) -``` - - - -从上面示例可以看出,修改数据库级别的 NLS 参数并不会应用于当前会话,需要断开会话重新连接才会生效。 - -```javascript -obclient> select sysdate, systimestamp from dual; -+-----------+-------------------------------------+ -| SYSDATE | SYSTIMESTAMP | -+-----------+-------------------------------------+ -| 02-APR-20 | 02-APR-20 07.50.58.427570 PM +08:00 | -+-----------+-------------------------------------+ -1 row in set (0.00 sec) - -obclient> show session variables where variable_name in ('nls_date_format','nls_timestamp_format','nls_timestamp_tz_format'); -+-------------------------+------------------------------+ -| VARIABLE_NAME | VALUE | -+-------------------------+------------------------------+ -| nls_date_format | DD-MON-RR | -| nls_timestamp_format | DD-MON-RR HH.MI.SSXFF AM | -| nls_timestamp_tz_format | DD-MON-RR HH.MI.SSXFF AM TZR | -+-------------------------+------------------------------+ -3 rows in set (0.01 sec) - -obclient> -``` - - - -修改会话级别的 NLS 参数 ------------------------ - -客户端会话可以设置跟数据库不同的 NLS 参数,当时只支持对日期和时间格式的 NLS 参数进行修改。 - -会话级别的 NLS 参数有两种修改方法: - -* 通过 ALTER SESSION SET 命令修改 - -* 通过 SET \[SESSION\] VARIABLE 命令修改 - - - - - - -**示例:修改会话级别的 NLS 参数** - -```javascript -obclient> alter session set nls_date_format='YYYY/MM/DD'; -Query OK, 0 rows affected (0.00 sec) - -obclient> set session nls_timestamp_format='YYYY/MM/DD HH.MI.SSXFF AM'; -Query OK, 0 rows affected (0.00 sec) - -obclient> set session nls_timestamp_tz_format='YYYY/MM/DD HH.MI.SSXFF AM TZR'; -Query OK, 0 rows affected (0.00 sec) - -obclient> select sysdate, systimestamp from dual; -+------------+--------------------------------------+ -| SYSDATE | SYSTIMESTAMP | -+------------+--------------------------------------+ -| 2020/04/02 | 2020/04/02 07.51.52.254705 PM +08:00 | -+------------+--------------------------------------+ -1 row in set (0.00 sec) - -obclient> show variables where variable_name in ('nls_date_format','nls_timestamp_format','nls_timestamp_tz_format'); -+-------------------------+-------------------------------+ -| VARIABLE_NAME | VALUE | -+-------------------------+-------------------------------+ -| nls_date_format | YYYY/MM/DD | -| nls_timestamp_format | YYYY/MM/DD HH.MI.SSXFF AM | -| nls_timestamp_tz_format | YYYY/MM/DD HH.MI.SSXFF AM TZR | -+-------------------------+-------------------------------+ -3 rows in set (0.01 sec) - -obclient> -``` - - - -会话级别的 NLS 参数修改作用范围是当前会话,如果会话断开再重连,又会获取数据库级别的 NLS 参数作为会话参数的初始值。 diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/5.working-in-a-global-environment/5.use-unicode-in-internationalized-programs.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/5.working-in-a-global-environment/5.use-unicode-in-internationalized-programs.md deleted file mode 100644 index c80d4b22e..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/5.working-in-a-global-environment/5.use-unicode-in-internationalized-programs.md +++ /dev/null @@ -1,46 +0,0 @@ -在国际化程序中使用 Unicode -====================================== - - - -您可以插入和检索 Unicode 数据。数据在数据库和客户端程序之间进行字符集透明转换,确保客户端程序独立于数据库字符集和国家字符集。 - -Unicode 数据会使用国家字符集,由参数 NLS_NCHAR_CHARACTERSET 指定。 - -在 SQL 和 PL 语句中表示 Unicode 字符 ------------------------------------- - -在 SQL 或 PL 语句中表示 Unicode 字符串的方法为:N'string'。例如:N'中' 。 - -示例:在 SQL 中表示 Unicode 字符 - -```javascript -obclient> select N'中' , dump(N'中',16), dump('中',16) from dual; -+--------+---------------------+------------------------+ -| N'中' | DUMP(N'中',16) | DUMP('中',16) | -+--------+---------------------+------------------------+ -| 中 | Typ=44 Len=2: 4e,2d | Typ=23 Len=3: e4,b8,ad | -+--------+---------------------+------------------------+ -1 row in set (0.01 sec) - -obclient> show variables where variable_name in ('nls_characterset','nls_nchar_characterset'); -+------------------------+-----------+ -| VARIABLE_NAME | VALUE | -+------------------------+-----------+ -| nls_characterset | AL32UTF8 | -| nls_nchar_characterset | AL16UTF16 | -+------------------------+-----------+ -2 rows in set (0.00 sec) -``` - - - - - -在字符集转换中避免数据损失 ----------------------- - -作为 SQL 或 PL 语句的一部分,文本(带有或不带有前缀N)都与语句其余部分使用相同的字符集编码。 在客户端,语句按客户端字符集编码,由 NLS_LANG 参数决定。在服务器端,语句按数据库字符集编码。 - -当 SQL 或 PL 语句从客户端发往数据库端时,会相应的发生字符集转换。如果数据库字符集不包含客户端语句中的所有文本字符,在转换过程中就会发生语句数据丢失。比如,NCHAR 类型文本就比 CHAR 类型文本更脆弱一些,因为前者设计上是独立于数据库字符集的。 - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/6.build-scalable-applications/1.about-extensible-applications.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/6.build-scalable-applications/1.about-extensible-applications.md deleted file mode 100644 index 559bfb96b..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/6.build-scalable-applications/1.about-extensible-applications.md +++ /dev/null @@ -1,23 +0,0 @@ -关于可扩展的应用程序 -=============================== - - - -可扩展的应用程序设计目标是不管用户量和数据量,每个应用只用相同的资源,而不是耗尽系统资源。伴随着系统资源利用相应的增长,可扩展的应用程序可以处理更大的负载。比如,如果应用负载加倍了,可扩展的应用程序就使用两倍的系统资源。 - -不可扩展的应用程序会耗尽系统资源。如果应用负载增加,吞吐量不会增加。不可扩展的应用程序只会有固定的吞吐量和较差的响应时间。 - -资源耗尽的例子有: - -* 硬件资源耗尽 - -* 大数据量表扫描导致磁盘 IO 能力不足 - -* 大量网络请求导致网络和调度瓶颈 - -* 大量换页和交换导致内存分配繁忙 - -* 大量进程和线程分配导致操作系统崩溃 - - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/6.build-scalable-applications/2.use-bind-variables-to-improve-scalability.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/6.build-scalable-applications/2.use-bind-variables-to-improve-scalability.md deleted file mode 100644 index f43d7e57b..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/6.build-scalable-applications/2.use-bind-variables-to-improve-scalability.md +++ /dev/null @@ -1,32 +0,0 @@ -使用绑定变量提升可扩展性 -================================= - - - -绑定变量正确使用的时候,可以开发出高效、可扩展的应用程序。 - -绑定变量是 SQL 语句中的占位符,必须用有效值(常量)或值地址(变量)替换该语句才能成功执行。通过使用绑定变量,您可以编写一个 SQL 语句,在运行时接受输入或参数。 - -类似于子程序可以有参数,SQL 语句可以具有绑定变量占位符,其值在运行时提供。就像一个子程序可以被编译一次,然后用不同的参数运行多次一样,一个带有绑定变量占位符的 SQL 语句可以被硬解析一次,然后用不同的绑定变量进行软解析。 - -硬解析,包括优化和行源生成,是一个 CPU 密集型的操作,而且是一个不可扩展的操作,不能跟其他很多操作并行。软解析,跳过优化和行源生成直接进行执行,相同的语句通常比硬解析快得多。 - -尽管软解析比硬解析更有效一些,但是大量的软解析成本也是很高的。为了最大化应用的有效性和扩展性,最小化解析成本,最方便的方法是使用 PL。 - -**示例:绑定变量示例** - -```javascript -delimiter / -DECLARE - v_sql varchar2(2000) := ''; - s_name ware.w_name%TYPE := ''; -BEGIN - v_sql := 'select w_name from ware where w_id = :1'; - EXECUTE IMMEDIATE v_sql INTO s_name USING '1' ; - dbms_output.put_line('w_name IS ' || s_name); -END; -/ -delimiter ; -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/6.build-scalable-applications/3.use-pl-to-improve-performance.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/6.build-scalable-applications/3.use-pl-to-improve-performance.md deleted file mode 100644 index fe5b14b2a..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/6.build-scalable-applications/3.use-pl-to-improve-performance.md +++ /dev/null @@ -1,93 +0,0 @@ -使用 PL 提升性能 -=============================== - - - -PL 怎样减少解析 ------------------------------- - -PL 在数据库访问方面做了优化,能够缓存语句。比如,在 PL 里,如果关闭了一个游标,那么该游标将不能使用了,实际上 PL 还是保存游标打开状态并且缓存了它的语句。当需要再次使用缓存的语句时,PL 会使用相同的游标,从而避免了一次解析。 - -PL 只能缓存运行时不会变化的 SQL 语句。 - -关于 EXECUTE IMMEDIATE 语句 --------------------------------------------- - -EXECUTE IMMEDIATE 语句在单个操作中构建和运行动态 SQL。最基本的语法格式为: - -```javascript -EXECUTE IMMEDIATE sql_statement -``` - - - -其中,sql_statement 字符串代表 SQL 语句。如果 sql_statement 具体值在每次 EXECUTE IMMEDIATE 运行时都一样,则 PL 可以缓存 EXECUTE IMMEDIATE 语句;如果 sql_statement 每次执行时值都不一样,则 PL 不能缓存这个 EXECUTE IMMEDIATE 语句。 - -关于 OPEN FOR 语句 ------------------------------------ - -OPEN FOR 语句的简单语法格式如下: - -```javascript -OPEN cursor_variable FOR query -``` - - - -应用程序能够为不同的查询打开游标变量,用完才关闭游标。因为 PL 只有在运行时才能决定不同查询的数量,所以 PL 不能缓存 OPEN FOR 语句。 - -如果您不需要游标变量,为了更好的性能和程序的便利性,建议使用声明的游标。 - -关于 Bulk SQL ---------------------------------- - -Bulk SQL 减少了 PL 和 SQL 之间的交互次数,从而使用了较少的资源。 - -如果没有 Bulk SQL,通过 SQL 引擎从数据库每次获取一行数据,在 PL 里处理,然后返回给数据库 SQL 引擎;有了 Bulk SQL,一次可以从数据库获取一批记录,然后处理这批记录,再返回给数据库。 - -当需要从数据库获取很多行数据并在处理完后返还给数据库时,建议请使用Bulk SQL;如果不需要返回给数据库数据,则不需要 Bulk SQL。 - -下面示例通过对表 ware 循环,每次获取 100 行记录(在 Bulk FETCH 语句后加上 LIMIT 语句限制获取行数,这需要显式的游标),然后处理,再返回给数据库。 - -```javascript -delimiter / -CREATE OR REPLACE PROCEDURE sp_bulk_sql_test -AS - TYPE T_IDS IS TABLE OF number ; - TYPE T_NAMES IS TABLE OF varchar2(50); - l_id T_IDS; - l_first T_NAMES; - l_last T_NAMES; - - CURSOR c1 IS SELECT c_id, c_last, c_first FROM cust ; - - N NUMBER := 100 ; -BEGIN - OPEN c1 ; - LOOP - FETCH c1 BULK COLLECT INTO l_id, l_first, l_last LIMIT N; - - FOR i IN 1..l_id.COUNT - LOOP - l_first(i) := 'F-' || LPAD(to_char(l_id(i)),5,'0'); - l_last(i) := 'L-' || LPAD(to_char(l_id(i)),5,'0'); - END LOOP; - - FORALL i IN 1..l_id.COUNT - UPDATE cust SET c_first = l_first(i), c_last = l_last(i) WHERE c_id = l_id(i); - EXIT WHEN c1%NOTFOUND; - - COMMIT; - END LOOP; - CLOSE c1; -END; -/ -delimiter ; - -obclient> call sp_bulk_sql_test(); -Query OK, 0 rows affected (8.87 sec) - -obclient> -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/6.build-scalable-applications/4.about-concurrency-and-scalability.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/6.build-scalable-applications/4.about-concurrency-and-scalability.md deleted file mode 100644 index 8fcf6c7e5..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/6.build-scalable-applications/4.about-concurrency-and-scalability.md +++ /dev/null @@ -1,37 +0,0 @@ -关于并发和可扩展性 -============================== - - - -**并发** 是多个事务的同时执行,应用程序处理并发越好,它的可伸缩性就越大。一个可扩展的应用程序可以处理更大的工作量,同时系统资源使用量也会相应增加。 - -并发事务必须产生有意义和一致的结果。因此,多用户数据库必须提供以下能力: - -* 数据并发,保证了多个用户能同时访问数据。 - -* 数据一致性,保证了每个用户都能看到数据的一致视图,包括来自自己的事务和其他用户已提交事务的可见更改。 - - - - -OceanBase 数据库通过使用多版本一致性模型和各种类型的锁和事务隔离级别来保持数据一致性。 - -OceanBase Oracle 租户有多项特性能够提高并发和扩展性。比如序列、非阻塞读和写、以及共享 SQL。 - -关于序列、自增列和并发 --------------------- - -序列是一个模式对象,多个用户可以通过它生成全局唯一的整数,当您需要唯一的主键时,这是非常有用的。在分布式架构下,OceanBase 的序列也能提供全局唯一且连续的整数。 - -如果没有序列,就必须以编程方式生成唯一的主键值,用户通过选择最近产生的值并增加它得到一个新的主键值。这种技术需要在事务期间锁定这个值,并导致多个用户等待下一个主键值,即事务序列化。序列能消除序列化,从而提高应用程序的并发性和可伸缩性。 - -序列是 Oracle 租户特有的。自增列是数值类型的一种,由数据库默认用不重复且递增的数字填充该列的值。 - -序列对用户的意义跟序列是一样的。 - -关于非阻塞性读和写以及并发 ----------------------- - -OceanBase 数据库中,非阻塞读写特性允许在数据被修改的同时查询也能并发执行而不需要被阻塞或停止。非阻塞读写特性允许一个会话在另外一个会话修改数据的同时去读这个数据,并且保证读取的数据不会是脏数据。 - -OceanBase 的非阻塞性读写是基于多版本实现的,是无锁的。 diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/6.build-scalable-applications/5.restrict-the-parallelism-of-a-session.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/6.build-scalable-applications/5.restrict-the-parallelism-of-a-session.md deleted file mode 100644 index 09de2f123..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/6.build-scalable-applications/5.restrict-the-parallelism-of-a-session.md +++ /dev/null @@ -1,8 +0,0 @@ -限制会话的并发数 -============================= - - - -并发会话越多,基于并发的等待就越多,响应时间就越慢。 - -如果一个租户有 n 个 CPU,通常该租户最多有 10\*n 个用户会话是同时活动的,此时增加的每个额外的并发会话在活跃之前将等待一个可用的工作线程。如果大部分会话执行的 SQL 都很快,这个等待会非常短,因此可以增加更多的应用会话以提升应用整体的吞吐量。 diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/6.build-scalable-applications/6.data-processing-skills.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/6.build-scalable-applications/6.data-processing-skills.md deleted file mode 100644 index 82b33529c..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/6.build-scalable-applications/6.data-processing-skills.md +++ /dev/null @@ -1,252 +0,0 @@ -数据处理技巧 -=========================== - - - -基于数据仓库的数据库应用程序常见任务是海量数据查询或修改。应用程序开发人员面临的问题是如何在处理海量数据集时实现高性能。 - -数据处理技术分为两个类型:迭代运算和集合运算。 - -关于迭代的数据处理技巧 --------------------- - -在迭代处理中,应用程序使用条件循环遍历一组行数据。 - -典型的迭代处理流程如下(并不是每一步都是必需的),用到了客户端/服务器模型: - -1. 客户端应用程序从数据库端读取了一组数据。 - - - -2. 客户端应用程序内部逐笔处理这组数据。 - - - -3. 客户端将这组数据处理结果写回给数据库。 - - - - - - -您可以使用三种主要技术实现迭代算法:逐行处理、数组处理和手动并行。 - -* 逐行迭代处理 - - 在逐行处理中,单进程遍历数据集,并且每次在单个行上操作。在典型的实现中,应用程序从数据库中检索一行,在中间层处理,然后将行发送回数据库,数据库执行 DML 并提交。 - - 假设您有个需求,需要处理一个表 raw_list 中记录,把每行记录分拆为两笔记录插入到表 op_list 中。下面的 PL 程序示例代码使用逐行处理技术实现了这个需求。 - - - - - -```javascript -CREATE TABLE raw_list( - id number NOT NULL PRIMARY KEY - , debit_id number NOT NULL - , credit_id number NOT NULL - , op_amount number NOT NULL - , op_time date NOT NULL -); -CREATE SEQUENCE seq_op_list START WITH 1 ; -CREATE TABLE op_list( - op_id number NOT NULL PRIMARY KEY - , op_code varchar2(20) NOT NULL - , account_id number NOT NULL - , amount number NOT NULL - , gmt_create date DEFAULT sysdate NOT NULL -); - -delimiter / -DECLARE - CURSOR c1 IS SELECT * FROM raw_list ; - r raw_list%rowtype ; -BEGIN - OPEN c1; - LOOP - FETCH c1 INTO r ; - EXIT WHEN c1%NOTFOUND ; - - INSERT INTO op_list(op_id, op_code, account_id, amount) values(seq_op_list.nextval, '-', r.credit_id, r.op_amount); - INSERT INTO op_list(op_id, op_code, account_id, amount) values(seq_op_list.nextval, '+', r.debit_id, r.op_amount); - COMMIT; - END LOOP; -END; -/ -delimiter ; -``` - - - -逐行处理技术有如下的优点: - - - -逐行处理技术也有如下的缺点: - - - - - -* 分组迭代处理 - - 分组处理与逐行处理相同,只是它在每次迭代中处理多行,而不是单行。如下示例: - - - - - -```javascript -delimiter / -DECLARE - CURSOR c1 IS SELECT * FROM raw_list ; - TYPE T_RAW IS TABLE OF raw_list%ROWTYPE INDEX BY binary_integer ; - t T_RAW; - row_cnt binary_integer := 0; - array_size NUMBER := 100; -BEGIN - OPEN c1; - LOOP - FETCH c1 BULK COLLECT INTO t LIMIT array_size ; - EXIT WHEN t.COUNT = 0 ; - - FORALL i IN 1..t.COUNT - INSERT INTO op_list(op_id, op_code, account_id, amount) values(seq_op_list.nextval, '-', t(i).credit_id, t(i).op_amount); - - FORALL i IN 1..t.COUNT - INSERT INTO op_list(op_id, op_code, account_id, amount) values(seq_op_list.nextval, '+', t(i).debit_id, t(i).op_amount); - - COMMIT; - END LOOP; -END; -/ -delimiter ; -``` - - - -上面代码跟逐行迭代处理区别在于在 FETCH 语句中使用了 BULK COLLECT 操作符分组获取数据,并限制了每组大小 array_size 。 - -相比于逐行迭代处理技术,分组迭代技术有如下优点: - - - -分组迭代技术的缺点跟逐行迭代技术是一样的,面对大数据量时,这个处理时间也是不能接受的。此外就是应用程序也只能串行执行,不能发挥数据库的并行处理能力。 - -* 手动并行迭代处理 - - 手动并行迭代与逐行和分组处理使用相同的迭代算法,但允许多个服务器进程划分工作并并行运行。 - - 假设业务功能需求跟前面逐行迭代处理是一样的,但是做如下调整: - - - - - - - -```javascript -delimiter / -DECLARE - sqlstmt varchar2(1024) := q'[ -DECLARE - CURSOR c1 IS SELECT * FROM raw_list_${thr} ; - TYPE T_RAW IS TABLE OF raw_list%ROWTYPE INDEX BY binary_integer ; - t T_RAW; - row_cnt binary_integer := 0; - array_size NUMBER := 100; -BEGIN - OPEN c1; - LOOP - FETCH c1 BULK COLLECT INTO t LIMIT array_size ; - EXIT WHEN t.COUNT = 0 ; - - FORALL i IN 1..t.COUNT - INSERT INTO op_list(op_id, op_code, account_id, amount) values(seq_op_list.nextval, '-', t(i).credit_id, t(i).op_amount); - - FORALL i IN 1..t.COUNT - INSERT INTO op_list(op_id, op_code, account_id, amount) values(seq_op_list.nextval, '+', t(i).debit_id, t(i).op_amount); - - COMMIT; - END LOOP; -END; -]' ; - -BEGIN - sqlstmt := replace(sqlstmt, '${thr}', 1); - EXECUTE IMMEDIATE sqlstmt ; -END; -/ -delimiter ; -``` - - - -手动并行处理技术有如下优点: - - - -手动并行处理技术有如下缺点: - - - - - -关于基于集合的数据处理 --------------------- - -基于集合的处理是一种 SQL 技术,它的处理对象是数据库中的数据集。 - -在基于集合的模型中,SQL 语句定义了结果,并允许数据库确定最有效的获取方法。相反,迭代算法使用条件逻辑将数据库中的每一行或每一组数据行拉到客户端应用程序,处理客户端上的数据,然后将数据发送回数据库。基于集合的处理消除了网络往返和数据库 API 开销,因为数据不会离开数据库。 - -还是以前面例子为例,以下 SQL 语句使用基于集合的算法满足这一要求: - -```javascript -INSERT INTO op_list(op_id, op_code, account_id, amount, gmt_create) -SELECT seq_op_list.nextval, '+', debit_id, op_amount, sysdate -FROM raw_list; -INSERT INTO op_list(op_id, op_code, account_id, amount, gmt_create) -SELECT seq_op_list.nextval, '-', credit_id, op_amount, sysdate -FROM raw_list; -COMMIT; -``` - - - -INSERT 语句后的 SELECT 子句读取了所有数据同时一次性写入到目标表,然后应用一次性提交事务。 - -相比迭代算法,基于集合技术有如下优点: - -* 中等规模数据量情况下,基于集合处理技术性能会更好一些。 - - - -* 代码更加简洁明了。 - - - -* 相比手动并行技术,基于集合的处理技术可以发挥数据库内部的并行处理技术。 - - - -* 如果涉及到表连接,数据库端可能会使用更高效的 HASH 连接算法,这个比迭代算法中的嵌套循环算法要好很多。 - - - - - - -相比迭代算法,基于集合技术有如下缺点: - -* SQL 逻辑比较简单,不能实现复杂的业务逻辑。 - - - -* 可能产生大事务,如果数据规模非常大的时候,大事务可能导致数据库内存资源紧张。 - - - - - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/7.migrate-data-to-oceanbase-1/1.about-data-migration-and-synchronization-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/7.migrate-data-to-oceanbase-1/1.about-data-migration-and-synchronization-1.md deleted file mode 100644 index 89e2a42b0..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/7.migrate-data-to-oceanbase-1/1.about-data-migration-and-synchronization-1.md +++ /dev/null @@ -1,12 +0,0 @@ -关于数据迁移和同步 -============================== - - - -数据从传统数据库迁移到 OceanBase 数据库上,可以选择将数据导出为 CSV 文件、SQL 文件,然后再导入到OceanBase 中。也可以使用 OceanBase 产品 DataX 或 OMS 在传统数据库和 OceanBase 之间做离线或在线数据迁移。 -**注意** - - - -当数据迁移的数据量非常大时,如果迁移速度很快,可能导致 OceanBase 的增量内存消耗速度快于转储和合并释放内存的速度。此时需要针对数据迁移做参数修改,或内存写入限速,或者对实例做内存扩容。 - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/7.migrate-data-to-oceanbase-1/2.general-purpose-data-synchronization-framework-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/7.migrate-data-to-oceanbase-1/2.general-purpose-data-synchronization-framework-1.md deleted file mode 100644 index b3d308f78..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/7.migrate-data-to-oceanbase-1/2.general-purpose-data-synchronization-framework-1.md +++ /dev/null @@ -1,143 +0,0 @@ -通用数据同步框架 DataX -=================================== - - - -DataX 简介 ------------------ - -DataX 是阿里巴巴集团内被广泛使用的离线数据同步工具/平台,实现包括 MySQL、Oracle、SqlServer、Postgre、HDFS、Hive、ADS、HBase、TableStore(OTS)、MaxCompute(ODPS)、DRDS 和 OceanBase 数据库等各种异构数据源之间高效的数据同步功能。 - -DataX 本身作为数据同步框架,将不同数据源的同步抽象为从源头数据源读取数据的 Reader 插件,以及向目标端写入数据的 Writer 插件,理论上 DataX 框架可以支持任意数据源类型的数据同步工作。同时 DataX 插件体系作为一套生态系统,每接入一套新数据源该新加入的数据源即可实现和现有的数据源互通。 - -DataX 已经在 github 开源,开源地址是:[github.com/Alibaba/datax](http://github.com/Alibaba/datax),开源的产品不支持 OceanBase 和 DB2 ,OceanBase 团队提供针对 OceanBase 和 DB2 的读写插件。 - -DataX 的使用示例 --------------------- - -DataX 安装后,默认目录在 `/home/admin/datax3` 。目录下有个文件夹 `job` ,默认存放数据迁移任务的配置文件,当然也可以自定义目录。 - -每个任务的参数文件是一个 json 格式,主要由一个 reader 和一个 writer 组成。`job` 文件夹下有个默认的示例任务配置文件 `job.json`: - -```javascript -[admin /home/admin/datax3/job] -$cat job.json -{ - "job": { - "setting": { - "speed": { - "byte":10485760 - }, - "errorLimit": { - "record": 0, - "percentage": 0.02 - } - }, - "content": [ - { - "reader": { - "name": "streamreader", - "parameter": { - "column" : [ - { - "value": "DataX", - "type": "string" - }, - { - "value": 19890604, - "type": "long" - }, - { - "value": "1989-06-04 00:00:00", - "type": "date" - }, - { - "value": true, - "type": "bool" - }, - { - "value": "test", - "type": "bytes" - } - ], - "sliceRecordCount": 100000 - } - }, - "writer": { - "name": "streamwriter", - "parameter": { - "print": false, - "encoding": "UTF-8" - } - } - } - ] - } -} -``` - - - -这个任务的配置文件的 reader 和 writer 类型是一个 stream。这个任务会检测 DataX 是否正确安装,运行之前确保安装 JDK 运行环境。 - -```javascript -[admin@h07g12092.sqa.eu95 /home/admin/datax3/job] -$cd ../ - -[admin@h07g12092.sqa.eu95 /home/admin/datax3] -$bin/datax.py job/job.json -``` - - - -运行结果如下: - -```unknow -2021-03-16 16:52:21.489 [job-0] INFO JobContainer - - === total summarize info === - - 1. all phase average time info and max time task info: - -PHASE | AVERAGE USED TIME | ALL TASK NUM | MAX USED TIME | MAX TASK ID | MAX TASK INFO -TASK_TOTAL | 0.403s | 1 | 0.403s | 0-0-0 | null -READ_TASK_INIT | 0.001s | 1 | 0.001s | 0-0-0 | null -READ_TASK_PREPARE | 0.001s | 1 | 0.001s | 0-0-0 | null -READ_TASK_DATA | 0.076s | 1 | 0.076s | 0-0-0 | null -READ_TASK_POST | 0.000s | 1 | 0.000s | 0-0-0 | null -READ_TASK_DESTROY | 0.000s | 1 | 0.000s | 0-0-0 | null -WRITE_TASK_INIT | 0.001s | 1 | 0.001s | 0-0-0 | null -WRITE_TASK_PREPARE | 0.000s | 1 | 0.000s | 0-0-0 | null -WRITE_TASK_DATA | 0.276s | 1 | 0.276s | 0-0-0 | null -WRITE_TASK_POST | 0.000s | 1 | 0.000s | 0-0-0 | null -WRITE_TASK_DESTROY | 0.000s | 1 | 0.000s | 0-0-0 | null -WAIT_READ_TIME | 0.041s | 1 | 0.041s | 0-0-0 | null -WAIT_WRITE_TIME | 0.025s | 1 | 0.025s | 0-0-0 | null - - - 2. record average count and max count task info : - -PHASE | AVERAGE RECORDS | AVERAGE BYTES | MAX RECORDS | MAX RECORD`S BYTES | MAX TASK ID | MAX TASK INFO -READ_TASK_DATA | 100000 | 2.60M | 100000 | 2.60M | 0-0-0 | null - -2021-03-16 16:52:21.490 [job-0] INFO MetricReportUtil - reportJobMetric is turn off -2021-03-16 16:52:21.491 [job-0] INFO StandAloneJobContainerCommunicator - Total 100000 records, 2600000 bytes | Speed 2.48MB/s, 100000 records/s | Error 0 records, 0 bytes | All Task WaitWriterTime 0.025s | All Task WaitReaderTime 0.041s | Percentage 100.00% -2021-03-16 16:52:21.491 [job-0] INFO LogReportUtil - report datax log is turn off -2021-03-16 16:52:21.492 [job-0] INFO JobContainer - -任务启动时刻 : 2021-03-16 16:52:20 -任务结束时刻 : 2021-03-16 16:52:21 -任务总计耗时 : 1s -任务平均流量 : 2.48MB/s -记录写入速度 : 100000rec/s -读出记录总数 : 100000 -读写失败总数 : 0 -``` - - - - -**说明** - - - -这个默认的任务参数关闭了数据流输出,所以看不到输出结果。 - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/7.migrate-data-to-oceanbase-1/3.examples-of-the-datax-reader-and-writer-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/7.migrate-data-to-oceanbase-1/3.examples-of-the-datax-reader-and-writer-1.md deleted file mode 100644 index 55c5a4047..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/7.migrate-data-to-oceanbase-1/3.examples-of-the-datax-reader-and-writer-1.md +++ /dev/null @@ -1,424 +0,0 @@ -不同数据源的 DataX 读写插件示例 -======================================== - - - -DataX 官网支持绝大部分主流数据源的读写插件,并且有详细的使用文档。 - -CSV 文件的读写插件 --------------------- - -csv 文件就是文本文件,用 txtreader 和 txtwriter 读写。配置文件详细语法请参见 **D** **ataX官网说明** 。 - -**txtread** **er 配** **置示例:** - -```javascript - "reader":{ - "name":"txtfilereader", - "parameter":{ - "path":["文件全路径"], - "encoding":"UTF-8", - "column":[ - { "index":0, "type":"long" } - ,{ "index":1, "type":"long" } - ,{ "index":2, "type":"string" } - ,{ "index":3, "type":"double" } - ,{ "index":4, "type":"string" } - ], - "fieldDelimiter":"||", - "fileFormat":"text" - } - } -``` - - - -**txtwriter** **配置示例:** - -```javascript - "writer":{ - "name":"txtfilewriter", - "parameter":{ - "path":"文件全路径", - "fileName":"文件名", - "writeMode":"truncate", - "dateFormat":"yyyy-MM-dd", - "charset":"UTF-8", - "nullFormat":"", - "fileDelimiter":"||" - } - } -``` - - - -MySQL 数据库的读写插件 ------------------------ - -针对 MySQL 数据库,用 mysqlreader 和 mysqlwriter 插件读写。 - -**mysqlreader** **配置示例:** - -```javascript - "reader": { - "name": "mysqlreader", - "parameter": { - "username": "root", - "password": "root", - "column": [ - "id", - "name" - ], - "splitPk": "db_id", - "connection": [ - { - "table": [ - "table" - ], - "jdbcUrl": [ - "jdbc:mysql://127.0.0.1:3306/database" - ] - } - ] - } - } -``` - - - -**mysqlwriter** **配置示例:** - -```javascript - "writer": { - "name": "mysqlwriter", - "parameter": { - "writeMode": "insert", - "username": "root", - "password": "root", - "column": [ - "id", - "name" - ], - "session": [ - "set session sql_mode='ANSI'" - ], - "preSql": [ - "delete from test" - ], - "connection": [ - { - "jdbcUrl": "jdbc:mysql://127.0.0.1:3306/datax?useUnicode=true&characterEncoding=gbk", - "table": [ - "test" - ] - } - ] - } - } -``` - - - - - -Oracle 数据库的读写插件 ------------------------- - -针对 Oracle 数据库,用 oraclereader 和 oraclewriter 插件来读写。 - -**oraclereader** **配置示例:** - -```javascript - "reader": { - "name": "oraclereader", - "parameter": { - // 数据库连接用户名 - "username": "root", - // 数据库连接密码 - "password": "root", - "column": [ - "id","name" - ], - //切分主键 - "splitPk": "db_id", - "connection": [ - { - "table": [ - "table" - ], - "jdbcUrl": [ - "jdbc:oracle:thin:@[HOST_NAME]:PORT:[DATABASE_NAME]" - ] - } - ] - } - } -``` - - - -**oraclewriter** **配置示例:** - -```javascript - "writer": { - "name": "oraclewriter", - "parameter": { - "username": "root", - "password": "root", - "column": [ - "id", - "name" - ], - "preSql": [ - "delete from test" - ], - "connection": [ - { - "jdbcUrl": "jdbc:oracle:thin:@[HOST_NAME]:PORT:[DATABASE_NAME]", - "table": [ - "test" - ] - } - ] - } - } -``` - - - - - -DB2 数据库的读写插件 ---------------------- - -**db2reader** **配置示例:** - -```javascript -"reader":{ - "name":"db2reader", - "parameter":{ - "username":"SRC_DB_UESRNAME", - "password":"SRC_DB_PASSWORD", - "column":[ - "SRC_COLUMN_LIST" - ], - "connection":[ - { - "table":[ - "SRC_TABLE_NAME" - ], - "jdbcUrl":[ -"jdbc:db2://SRC_DB_IP:SRC_DB_PORT/SRC_DB_NAME" - ] - } - ] - } - } -``` - - - - - -OceanBase 数据库的读写插件 ---------------------------- - -OceanBase 数据库使用插件 oceanbasev10reader 和 oceanbasev10writer 来读写。该插件由 OceanBase 产品团队单独提供。 - -* **oceanbasev10reader** **配置示例** - - - - -```javascript - "reader":{ - "name":"oceanbasev10reader", - "parameter":{ - "where":"", - "timeout":10000, - "readBatchSize":100000, - "readByPartition":"true", - "column": [ - "列名1","列名2" - ], - "connection":[ - { - "jdbcUrl":["||_dsc_ob10_dsc_||集群名:租户名||_dsc_ob10_dsc_||jdbc:oceanbase://连接IP:连接端口/模式名或数据库名"], - "table":["表名"] - } - ], - "username":"租户内用户名", - "password":"密码" - } - } -``` - - - -示例:OceanBase 表 ware 导出到 csv 文件 - -```javascript -[admin@*** /home/admin/datax3] -$cat job/ob_tpcc_ware_2_csv.json -{ - "job":{ - "setting":{ - "speed":{ - "channel":10 - }, - "errorLimit":{ - "record":0, "percentage": 0.02 - } - }, - "content":[ - { - "reader":{ - "name":"oceanbasev10reader", - "parameter":{ - "where":"", - "timeout":10000, - "readBatchSize":100000, - "readByPartition":"true", - "column": [ -"W_ID","W_YTD","W_TAX","W_NAME","W_STREET_1","W_STREET_2","W_CITY","W_STATE","W_ZIP" - ], - "connection":[ - { - "jdbcUrl":["||_dsc_ob10_dsc_||obdemo:obbmsql||_dsc_ob10_dsc_||jdbc:oceanbase://127.1:2883/tpcc"], - "table":["ware"] - } - ], - "username":"tpcc", - "password":"123456" - } - }, - "writer":{ - "name":"txtfilewriter", - "parameter":{ - "path":"/home/admin/csvdata/", - "fileName":"ware", - "writeMode":"truncate", - "dateFormat":"yyyy-MM-dd", - "charset":"UTF-8", - "nullFormat":"", - "fileDelimiter":"||" - } - } - } - ] - } -} - -[admin@*** /home/admin/datax3] -$bin/datax.py job/ob_tpcc_ware_2_csv.json -``` - - - -![image.png](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/2111155061/p148905.png "image.png") - -* **oceanbasev10writer** **配置示例** - - - - -```javascript - "writer": { - "name": "oceanbasev10writer", - "parameter": { - "username": "租户内的用户名", - "password": "密码", - "writeMode": "insert", - "column": [ - "列名1","列名2" - ], - "preSql": [ - "" - ], - "connection": [ - { - "jdbcUrl": "||_dsc_ob10_dsc_||集群名:租户名||_dsc_ob10_dsc_||jdbc:oceanbase://连接IP:连接端口(默认2883)/模式名或数据库名", - "table": [ - "表名" - ] - } - ], - "batchSize": 1024, - "activeMemPercent": "90" - } - } -``` - - - -示例:从 csv 文件导入到 OceanBase 表中 - -```javascript -[admin@*** /home/admin/datax3] -$cat job/csv_2_ob_tpcc_ware2.json -{ - "job":{ - "setting":{ - "speed":{ - "channel":32 - }, - "errorLimit":{ - "record":0, "percentage": 0.02 - } - }, - "content":[ - { - "reader":{ - "name":"txtfilereader", - "parameter":{ - "path":["/home/admin/csvdata/ware*"], - "encoding":"UTF-8", - "column":[ - { "index":0, "type":"long" } - ,{ "index":1, "type":"long" } - ,{ "index":2, "type":"long" } - ,{ "index":3, "type":"string" } - ,{ "index":4, "type":"string" } - ,{ "index":5, "type":"string" } - ,{ "index":6, "type":"string" } - ,{ "index":7, "type":"string" } - ,{ "index":8, "type":"string" } - ], - "fieldDelimiter":",", - "fileFormat":"text" - } - }, - "writer":{ - "name":"oceanbasev10writer", - "parameter":{ - "writeMode":"insert", - "column":[ - "W_ID","W_YTD","W_TAX","W_NAME","W_STREET_1","W_STREET_2","W_CITY","W_STATE","W_ZIP" - ], - "connection":[ - { -"jdbcUrl":"||_dsc_ob10_dsc_||obdemo:obbmsql||_dsc_ob10_dsc_||jdbc:oceanbase://127.1:2883/tpcc", - "table":["WARE2"] - } - ], - "username":"tpcc", - "password":"123456", - "batchSize":256, - " memstoreThreshold":"90" - } - } - } - ] - } -} - - -[admin@*** /home/admin/datax3] -$bin/datax.py job/csv_2_ob_tpcc_ware2.json -``` - - - -![image.png](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/2111155061/p148906.png "image.png") - -![image.png](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/3111155061/p148907.png "image.png") diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/7.migrate-data-to-oceanbase-1/4.data-loading-technology-of-oceanbase-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/7.migrate-data-to-oceanbase-1/4.data-loading-technology-of-oceanbase-1.md deleted file mode 100644 index b5c54ac7f..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/7.migrate-data-to-oceanbase-1/4.data-loading-technology-of-oceanbase-1.md +++ /dev/null @@ -1,192 +0,0 @@ -OceanBase 数据加载技术 -===================================== - - - -OceanBase 数据库支持通过 LOAD DATA 命令加载外部文本文件的内容到数据库表中。 - -LOAD DATA 语法格式如下: - -```javascript -LOAD DATA - [/*+ parallel(N)*/] - INFILE 'file_name' - [IGNORE] - INTO TABLE tbl_name - [{FIELDS | COLUMNS} - [TERMINATED BY 'string'] - [[OPTIONALLY] ENCLOSED BY 'char'] - [ESCAPED BY 'char'] - ] - [LINES - [STARTING BY 'string'] - [TERMINATED BY 'string'] - ] - [IGNORE number {LINES | ROWS}] - [(col_name_var - [, col_name_var] ...)] -``` - - -**注意** - - - -要加载的文件必须在该表的主副本所在的 OBServer 上,当前版本不支持从远程客户端加载数据。 - -Load Data 目前可以对 CSV 格式的文本文件进行导入,整个导入的过程如下: - -1. 解析文件:OceanBase 数据库会根据用户输入的文件名,读取文件中的数据,并且根据用户输入的并行度来决定并行或者串行解析输入文件中的数据。 - - - -2. 分发数据:由于 OceanBase 数据库是分布式数据库系统,各个分区的数据可能分布在各个不同的 OBServer 上,Load Data 会对解析出来的数据进行计算,决定数据需要被发送到哪个 OBServer。 - - - -3. 插入数据:当目标 OBServer 收到了发送过来的数据之后,在本地执行 INSERT 操作把数据插入到对应的分区当中。 - - - - - - -Load Data 提供了很多选项支持用户不同的需求,目前支持的选项有: - -* **并行度:** /\*+ parallel(N)\*/ 选项指定加载数据的并行度,建议使用的值范围是 \[0 - 租户的最大CPU数\]。例如: - - - - -```javascript -load data /*+ parallel(4) */infile '/home/admin/a.csv' into table t -``` - - - -* **输入文件:** INFILE 'file_name' 关键字指定输入文件的路径和文件名,目前 Load Data 只支持加载 OBServer 本地的输入文件。所以,用户需要在导入之前把文件拷贝到某一个 OBServer 上,并连接文件所在的 OBServer 运行 Load Data 语句。 - - - - - - -* **执行权限:** 用户需要授予权限才能访问机器上的文件,有两步: - - - - - - -* **重复数据处理:** 这部分指定如何处理重复的数据。`Replace` 表示将表中原有的数据替换成为输入文件中的数据;`Ignore` 表示忽略掉重复的数据。Load Data 通过表的主键来判断数据是否重复,如果表不存在主键,那么 Load Data 语句就无法判断数据是否重复,`Replace` 和 `Ignore` 选项没有区别。如果用户不指定这个选项,那么遇到重复数据的时候,Load Data 语句会将出现把错误的数据记录到日志文件中。 - - - - - - -* **目标表选项:** `INTO TABLE tbl_name` 关键字用于指定目标表名称。Load Data 支持分区表和非分区表。 - - - - - - -* **字段格式:** 这部分指定输入文件的各个字段的分隔符选项,通过 `Fields | Columns` 子句来指定,其中:`Terminated By` 关键字用来指定字段的分隔符;`Enclosed By` 关键字指定每个字段的开始和结束是否包含了特定的字符;`Escaped By` 关键字用来指定字段中的通配符。 - - - - - - -* **行格式:** 这部分指定输入文件中每一行的开始和结束字符,通过 `Lines` 子句设置。 其中 `Starting By` 用于指定每一行开始的字符;`Terminated By` 用户指定每一行的结束字符。`IGNORE number {LINES | ROWS}` 子句指定忽略掉输入文件的前 `number` 行数据。 - - - - -```javascript -load data /*+ parallel(4) */infile '/home/admin/a.csv' into table t fields terminated by ',' lines terminated by '\n'; -``` - - - -* **列对应关系选项:** 这部分用于指定目标表的各个列与输入文件的字段之间的关系,通过 `(col_name_var [, col_name_var] ...)` 关键字指定。如果用户没有指定,默认会将输入文件中的字段逐个与表中的列进行对应。如果用户通过 `col_name_or_user_var` 关键字指定输入文件中的字段与表中列的对应关系,Load Data 会根据指定的列名与表中的列进行对应,没有被指定的列会取空值,下面是一个基本的示例: - - - - -```javascript -load data infile '/home/admin/a.csv' into table t (id, names) set dates=CURRENT_TIMESTAMP; -``` - - - -如果输入文件中并没有包含所有的列,那么缺少的列按照以下的规则会被默认填充: - - - -如果用户需要添加空值,请在输入文件中使用 '\\N'。 - -* **日志文件:** 如果导入的过程中出现了错误,出现错误的 INSERT 语句会被回滚,并且 Load Data 语句会在 OBServer 安装路径的 log 子目录下产生名称为 `obloaddata.log.` 的日志文件,以下是一个日志文件的示例: - - - - -```javascript -Tenant name: mysql -File name: /home/admin/a.csv -Into table: `test`.`t` -Parallel: 1 -Batch size: 1000 -SQL trace: YD7A20BA65670-0005AADAAA3CAB52 -Start time: 2020-07-29 21:08:13.073741 -Load query: -load data infile '/home/admin/test.csv' into table t fields terminated by ',' lines terminated by '\n' -Row ErrCode ErrMsg -1 1062 Duplicated primary key -2 1062 Duplicated primary key -``` - - - -日志中会包含 Load Data 产生的任务的基本信息,包含了:租户名,输入文件名,目标表名,并行度,使用的 Load Data 命令,并且以行为单位给出具体错误的信息。 - -**示例:通过** **Load Data** **导入 csv 文件到表** **ware2** **中** - -```javascript -[admin@h07g12092.sqa.eu95 /home/admin/csvdata] -$more ware__df8f30ac_64e0_474c_9cc4_9919d64c5e4c -2,1200,.0862,L6xwRsbDk,xEdT1jkENtbLwoI1Zb0,NT0j4RCQ4OqrS,vlwzndw2FPrO,XR,063311111 -1,1200,.1868,n1P4zYo8OH,jTNkXKWXOdh,lf9QXTXXGoF04IZBkCP7,srRq15uvxe5,GQ,506811111 - -$obclient -h192.168.1.101 -utpcc@obbmsql -P2881 -p123456 - -obclient> load data infile '/home/admin/csvdata/ware__df8f30ac_64e0_474c_9cc4_9919d64c5e4c' into table ware2 fields terminated by ',' lines terminated by '\n'; -Query OK, 2 rows affected (0.02 sec) -Records: 2 Deleted: 0 Skipped: 0 Warnings: 0 - -obclient> select * from ware2\G -*************************** 1. row *************************** - W_ID: 2 - W_YTD: 1200 - W_TAX: .0862 - W_NAME: L6xwRsbDk -W_STREET_1: xEdT1jkENtbLwoI1Zb0 -W_STREET_2: NT0j4RCQ4OqrS - W_CITY: vlwzndw2FPrO - W_STATE: XR - W_ZIP: 063311111 -*************************** 2. row *************************** - W_ID: 1 - W_YTD: 1200 - W_TAX: .1868 - W_NAME: n1P4zYo8OH -W_STREET_1: jTNkXKWXOdh -W_STREET_2: lf9QXTXXGoF04IZBkCP7 - W_CITY: srRq15uvxe5 - W_STATE: GQ - W_ZIP: 506811111 -2 rows in set (0.00 sec) -``` - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/8.appendix-1/1.use-java-to-connect-to-oceanbase-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/8.appendix-1/1.use-java-to-connect-to-oceanbase-1.md deleted file mode 100644 index 10304df4d..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/8.appendix-1/1.use-java-to-connect-to-oceanbase-1.md +++ /dev/null @@ -1,63 +0,0 @@ -Java 连接 OceanBase 示例 -========================================= - - - -1. 添加 Maven 依赖 - - - - - - -```javascript - - com.alipay.oceanbase - oceanbase-client - -``` - - -**说明** - - - -如果需要下载 oceanbase-client,请点击:[oceanbase-client](https://oceanbase-aliyun-docs.oss-cn-hangzhou.aliyuncs.com/downloads/obclient/oceanbase-client-1.1.5.jar) - -2. 修改连接字符串 - - 连接串的前缀需要设置为 `jdbc:oceanbase:oracle` ,其他部分的使用方式与原生的 MySQL 使用方式保持一致。 - - - - - -```javascript -String url = "jdbc:oceanbase:oracle://连接串:1521/用户名"; -String username = "用户名"; -String password = ""; -Connection conn = null; -try { - Class.forName("com.alipay.oceanbase.jdbc.Driver"); - conn = DriverManager.getConnection(url, username, password); - PreparedStatement ps = conn.prepareStatement("select to_char(sysdate,'yyyy-MM-dd HH24:mi:ss') from dual;"); - ResultSet rs = ps.executeQuery(); - rs.next(); - System.out.println("sysdate is:" + rs.getString(1)); - rs.close(); - ps.close(); -} catch (Exception e) { - e.printStackTrace(); -} finally { - if (null != conn) { - conn.close(); - } -} -``` - - -**说明** - - - -对于 Druid 框架,推荐使用 Druid 最新版 1.2.3:https://github.com/alibaba/druid/releases。 diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/8.appendix-1/2.common-oceanbase-parameters-and-variables-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/8.appendix-1/2.common-oceanbase-parameters-and-variables-1.md deleted file mode 100644 index 31f50afa9..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/8.appendix-1/2.common-oceanbase-parameters-and-variables-1.md +++ /dev/null @@ -1,68 +0,0 @@ -OceanBase 常用参数和变量 -====================================== - - - -* 下表所示是常用的跟开发有关的参数(parameters) - - - - - - - -| **参数名** | **参数值** | **参数含义** | **范围** | -|---------------------------------------|---------|-----------------------------------------|--------| -| minor_freeze_times | 0 | 指定多少次 minor freeze 后会触发 major freeze。 | 集群 | -| enable_major_freeze | True | 指定集群是否开启自动 major freeze。 | 集群 | -| major_freeze_duty_time | 02:00 | 指定集群自动 major freeze 的开始时间。 | 集群 | -| enable_rebalance | True | 指定是否开启分区负载均衡。True 开启,False 关闭。 | 集群 | -| enable_auto_leader_switch | True | 指定是否开启分区自动切主。 | 集群 | -| large_query_threshold | 100ms | 指定一个查询执行时间被判定为大查询的阈值。 | 集群 | -| large_query_worker_percentage | 30 | 指定大查询要使用的 CPU 工作线程比例。 | 集群 | -| data_copy_concurrency | 20 | 指定分区迁移时集群最大的迁移任务数。 | 集群 | -| server_data_copy_out_concurrency | 2 | 指定分区迁移时每个节点最大的迁出任务数。 | 集群 | -| server_data_copy_in_concurrency | 2 | 指定分区迁移时每个节点最大的迁入任务数。 | 集群 | -| freeze_trigger_percentage | 70 | 指定增量内存使用比例的一个阈值,达到这个值会触发 minor freeze 。 | 集群 | -| enable_perf_event | True | 指定是否开启性能事件信息收集,默认是 False。 | 集群 | -| enable_sql_audit | True | 指定是否开启 SQL 审计功能,默认是 True。 | 集群 | -| sql_work_area | 1G | 指定租户的 SQL 工作内存。 | 租户 | -| writing_throttling_maximum_duration | 1h | 指定触发租户限流时增量内存预估最大使用时间。 | 租户 | -| writing_throttling_trigger_percentage | 100 | 指定触发租户限流时增量内存的使用比例阈值。 | 租户 | -| max_stale_time_for_weak_consistency | 5s | 指定弱一致读能接受备副本的最大时延。 | 租户 | - - - - - -* 下表所示是常用的租户变量(variables) - - - - - - - -| **变量名** | **变量值** | **变量含义** | -|-----------------------------|---------------------------------------------------------------|------------------------------------------------------------------------------| -| autocommit | ON | 指定租户是否开启事务自动提交。 | -| nls_date_format | DD-MON-RR | 指定 Oracle 租户的默认日期格式。 | -| nls_timestamp_format | DD-MON-RR HH.MI.SSXFF AM | 指定 Oracle 租户的默认时间戳格式。 | -| nls_timestamp_tz_format | DD-MON-RR HH.MI.SSXFF AM TZR | 指定 Oracle 租户的默认带时区的时间戳格式。 | -| ob_compatibility_mode | ORACLE/MYSQL | 显示当前租户的兼容类型。ORACLE/MYSQL。只读变量。 | -| ob_tcp_invited_nodes | % | 指定租户访问的IP白名单,逗号分隔。如:127.1,192.168.0.0/16 | -| ob_timestamp_service | GTS | 指定租户时间服务是用 GTS 还是 LTS。 | -| ob_query_timeout | 10000000 | 指定 SQL 执行默认超时时间,单位微秒(us)。 | -| ob_trx_idle_timeout | 120000000 | 指定租户里事务最大空闲时间,单位微秒(us)。 | -| ob_trx_timeout | 100000000 | 指定租户里事务最大持续时间,单位微秒(us)。 | -| ob_read_consistency | STRONG | 指定租户里读 SQL 的默认一致性级别。STRONG 是强一致读,WEAK 是弱一致性读,FORZEN 是读上次major freeze 版本的数据。 | -| ob_sql_audit_percentage | 3 | 指定租户 SQL 日志占用最大内存百分比。 | -| ob_sql_work_area_percentage | 5 | 指定租户 SQL 工作内存占内存最大百分比。 | -| recyclebin | ON | 指定是否开启回收站。ON 开启,OFF 关闭。 | -| sql_mode | STRICT_TRANS_TABLES,STRICT_ALL_TABLES,PAD_CHAR_TO_FULL_LENGTH | 指定 SQL 遵守的模式。 | -| tx_isolation | READ-COMMITTED | 指定租户事务默认隔离级别。 | -| time_zone | +8:00 | 指定租户默认时区。 | -| system_time_zone | +08:00 | 显示系统默认时区。 | -| version_comment | | 显示 OceanBase 版本,只读变量。 | - - diff --git a/docs/docs/docs-cn/8.developer-guide-oracle-mode/8.appendix-1/3.common-sql-hints-for-oceanbase-1.md b/docs/docs/docs-cn/8.developer-guide-oracle-mode/8.appendix-1/3.common-sql-hints-for-oceanbase-1.md deleted file mode 100644 index 9e031a7f9..000000000 --- a/docs/docs/docs-cn/8.developer-guide-oracle-mode/8.appendix-1/3.common-sql-hints-for-oceanbase-1.md +++ /dev/null @@ -1,45 +0,0 @@ -OceanBase 常用 SQL Hints -=========================================== - - - -SQL Hint的语法格式如下: - -```javascript -/*+ HINT_NAME */ -``` - - - -或 - -```javascript -/*+ HINT_NAME ( HINT_PARA ) -``` - - - -如果是在命令行客户端 obclient 或 mysql 下连接 OceanBase,注意需要指定参数 -c ,这样 Hint 文本才会发送到 OBServer 端生效。 - -OceanBase 常用 SQL Hint 如下表所示: - - -| **Hint** **名称** | **Hint** **参数** | **Hint** **语义** | -|-------------------------|-------------------------------------------------------|----------------------------------------------------------------------------| -| NO_REWRITE | | 不改写 SQL。 | -| READ_CONSISTENCY | weak\|strong\|frozen | weak:弱一致性读 strong:强一致性读 frozen:读最近一次冻结点的数据 | -| INDEX_HINT | \[ *qb_name* \] *table_name* *index_name* | 指定查询表时选择的索引。 | -| QUERY_TIMEOUT | *int64* | 指定语句执行的超时时间,单位是微秒(us)。 | -| LEADING | \[ *qb_name* \] *table_name* \[, *table* _ *name* \] | 指定多表连接时的顺序。 | -| ORDERED | | 指定多表连接顺序按SQL中表出现的顺序。 | -| FULL | \[qb *_name* \] *table_name* | 指定表的访问方式为全表扫描(有主键时会读主键)。 | -| USE_MERGE | \[qb *_name* \] *table_name* \[, *table_name* \] | 指定多表连接时使用MERGE算法。 | -| USE_NL | \[ *qb_name* \] *table_name* \[, *table_name* \] | 指定多表连接时使用NEST LOOP算法。 | -| USE_BNL | \[qb_name\] table_name \[,table_name\] | 指定多表连接时适用BLOCK NEST LOOP算法。 | -| USE_HASH_AGGREGATION | \[ *qb_name* \] | 指定 aggregate 方法使用HASH AGGREGATE,例如HASH GROUP BY,HASH DISTINCT。 | -| NO_USE_HASH_AGGREGATION | \[ *qb_name* \] | 指定 aggregate 方法不使用HASH AGGREGATE,使用MERGE GROUP BY,MERGE DISTINCT 。 | -| QB_NAME | *qb_name* | 指定 query block的名称。 | -| PARALLEL | *int64* | 指定分布式执行的并行度。 | - - - diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/1.what-is-jdbc/1.jdbc-overview.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/1.what-is-jdbc/1.jdbc-overview.md deleted file mode 100644 index 9af7973df..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/1.what-is-jdbc/1.jdbc-overview.md +++ /dev/null @@ -1,69 +0,0 @@ -JDBC 简介 -============================ - -Java 数据库连接器(Java Database Connectivity,JDBC)提供了 Java 连接关系数据库的接口,是一种 Java 标准。 - -JDBC 标准由 Sun Microsystems 定义,通过标准 `java.sql` 接口实现,支持各个提供程序使用自己的 JDBC 驱动程序来实现和扩展标准。JDBC 是基于 X/Open SQL 的调用级别接口(Call Level Interface,CLI)。 - -主要功能 ----------------------- - -OceanBase JDBC 主要模块的功能如下: - -* DriverManager:用于加载驱动程序(Driver),并根据调用请求返回相应的数据库连接(Connection)。 - - - -* Driver:驱动程序,会被加载到 DriverManager 中,负责处理请求并返回相应的数据库连接(Connection)。 - - - -* Connection:数据库连接,负责与数据库进行通讯,提供 SQL 执行以及事务处理的 Connection 环境,创建和执行 Statement。 - - - - - - - - -* Statment: - - * Statements:用以单次执行 SQL 查询和更新。 - - - - * PreparedStatement:用以执行已缓存的 Statement,其执行路径已经预先确定,支持重复执行以提高执行效率。 - - - - * CallableStatement:用以执行数据库中的存储过程。 - - - - - - - - - - - -* SQLException:显示在与数据库创建、关闭连接,或者执行 SQL 语句时发生的错误。 - - - - - - -JDBC 驱动程序 ---------------------------- - -OceanBase JDBC 的驱动程序为 OceanBase Client,属于 Type 4 驱动类型,可以通过本地协议直接与数据库引擎通信。OBServer 支持 OceanBase Client,同时完全兼容 MySQL 原生的 JDBC 驱动(MySQL Connector Java)。OceanBase Client 完全兼容 MySQL JDBC 的使用方式,可以自动识别 OceanBase 数据库的运行模式是 MySQL 还是 Oracle,并在协议层同时兼容这两种模式。OceanBase Client 兼容 OB2.0 协议。 -**注意** - - - -OBServer 会依据 JDBC 驱动连接时的租户名称判断运行模式为 MySQL 或者 Oracle。Oracle 模式的租户只允许使用 Oracle 兼容的 SQL 语法。 - -除了支持标准的 JDBC 应用程序编程接口(API),OceanBase JDBC 还兼容 Oracle driver 的使用方式,OBServer 的 Oracle 模式兼容 Oracle 的大部分语法。 diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/1.what-is-jdbc/2.compatibility-requirements.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/1.what-is-jdbc/2.compatibility-requirements.md deleted file mode 100644 index b014e4fb3..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/1.what-is-jdbc/2.compatibility-requirements.md +++ /dev/null @@ -1,29 +0,0 @@ -兼容性要求 -========================== - -OceanBase JDBC 对 OBServer 和 Java 版本有相应的兼容性要求。 - -服务器兼容性 ------------------------- - -OceanBase JDBC 与 OBServer 的兼容性如下表所示。 - - -| **OceanBase JDBC 版本** | **所兼容的 OBServer 版本** | -|-----------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| JDBC V2 | * OceanBase V1.4.x * OceanBase V2.0.x * OceanBase V2.1.x * OceanBase V2.2.x * OceanBase V3.1.x | - - - -Java 兼容性 --------------------------- - -OceanBase JDBC 与 Java 的兼容性如下表所示。 - - -| **OceanBase JDBC 版本** | **所兼容的 Java 版本** | -|-----------------------|------------------| -| JDBC V2 | Java 11, Java 8 | - - - diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/1.install-the-oceanbase-client.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/1.install-the-oceanbase-client.md deleted file mode 100644 index 9518e80e9..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/1.install-the-oceanbase-client.md +++ /dev/null @@ -1,77 +0,0 @@ -安装 OceanBase JDBC 驱动 -========================================= - -安装 OceanBase JDBC 驱动程序即 OceanBase Client for Java 需要具备一定的前提条件,并根据相应的步骤进行安装或升级。 - -前提条件 ----------------------- - -在安装使用 OceanBase JDBC 产品前请确保设置了基本的数据库开发环境,要求如下: - -* 在计算机上安装或升级到 Java JDK 8 版本。 - - - -* 根据需要安装数据库管理系统(DBMS)。 - - - - - - -安装步骤 ----------------------- - -获取 OceanBase Client for Java 安装包后,根据如下步骤进行安装或升级: - -1. 使用 Maven 安装 OceanBase Client for Java。 - - 请将以下依赖项添加到 `pom.xml` 配置文件中: - - ```unknow - - com.oceanbase - oceanbase-client - 2.2.0 - - ``` - - - **说明** - - - - 之前版本的 `groupId` 是 `com.alipay.oceanbase`。 - - -2. 装载驱动。 - - 类名为 `Class.forName("com.oceanbase.jdbc.Driver");` 或 - `Class.forName("com.oceanbase.obproxy.mysql.jdbc.Driver");` - - - **注意** - - - - 兼容之前的驱动 `com.alipay.oceanbase.jdbc.Driver` 和 `com.alipay.oceanbase.obproxy.mysql.jdbc.Driver`。 - - -3. 导入内部类。 - 将路径由原来的 `com.aplipay.oceanbase.jdbc` 修改为 `com.oceanbase.jdbc`。 - - - -4. 执行源代码编译。 - - ```unknow - mvn clean package -DskipTests - ``` - - - - - - - - diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/10.failover-and-load-balancing.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/10.failover-and-load-balancing.md deleted file mode 100644 index 2134a5c15..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/10.failover-and-load-balancing.md +++ /dev/null @@ -1,46 +0,0 @@ -Failover 和 Load-Balancing -============================================== - -OceanBase JDBC 支持三种 Failover 和 Load-Balancing 模式:sequential、loadbalance 和 replication。 - -sequential 模式 -------------------------------- - -`sequential` 模式在多主机环境中支持连接 Failover。此模式不支持从属服务器的 Load-Balancing 读取。连接器将尝试按照在连接 URL 中声明的顺序连接到主机,因此第一个可用的主机将用于所有查询。 -例如,连接 URL 如下: - -```unknow -jdbc:oceanbasedb:sequential:host1,host2,host3,host4/testobdb -``` - - - -当连接器尝试连接时,首先尝试连接 `host1`。如果该主机不可用,则尝试连接 `host2`。当主机发生故障时,连接器将尝试以相同的顺序重新连接到主机。 - -loadbalance 模式 --------------------------------- - -`loadbalance` 模式在多主机环境中支持连接 Load-Balancing。此模式不支持从属服务器的 Load-Balancing 读取。连接器通过从每个连接 URL 中随机选择一个主机来对所有查询执行 Load-Balancing。由于连接随机分布在所有主机上,因此查询实现 Load-Balancing。 - -replication 模式 --------------------------------- - -`replication` 模式在主从环境支持连接 Load-Balancing。该模式支持具有一个或多个主机的环境。如果在执行读取之前将连接设置为只读,则此模式支持从属服务器的 Load-Balancing 读取。连接器通过从连接 URL 中随机选择一个从服务器来执行读取查询,从而执行 Load-Balancing。 - -相关参数 ----------------------- - -相关参数如下表所示。 - - -| **参数** | **描述** | -|-----------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| autoReconnect | 如果启用了此参数,并且未使用 Failover 和 Load-Balancing 模式,则连接器在连接失败后仅尝试重新连接到主机,这称为 Basic Failover。 如果启用了此参数,并且正在使用 Failover 和 Load-Balancing 模式,则连接器会将出现故障的主机列入黑名单,并尝试连接到其他相同类型的主机。这称为 Standard Failover。 默认值: `false`。 | -| retriesAllDown | 当连接器正在执行 Failover 并且所有主机都关闭时,此参数用于定义连接器的最大连接尝试次数,以避免引发异常。 默认值:120 秒。 | -| failoverLoopRetries | 当连接器静默搜索有效主机时,此参数用于定义连接器的最大连接尝试次数,以避免引发异常。此参数不同于 `retriesAllDown` 参数,此静默搜索用于连接器的临时解决方案,例如在从属连接失败时使用主连接执行读取。 默认值:120。 | -| validConnectionTimeout | 当配置了多个主机时,连接器在所设置的时长(以秒为单位)之内,不会丢失验证连接。当此参数设置为 0 时,将不进行任何验证。 默认值:120 秒。 | -| loadBalanceBlacklistTimeout | 当连接失败时,此主机将被列入此参数所定义的时长黑名单。当连接到主机时,驱动程序将尝试连接未列入黑名单的主机,只有在未找到主机的情况下,才尝试连接已列入黑名单的主机。 此黑名单在类加载器内部共享。 默认值:50 秒。 | -| assureReadOnly | 如果使用 Failover 和 Load-Balancing 模式并与主机建立只读连接时启用此参数,将会话设置为只读来确保此连接处于只读模式。 默认为 `false`。 | -| allowMasterDownConnection | 使用 Failover 和 Load-Balancing 的 `replication` 模式时,允许在主服务器关闭时创建连接。如果没有可用的主服务器,则默认连接从服务器,而 `Connection.isReadOnly()` 将返回 `true`。 默认值:`false`。 | - - diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/11.batch-processing.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/11.batch-processing.md deleted file mode 100644 index 6bb5462f7..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/11.batch-processing.md +++ /dev/null @@ -1,143 +0,0 @@ -批处理 -======================== - -通过将多个 `UPDATE` 或 `INSERT` 语句分组为一个批处理,将整个批处理发送到数据库并一起处理,可以减少数据库的往返处理次数,从而提高应用程序性能。 - -JDBC 驱动程序使用服务器 `PrepareStatement` 和 `Statements` 作为与数据库进行批处理通信的标准,并通过 `allowMultiQueries` 和 `rewriteBatchedStatements` 两个参数进行管理。如果将 `allowMultiQueries` 或 `rewriteBatchedStatements` 选项设置为 `true`,则 JDBC 驱动程序将仅使用文本协议。`PrepareStatement`(参数替换)在客户端由驱动程序处理。 - -`rewriteBatchedStatements` 对于插入查询,用于重写 `batchedStatement` 以在单个 `executeQuery` 中执行。当它处于活跃状态时,`useServerPrepStmts` 选项被设置为 `false`。`allowMultiQueries` 为 `true` 时允许多值查询。 - -在 Oracle 和 MySQL 两种模式下,JDBC 驱动程序对于批处理的设置会有不同。Oracle 模式下的批处理 - -**PrepareStatement 处理方式** - - -| **useServerPrepStmts** | **rewriteBatchedStatements** | **allowMultiQueries** | **INSERT 操作** | **UPDATE 操作** | -|------------------------|------------------------------|-----------------------|---------------------------------------------------|--------------------------------------------------| -| true | true | true | Prepare 的 SQL String 会变成 `VALUES(),(),()...`的格式。 | Prepare 的 SQL String 是正常格式,之后通过多次`EXECUTE` 设置参数。 | -| true | true | false | Prepare 的 SQL String 会变成 `VALUES(),(),()...`的格式。 | Prepare 的 SQL String 是正常格式,之后通过多次`EXECUTE` 设置参数。 | -| true | false | true | Prepare 的 SQL String是正常格式,之后通过多次 `EXECUTE` 来设置参数。 | Prepare 的 SQL String是正常格式,之后通过多次`EXECUTE` 来设置参数。 | -| true | false | false | Prepare 的 SQL String 是正常格式,之后通过多次`EXECUTE` 设置参数。 | Prepare 的 SQL String 是正常格式,之后通过多次`EXECUTE` 设置参数。 | -| false | true | true | 拼成一个完整的 `VALUES(),(),()... `格式的字符串。 | 拼成一个完整的 `VALUES(),(),()...` 格式的字符串。 | -| false | true | false | 拼成一个完整的 `VALUES(),(),()... `格式的字符串。 | 执行多条 `UPDATE` 语句。 | -| false | false | true | 执行多条 `INSERT` 语句。 | 执行多条 `UPDATE` 语句。 | -| false | false | false | 执行多条 `INSERT` 语句。 | 执行多条 `UPDATE` 语句。 | - - - -**Statement 处理方式** - - -| **useServerPrepStmts** | **rewriteBatchedStatements** | **allowMultiQueries** | **INSERT 操作** | **UPDATE 操作** | -|------------------------|------------------------------|-----------------------|-----------------------------------------|-----------------------------------------| -| true | true | true | SQL String 会变成 `VALUES(),(),()...` 的格式。 | SQL String 会变成 `VALUES(),(),()...` 的格式。 | -| true | true | false | 逐一执行 SQL。 | 逐一执行 SQL。 | -| true | false | true | SQL String 会变成 `VALUES(),(),()...` 的格式。 | SQL String 会变成 `VALUES(),(),()...` 的格式。 | -| true | false | false | 逐个执行 `INSERT`。 | 逐个执行 `UPDATE`。 | -| false | true | true | SQL String 会变成 `VALUES(),(),()...` 的格式。 | SQL String 会变成 `VALUES(),(),()...` 的格式。 | -| false | true | false | 逐一执行 SQL。 | 逐一执行 SQL。 | -| false | false | true | SQL String 会变成 `VALUES(),(),()...` 的格式。 | SQL String 会变成 `VALUES(),(),()...` 的格式。 | -| false | false | false | 逐一执行 `INSERT`。 | 逐一执行 `UPDATE`。 | - - - -MySQL 模式下的批处理 -------------------------------- - -**PrepareStatement 处理方式** - - -| **useServerPrepStmts** | **rewriteBatchedStatements** | **allowMultiQueries** | **INSERT** **操作** | **UPDATE** **操作** | -|------------------------|------------------------------|-----------------------|----------------------------------------------------|-------------------------------------------------------| -| true | true | true | SQL String 会变成 `VALUES(),(),()...` 的格式。 | 逐一 Prepare 的 SQL String 是正常格式,之后通过多次 `EXECUTE` 来设置参数。 | -| true | true | false | SQL String 会变成 `VALUES(),(),()...` 的格式。 | 逐一 Prepare 的 SQL String 是正常格式,之后通过多次 `EXECUTE` 来设置参数。 | -| true | false | true | Prepare 的 SQL String 是正常格式,之后通过多次 `EXECUTE` 来设置参数。 | Prepare 的 SQL String 是正常格式,之后通过多次 `EXECUTE` 来设置参数。 | -| true | false | false | Prepare 的 SQL String 是正常格式,之后通过多次 `EXECUTE` 来设置参数。 | Prepare 的 SQL String 是正常格式,之后通过多次 `EXECUTE` 来设置参数。 | -| false | true | true | 拼成一个完整的 `VALUES(),(),()...` 格式的字符串。 | 拼成一个完整的 `VALUES(),(),()...` 格式的字符串。 | -| false | true | false | 拼成一个完整的 `VALUES(),(),()...` 格式的字符串。 | 执行多条 `UPDATE` 语句。 | -| false | false | true | 执行多条 `INSERT` 语句。 | 执行多条 `UPDATE` 语句。 | -| false | false | false | 执行多条 `INSERT` 语句。 | 执行多条 `UPDATE` 语句。 | - - - -**Statement 处理方式** - - -| **useServerPrepStmts** | **rewriteBatchedStatements** | **allowMultiQueries** | **INSERT** **操作** | **UPDATE 操作** | -|------------------------|------------------------------|-----------------------|-----------------------------------------|-----------------------------------------| -| true | true | true | SQL String 会变成 `VALUES(),(),()...` 的格式。 | SQL String 会变成 `VALUES(),(),()...` 的格式。 | -| true | true | false | 逐一执行 SQL。 | 逐一执行 SQL。 | -| true | false | true | SQL String 会变成 `VALUES(),(),()...` 的格式。 | SQL String 会变成 `VALUES(),(),()...` 的格式。 | -| true | false | false | 逐一执行 `INSERT`。 | 逐一执行 `UPDATE`。 | -| false | true | true | SQL String 会变成 `VALUES(),(),()...` 的格式。 | SQL String 会变成 `VALUES(),(),()...` 的格式。 | -| false | true | false | 逐一执行 SQL。 | 逐一执行 SQL。 | -| false | false | true | SQL String 会变成 `VALUES(),(),()...` 的格式。 | SQL String 会变成 `VALUES(),(),()...` 的格式。 | -| false | false | false | 逐一执行 `INSERT`。 | 逐一执行 `UPDATE`。 | - - - -示例 ------------------------ - -```unknow -public void test_execute_batch() { - Connection conn = null; - try { - for (int q = 0; q < 2; q++) { - for (int w = 0; w < 2; w++) { - for (int e = 0; e < 2; e++) { - - - /** - * useServerPrepStmts = true / false - * rewriteBatchedStatements = true / false - * allowMultiQueries = true / false - */ - boolean uSPS = q == 0 ? false : true; - String rBS = w == 0 ? "false" : "true"; - String aMQ = e == 0 ? "false" : "true"; - - String other_condition = "&rewriteBatchedStatements=" + rBS - + "&allowMultiQueries=" + aMQ; - conn = ConnectionUtils.getDefObOracleConnection(uSPS, true, other_condition); - Statement statement = conn.createStatement(); - - try { - statement.execute("DROP TABLE test_batch_t"); - } catch (SQLException exp) { - //e.printStackTrace(); - } - - String sql = "create table test_batch_t(id int primary key, c1 varchar2(10))"; - statement.execute(sql); - - PreparedStatement ps = conn - .prepareStatement("insert into test_batch_t(id, c1) values (?, ?)"); - - for (int j = 0; j < 10; j++) { - ps.setInt(1, j); - ps.setString(2, j + "_test"); - ps.addBatch(); - } - ps.executeBatch(); - - ps = conn.prepareStatement("update test_batch_t set id = ? where c1 = ?"); - - for (int j = 0; j < 10; j++) { - ps.setInt(1, j); - ps.setString(2, j + "_test"); - ps.addBatch(); - } - ps.executeBatch(); - } - } - } - } catch (Exception e) { - e.printStackTrace(); - } - - -} -``` - - diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/12.jdbc-security-features.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/12.jdbc-security-features.md deleted file mode 100644 index 75bdcc0f3..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/12.jdbc-security-features.md +++ /dev/null @@ -1,57 +0,0 @@ -JDBC 安全功能 -============================== - -JDBC 支持登录认证和 SSL 安全功能。 - -登录认证 ----------------------- - -客户端身份验证服务支持添加新的客户端身份验证插件。 - -Java 连接器中的身份验证插件列表: - -* mysql_clear_password - - - -* auth_gssapi_client - - - -* client_ed25519 - - - -* mysql_native_password - - - -* mysql_old_password - - - -* dialog (PAM) - - - -* sha256_password - - - -* caching_sha2_password - - - - - - -可以通过实现接口 `org.oceanbasedb.jdbc.authentication.AuthenticationPlugin` 来创建新的身份验证插件。 - -SSL ---------------------- - -可以使用定制化 SSL 来实现与服务器的连接,最初会创建一个 Socket。设置后,SSL Socket 将在此现有 Socket 上分层。`org.oceanbasedb.jdbc.tls.TlsSocketPlugin` 允许提供自定义 SSL 实现,例如创建新的 `HostnameVerifier`。 - -定制化需要使用 `org.oceanbasedb.jdbc.tls.TlsSocketPlugin` 并注册服务 `META-INF/services/org.oceanbasedb.jdbc.tls.TlsSocketPlugin`。 - -选项 `tlsSocketType` 用于激活定制化。 diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/13.troubleshooting-common-issues.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/13.troubleshooting-common-issues.md deleted file mode 100644 index 16f473ef7..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/13.troubleshooting-common-issues.md +++ /dev/null @@ -1,18 +0,0 @@ -常见问题排查 -=========================== - - - -出现错误信息 "Could not read resultset: unexpected end of stream, read 0 bytes from 4" --------------------------------------------------------------------------------------------------- - -这是在与服务器通信时出现的问题。 - -在大多数情况下,这是由读取具有较大结果集的查询引起的。服务器通常希望客户端相对快速地读取结果集。 `net_write_timeout` 服务器变量控制此行为(默认为 60s)。如果客户端在这段时间内没有读取整个结果集,则服务器将丢弃该连接。如果不希望在此时间内处理结果,则可以使用查询 `SET STATEMENT net_write_timeout = 10000 FOR XXX`,而 XXX 是指"常规"查询。`net_write_timeout` 针对此查询将设置为更长的时间(在此示例中为 10000)。 - -如果应用程序通常使用很多具有提取大小的长查询,则可以使用 `sessionVariables = net_write_timeout = xxx` 选项设置连接。 - -如何进行轻量级 Ping/ 以避免大量"select 1" ------------------------------------------------ - -`Connection.isValid()` 可以进行轻量级 `Ping/` 以避免大量"select 1"。`Connection.isValid()` 在 MySQL 协议中执行 Ping 操作,而不是网络 Ping 操作。 diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/14.jdbc-reference/1.supported-sql-and-pl-data-types.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/14.jdbc-reference/1.supported-sql-and-pl-data-types.md deleted file mode 100644 index 3ced65bb7..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/14.jdbc-reference/1.supported-sql-and-pl-data-types.md +++ /dev/null @@ -1,179 +0,0 @@ -支持的 SQL 和 PL 数据类型 -====================================== - -本节中的表列出了 SQL 和 PL 数据类型,并标注 OceanBase JDBC 驱动的支持情况。 - -SQL 数据类型 --------------------------- - - - -| **SQL 数据类型** | **JDBC** **是否支持** | -|---------------|-------------------| -| BLOB | 支持 | -| CHAR | 支持 | -| CLOB | 支持 | -| DATE | 支持 | -| NCHAR | 不支持 | -| NCHAR VARYING | 不支持 | -| NUMBER | 支持 | -| NVARCHAR2 | 支持 | -| RAW | 支持 | -| REF | 支持 | -| ROWID | 支持 | -| UROWID | 不支持 | -| VARCHAR2 | 支持 | - - -**说明** - - - -* 只间接支持 NCHAR 类型,没有对应的 `java.sql.Types` 类型,但是如果应用程序调用 `formOfUse(NCHAR)` 方法,则可以访问此类型。 - - - -* 在 JSE 6 中,直接支持 NVARCHAR2 类型。在J2SE 5.0 中,间接支持 NVARCHAR2 类型。没有对应的 `java.sql.Types` 类型,但是如果应用程序调用 `formOfUse(NCHAR)` 方法,则可以访问此类型。 - - - - - - -ANSI 所支持的 SQL 数据类型 ------------------------------------- - - - -| **ANSI 支持的 SQL 数据类型** | **JDBC** **是否支持** | -|----------------------------|-------------------| -| CHARACTER | 支持 | -| DEC | 支持 | -| DECIMAL | 支持 | -| DOUBLE PRECISION | 支持 | -| FLOAT | 支持 | -| INT | 支持 | -| INTEGER | 支持 | -| NATIONAL CHARACTER | 不支持 | -| NATIONAL CHARACTER VARYING | 不支持 | -| NATIONAL CHAR | 支持 | -| NATIONAL CHAR VARYING | 不支持 | -| NCHAR | 支持 | -| NCHAR VARYING | 不支持 | -| NUMERIC | 支持 | -| REAL | 支持 | -| SMALLINT | 支持 | -| VARCHAR | 支持 | - - - -用户自定义 SQL 类型 ------------------------------- - - - -| **用户自定义 SQL 类型** | **JDBC 是否支持** | -|-------------------|---------------| -| OPAQUE | 支持 | -| 参考类型 | 支持 | -| 对象类型(JAVA_OBJECT) | 支持 | -| 嵌套表和可变数组 | 支持 | - - - -PL 数据类型 -------------------------- - -PL 数据类型包括以下类别: - -* 标量类型 - - - -* 标量字符类型,其中包括 `BOOLEAN` 和 `DATE` 数据类型 - - - -* 复合类型 - - - -* 参考类型 - - - -* 大对象(LOB)类型 - - - - - - -| **PL 数据类型** | **JDBC 是否支持** | -|------------------|---------------| -| **标量类型:** | | -| BINARY INTEGER | 支持 | -| DEC | 支持 | -| DECIMAL | 支持 | -| DOUBLE PRECISION | 支持 | -| FLOAT | 支持 | -| INT | 支持 | -| INTEGER | 支持 | -| NATURAL | 支持 | -| NATURAL **n** | 不支持 | -| NUMBER | 支持 | -| NUMERIC | 支持 | -| PLS_INTEGER | 支持 | -| POSITIVE | 支持 | -| POSITIVE **n** | 不支持 | -| REAL | 支持 | -| SIGNTYPE | 支持 | -| SMALLINT | 支持 | -| **标量字符类型:** | | -| CHAR | 支持 | -| CHARACTER | 支持 | -| LONG | 支持 | -| LONG RAW | 支持 | -| NCHAR | 不支持 | -| NVARCHAR2 | 不支持 | -| RAW | 支持 | -| ROWID | 支持 | -| STRING | 支持 | -| UROWID | 不支持 | -| VARCHAR | 支持 | -| VARCHAR2 | 支持 | -| BOOLEAN | 支持 | -| DATE | 支持 | -| **复合类型:** | | -| RECORD | 不支持 | -| TABLE | 不支持 | -| VARRAY | 支持 | -| **参考类型:** | | -| REF CURSOR 类型 | 支持 | -| 对象引用类型 | 支持 | -| **LOB 类型:** | | -| BLOB | 支持 | -| CLOB | 支持 | -| NCLOB | 支持 | - - -**说明** - - - - - -* 类型 `NATURAL`、`NATURALn`、`POSITIVE`、`POSITIVEn` 和 `SIGNTYPE` 是 `BINARY INTEGER` 的子类型。 - - - -* `DEC`、`DECIMAL`、`DOUBLE PRECISION`、`FLOAT`、`INT`、`INTEGER`、`NUMERIC`、`REAL` 和 `SMALLINT` 类型是 `NUMBER` 的子类型。 - - - -* 间接支持类型 `NCHAR` 和 `NVARCHAR2`。他们没有对应的 `java.sql.Types` 类型,但是如果应用程序调用`formOfUse`(NCHAR),则可以访问这些类型。 - - - - - diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/2.jdbc-basic-operation/1.import-package.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/2.jdbc-basic-operation/1.import-package.md deleted file mode 100644 index 1a5c9842a..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/2.jdbc-basic-operation/1.import-package.md +++ /dev/null @@ -1,14 +0,0 @@ -导入程序包 -========================== - -在使用 OceanBase JDBC 驱动程序前,在应用程序的开头需加入 import 语句,以导入相应的程序包。 - -导入语句和作用如下表所示。 - - -| **导入语句** | **作用** | -|----------------------|-------------------------------------------------------------| -| `importjava.sql.*;` | 提供标准 JDBC 接口。 | -| `importjava.math.*;` | 可选。提供 BigDecimal 和 BigInteger 类。如果在应用程序中不需要使用这些类,则可以忽略此程序包。 | - - diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/2.jdbc-basic-operation/2.open-connection-to-database.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/2.jdbc-basic-operation/2.open-connection-to-database.md deleted file mode 100644 index 536419ed8..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/2.jdbc-basic-operation/2.open-connection-to-database.md +++ /dev/null @@ -1,67 +0,0 @@ -打开与数据库的连接 -============================== - -OceanBase JDBC 支持两种数据库连接方式:DriverManager 和数据连接池。 - -使用 DriverManager ----------------------------------- - -与 OceanBase Client 建立连接时,推荐使用 DriverManager 类。使用 DriverManager 类时,无需配置,就可以自动加载 OceanBase Client,示例如下: - -```javascript -Connection connection = DriverManager.getConnection("jdbc:oceanbase://lt:2883/user=root&password=***"); -``` - - - -使用数据连接池 -------------------------- - -与 OceanBase Client 建立连接的另一种方法是使用连接池。 - -OceanBase Client 支持 2 种不同的 Datasource Pool 实现: - -* `OceanbaseDataSource`:基本实现。每次调用 `getConnection()` 方法时都会创建一个新连接。 - - - -* `OceanbasePoolDataSource`:连接池实现。连接池用于集中维护连接资源,当收到新的连接请求时,会从该池中借用一个连接。 - - - - - - -**内部池** - -驱动程序的内部池配置提供了非常快速的池实现,并解决了以下大多数 Java 池具有的问题: - -* 释放后出现 2 种不同的连接状态 - - - -* 处理非活跃连接(如果一段时间后不使用,则池中的连接将被释放,避免在达到 `@wait_timeout` 阈值之后,由于服务器关闭连接而产生的问题)。 - - - - - - -**外部池** - -使用外部连接池时,必须配置 OceanBase 驱动程序类 `com``.oceanbase.jdbc.Driver`。 - -示例:使用 hikariCP JDBC 连接池。 - -```unknow -final HikariDataSource ds = new HikariDataSource(); -ds.setMaximumPoolSize(10); -ds.setDriverClassName("com.oceanbase.jdbc.Driver"); -ds.setJdbcUrl("jdbc:oceanbase://localhost:2883/db"); -ds.addDataSourceProperty("user", "root"); -ds.addDataSourceProperty("password", "OBClient"); -ds.setAutoCommit(false); -``` - - - diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/2.jdbc-basic-operation/3.create-a-statement-object.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/2.jdbc-basic-operation/3.create-a-statement-object.md deleted file mode 100644 index 7e2bc4d5c..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/2.jdbc-basic-operation/3.create-a-statement-object.md +++ /dev/null @@ -1,14 +0,0 @@ -创建语句对象 -=========================== - -JDBC 在与数据库连接过程中先创建一个 Connection 对象,然后创建一个 Statement 对象。 - -JDBC `Connection` 对象使用 `createStatement` 方法返回 JDBC `Statement` 类型的对象。 - -创建 `Statement` 对象的示例如下: - -```unknow -Statement st = conn.createStatement(); -``` - - diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/2.jdbc-basic-operation/4.run-queries-and-retrieve-result-set-objects.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/2.jdbc-basic-operation/4.run-queries-and-retrieve-result-set-objects.md deleted file mode 100644 index ac256436a..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/2.jdbc-basic-operation/4.run-queries-and-retrieve-result-set-objects.md +++ /dev/null @@ -1,26 +0,0 @@ -运行查询并检索结果集对象 -================================= - -Statement 对象使用 `executeQuery` 方法查询数据库,即将 SQL 语句作为输入,并返回 JDBC ResultSet 对象。 -**说明** - - - -* 执行 `Statement` 对象的方法取决于所执行的 SQL 语句的类型。如果 `Statement` 对象表示返回 `ResultSet` 对象的 SQL 查询,则应使用 `executeQuery` 方法。如果已知 SQL 是更新计数的 DDL 语句或 DML 语句,则应使用 `executeUpdate` 方法。 如果 SQL 语句的类型未知,则应使用 `execute` 方法。 - - - -* 对于标准的 JDBC 驱动程序,如果正在执行的 SQL 字符串未返回 `ResultSet` 对象,则 `executeQuery` 方法将引发 SQLException 异常。对于 OceanBaseJDBC 驱动程序,即使正在执行的 SQL 字符串未返回 `ResultSet` 对象,`executeQuery` 方法也不会引发 SQLException 异常。 - - - - - - -示例:`Statement` 对象 `st` 运行一个查询,并返回 `ResultSet` 对象,该对象包含表名为 `customers` 的 `name` 列的内容。 - -```unknow -ResultSet rs = st.executeQuery ("SELECT name FROM customers"); -``` - - diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/2.jdbc-basic-operation/5.processing-result-set-objects.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/2.jdbc-basic-operation/5.processing-result-set-objects.md deleted file mode 100644 index cec6cb915..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/2.jdbc-basic-operation/5.processing-result-set-objects.md +++ /dev/null @@ -1,18 +0,0 @@ -处理结果集对象 -============================ - -运行查询后,ResultSet 对象使用 next() 方法遍历结果。 - -此方法可以遍历结果集,并检测是否到达结果集的结尾。 - -要在遍历过程中从结果集中提取数据,请使用 `ResultSet` 对象的 `getXXX` 方法,其中 `XXX` 对应于 Java 数据类型。 - -示例:遍历 `ResultSet` 对象 `rs`,检索并打印每个顾客的姓名。 - -```unknow -while (rs.next()) System.out.println (rs.getString(1)); -``` - - - -当到达结果集的末尾时,`next()` 方法将返回 `false`。顾客姓名被物化为 Java 的 `String` 值。 diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/2.jdbc-basic-operation/6.close-result-sets-and-objects.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/2.jdbc-basic-operation/6.close-result-sets-and-objects.md deleted file mode 100644 index 862fed9f9..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/2.jdbc-basic-operation/6.close-result-sets-and-objects.md +++ /dev/null @@ -1,17 +0,0 @@ -关闭结果集和对象 -============================= - -使用完 ResultSet 和 Statement 对象后,必须执行显式关闭。 - -这适用于使用 OceanBase JDBC 驱动程序创建的所有 `ResultSet` 和 `Statement` 对象。 - -由于驱动程序没有收尾机制,`ResultSet` 和 `Statement` 类使用 `close` 方法执行清理例程。如果没有显式关闭`ResultSet` 和 `Statement` 对象,可能会发生严重的内存泄漏,也可能耗尽数据库中的游标。同时关闭 `ResultSet` 和 `Statement` 对象将释放数据库中相应的游标。如果仅关闭结果集,则不会释放游标。 - -示例:同时关闭 `ResultSet` 对象 `rs` 和 `Statement` 对象 `st`。 - -```unknow -rs.close(); -st.close(); -``` - - diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/2.jdbc-basic-operation/7.change-database.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/2.jdbc-basic-operation/7.change-database.md deleted file mode 100644 index 9880e3518..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/2.jdbc-basic-operation/7.change-database.md +++ /dev/null @@ -1,104 +0,0 @@ -更改数据库 -========================== - -OceanBase JDBC 支持 DML 操作和 DDL 操作来更改数据库。 - -DML 操作 ------------------------- - -要执行数据操作语言(DML)的 `INSERT` 或 `UPDATE` 操作,可以创建一个 `Statement` 对象或 `PreparedStatement` 对象。可以使用 `PreparedStatement` 对象运行带有输入参数集的语句。JDBC `Connection` 对象的 `prepareStatement` 方法可以定义一条语句并采用变量绑定参数,返回带有语句定义的 JDBC `PreparedStatement` 对象。 - -`PreparedStatement` 对象使用 `setXXX` 方法将数据绑定到准备发送到数据库的语句。 - -示例:使用 `PreparedStatement` 执行 `INSERT` 操作将两行数据添加到 `customers` 表中。 - -```unknow -PreparedStatement ps = null; -try{ - ps = conn.prepareStatement ("insert into customers (customerID, name) values (?, ?)"); - - ps.setInt (1, 150); // 第一个? 对应 customerID - ps.setString (2, "Adam"); // 第二个? 对应 name - - ps.execute (); - - ps.setInt (1, 207); - ps.setString (2, "Alice"); - ps.execute (); -} - -finally{ - if(ps!=null) - ps.close(); -} -``` - - - -DDL 操作 ------------------------- - -要执行数据定义语言(DDL)操作,可以创建一个 `Statement` 对象或 `PreparedStatement` 对象。 - -示例:使用 `Statement` 对象在数据库中创建表。 - -```unknow -//创建表 customers 以及 customerID 和 name 列 -String query; -Statement st=null; - -try{ - query="create table customers " + - "(customerID int, " + - "name varchar(50))"; - st = conn.createStatement(); - st.executeUpdate(query); - } -finally{ - //关闭 Statement - st.close(); - } -``` - - - -如果涉及重新执行 DDL 操作,那么在重新执行该语句之前,必须重新进行准备。 - -示例:在重新执行之前准备 DDL 语句。 - -```unknow -// -PreparedStatement ps = null; -PreparedStatement ts = null; -try{ - ps = conn.prepareStatement ("insert into customers(customerID, name) values (?, ?)"); - - // 添加新顾客 Adam,编号150 - ps.setInt (1, 150); // 第一个? 对应 customerID - ps.setString (2, "Adam"); // 第二个? 对应 name - // 插入数据 - ps.execute (); - - ts = conn.prepareStatement("truncate table customers"); - ts.executeUpdate(); - - - // 添加新顾客 Alice,编号 207 - ps.setInt (1, 207); // 第一个? 对应 customerID - ps.setString (2, "Alice"); // 第二个? 对应 name - // 插入数据 - ps.execute (); - - ts.close(); - ts = conn.prepareStatement("truncate table customers"); - ts.executeUpdate(); - } -finally{ - if(ps!=null) - // 关闭 Statement - ps.close(); -} -``` - - - diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/2.jdbc-basic-operation/8.submit-changes.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/2.jdbc-basic-operation/8.submit-changes.md deleted file mode 100644 index 488876ca6..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/2.jdbc-basic-operation/8.submit-changes.md +++ /dev/null @@ -1,44 +0,0 @@ -提交变更 -========================= - -DML 操作在运行时会默认自动提交,称为自动提交模式。 - -也可以通过在 `Connection` 对象上调用以下方法来禁用自动提交模式: - -```unknow -conn.setAutoCommit(false); -``` - - - -如果禁用了自动提交模式,则必须调用 `Connection` 对象上相应的方法来手动提交或回滚更改,如下所示: - -```unknow -conn.commit(); -``` - - - -或者使用如下命令: - -```unknow -conn.rollback(); -``` - - - -`COMMIT` 或 `ROLLBACK` 操作会影响自上一次 `COMMIT` 或 `ROLLBACK` 之后运行的所有 DML 语句。 -**说明** - - - -* 如果禁用了自动提交模式,并且在没有显式提交或回滚最后更改的情况下关闭了连接,则将运行隐式 `COMMIT` 操作。 - - - -* 任何 DDL 操作始终会引发隐式 `COMMIT`。如果禁用了自动提交模式,则此 `COMMIT` 将隐式提交尚未显式提交或回滚的 DML 操作。 - - - - - diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/2.jdbc-basic-operation/9.close-connection-to-database.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/2.jdbc-basic-operation/9.close-connection-to-database.md deleted file mode 100644 index df13ae640..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/2.jdbc-basic-operation/9.close-connection-to-database.md +++ /dev/null @@ -1,20 +0,0 @@ -关闭与数据库的连接 -============================== - -所有操作执行完成后,必须关闭与数据库的连接。 - -可以使用 `Connection` 对象的 `close` 方法关闭连接,如下所示: - -```unknow -conn.close(); -``` - - - - -**说明** - - - -通常应将 `close` 语句放在 `finally` 子句中。 - diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/3.handle-sql-exceptions.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/3.handle-sql-exceptions.md deleted file mode 100644 index 57d0dbeb2..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/3.handle-sql-exceptions.md +++ /dev/null @@ -1,68 +0,0 @@ -处理 SQL 异常 -============================== - -OceanBase JDBC 驱动程序通过引发 SQL 异常,生成 java.sql.SQLException 类或其子类的实例,来处理异常情况。 - -异常可能源自 JDBC 驱动程序,也可能源自数据库本身。结果信息会描述该异常并识别引发该异常的方法,还可以附加其他运行信息。 - -`SQLException` 类支持的基本异常处理包括检索错误消息、检索错误代码、检索 SQL 状态以及打印堆栈跟踪。 - -检索错误信息 ------------------------- - -`SQLException` 类检索基本错误信息的方法如下: - -* `getMessage` - - - -* `getErrorCode` - - - -* `getSQLState` - - - - - - -示例:调用 `getMessage` 方法进行输出显示。 - -```unknow -catch(SQLException ecp) -{ - System.out.println("exception: " + ecp.getMessage()); -} -//输出源自 JDBC 驱动程序的错误 -exception: Invalid column type -``` - - - -打印堆栈跟踪 ------------------------- - -`SQLException` 类提供的 `printStackTrace()` 方法可以用于打印堆栈跟踪。此方法将可抛出对象的堆栈跟踪信息依照标准错误流进行打印。您还可以指定一个 `java.io.PrintStream` 对象或 `java.io.PrintWriter` 对象进行输出。 - -示例:捕获 SQL 异常并打印堆栈跟踪。 - -```unknow -// SQL 代码示例:遍历结果并打印员工姓名 -try { - while (rs.next ()) - System.out.println (rs.getString (5)); // 假设使用了不正确的列索引 -} -catch(SQLException ecp) { ecp.printStackTrace (); } - -//捕获 SQL 异常并打印堆栈跟踪 -try { } -catch(SQLException ecp) { ecp.printStackTrace (); } - -//运行程序产生以下错误文本 -java.sql.SQLException: Invalid column index -at OceanBase.jdbc.driver.OceanBaseResultSetImpl.getDate(OceanBaseResultSetImpl.java:1556) -at emp.main(emp.java:41) -``` - - diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/4.java-data-stream/1.java-data-flow-overview.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/4.java-data-stream/1.java-data-flow-overview.md deleted file mode 100644 index 84557544d..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/4.java-data-stream/1.java-data-flow-overview.md +++ /dev/null @@ -1,36 +0,0 @@ -Java 数据流概述 -=============================== - -OceanBase JDBC 驱动程序支持在服务器和客户端之间进行双向数据流操作。 - -驱动程序目前支持以下数据流转换: - -* 二进制位 - - 用于 `RAW` 字节数据,对应于 `getBinaryStream` 方法。 - - - - - - - -* ASCII 码 - - 用于 ISO-Latin-1 编码中的 ASCII 字节,对应于 `getAsciiStream` 方法。 - - - - - - - -* Unicode - - 用于具有 UTF-16 编码的 Unicode 字节,对应于 `getUnicodeStream` 方法。 - - - - - -`getBinaryStream`、`getAsciiStream` 和 `getUnicodeStream` 方法返回 `InputStream` 对象中的数据字节。 diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/4.java-data-stream/2.long-and-long-raw-data-types.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/4.java-data-stream/2.long-and-long-raw-data-types.md deleted file mode 100644 index da5c85f17..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/4.java-data-stream/2.long-and-long-raw-data-types.md +++ /dev/null @@ -1,149 +0,0 @@ -LONG 和 LONG RAW 数据类型 -========================================= - -当查询选择一个或多个 LONG 或 LONG RAW 列时,JDBC 驱动程序将这些列以流模式传输到客户端。 - -在流模式下,JDBC 驱动程序一般不会从网络读取 `LONG` 或 `LONG RAW `列的数据。在使用代码调用 `getXXX` 方法读取列数据之前,列数据将保留在网络通信通道中。除了读取列数据外,任何连接使用都会将列数据从通道中丢弃。虽然流模式可以有效利用内存并最大程度地减少往返通信,但它会干扰其他数据库操作。 - -要访问 `LONG` 列中的数据,您可以将该列作为 `Java InputStream` 对象,并使用 `InputStream` 对象的 `read` 方法获取。也可以将数据作为 `String` 或 `byte` 数组,通过执行流传输获取。 - -三种流类型都可以获取 `LONG` 和 `LONG RAW` 数据。驱动程序将根据数据库和驱动程序的字符集进行执行转换。 -**注意** - - - -不要创建带有 `LONG` 列的表。可以改用大对象(`LOB`)列、`CLOB`、`NCLOB` 和 `BLOB`。因为 `LOB` 列的使用限制远少于 `LONG` 列,所以建议将现有的 `LONG` 列转换为 `LOB` 列。 - -LONG RAW 数据转换 -------------------------------- - -调用 `getBinaryStream` 返回 `RAW` 数据。调用 `getAsciiStream` 会将 `RAW` 数据转换为十六进制并返回相应的 ASCII。调用` getUnicodeStream` 会将 `RAW` 数据转换为十六进制并返回 Unicode 字符。 - -LONG 数据转换 ---------------------------- - -使用 `getAsciiStream` 获取 `LONG` 数据时,驱动程序会假定数据库中的基础数据使用 `US7ASCII` 或 `WE8ISO8859P1` 字符集。如果假设为真,则驱动程序将返回与 ASCII 字符相对应的字节。如果数据库未使用 `US7ASCII` 或 `WE8ISO8859P1` 字符集,则调用 `getAsciiStream` 将返回无意义的信息。 - -使用 `getUnicodeStream` 获取 `LONG` 数据时,将获得 UTF-16 编码的 Unicode 字符流。 - -使用 `getBinaryStream` 获取 `LONG` 数据时,如果数据库字符集不是 `US7ASCII` 或 `WE8ISO8859P1`,则调用 `getBinaryStream` 将返回 UTF-8。如果服务器端字符集是 `US7ASCII` 或 `WE8ISO8859P1`,则调用将返回 `US7ASCII` 字节流。 -**注意** - - - -将 `LONG` 或 `LONG RAW` 列作为流进行接收时,需要特别注意在数据库中检索的列的顺序。 - -`LONG` 和 `LONG RAW` 数据转换的详细信息如下表所示。 - - -| **数据类型** | **BinaryStream** | **AsciiStream** | **UnicodeStream** | -|----------|---------------------------------------------------------------------------------------------------------|-----------------------------------------|----------------------------| -| LONG | 字节表示 Unicode UTF-8 中的字符。如果数据库字符集为 `US7ASCII` 或 `WE8ISO8859P1`,则这些字节表示 `US7ASCII` 或 `WE8ISO8859P1` 中的字符。 | 字节表示 ISO-Latin-1(`WE8ISO8859P1`)编码中的字符。 | 字节代表 Unicode UTF-16 编码的字符。 | -| LONG RAW | 数据不变数据。 | 十六进制字节的 ASCII 表示形式。 | 十六进制字节的 Unicode 表示形式。 | - - - -示例 --------------------- - -`getXXXStream` 方法的功能之一是能够以增量方式获取数据,而 `getBytes` 在一次调用中就获取所有数据。以下是获取二进制数据流的示例。 - -**示例 1:使用 getBinaryStream 方法获取 LONG RAW 数据** - -```unknow ---创建了一个表stream01,存储与名称 SAMPLE 相关的LONG RAW 数据列 -CREATE TABLE stream01 (name VARCHAR2 (50), giftype LONG RAW); -INSERT INTO stream01 VALUES ('SAMPLE', '1234567890123'); - ---将 LONG RAW 列中的数据写入名为 sample.gif 的文件中 -ResultSet rs = st.executeQuery - ("select giftype from stream01 where NAME='SAMPLE'"); - -// 获取第一行 -if (rs.next()) -{ - // 以流形式获取 GIF 数据 - InputStream gif_type = rs.getBinaryStream (1); - try - { - FileOutputStream file = null; - file = new FileOutputStream ("sample.gif"); - int chunk; - while ((chunk = gif_type.read()) != -1) - file.write(chunk); - } - catch (Exception e) - { - String err = e.toString(); - System.out.println(err); - } - finally - { - if file != null() - file.close(); - } -} -``` - - - -上述示例中,调用 `getBinaryStream` 返回的 `InputStream` 对象直接从数据库连接中读取数据。 - -**示例 2:使用 getBytes 方法获取 LONG RAW 数据** - -本示例使用 `getBytes` 获取 `giftype` 列的内容,驱动程序将在一次调用中获取所有数据,并将其存储在字节数组中。 - -```unknow -ResultSet rs2 = st.executeQuery - ("select giftype from streame01 where NAME='SAMPLE'"); - -// 获取第一行 -if (rs2.next()) -{ - // 以流形式获取 GIF 数据 - byte[] bytes = rs2.getBytes(1); - try - { - FileOutputStream file = null; - file = new FileOutputStream ("sample2.gif"); - file.write(bytes); - } - catch (Exception e) - { - String err = e.toString(); - System.out.println(err); - } - finally - { - if file != null() - file.close(); - } -} -``` - - - -因为 `LONG RAW` 列最多可以包含 2 GB 的数据,所以与 `getBinaryStream` 示例相比,`getBytes` 示例可以使用更多的内存。如果不知道 `LONG` 或 `LONG RAW` 列中数据的最大大小,请使用流。 -**说明** - - - -* JDBC 驱动程序可以自动流传输任何 `LONG` 和 `LONG RAW` 列。但在某些情况下,您可能希望避免数据流传输。例如,当 `LONG` 列很小时,这种情况可能就要避免递增式返回数据,而是采用一次调用就返回数据。 - - - -* 为避免流传输,请使用 `defineColumnType` 方法重新定义 `LONG` 列的类型。例如,可以将 `LONG` 或 `LONG RAW` 列重新定义为 `VARCHAR` 或 `VARBINARY` 类型,则驱动程序将不会自动流传输数据。 - - - - - - - - -* 如果使用 `defineColumnType` 重新定义列类型,则必须在查询中声明列的类型。否则,`executeQuery` 将执行失败。另外,必须将 `Statement` 对象转换为 `oceanbase.jdbc.oceanbaseStatement`。 - - - - - diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/4.java-data-stream/3.lob-data-type.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/4.java-data-stream/3.lob-data-type.md deleted file mode 100644 index d9757a6b4..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/4.java-data-stream/3.lob-data-type.md +++ /dev/null @@ -1,25 +0,0 @@ -LOB 数据类型 -============================= - -大对象(LOB)是指太大而无法直接存储在数据库表中的数据项。解决方法是可以在数据库表中存储一个定位器,该定位器指向实际数据的位置。 - -JDBC 驱动程序可以通过使用流来支持以下类型: - -* 二进制大对象(`BLOB`)对应非结构化二进制数据 - - - -* 字符大对象(`CLOB`)对应字符数据 - - - -* 国家字符大对象(`NCLOB`)对应国家字符数据 - - - - - - -`LOB` 的行为与本章描述的其他类型的流数据不同。`LOB` 不是将实际数据存储在表中,而是存储于定位器,可以使用此定位器来操纵实际数据,包括以流的形式读取和写入数据。即使在流传输时,也只在网络中移动必要的数据。相反,在流传输 `LONG` 或者 `LONG RAW` 数据时,要在网络中移动所有的数据。 - -当查询获取一个或多个`BLOB`、`CLOB` 或 `NCLOB` 列时,JDBC 驱动程序会将数据传输到客户端,从而可以访问此数据流。 diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/5.use-lob/1.lob-data-types.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/5.use-lob/1.lob-data-types.md deleted file mode 100644 index 89eeff3e7..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/5.use-lob/1.lob-data-types.md +++ /dev/null @@ -1,38 +0,0 @@ -LOB 数据类型简介 -=============================== - -OceanBase 数据库支持三种 LOB 数据类型。 - -三种 `LOB` 数据类型如下: - -* 二进制大对象(`BLOB`) - - 此数据类型用于非结构化二进制数据。 - - - - - - - -* 字符大对象(`CLOB`) - - 此数据类型用于字符数据。 - - - - - - - -* 国家字符大对象(`NCLOB`) - - 此数据类型用于国家字符数据。 - - - - - -`BLOB`、`CLOB` 和 `NCLOB` 永久存储在数据库表空间中,并且对这些数据类型执行的所有操作都在事务控制下。 - -PL 语言支持 `LOB` 数据类型,并且 JDBC 接口允许将 `IN` 参数传递给 PL 存储过程或函数,以及允许检索 `OUT` 参数或返回值。 diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/5.use-lob/2.lob-data-interface.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/5.use-lob/2.lob-data-interface.md deleted file mode 100644 index 72e3bb615..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/5.use-lob/2.lob-data-interface.md +++ /dev/null @@ -1,160 +0,0 @@ -LOB 数据接口 -============================= - -OceanBase JDBC 驱动程序提供了用于写入和读取整个 LOB 内容的简化机制,称为数据接口。 - -数据接口使用标准的 JDBC 方法(如 `getString` 和 `setBytes`)读取和写入 `LOB` 数据。使用数据接口更易于编码且速度更快, 但与标准 `java.sql.Blob`、`java.sql.Clob` 和 `java.sql.NClob` 接口不同,它不提供随机访问功能,并且访问数据量不能超出 2147483648 个元素。 - -Input ------------------------ - -OceanBase JDBC 驱动程序扩展了 `PreparedStatement` 的 `setBytes`、`setBinaryStream`、`setString`、`setCharacterStream` 和 `setAsciiStream` 方法,以增强使用 `BLOB`、`CLOB` 和 `NCLOB` 的能力。 - -对于服务器端内部驱动程序,当前对 SQL 语句(如 `INSERT` 语句)的操作限制为 4000 字节。此限制不适用于 PL 语句。`INSERT` 语句通过包裹在 PL 块中来解决这一限制,方法如下: - -```unknow -BEGIN - INSERT id, name INTO clob_emp VALUES(?,?); -END -``` - - - -对于大型数据共有三种输入模式,如下所示: - -* 直接绑定 - - 此绑定方式的大小受到限制,但效率最高。它将所有输入列的数据内联在的数据块中,再发送到服务器。所有数据(包括批处理的多次执行)都在单个网络操作中发送。 - - - - - - - -* 流绑定 - - 此绑定将数据放在末尾。它将批量大小限制为一个,因而可能需要多次往返才能完成。 - - - - - - - -* `LOB` 绑定 - - 此绑定创建一个临时 `LOB`,将数据复制到 `LOB`,并绑定 `LOB` 定位器。临时 `LOB` 在执行后自动释放。创建临时 `LOB` 然后写入 `LOB` 的操作需要多次往返。定位器的输入可以是成批的。 - - - - - -对于 SQL 语句,输入模式的使用注意事项如下: - -* `setBytes` 和 `setBinaryStream` 方法对小于 4001 字节的数据使用直接绑定。 - - - -* `setBytes` 和 `setBinaryStream` 方法对大于 4000 字节的数据使用流绑定。 - - - -* `setAsciiStream`、`setBinaryStream` 和 `setCharacterStream` 方法将长参数作为表单长度,使用长度大于 2147483648 的 `LOB` 绑定。未指定长度的表单始终使用 `LOB` 绑定。 - - - -* `setString`、`setCharacterStream` 和 `setAsciiStream` 方法对小于 32767 个字符的数据使用直接绑定。 - - - -* `setString`、`setCharacterStream` 和 `setAsciiStream` 方法对大于 32766 个字符的数据使用流绑定。 - - - -* `setCharacterStream` 方法的新形式需要使用 `long` 参数的中作为长度,对大于 2147483647 的长度使用 `LOB` 绑定。未指定长度的表单始终使用 `LOB` 绑定。 - - - - - - -对于 PL 语句,输入模式的使用注意事项如下: - -* `setBytes` 和 `setBinary` 流式方法对小于 32767 字节的数据使用直接绑定。 - - - -* `setBytes` 和 `setBinaryStream` 方法对大于 32766 字节的数据使用 `LOB` 绑定。 - - - -* `setString`、`setCharacterStream` 和 `setAsciiStream` 方法对数据库字符集中小于 32767 字节的数据使用直接绑定。 - - **说明** - - - - BLOB 无法使用 `setString` 来设置。 - - -* `setString`、`setCharacterStream` 和 `setAsciiStream` 方法对数据库字符集中大于 32766 字节的数据使用 `LOB` 绑定。 - - - - - - -自动切换输入模式会影响某些程序。自动切换也可能导致附加的服务器端解析,以适应参数类型的更改。如果重复执行语句时,数据大小在阈值上下不断变化,则将导致性能影响。切换到流模式也会影响批处理。 - -Output ------------------------- - -`ResultSet` 和 `CallableStatement` 的 `getBytes`、`getBinaryStream`、`getString`、`getCharacterStream` 和 `getAsciiStream` 方法已扩展为可与 `BLOB`、`CLOB` 或 `OUT` 参数一起使用。 这些方法适用于长度小于 2147483648 的任何 `LOB`。 -**说明** - - - -`getString` 和 `getNString` 方法不能用于检索 `BLOB` 列值。 - -数据接口通过访问驱动程序中的 `LOB` 定位器进行操作,并且对应用程序编程是透明的。可以根据需要使用 `LOB` 预取来减少或消除的其他数据库往返行程。 - -可以使用与 `LONG RAW` 和 `LONG` 数据相同的流式传输机制来读取和写入 `BLOB` 或 `CLOB` 数据。可以在列上使用 `defineColumnType(nn,Types.LONGVARBINARY)` 或 `defineColumnType(nn,Types.LONGVARCH` 方法来读取数据,产生直接流,就好像是读取 `LONG RAW` 或 `LONG` 列的数据一样。 - -CallableSatement 和 IN OUT 参数 ----------------------------------------------- - -PL 要求用作 `IN OUT` 参数输入和输出的 Java 类型必须相同。 - -对于存储过程的 `IN OUT CLOB` 参数,希望使用 `setString` 方法设置该参数的值。对于任何 `IN` 和 `OUT` 参数,必须对相同的类型进行绑定。如果无法确定数据大小,则自动切换输入模式会引发错误。例如,如果知道输入数据和输出数据都不会大于 32766 字节,则可以对输入参数使用 `setString` 方法,并将 `OUT` 参数注册为 `Types.VARCHAR`,对输出参数使用 `getString` 方法。 - -更好的解决方案是将存储过程更改为具有单独的 `IN` 和 `OUT` 参数。 如下例所示: - -```unknow -CREATE PROCEDURE clob_obproc( cc IN OUT CLOB ); -``` - - - -更改为如下示例: - -```unknow -CREATE PROCEDURE clob_obproc( cc_in IN CLOB, cc_out OUT CLOB ); -``` - - - -另一个解决方法是使用容器块进行调用。`clob_plproc` 存储过程可以用 Java 字符串包装,以用于 `prepareCall` 语句,如下所示: - -```unknow -"DECLARE cc_temp; BEGIN cc_temp := ?; clob_plproc( cc_temp); ? := cc_temp; END;" -``` - - - -无论哪种情况,都可以在第一个参数上使用 `setString` 方法,在第二个参数上使用 `registerOutParameter` 方法和 `Types.CLOB`。 - -大小限制 ----------------------- - -如果创建非常大的 `byte` 数组或 String 可能会对 Java 内存管理系统的性能产生影响。阅读 Java 虚拟机(JVM)供应商提供的有关大量数据元素影响内存管理的相关信息,并考虑改用流接口。 diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/5.use-lob/3.lob-locator-apis.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/5.use-lob/3.lob-locator-apis.md deleted file mode 100644 index 969e97ee5..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/5.use-lob/3.lob-locator-apis.md +++ /dev/null @@ -1,12 +0,0 @@ -LOB Locator 接口 -=================================== - -定位符是小型数据结构,包含用于访问 LOB 实际数据的信息。 - -在数据库的表中,定位符直接存储在表中,而数据可以存储在表中或单独存储。通常将单独的表空间用于大型 `LOB`。 - -OceanBase JDBC 驱动程序在获取 LOB Locator 后可以对 LOB 对象进行 `UPDATE TRUNCATE` 和 `READ` 操作。通过配置 URL Option 来开启或关闭 LOB Locator,配置项 `supportLobLocator` 默认开启。 - -**LOB 预取** - -OceanBase JDBC 驱动程序通过在常规提取操作期间预提取元数据(例如 `LOB` 长度和块大小以及 `LOB` 数据的开头以及定位符)来减少往返次数。如果在结果集中选择 `LOB` 列,则在获取定位符时,服务器和 JDBC 驱动程序支持将部分或全部数据预取到客户端。之后读取 API 调用从预取缓冲区获取数据,而无需进行数据库往返。 diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/5.use-lob/4.char-varchar-and-raw-data-types.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/5.use-lob/4.char-varchar-and-raw-data-types.md deleted file mode 100644 index 75c627f74..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/5.use-lob/4.char-varchar-and-raw-data-types.md +++ /dev/null @@ -1,6 +0,0 @@ -CHAR、VARCHAR 和 RAW 数据类型 -============================================ - -如果尝试在不重新定义列类型的情况下将 CHAR、VARCHAR 或 RAW 列获取为数据流,则 JDBC 驱动程序将返回 Java InputStream,但不会发生真正的流传输。 - -对于这些数据类型,JDBC 驱动程序在调用 `executeQuery` 方法或 `next` 方法时会将数据完全提取到内存缓冲区中,`getXXXStream` 的入口点将返回从此缓冲区读取数据的流。 diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/6.use-callablestatements-to-call-stored-procedure.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/6.use-callablestatements-to-call-stored-procedure.md deleted file mode 100644 index f043df449..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/6.use-callablestatements-to-call-stored-procedure.md +++ /dev/null @@ -1,110 +0,0 @@ -使用 CallableStatements 调用存储过程 -================================================= - -JDBC 的 `CallableStatement` 接口支持调用存储过程。 - -`CallableStatement` 支持使用 `executeUpdate()`,`executeQuery()` 或 `execute()` 方法调用 Statement 执行存储过程。其中最灵活的调用方法是 `execute()`,因为您无需提前知道存储过程是否返回结果集。 - -如下为一个存储过程示例,该存储过程返回以 1 递增的 `inOutParam` 值,以及使用 `inputParam` 作为 `ResultSet` 来输入字符串。 - -```unknow -CREATE PROCEDURE obSp(IN inputParam VARCHAR(100), - INOUT inOutParam INT) -BEGIN - DECLARE n INT; - SET n = inOutParam + 1; - SET inOutParam = n; - - SELECT inputParam; - - SELECT CONCAT('zhang', inputParam); -END -``` - - - -根据如下步骤调用上述示例中的 `obSp` 存储过程: - -1. 通过使用 `Connection.prepareCall()` 准备可调用语句。 - - 示例如下: - - ```unknow - import java.sql.CallableStatement; - - ... - - - - CallableStatement cSt = conn.prepareCall("{call obSp(?, ?)}"); - - - cSt.setString(1, "asdfg"); - ``` - - - -2. 注册输出参数(如果存在) - - 为了检索输出参数的值(在创建存储过程时指定为 OUT 或 INOUT 的参数),JDBC 要求在执行语句之前使用 `CallableStatement` 接口中的 `registerOutputParameter()` 方法指定输出参数的值。示例如下: - - ```unknow - import java.sql.Types; - ... - cSt.registerOutParameter(2, Types.INTEGER); - - cSt.registerOutParameter("inOutParam", Types.INTEGER); - ... - ``` - - - -3. 设置输入参数(如果存在)。 - - 输入和输入/输出参数的设置与 PreparedStatement 对象相同。但是,`CallableStatement` 也支持按名称设置参数。示例如下: - - ```unknow - cSt.setString(1, "asdfg"); - - cSt.setString("inputParam", "asdfg"); - - - cSt.setInt(2, 1); - - cSt.setInt("inOutParam", 1); - - ... - ``` - - - -4. 执行 `CallableStatement`,并检索任何结果集或输出参数。 - - 示例如下: - - ```unknow - ... - - boolean obResults = cSt.execute(); - - while (obResults) { - ResultSet rs = cSt.getResultSet(); - - - ... - - obResults = cSt.getMoreResults(); - } - - int outputValue = cSt.getInt(2); - - outputValue = cSt.getInt("inOutParam"); - - ... - ``` - - - - - - diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/7.data-source-and-url/1.data-sources.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/7.data-source-and-url/1.data-sources.md deleted file mode 100644 index 982764217..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/7.data-source-and-url/1.data-sources.md +++ /dev/null @@ -1,14 +0,0 @@ -数据源概述 -========================== - -数据源是标准的通用对象,用于指定要使用的数据库或其他资源,通过连接 JDBC 数据源可以将应用程序连接到数据库。 - -OceanBase JDBC 扩展应用程序编程接口(API)引入了数据源的概念。为了方便和可移植性,可以将数据源绑定到 Java 命名和目录接口(JNDI)实体,以便可以通过逻辑名访问数据库。 - -数据源功能完全替代了以前的 JDBC `DriverManager` 功能。您可以在同一应用程序中使用这两种功能,但是建议将应用程序转换为数据源。 - -数据源支持 JNDI,JNDI 标准为应用程序提供了一种查找和访问远程服务和资源的方式,而且这些服务可以是任何企业服务。但是,对于 JDBC 应用程序,只包括数据库连接和服务。 - -JNDI 允许应用程序在访问这些服务时使用逻辑名,即可以从应用程序代码中删除供应商的特定语法。JNDI 具有将逻辑名称与所需服务的指定来源相关联的功能。 - -所有 OceanBase JDBC 数据源都是 JNDI 引用的。开发人员不需要使用此功能,但是通过 JNDI 逻辑名称访问数据库可使代码更加具有可移植性。 diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/7.data-source-and-url/2.properties-and-properties-of-data-sources.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/7.data-source-and-url/2.properties-and-properties-of-data-sources.md deleted file mode 100644 index a4df2a829..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/7.data-source-and-url/2.properties-and-properties-of-data-sources.md +++ /dev/null @@ -1,73 +0,0 @@ -数据源的特性和属性 -============================== - -通过将数据源功能与 JNDI 结合使用,就不需要注册供应商指定的 JDBC 驱动程序类名称,还可以将逻辑名称用于 URL 和其他属性,这样确保了用于打开数据库连接的代码可以移植到其他环境。 - - - -DataSource 接口 -------------------------------- - -JDBC 数据源是实现标准 `javax.sql.DataSource` 接口类的实例,如下所示: - -```unknow -public interface DataSource -{ - Connection getConnection() throws SQLException; - Connection getConnection(String username, String password) - throws SQLException; - ... -} -``` - - - -OceanBase 数据库使用 `ocanbase.jdbc.pool` 软件包中的 `OceanBaseDataSource` 类实现此接口,通过 `getConnection` 方法重载返回到数据库的连接。 - -要使用其他值,可以使用适当的 `Setter` 方法设置对应属性。对于备用用户名和密码,还可以将这些参数作输入到 `getConnection` 方法,这优先于属性设置。 - -DataSource 属性 -------------------------------- - -与实现 `DataSource` 接口的类一样,`OceanBaseDataSource` 类提供了一组属性,可用于指定要连接的数据库。这些属性遵循 JavaBeans 设计模式。 - -`OceanBaseDataSource` 依据 Sun Microsystems 规范的标准属性,如下表所示。 - - -| **名称** | **类型** | **描述** | -|-----------------|--------|---------------------------------------------------| -| databaseName | String | 服务器上指定数据库的名称。 | -| dataSourceName | String | 基础数据源类的名称。对于连接池,这是基础池连接数据源类。对于分布式事务,这是基础 XA 数据源类。 | -| description | String | 对数据源的描述。 | -| networkProtocol | String | 与服务器通信的网络协议。 | -| password | String | 连接用户的密码。 | -| portNumber | int | 服务器侦听请求的端口号。 | -| serverName | String | 数据库服务器名称。 | -| user | String | 登录名。 | - - - -`OceanBaseDataSource` 扩展的数据源属性如下表所示。 - - -| **名称** | **类型** | **描述** | -|-------------------------------|----------------------|----------------------------------------------------------------------------------------------------------------------------| -| | | | -| connectionCacheName | String | 指定缓存的名称。创建缓存后无法更改。 | -| connection­Cache­Properties | java.util.Properties | 指定隐式连接缓存的属性。 | -| connectionCachingEnabled | Boolean | 指定是否使用隐式连接缓存。 | -| connectionProperties | java.util.Properties | 指定连接属性。 | -| driverType | String | 指定 JDBC 驱动程序类型。 | -| fastConnectionFailoverEnabled | Boolean | 指定是否正在使用快速连接故障转移。 | -| implicitCachingEnabled | Boolean | 指定是否启用隐式语句连接缓存。 | -| loginTimeout | int | 指定此数据源在尝试连接到数据库时将等待的最长时间(以秒为单位)。 | -| logWriter | java.io.PrintWriter | 指定此数据源的日志编写器。 | -| maxStatements | int | 指定应用程序缓存中的最大语句数。 | -| serviceName | String | 指定此数据源的数据库服务名称。 | -| tnsEntry | String | 指定 TNS 条目名称。TNS 条目名称对应于 `tnsnames.ora` 配置文件中指定的 TNS 条目。 | -| url | String | 指定数据库连接字符串的 URL。可以使用此属性代替 `tnsEntry` 和 `driverType` 属性以及标准 `portNumber`、`networkProtocol`、`serverName` 和 `databaseName`属性。 | -| ONSConfiguration | String | 指定用于远程订阅 FAN/ONS 事件的 ONS 配置字符串。 | - - - -使用 `setConnectionProperties` 方法设置连接的属性,并使用 `setConnectionCacheProperties` 方法设置连接缓存的属性。另外,只有在对数据源启用了缓存之后才设置了数据源的 `ConnectionCacheName` 属性,`getConnectionCacheName()` 才会返回缓存的名称。 diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/7.data-source-and-url/3.create-and-connect-to-a-data-source-instance.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/7.data-source-and-url/3.create-and-connect-to-a-data-source-instance.md deleted file mode 100644 index 09a100a8a..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/7.data-source-and-url/3.create-and-connect-to-a-data-source-instance.md +++ /dev/null @@ -1,95 +0,0 @@ -创建数据源实例并连接 -=============================== - -本节主要介绍如何创建最基本的使用数据源连接到数据库的示例,并且需要使用供应商指定的的硬编码属性设置。 - -创建一个 `OceanBaseDataSource` 实例,对其连接属性进行初始化,然后获取一个连接实例,如下例所示: - -```unknow -OceanBaseDataSource obds = new OceanBaseDataSource(); -obds.setDriverType("oceanbase-client"); -obds.setServerName("dlsun111"); -obds.setNetworkProtocol("tcp"); -obds.setDatabaseName("312"); -obds.setPortNumber(1522); -obds.setUser("adam"); -obds.setPassword("apple"); -Connection conn = obds.getConnection(); -``` - - - -或者可以选择覆盖用户名和密码,如下例所示: - -```unknow -Connection conn = obds.getConnection("alice", "orange"); -``` - - - -在使用数据源连接到数据库时支持使用 JNDI 功能。但仅在将数据源实例绑定到 JNDI 逻辑名称的代码中才需要供应商指定的硬编码属性设置。您可以在创建数据源时使用逻辑名来创建可移植代码,从中获取连接实例。 - -创建数据源实例,注册 JNDI 并连接的步骤如下: - -1. 初始化数据源属性 - - 创建一个 `OceanBaseDataSource` 实例,然后根据需要初始化其属性,如下例所示: - - ```unknow - OceanBaseDataSource obds = new OceanBaseDataSource(); - obds.setDriverType("oceanbase-client"); - obds.setServerName("dlsun111"); - obds.setNetworkProtocol("tcp"); - obds.setDatabaseName("312"); - obds.setPortNumber(1522); - obds.setUser("adam"); - obds.setPassword("apple"); - ``` - - - - - - - - -2. 注册数据源 - - 初始化 `OceanBaseDataSource` 实例的连接属性后,就可以向 JNDI 注册该数据源实例,如下例所示: - - ```unknow - Context obctx = new InitialContext(); - obctx.bind("jdbc/sampleobdb", obds); - ``` - - - - 调用 JNDI `InitialContext()` 构造函数将创建一个引用初始 JNDI 命名文本的 Java 对象。系统属性(未显示)指示 JNDI 使用的服务提供商。 - - `obctx.bind` 调用将 `OceanBaseDataSource` 实例绑定到逻辑 JNDI 名称。这意味着在调用 `obctx.bind` 之后,随时可以使用逻辑名 `jdbc/sampleobdb` 并根据 `OceanBaseDataSource` 实例的 `obds` 的属性打开数据库连接。逻辑名称 `jdbc/sampleobdb` 在逻辑上绑定到此数据库。 - - JNDI 命名空间的层次结构类似于文件系统。在此示例中,JNDI 名称在根命名上下文下指定子上下文 `jdbc`,并在 `jdbc` 子上下文内指定逻辑名 `sampleobdb`。 - - Context 接口和 `InitialContext` 类包含于标准 `javax.naming` 包中。 - - - - - - - -3. 打开连接 - - 要执行查找并打开逻辑上绑定到 JNDI 名称的数据库连接,请使用逻辑 JNDI 名称。为此,需要将查找结果(也可以是 Java `Object`)强制转换为 `OceanBaseDataSource`,然后使用相应的 `getConnection` 方法打开连接。 - - 如例所示: - - ```unknow - OceanBaseDataSource obdsconn = (OceanBaseDataSource)obctx.lookup("jdbc/sampleobdb"); - Connection conn = obdsconn.getConnection(); - ``` - - - - - diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/7.data-source-and-url/4.database-url.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/7.data-source-and-url/4.database-url.md deleted file mode 100644 index 1b9ea9e09..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/7.data-source-and-url/4.database-url.md +++ /dev/null @@ -1,166 +0,0 @@ -数据库 URL -============================ - -数据库 URL 是字符串。 - -完整的 URL 语法如下: - -```unknow -jdbc:oceanbase:driver_type:[username/password]@database_specifier -``` - - - -URL 的第一部分 `driver_type` 指定要使用的 JDBC 驱动程序。URL 的其余部分包含一个可选的用户名和密码,由一个斜杠,一个 `@` 和数据库说明符分隔,用于唯一标识应用程序所连接的数据库。 - -本节主要介绍 JDBC 驱动程序可选的 URL 参数。 - -OceanBase JDBC 特有的配置 ------------------------------------------ - - - -| 参数 | 描述 | -|-------------------------|-----------------------------------------------------------| -| supportLobLocator | lOB Locator 开关。 默认值:`true`。 | -| useObChecksum | Checksum 开关,是 OB 2.0 协议的一个配置。 默认值:`true`。 | -| useOceanBaseProtocolV20 | 是否使用 Protocol 2.0。 默认值:`false`。 | -| complexDataCacheSize | ComplexData Cache 的大小。 默认值:50。 | -| cacheComplexData | 是否缓存 ComplexData。 默认值:`true`。 | -| useSqlStringCache | 是否将 SQLString 混存在客户端。 默认值:`false`。 | -| useServerPsStmtChecksum | 是否使用 PS 的 Checksum。 默认值:`true`。 | - - - -基本参数 ----------------------- - - - -| **参数** | **描述** | -|--------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| user | 数据库用户名称。 | -| password | 数据库用户密码。 | -| rewriteBatchedStatements | 对于插入查询,重写 `batchedStatement` 以在单个 `executeQuery` 中执行。 例如` insert into ab (i) values (?)with first batch values = 1, second = 2` 被重写为 `insert into ab (i) values (1), (2)`。 如果无法用"多值"重写查询,则将使用多查询重写 `INSERT INTO TABLE(col1) VALUES (?) ON DUPLICATE KEY UPDATE col2=?` 并附加值\[1,2\] 和 \[2,3\] ,将被重写为 `INSERT INTO TABLE(col1) VALUES (1) ON DUPLICATE KEY UPDATE col2=2;INSERT INTO TABLE(col1) VALUES (3) ON DUPLICATE KEY UPDATE col2=4`。 处于活跃状态时,`useServerPrepStmts` 选项被设置为 `false`。 默认值:`false`。 | -| connectTimeout | 连接超时值,以毫秒为单位,如果没有超时则为零。 默认值:30000。 | -| useServerPrepStmts | 在执行之前,在服务器端准备 PrepareStatement。重复使用相同查询的应用程序具有激活该选项的值,但通常情况是使用直接命令(文本协议)。如果 `rewriteBatchedStatements` 设置为 `true`,则此选项将设置为 `false`。 默认值:`false`。 | -| useBatchMultiSend | 驱动程序可以批量发送查询。 如果设置为 `false`,查询将逐一发送,等待返回结果后再发送下一个。 如果设置为 `true`,则将根据与 `useBatchMultiSendNumber` 选项值(默认为 `100`)批量发送查询,如果超出数据包允许发送的查询数量,则根据 `max_allowed_packet` 服务器变量发送查询,之后再读取结果,从而避免了客户端和服务器不在同一主机上时发生的大量网络延迟。 默认值:`true` | -| allowLocalInfile | 允许从文件加载数据。 默认值:`false`。 | -| useMysqlMetadata | `databaseMetaData.getDatabaseProductName()` 根据服务器类型返回 OceanBase 或 MySQL。 | - - - -TLS 参数 ------------------------- - - - -| **参数** | **描述** | -|--------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| useSSL | 强制连接时是否使用 SSL/TLS。 默认值:`false`。 | -| trustServerCertificate | 使用 SSL/TLS 时,请不要检查服务器的证书。 默认值:`false`。 | -| serverSslCert | 允许以 DER 形式提供服务器的证书或服务器的 CA 证书。该服务器将被添加到 trustStor,这样可以信任自签名证书。 可以使用以下三种方式之一: * serverSslCert=/path/to/cert.pem (full path to certificate) * serverSslCert=classpath:relative/cert.pem (relative to current classpath) * as verbatim DER-encoded certificate string "------BEGIN CERTIFICATE-----" | -| keyStore | 包含客户端私钥存储和关联证书的 keyStore 文件的文件路径(类似于Java 系统属性 `javax.net.ssl.keyStore`,但确保仅使用私钥的条目)。旧别名 `clientCertificateKeyStoreUrl`。 | -| keyStorePassword | 客户端证书 keyStore 的密码(类似于 Java 系统属性 `javax.net.ssl.keyStorePassword`)。旧别名 `clientCertificateKeyStorePassword` | -| keyPassword | 客户端证书 keyStore 中私钥的密码。(仅当私钥密码与 keyStore 密码不同时才需要)。 | -| trustStore | trustStore 文件的文件路径(类似于 Java 系统属性 `javax.net.ssl.trustStore`,旧别名 `trustCertificateKeyStoreUrl`)将指定的文件用于受信任的根证书。设置后,将覆盖 `serverSslCert`。 | -| trustStorePassword | 受信任的根证书文件的密码(类似于 Java 系统属性 `javax.net.ssl.trustStorePassword`,旧别名 `trustCertificateKeyStorePassword`)。 | -| enabledSslProtocolSuites | 强制将 TLS/SSL 协议强制为一组特定的 TLS 版本(以逗号分隔的列表)。示例:"TLSv1,TLSv1.1,TLSv1.2"(也可以使用别名 `enabledSSLProtocolSuites`)默认值:Java 默认值。 | -| enabledSslCipherSuites | 强制使用 TLS/SSL 密码(以逗号分隔的列表)。 示例:" TLS_DHE_RSA_WITH_AES_256_GCM_SHA384,TLS_DHE_DSS_WITH_AES_256_GCM_SHA384"。 默认值:使用 JRE 密码。 | -| disableSslHostnameVerification | 使用 SSL 时,驱动程序将对照服务器证书中显示的服务器身份检查主机名(检查备用名称或证书 CN),以防止中间人攻击。 此选项允许停用此验证。当`trustServerCertificate` 选项设置为 `default` 时,将禁用主机名验证。 | -| keyStoreType | 指明密钥存储类型(JKS/PKCS12)。 默认值为 `null`,表示使用 Java 默认类型。 | -| trustStoreType | 指明信任库类型(JKS/PKCS12)。 默认值为`null`,表示使用 Java 默认类型。 | - - - -连接池参数 ------------------------ - - - -| **参数** | **描述** | -|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| pool | 使用连接池。仅当不使用 DataSource 对象而仅使用连接对象时,此选项才有用。 默认值:`false`。 | -| poolName | 允许标识线程的连接池名称。 默认值:自动生成为 `oceanbase-pool- ` | -| maxPoolSize | 连接池应包含的最大物理连接数。 默认值:8。 | -| minPoolSize | 如果由于使用时间不超过 `maxIdleTime` 而删除了连接,则将关闭连接并将其从池中删除。`minPoolSize` 指明连接池应始终保持可用的物理连接数,应小于或等于 `maxPoolSize`。 默认值:`maxPoolSize`。 | -| poolValidMinDelay | 当询问连接时,连接池将验证连接状态。如果最近借用了连接,则 `poolValidMinDelay` 允许禁用此验证,避免在频繁重复使用连接的情况下进行无用的验证。0 表示每次请求连接时都要进行验证。 默认值:1000(毫秒)。 | -| maxIdleTime | 不使用连接时,连接可以保留在池中的最长时间(以秒为单位)。此值必须始终低于 `@wait_timeout-45s`。 默认值:600 秒(即 10 分钟),最小值为 60 秒。 | -| staticGlobal | 表明不会更改全局变量 `max_allowed_packet`、`wait_timeout`,`autocommit`、`auto_increment_increment`、`time_zone`、`system_time_zoneandtx_isolation` 的值,从而允许连接池更快地创建新连接。 默认值:`false`。 | -| useResetConnection | 当一个连接为 `closed()`(返回给连接池)时,连接池将重置连接状态。设置此选项后,如果服务器允许,则准备命令将被删除,会话变量将被重置,用户变量将被销毁,从而在应用程序大量使用变量时,服务器可以节省内存。不得与 `useServerPrepStmts` 选项一起使用。 默认值:`false`。 | -| registerJmxPool | 注册 JMX 监视池。 默认值:`true`。 | - - - -日志参数 ----------------------- - - - -| **参数** | **描述** | -|-------------------------|-------------------------------------------------| -| log | 启用日志信息。 默认值:`false`。 | -| maxQuerySizeToLog | 日志中仅显示与该选项大小相对应数量的字符。 默认值:1024。 | -| slowQueryThresholdNanos | 记录执行时间超过此值的查询(如果已定义)。 默认值:1024。 | -| profileSql | 日志查询执行时间。 默认值:`false`。 | - - - -不常用的参数 ------------------------- - - - -| **参数** | **描述** | -|-----------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| passwordCharacterEncoding | 指明密码编码字符集。字符集值必须是 Java 字符集。例如:UTF-8。 默认值:`null`(即平台的默认字符集) | -| useFractionalSeconds | 可以处理亚秒精度的时间戳。 默认值:`true`。 | -| allowMultiQueries | 允许多个查询。 例如 `insert into ab (i) values (1); insert into ab (i) values (2)`。 默认值:`false`。 | -| dumpQueriesOnException | 如果设置为 `true`,则在执行查询期间将引发包含查询字符串的异常。 默认值:`false`。 | -| useCompression | 通过 `gzip` 压缩与数据库的交换。当数据库不在同一位置时,可以提供更好的性能。 默认值:`false`。 | -| socketFactory | 要使用自定义 Socket Factory,请将其设置为 `javax.net.SocketFactory` 类的全名。 | -| tcpNoDelay | 在连接 Socket 上设置相应的选项。 | -| tcpKeepAlive | 在连接 Socket 上设置相应的选项。 | -| tcpAbortiveClose | 此选项可用于快速连续创建和关闭连接的环境中。通常,短时间内无法在这种环境中创建 Socket,因为所有本地"临时"端口都被 TCP 连接用尽了,并处于 `TCP_WAIT` 状态。使用 `tcpAbortiveClose` 通过重置 TCP 连接(主动关闭或硬关闭)而不是有序关闭来解决此问题。使用 `socket.setSoLinger(true,0)` 进行异常关闭。 | -| tcpRcvBuf | 设置 TCP 缓冲区(`SO_RCVBUF`)的大小。 | -| tcpSndBuf | 设置 TCP 缓冲区(`SO_SNDBUF`)的大小。 | -| pipe | 在 Windows 上,指定命名管道名称以连接到 `mysqld.exe`。 | -| tinyInt1isBit | 数据类型映射标志,将 MySQL Tiny 作为 BIT(Boolean)处理。 默认值:`true`。 | -| yearIsDateType | 将 Year 作为日期类型处理,而不是数字。 默认值:`true`。 | -| sessionVariables | 在建立成功连接时设置的 ` = ` 对,以逗号分隔 MySQL 会话变量。 | -| localSocket | 如果服务器允许,则可以通过 Unix 域 Socket 连接到数据库。值是 Unix 域 Socket 的路径(即 Socket 数据库参数:`select @@ socket`)。 | -| sharedMemory | 如果服务器允许,则通过共享内存连接到数据库。值是共享内存的基本名称。 | -| localSocketAddress | 将连接套接字绑定到本地(UNIX 域)Socket 的主机名或 IP 地址。 | -| socketTimeout | 定义了网络套接字超时(`SO_TIMEOUT`),以毫秒为单位。值为 0 时将禁用此超时。也可以通过设置系统变量 `max_statement_time` 来限制查询时间。 默认值:0(标准配置)或 10000 ms。 | -| interactiveClient | 会话超时由 `thewait_timeoutserver` 变量定义。将 `interactiveClient` 设置为 `true` 将告诉服务器使用 `interactive_timeoutserver` 变量。 默认值:`false`。 | -| useOldAliasMetadataBehavior | 元数据 `ResultSetMetaData.getTableName()` 返回物理表名称。如果设置了 `useOldAliasMetadataBehavior`,则发送表别名可以激活继承代码。 默认值:`false`。 | -| createDatabaseIfNotExist | 在 URL 中创建指定的数据库(如果不存在)。 默认值:`false`。 | -| serverTimezone | 定义服务器时区。仅在 GRE 服务器实现不同的服务器时区时使用(最好具有相同的服务器时区)。 | -| cachePrepStmts | 如果 `useServerPrepStmts = true`,则将准备好的信息缓存在 LRU 缓存中,以避免重新准备命令。下次使用该命令时,会将准备好的标识符和参数(如果有)发送到服务器,因而可以避免服务器重新解析查询。 默认值:`true`。 | -| prepStmtCacheSize | 如果 `useServerPrepStmts = true`,则使用选项 `cachePrepStmts` 定义准备好的语句缓存大小。 默认值:250。 | -| prepStmtCacheSqlLimit | 如果 `useServerPrepStmts = true`,则大于此阈值的查询将不被缓存。 默认值:2048。 | -| jdbcCompliantTruncation | 截断错误("在行 % 处的列 '%' 的数据被截断","在行 % 处的列 '%' 的值超出范围")将被视为错误而不是警告。 默认值:`true`。 | -| cacheCallableStmts | 启用/禁用调用语句缓存。 默认值:`true`。 | -| callableStmtCacheSize | 如果启用了 `cacheCallableStmts`,则设置驱动程序缓存每个 VM 的可调用语句的数量。 默认值:`true`。 | -| useBatchMultiSendNumber | 当选项 `useBatchMultiSend` 是活跃的,表明在读取结果前可以连续发送的最大查询。 默认值:100。 | -| connectionAttributes | 当 `performance_schema` 处于活跃状态时,允许以键值对格式(例如:connectionAttributes = key1:value1,key2,value2)向服务器发送一些客户端信息。这些信息可以在服务器上的表 `performance_schema.session_connect_attrs` 和 `performance_schema.session_account_connect_attrs `中检索到。 | -| usePipelineAuth | 在连接期间,将执行不同的查询。如果该选项处于活跃状态,则使用管道发送查询(发送所有查询,然后读取所有结果),从而可以更快地创建连接。 默认值:`true`。 | -| enablePacketDebug | 驱动程序将保存最近的 16 个 MySQL 数据交换包(限制为前 1000 个字节)。发生 IOException 时,这些数据包的十六进制值将添加到 `stacktrace` 中。此选项对性能没有影响,但驱动程序将占用 16 KB 以上的内存。 默认值:`false`。 | -| useBulkStmts | 尽可能使用专用的 `COM_STMT_BULK_EXECUTE` 协议进行批量插入。 (不包含 `Statement.RETURN_GENERATED_KEYS` 和流的批处理)。 默认值:`false`。 | -| autocommit | 在连接初始化时设置自动提交的默认值。 默认值:`true`。 | -| galeraAllowedState | 通常,`Connection.isValid` 只是向服务器发送一个空数据包,并且服务器会发送一个小的响应以确保连接性。设置此选项后,连接器将确保 Galera 服务器状态 `wsrep_local_state` 与允许的值相对应(用逗号分隔)。例如" 4,5",推荐为" 4"。 默认值:空。 | -| includeInnodbStatusInDeadlockExceptions | 发生死锁异常时,将 `SHOW ENGINE INNODB STATUS` 结果添加到异常跟踪。 默认值:`false`。 | -| includeThreadDumpInDeadlockExceptions | 发生死锁异常时将线程转储添加到异常跟踪中。 默认值:`false`。 | -| useReadAheadInput | 使用缓冲的 `inputSteam` 读取可用的 Socket 数据。 默认值:`true`。 | -| servicePrincipalName | 使用 GSSAPI 身份验证时,将该值用作服务主体名称(SPN),而不是使用为数据库服务器上的用户帐户定义的名称。 | -| useMysqlMetadata | 强制 `DatabaseMetadata.getDatabaseProductName()` 返回 MySQL 作为数据库,而不是实际的数据库类型。 默认值:`false`。 | -| defaultFetchSize | 驱动程序将在所有新创建的 Statements 上调用 `setFetchSize(n)`。 默认值:0。 | -| blankTableNameMeta | 结果集元数据 `getTableName` 始终返回空白。此选项主要是为了与 ORACLE 数据库兼容。 默认值:`false`。 | -| serverRsaPublicKeyFile | 指明用于 `sha256_password` 和 `caching_sha2_password` 身份验证密码的 RSA 服务器公钥文件的路径。 | -| allowPublicKeyRetrieval | 当未设置 `serverRsaPublicKeyFile` 时,授权客户端检索 RSA 服务器公钥(对于 `sha256_password` 和 `caching_sha2_password` 身份验证密码)。 默认值:`false`。 | -| tlsSocketType | 指明要使用的 TLS `org.oceanbase.jdbc.tls.TlsSocketPlugin` 插件类型。 插件必须存在于`classpath` 中。 | -| credentialType | 指明要使用的凭据插件类型。插件必须存在于 `classpath` 中。 | -| trackSchema | 服务器具有 `CLIENT_SESSION_TRACK` 功能时,允许禁用 `session_track_schema` 设置。 默认值:`true`。 | - - - diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/8.result-set/1.restriction-and-degradation-rules.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/8.result-set/1.restriction-and-degradation-rules.md deleted file mode 100644 index 701353304..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/8.result-set/1.restriction-and-degradation-rules.md +++ /dev/null @@ -1,119 +0,0 @@ -限制和降级规则 -============================ - -某些类型的结果集对于某些查询是不适用的。如果为运行的查询指定了不可用的结果集类型或并发类型,则 JDBC 驱动程序将遵循相应的规则来确定最佳可行类型。 - -实际的结果集类型和并发类型是在运行语句时确定的,如果所需的结果集类型或并发类型不可用,则驱动程序将在语句对象上发出 `SQLWarning`。`SQLWarning` 对象包含该请求类型不可用的原因。检查警告以验证您是否收到了所需的结果集类型。 - -结果集限制 ------------------------ - -对结果集的查询具有以下限制。不遵循这些准则将导致 JDBC 驱动程序选择备用结果集类型或并发类型。 - -生成可更新的结果集的限制: - -* 查询只能从单个表中选择,并且不能包含任何联接操作。另外,为了执行插入操作,查询必须选择所有不可为空的列以及所有没有默认值的列。 - - - -* 查询不能使用 `SELECT *`。 - - 查询必须仅选择表列。不能选择派生的列或聚合,例如一组列的 `SUM` 或 `MAX`。 - - - - - -生成对回滚敏感的结果集的限制: - -* 查询不能使用 `SELECT *`。 - - - -* 查询只能从单个表中选择。 - - - - - - -可回滚和可更新的结果集不能有 `Stream` 列。当服务器必须提取 `Stream` 列时,会将读取大小减为 1,并阻塞 `Stream` 列之后的所有列,直到读取到 `Stream` 列为止。结果为无法批量获取列和滚动浏览。 - -作为 `SELECT *` 限制的一种解决方法,可以使用表别名,如以下示例所示: - -```unknow -SELECT tab.* FROM TABLE tab ... -``` - - - -可以通过一种简单的方法来确定查询是否可能生成回滚敏感或可更新的结果集:如果可以合法地将 `ROWID` 列添加到查询列表中,则该查询可能为对回滚敏感或可更新的结果集。 - -结果集降级规则 -------------------------- - -如果指定的结果集类型或并发类型不可用,那么 OceanBase JDBC 驱动程序将根据以下规则选择备用类型: - -* 如果指定的结果集类型为 `TYPE_SCROLL_SENSITIVE`,而 JDBC 驱动程序无法满足该请求,则驱动程序将尝试降级为 `TYPE_SCROLL_INSENSITIVE`。 - - - -* 如果指定或降级的结果集类型为 `TYPE_SCROLL_INSENSITIVE`,而 JDBC 驱动程序无法满足该请求,则驱动程序将尝试降级为 `TYPE_FORWARD_ONLY`。 - - - -* 如果指定的并发类型为 `CONCUR_UPDATABLE`,而 JDBC 驱动程序无法满足该请求,则 JDBC 驱动程序将尝试降级为 `CONCUR_READ_ONLY`。 - - - - - -**说明** - - - -JDBC 驱动程序对结果集类型和并发类型的任何操作都是相互独立的。 - -运行查询后,可以通过在结果集对象上调用方法来验证 JDBC 驱动程序实际使用的结果集类型和并发类型。 - -* `int getType() throws SQLException` - - 此方法返回用于查询的结果集类型的 `int` 值。`ResultSet.TYPE_FORWARD_ONLY`、`ResultSet.TYPE_SCROLL_SENSITIVE` 或 `ResultSet.TYPE_SCROLL_INSENSITIVE` 是可能的值。 - - - - - - - -* `int getConcurrency() throws SQLException` - - 此方法返回用于查询的并发类型的 `int` 值。`ResultSet.CONCUR_READ_ONLY` 或 `ResultSet.CONCUR_UPDATABLE` 是可能的值。 - - - - - -避免更新冲突 ------------------------- - -以下是有关 JDBC 驱动程序可更新结果集的注意事项: - -* 驱动程序不对可更新结果集强制执行写锁定。 - - - -* 驱动程序不检查与结果集 `DELETE` 或 `UPDATE` 操作的冲突。 - - - - - - -如果您尝试对另一个提交事务的行执行 `DELETE` 或 `UPDATE` 操作,则会发生冲突。 - -OceanBase JDBC 驱动程序使用 `ROWID` 唯一标识数据库表中的一行。只要驱动程序尝试向数据库发送 `UPDATE` 或 `DELETE` 操作时 `ROWID` 是有效的,该操作就会运行。 - -驱动程序将不会报告其他已提交事务所做的任何更改。任何冲突都将被忽略,并且您的更改将覆盖以前的更改。 - -为避免此类冲突,请在运行生成结果集的查询时使用 `FOR UPDATE` 功能。这将避免冲突,但也将阻止同时访问数据。数据项只能同时保留一个写锁。 diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/8.result-set/2.fetch-size.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/8.result-set/2.fetch-size.md deleted file mode 100644 index 665942bc6..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/8.result-set/2.fetch-size.md +++ /dev/null @@ -1,57 +0,0 @@ -Fetch Size -=============================== - -可以使用 Fetch Size 更改行获取值来更改每次访问数据库游标时检索的行数。 - -默认情况下,OceanBase JDBC 运行查询时,默认一次从数据库游标中检索 10 行的结果集。 - -使用标准 JDBC,还可以指定每次查询数据库往返所获取的行数,该数量称为 Fetch Size。在 Oceanbase JDBC 中,行预取值为语句对象中的默认访存大小。设置访存大小会覆盖行预取值设置,并影响该语句对象的后续查询。 - -Fetch Size 也用于结果集中。当语句对象运行查询时,语句对象的 Fetch Size 将传递给查询的结果集对象。但是,您也可以在结果集对象中设置访存大小,以覆盖传递给它的语句访存大小。 -**注意** - - - -生成结果集后,对语句对象的 Fetch Size 所做的更改对该结果集不会产生影响。 - -结果集的 Fetch Size,无论是显式设置的,还是默认等于传递给它的语句 Fetch Size,都可以确定后续对该结果集进行数据库访问时检索到的行数。这包括完成原始查询仍然需要的所有行程,以及将数据重新提取到结果集中的所有行程。可以显式或隐式地重新获取数据,以更新对回滚敏感或对回滚不敏感/可更新的结果集。 - -设置提取大小 ------------------------- - -对所有 `Statement`、`PreparedStatement`、`CallableStatement` 和 `ResultSet` 对象,可以使用以下方法来设置和获取 Fetch Size: - -* `void setFetchSize(int rows) throws SQLException` - - - -* `int getFetchSize() throws SQLException` - - - - - - -要设置查询的 Fetch Size,请在运行查询之前在语句对象上调用 `setFetchSize`。如果将 Fetch Size 设置为 N,则每次访问数据库时都会获取 N 行。 - -运行查询后,可以在结果集对象上调用 `setFetchSize` 来覆盖传递给它的语句对象访存大小。这将影响到数据库的后续行程,为原始查询获取更多行,并影响以后的行重取。 - -预设提取方向 ------------------------- - -标准 JDBC 可以预先指定用于处理结果集的方向(称为提取方向)。结果集设置方法如下: - -* `void setFetchDirection(int direction) throws SQLException` - - - -* `int getFetchDirection() throws SQLException` - - - - - - -OceanBase JDBC 驱动程序仅支持向前的预设值,可以通过输入 `ResultSet.FETCH_FORWARD` 静态常量值来指定该值。 - -不支持值 `ResultSet.FETCH_REVERSE` 和 `ResultSet.FETCH_UNKNOWN`,如果尝试指定会导致 SQL 警告,并且设置将被忽略。 diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/8.result-set/3.refetch-rows.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/8.result-set/3.refetch-rows.md deleted file mode 100644 index ed43b7713..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/8.result-set/3.refetch-rows.md +++ /dev/null @@ -1,42 +0,0 @@ -重取行 -======================== - -对于某些类型的结果集,结果集支持 refreshRow 方法来重新获取数据,包括返回数据库以重新获取与结果集中的 n 行相对应的数据库行,从当前行开始,其中 n 是获取大小。 - -可以查看数据库在结果集之外的更新操作,但是取决于该事务的隔离级别。 - -因为仅重新获取与结果集中已存在的行相对应的行,所以对于自原始查询以来已在数据库中插入或删除的行不执行任何操作。重新获取会忽略已插入的行,即使从数据库中删除了相应的行,行仍将保留在结果集中。当尝试重新获取数据库中已删除的行时,结果集中的相应行将保持其原始值。 -**说明** - - - -如果您声明 `TYPE_SCROLL_SENSITIVE` 结果集是基于具有特定条件的查询,然后从外部更新该行以使列值不再与查询条件匹配,那么驱动程序的行为就好像该行已从数据库中删除而该查询未检索到该行。因此,调用 `refreshRow` 方法时,看不到特定行的更新。 - -以下是 `refreshRow` 方法的签名: - -```unknow -void refreshRow() throws SQLException -``` - - - -调用此方法时,您必须位于当前行中,不能在行边界之外,也不能在插入行中。 - -支持 `refreshRow` 方法的结果集类别如下: - -* 回滚敏感/只读 - - - -* 回滚敏感/可更新 - - - -* 回滚不敏感/可更新 - - - - - - -回滚敏感的结果集功能是通过隐式调用 `refreshRow` 来实现的。 diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/8.result-set/4.cursor-result-set.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/8.result-set/4.cursor-result-set.md deleted file mode 100644 index 163062b3c..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/8.result-set/4.cursor-result-set.md +++ /dev/null @@ -1,92 +0,0 @@ -游标结果集 -========================== - -游标(Cursor)是处理数据的一种方法,为了查看或者处理结果集中的数据,游标提供了在结果集中一次一行或者多行前进或向后浏览数据的能力。 - -结果集分类 ------------------------ - -JDBC 结果集按照配置分为以下三种: - -* 常规结果集:一次获取到所有的结果,执行速度最快但容易引发 `OOM`。 - - - -* 流式结果:不一次性读取全部的数据,而是一行一行从 Socket 中读取数据。`statement.setFetchSize(Integer.MIN_VALUE)` 就可以使用流式结果集。流式结果集执行速度快,但是一旦开始读取就无法停止,而且容易造成网络问题。 - - - -* 游标结果集:需要 `COM_STMT_FETCH` 支持且需要开启 PS。设置语法为 `useCursorFetch=true`,还需要指定 `fetchSize`。游标结果集执行速度慢,并且要求 ODP V1.8.5 及 OBServer V2.2.75 以上版本。 - - - - - - -useCursorFetch 使用方法 -------------------------------------- - -游标结果集(`useCursorFetch`)的使用方法如下: - -1. 建立链接,设置参数 `useCursorFetch` 和 `useServerPrepStmts`。 - - ```unknow - String url = "jdbc:mysql://host:port/test?useServerPrepStmts=false&useCursorFetch=true"conn = DriverManager.getConnection(url,"admin@mysql", "admin"); - ``` - - - - - - - - -2. 生成 Prepare 语句。 - - ```unknow - PreparedStatement pstmt = conn.prepareStatement("select * from tab",ResultSet.TYPE_FORWARD_ONLY, ResultSet.CONCUR_READ_ONLY); - ``` - - - - - - - - -3. 设置 `fetchsize`。 - - ```unknow - pstmt.setFetchSize(3); - ``` - - - - - - - - -4. 执行语句。 - - ```unknow - ResultSet rs = pstmt.executeQuery(); - ``` - - - - - - - - -5. 循环获取下一行数据。 - - ```unknow - while (rs.next()) {} - ``` - - - - - diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/9.statement-cache/1.statement-caching-overview.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/9.statement-cache/1.statement-caching-overview.md deleted file mode 100644 index 88648b006..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/9.statement-cache/1.statement-caching-overview.md +++ /dev/null @@ -1,32 +0,0 @@ -语句缓存简介 -=========================== - -语句缓存通过缓存重复使用的可执行语句(例如在循环中或在重复调用的方法中的语句)来提高性能。 - -JDBC 标准定义了一个语句缓存接口。 - -语句缓存可以执行以下操作: - -* 防止重复创建游标的开销 - - - -* 防止重复的语句解析和创建 - - - -* 重用客户端中的数据结构 - - - - - - -显式语句缓存可以缓存和检索选定的已准备好的语句和可调用的语句。显式语句缓存依赖于密钥,即提供的 Java `String`。 -**说明** - - - -无法缓存普通语句。 - -显式 Statement 缓存保留语句数据和状态以及元数据,具有较高的性能优势。在显式 Statement 缓存期间,如果 JDBC 驱动程序在缓存中找不到匹配的语句,则将返回 `null` 值。 diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/9.statement-cache/2.use-statement-caching.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/9.statement-cache/2.use-statement-caching.md deleted file mode 100644 index 167d92577..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/9.statement-cache/2.use-statement-caching.md +++ /dev/null @@ -1,18 +0,0 @@ -使用语句缓存 -=========================== - -JDBC 通过 API 接口调用相关的语句缓存功能,包括启用和禁用,以及可调用语句的数量和设置 SQL 的最大缓存数量等。 - -详细的参数信息如下表所示。 - - -| **参数** | **描述** | -|-----------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| useServerPrepStmts | 在执行之前,在服务器端准备 PrepareStatement。重复使用相同查询的应用程序具有激活该选项的值,但通常情况是使用直接命令(文本协议)。如果 `rewriteBatchedStatements` 设置为 `true`,则此选项将设置为 `false`。 默认值:`false`。 | -| cachePrepStmts | 如果 `useServerPrepStmts = true`,则将准备好的信息缓存在 LRU 缓存中,以避免重新准备命令。下次使用该命令时,会将准备好的标识符和参数(如果有)发送到服务器,因而可以避免服务器重新解析查询。 默认值:`true`。 | -| prepStmtCacheSize | 如果 `useServerPrepStmts = true`,则使用选项 `cachePrepStmts` 定义准备好的语句缓存大小。 默认值:250。 | -| prepStmtCacheSqlLimit | 如果 `useServerPrepStmts = true`,则大于此阈值的查询将不被缓存。 默认值:2048。 | -| cacheCallableStmts | 启用/禁用调用语句缓存。 默认值:`true`。 | -| callableStmtCacheSize | 如果启用了 `cacheCallableStmts`,则设置驱动程序缓存每个 VM 的可调用语句的数量。 默认值:`true`。 | - - diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/9.statement-cache/3.reuse-statement-object.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/9.statement-cache/3.reuse-statement-object.md deleted file mode 100644 index 5f90112c8..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/2.use-jdbc/9.statement-cache/3.reuse-statement-object.md +++ /dev/null @@ -1,68 +0,0 @@ -复用语句对象 -=========================== - -JDBC 的语句池功能允许应用程序以与使用 Connection 对象相同的方式重用 PreparedStatement 对象。 - -多个逻辑连接可以以透明方式重用 `PreparedStatement` 对象。 - -使用 Pooled Statement -------------------------------------- - -应用程序可以通过从 `Statement` 接口调用 `isPoolable` 方法来找出数据源是否支持语句池。如果返回值为 `true`,则应用程序知道正在准备 `PreparedStatement` 对象。应用程序还可以通过使用 `Statement` 接口中的 `setPoolable` 方法来请求要合并或不合并的语句。 - -Pooled Statement 的重用对于应用程序应该是完全透明的,也就是说,无论 `PreparedStatement` 对象是否参与语句池,应用程序代码应保持相同。如果应用程序关闭了 `PreparedStatement` 对象,则必须调用 `Connection.prepareStatement` 方法进行重用。 - -关闭 Pooled Statement -------------------------------------- - -应用程序关闭 Pooled Statement 的方式与关闭非 Pooled Statement 的方式完全相同。一旦语句被关闭,无论该语句是池中的还是非池中的,都不再供应用程序使用,如果尝试重用该语句会引发异常。唯一可见的区别是应用程序无法直接关闭正在池化的物理语句,而是由池管理器负责完成。`PooledConnection.closeAll` 方法关闭给定物理连接上打开的所有语句,从而释放与这些语句关联的资源。 - -关闭 Pooled Statement 的方法如下: - -* `close` - - 此 `java.sql.Statement` 接口方法由应用程序调用。如果正在对该语句进行池化,则它将关闭该应用程序使用的逻辑语句,但不会关闭正在池化的物理语句。 - - - - - - - -* `close` - - 此 `java.sql.Connection` 接口方法由应用程序调用。此方法的行为根据使用该语句的连接是否被池化而有所不同。 - - - - - - - -* 非池化连接 - - 此方法关闭物理连接以及该连接创建的所有语句。这是必需的,因为垃圾回收机制无法检测何时可以释放外部管理的资源。 - - - - - - - -* 池化连接 - - 此方法关闭逻辑连接及其返回的逻辑语句,但打开基础的 `PooledConnection` 对象和所有关联的缓冲语句。 - - - - - - - -* `PooledConnection.closeAll` - - 连接池管理器调用此方法以关闭 `PooledConnection` 对象所有正在池化的物理语句。 - - - - diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/3.features-specific-to-oracle-mode/1.call-pl-stored-procedure.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/3.features-specific-to-oracle-mode/1.call-pl-stored-procedure.md deleted file mode 100644 index d70e7c9ad..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/3.features-specific-to-oracle-mode/1.call-pl-stored-procedure.md +++ /dev/null @@ -1,51 +0,0 @@ -调用 PL 存储过程 -=============================== - -JDBC 驱动程序支持处理 PL 存储过程和匿名块,支持 PL 块语法和大多数 JDBC 转义语法。 - -以下 PL 调用可与 JDBC 驱动程序一起使用: - -```unknow -// JDBC 转义语法 -CallableStatement ecs1 = conn.prepareCall - ( "{call proc (?,?)}" ) ; // 存储过程 -CallableStatement ecs2 = conn.prepareCall - ( "{? = call func (?,?)}" ) ; // 存储函数 -// PL 块语法 -CallableStatement ecs3 = conn.prepareCall - ( "begin proc (?,?); end;" ) ; // 存储过程 -CallableStatement ecs4 = conn.prepareCall - ( "begin ? := func(?,?); end;" ) ; // 存储函数 -``` - - - -JDBC 程序中的函数调用如下所示: - -```unknow -OceanBaseDataSource obds = new OceanBaseDataSource(); -obds.setURL("jdbc:oceanbase:oracle://连接串:1521/用户名"); -obds.setUser("Adam"); -obds.setPassword("P@ssw0rd"); -Connection conn = obds.getConnection(); - -CallableStatement cs = conn.prepareCall ("begin ? := f(?); end;"); -cs.registerOutParameter(1,Types.CHAR); -cs.setString(3, "aaa"); -cs.executeUpdate(); -String result = cs.getString(1); -``` - - - -示例:PL 函数获取一个字符序列并为其添加后缀。 - -```unknow -CREATE OR REPLACE FUNCTION f (v CHAR) -RETURN CHAR AS -BEGIN - RETURN v || 'suffix'; -END; -``` - - diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/3.features-specific-to-oracle-mode/2.result-set-performance.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/3.features-specific-to-oracle-mode/2.result-set-performance.md deleted file mode 100644 index 25ef7cc62..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/3.features-specific-to-oracle-mode/2.result-set-performance.md +++ /dev/null @@ -1,16 +0,0 @@ -结果集性能 -========================== - -OceanBase JDBC 结果集通过使用客户端缓存来支持可滚动性,并通过使用 `ROWID` 支持可更新性。 - -可滚动性 ----------------------- - -由于基础服务器不支持可滚动游标,因此 OceanBase JDBC 必须在单独的层中实现可滚动性,并且是通过使用客户端内存缓存存储可滚动结果集的行来完成的。 - -因为可滚动结果集的所有行都存储在客户端缓存中,所以结果集包含很多行,如果存在很多列或非常大的列可能会导致客户端 Java 虚拟机(JVM)运行失败 ,所以建议不要为大型结果集指定可滚动性。 - -可更新性 ----------------------- - -为了支持可更新性,OceanBase JDBC 使用 `ROWID` 来唯一标识出现在结果集中的数据库行。对于对可更新结果集的每个查询,OceanBase JDBC 驱动程序都会自动检索 `ROWID` 以及所选择的列。 diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/3.features-specific-to-oracle-mode/3.create-a-multi-level-collection-type.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/3.features-specific-to-oracle-mode/3.create-a-multi-level-collection-type.md deleted file mode 100644 index 46d512d55..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/3.features-specific-to-oracle-mode/3.create-a-multi-level-collection-type.md +++ /dev/null @@ -1,24 +0,0 @@ -创建多级集合类型 -============================= - -在 JDBC 中创建新的多级集合类型的最常见方法是将 SQL CREATE TYPE 语句传递给 java.sql.Statement 类的 `execute` 方法。 - -以下代码为创建一个一级嵌套表 `first_level` 和一个二级嵌套表 `second_level`: - -```unknow -Connection conn = .... // 建立数据库连接 - -Statement st = conn.createStatement(); // 打开数据库游标 - -st.execute("CREATE TYPE first_level AS TABLE OF NUMBER"); // 创建一个嵌套的数字表 - -st.execute("CREATE TYPE second_level AS TABLE OF first_level"); // 创建一个两级嵌套表 -... -st.close(); // 释放资源 - -conn.close(); // 关闭数据库连接 -``` - - - -一旦创建了多级收集类型,就可以将它们用作基础表的列以及对象类型的属性。 diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/3.features-specific-to-oracle-mode/4.use-the-array-and-struct-classes.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/3.features-specific-to-oracle-mode/4.use-the-array-and-struct-classes.md deleted file mode 100644 index cc24345bb..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/3.features-specific-to-oracle-mode/4.use-the-array-and-struct-classes.md +++ /dev/null @@ -1,404 +0,0 @@ -使用 ARRAY 和 STRUCT 类 -======================================== - -数组和 STRUCT 类同属于集合类,一般会一起使用。 - -ARRAY 描述符 ---------------------------- - -创建和使用 `ARRAY` 对象需要一个描述符(即 `oracle.sql.ArrayDescriptor` 类的实例)。对于与相同 SQL 类型相对应的任意数量的 `ARRAY` 对象,只需一个 `ArrayDescriptor` 对象。 - -\> var1) throws SQLException; -Object getArray(long var1, int var3) throws SQLException; -Object getArray(long var1, int var3, Map\> var4) throws SQLException; ResultSet getResultSet() throws SQLException; ResultSet getResultSet(Map\> var1) throws SQLException; ResultSet getResultSet(long var1, int var3) throws SQLException; ResultSet getResultSet(long var1, int var3, Map\> var4) throws SQLException; void free() throws SQLException; 这些函数 可以参考 java.sql.Array" commentTypeId="40" timestamp="2021-07-29T16:30:04+08:00" authorId="13117" uuid="b380ade9-de04-4a2b-bcc6-27255a8caf0b" id="comment-iaq-b0r-nwx"\>ARRAY 类方法 --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- - -`oracle.sql.ARRAY` 类包含以下方法: - -* `getDescriptor` - - 返回描述数组类型的 `ArrayDescriptor` 对象。 - - - - - - - -* `getArray` - - 检索默认 JDBC 类型的数组的内容。如果它检索对象数组,则 `getArray` 使用数据库连接对象的默认类型映射来确定类型。 - - -* `getOracleArray` - - 与 `getArray` 相同,但是以 `oracle.sql.*` 格式检索元素。 - - - - - - - -* `getBaseType` - - 返回数组元素的 SQL 类型代码。 - - - - - - - -* `getBaseTypeName` - - 返回此数组的元素的 SQL 类型名称。 - - - - - - - -* `getSQLTypeName` - - 返回整个数组的标准 SQL 类型名称。此方法是 Oracle 扩展。 - - - - - - - -* `getResultSet` - - 将数组元素具体化为结果集。 - - - - - - - -* `getJavaSQLConnection` - - 返回与此数组关联的连接实例。 - - - - - - - -* `length` - - 返回数组中的元素数。 - - - - - -使用 ARRAY 和 STRUCT 类的示例 ----------------------------------------- - -```unknow - @BeforeClass() - public static void initClass() throws SQLException { - createTable(tablenameArray, "c1 int primary key,c2 interval day(6) to second(5)"); - createTable(tablenameStruct, " c1 int primary key,c2 interval year(4) to month"); - createTable(array1, "c1 int"); - createTable(array2, "c1 char(100)"); - createTable(array3, "c1 date"); - createTable(struct1, "c1 int"); - createTable(struct2, "c1 varchar(100)"); - createTable(struct3, "c1 date"); - createTable(raw1, "c1 int ,c2 raw(100)"); - createTable(refcursor1, "c1 varchar(20), c2 number"); - } - - public void showArrayRes(Array array) throws Exception { - ResultSet arrayRes = array.getResultSet(); - while (arrayRes.next()) { - int index = arrayRes.getInt(1); - Struct struct = (Struct) arrayRes.getObject(2); - Object[] objArr = struct.getAttributes(); - for (Object obj : objArr) { - System.out.printf("index j %d obj now is %s\n", index, obj); - } - } - } - - public void executeSqls(String[] sqls, Connection conn) { - PreparedStatement ps; - for (String sql : sqls) { - try { - ps = conn.prepareStatement(sql); - ps.execute(); - ps.close(); - } catch (Exception e) { - System.out.println("sql:" + sql); - // ignore, maybe table does not exist - e.printStackTrace(); - } - } - } - - //示例 1 - public void basicArrayAndStructTest() throws SQLException { - Assume.assumeTrue(sharedUsePrepare()); - Connection conn = null; - try { - conn = sharedPSConnection; - PreparedStatement ps = null; - Statement stmt = conn.createStatement(); - stmt.execute("CREATE OR REPLACE TYPE my_obj as object (c1 int, c3 date)"); - stmt.execute("CREATE OR REPLACE TYPE obj_array IS TABLE OF my_obj"); - - // test input - String createPlSql = "CREATE OR REPLACE PROCEDURE my_proc_objarr(X IN obj_array) IS " - + "BEGIN " + " FOR idx IN 1..X.count LOOP " + " INSERT INTO " - + array1 + " VALUES(X(idx).c1);" - + " END LOOP; " - // + " FOR idx IN 1..X.count LOOP" + " INSERT INTO " + array2 - // + " VALUES(X(idx).c2);" + " END LOOP; " - + " FOR idx IN 1..X.count LOOP" + " INSERT INTO " + array3 - + " VALUES(X(idx).c3);" + " END LOOP; " + "END;"; - stmt.execute(createPlSql); - Integer[] intArray = new Integer[10]; - for (int i = 0; i < 10; ++i) { - if (i % 2 == 0) { - intArray[i] = null; - } else { - intArray[i] = i; - } - } - // String[] strArray = new String[10]; - // for (int i = 0; i < 10; ++i) { - // if (i % 2 == 0) { - // strArray[i] = "luyun_" + i; - // } else { - // strArray[i] = null; - // } - // } - - java.sql.Timestamp[] dateArray = new Timestamp[10]; - for (int i = 0; i < 10; ++i) { - if (i % 2 == 0) { - dateArray[i] = Timestamp.valueOf("2019-06-04 10:29:11.123456"); - } else { - dateArray[i] = null; - } - } - Object[] structArray = new Object[10]; - for (int i = 0; i < 10; ++i) { - structArray[i] = conn.createStruct("my_obj", new Object[] { intArray[i], - dateArray[i] }); - // strArray[i], dateArray[i] }); - } - Array array = conn.createArrayOf("my_obj", structArray); - // ((ArrayImpl)array).getComplexType().setTypeName("obj_array"); - { - System.out.println("=======prepareStatement input test ============="); - ps = conn.prepareStatement("call my_proc_objarr(?)"); - ps.setArray(1, array); - ps.execute(); - ps.close(); - - ps = conn.prepareStatement("select * from " + array1); - ResultSet rs = ps.executeQuery(); - while (rs.next()) { - System.out.println(rs.getInt("c1")); - } - ps.close(); - - // ps = conn.prepareStatement("select * from " + array2); - // rs = ps.executeQuery(); - // while (rs.next()) { - // System.out.println(rs.getString("c1")); - // } - // ps.close(); - - ps = conn.prepareStatement("select * from " + array3); - rs = ps.executeQuery(); - while (rs.next()) { - System.out.println(rs.getDate("c1")); - } - ps.close(); - } - { - System.out.println("=======callable Statement input test ============="); - ps = conn.prepareCall("call my_proc_objarr(?)"); - ps.setArray(1, array); - ps.execute(); - ps.close(); - - ps = conn.prepareStatement("select * from " + array1); - ResultSet rs = ps.executeQuery(); - while (rs.next()) { - System.out.println(rs.getInt("c1")); - } - ps.close(); - - // ps = conn.prepareStatement("select * from " + array2); - // rs = ps.executeQuery(); - // while (rs.next()) { - // System.out.println(rs.getString("c1")); - // } - // ps.close(); - - ps = conn.prepareStatement("select * from " + array3); - rs = ps.executeQuery(); - while (rs.next()) { - System.out.println(rs.getDate("c1")); - } - ps.close(); - } - // test output - createPlSql = "CREATE OR REPLACE PROCEDURE my_proc_obj_out(x OUT obj_array) IS" - + " i int :=1;" + " BEGIN" + " x.extend(10);" + " for idx in 1..5 loop" - // + " x(i).c1 := idx;" + " x(i).c2 := idx;" - + " x(i).c1 := idx;" + " x(i).c3 := date '1970-01-01';" - + " x(i + 1).c1 := null;" - // + " x(i + 1).c2 := null;" + " x(i + 1).c3 := null;" - + " x(i + 1).c3 := null;" + " i := i + 2;" + " end loop;" + "END;"; - { - stmt.execute(createPlSql); - ps = conn.prepareStatement("call my_proc_obj_out(?)"); - ps.setArray(1, null); - ResultSet rs = ps.executeQuery(); - while (rs.next()) { - Array resArray = rs.getArray(1); - showArrayRes(resArray); - } - } - // callable test - { - System.out.println("=========callable stmt test=========="); - CallableStatement csmt = conn.prepareCall("{call my_proc_obj_out(?)}"); - csmt.registerOutParameter(1, Types.ARRAY, "obj_array"); - csmt.execute(); - Array resArray = csmt.getArray(1); - showArrayRes(resArray); - } - } catch (Exception e) { - e.printStackTrace(); - fail(); - } - } - - //示例 2 - public void basicRawTest() throws SQLException { - Connection conn = null; - try { - conn = sharedPSConnection; - PreparedStatement ps = null; - ps = conn.prepareStatement("insert into " + raw1 + " values(?,?)"); - ps.setInt(1, 11); - ps.setBytes(2, new byte[] { 1, 2, 3 }); - ps.execute(); - - ps = conn.prepareStatement("select c1 ,c2 from " + raw1 + " where c1 = 11"); - ResultSet rs = ps.executeQuery(); - // Assert.assertEquals("[B", rs.getMetaData().getColumnClassName(2)); - Assert.assertEquals("RAW", rs.getMetaData().getColumnTypeName(2)); - Assert.assertEquals(-3, rs.getMetaData().getColumnType(2)); - Assert.assertEquals(2, rs.getMetaData().getColumnCount()); - Assert.assertEquals("C2", rs.getMetaData().getColumnLabel(2)); - Assert.assertEquals(100, rs.getMetaData().getColumnDisplaySize(2)); - Assert.assertEquals("UNITTESTS", rs.getMetaData().getCatalogName(2)); - Assert.assertEquals("C2", rs.getMetaData().getColumnName(2)); - Assert.assertEquals(0, rs.getMetaData().getScale(2)); - Assert.assertEquals("TEST_RAW1", rs.getMetaData().getTableName(2)); - // assertFalse(rs.getMetaData().isCaseSensitive(2)); - assertTrue(rs.next()); - Assert.assertEquals(11, rs.getInt(1)); - Assert.assertTrue(Arrays.equals(new byte[] { 1, 2, 3 }, rs.getBytes(2))); - Assert.assertEquals("010203", rs.getString(2)); - Assert.assertEquals(3, rs.getBinaryStream(2).available()); - rs.close(); - ps.close(); - } catch (Exception e) { - e.printStackTrace(); - fail(); - } - } - - //示例 3 - public void testRefCursor() { - for (int loop = 0; loop < 2; loop++) { - Connection conn = sharedPSConnection; - { - { - String sql = "insert into " + refcursor1 + " values(?, ?)"; - for (int i = 0; i < 10; i++) { - try { - PreparedStatement statement = conn.prepareStatement(sql); - statement.setString(1, "test" + i); - statement.setInt(2, i); - statement.execute(); - } catch (SQLException e) { - e.printStackTrace(); - } - } - } - try { - String sql = "select * from " + refcursor1; - PreparedStatement statement = conn.prepareStatement(sql); - statement.execute(); - ResultSet resultSet = statement.getResultSet(); - while (resultSet.next()) { - int columnCnt = resultSet.getMetaData().getColumnCount(); - for (int j = 1; j <= columnCnt; j++) { - System.out.println(resultSet.getMetaData().getColumnName(j) + ":" - + resultSet.getString(j)); - } - } - } catch (SQLException e) { - e.printStackTrace(); - } - try { - Statement statement = conn.createStatement(); - String createPlSql = "CREATE OR REPLACE PROCEDURE test_cursor(p_cursor OUT sys_refcursor) " - + "is BEGIN " - + " open p_cursor for select * from " - + refcursor1 + ";" + "end;"; - statement.execute(createPlSql); - CallableStatement csmt = conn.prepareCall("call test_cursor(?)", - ResultSet.TYPE_FORWARD_ONLY, ResultSet.CONCUR_READ_ONLY); - csmt.setFetchSize(10); - csmt.registerOutParameter(1, Types.REF); - csmt.execute(); - ResultSet resultSet = (ResultSet) csmt.getObject(1); - resultSet.setFetchSize(2); - System.out.println("=========refcursor output=========="); - while (resultSet.next()) { - int columnCnt = resultSet.getMetaData().getColumnCount(); - for (int j = 1; j <= columnCnt; j++) { - System.out.println(resultSet.getMetaData().getColumnName(j) + ":" - + resultSet.getString(j)); - } - } - resultSet.close(); - resultSet = (ResultSet) csmt.getObject(1); - System.out.println("=========refcursor output=========="); - try { - while (resultSet.next()) { - int columnCnt = resultSet.getMetaData().getColumnCount(); - for (int j = 1; j <= columnCnt; j++) { - System.out.println(resultSet.getMetaData().getColumnName(j) + ":" - + resultSet.getString(j)); - } - } - } catch (SQLException e) { - Assert.assertEquals(e.getErrorCode(), 600); - } - } catch (SQLException e) { - e.printStackTrace(); - Assert.assertEquals(e.getMessage(), "cursor is not open"); - } - } - } - } -``` - - diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/3.features-specific-to-oracle-mode/5.distributed-transactions-1/1.overview-of-distributed-transactions.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/3.features-specific-to-oracle-mode/5.distributed-transactions-1/1.overview-of-distributed-transactions.md deleted file mode 100644 index 40495032c..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/3.features-specific-to-oracle-mode/5.distributed-transactions-1/1.overview-of-distributed-transactions.md +++ /dev/null @@ -1,51 +0,0 @@ -分布式事务概述 -============================ - -使用 XA 功能时,事务管理器将使用 XA 资源实例来准备和协调每个事务分支,然后适当地提交或回滚所有事务分支。 - -XA 功能的关键组件包括 XA 数据源、XA 连接、XA 资源和事务编号。 - -XA 数据源 ------------------------- - -XA 数据源是连接池数据源和其他数据源的扩展,在概念和功能上相似。 - -每个资源管理器将有一个 XA 数据源实例,并用于分布式事务中。通常,在中间层软件中创建 XA 数据源实例。 - -XA 数据源产生 XA 连接。 - -XA 连接 ------------------------ - -XA 连接是池连接的扩展,在概念和功能上相似。XA 连接封装了物理数据库连接。各个连接实例是这些物理连接的临时句柄。 - -XA 连接实例只对应于一个会话,尽管该会话可以由多个逻辑连接实例按顺序使用,例如池连接实例。 - -通常,可以从中间层软件中的 XA 数据源实例获取 XA 连接实例。如果分布式事务将涉及同一数据库中的多个会话,则可以从单个 XA 数据源实例获得多个 XA 连接实例。 - -XA 连接产生 OracleXAResource 实例和 JDBC 连接实例。 - -XA 资源 ------------------------ - -事务管理器使用 XA 资源来协调分布式事务的事务分支。 - -通常,在中间层软件中,可以从每个 XA 连接实例中获得一个 OracleXAResource 实例。OracleXAResource 实例和 XA 连接实例之间存在一对一的关联。同样,OracleXAResource 实例与会话之间也存在一对一的关联。 - -在典型情况下,中间层组件会将 OracleXAResource 实例移交给事务管理器,以用于协调分布式事务。 - -因为每个 OracleXAResource 实例都对应一个会话,所以在任何给定时间只能有一个与 OracleXAResource 实例关联的活动事务分支,但也可能会有其他暂停的事务分支。 - -每个 OracleXAResource 实例可以操作与其相关联的会话事务分支,包括启动、结束、准备、提交或回滚。 - -准备步骤是两阶段提交操作的第一步。事务管理器将向每个 OracleXAResource 实例发出 `PREPARE`。一旦事务管理器看到每个事务分支的操作已成功准备,它将向每个 OracleXAResource 实例发出 `COMMIT` 来提交所有更改。 - -事务 ID ------------------------ - -事务 ID 用于标识事务分支。每个 ID 包括事务分支 ID 组件和分布式事务 ID 组件。这也就是分支与分布式事务关联的方式。与给定的分布式事务关联的所有 OracleXAResource 实例都具有一个事务 ID,该事务 ID 包含相同的分布式事务 ID 组件。 - -OracleXAResource.ORATRANSLOOSE ------------------------------------------------- - -使用事务 ID `xid` 启动一个松散耦合的事务。 diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/3.features-specific-to-oracle-mode/5.distributed-transactions-1/2.xa-components.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/3.features-specific-to-oracle-mode/5.distributed-transactions-1/2.xa-components.md deleted file mode 100644 index 864ff0a2f..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/3.features-specific-to-oracle-mode/5.distributed-transactions-1/2.xa-components.md +++ /dev/null @@ -1,505 +0,0 @@ -XA 组件 -========================== - -XA 组件是 JDBC 标准中指定的标准 XA 接口。 - -XADatasource 接口和 Oracle 实施 --------------------------------------------- - -`javax.sql.XADataSource` 接口概述了 XA 数据源的标准功能,是 XA 连接的工厂。`getXAConnection`方法重载返回一个 XA 连接实例,并可以选择使用用户名和密码作为输入,如下所示: - -```unknow -public interface XADataSource -{ - XAConnection getXAConnection() throws SQLException; - XAConnection getXAConnection(String user, String password) - throws SQLException; - ... -} -``` - - - -JDBC 使用 `OracleXADataSource` 类实现 `XADataSource` 接口。`OracleXADataSource` 类还扩展了 `OracleConnectionPoolDataSource` 类,而 `OracleConnectionPoolDataSource` 类扩展了 `OracleDataSource` 类,因此包括所有连接属性。 - -`OracleXADataSource` 类的 `getXAConnection` 方法返回 XA 连接实例的 Oracle 实现,这些实例是 `OracleXAConnection` 实例。 -**说明** - - - -您可以使用前面讨论的非池化数据源相同的命名约定在 Java 命名目录和接口(JNDI)中注册 XA 数据源。 - -XAConnection 接口和 Oracle 实施 --------------------------------------------- - -XA 连接实例与池连接实例一样,封装了与数据库的物理连接。 这里的数据库是指在产生 XA 连接实例的 XA 数据源实例的连接属性中指定的数据库。 - -每个 XA 连接实例还具有生成 OracleXAResource 实例的功能,该实例将与之相对应以用于协调分布式事务。 - -XA 连接实例是实现标准` javax.sql.XAConnection` 接口类的实例,如下所示: - -```unknow -public interface XAConnection extends PooledConnection -{ - javax.jta.xa.XAResource getXAResource() throws SQLException; -} -``` - - - -XAConnection 接口扩展了 `javax.sql.PooledConnection` 接口,因此还包括 `getConnection`、`close`、`addConnectionEventListener` 和 `removeConnectionEventListener` 方法。 - -JDBC 使用 OracleXAConnection 类实现 XAConnection 接口,OracleXAConnection 类还扩展了 OraclePooledConnection 类。 - -OracleXAConnection 类的 `getXAResource` 方法返回 OracleXAResource 实例的 Oracle 实现,该实例是一个OracleXAResource 实例。`getConnection` 方法返回一个 OracleConnection 实例。 - -XA 连接实例返回的 JDBC 连接实例充当物理连接的临时句柄,而不是封装物理连接。物理连接由 XA 连接实例封装。与常规连接完全相同,它从 XAConnection 对象获得连接的行为,直至参与到全局事务为止。这时,自动提交状态设置为 `false`。全局事务结束后,自动提交状态将返回到其在全局事务之前的值。从 XAConnection 获得的连接的默认自动提交状态均为 `true`。 - -每次调用 XA 连接实例的 `getConnection` 方法时,都会返回一个表现出默认行为的新连接实例,并关闭以前存在的并由同一 XA 连接实例返回的所有以前的连接实例。但是,建议在打开新的连接实例之前显式关闭先前的连接实例。 - -调用 XA 连接实例的 `close` 方法将关闭与数据库的物理连接,并通常在中间层执行。 - -XAResource 接口和 Oracle 实施 ------------------------------------------- - -事务管理器使用 `OracleXAResource` 实例来协调分布式事务的所有事务分支。 - -每个 `OracleXAResource` 实例都提供给事务管理器调用的关键功能,如下: - -* 将分布式事务与产生此 `OracleXAResource` 实例的 XA 连接实例中运行的事务分支关联和解除关联。本质上,是将分布式事务与 XA 连接实例封装的物理连接或会话相关联。这是通过使用事务 ID 来完成的。 - - - -* 执行分布式事务的两阶段提交功能,以确保在所有事务分支中更改都成功之前,不会在某一个事务分支中提交更改。 - - - - - -**注意** - - - -* 因为 XA 连接实例和 `OracleXAResource` 实例之间必须始终存在一对一的关联,所以当关联的 XA 连接实例关闭时,隐式关闭 `OracleXAResource` 实例。 - - - -* 如果事务由指定的 `OracleXAResource` 实例打开,则它也必须由相同的 `OracleXAResource` 实例关闭。 - - - - - - -`OracleXAResource` 实例是实现标准 `javax.transaction.xa.XAResource` 接口类的实例。JDBC 使用`OracleXAResource` 类实现 `XAResource` 接口。 - -每当调用 `OracleXAConnection` 类的 `getXAResource` 方法时,JDBC 驱动程序都会创建并返回一个 `OracleXAResource` 实例,并且 JDBC 驱动程序将 `OracleXAResource` 实例与连接实例和通过该连接运行的事务分支相关联。 - -这种方法是将 `OracleXAResource` 实例与特定连接以及在该连接中运行的事务分支相关联的方式。 - -OracleXAResource 方法功能和输入参数 --------------------------------------------- - -OracleXAResource 类具有几种方法来协调事务分支和与其关联的分布式事务。此功能通常涉及两阶段提交操作。 - -从中间层组件(例如应用程序服务器)接收 `OracleXAResource` 实例的事务管理器通常会调用此功能。 - -这些方法中的每一个都以 `Xid` 实例的形式将事务 ID 作为输入,其中包括事务分支 ID 组件和分布式事务 ID 组件。每个事务分支都有唯一的事务 ID,但是属于同一全局事务的事务分支作为其事务 ID 的一部分,所以具有相同的全局事务组件。 - -**Start** - -代表事务分支开始工作,将事务分支与分布式事务相关联。语法如下: - -```unknow -void start(Xid xid, int flags) -``` - - - -`flags` 参数必须是以下一个或多个值: - -* `XAResource.TMNOFLAGS` - - 将新事务分支的开始标记为与此 XA 资源实例相关联的会话中的后续操作。该分支将具有事务 ID `xid`,这是由事务管理器创建的 `OracleXid` 实例。 这会将事务分支映射到适当的分布式事务。 - - - - - - - -* `XAResource.TMJOIN` - - 将与此 XA 资源实例相关联会话的后续操作加入到 `xid` 指定的现有事务分支中。 - - - - - - - -* `XAResource.TMRESUME` - - 恢复 `xid` 指定的事务分支。 - **说明** - - - - 只能恢复之前挂起的事务分支。 - - - - - - - -* `OracleXAResource.ORATMSERIALIZABLE` - - 使用事务 ID `xid` 启动可序列化的事务。 - - - - - - - -* `OracleXAResource.ORATMREADONLY` - - 使用事务 ID `xid` 启动一个只读事务。 - - - - - - - -* `OracleXAResource.ORATMREADWRITE` - - 使用事务 ID `xid` 启动读/写事务。 - - - - - - - -* `OracleXAResource.ORATRANSLOOSE` - - 使用事务 ID `xid` 启动一个松散耦合的事务。 - - - - - -`TMNOFLAGS`、`TMJOIN`、`TMRESUME`、`ORATMSERIALIZABLE`、`ORATMREADONLY` 和 `ORATMREADWRITE` 被定义为 `XAResource` 接口和 `OracleXAResource` 类的 `static` 成员。`ORATMSERIALIZABLE`、`ORATMREADONLY `和 `ORATMREADWRITE` 是隔离模式标志。默认的隔离行为是 `READ COMMITTED`。 -**说明** - - - -* 代替使用 `TMRESUME` 的 `start` 方法,事务管理器可以将其强制转换为 `OracleXAResource` 并使用Oracle 扩展 `resume(Xid xid)` 方法。 - - - -* 如果使用 `TMRESUME`,则还必须使用 `TMNOMIGRATE`,如 `start(xid,XAResource.TMRESUME|OracleXAResource.TMNOMIGRATE)` 中所示。这可以防止应用程序收到错误信息 `ORA 1002: fetch out of sequence`。 - - - -* 如果错误地使用了隔离模式标识,则会引发代码为 `XAER_INVAL` 的异常。此外,因为无法设置现有事务的隔离级别,所以在恢复全局事务时不能使用隔离模式标识。如果在恢复事务时尝试使用隔离模式标识,则会引发代码为 `ORA-24790` 的外部 Oracle 异常。 - - - -* 为了避免错误 `Error ORA 1002: fetch out of sequence`,请在启动方法中包括 `TMNOMIGRATE` 标识。例如:`start(xid, XAResource.TMSUSPEND | OracleXAResource.TMNOMIGRATE);` - - - -* 在编写使用这些标识的事务管理器时,请注意 `OracleXAResource` 中定义的所有标志都是 Oracle 扩展。 - - - - - - -请注意,要在启动事务分支时创建适当的事务 ID,事务管理器必须知道该事务分支属于哪个分布式事务。其机制在中间层和事务管理器之间处理。 - -**End** - -结束工作代表 `xid` 指定的事务分支,将事务分支与其分布式事务解除关联。语法如下: - -```unknow -void end(Xid xid, int flags) -``` - - - -`flags` 参数可以具有以下值之一: - -* `XAResource.TMSUCCESS` - - 这表明该事务分支已经成功。 - - - - - - - -* `XAResource.TMFAIL` - - 这表明该事务分支已失败。 - - - - - - - -* `XAResource.TMSUSPEND` - - 这是为了挂起 `xid` 指定的事务分支。通过挂起事务分支,您可以在单个会话中拥有多个事务分支。但是,在给定时间只能激活一个。这比进行两次会话要耗费更多的资源。 - - - - - -`TMSUCCESS`、`TMFAIL` 和 `TMSUSPEND` 被定义为 `XAResource` 接口和 `OracleXAResource` 类的静态成员。 -**说明** - - - -* 与使用 `TMSUSPEND` 的 `end` 方法不同,事务管理器可以将其强制转换为 `OracleXAResource` 并使用 `suspend(Xid xid)` 方法(Oracle 扩展)。 - - - -* 暂停事务的 XA 功能提供了一种在单个 JDBC 连接内的各种事务之间进行切换的方法。您可以使用 XA 类来完成此操作。 - - - -* 如果使用 TMSUSPEND,则还必须使用 `TMNOMIGRATE`,如 `end(xid,XAResource.TMSUSPEND| OracleXAResource.TMNOMIGRATE)` 所示。 这样可以防止应用程序收到错误 `ORA 1002: fetch out of sequence`。 - - - -* 为了避免错误 `Error ORA 1002: fetch out of sequence`,请将 `TMNOMIGRATE` 标识作为 `end` 方法的一部分。 例如: - - - -* `end(xid, XAResource.TMSUSPEND | OracleXAResource.TMNOMIGRATE);` - - - -* 在编写使用这些标识的事务管理器时,请注意 `OracleXAResource` 中定义的所有标志都是 Oracle 扩展。 - - - - - - -**Prepare** - -在 `xid` 指定的事务分支中准备执行的更改。这是两阶段提交操作的第一阶段,以确保可以访问数据库并且可以成功提交更改。语法如下: - -```unknow -int prepare(Xid xid) -``` - - - -此方法返回一个整数值,如下所示: - -* `XAResource.XA_RDONLY` - - 如果事务分支仅运行只读操作(例如 `SELECT` 语句),则返回此值。 - - - - - - - -* `XAResource.XA_OK` - - 如果事务分支运行所有准备就绪且没有错误的更新,则返回此值。 - - - - - - - -* NA(不返回任何值) - - 如果事务分支运行更新,如果其中任何一个在准备过程中遇到错误,则不返回任何值。在这种情况下,将引发 XA 异常。 - - - - - -`XA_RDONLY` 和 `XA_OK` 被定义为 `XAResource` 接口和 `OracleXAResource` 类的静态成员。 -**说明** - - - -* 在调用 `prepare` 方法之前始终在分支上调用 `end` 方法。 - - - -* 如果分布式事务中只有一个事务分支,则无需调用 `prepare` 方法。无需预先准备就可以调用`OracleXAResource` 提交方法。 - - - - - - -**Commit** - -在 `xid` 指定的事务分支中提交准备好的更改。这是两阶段提交的第二阶段,仅在成功准备好所有事务分支之后才执行。语法如下: - -```unknow -void commit(Xid xid, boolean onePhase) -``` - - - -设置 `onePhase` 参数如下: - -* `true` - - 表示在提交事务分支时使用一阶段协议而不是两阶段协议,适用于分布式事务中只有一个事务分支的情况。`prepare` 步骤将被跳过。 - - - - - - - -* `false` - - 表示在提交事务分支时使用两阶段协议。 - - - - - -**Rollback** - -在 `xid `指定的事务分支中回滚准备好的更改。语法如下: - -```unknow -void rollback(Xid xid) -``` - - - -**Forget** - -告诉资源管理器忘记启发完成的事务分支。语法如下: - -```unknow -public void forget(Xid xid) -``` - - - -**Recover** - -事务管理器在恢复期间调用此方法,以获取当前处于准备或启发完成状态的事务分支的列表。语法如下: - -```unknow -public Xid[] recover(int flag) -``` - - -**说明** - - - -`TMSTARTRSCAN`、`TMENDRSCAN` 或 `TMNOFLAGS` 以外的标识值会引发异常,否则将忽略该标志。 - -资源管理器为当前处于准备或启发完成状态的事务分支返回零个或多个 `Xid`。如果在操作过程中发生错误,则资源管理器将引发适当的 `XAException`。 -**说明** - - - -恢复方法要求在 Oracle 数据库服务器中具有 `DBA_PENDING_TRANSACTIONS` 的 `SELECT` 特权和 SYS.DBMS_XA 的 `EXECUTE` 特权。 - -**isSameRM** - -要确定两个 `OracleXAResource` 实例是否对应于同一资源管理器,请从一个 `OracleXAResource` 实例调用 `isSameRM` 方法,并指定另一个 `OracleXAResource` 实例作为输入。 - -在以下示例中,假定 `xares1` 和 `xares2` 是 `OracleXAResource` 实例: - -```unknow -boolean sameRM = is1.isSameRM(is2); -``` - - - -Xid 接口和 Oracle 实施 ------------------------------------ - -事务管理器创建事务 ID 实例,并用于协调分布式事务的分支。每个事务分支都分配有唯一的事务 ID,其中包括以下信息: - -* 格式识别码 - - 格式标识符指定 Java 事务管理器。例如,可能有一个格式标识符 `ORCL`。该字段不能为空。格式标识符的大小为 4 个字节。 - - - - - - - -* 全局事务标识符 - - 它也被称为分布式事务 ID 组件。全局事务标识符的大小为 64 个字节。 - - - - - - - -* 分支限定符 - - 也称为事务分支 ID 组件。分支限定符的大小为 64 个字节。 - - - - - -属于同一分布式事务的所有事务分支的事务 ID 具有相同的 64 字节全局事务标识符值。但是,总的事务 ID 对于每个事务分支都是唯一的。 - -XA 事务 ID 实例是实现标准 `javax.transaction.xa.Xid` 接口类的实例,该接口是 X/Open 事务标识符 XID 结构的 Java 映射。 - -Oracle 使用 `oracle.jdbc.xa` 包中的 `OracleXid` 类实现此接口。`OracleXid` 实例仅在事务管理器中使用,对应用程序或应用服务器透明。 -**说明** - - - -Oracle 不需要将` OracleXid` 用于 `OracleXAResource` 调用。 相反,请使用实现 `javax.transaction.xa.Xid` 接口的任何类。 - -事务管理器在创建 `OracleXid` 实例时可以使用以下内容: - -```unknow -public OracleXid(int fId, byte gId[], byte bId[]) throws XAException -``` - - - -其中,`fId` 是格式标识符的整数值,`gId []` 是全局事务标识符的字节数组,`bId []` 是分支限定符的字节数组。 - -`Xid` 接口指定以下 `getter` 方法: - -* `public int getFormatId()` - - - -* `public byte[] getGlobalTransactionId()` - - - -* `public type[] getBranchQualifier()` - - - - - diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/3.features-specific-to-oracle-mode/5.distributed-transactions-1/3.distributed-transaction-example.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/3.features-specific-to-oracle-mode/5.distributed-transactions-1/3.distributed-transaction-example.md deleted file mode 100644 index 66fc77eeb..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/3.features-specific-to-oracle-mode/5.distributed-transactions-1/3.distributed-transaction-example.md +++ /dev/null @@ -1,148 +0,0 @@ -分布式事务示例 -============================ - -本节主要介绍如何使用 Oracle XA 功能实现分布式事务的示例。 - -Oracle XA 导入 ------------------------------- - -使用 Oracle XA 功能必须导入以下内容: - -```unknow -import oracle.jdbc.xa.OracleXid; -import oracle.jdbc.xa.OracleXAException; -import oracle.jdbc.pool.*; -import oracle.jdbc.xa.client.*; -import javax.transaction.xa.*; -``` - - - -`oracle.jdbc.pool` 软件包具有用于连接池功能的类,并将与 XA 相关的类作为子类。 - -或者,如果代码将在数据库内部运行并访问该数据库以进行 SQL 操作,则必须导入 `oracle.jdbc.xa.server` 而不是 `oracle.jdbc.xa.client`。语法如下: - -```unknow -import oracle.jdbc.xa.server.*; -``` - - - -客户端和服务器软件包分别具有 `OracleXADataSource`、`OracleXAConnection` 和 `OracleXAResource` 类的版本。 这三个类的抽象版本位于顶级 `oracle.jdbc.xa` 包中。 - -Oracle XA 代码示例 --------------------------------- - -如下为 XA 事务的处理过程示例: - -1. 使用 `XA START` 启动 XA 事务,并将其置于 `ACTIVE` 状态。 - - - -2. 对于处于 `ACTIVE` 状态的 XA 事务,执行构成该事务的 SQL 语句,然后执行 `XA END` 语句。`XA END` 使事务置于 `IDLE` 状态。 - - - -3. 对于处于 `IDLE` 状态的 XA 事务,可以执行 `XA PREPARE` 语句或 `XA COMMIT ... ONE PHASE` 语句: - - * ` XA PREPARE` 将事务置于 `PREPARED` 状态。此时的 `XA RECOVER` 语句在其输出中包括事务的 `xid` 值,因为 `XA RECOVER` 会列出所有处于` PREPARED` 状态的 XA 事务。 - - - - * `XA COMMIT ... ONE PHASE` 用于预备和提交事务。由于事务终止,`xid` 值未由 `XA RECOVER` 列出。 - - - - - - -4. 对于处于 `PREPARED` 状态的 XA 事务,可以执行 `XA COMMIT` 语句来提交和终止事务,或者执行 `XA ROLLBACK` 来回滚和终止事务。 - - - - - - -```unknow -public static void initClass() throws SQLException { - createTable(tableName1, "c1 int,c2 int"); - createTable(tableName2, "c1 int,c2 int"); - createTable(tableName3, "c1 varchar(200)"); -} - -public void obOracleXAOne() throws Exception { - Assume.assumeTrue(sharedUsePrepare()); - Connection conn = setConnection(); - conn.createStatement().execute(" insert into " + tableName1 + " values(1,2)"); - JDBC4MysqlXAConnection mysqlXAConnection = new JDBC4MysqlXAConnection( - (OceanBaseConnection) conn); - String gtridStr = "gtrid_test_wgs_ob_oracle_xa_one"; - String bqualStr = "bqual_test_wgs_ob_oracle_xa_one"; - Xid xid = new MysqlXid(gtridStr.getBytes(), bqualStr.getBytes(), 123); - try { - mysqlXAConnection.start(xid, XAResource.TMNOFLAGS); - PreparedStatement pstmt = null; - ResultSet rs = null; - pstmt = conn.prepareStatement("select c1 from " + tableName1); - rs = pstmt.executeQuery(); - - while (rs.next()) { - System.out.println(rs.getInt(1)); - } - pstmt.close(); - pstmt = conn.prepareStatement("insert into " + tableName1 + " (c1, c2) values(?, ?)"); - pstmt.setInt(1, 12); - pstmt.setInt(2, 12); - pstmt.executeUpdate(); - mysqlXAConnection.end(xid, XAResource.TMSUCCESS); - mysqlXAConnection.prepare(xid); - mysqlXAConnection.commit(xid, false); - } catch (Exception e) { - e.printStackTrace(); - mysqlXAConnection.rollback(xid); - throw e; - } -} - -public void obOracleXAOnePhase() throws Exception { - Assume.assumeTrue(sharedUsePrepare()); - Connection conn = null; - - conn = setConnection(); - conn.createStatement().execute(" insert into " + tableName2 + " values(1,2)"); - - JDBC4MysqlXAConnection mysqlXAConnection = new JDBC4MysqlXAConnection( - (OceanBaseConnection) conn); - String gtridStr = "gtrid_test_wgs_ob_oracle_xa_one_phase"; - String bqualStr = "bqual_test_wgs_ob_oracle_xa_one_phase"; - - Xid xid = new MysqlXid(gtridStr.getBytes(), bqualStr.getBytes(), 123); - try { - mysqlXAConnection.start(xid, XAResource.TMNOFLAGS); - // ps test - PreparedStatement pstmt = null; - ResultSet rs = null; - pstmt = conn.prepareStatement("select c1 from " + tableName2 + ""); - rs = pstmt.executeQuery(); - - while (rs.next()) { - System.out.println(rs.getInt(1)); - } - - pstmt.close(); - - pstmt = conn.prepareStatement("insert into " + tableName2 + " (c1, c2) values(?, ?)"); - pstmt.setInt(1, 12); - pstmt.setInt(2, 12); - pstmt.executeUpdate(); - - mysqlXAConnection.end(xid, XAResource.TMSUCCESS); - mysqlXAConnection.commit(xid, true); - } catch (Exception e) { - mysqlXAConnection.rollback(xid); - throw e; - } -} -``` - - diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/3.features-specific-to-oracle-mode/6.oracle-mode-error-message.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/3.features-specific-to-oracle-mode/6.oracle-mode-error-message.md deleted file mode 100644 index 33ea6ada7..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/3.features-specific-to-oracle-mode/6.oracle-mode-error-message.md +++ /dev/null @@ -1,206 +0,0 @@ -Oracle 模式的错误消息 -=================================== - -本节主要介绍错误消息的结构和 JDBC 常见的错误信息。 - -错误消息的结构 -------------------------- - -常规的 JDBC 错误消息结构允许将运行时信息附加到消息的末尾,并以冒号开头,如下所示: - -```unknow -: -``` - - - -如下示例为显示 `closed statement` 错误,这表明在调用 `next` 方法(结果集对象)的过程中引发了异常。 - -```unknow -Closed Statement:next -``` - - - -在某些情况下,用户可以在堆栈跟踪中找到相同的信息。 - -JDBC 常见错误信息 ------------------------------ - -JDBC 消息按 ORA 编号排序如下表所示。 - - -| **ORA 编码** | **信息** | -|------------|---------------------------------------------------------------------------------------------| -| ORA-17001 | 内部错误。 | -| ORA-17002 | IO 异常。 | -| ORA-17003 | 无效的列索引。 | -| ORA-17004 | 无效的列类型。 | -| ORA-17005 | 不支持的列类型。 | -| ORA-17006 | 列名无效。 | -| ORA-17007 | 无效的动态列。 | -| ORA-17008 | 关闭的连接。 | -| ORA-17009 | 关闭的语句。 | -| ORA-17010 | 关闭的结果集。 | -| ORA-17011 | 结果集已耗尽。 | -| ORA-17012 | 参数类型冲突。 | -| ORA-17014 | 未调用 `ResultSet.next`。 | -| ORA-17015 | 语句被取消。 | -| ORA-17016 | 语句超时。 | -| ORA-17017 | 已初始化游标。 | -| ORA-17018 | 无效的游标。 | -| ORA-17019 | 只能描述查询。 | -| ORA-17020 | 无效的行预取。 | -| ORA-17021 | 定义丢失。 | -| ORA-17022 | 在索引处定义丢失。 | -| ORA-17023 | 不支持的特性。 | -| ORA-17024 | 未读取数据。 | -| ORA-17025 | `define.isNull()` 中出现错误。 | -| ORA-17026 | 数字溢出。 | -| ORA-17027 | 信息流已被关闭。 | -| ORA-17028 | 直到关闭当前的结果集才能进行新的定义。 | -| ORA-17029 | `setReadOnly`:不支持只读连接。 | -| ORA-17030 | 仅 `READ_COMMITTED` 和 `SERIALIZABLE` 是有效的事务处理级。 | -| ORA-17031 | `setAutoClose`:仅支持自动关闭模式打开。 | -| ORA-17032 | 行预取不能设置为零。 | -| ORA-17033 | 出现格式不正确的 SQL92 串。 | -| ORA-17034 | 出现不支持的 SQL92 标记。 | -| ORA-17035 | 不支持的字符集 !! | -| ORA-17036 | OracleNumber 中的异常。 | -| ORA-17037 | 不能在 UTF8 和 UCS2 之间转换。 | -| ORA-17038 | 字节数组不够长。 | -| ORA-17039 | CHAR 数组不够长。 | -| ORA-17040 | 必须在连接 URL 中指定子协议。 | -| ORA-17041 | 索引中丢失 `IN` 或 `OUT` 参数。 | -| ORA-17042 | 无效的批值。 | -| ORA-17043 | 流的最大长度无效。 | -| ORA-17044 | 内部错误: 未分配数据数组。 | -| ORA-17045 | 内部错误: 试图访问批值之外的绑定值。 | -| ORA-17046 | 内部错误: 数据访问的索引无效。 | -| ORA-17047 | 分析类型描述符时出错。 | -| ORA-17048 | 未定义的类型。 | -| ORA-17049 | 不一致的 Java 和 SQL 对象类型。 | -| ORA-17050 | 矢量中没有这样的元素。 | -| ORA-17051 | 此 API 不能用于非 UDT 类型。 | -| ORA-17052 | 此 `ref` 无效。 | -| ORA-17053 | 长度无效。 | -| ORA-17054 | LOB 定位器无效。 | -| ORA-17055 | 遇到无效字符。 | -| ORA-17056 | 不支持的字符集 (在类路径中添加 `orai18n.jar`)。 | -| ORA-17057 | 关闭的 LOB。 | -| ORA-17058 | 内部错误: 无效的 NLS 转换率。 | -| ORA-17059 | 无法转换为内部表示。 | -| ORA-17060 | 无法构造描述符。 | -| ORA-17061 | 丢失描述符。 | -| ORA-17062 | Ref 游标无效。 | -| ORA-17063 | 不在事务处理中。 | -| ORA-17064 | 无效的语法或数据库名为空。 | -| ORA-17065 | 转换类为空。 | -| ORA-17066 | 访问层需要具体实施。 | -| ORA-17067 | 指定了无效的 URL。 | -| ORA-17068 | 调用中的无效参数。 | -| ORA-17069 | 使用明确的 XA 调用。 | -| ORA-17070 | 数据大小超出此类型的最大值。 | -| ORA-17071 | 超出 VARRAY 的最大限制。 | -| ORA-17072 | 插入列的值过大。 | -| ORA-17074 | 无效的名称模式。 | -| ORA-17075 | 对只转发结果集的无效操作。 | -| ORA-17076 | 对只读结果集的无效操作。 | -| ORA-17077 | 无法设置 REF 值。 | -| ORA-17078 | 无法进行该操作,因为连接已打开。 | -| ORA-17079 | 用户身份证明与现有身份证明不匹配。 | -| ORA-17080 | 无效的批处理命令。 | -| ORA-17081 | 批处理中出现错误。 | -| ORA-17082 | 没有当前行。 | -| ORA-17083 | 不在插入的行上。 | -| ORA-17084 | 访问插入行。 | -| ORA-17085 | 出现值冲突。 | -| ORA-17086 | 插入行上的未定义列值。 | -| ORA-17087 | 可忽略的性能提示: `setFetchDirection()`。 | -| ORA-17088 | 不支持所请求的结果集类型和并发级别的语法不受支持。 | -| ORA-17089 | 内部错误。 | -| ORA-17090 | 不允许的操作。 | -| ORA-17091 | 在所请求的类型和 (或) 并发级别无法创建结果集。 | -| ORA-17092 | 无法在调用处理操作结束时创建或执行 JDBC 语句。 | -| ORA-17094 | 对象类型版本不匹配。 | -| ORA-17095 | 未设置语句缓存大小。 | -| ORA-17096 | 不能为此逻辑连接启用语句缓存。 | -| ORA-17097 | PL 索引表的元素类型无效。 | -| ORA-17098 | 空 LOB 操作无效。 | -| ORA-17099 | PL 索引表数组长度无效。 | -| ORA-17100 | 数据库 Java 对象无效。 | -| ORA-17103 | 通过 `getConnection` 返回的连接类型无效。改用 `getJavaSqlConnection`。 | -| ORA-17104 | 要执行的 SQL 语句不得为空或 Null。 | -| ORA-17105 | 未设置连接会话时区。 | -| ORA-17107 | 指定的代理类型无效。 | -| ORA-17108 | 没有在 `defineColumnType` 中指定最大长度。 | -| ORA-17109 | 找不到标准 Java 字符编码。 | -| ORA-17110 | 执行完毕,但带有警告。 | -| ORA-17111 | 指定的连接缓存 TTL 超时时间无效。 | -| ORA-17112 | 指定的线程时间间隔无效。 | -| ORA-17113 | 线程时间间隔值大于高缓存超时值。 | -| ORA-17114 | 无法在全局事务中使用本地事务提交。 | -| ORA-17115 | 无法在全局事务中使用本地事务回退。 | -| ORA-17116 | 无法在活跃的全局事务中启用自动提交功能。 | -| ORA-17117 | 无法在活跃的全局事务处理中设置保存点。 | -| ORA-17118 | 法获取已命名保存点的 ID。 | -| ORA-17119 | 无法获取未命名保存点的名称。 | -| ORA-17120 | 无法设置启用了自动提交功能的保存点。 | -| ORA-17121 | 无法回退到启用了自动提交功能的保存点。 | -| ORA-17122 | 无法在全局事务中回滚到本地 txn 保存点。 | -| ORA-17123 | 指定的语句缓存大小无效。 | -| ORA-17124 | 指定的连接缓存失活超时时间无效。 | -| ORA-17125 | 显式缓存返回了不正确的语句类型。 | -| ORA-17126 | 固定等待超时时间已过。 | -| ORA-17127 | 指定的固定等待超时时间无效。 | -| ORA-17128 | SQL 字符串不是查询。 | -| ORA-17129 | SQL 字符串不是 DML 语句。 | -| ORA-17132 | 请求的转换无效。 | -| ORA-17133 | `UNUSED`。 | -| ORA-17134 | SQL 中命名参数的长度超过 32 个字符。 | -| ORA-17135 | `setXXXStream` 中使用的参数名在 SQL 中出现多次 | -| ORA-17136 | 格式错误的 DATALINK URL,请尝试使用 `getString()`。 | -| ORA-17137 | 连接高速缓存未启用,或者不是启用缓存的有效数据源。 | -| ORA-17138 | 连接缓存名称无效。必须是有效的字符串并且是唯一的。 | -| ORA-17139 | 连接缓存属性无效。 | -| ORA-17140 | 具有此名称的连接缓存已存在。 | -| ORA-17141 | 具有此名称的连接缓存不存在。 | -| ORA-17142 | 具有此缓存名称的连接缓存已禁用。 | -| ORA-17143 | 在连接缓存中找到的连接无效或已过时。 | -| ORA-17144 | 未执行语句句柄。 | -| ORA-17145 | 接收到的 ONS 事件无效。 | -| ORA-17146 | 接收到的 ONS 事件版本无效。 | -| ORA-17147 | SQL 试图设置未出现在 SQL 中的参数名。 | -| ORA-17149 | 这已经是代理会话。 | -| ORA-17150 | 代理会话的参数错误。 | -| ORA-17151 | Clob 太大,无法存储在 Java 字符串中。 | -| ORA-17152 | 此方法仅在逻辑连接中实施。 | -| ORA-17153 | 此方法仅在物理连接中实施。 | -| ORA-17156 | 数组大小对于端对端的度量值无效。 | -| ORA-17157 | `setString` 只能处理少于 32766 个字符的字符串。 | -| ORA-17158 | 持续时间对该函数无效。 | -| ORA-17159 | 要执行端对端跟踪的度量值太长。 | -| ORA-17160 | 执行上下文 ID 序列号超出范围。 | -| ORA-17161 | 使用的交易模式无效。 | -| ORA-17162 | 不支持的 `holdability` 值。 | -| ORA-17163 | 无法在启用连接缓存时使用 `getXAConnection()`。 | -| ORA-17164 | 无法在启用了缓存的情况下从物理连接调用 `getXAResource()`。 | -| ORA-17165 | 服务器中不存在此连接的 `PRIVATE_JDBC` 包。 | -| ORA-17166 | 无法提取 PL 语句。 | -| ORA-17167 | 找不到 PKI 类。要使用 `connect/` 功能,`oraclepki.jar` 必须位于类路径中。 | -| ORA-17168 | 密钥存储遇到问题。请在打开的 Wallet (`cwallet.sso`) 时检查 Wallet 的位置并使用 `mkstore` 实用程序确保此 Wallet 包含正确的身份证明。 | -| ORA-17169 | 无法将流绑定到 `ScrollableResultSet` 或 `UpdatableResultSet`。 | -| ORA-17170 | 名称空间不能为空。 | -| ORA-17171 | 属性长度不能超过 30 个字符。 | -| ORA-17172 | 属性的值不能超过 400 个字符。 | -| ORA-17173 | 并非所有返回参数都已注册。 | -| ORA-17174 | 唯一受支持的名称空间是 `CLIENTCONTEXT`。 | -| ORA-17175 | 配置远程 ONS 期间出错。 | -| ORA-17259 | SQLXML 在类路径中找不到 XML 支持的 jar 文件。 | -| ORA-17260 | 尝试读取一个空的 SQLXML。 | -| ORA-17261 | 尝试读取不可读的 SQLXML。 | -| ORA-17262 | 尝试编写不可写的 SQLXML。 | -| ORA-17263 | SQLXML 无法创建该类型的结果。 | -| ORA_17264 | SQLXML 不能创建该类型的源。 | - - diff --git a/docs/docs/docs-cn/9.jdbc-developer-s-guide/3.features-specific-to-oracle-mode/7.data-types-supported-in-oracle-mode.md b/docs/docs/docs-cn/9.jdbc-developer-s-guide/3.features-specific-to-oracle-mode/7.data-types-supported-in-oracle-mode.md deleted file mode 100644 index b44249146..000000000 --- a/docs/docs/docs-cn/9.jdbc-developer-s-guide/3.features-specific-to-oracle-mode/7.data-types-supported-in-oracle-mode.md +++ /dev/null @@ -1,123 +0,0 @@ -Oracle 模式支持的数据类型 -===================================== - -Oracle 模式所支持的数据类型如下列表所示。 - -* 字符型 - - * VARCHAR2 - - - - * NVARCHAR2 - - - - * CHAR - - - - * NCHAR - - - - - - - - - - - -* 数字类型支持 - - * NUMBER - - - - * NUMBER_FLOAT - - - - * BINARY_FLOAT - - - - * BINARY_DOUBLE - - - - - - - - - - - -* 复杂数据类型 - - * Ref Cursor - - - - * Struct - - - - * Array - - - - * RAW - - - - * RowId - - - - - - - - - - - -* 日期型 - - * DATE - - - - * TIMESTAMP - - - - * TIMESTAMP WITH TIME ZONE - - - - * TIMESTAMP WITH LOCAL TIME ZONE - - - - * INTERVAL - - - - * INTERVALDS - - - - * INTERVALYM - - - - - - - - -