TSContainerUsage 函数

TSContainerUsage 函数返回指定容器或所有容器的大小和容量信息。

语法

TSContainerUsage(container_name  varchar(128,1));

TSContainerUsage(container_name  varchar(128,1),
                 rw_flag         integer default 0);

container_name: 指定要返回其相关信息的窗口。必须是现有容器名称。; 值 NULL 将返回有关数据库的所有容器的信息。
rw_flag: 对于滚动窗口容器，指定要返回其存储空间使用总量的分区：; 0 = 活动窗口中的分区; 1 = 休眠窗口中的分区; 2 = 容器分区。; 3 = 所有分区。

描述

使用 TSContainerUsage 函数可监视指定容器的填充程度。对于滚动窗口容器，TSContainerTotalUsage 函数将返回指定分区集的填充程度的摘要值。可以使用此函数返回的信息来确定容器的填充速度，以及是否必须分配更多存储空间。

返回结果

在 pages 列中返回包含时间系列数据的页面数，在 slots 列中返回元素数，并在 total 列中返回分配给容器的页面数。

示例

以下语句返回名为 mult_container 的容器的信息：

EXECUTE FUNCTION TSContainerUsage("mult_container");

      pages                slots       total 

         30                   26          50

1 row(s) retrieved.

此容器有 26 个时间系列数据元素，这些元素使用了 30 页（共 50 页）的空间。尽管此容器几乎为半空，但它可能只能再容纳不到 20 个时间系列元素。

以下语句返回所有容器的信息：

EXECUTE FUNCTION TSContainerUsage(NULL);

      pages                slots       total 

       2029               241907        2169

1 row(s) retrieved.

这些容器只有 140 页的可用空间。