.create-merge tables 命令

使用 “版本 ”下拉列表切换服务。 了解有关导航的详细信息
适用于:✅ Azure Data Explorer

允许你在特定数据库的上下文中,通过单个批量操作创建和扩展现有表的架构。

权限

此命令需要 Database User 权限,以及用于扩展现有表的 Table Admin 权限。

语法

.create-merge tables tableName1(columnName:columnType [, ...]) [,tableName2(columnName:columnType [, ...]) ... ][with(propertyName=propertyValue [, ...])]

详细了解语法约定

参数

客户 类型 必需 说明
tableName string ✔️ 要创建或扩展的表的名称。
columnNamecolumnType string ✔️ 映射到该列中数据类型的现有列或新列的名称。 映射列表定义输出列架构。
propertyName、propertyValue string 键值属性对的逗号分隔列表。 请参阅支持的属性

支持的属性

客户 类型 说明
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