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');
关键词