[FLINK-23028][docs] Improve documentation for pages of SQL

This closes apache#16070
derekm · Jun 25, 2021 · b116a4e · b116a4e
1 parent e8b7f3d
commit b116a4e
Show file tree

Hide file tree

Showing 4 changed files with 30 additions and 4 deletions.
diff --git a/docs/content.zh/docs/dev/table/sql/drop.md b/docs/content.zh/docs/dev/table/sql/drop.md
@@ -28,10 +28,11 @@ under the License.
 
 
 
-DROP 语句用于从当前或指定的 [Catalog]({{< ref "docs/dev/table/catalogs" >}}) 中删除一个已经注册的表、视图或函数。
+DROP 语句可用于删除指定的 catalog，也可用于从当前或指定的 [Catalog]({{< ref "docs/dev/table/catalogs" >}}) 中删除一个已经注册的表、视图或函数。
 
 Flink SQL 目前支持以下 DROP 语句：
 
+- DROP CATALOG
 - DROP TABLE
 - DROP DATABASE
 - DROP VIEW
@@ -146,6 +147,18 @@ Flink SQL> SHOW TABLES;
 {{< /tab >}}
 {{< /tabs >}}
 
+## DROP CATALOG
+
+```sql
+DROP CATALOG [IF EXISTS] catalog_name
+```
+
+删除给定名字的 catalog。
+
+**IF EXISTS**
+
+如果目标 catalog 不存在，则不会执行任何操作。
+
 ## DROP TABLE
 
 ```sql

diff --git a/docs/content.zh/docs/dev/table/sql/use.md b/docs/content.zh/docs/dev/table/sql/use.md
@@ -243,7 +243,7 @@ Flink SQL> SHOW FULL MODULES;
 
 {{< top >}}
 
-## USE CATLOAG
+## USE CATALOG
 
 ```sql
 USE CATALOG catalog_name

diff --git a/docs/content/docs/dev/table/sql/drop.md b/docs/content/docs/dev/table/sql/drop.md
@@ -26,10 +26,11 @@ under the License.
 
 # DROP Statements
 
-DROP statements are used to remove a registered table/view/function from current or specified [Catalog]({{< ref "docs/dev/table/catalogs" >}}).
+DROP statements are used to remove a catalog with the given catalog name or to remove a registered table/view/function from the current or specified [Catalog]({{< ref "docs/dev/table/catalogs" >}}).
 
 Flink SQL supports the following DROP statements for now:
 
+- DROP CATALOG
 - DROP TABLE
 - DROP DATABASE
 - DROP VIEW
@@ -138,6 +139,18 @@ Flink SQL> SHOW TABLES;
 {{< /tab >}}
 {{< /tabs >}}
 
+## DROP CATALOG
+
+```sql
+DROP CATALOG [IF EXISTS] catalog_name
+```
+
+Drop a catalog with the given catalog name.
+
+**IF EXISTS**
+
+If the catalog does not exist, nothing happens.
+
 ## DROP TABLE
 
 ```sql

diff --git a/docs/content/docs/dev/table/sql/use.md b/docs/content/docs/dev/table/sql/use.md
@@ -244,7 +244,7 @@ Flink SQL> SHOW FULL MODULES;
 
 {{< top >}}
 
-## USE CATLOAG
+## USE CATALOG
 
 ```sql
 USE CATALOG catalog_name