时间系列 SQL 例程

时间系列 SQL 例程创建特定时间系列类型的实例，然后将数据添加到时间系列类型中或在时间系列类型中更改数据。提供 SQL 例程还可用于检查、分析、处理和聚集时间系列中的数据。

在本章示例中使用的几种数据类型和表在下表中列出。

类型/表	描述
stock_bar	包含 timestamp(DATETIME)、high、low、final 和 vol 列的类型
daily_stocks	包含 stock_id、stock_name 和 stock_data 列的表
stock_trade	包含 timestamp(DATETIME)、price、vol、trade、broker、buyer 和 seller 列的类型
activity_stocks	包含 stock_id 和 activity_data 列的表

有关上述数据类型和表的更多信息，请参阅创建 TimeSeries 子类型和创建数据库表。

这些示例的模式位于 $GBASEDBTDIR/TimeSeries.version/examples 目录中。

按任务分类的时间系列 SQL 例程
基于任务类型将时间系列 SQL 例程分类成各个逻辑区域。
flags 参数值
插入数据的时间系列 SQL 函数具有 flags 参数，可确定元素的插入方式。
Abs 函数
Abs 函数返回其参数的绝对值。
Acos 函数
Acos 函数返回其参数的反余弦。
AggregateBy 函数
AggregateBy 函数使用通过提供日历指定的新时间间隔聚集时间系列中的值。
AggregateRange 函数
AggregateRange 函数对 start 和 end DATETIME 参数指定的时间范围的每个元素生成聚集。
Apply 函数
Apply 函数查询一个或多个时间系列并将用户指定的 SQL 表达式或函数应用到选定的时间系列元素。
ApplyBinaryTsOp 函数
ApplyBinaryTsOp 函数将二进制算术函数应用到一对时间系列，或一个时间系列和一个兼容的行类型或编号。
ApplyCalendar 函数
ApplyCalendar 函数将新日历应用到时间系列。
ApplyOpToTsSet 函数
ApplyOpToTsSet 函数将二进制算术函数应用到一组时间系列。
ApplyUnaryTsOp 函数
ApplyUnaryTsOp 函数将一元算术函数应用到时间系列。
Asin 函数
Asin 函数返回其参数的反正弦。
Atan 函数
Atan 函数返回其参数的反正切。
Atan2 函数
Atan2 函数返回两个时间系列中对应元素的反正切。
二进制算术函数
标准二进制算术函数 Atan2、Plus、Minus、Times、Divide、Mod 和 Pow 可以对时间系列数据执行运算。Plus、Minus、Times 和 Divide 函数还可以分别通过其标准运算符 +、-、* 和 / 表示。
BulkLoad 函数
BulkLoad 函数将客户机文件中的数据装入现有时间系列。
Clip 函数
Clip 函数抽取时间系列中两个时间点之间的数据，并返回包含该数据的新时间系列。您可以从大型时间系列中抽取关注的时间段，并独立于大型系列对其进行存储或运算。
ClipCount 函数
ClipCount 函数是 Clip 的变体，其中第一个整数参数将解释为要剪切的条目计数。如果计数是正的，ClipCount 将从时间戳记或之后的第一个元素开始，并剪切后面的计数条目。如果计数是负的，ClipCount 将从时间戳记或之前的第一个元素开始，并剪切前面的计数条目。
ClipGetCount 函数
ClipGetCount 函数返回当前时间系列中在使用时间戳记定界的时间段中产生的元素数。
Cos 函数
Cos 函数返回其参数的余弦。
CountIf 函数
CountIf 函数对与简单算术表达式的条件匹配的元素进行计数。
DelClip 函数
DelClip 函数删除指定时间系列实例在指定时间范围（包括定界时间点）内的所有元素。DelClip 与 DelTrim 函数的不同之处在于，它从规则的时间系列的结尾处理删除。DelTrim 缩短时间系列并回收空间，而 DelClip 使用空值替换元素。
DelElem 函数
DelElem 函数删除指定时间系列实例中指定时间点的元素。
DelRange 函数
DelRange 函数删除指定时间系列实例中指定时间范围（包括定界时间点）内的所有元素。DelRange 函数与 DelTrim 函数相似，但不同的是 DelRange 函数删除元素并从规则时间系列的任何部分回收空间。
DelTrim 函数
DelTrim 函数删除时间系列实例中指定时间范围（包括定界时间点）内的所有元素。DelTrim 函数与 DelClip 函数类似，只是 DelTrim 函数删除元素并从规则时间系列实例结束点回收空间，而 DelClip 函数将元素替换为空值。DelTrim 函数也与 DelRange 函数类似，只是 DelRange 函数删除元素并从规则时间系列实例的任何部分回收空间。
Divide 函数
Divide 函数将一个时间系列除以另一个时间系列。
ElemIsHidden 函数
ElemIsHidden 函数确定元素是否隐藏。
ElemIsNull 函数
ElemIsNull 函数确定元素是否不包含数据。
Exp 函数
Exp 函数对时间系列取幂。
FindHidden 函数
FindHidden 函数扫描时间系列并返回所有隐藏的元素。
GetCalendar 函数
GetCalendar 函数返回与给定时间系列关联的日历。
GetCalendarName 函数
GetCalendarName 函数返回给定时间系列使用的日历的名称。
GetClosestElem 函数
GetClosestElem 函数返回最接近给定时间戳记的第一个非空元素。还可以指定时间系列元素中的哪一列必须为非空以满足搜索条件。
GetContainerName 函数
GetContainerName 函数返回给定时间系列的容器的名称。
GetElem 函数
GetElem 函数抽取给定时间戳记的元素。
GetFirstElem 函数
GetFirstElem 函数返回时间系列中的第一个元素。
GetFirstElementStamp 函数
GetFirstElementStamp 函数返回时间系列中第一个元素的时间戳记。
GetIndex 函数
GetIndex 函数返回与所提供时间戳记关联的时间系列条目的索引（偏移量）。
GetInterval 函数
GetInterval 函数返回时间系列使用的时间间隔。
GetLastElem 函数
GetLastElem 函数返回时间系列中存储的最终条目。
GetLastElementStamp 函数
GetLastElementStamp 函数返回时间系列中最后一个元素的时间戳记。
GetLastNonNull 函数
GetLastNonNull 函数返回在指定日期或之前的上一个非空元素。
GetLastValid 函数
GetLastValid 函数抽取时间系列中给定时间戳记的元素。
GetMetaData 函数
GetMetaData 函数返回给定时间系列的用户定义的元数据。
GetMetaTypeName 函数
GetMetaTypeName 函数返回在给定时间系列中存储的用户定义的元数据类型的类型名称。
GetNelems 函数
GetNelems 函数返回时间系列中存储的元素数。
GetNextNonNull 函数
GetNextNonNull 函数返回在指定日期或之后的下一个非空元素。
GetNextValid 函数
GetNextValid 函数返回给定时间戳记之后的最近条目。
GetNthElem 函数
GetNthElem 函数抽取时间系列中特定偏移量或位置上的条目。
GetOrigin 函数
GetOrigin 函数返回时间系列的原点。
GetPreviousValid 函数
GetPreviousValid 函数返回给定时间戳记之前的最后一个元素。
GetStamp 函数
GetStamp 函数返回与时间系列中所提供偏移量关联的时间戳记。偏移量可以是正整数或负整数。
GetThreshold 函数
GetThreshold 函数返回与指定时间系列关联的阈值。
HideElem 函数
HideElem 函数将给定时间戳记的元素或元素集标记为不可见。
HideRange 函数
InsElem 函数
InsSet 函数
InstanceId 函数
InstanceId 函数确定时间系列是否存储在容器中，（如果是）并返回该时间系列的实例标识。
Intersect 函数
IsRegular 函数
Lag 函数
Logn 函数
Minus 函数
Mod 函数
Negate 函数
NullCleanup 函数
NullCleanup 函数释放时间系列实例中某个范围内或整个时间系列实例内仅包含空元素的所有页面。
Plus 函数
Positive 函数
Pow 函数
PutElem 函数
PutElemNoDups 函数
PutNthElem 函数
PutSet 函数
PutSet 函数使用提供的行类型值多个集更新时间系列。
PutTimeSeries 函数
PutTimeSeries 函数将第一个时间系列的每个元素放到第二个时间系列中。
RevealElem 函数
RevealRange 函数
Round 函数
SetContainerName 函数
SetContainerName 函数会为时间系列设置容器名称，即使时间系列已具有容器名称。
SetOrigin 函数
Sin 函数
Sqrt 函数
Tan 函数
Times 函数
TimeSeriesRelease 函数
Transpose 函数
Transpose 函数会转换用于以表格式进行处理的时间系列数据。
TSAddPrevious 函数
TSAddPrevious 函数对调用函数所使用的所有值求和，并在每次调用时返回当前总和。总和中不包括当前自变量。
TSCmp 函数
TSCmp 函数比较两个值。
TSColNameToList 函数
TSColNumToList 函数
TSContainerCreate 过程
TSContainerCreate 过程创建用于为指定的 TimeSeries 子类型存储时间系列数据的容器。可以在一个数据库空间中创建容器，创建跨多个分区的容器，或创建滚动窗口容器，以用于控制存储的数据量。
TSContainerDestroy 过程
TSContainerDestroy 过程从 TSContainerTable 表删除容器行，并除去容器及其对应的系统目录行。
TSContainerLock 过程
TSContainerLock 过程控制是否多个会话可以同时写入一个容器。
TSContainerManage 函数
TSContainerManage 函数更改容器的属性。
TSContainerNElems 函数
TSContainerNElems 函数返回存储在指定容器或所有容器中的时间系列数据元素数。
TSContainerPctUsed 函数
TSContainerPctUsed 函数返回指定容器或所有容器中已用空间的百分比。
TSContainerPoolRoundRobin 函数
TSContainerPoolRoundRobin 函数提供循环策略以将时间系列数据插入到指定容器池中的容器。
TSContainerPurge 函数
TSContainerPurge 函数从一个或多个容器中删除指定时间戳记内的时间系列数据。
TSContainerSetPool 过程
TSContainerSetPool 过程将指定的容器移入指定的容器池。
TSContainerTotalPages 函数
TSContainerTotalPages 函数返回分配给指定容器或所有容器中的页面总数。
TSContainerTotalUsed 函数
TSContainerTotalUsed 函数返回指定容器或所有容器中包含时间系列数据的页面总数。
TSContainerUsage 函数
TSContainerUsage 函数返回指定容器或所有容器的大小和容量信息。
TSCreate 函数
TSCreate 函数会创建空的常规时间系列或使用给定数据集填充的常规时间系列。新时间系列还可以附加用户定义的元数据。
TSCreateIrr 函数
TSDecay 函数
TSL_Attach 函数
TSL_Attach 函数打开用于装入数据的数据库会话。
TSL_GetKeyContainer 函数
TSL_GetKeyContainer 函数返回针对指定主键值存储时间系列值的容器的名称。
TSL_GetLogMessage 函数
TSL_GetLogMessage 函数指定从装入器消息队列中检索的消息数。
TSL_Flush 函数
TSL_Flush 函数将数据清空到磁盘。
TSL_Init 函数
TSL_Init 函数初始化用于装入数据的会话。
TSL_Put 函数
TSL_Put 函数装入时间系列数据。
TSL_PutRow 函数
TSL_PutRow 函数装入一行时间系列数据。
TSL_PutSQL 函数
TSL_PutSQL 函数从表中装入时间系列数据。
TSL_SessionClose 函数
TSL_SessionClose 函数关闭当前数据库会话。
TSL_SetLogMode 函数
TSL_SetLogMode 函数指定如何记录有关装入器的消息。
TSL_Shutdown 过程
TSL_Shutdown 过程关闭装入器应用程序并释放所有资源。
TSPrevious 函数
TSPrevious 函数记录提供的自变量并返回传递它的最后一个自变量。
TSRollup 函数
TSRollup 函数按时间聚集表中多个行的时间系列值。
TSRowNameToList 函数
TSRowNumToList 函数
TSRowToList 函数
TSRunningAvg 函数
TSRunningAvg 函数计算 SMALLFLOAT 或 DOUBLE PRECISION 值的运行平均值。
TSRunningCor 函数
TSRunningCor 函数会计算运行窗口上的两个时间系列的运行关联。如果该窗口中任一输入的方差是零或 NULL，那么 TSRunningCor 函数会返回 NULL。
TSRunningMed 函数
TSRunningMed 函数计算运行窗口内的时间系列的中位数。只有在 Apply 函数内使用时此函数才有用。
TSRunningSum 函数
TSRunningVar 函数
TSRunningVar 函数计算运行窗口内的时间系列的方差。
TSSetToList 函数
TSToXML 函数
TSToXML 函数返回时间系列的 XML 表示法。
一元算术函数
Union 函数
UpdElem 函数
UpdMetaData 函数
UpdSet 函数
WithinC 和 WithinR 函数

相关概念

存取时间系列数据的规划