CREATE SCHEMA
功能概述
CREATE SCHEMA
CREATE SCHEMA
语句用于在当前 workspace 下创建一个新的 schema（数据模式）。schema 是 Lakehouse 对象（表、视图、函数等）的逻辑命名空间，用于对数据进行分组管理。
语法
CREATE SCHEMA [ IF NOT EXISTS ] schema_name [ COMMENT 'comment' ];
参数说明
| 参数 | 是否必填 | 说明 |
|---|
schema_name
schema_name | 是 | 新建 schema 的名称，在同一 workspace 下必须唯一 |
IF NOT EXISTS
IF NOT EXISTS | 否 | 若 schema 已存在则跳过，不报错 |
COMMENT 'comment'
COMMENT 'comment' | 否 | 为 schema 添加描述性注释 |
使用示例
示例 1：创建基本 schema
CREATE SCHEMA sales_data;
示例 2：创建带注释的 schema
CREATE SCHEMA customer_data COMMENT '客户相关数据';
示例 3：使用 IF NOT EXISTS 避免重复创建报错
CREATE SCHEMA IF NOT EXISTS doc_test_qiliang COMMENT '文档测试用 schema';
执行后使用
SHOW SCHEMAS
SHOW SCHEMAS
验证创建结果：
SHOW SCHEMAS;
返回示例（部分）：
+------------------+
| schema_name |
+------------------+
| doc_test |
| doc_test_qiliang |
| public |
+------------------+
示例 4：查看 schema 详细信息
DESC SCHEMA doc_test;
返回示例：
+--------------------+--------------------------------------+
| info_name | info_value |
+--------------------+--------------------------------------+
| name | doc_test |
| creator | qiliang |
| created_time | 2026-05-19 20:16:36.263 |
| last_modified_time | 2026-05-19 22:53:21.766 |
| comment | 文档验证专用测试 schema，可随时清理 |
| type | managed |
+--------------------+--------------------------------------+
注意事项
- schema 名称在同一 workspace 下必须唯一，重复创建会报错，建议使用
IF NOT EXISTS
IF NOT EXISTS
。
- schema 名称支持字母、数字和下划线，不区分大小写，建议使用小写字母。
- 创建 schema 后，可使用
ALTER SCHEMA
ALTER SCHEMA
修改注释或属性，使用 DROP SCHEMA
DROP SCHEMA
删除。
权限要求
执行
CREATE SCHEMA
CREATE SCHEMA
的用户需要具备在当前 workspace 下创建 schema 的权限。
