Share via

.create table based-on 命令

  • 项目

基于现有表创建新的空表。 此命令必须在特定数据库的上下文中运行。

注意

源表的所有属性都将复制到新表中，但以下情况除外：

权限

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

语法

.createtabletableNamebased-onotherTable [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")