.alter-merge materialized-view policy retention command

Applies to: ✅ Azure Data Explorer

Changes the materialized-view's retention policy. The retention policy controls the mechanism that automatically removes data from tables or materialized views. It is used to remove data whose relevance is age-based.

Permissions

You must have at least Database Admin permissions to run this command.

Syntax

.alter-merge materialized-view MaterializedViewName policy retention PolicyParameters

Learn more about syntax conventions.

Parameters

Name Type Required Description
MaterializedViewName string ✔️ The name of the materialized view.
PolicyParameters string ✔️ One or more policy parameters. For more information, see retention policy.

Example

Sets a retention policy with a 10-day soft-delete period, and disables data recoverability:

.alter-merge materialized-view View1 policy retention softdelete = 10d recoverability = disabled