.show database policy retention command

Applies to: ✅ Microsoft Fabric ✅ Azure Data Explorer

Display a database'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 Database User, Database Viewer, or Database Monitor permissions to run this command. For more information, see role-based access control.

Syntax

.show database DatabaseName policy retention

Learn more about syntax conventions.

Parameters

Name	Type	Required	Description
DatabaseName	string	✔️	The name of the database.

Returns

Returns a JSON representation of the policy.

Example

Display a retention policy:

.show database MyDatabase policy retention