时序表管理

时序表是时序数据的载体，与关系表在关系模型中的意义相同。使用时先创建数据库，再创建时序表，然后才能写入或查询时序数据。

本章节主要介绍时序表管理，包括时序表的创建、修改、删除，以及查看当前 database 下的时序表视图。

创建时序表

用于在当前 database 下创建一个新的时序表。

创建时序表语法如下：

CREATE TIMESERIES TABLE [ IF NOT EXISTS ] table_name
( column_name data_type [ tslabel ] [ DEFAULT default_expr ] [, ...] [ COLLATE collation ] )
[ POLICY policy_name ]
[ TABLESPACE tablespace_name ];

更多信息请参见CREATE TIMESERIES TABLE。

修改时序表

用于修改一张已存在的时序表。可修改内容包括时序表的列名、列默认值、时序表的数据保留策略、所有者，以及时序表的表空间。

修改时序表的语法如下：

ALTER TIMESERIES TABLE [ IF EXISTS ] tablename_name actions

更多信息请参见ALTER TIMESERIES TABLE。

删除时序表

用于删除一张或多张已存在的时序表。

删除时序表语法如下：

DROP TIMESERIES TABLE [ IF EXISTS ] table_name [, table1_name ...];

更多信息请参见DROP TIMESERIES TABLE。

时序表视图

为方便用户使用，系统定义了一组时序表相关的视图。

timeseries_views.tstable，详细内容参见timeseries_views.tstable。

用于展示当前 database 下的所有时序表。

使用示例：

--查看schema为timeseries_views下的所有时序表。
Uqbar=# SELECT * FROM timeseries_views.tstable;
 schemaname | tablename | timecolname |     tagcol      | tspolicy 
------------+-----------+-------------+-----------------+----------
 public     | weather   | time        | {city,location} | infinity
(1 rows)

timeseries_views.tschunkgroup，详细内容参见timeseries_views.tschunkgroup。

用于展示当前 database 下所有时序表的 chunkgroup。

使用示例：

--查看时序表weather的ChunkGroup视图。
Uqbar=# SELECT tablename, chunkgroupname, chunkgroupduration, start_time, end_time FROM timeseries_views.tschunkgroup WHERE tablename= 'weather';
 tablename |  chunkgroupname |  chunkgroupduration  |       start_time      |       end_time    
--------------------+--------------------+----------------------+----------------------+----------------
 weather   |      p_1_1      |        7 days        |   2022-6-16 00:00:00  |   2022-6-23 00:00:00
 weather   |      p_1_2      |        7 days        |   2022-6-16 00:00:00  |   2022-6-23 00:00:00
 weather   |      p_2_1      |        7 days        |   2022-6-23 00:00:00  |   2022-6-30 00:00:00
 weather   |      p_2_2      |        7 days        |   2022-6-23 00:00:00  |   2022-6-30 00:00:00

(4 rows)