Timescale Cloud:性能、扩展性、企业级
自托管产品
MST
获取与超表关联的数据块列表。
函数接受以下必需和可选参数。这些参数与 drop_chunks 函数具有相同的语义。
| 名称 | 类型 | 描述 |
|---|---|---|
relation | REGCLASS | 从中选择数据块的超表或连续聚合。 |
| 名称 | 类型 | 描述 |
|---|---|---|
older_than | ANY | 指定截止点,显示早于此时间戳的所有数据块。 |
newer_than | ANY | 指定截止点,显示晚于此时间戳的所有数据块。 |
created_before | ANY | 指定截止点,显示在此时间戳之前创建的所有数据块。 |
created_after | ANY | 指定截止点,显示在此时间戳之后创建的所有数据块。 |
older_than 和 newer_than 参数可以通过两种方式指定
间隔类型: 截止点计算为
now() - older_than,类似地为now() - newer_than。如果提供了 INTERVAL 但时间列不是 TIMESTAMP、TIMESTAMPTZ 或 DATE 之一,则返回错误。时间戳、日期或整数类型: 截止点明确地作为 TIMESTAMP / TIMESTAMPTZ / DATE 或 SMALLINT / INT / BIGINT 给出。时间戳或整数的选择必须与超表时间列的类型一致。
created_before 和 created_after 参数可以通过两种方式指定
间隔类型: 截止点计算为
now() - created_before,类似地为now() - created_after。这使用数据块创建时间进行过滤。时间戳、日期或整数类型: 截止点明确地作为
TIMESTAMP/TIMESTAMPTZ/DATE或SMALLINT/INT/BIGINT给出。整数值的选择必须与超表分区列的类型一致。否则,数据块创建时间将用于过滤。
当同时使用 older_than 和 newer_than 参数时,函数返回两个结果范围的交集。例如,指定 newer_than => 4 months 和 older_than => 3 months 会显示所有介于 3 到 4 个月之间的数据块。类似地,指定 newer_than => '2017-01-01' 和 older_than => '2017-02-01' 会显示所有介于 '2017-01-01' 和 '2017-02-01' 之间的数据块。如果指定的参数导致两个范围之间没有重叠交集,则会返回错误。
当同时使用 created_before 和 created_after 参数时,函数返回两个结果范围的交集。例如,指定 created_after=> 4 months和created_before=> 3 months 会显示所有在当前时间点起 3 到 4 个月之间创建的数据块。类似地,指定 created_after=> '2017-01-01'和created_before => '2017-02-01' 会显示所有在 '2017-01-01' 和 '2017-02-01' 之间创建的数据块。如果指定的参数导致两个范围之间没有重叠交集,则会返回错误。
注意
created_before/created_after 参数不能与 older_than/newer_than 一起使用。
获取与表关联的所有数据块列表
SELECT show_chunks('conditions');
获取超表 conditions 中所有超过 3 个月的数据块
SELECT show_chunks('conditions', older_than => INTERVAL '3 months');
获取超表 conditions 中所有在 3 个月前创建的数据块
SELECT show_chunks('conditions', created_before => INTERVAL '3 months');
获取超表 conditions 中所有在最近 1 个月内创建的数据块
SELECT show_chunks('conditions', created_after => INTERVAL '1 month');
获取超表 conditions 中所有在 2017 年之前的数据块
SELECT show_chunks('conditions', older_than => DATE '2017-01-01');
关键词