次の方法で共有

.alter-merge table コマンド

  • [アーティクル]

適用対象: ✅Microsoft Fabric✅Azure データ エクスプローラー

.alter-merge table コマンドは、次のことを行います。

  • 既存の列のデータを保護する
  • 既存のテーブルに新しい列、 docstring、およびフォルダーを追加します
  • テーブル名のスコープを指定する特定のデータベースのコンテキストで実行する必要がある

アクセス許可

このコマンドを実行するには、少なくとも Table 管理者 アクセス許可が必要です。

構文

.alter-mergetable tableName (columnName:columnType [, ...] ) [with (propertyName = propertyValue [, ...]] )]

構文規則について詳しく知る。

パラメーター

件名 タイプ Required 説明
tableName string ✔️ 変更するテーブルの名前。
columnName, columnType string ✔️ その列のデータ型にマップされた既存または新しい列の名前。 これらのマッピングの一覧では、出力列スキーマが定義されています。
propertyName, propertyValue string キーと値のプロパティのペアのコンマ区切りのリスト。 サポートされるプロパティを参照してください。

Note

列の種類を変更しようとすると、コマンドは失敗します。 代わりに .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 table」を参照してください。