.create table based-on コマンド
既存のテーブルに基づいて新しい空のテーブルを作成します。 このコマンドは、特定のデータベースのコンテキストで実行する必要があります。
Note
ソース テーブルのすべてのプロパティが新しいテーブルにコピーされますが、次の例外があります。
- 更新ポリシー
- 承認されたプリンシパル:
.create table based-on
コマンドを使用すると、現在のプリンシパルがテーブル管理者に追加されます。
アクセス許可
このコマンドを実行するには、少なくとも Database Admin アクセス許可が必要です。
構文
.create
table
tableName based-on
otherTable [ifnotexists
] [with
(
propertyName =
propertyValue [,
...])
]
構文規則について詳しく知る。
パラメーター
件名 | タイプ | Required | 説明 |
---|---|---|---|
ifnotexists |
string |
指定した場合、テーブルは存在しない場合にのみ作成されます。 | |
tableName | string |
✔️ | 作成するテーブルの名前です。 大文字と小文字を区別する名前は、データベース内で一意である必要があります。 |
otherTable | string |
✔️ | 作成するテーブルの列、docstring、およびフォルダーのソースとして使用する既存のテーブルの名前。 |
propertyName, propertyValue | string |
キーと値のプロパティのペアのコンマ区切りのリスト。 サポートされるプロパティを参照してください。 |
サポートされるプロパティ
名前 | 種類 | 説明 |
---|---|---|
docstring |
string |
追加するエンティティを説明するフリー テキスト。 この文字列は、エンティティ名の横にあるさまざまな UX 設定で表示されます。 既定値は tableName> に基づいて作成<。 |
folder |
string |
テーブルを追加するフォルダーの名前。 既定値は、 tableName と同じフォルダーです。 |
返品
このコマンドは、次のコマンドを実行した場合と同様に、新しいテーブルのスキーマを JSON 形式で返します。
.show table MyLogs schema as json
Note
- テーブルが既に存在する場合:
ifnotexists
フラグ*を指定した場合、コマンドを無視します (変更は適用されない)。ifnotexists
フラグ*を指定していない場合、エラー*を返します。
例
.create table MyLogs_Temp based-on MyLogs with (folder="TempTables")