.alter-merge テーブル ポリシー ミラーリング コマンド
適用対象: ✅Microsoft Fabric
テーブルの ミラー化ポリシーを変更します。 ミラーリング ポリシーでは、データベース内のテーブルの論理コピーをデルタ Parquet 形式で作成し、ファイルをパーティション分割してクエリ速度を向上させることができます。 各パーティションは、[パーティション] リストに表示されている PartitionName を使用して個別の列として表されます。 つまり、ターゲットにはソース テーブルよりも多くの列があります。
構文
(.alter | .alter-merge) table TableName policy mirroring [partition by (Partitions)] dataformat = parquet
[with (IsEnabled=IsEnabledValue)]
構文規則について詳しく知る。
パラメーター
| 件名 | タイプ | Required | 説明 |
|---|---|---|---|
| TableName | string | ✔️ | エンティティ名規則に準拠するテーブル名。 |
| パーティション | string | データをより小さなパーティションに分割するために使用される列のコンマ区切りのリスト。 「 パーティションの書式設定を参照してください。 |
パーティションの書式設定
パーティションの一覧は、次の表に示す形式のいずれかを使用して指定されたパーティション列の任意の組み合わせです。
| パーティションの種類 | 構文 | メモ |
|---|---|---|
| 仮想列 | 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 は、他のパーティション名とミラー化テーブルの列名の両方で、大文字と小文字を区別しない一意の文字列である必要があります。
プロパティ
| 件名 | 種類 | 説明 |
|---|---|---|
IsEnabled |
bool |
ミラーリング ポリシーが有効かどうかを決定するブール値。 既定値は true です。 ミラーリング ポリシーを無効にして falseに設定すると、基になるミラーリング データは論理的に削除され、データベースに保持されます。 |
Note
ミラーリング ポリシーが有効になっている場合、テーブルの名前を変更することはできません。
例
.alter table policy mirroring
次の例では、 myTable というテーブルがミラー化されています。 データは、最初に名前でパーティション分割され、次に日付でパーティション分割されます。
.alter table myTable policy mirroring
partition by (Name: string=Name, Date: datetime= startofday(timestamp))
dataformat=parquet
with
(IsEnabled=true)
関連するコンテンツ
- ミラーリング操作を確認するには、 .show table mirroring operations コマンドを参照してください。
- ミラーリング操作を削除するには、「 .delete table policy mirroring commandを参照してください。