dolphindb 3.0.229 → 3.1.1

package/browser.d.ts

@@ -117,7 +117,7 @@ export declare class DdbObj<TValue extends DdbValue = DdbValue> {
     /** 将 DdbObj 转换为 js 原生数据类型
         - 标量对应 number, bigint 或者字符串 (其中时间类型转换为常用的字符串表示)
         - 数组对应 js 原生数组
-        - 表格对应 DdbTableData
+        - 表格对应 TResult, 可以传入 table: 'full' 配置返回包含列名，列类型的 DdbTableData 结构
         - 矩阵对应 DdbMatrixData
         - 字典对应普通的 js 对象 Record<string, any>
         - 图对应 DdbChartValue */
@@ -548,7 +548,7 @@ export declare class DDB {
                  Set this flag to true to skip connection status checks */
     call<TResult extends DdbObj>(func: string, args?: (DdbObj | string | boolean)[], { urgent, node, nodes, add_node_alias, listener, parse_object, skip_connection_check, on_more_messages }?: DdbCallOptions): Promise<TResult>;
     /** 调用 dolphindb 函数，传入 js 原生数组作为参数，返回 js 原生对象或值（调用 DdbObj.data() 后的结果）
-        - func: 函数名
+        - func: 函数名，或者函数完整实现，会间接调用 define 进行预定义
         - args?: `[ ]` 调用参数，可以是 js 原生数组，参数在中间且想用 server 函数的默认参数值时可以传 null 占位
         - options?: 调用选项
             - urgent?: 紧急 flag。使用 urgent worker 执行，防止被其它作业阻塞
@@ -581,6 +581,8 @@ export declare class DDB {
     /** 定义函数并保存，避免下次重复执行定义，会自动提取脚本中的函数名，作为缓存 key，
         也同时作为返回值
         - definition: 函数完整定义
+        - options?:
+            - urgent?: 紧急 flag，确保提交的脚本使用 urgent worker 处理，防止被其它作业阻塞
         @example
         await ddb.invoke(
             await ddb.define(
@@ -588,7 +590,9 @@ export declare class DDB {
                 '    print(bar)\n' +
                 '}\n'),
             ['hello']) */
-    define(definition: string): Promise<string>;
+    define(definition: string, { urgent }?: {
+        urgent?: boolean;
+    }): Promise<string>;
 }
 export interface DdbMessageListener {
     (message: DdbMessage, _this: DDB): any;

package/browser.js

@@ -3,7 +3,7 @@ import { blue, cyan, green, grey, magenta } from 'xshell/chalk.browser.js';
 import { concat, assert, Lock, genid, seq, zip_object, decode, delay, check } from 'xshell/utils.browser.js';
 import { connect_websocket } from 'xshell/net.browser.js';
 import { t } from "./i18n/index.js";
-import { date2str, datehour2str, datetime2str, ddb_tensor_bytes, DdbChartType, DdbDurationUnit, DdbForm, DdbFunctionType, DdbType, DdbVoidType, dictables, generate_array_type, get_big_int_128, get_ddb_time_value, get_duration_unit, get_type_name, int1282str, ipaddr2str, is_decimal_null_value, is_decimal_type, minute2str, month2str, nanotime2str, nanotimestamp2str, nulls, second2str, set_big_int_128, time2str, timestamp2str, uuid2str } from "./common.js";
+import { date2str, datehour2str, datetime2str, ddb_tensor_bytes, DdbChartType, DdbDurationUnit, DdbForm, DdbFunctionType, DdbType, DdbVoidType, dictables, function_definition_pattern, generate_array_type, get_big_int_128, get_ddb_time_value, get_duration_unit, get_type_name, int1282str, ipaddr2str, is_decimal_null_value, is_decimal_type, minute2str, month2str, nanotime2str, nanotimestamp2str, nulls, second2str, set_big_int_128, time2str, timestamp2str, uuid2str } from "./common.js";
 export * from "./common.js";
 /** 可以表示所有 DolphinDB 数据库中的数据类型  Can represent data types in all DolphinDB databases */
 export class DdbObj {
@@ -1114,13 +1114,17 @@ export class DdbObj {
             case DdbForm.table: {
                 const cols = value;
                 const jscols = cols.map(col => col.data(options));
-                const keys = cols.map(({ name }) => name);
-                return {
-                    name: name || '',
-                    columns: cols.map(({ name }) => name),
-                    types: cols.map(({ type }) => type),
-                    data: seq(rows, i => zip_object(keys, seq(cols.length, j => jscols[j][i])))
-                };
+                const columns = cols.select('name');
+                const data = seq(rows, i => zip_object(columns, seq(cols.length, j => jscols[j][i])));
+                return options?.table === 'full' ?
+                    {
+                        name: name || '',
+                        columns,
+                        types: cols.select('type'),
+                        data
+                    }
+                    :
+                        data;
             }
             case DdbForm.dict: {
                 const [keys, values] = value;
@@ -2925,7 +2929,7 @@ export class DDB {
         });
     }
     /** 调用 dolphindb 函数，传入 js 原生数组作为参数，返回 js 原生对象或值（调用 DdbObj.data() 后的结果）
-        - func: 函数名
+        - func: 函数名，或者函数完整实现，会间接调用 define 进行预定义
         - args?: `[ ]` 调用参数，可以是 js 原生数组，参数在中间且想用 server 函数的默认参数值时可以传 null 占位
         - options?: 调用选项
             - urgent?: 紧急 flag。使用 urgent worker 执行，防止被其它作业阻塞
@@ -2952,6 +2956,8 @@ export class DDB {
                         convertable = false;
                 }
         let result;
+        if (function_definition_pattern.test(func))
+            func = await this.define(func);
         if (convertable)
             result = await this.call(func, args, options);
         else {
@@ -3112,7 +3118,7 @@ export class DDB {
                         throw new Error(value.slice(value.indexOf(':') + 1).trim());
                     }
                     if (first) {
-                        schema = data = obj.data();
+                        schema = data = obj.data({ table: 'full' });
                         data.name ||= this.streaming.table;
                         first = false;
                     }
@@ -3120,7 +3126,7 @@ export class DDB {
                         let rows;
                         // 用了流数据过滤功能后，必然发 table
                         if (obj.form === DdbForm.table) {
-                            data = obj.data();
+                            data = obj.data({ table: 'full' });
                             data.name ||= schema.name;
                             rows = data.data.length;
                         }
@@ -3166,6 +3172,8 @@ export class DDB {
     /** 定义函数并保存，避免下次重复执行定义，会自动提取脚本中的函数名，作为缓存 key，
         也同时作为返回值
         - definition: 函数完整定义
+        - options?:
+            - urgent?: 紧急 flag，确保提交的脚本使用 urgent worker 处理，防止被其它作业阻塞
         @example
         await ddb.invoke(
             await ddb.define(
@@ -3173,8 +3181,8 @@ export class DDB {
                 '    print(bar)\n' +
                 '}\n'),
             ['hello']) */
-    async define(definition) {
-        const matches = /\bdef (\w+) \(/.exec(definition);
+    async define(definition, { urgent } = {}) {
+        const matches = function_definition_pattern.exec(definition);
         if (!matches)
             throw new Error(t('DDB.define 方法传入的 definition 不符合函数定义格式 def xxx ()'));
         const func_name = matches[1];
@@ -3184,7 +3192,7 @@ export class DDB {
         // 防止并发调用 define 时多次重复定义
         let promise = this.pdefinitions.get(func_name);
         if (!promise)
-            this.pdefinitions.set(func_name, promise = this.execute(definition));
+            this.pdefinitions.set(func_name, promise = this.execute(definition, { urgent }));
         await promise;
         this.definitions.set(func_name, definition);
         // 成功定义之后，definitions 中有了，就不需要通过 promise 来防止并发了，清理掉