dolphindb 3.0.227 → 3.1.0

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 */
@@ -185,7 +185,7 @@ export interface InspectOptions {
 export declare function format(type: DdbType, value: DdbValue, le: boolean, options?: InspectOptions): string;
 /** 格式化向量、集合中的第 index 项为字符串，空值返回 'null' 字符串  formatted vector, the index-th item in the collection is a string, a null value returns a 'null' string */
 export declare function formati(obj: DdbVectorObj, index: number, options?: InspectOptions): string;
-export declare function convert(type: DdbType, value: DdbValue, le: boolean, { blob, char, timestamp }?: ConvertOptions): string | number | bigint | boolean | number[] | Uint8Array<ArrayBufferLike> | DdbFunctionDefValue | DdbDurationValue | DdbDecimal32Value | DdbDecimal64Value | Int8Array<ArrayBufferLike> | Int16Array<ArrayBufferLike> | Int32Array<ArrayBufferLike> | Float32Array<ArrayBufferLike> | Float64Array<ArrayBufferLike> | BigInt64Array<ArrayBufferLike> | BigInt128Array | string[] | Uint8Array<ArrayBufferLike>[] | DdbObj<DdbValue>[] | IotVectorItemValue | DdbSymbolExtendedValue | DdbArrayVectorValue | DdbDecimal32VectorValue | DdbDecimal64VectorValue | DdbDecimal128VectorValue | DdbDurationVectorValue | DdbMatrixValue | DdbChartValue | DdbTensorValue;
+export declare function convert(type: DdbType, value: DdbValue, le: boolean, { blob, char, timestamp }?: ConvertOptions): string | number | bigint | boolean | string[] | number[] | DdbFunctionDefValue | DdbDurationValue | DdbDecimal32Value | DdbDecimal64Value | DdbDecimal32VectorValue | DdbDecimal64VectorValue | DdbSymbolExtendedValue | DdbTensorValue | Uint8Array<ArrayBufferLike> | Int8Array<ArrayBufferLike> | Int16Array<ArrayBufferLike> | Int32Array<ArrayBufferLike> | Float32Array<ArrayBufferLike> | Float64Array<ArrayBufferLike> | BigInt64Array<ArrayBufferLike> | BigInt128Array | Uint8Array<ArrayBufferLike>[] | DdbObj<DdbValue>[] | IotVectorItemValue | DdbArrayVectorValue | DdbDecimal128VectorValue | DdbDurationVectorValue | DdbMatrixValue | DdbChartValue;
 /** 转换一个向量到 js 原生数组 */
 export declare function converts(type: DdbType, value: DdbVectorValue, rows: number, le: boolean, options?: ConvertOptions): any[] | Uint8Array;
 /** 构造 void 类型，默认为 `DdbVoidType.undefined` */
@@ -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 执行，防止被其它作业阻塞

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;
                         }
@@ -3174,9 +3180,9 @@ export class DDB {
                 '}\n'),
             ['hello']) */
     async define(definition) {
-        const matches = /\bdef (\w+)\s?\(/.exec(definition);
+        const matches = function_definition_pattern.exec(definition);
         if (!matches)
-            throw new Error(t('DDB.define 方法传入的 definition 不符合函数定义格式'));
+            throw new Error(t('DDB.define 方法传入的 definition 不符合函数定义格式 def xxx ()'));
         const func_name = matches[1];
         // 已定义成功
         if (this.definitions.has(func_name))