Share via


.alter-merge table policy update コマンド

テーブルの更新ポリシーを変更します。 更新ポリシーを使用すると、2 つのテーブル間でデータを同期および更新するプロセスが簡略化されます。 ソース テーブルに新しいデータが挿入されると、変換クエリがこのデータに対して実行され、データが変更され、ターゲット テーブルに挿入されます。

Note

  • 更新ポリシーが定義されているソース テーブルとテーブルは、同じデータベースに含む必要があります。
  • 更新ポリシー関数スキーマとターゲット テーブル スキーマは、列名、型、順序で一致している必要があります。
  • ポリシーがテーブルに既に定義されている場合、コマンドで指定された PolicyObjects は、既存のポリシーの PolicyObjects の配列に追加されます。

アクセス許可

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

構文

.alter-mergetable [ DatabaseName.]TablenamepolicyupdateArrayOfPolicyObjects

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

パラメーター

名前 必須 説明
DatabaseName string データベースの名前。 変更するテーブルを含むデータベース コンテキストからコマンドを実行する場合、 DatabaseName は必要ありません。
TableName string ✔️ テーブルの名前。 ワイルドカード である は、 *すべてのテーブルを表します。
ArrayOfPolicyObjects string ✔️ ポリシー オブジェクトのシリアル化された配列。 詳しくは、「更新ポリシー」をご覧ください。

戻り値

ポリシーの JSON 表現を返します。

次のコマンドは、 複数行の文字列リテラルを使用してテーブルの更新ポリシーを変更します。

.alter-merge table MyDatabase.MyTable policy update
```
[
    {
        "IsEnabled": true,
        "Source": "MyTableX",
        "Query": "MyOtherTable",
        "IsTransactional": true,
        "PropagateIngestionProperties": false
    }
]
```