add_policies()

社区版社区版功能在 Timescale 社区版下可用。点击了解更多。实验性实验性功能不适用于生产环境。它们包含在 TimescaleDB 实验性模式下。点击了解更多。

Timescale Cloud：性能、扩展、企业级

自托管产品

MST

一步添加刷新、压缩和数据保留策略到连续聚合。所添加的压缩和保留策略适用于连续聚合，而非原始超表。


timescaledb_experimental.add_policies(
     relation REGCLASS,
     if_not_exists BOOL = false,
     refresh_start_offset "any" = NULL,
     refresh_end_offset "any" = NULL,
     compress_after "any" = NULL,
     drop_after "any" = NULL,
     hypercore_use_access_method BOOL = NULL)
) RETURNS BOOL

警告

实验性功能可能存在错误。它们可能不向后兼容，并可能在未来的版本中移除。使用这些功能需自担风险，切勿在生产环境中使用任何实验性功能。

注意

add_policies() 不允许设置连续聚合的 schedule_interval，而是使用默认值 1 小时。

如果您想设置此项，请手动添加您的策略（参见 add_continuous_aggregate_policy）。

必选参数

名称	类型	描述
`relation`	`REGCLASS`	应应用策略的连续聚合

可选参数

名称	类型	描述
`if_not_exists`	`BOOL`	如果连续聚合不存在，设置为 true 则打印警告而非报错。默认为 false。
`refresh_start_offset`	`INTERVAL` 或 `INTEGER`	连续聚合刷新窗口的开始，表示为策略运行时间的偏移量。
`refresh_end_offset`	`INTERVAL` 或 `INTEGER`	连续聚合刷新窗口的结束，表示为策略运行时间的偏移量。必须大于 `refresh_start_offset`。
`compress_after`	`INTERVAL` 或 `INTEGER`	如果连续聚合分块仅包含早于此间隔的数据，则对其进行压缩。
`drop_after`	`INTERVAL` 或 `INTEGER`	如果连续聚合分块仅包含早于此间隔的数据，则将其删除。
`hypercore_use_access_method`	BOOLEAN	`NULL`

对于可以是 INTERVAL 或 INTEGER 的参数，如果您的时间桶基于时间戳，请使用 INTERVAL。如果您的时间桶基于整数，请使用 INTEGER。

如果成功，则返回 true。

示例用法

给定一个名为 example_continuous_aggregate 的连续聚合，为其添加三项策略

定期刷新连续聚合，以实现 1 天到 2 天前的数据具象化。
20 天后压缩连续聚合中的数据。
1 年后删除连续聚合中的数据。


SELECT timescaledb_experimental.add_policies(
    'example_continuous_aggregate',
    refresh_start_offset => '1 day'::interval,
    refresh_end_offset => '2 day'::interval,
    compress_after => '20 days'::interval,
    drop_after => '1 year'::interval
);

add_policies()

警告

注意

必选参数

可选参数

返回

示例用法

相关内容