.alter table retention policy command

Applies to: ✅ Microsoft Fabric ✅ Azure Data Explorer

Changes the table'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. The retention policy can be configured for a specific table or materialized view, or for an entire database. The policy then applies to all tables in the database that don't override it.

Permissions

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

Syntax

.alter table TableName policy retention PolicyObject

Learn more about syntax conventions.

Parameters

Name	Type	Required	Description
TableName	string	✔️	The name of the table.
PolicyObject	string	✔️	A serialized policy object. For more information, see retention policy.

Example

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

.alter table MySourceTable policy retention
```
{
    "SoftDeletePeriod": "10.00:00:00",
    "Recoverability": "Enabled"
}
```