.alter-merge table 命令
適用於: ✅Microsoft網狀架構✅Azure 數據總管
.alter-merge table
命令:
- 保護現有數據行中的數據
- 將新的數據行、
docstring
和資料夾新增至現有的資料表 - 必須在限定數據表名稱的特定資料庫內容中執行
權限
您必須至少有 資料表管理員 許可權才能執行此命令。
語法
.alter-merge
tableName columnName:
(
columnType [,
...])
[with
(
propertyName =
propertyValue [,
...]])
table
深入瞭解 語法慣例。
參數
姓名 | 類型 | 必要 | 描述 |
---|---|---|---|
tableName | string |
✔️ | 要改變的數據表名稱。 |
columnName, columnType | string |
✔️ | 對應至該數據行中數據類型的現有或新數據行名稱。 這些對應的清單會定義輸出數據行架構。 |
propertyName、 propertyValue | string |
索引鍵/值屬性組的逗號分隔清單。 請參閱 支持的屬性。 |
注意
如果您嘗試改變數據行類型,命令將會失敗。 請改用 .alter column
。
提示
使用 .show table [tableName] cslschema
來取得現有的數據行架構,再加以變更。
支援的屬性
名稱 | 類型 | 描述 |
---|---|---|
docstring |
string |
描述要加入之實體的免費文字。 此字串會顯示在實體名稱旁的各種UX設定中。 |
folder |
string |
要加入至數據表的資料夾名稱。 |
命令如何影響數據
- 不會修改或刪除現有的數據
- 新的數據行將會新增至架構結尾
- 新數據行中的數據假設為 Null
範例
.alter-merge table MyTable (ColumnX:string, ColumnY:int)
.alter-merge table MyTable (ColumnX:string, ColumnY:int) with (docstring = "Some documentation", folder = "Folder1")
相關內容
.alter
當您想要進一步重新定義資料表設定時,請使用 table 命令。 如需詳細資訊,請參閱 .alter 數據表。