鏡像原則

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

管理命令

• 使用 .show 數據表原則鏡像命令 來顯示數據表目前的鏡像原則。
• 使用 .alter-merge 數據表原則鏡像命令 來變更目前的鏡像原則。
• 使用 .delete 數據表原則鏡像命令 來虛刪除目前的鏡像原則。
• 使用 .show 數據表鏡像作業命令 來檢查作業鏡像狀態。
• 使用 .show 數據表鏡像作業導出成品命令 來檢查作業導出的成品狀態。
• 使用 .show 數據表鏡像作業失敗 來檢查作業鏡像失敗狀態。

原則物件

鏡像原則包含下列屬性：

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

警告

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

數據分割格式設定

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

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

注意

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

數據類型對應

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

事件存放區與 Delta 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,
}

不支援此功能。