TimescaleDB API referenceContinuous aggregates

Remove refresh, compression, and data retention policies from a continuous aggregate. The removed compression and retention policies apply to the continuous aggregate, not to the original hypertable.

timescaledb_experimental.remove_policies(
relation REGCLASS,
if_exists BOOL = false,
VARIADIC policy_names TEXT[] = NULL
) RETURNS BOOL

To remove all policies on a continuous aggregate, see remove_all_policies().

Warning

Experimental features could have bugs. They might not be backwards compatible, and could be removed in future releases. Use these features at your own risk, and do not use any experimental features in production.

NameTypeDescription
relationREGCLASSThe continuous aggregate to remove policies from
NameTypeDescription
if_existsBOOLWhen true, prints a warning instead of erroring if the policy doesn't exist. Defaults to false.
policy_namesTEXTThe policies to remove. You can list multiple policies, separated by a comma. Allowed policy names are policy_refresh_continuous_aggregate, policy_compression, and policy_retention.

Returns true if successful.

Given a continuous aggregate named example_continuous_aggregate with a refresh policy and a data retention policy, remove both policies.

Throw an error if either policy doesn't exist. If the continuous aggregate has a compression policy, leave it unchanged:

SELECT timescaledb_experimental.remove_policies(
'example_continuous_aggregate',
false,
'policy_refresh_continuous_aggregate',
'policy_retention'
);

Keywords

Found an issue on this page?

Report an issue!