SHOW EXTERNAL SCHEMAS
功能概述
SHOW SCHEMAS EXTENDED
SHOW SCHEMAS EXTENDED
语句用于查看当前 workspace 下的 schema 列表,并通过
EXTENDED
EXTENDED
关键字显示每个 schema 的类型(托管或外部)。结合
WHERE
WHERE
子句可筛选出外部 schema。
语法
SHOW SCHEMAS [ EXTENDED [ WHERE expr ] ];
参数说明
| 参数 | 是否必填 | 说明 |
|---|
EXTENDED
EXTENDED | 否 | 在结果中增加 type
type 列,显示 schema 类型 |
WHERE expr
WHERE expr | 否 | 按返回列进行过滤,仅在使用 EXTENDED
EXTENDED 时有效 |
返回列说明
不带 EXTENDED
| 列名 | 类型 | 说明 |
|---|
schema_name
schema_name | STRING | schema 名称 |
带 EXTENDED
| 列名 | 类型 | 说明 |
|---|
schema_name
schema_name | STRING | schema 名称 |
type
type | STRING | schema 类型:managed
managed (托管)、external
external (外部)、shared
shared (共享) |
使用示例
示例 1:查看所有 schema
SHOW SCHEMAS;
返回示例:
+------------------+
| schema_name |
+------------------+
| doc_test |
| information_schema |
| public |
+------------------+
示例 2:查看所有 schema 及其类型
SHOW SCHEMAS EXTENDED;
返回示例:
+--------------------+---------+
| schema_name | type |
+--------------------+---------+
| doc_test | managed |
| information_schema | shared |
| public | managed |
+--------------------+---------+
示例 3:筛选外部 schema
SHOW SCHEMAS EXTENDED WHERE type = 'external';
返回示例(存在外部 schema 时):
+--------------------+----------+
| schema_name | type |
+--------------------+----------+
| my_external_schema | external |
+--------------------+----------+
示例 4:筛选托管 schema
SHOW SCHEMAS EXTENDED WHERE type = 'managed';
返回示例(部分):
+------------------+---------+
| schema_name | type |
+------------------+---------+
| doc_test | managed |
| public | managed |
+------------------+---------+
注意事项
WHERE
WHERE
子句只能引用 EXTENDED
EXTENDED
模式下返回的列(schema_name
schema_name
、type
type
)。
type
type
的可能取值为 managed
managed
(托管 schema)、external
external
(外部 schema)、shared
shared
(通过 SHARE 引入的共享 schema)。
- 若当前 workspace 下没有外部 schema,
WHERE type='external'
WHERE type='external'
将返回空结果集。