.create-merge table 命令

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

创建新表或扩展现有表。

此命令必须在特定数据库的上下文中运行。

权限

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

语法

.create-merge table tableName(columnName:columnType [, ...]) [with(propertyName=propertyValue [, ...])]

详细了解语法约定

参数

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

支持的属性

客户 类型 说明
docstring string 描述要添加的实体的自由文本。 此字符串显示在实体名称旁边的各种 UX 设置中。
folder string 要添加到表的文件夹的名称。

返回

如果该表不存在,则其功能与 .create table 命令完全相同。

如果表 T 存在并且你发送了 .create-merge table T (<columns specification>) 命令,则:

  • 先前不在 T 中存在的 <列规范> 中的任何列都将添加到 T 的架构的末尾。
  • 在 T 中但不在 <列规范> 中的任何列都不会被从 T 中删除。
  • 在 T 中存在的 <列规范> 中的任何列,但使用不同的数据类型将导致命令失败。