.create-merge tables 命令
允许你在特定数据库的上下文中，通过单个批量操作创建和扩展现有表的架构。
权限
此命令需要数据库用户权限，以及用来扩展现有表的表管理员权限。
语法
.create-mergetablestableName1(columnName:columnType [, ...]) [,tableName2(columnName:columnType [, ...]) ... ] [with(propertyName=propertyValue [, ...])]
详细了解语法约定。
参数
| 客户 | 类型 | 必需 | 说明 |
|---|---|---|---|
| tableName | string |
✔ | 要创建或扩展的表的名称。 |
| columnName, columnType | string |
✔ | 映射到该列中数据类型的现有列或新列的名称。 映射列表定义输出列架构。 |
| propertyName, propertyValue | string |
键值属性对的逗号分隔列表。 请参阅支持的属性。 |
支持的属性
| 名称 | Type | 描述 |
|---|---|---|
docstring |
string |
描述要添加的实体的自由文本。 此字符串显示在实体名称旁边的各种 UX 设置中。 |
folder |
string |
要添加到表的文件夹的名称。 |
返回
- 将创建不存在的指定表。
- 已存在的指定表将扩展其架构。
- 不存在的列将添加到现有表架构的末尾。
- 此命令中未指定的现有列不会从现有表的架构中删除。
- 命令中使用与现有表架构中的数据类型不同的数据类型指定的现有列导致失败。 未创建任何表。
示例
.create-merge tables
MyLogs (Level:string, Timestamp:datetime, UserId:string, TraceId:string, Message:string, ProcessId:int32),
MyUsers (UserId:string, Name:string)
输出
| tableName | DatabaseName | 文件夹 | DocString |
|---|---|---|---|
| MyLogs | TopComparison | ||
| MyUsers | TopComparison |