timescaledb_information.chunks

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

自托管产品

MST

获取超表分块的元数据。

此视图显示分块主要时间维度元数据。有关超表的次要维度信息，应使用 dimensions 视图代替。

如果分块的主要维度是时间数据类型，则设置 range_start 和 range_end。否则，如果主要维度类型是基于整数的，则设置 range_start_integer 和 range_end_integer。

可用列

名称	类型	描述
`hypertable_schema`	TEXT	超表的模式名称
`hypertable_name`	TEXT	超表的表名称
`chunk_schema`	TEXT	分块的模式名称
`chunk_name`	TEXT	分块的名称
`primary_dimension`	TEXT	作为主要维度的列的名称
`primary_dimension_type`	REGTYPE	作为主要维度的列的类型
`range_start`	TIMESTAMP WITH TIME ZONE	分块维度的范围起始
`range_end`	TIMESTAMP WITH TIME ZONE	分块维度的范围结束
`range_start_integer`	BIGINT	如果维度类型是基于整数的，则为分块维度的范围起始
`range_end_integer`	BIGINT	如果维度类型是基于整数的，则为分块维度的范围结束
`is_compressed`	BOOLEAN	分块中的数据是否已压缩？请注意，对于分布式超表，这是访问节点上分块的缓存压缩状态。在某些情况下，访问节点和数据节点上的缓存状态可能不同步。例如，如果用户在数据节点而不是访问节点上压缩或解压缩分块，或者直接在数据节点上设置压缩策略。使用 `chunk_compression_stats()` 函数获取分布式分块的实时压缩状态。
`chunk_tablespace`	TEXT	分块使用的表空间
`data_nodes`	ARRAY	分块所在的复制节点。这仅适用于分布式超表的分块
`chunk_creation_time`	TIMESTAMP WITH TIME ZONE	为添加数据而创建此分块的时间

示例用法

获取超表分块的信息。

注意

维度构建器 by_range 在 TimescaleDB 2.13 中引入。chunk_creation_time 元数据在 TimescaleDB 2.13 中引入。


CREATE TABLESPACE tablespace1 location '/usr/local/pgsql/data1';

CREATE TABLE hyper_int (a_col integer, b_col integer, c integer);
SELECT table_name from create_hypertable('hyper_int', by_range('a_col', 10));
CREATE OR REPLACE FUNCTION integer_now_hyper_int() returns int LANGUAGE SQL STABLE as $$ SELECT coalesce(max(a_col), 0) FROM hyper_int $$;
SELECT set_integer_now_func('hyper_int', 'integer_now_hyper_int');

INSERT INTO hyper_int SELECT generate_series(1,5,1), 10, 50;

SELECT attach_tablespace('tablespace1', 'hyper_int');
INSERT INTO hyper_int VALUES( 25 , 14 , 20), ( 25, 15, 20), (25, 16, 20);

SELECT * FROM timescaledb_information.chunks WHERE hypertable_name = 'hyper_int';

-[ RECORD 1 ]----------+----------------------
hypertable_schema      | public
hypertable_name        | hyper_int
chunk_schema           | _timescaledb_internal
chunk_name             | _hyper_7_10_chunk
primary_dimension      | a_col
primary_dimension_type | integer
range_start            |
range_end              |
range_start_integer    | 0
range_end_integer      | 10
is_compressed          | f
chunk_tablespace       |
data_nodes             |
-[ RECORD 2 ]----------+----------------------
hypertable_schema      | public
hypertable_name        | hyper_int
chunk_schema           | _timescaledb_internal
chunk_name             | _hyper_7_11_chunk
primary_dimension      | a_col
primary_dimension_type | integer
range_start            |
range_end              |
range_start_integer    | 20
range_end_integer      | 30
is_compressed          | f
chunk_tablespace       | tablespace1
data_nodes             |

timescaledb_information.chunks

可用列

示例用法

注意

相关内容