共用方式為


.alter-merge table 命令

適用於: ✅Microsoft網狀架構Azure 數據總管

.alter-merge table 命令:

  • 保護現有數據行中的數據
  • 將新的數據行、 docstring和資料夾新增至現有的資料表
  • 必須在限定數據表名稱的特定資料庫內容中執行

權限

您必須至少有 資料表管理員 許可權才能執行此命令。

語法

.alter-mergetableName columnName: (columnType [, ...]) [with( propertyName = propertyValue [, ...]])table

深入瞭解 語法慣例

參數

姓名 類型​​ 必要 描述
tableName string ✔️ 要改變的數據表名稱。
columnNamecolumnType string ✔️ 對應至該數據行中數據類型的現有或新數據行名稱。 這些對應的清單會定義輸出數據行架構。
propertyNamepropertyValue 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 數據表