次の方法で共有

.alter-merge テーブル ポリシー ミラーリング コマンド

  • [アーティクル]

適用対象: ✅Microsoft Fabric

テーブルの ミラー化ポリシーを変更します。 ミラーリング ポリシーでは、データベース内のテーブルの論理コピーをデルタ Parquet 形式で作成し、ファイルをパーティション分割してクエリ速度を向上させることができます。 各パーティションは、[パーティション] リストに表示されている PartitionName を使用して個別の列として表されます。 つまり、ターゲットにはソース テーブルよりも多くの列があります。

構文

(.alter | .alter-merge) tableTableNamepolicy mirroring [partitionby (Partitions)] )] dataformat = parquet [with(propertyName=propertyValue [, ...])]

構文規則について詳しく知る。

パラメーター

件名 タイプ Required 説明
TableName string ✔️ エンティティ名規則に準拠するテーブル名。
パーティション string データをより小さなパーティションに分割するために使用される列のコンマ区切りのリスト。 「 パーティションの書式設定を参照してください。
propertyName、propertyValue 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に設定すると、基になるミラーリング データは論理的に削除され、データベースに保持されます。
TargetLatencyInMinutes int 書き込み操作の遅延 (最小値)。 既定では、書き込み操作には最大 3 時間か、256 MB のデータが使用可能になるまでかかる場合があります。 5 分から 3 時間の間の値に遅延を調整できます。

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)

関連するコンテンツ