dolphindb 2.0.1013 → 2.0.1015

package/index.d.ts

@@ -320,15 +320,17 @@ export declare function int1282str(buffer: Uint8Array, le?: boolean): string;
 export interface StreamingParams {
     table: string;
     action?: string;
-    handler(message: StreamingData): any;
+    handler(message: StreamingMessage): any;
 }
-export interface StreamingData extends StreamingParams {
+export interface StreamingMessage extends StreamingParams {
     /** server 发送消息的时间 (nano seconds since epoch)   The time the server sent the message (nano seconds since epoch)
         std::chrono::system_clock::now().time_since_epoch() / std::chrono::nanoseconds(1) */
     time: bigint;
     /** message id */
     id: bigint;
     colnames: string[];
+    /** 最新的 server 有可能先推一个 table schema 过来 */
+    schema?: DdbTableObj;
     /** 订阅主题，即一个订阅的名称。  Subscription topic, which is the name of a subscription.
         它是一个字符串，由订阅表所在节点的别名、流数据表名称和订阅任务名称（如果指定了 actionName）组合而成，使用 `/` 分隔
         It is a string consisting of the alias of the node where the subscription table is located, the stream data table name, and the subscription task name (if actionName is specified), separated by `/` */
@@ -417,7 +419,7 @@ export declare class DDB {
     /** 表示本次会话执行的 SQL 标准 */
     sql: SqlStandard;
     /** 是否为流数据连接，非流数据这个字段恒为 null  Whether it is a streaming data connection, this field is always null for non-streaming data */
-    streaming: StreamingData;
+    streaming: StreamingParams;
     /** 是否打印每个 rpc 的信息用于调试 */
     verbose: boolean;
     print_message_buffer: boolean;
@@ -462,7 +464,7 @@ export declare class DDB {
     constructor(url: string, options?: DdbOptions);
     private on_message;
     private on_error;
-    /** 调用后会确保和数据库的连接是正常的 (this.connected === true && this.errored === false)，否则抛出错误
+    /** 调用后会确保和数据库的连接是正常的 (this.connected === true)，否则抛出错误
         这个方法是幂等的，首次调用建立实际的 WebSocket 连接到 URL 对应的 DolphinDB，然后执行自动登录，
         如果是流数据连接，还会调用 publishTable 订阅流表
         后续调用检查上面的条件
@@ -471,7 +473,7 @@ export declare class DDB {
         2. session 是有状态的，重连也无法恢复之前的状态
         3. 断线后所有之前的 ddb.call, ddb.eval 都应该抛出连接错误
         
-        After calling, it will ensure that the connection with the database is normal (this.connected === true && this.errored === false), otherwise an error will be thrown
+        After calling, it will ensure that the connection with the database is normal (this.connected === true), otherwise an error will be thrown
         This method is idempotent, the first call establishes an actual WebSocket connection to the DolphinDB corresponding to the URL, and subsequent calls check the above conditions
         After the connection is disconnected, it is forbidden to call connect again to reconnect the original ddb object. You should use new DDB() to create a new connection object because:
         1. The on_error callback is bound to a certain websocket, and it is inconvenient to unbind and rebind
@@ -582,7 +584,7 @@ export declare class DDB {
     /** 解析服务端响应报文，返回去掉 header 的 data buf */
     parse_message(buf: Uint8Array, error: DdbDatabaseError): DdbMessage;
     /** 内部的流订阅方法  Internal stream subscription method */
-    subscribe(): Promise<StreamingData>;
+    subscribe(): Promise<void>;
 }
 export interface DdbMessageListener {
     (message: DdbMessage, _this: DDB): any;

package/index.js

@@ -2219,7 +2219,7 @@ export class DDB {
     on_error() {
         // 这里的实现一定会被 connect, rpc 中的实现覆盖
     }
-    /** 调用后会确保和数据库的连接是正常的 (this.connected === true && this.errored === false)，否则抛出错误
+    /** 调用后会确保和数据库的连接是正常的 (this.connected === true)，否则抛出错误
         这个方法是幂等的，首次调用建立实际的 WebSocket 连接到 URL 对应的 DolphinDB，然后执行自动登录，
         如果是流数据连接，还会调用 publishTable 订阅流表
         后续调用检查上面的条件
@@ -2228,7 +2228,7 @@ export class DDB {
         2. session 是有状态的，重连也无法恢复之前的状态
         3. 断线后所有之前的 ddb.call, ddb.eval 都应该抛出连接错误
         
-        After calling, it will ensure that the connection with the database is normal (this.connected === true && this.errored === false), otherwise an error will be thrown
+        After calling, it will ensure that the connection with the database is normal (this.connected === true), otherwise an error will be thrown
         This method is idempotent, the first call establishes an actual WebSocket connection to the DolphinDB corresponding to the URL, and subsequent calls check the above conditions
         After the connection is disconnected, it is forbidden to call connect again to reconnect the original ddb object. You should use new DDB() to create a new connection object because:
         1. The on_error callback is bound to a certain websocket, and it is inconvenient to unbind and rebind
@@ -2640,9 +2640,7 @@ export class DDB {
     }
     /** 内部的流订阅方法  Internal stream subscription method */
     async subscribe() {
-        console.log(t('订阅流表成功') + ', colnames:', 
-        // string[3](['time', 'stock', 'price'])
-        this.streaming.colnames = (await this.call('publishTable', [
+        const { value: colnames } = await this.call('publishTable', [
             'localhost',
             new DdbInt(0),
             this.streaming.table,
@@ -2650,27 +2648,30 @@ export class DDB {
             // new DdbInt(-1),  // offset
             // filter
             // allow exists
-        ], { skip_connection_check: true })).value);
-        this.streaming.window = {
+        ], { skip_connection_check: true });
+        console.log(t('订阅流表成功') + ', colnames:', 
+        // string[3](['time', 'stock', 'price'])
+        colnames);
+        let win = {
             offset: 0,
             rows: 0,
             segments: [],
         };
+        let schema;
         // 先准备好收到 websocket message 的 callback
         this.on_message = buffer => {
-            // 复制一份，避免 handler 中异步直接使用传入的 streaming 这个对象时属性发生变化
-            let streaming = { ...this.streaming, error: null };
             try {
                 const dv = new DataView(buffer);
                 const buf = new Uint8Array(buffer);
-                streaming.time = dv.getBigInt64(1, this.le);
-                streaming.id = dv.getBigInt64(9, this.le);
                 const i_topic_end = buf.indexOf(0, 17);
-                streaming.topic = this.dec.decode(buf.subarray(17, i_topic_end));
-                // 是 column 片段组成的 any vector
-                const data = streaming.data = DdbObj.parse(buf.subarray(i_topic_end + 1), this.le);
-                let { window: win } = streaming;
-                win.rows += streaming.rows = data.value[0].rows;
+                // 首个 message 可能是 table schema, 后续消息是 column 片段组成的 any vector
+                const data = DdbObj.parse(buf.subarray(i_topic_end + 1), this.le);
+                if (data.form === DdbForm.table) {
+                    schema = data;
+                    return;
+                }
+                const { rows } = data.value[0];
+                win.rows += rows;
                 win.segments.push(data);
                 if (win.rows >= winsize * 2 && win.segments.length >= 2) {
                     let winsize_ = 0;
@@ -2682,14 +2683,23 @@ export class DDB {
                     win.offset += win.rows - winsize_;
                     win.rows = winsize_;
                 }
+                this.streaming.handler({
+                    ...this.streaming,
+                    id: dv.getBigInt64(9, this.le),
+                    time: dv.getBigInt64(1, this.le),
+                    rows,
+                    topic: this.dec.decode(buf.subarray(17, i_topic_end)),
+                    colnames,
+                    schema,
+                    data,
+                    window: win,
+                });
             }
             catch (error) {
                 // 将 error 交给 handler 处理
-                streaming.error = error;
+                this.streaming.handler({ ...this.streaming, error });
             }
-            this.streaming.handler(streaming);
         };
-        return this.streaming;
     }
 }
 // const ddb_gateway = {