You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@shardingsphere.apache.org by me...@apache.org on 2021/02/02 08:58:02 UTC
[shardingsphere] branch master updated: Move RDL to distSQL menu
(#9264)
This is an automated email from the ASF dual-hosted git repository.
menghaoran pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/shardingsphere.git
The following commit(s) were added to refs/heads/master by this push:
new 750d8e4 Move RDL to distSQL menu (#9264)
750d8e4 is described below
commit 750d8e44190738460a9cb447b55850a6b36f869e
Author: Liang Zhang <te...@163.com>
AuthorDate: Tue Feb 2 16:57:39 2021 +0800
Move RDL to distSQL menu (#9264)
* Move RDL to distSQL menu
* Add RQL page
* Update index
* Update index
---
.../content/features/dist-sql/_index.cn.md | 4 ++++
.../content/features/dist-sql/_index.en.md | 4 ++++
.../{sharding/use-norms => dist-sql}/rdl.cn.md | 11 +++++------
.../{sharding/use-norms => dist-sql}/rdl.en.md | 11 ++++++-----
docs/document/content/features/dist-sql/rql.cn.md | 10 ++++++++++
docs/document/content/features/dist-sql/rql.en.md | 10 ++++++++++
.../features/sharding/use-norms/parser.cn.md | 23 ----------------------
.../features/sharding/use-norms/parser.en.md | 23 ----------------------
8 files changed, 39 insertions(+), 57 deletions(-)
diff --git a/docs/document/content/features/dist-sql/_index.cn.md b/docs/document/content/features/dist-sql/_index.cn.md
index 46c6825..0a13a66 100644
--- a/docs/document/content/features/dist-sql/_index.cn.md
+++ b/docs/document/content/features/dist-sql/_index.cn.md
@@ -25,3 +25,7 @@ DistSQL 划分为 RDL、RQL 和 SCTL 这三种具体类型。
## 目标
**打破中间件和数据库之间的界限，让开发者像使用数据库一样使用 Apache ShardingSphere，是 DistSQL 的设计目标。**
+
+## 注意事项
+
+DistSQL 只能用于 ShardingSphere-Proxy，ShardingSphere-JDBC 暂不提供。
diff --git a/docs/document/content/features/dist-sql/_index.en.md b/docs/document/content/features/dist-sql/_index.en.md
index 9473f20..f6c15bd 100644
--- a/docs/document/content/features/dist-sql/_index.en.md
+++ b/docs/document/content/features/dist-sql/_index.en.md
@@ -25,3 +25,7 @@ DistSQL is divided into RDL, RQL and SCTL.
## Goal
**It is the design goal of DistSQL to break the boundary between middleware and database and let developers use Apache ShardingSphere just like database.**
+
+## Notice
+
+DistSQL can use for ShardingSphere-Proxy only, not for ShardingSphere-JDBC now.
diff --git a/docs/document/content/features/sharding/use-norms/rdl.cn.md b/docs/document/content/features/dist-sql/rdl.cn.md
similarity index 86%
rename from docs/document/content/features/sharding/use-norms/rdl.cn.md
rename to docs/document/content/features/dist-sql/rdl.cn.md
index 2609ebc..da44ebb 100644
--- a/docs/document/content/features/sharding/use-norms/rdl.cn.md
+++ b/docs/document/content/features/dist-sql/rdl.cn.md
@@ -1,14 +1,13 @@
+++
title = "RDL"
-weight = 4
+weight = 1
+++
-## 什么是 RDL?
+## 定义
-RDL（Rule Definition Language）是ShardingSphere特有的内置SQL语言。用户可以使用RDL语言向SharidngSphere注入数据源资源、创建分片规则等，即向ShardingSphere注入数据库资源信息和分片规则信息。
-RDL使得用户抛弃对传统Yaml或其他配置文件的依赖，像使用数据库一样，通过SQL进行资源信息的注入和规则的配置。
+RDL（Resource & Rule Definition Language）用于定义数据源资源、创建规则等。
-当前，RDL主要包括以下SQL内容：
+RDL 主要包括以下 SQL 内容：
- `Create DATASOURCES`，用于注入数据源信息。
@@ -44,7 +43,7 @@ t_item=mod(item_id, 2)
)
```
-## RDL使用实战
+## 使用实战
### 前置工作
diff --git a/docs/document/content/features/sharding/use-norms/rdl.en.md b/docs/document/content/features/dist-sql/rdl.en.md
similarity index 91%
rename from docs/document/content/features/sharding/use-norms/rdl.en.md
rename to docs/document/content/features/dist-sql/rdl.en.md
index 5bf5fb4..8220be3 100644
--- a/docs/document/content/features/sharding/use-norms/rdl.en.md
+++ b/docs/document/content/features/dist-sql/rdl.en.md
@@ -1,13 +1,14 @@
+++
title = "RDL"
-weight = 4
+weight = 1
+++
-## What's the RDL?
-RDL means rule definition language to create your distributed DBs, tables by SQL. In other words, this is a specific SQLs for ShardingSphere to inject some configurations.
-By means of RDL, users could inject data sources and configure sharding rules by SQL.
+## Definition
+
+RDL（Resource & Rule Definition Language）is used to define data resources and rules.
At present, there are the following RDLs,
+
- `Create DATASOURCES` to add database resources to ShardingSphere
```sql
@@ -42,7 +43,7 @@ t_item=mod(item_id, 2)
)
```
-## A common scenario for RDL
+## Usage
### Pre-work
diff --git a/docs/document/content/features/dist-sql/rql.cn.md b/docs/document/content/features/dist-sql/rql.cn.md
new file mode 100644
index 0000000..349ac5c
--- /dev/null
+++ b/docs/document/content/features/dist-sql/rql.cn.md
@@ -0,0 +1,10 @@
++++
+title = "RQL"
+weight = 2
++++
+
+## 定义
+
+RDL（Resource & Rule Query Language）用于查询已有的数据源资源和规则。
+
+TODO
diff --git a/docs/document/content/features/dist-sql/rql.en.md b/docs/document/content/features/dist-sql/rql.en.md
new file mode 100644
index 0000000..1bcd10f
--- /dev/null
+++ b/docs/document/content/features/dist-sql/rql.en.md
@@ -0,0 +1,10 @@
++++
+title = "RQL"
+weight = 2
++++
+
+## Definition
+
+RDL（Resource & Rule Query Language）is used to query existed data sources and rules.
+
+TODO
diff --git a/docs/document/content/features/sharding/use-norms/parser.cn.md b/docs/document/content/features/sharding/use-norms/parser.cn.md
deleted file mode 100644
index afbe8a3..0000000
--- a/docs/document/content/features/sharding/use-norms/parser.cn.md
+++ /dev/null
@@ -1,23 +0,0 @@
-+++
-title = "解析器"
-weight = 3
-+++
-
-ShardingSphere使用不同解析器支持SQL多种方言。对于未实现解析器的特定SQL方言，默认采用SQL92标准进行解析。
-
-## 特定SQL方言解析器
-
-* PostgreSQL解析器
-* MySQL解析器
-* Oracle解析器
-* SQLServer解析器
-
-注：MySQL解析器支持的方言包括MySQL、H2和MariaDB。
-
-## 默认SQL方言解析器
-
-其他SQL方言，如SQLite、Sybase、DB2和Informix等，默认采用SQL92标准进行解析。
-
-## RDL(Rule definition Language)方言解析器
-
-ShardingSphere独有的RDL方言解析器。该解析器主要解析ShardingSphere内部的RDL方言，即自定义的SQL。请查阅[RDL](/cn/features/sharding/concept/rdl/)了解详情。
\ No newline at end of file
diff --git a/docs/document/content/features/sharding/use-norms/parser.en.md b/docs/document/content/features/sharding/use-norms/parser.en.md
deleted file mode 100644
index b0e4704..0000000
--- a/docs/document/content/features/sharding/use-norms/parser.en.md
+++ /dev/null
@@ -1,23 +0,0 @@
-+++
-title = "Parser"
-weight = 3
-+++
-
-ShardingSphere supports multiple dialects of SQL using different parsers. For specific SQL dialects that do not implement parsers, the default is to use the SQL92 standard for parsing.
-
-## Specific SQL dialect parser
-
-* PostgreSQL parser
-* MySQL parser
-* Oracle parser
-* SQLServer parser
-
-Note: MySQL parser supports MySQL, H2, and MariDB dialect.
-
-## Default SQL dialect parser
-
-Other SQL dialects, such as SQLite, Sybase, DB2 and Informix, are parsed by default using the standard of SQL92.
-
-## RDL(Rule definition Language) dialect parser
-
-This is a particular parser for ShardingSphere, which mainly to parse the RDL, namely ShardingSphere-defined SQL. [RDL](/en/features/sharding/concept/rdl/) will show you more.