dolphindb 3.0.113 → 3.0.114

package/index.d.ts

@@ -538,6 +538,11 @@ export declare function int1282str(buffer: Uint8Array, le?: boolean): string;
 export interface StreamingParams {
     table: string;
     action?: string;
+    /** offset 是订阅任务开始后的第一条消息所在的位置。消息是流数据表中的行。
+        如果未指定，或设为-1，订阅将会从流数据表的当前行开始。
+        如果 offset = -2，系统会获取持久化到磁盘上的 offset，并从该位置开始订阅。注意：须同时设置 persistOffset = true，offset = -2 才会生效；否则 offset 会变为 -1。
+        offset 与流数据表创建时的第一行对应。如果某些行因为内存限制被删除，在决定订阅开始的位置时，这些行仍然考虑在内。 */
+    offset?: number;
     filters?: {
         /** https://docs.dolphindb.cn/zh/help/FunctionsandCommands/FunctionReferences/s/subscribeTable.html#:~:text=%E8%BF%9E%E6%8E%A5%E6%96%B0%E7%9A%84%20leader%E3%80%82-,filter%20%E5%8F%82%E6%95%B0%E9%9C%80%E8%A6%81%E9%85%8D%E5%90%88,-setStreamTableFilterColumn%20%E5%87%BD%E6%95%B0%E4%B8%80%E8%B5%B7 */
         column?: DdbObj;

package/index.js

@@ -3308,10 +3308,10 @@ export class DDB {
             new DdbInt(0),
             this.streaming.table,
             (this.streaming.action ||= `api_js_${new Date().getTime()}`),
-            ...this.streaming?.filters?.column ? [
-                new DdbVoid(), // offset
-                this.streaming.filters.column // filter
-            ] : []
+            (this.streaming.offset === undefined || this.streaming.offset === null)
+                ? new DdbVoid()
+                : new DdbInt(this.streaming.offset), // offset
+            this.streaming.filters?.column || new DdbVoid(), // filter
         ], {
             skip_connection_check: true,
             // 先准备好收到 websocket message 的 callback