CREATE 命令参考

功能概述

在云器 Lakehouse 中创建各类 Lakehouse 对象。

语法

CREATE <object_type> [ IF NOT EXISTS ] <object_name> [ COMMENT '<string_literal>' ]

参数说明

参数	说明	是否必填
`<object_type>` <object_type>	要创建的对象类型，如 `TABLE` TABLE 、 `VIEW` VIEW 、 `SCHEMA` SCHEMA 等	是
`IF NOT EXISTS` IF NOT EXISTS	对象已存在时静默跳过，不报错	否
`<object_name>` <object_name>	对象名称，可包含 schema 前缀	是
`COMMENT` COMMENT	对象描述信息	否

支持的对象类型

对象类型	语法示例	说明
普通表	`CREATE TABLE <name> (col1 TYPE, ...)` CREATE TABLE <name> (col1 TYPE, ...)	结构化二维数据
外部表	`CREATE EXTERNAL TABLE <name> USING <format>` CREATE EXTERNAL TABLE <name> USING <format>	数据存储在外部系统
视图	`CREATE VIEW <name> AS SELECT ...` CREATE VIEW <name> AS SELECT ...	虚拟表，不存储数据
动态表	`CREATE DYNAMIC TABLE <name> REFRESH INTERVAL ...` CREATE DYNAMIC TABLE <name> REFRESH INTERVAL ...	自动增量刷新的数据对象
物化视图	`CREATE MATERIALIZED VIEW <name> AS SELECT ...` CREATE MATERIALIZED VIEW <name> AS SELECT ...	预计算查询结果
Table Stream	`CREATE TABLE STREAM <name> ON TABLE <table>` CREATE TABLE STREAM <name> ON TABLE <table>	捕获表级变更（CDC）
Schema	`CREATE SCHEMA <name>` CREATE SCHEMA <name>	命名空间
外部 Schema	`CREATE EXTERNAL SCHEMA <name> CONNECTION <conn>` CREATE EXTERNAL SCHEMA <name> CONNECTION <conn>	挂载外部 Schema
外部 Catalog	`CREATE EXTERNAL CATALOG <name> CONNECTION <conn>` CREATE EXTERNAL CATALOG <name> CONNECTION <conn>	挂载外部目录
连接	`CREATE STORAGE/CATALOG/API CONNECTION <name> ...` CREATE STORAGE/CATALOG/API CONNECTION <name> ...	存储/目录/API 连接配置
管道	`CREATE PIPE <name> ... AS COPY INTO ...` CREATE PIPE <name> ... AS COPY INTO ...	持续数据导入管道
计算集群	`CREATE VCLUSTER <name> ...` CREATE VCLUSTER <name> ...	虚拟计算集群
数据分享	`CREATE SHARE <name>` CREATE SHARE <name>	跨实例数据共享
同义词	`CREATE SYNONYM <name> FOR <object>` CREATE SYNONYM <name> FOR <object>	对象别名
SQL 函数	`CREATE SQL FUNCTION <name> AS ...` CREATE SQL FUNCTION <name> AS ...	用户自定义 SQL 函数
外部函数	`CREATE EXTERNAL FUNCTION <name> ...` CREATE EXTERNAL FUNCTION <name> ...	调用外部服务的函数
用户	`CREATE USER <name> ...` CREATE USER <name> ...	系统用户
角色	`CREATE ROLE <name>` CREATE ROLE <name>	权限角色

权限要求

执行

CREATE

CREATE

操作需要对目标 Schema 或工作空间具有相应的创建权限（如

CREATE TABLE

CREATE TABLE

、

CREATE VIEW

CREATE VIEW

等），具体权限要求参见各对象类型的语法文档。

注意事项

大多数
```
CREATE
```
CREATE
语句支持
```
IF NOT EXISTS
```
IF NOT EXISTS
子句，适合在脚本或自动化流程中使用
创建对象时可通过
```
COMMENT
```
COMMENT
子句附加描述信息
不同对象类型有各自的必填参数和可选参数，详见下方语法参考

CREATE 命令参考

功能概述

语法

参数说明

支持的对象类型

权限要求

注意事项

语法参考

数据对象

索引与同义词

Schema 与 Catalog

连接与管道

计算与共享

函数

用户与权限