ミラーリングポリシー

適用対象: ✅Microsoft Fabric

ミラーリングポリシーコマンドを使用すると、テーブルミラーリングポリシーを表示、変更、パーティション分割、および削除できます。また、操作ミラーリングの状態を確認して、ミラーリングの待機時間を確認する方法も提供します。

管理コマンド

ミラーリングポリシーには、次のプロパティが含まれています。

プロパティ	説明	値	既定値
形式	ミラー化されたファイルの形式。	有効な値は `parquet`。	`parquet`
ConnectionStrings	接続の構成と確立に役立つ接続文字列の配列。この値は自動的に設定されます。
IsEnabled	ミラーリングポリシーが有効かどうかを判断します。ミラーリングポリシーが無効で `false`に設定されている場合、基になるミラーリングデータはデータベースに保持されます。	`true`、 `false`、 `null`。	`null`
パーティション	データをより小さなパーティションに分割するために使用される列のコンマ区切りのリスト。	「パーティションの書式設定を参照してください。

警告

テーブルミラーリングポリシーを削除または削除すると、OneLake のデルタテーブルが完全に削除されます。

Note

ミラーリングポリシーが有効になっている場合、テーブルの名前を変更することはできません。

パーティションの一覧は、次の表に示す形式のいずれかを使用して指定されたパーティション列の任意の組み合わせです。

パーティションの種類	構文	メモ
仮想列	PartitionName `:` (`datetime` \| `string`)	詳細については、仮想列を参照してください。
文字列列の値	PartitionName `:` `string` `=` ColumnName
文字列列の値 hash()	PartitionName `:` `long` `=` `hash(`ColumnName`,` Number`)`	ハッシュは剰余 Numberです。
切り捨てられた datetime 列 (値)	PartitionName `:` `datetime` `=` (`startofyear` \| `startofmonth` \| `startofweek` \| `startofday`) `(` ColumnName `)`	startofyear、startofmonth、startofweek、または startofday 関数に関するドキュメントを参照してください。
切り捨てられた Datetime 列の値 `=` `bin` `(` ColumnName `,` TimeSpan `)`	bin関数の詳細を参照してください。

Note

各パーティションは、[パーティション] リストに表示されている 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,
}