.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")