.create table based-on 命令
适用于:✅Azure 数据资源管理器
基于现有表创建新的空表。 此命令必须在特定数据库的上下文中运行。
权限
你必须至少具有数据库管理员权限才能运行此命令。
语法
.create
table
tableName based-on
otherTable [ifnotexists
] [with
(
propertyName =
propertyValue [,
...])
]
详细了解语法约定。
参数
客户 | 类型 | 必需 | 说明 |
---|---|---|---|
ifnotexists |
string |
如果指定此项,则只有在表不存在的情况下,才会创建表。 | |
tableName | string |
✔️ | 要创建的表的名称。 该区分大小写的名称在数据库中必须唯一。 |
otherTable | string |
✔️ | 要用作所创建表的列、docstring 和文件夹的源的现有表的名称。 |
propertyName, propertyValue | string |
键值属性对的逗号分隔列表。 请参阅支持的属性。 |
支持的属性
名称 | Type | 描述 |
---|---|---|
docstring |
string |
描述要添加的实体的自由文本。 此字符串显示在实体名称旁边的各种 UX 设置中。 默认值是基于 <tableName> 创建的。 |
folder |
string |
要将表添加到的文件夹的名称。 默认值是与 tableName 相同的文件夹。 |
返回
此命令以 JSON 格式返回新表的架构,类似于运行以下命令:
.show table MyLogs schema as json
注意
- 如果表已存在:
- 如果指定了
ifnotexists
标志,则该命令将被忽略(不应用更改)。 - 如果未指定
ifnotexists
标志,则将返回错误。
- 如果指定了
示例
.create table MyLogs_Temp based-on MyLogs with (folder="TempTables")