鏡像原則

適用於： ✅Microsoft Fabric

鏡像原則命令可讓您檢視、變更、分割及刪除數據表鏡像原則。它們也會提供檢閱作業鏡像狀態來檢查鏡像延遲的方式。

管理命令

鏡像原則包含下列屬性：

屬性	描述	值	預設
格式	鏡像檔案的格式。	有效值為 `parquet`。	`parquet`
ConnectionStrings	連接字串數位列，可協助設定和建立連線。這個值會自動填入。
IsEnabled	判斷是否啟用鏡像原則。停用鏡像原則並設定為 `false`時，基礎鏡像數據會保留在資料庫中。	`true`、、`falsenull`。	`null`
資料分割	以逗號分隔的數據行清單，用來將數據分割成較小的分割區。	請參閱分割區格式設定。

警告

刪除或卸除數據表鏡像原則將會永久刪除 OneLake 中的差異數據表。

注意

啟用鏡像原則時，無法重新命名數據表。

數據分割清單是資料分割資料行的任何組合，使用下表所示的其中一個表單來指定。

數據分割類型	語法	備註
虛擬數據行	PartitionName `:` （`datetime` \| `string`）	深入瞭解虛擬數據行。
字串數據行值	PartitionName `=` `:` `string` ColumnName
字串資料行值哈希（）	PartitionName ColumnName`=``:` `long` `hash(,` Number`)`	哈希為模數。
截斷日期時間資料行（value）	PartitionName `datetime` `:` `=` （`startofyearstartofweek` \| \| \| `startofdaystartofmonth`） `(` ColumnName `)`	請參閱 startofyear、startofmonth 、startofweek 或 startofday 函式的檔。
截斷的 Datetime 資料行值 `=` `bin` `(` ColumnName `,`TimeSpan `)`	深入瞭解 bin 函式。

注意

每個分割區會使用 Partitions 清單中所列的 PartitionName，以個別數據行表示。 PartitionName 必須是不區分大小寫的唯一字串，以及其他數據分割名稱和鏡像數據表的數據行名稱。

若要確保相容性並優化查詢，請確定數據類型已正確對應到 parquet 數據類型。

事件存放區數據類型會使用下列規則對應至 Delta Parquet 資料類型：

事件存放區資料類型	Delta 資料類型
`bool`	`boolean`
`datetime`	`timestamp OR date (for date-bound partition definitions)`
`dynamic`	`string`
`guid`	`string`
`int`	`integer`
`long`	`long`
`real`	`double`
`string`	`string`
`timespan`	`long`
`decimal`	`decimal(38,18)`

如需事件存放區資料類型的詳細資訊，請參閱純量資料類型。

{
  "Format": "parquet",
  "IsEnabled": true,
  "Partitions": null,
}