你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

.create table 命令

  • 项目

创建新的空表。

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

权限

你必须至少具有数据库用户权限才能运行此命令。

语法

.createtabletableName(columnName:columnType [, ...]) [with(propertyName=propertyValue [, ...])]

详细了解语法约定。

参数

名称 类型 必需 说明
tableName string ✔️ 要创建的表的名称。
columnName, columnType string ✔️ 映射到该列中数据类型的列的名称。 这些映射的列表定义了输出列架构。
propertyName, propertyValue string 键值属性对的逗号分隔列表。 请参阅支持的属性。

支持的属性

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

注意

如果数据库的上下文中已存在具有相同名称（区分大小写）的表，则命令将返回成功，且不会更改现有表，即使在以下情况下也是如此：

  • 指定的架构与现有表的架构不匹配
  • 为 folder 或 docstring 参数指定了与表中设置的值不同的值

示例

.create table MyLogs ( Level:string, Timestamp:datetime, UserId:string, TraceId:string, Message:string, ProcessId:int32 )

输出

以 JSON 格式返回表的架构，与下面的命令相同：

.show table MyLogs schema as json

注意

若要创建多个表，请使用 .create tables 命令以提高性能并降低群集负载。