次の方法で共有

ミラーリング ポリシー

適用対象: ✅Microsoft Fabric

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

管理コマンド

ポリシー オブジェクト

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

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

警告

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

注

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

パーティションの書式設定

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

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

注

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