.alter materialized-view

具体化されたビューを変更すると、そのビューの既存のデータを保持したまま、具体化されたビューのクエリを変更することができます。

アクセス許可

このコマンドを実行するには、少なくとも Materialized View Admin アクセス許可が必要です。

構文

.altermaterialized-view [ with (PropertyName = PropertyValue,...)] MaterializedViewName on table SourceTableName{Query }

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

パラメーター

サポートされているプロパティ

with (PropertyName = PropertyValue) 句では、次のプロパティがサポートされています。 すべてのプロパティは省略可能です。

返品

[Output Schema]\(出力スキーマ\):

例

具体化されたビューのクエリ定義を変更する

次のコマンドは、具体化されたビュー MyView のクエリ定義を変更します。

.alter materialized-view MyView on table MyTable
{
    MyTable | summarize arg_max(Column3, *) by Column1
}

出力

ユース ケース

• ビューに集計を追加します。たとえば、ビュー クエリを T | summarize count(), min(Value), avg(Value) by Id に変更して、avg 集計を T | summarize count(), min(Value) by Id に追加します。
• summarize 演算子以外の演算子を変更します。 たとえば、 T | summarize arg_max(Timestamp, *) by User を T | where User != 'someone' | summarize arg_max(Timestamp, *) by Userに変更して、一部のレコードをフィルターで除外します。
• ソース テーブルが変更されたため、クエリは変更しません。 たとえば、autoUpdateSchemaに設定されていないT | summarize arg_max(Timestamp, *) by Idのビューを想定します (.create materialized-view コマンドを参照)。 ビューのソース テーブルに列が追加または削除されると、ビューは自動的に無効になります。 まったく同じクエリで alter コマンドを実行して、具体化されたビューのスキーマを新しいテーブル スキーマに合わせて変更します。 変更後も、enable materialized view コマンドを使用して、ビューを明示的に有効にする必要があります。

制限事項

• 次の変更はサポートされていません:

  • 式別の具体化されたビュー グループに対する変更。
  • 列の種類の変更。
  • 列名を変更する。 たとえば、T | summarize count() by Idのビューを変更して列count_T | summarize Count=count() by Id削除し、最初は null のみを含む新しい列Countを作成します。

• 既存のデータへの影響:

  • 具体化されたビューを変更しても、既存のデータに影響はありません。
  • クエリにフィルターを追加すると、新しく取り込まれたレコードにのみ適用され、既に具体化されているレコードは変更されません。
    • alter コマンドの後に取り込まれたレコードが null 値を変更するまで、新しい列は既存のすべてのレコードに対して NULL を受け取ります。
    • たとえば、 T | summarize count() by bin(Timestamp, 1d) のビューが T | summarize count(), sum(Value) by bin(Timestamp, 1d)に変更されます。 ビューを変更する前にレコードが既に処理されている特定の Timestamp=T の場合、 sum 列には部分的なデータが含まれます。 このビューには、変更の実行後に処理されたレコードだけが含まれます。