dolphindb 3.1.0 → 3.1.2

package/index.d.ts

@@ -174,7 +174,7 @@ export interface InspectOptions extends UtilInspectOptions {
 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 | string[] | number[] | DdbFunctionDefValue | DdbDurationValue | DdbDecimal32Value | DdbDecimal64Value | DdbDecimal32VectorValue | DdbDecimal64VectorValue | DdbSymbolExtendedValue | DdbTensorValue | Uint8Array<ArrayBufferLike> | IotVectorItemValue | DdbDurationVectorValue | Int8Array<ArrayBufferLike> | Int16Array<ArrayBufferLike> | Int32Array<ArrayBufferLike> | Float32Array<ArrayBufferLike> | Float64Array<ArrayBufferLike> | BigInt64Array<ArrayBufferLike> | BigInt128Array | Uint8Array<ArrayBufferLike>[] | DdbObj<DdbValue>[] | DdbArrayVectorValue | DdbDecimal128VectorValue | DdbMatrixValue | DdbChartValue;
+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 | string[] | IotVectorItemValue | DdbSymbolExtendedValue | DdbDecimal32VectorValue | DdbDecimal64VectorValue | DdbDurationVectorValue | DdbTensorValue | Int8Array<ArrayBufferLike> | Int16Array<ArrayBufferLike> | Int32Array<ArrayBufferLike> | Float32Array<ArrayBufferLike> | Float64Array<ArrayBufferLike> | BigInt64Array<ArrayBufferLike> | BigInt128Array | Uint8Array<ArrayBufferLike>[] | DdbObj<DdbValue>[] | DdbArrayVectorValue | DdbDecimal128VectorValue | DdbMatrixValue | DdbChartValue;
 /** 转换一个向量到 js 原生数组 */
 export declare function converts(type: DdbType, value: DdbVectorValue, rows: number, le: boolean, options?: ConvertOptions): any[] | Uint8Array;
 /** 构造 void 类型，默认为 `DdbVoidType.undefined` */
@@ -571,6 +571,8 @@ export declare class DDB {
     /** 定义函数并保存，避免下次重复执行定义，会自动提取脚本中的函数名，作为缓存 key，
         也同时作为返回值
         - definition: 函数完整定义
+        - options?:
+            - urgent?: 紧急 flag，确保提交的脚本使用 urgent worker 处理，防止被其它作业阻塞
         @example
         await ddb.invoke(
             await ddb.define(
@@ -578,7 +580,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/index.js

@@ -2935,7 +2935,7 @@ export class DDB {
                 }
         let result;
         if (function_definition_pattern.test(func))
-            func = await this.define(func);
+            func = await this.define(func, { urgent: options?.urgent });
         if (convertable)
             result = await this.call(func, args, options);
         else {
@@ -3150,6 +3150,8 @@ export class DDB {
     /** 定义函数并保存，避免下次重复执行定义，会自动提取脚本中的函数名，作为缓存 key，
         也同时作为返回值
         - definition: 函数完整定义
+        - options?:
+            - urgent?: 紧急 flag，确保提交的脚本使用 urgent worker 处理，防止被其它作业阻塞
         @example
         await ddb.invoke(
             await ddb.define(
@@ -3157,7 +3159,7 @@ export class DDB {
                 '    print(bar)\n' +
                 '}\n'),
             ['hello']) */
-    async define(definition) {
+    async define(definition, { urgent } = {}) {
         const matches = function_definition_pattern.exec(definition);
         if (!matches)
             throw new Error(t('DDB.define 方法传入的 definition 不符合函数定义格式 def xxx ()'));
@@ -3168,7 +3170,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 来防止并发了，清理掉