dolphindb 3.0.218 → 3.0.219

package/README.md

@@ -508,6 +508,37 @@ async upload (
 ): Promise<void>
 ```
 
+
+### Upload and insert data into the table
+```ts
+// Load or create a table in the session corresponding to the connection
+await ddb.execute('t = table(1..10 as id, take(["A001", "B001"], 10) as sym, rand(10.0, 10) as val)')
+// await ddb.execute('t = loadTable(database("dfs://path-to-db"), "table_name")')
+
+console.log(
+    'Number of rows inserted:',
+    // Use tableInsert to insert data
+    await ddb.invoke<number>(
+        'tableInsert',
+        [
+            't',
+            
+            // Data
+            new DdbTable([
+                // First column
+                new DdbVectorInt([1, 2, 3]),
+                
+                // Second column
+                new DdbVectorSymbol(['a', 'b', 'c']),
+                
+                // The third column
+                new DdbVectorDouble([1.1, 1.2, 1.3]),
+            ])
+        ]
+    )
+)
+```
+
 ### Other Examples
 
 ```ts

package/README.zh.md

@@ -489,6 +489,36 @@ async upload (
 ```
 
 
+### 向表中上传并插入数据
+```ts
+// 在连接对应的会话中加载或创建表
+await ddb.execute('t = table(1..10 as id, take(["A001", "B001"], 10) as sym, rand(10.0, 10) as val)')
+// await ddb.execute('t = loadTable(database("dfs://path-to-db"), "table_name")')
+
+console.log(
+    '插入的行数:',
+    // 使用 tableInsert 插入数据
+    await ddb.invoke<number>(
+        'tableInsert',
+        [
+            't',
+            
+            // 数据
+            new DdbTable([
+                // 第一列
+                new DdbVectorInt([1, 2, 3]),
+                
+                // 第二列
+                new DdbVectorSymbol(['a', 'b', 'c']),
+                
+                // 第三列
+                new DdbVectorDouble([1.1, 1.2, 1.3]),
+            ])
+        ]
+    )
+)
+```
+
 ### 其他例子
 
 ```ts

package/browser.d.ts

@@ -419,7 +419,7 @@ export interface ConvertOptions {
     /** `'ms'` timestamp 类型转换为字符串表示时显示到秒还是毫秒 */
     timestamp?: 's' | 'ms';
 }
-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 | DdbFunctionDefValue | DdbDurationValue | DdbDecimal32Value | DdbDecimal64Value | DdbDecimal32VectorValue | DdbDecimal64VectorValue | DdbDecimal128VectorValue | BigInt128Array | DdbSymbolExtendedValue | string[] | DdbArrayVectorValue | DdbMatrixValue | Uint8Array<ArrayBufferLike> | Int8Array<ArrayBufferLike> | Int16Array<ArrayBufferLike> | Int32Array<ArrayBufferLike> | Float32Array<ArrayBufferLike> | Float64Array<ArrayBufferLike> | BigInt64Array<ArrayBufferLike> | Uint8Array<ArrayBufferLike>[] | DdbObj<DdbValue>[] | IotVectorItemValue | DdbDurationVectorValue | number[] | DdbTensorValue | DdbChartValue;
 /** 转换一个向量到 js 原生数组 */
 export declare function converts(type: DdbType, value: DdbVectorValue, rows: number, le: boolean, options?: ConvertOptions): any[] | Uint8Array;
 /** 构造 void 类型，默认为 `DdbVoidType.undefined` */
@@ -647,6 +647,7 @@ export interface DdbOptions {
     username?: string;
     password?: string;
     python?: boolean;
+    kdb?: boolean;
     sql?: SqlStandard;
     streaming?: StreamingParams;
     verbose?: boolean;
@@ -684,6 +685,8 @@ export declare class DDB {
     password: string;
     /** python session flag (2048) */
     python: boolean;
+    /** kdb session flag (4096) */
+    kdb: boolean;
     /** 表示本次会话执行的 SQL 标准 */
     sql: SqlStandard;
     /** 是否为流数据连接，非流数据这个字段恒为 null  Whether it is a streaming data connection, this field is always null for non-streaming data */
@@ -720,6 +723,7 @@ export declare class DDB {
             - username?: DolphinDB 登录用户名，默认 `'admin'`  DolphinDB username, default `'admin'`
             - password?: DolphinDB 登录密码，默认 `'123456'`  DolphinDB password, default `'123456'`
             - python?: 设置 python session flag，默认 `false`  set python session flag, default `false`
+            - kdb?: 设置 kdb session flag，默认 `false`  set kdb session flag, default `false`
             - streaming?: 设置该选项后，该 WebSocket 连接只用于流数据  When this option is set, the WebSocket connection is only used for streaming data
             - verbose?: 是否打印每个 rpc 的信息用于调试
             - sql?: 设置当前会话执行的 sql 标准, 请使用 SqlStandard 枚举进行传参，默认 `DolphinDB`

package/browser.js

@@ -2822,6 +2822,8 @@ export class DDB {
     password = '123456';
     /** python session flag (2048) */
     python = false;
+    /** kdb session flag (4096) */
+    kdb = false;
     /** 表示本次会话执行的 SQL 标准 */
     sql = SqlStandard.DolphinDB;
     /** 是否为流数据连接，非流数据这个字段恒为 null  Whether it is a streaming data connection, this field is always null for non-streaming data */
@@ -2861,6 +2863,7 @@ export class DDB {
             - username?: DolphinDB 登录用户名，默认 `'admin'`  DolphinDB username, default `'admin'`
             - password?: DolphinDB 登录密码，默认 `'123456'`  DolphinDB password, default `'123456'`
             - python?: 设置 python session flag，默认 `false`  set python session flag, default `false`
+            - kdb?: 设置 kdb session flag，默认 `false`  set kdb session flag, default `false`
             - streaming?: 设置该选项后，该 WebSocket 连接只用于流数据  When this option is set, the WebSocket connection is only used for streaming data
             - verbose?: 是否打印每个 rpc 的信息用于调试
             - sql?: 设置当前会话执行的 sql 标准, 请使用 SqlStandard 枚举进行传参，默认 `DolphinDB`
@@ -2887,6 +2890,8 @@ export class DDB {
             this.password = options.password;
         if (options.python !== undefined)
             this.python = options.python;
+        if (options.kdb !== undefined)
+            this.kdb = options.kdb;
         if (options.sql !== undefined)
             this.sql = options.sql;
         if (options.streaming !== undefined)
@@ -2931,7 +2936,7 @@ export class DDB {
                     url.searchParams.set('filter', this.streaming.filters.expression.trim());
                 // 连接建立之前应该不会有别的调用占用 this.lwebsocket
                 this.lwebsocket.resource = await connect_websocket(url, {
-                    protocols: this.streaming ? ['streaming'] : this.python ? ['python'] : undefined,
+                    protocols: this.streaming ? ['streaming'] : this.python ? ['python'] : this.kdb ? ['kdb'] : undefined,
                     on_message: (buffer, websocket) => {
                         this.on_message(new Uint8Array(buffer), websocket);
                     },
@@ -3006,6 +3011,9 @@ export class DDB {
         // python session
         if (this.python)
             flag += 2048;
+        // kdb session
+        if (this.kdb)
+            flag += 4096;
         // sql standrd
         flag += 2 ** 19 * this.sql;
         const options = [