dolphindb 2.0.959 → 2.0.960

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (7) hide show
  1. package/browser.js +2 -0
  2. package/browser.js.map +1 -1
  3. package/docs.en.json +524 -827
  4. package/docs.zh.json +77 -114
  5. package/index.js +2 -0
  6. package/index.js.map +1 -1
  7. package/package.json +1 -1
package/docs.zh.json CHANGED
@@ -2734,7 +2734,7 @@
2734
2734
  "",
2735
2735
  "`capacity` 是正整数，表示向量的容量，即该向量新建时系统为该向量分配的内存（以元素数为单位）。当元素数超过capacity时，系统会自动扩充容量。系统首先会分配当前容量1.2~2倍的内存，然后复制数据到新的内存空间，最后释放原来的内存。",
2736
2736
  "",
2737
- "`defaultValue` 是向量的默认值。如果不指定默认值，对于多数数据类型，默认值是 0。对于字符串和符号(Symbol)，默认值是 NULL。"
2737
+ "`defaultValue` 是向量的默认值。若指定，则只能是标量。若不指定：对于多数数据类型，默认值是 0；对于字符串和符号(Symbol)，默认值是 NULL。"
2738
2738
  ]
2739
2739
  }
2740
2740
  ]
@@ -14897,7 +14897,7 @@
14897
14897
  "使用 `sortKeyMappingFunction` 时需要注意以下几点：",
14898
14898
  "",
14899
14899
  "* `sortKeyMappingFunction` 指定的函数对象与索引列中的各列一一对应，若其中某列无需降维，则函数对象置为空。",
14900
- "* 当 `sortKeyMappingFunction` 中的函数对象为 hashBucket，且降维的列为采用 Hash 分区的分区字段时，Hash 分区的数量不能被 hashBucket 中的 buckets 整除，否则同一分区内的 Hash 得到的 key 都相同。"
14900
+ "* 当 `sortKeyMappingFunction` 中的函数对象为 hashBucket，且需要对采用 Hash 分区的分区字段进行降维时，应确保 Hash 分区的数量和 hashBucket 中的 buckets 之间不存在整除关系，否则会导致同一分区内的所有 Hash 值得到的 key 都相同。"
14901
14901
  ]
14902
14902
  }
14903
14903
  ]
@@ -15352,7 +15352,7 @@
15352
15352
  "",
15353
15353
  "若同时有一批数据注入响应式状态引擎，则引擎内部数据是分批进行计算的，每个批次的数据称为一个 batch，每个 batch 包含记录数由系统决定。",
15354
15354
  "",
15355
- "`outputElapsedMicroseconds` 布尔值，表示是否输出每个 batch 中数据从注入引擎到计算输出的总耗时，以及每个 batch 包含的总记录数，默认为 false。指定参数 *outputElapsedMicroseconds* 后，在定义 *outputTables* 时需要在 keyColumn 列后增加两列，详见 *outputTable* 参数说明。"
15355
+ "`outputElapsedMicroseconds` 布尔值，表示是否输出每个 batch 中数据从注入引擎到计算输出的总耗时，以及每个 batch 包含的总记录数，默认为 false。指定参数 *outputElapsedMicroseconds* 后，在定义 *outputTable* 时需要在 keyColumn 列后增加两列，详见 *outputTable* 参数说明。"
15356
15356
  ]
15357
15357
  }
15358
15358
  ]
@@ -16076,7 +16076,7 @@
16076
16076
  ".. versionadded:: 2.00.9",
16077
16077
  " 参数 *outputElapsedMicroseconds*",
16078
16078
  "",
16079
- "`outputElapsedMicroseconds` 布尔值，表示是否输出每个窗口数据注入到计算完成的耗时（若指定了 *keyColumn* 则包含数据分组的耗时），默认为 false。指定参数 outputElapsedMicroseconds 后，在定义 outputTables 时需要在时间列和分组列后增加一个 LONG 类型的列，详见 *outputTable* 参数说明。",
16079
+ "`outputElapsedMicroseconds` 布尔值，表示是否输出每个窗口数据注入到计算完成的耗时（若指定了 *keyColumn* 则包含数据分组的耗时），默认为 false。指定参数 outputElapsedMicroseconds 后，在定义 outputTable 时需要在时间列和分组列后增加一个 LONG 类型的列，详见 *outputTable* 参数说明。",
16080
16080
  ""
16081
16081
  ]
16082
16082
  }
@@ -19225,7 +19225,7 @@
19225
19225
  "value": [
19226
19226
  "`X` 是标量/向量。",
19227
19227
  " ",
19228
- "`size` 是整型标量，必须满足 0<=size<size(X) 条件。",
19228
+ "`size` 是整型标量，必须满足 0<size<=size(X) 条件。",
19229
19229
  "",
19230
19230
  "`cutPositions` 是单增的整型向量，用于指定切分段开始的索引。"
19231
19231
  ]
@@ -19660,21 +19660,21 @@
19660
19660
  "",
19661
19661
  "`partitionScheme` 描述了分区是如何创建的。它通常是一个向量，在序列域是一个整型标量。分区方案的说明决定了分区类型。*partitionScheme* 支持以下数据类型：CHAR, SHORT, INT, DATE, MONTH, TIME, MINUTE, SECOND, DATETIME 和 SYMBOL。",
19662
19662
  "",
19663
- "+--------+--------+------------------------------------------------------------+",
19664
- "|分区类型|分区符号|分区方案 |",
19665
- "+========+========+============================================================+",
19666
- "|顺序分区|SEQ |整型标量。表示分区的数量。 |",
19667
- "+--------+--------+------------------------------------------------------------+",
19668
- "|范围分区|RANGE |向量。向量的任意两个相邻元素定义分区的范围。 |",
19669
- "+--------+--------+------------------------------------------------------------+",
19670
- "|哈希分区|HASH |元组。第一个元素是分区列的数据类型，第二个元素是分区的数量。|",
19671
- "+--------+--------+------------------------------------------------------------+",
19672
- "|值分区 |VALUE |向量。向量的每个元素定义了一个分区。 |",
19673
- "+--------+--------+------------------------------------------------------------+",
19674
- "|列表分区|LIST |向量。向量的每个元素定义了一个分区。 |",
19675
- "+--------+--------+------------------------------------------------------------+",
19676
- "|组合分区|COMPO |向量。向量的每个元素是一个数据库句柄。 |",
19677
- "+--------+--------+------------------------------------------------------------+",
19663
+ "+--------+--------+--------------------------------------------------------------------------------+",
19664
+ "|分区类型|分区符号|分区方案 |",
19665
+ "+========+========+================================================================================+",
19666
+ "|顺序分区|SEQ |整型标量。表示分区的数量。 |",
19667
+ "+--------+--------+--------------------------------------------------------------------------------+",
19668
+ "|范围分区|RANGE |向量。向量的任意两个相邻元素定义分区的范围。 |",
19669
+ "+--------+--------+--------------------------------------------------------------------------------+",
19670
+ "|哈希分区|HASH |元组。第一个元素是分区列的数据类型，第二个元素是分区的数量。 |",
19671
+ "+--------+--------+--------------------------------------------------------------------------------+",
19672
+ "|值分区 |VALUE |向量。向量的每个元素定义了一个分区。 |",
19673
+ "+--------+--------+--------------------------------------------------------------------------------+",
19674
+ "|列表分区|LIST |向量。向量的每个元素定义了一个分区。 |",
19675
+ "+--------+--------+--------------------------------------------------------------------------------+",
19676
+ "|组合分区|COMPO |向量。向量的每个元素是一个数据库句柄。向量长度表示分区的层级，最小是2，最大是3。|",
19677
+ "+--------+--------+--------------------------------------------------------------------------------+",
19678
19678
  "",
19679
19679
  "`locations` 是元组，指定分区的位置。元组中元素的数量应该与 *partitionType* 和 *partitionScheme* 共同决定的分区数量相同。若要在多个节点上保存分区时，",
19680
19680
  "可以使用分布式文件系统或使用 *locations* 参数指定每个分区在哪些节点。如果没有指定 *locations* 参数，所有分区属于当前节点。我们不能指定分层域的分区。",
@@ -32410,7 +32410,7 @@
32410
32410
  "value": [
32411
32411
  "返回集群中的分布式表。",
32412
32412
  "",
32413
- "1.30.21 版本起，",
32413
+ "2.00.9 版本起，",
32414
32414
  "",
32415
32415
  "* 该函数由管理员或拥有 DB_MANAGE 权限的用户执行时，返回集群中所有的分布式表；",
32416
32416
  "* 否则，仅返回该用户有访问权限的分布式表。其中，访问权限包含 DB_OWNER, TABLE_READ, TABLE_WRITE, TABLE_INSERT, TABLE_UPDATE, TABLE_DELETE, DB_READ, DB_WRITE, DB_INSERT, DB_UPDATE, DB_DELETE。 "
@@ -36409,7 +36409,7 @@
36409
36409
  {
36410
36410
  "type": "text",
36411
36411
  "value": [
36412
- "获取会话的内存占用状态，返回一张表包含以下字段：",
36412
+ "获取当前节点所有连接会话的内存占用状态，返回一张表包含以下字段：",
36413
36413
  "",
36414
36414
  "* userId：用户 ID 或缓存类型的标识符（形如：\\_\\_xxx\\_\\_）。 ",
36415
36415
  "* sessionId：会话 ID。 ",
@@ -36447,9 +36447,10 @@
36447
36447
  "| \\_\\_StreamingSubQueue\\_\\_ | 流数据订阅队列里未处理的消息数。 |",
36448
36448
  "+------------------------------+-----------------------------------------------------+",
36449
36449
  "",
36450
- "注：此函数无法统计到会话中正在执行的任务所占用的内存情况。",
36450
+ "注：",
36451
36451
  "",
36452
- "被创建的时间与最后使用时间均为零时区时间，可使用 :doc:`../l/localtime` 函数转换为当前时区的时间，详见例子。"
36452
+ "* 此函数无法统计到会话中正在执行的任务所占用的内存情况。",
36453
+ "* 对于返回表中的 createTime 和 lastActiveTime，2.00.9.4 之前版本的 DolphinDB，返回零时区时间；2.00.9.4 及之后版本的 DolphinDB，返回当前时区的时间。"
36453
36454
  ]
36454
36455
  }
36455
36456
  ]
@@ -36474,72 +36475,19 @@
36474
36475
  "=========================== ============ ======== ============== ========== =========================== ========================= ",
36475
36476
  "userId sessionId memSize remoteIP remotePort createTime lastActiveTime ",
36476
36477
  "=========================== ============ ======== ============== ========== =========================== ========================= ",
36477
- "__DimensionalTable__ 0 0.0.0.0 ",
36478
- "",
36479
- "__SharedTable__ 0 0.0.0.0 ",
36480
- "",
36481
- "__OLAPTablet__ 0 0.0.0.0 ",
36482
- "",
36483
- "__OLAPCacheEngine__ 0 0.0.0.0 ",
36484
- "",
36485
- "__OLAPCachedSymbolBa... 0 0.0.0.0 ",
36486
- "",
36487
- "__DFSMetadata__ 2769 0.0.0.0 ",
36488
- "",
36489
- "__TSDBCacheEngine__ 0 0.0.0.0 ",
36490
- "",
36491
- "__TSDBLevelFileIndex__ 0 0.0.0.0 ",
36492
- "",
36493
- "__TSDBCachedSymbolBa... 0 0.0.0.0 ",
36494
- "",
36495
- "__StreamingPubQueue__ 0 0.0.0.0 ",
36496
- "",
36497
- "__StreamingSubQueue__ 0 0.0.0.0 ",
36498
- "",
36478
+ "__DimensionalTable__ 0 0.0.0.0 ",
36479
+ "__SharedTable__ 0 0.0.0.0 ",
36480
+ "__OLAPTablet__ 0 0.0.0.0 ",
36481
+ "__OLAPCacheEngine__ 0 0.0.0.0 ",
36482
+ "__OLAPCachedSymbolBa... 0 0.0.0.0 ",
36483
+ "__DFSMetadata__ 2769 0.0.0.0 ",
36484
+ "__TSDBCacheEngine__ 0 0.0.0.0 ",
36485
+ "__TSDBLevelFileIndex__ 0 0.0.0.0 ",
36486
+ "__TSDBCachedSymbolBa... 0 0.0.0.0 ",
36487
+ "__StreamingPubQueue__ 0 0.0.0.0 ",
36488
+ "__StreamingSubQueue__ 0 0.0.0.0 ",
36499
36489
  "admin 2882591513 1416 60.176.105.0 20861 2023.02.15T02:15:22.384 2023.02.15T02:24:16.307",
36500
- "=========================== ============ ======== ============== ========== =========================== ========================= ",
36501
- ""
36502
- ]
36503
- },
36504
- {
36505
- "type": "code",
36506
- "language": "console",
36507
- "value": [
36508
- "",
36509
- " $ update t set createTime=localtime(createTime), lastActiveTime=localtime(lastActiveTime) where not userId like \"__%__\"",
36510
- ""
36511
- ]
36512
- },
36513
- {
36514
- "type": "text",
36515
- "value": [
36516
- "================================= ============ ======== ============== ========== ======================= ========================= ",
36517
- "userId sessionId memSize remoteIP remotePort createTime lastActiveTime ",
36518
- "================================= ============ ======== ============== ========== ======================= =========================",
36519
- "__DimensionalTable__ 0 0.0.0.0 ",
36520
- "",
36521
- "__SharedTable__ 0 0.0.0.0 ",
36522
- "",
36523
- "__OLAPTablet__ 0 0.0.0.0 ",
36524
- "",
36525
- "__OLAPCacheEngine__ 0 0.0.0.0 ",
36526
- "",
36527
- "__OLAPCachedSymbolBa... 0 0.0.0.0 ",
36528
- "",
36529
- "__DFSMetadata__ 2769 0.0.0.0 ",
36530
- "",
36531
- "__TSDBCacheEngine__ 0 0.0.0.0 ",
36532
- "",
36533
- "__TSDBLevelFileIndex__ 0 0.0.0.0 ",
36534
- "",
36535
- "__TSDBCachedSymbolBa... 0 0.0.0.0 ",
36536
- "",
36537
- "__StreamingPubQueue__ 0 0.0.0.0 ",
36538
- "",
36539
- "__StreamingSubQueue__ 0 0.0.0.0 ",
36540
- "",
36541
- "admin 1195587396 1416 60.176.105.0 20874 2023.02.14T21:26:14.004 2023.02.14T21:27:27.463",
36542
- "================================= ============ ======== ============== ========== ======================= ========================= "
36490
+ "=========================== ============ ======== ============== ========== =========================== ========================= "
36543
36491
  ]
36544
36492
  }
36545
36493
  ]
@@ -44478,7 +44426,7 @@
44478
44426
  {
44479
44427
  "type": "text",
44480
44428
  "value": [
44481
- "`X` 可以是标量、数据对、向量、矩阵或内存表。"
44429
+ "`X` 可以是标量、数据对、向量、字典、矩阵或内存表。"
44482
44430
  ]
44483
44431
  }
44484
44432
  ]
@@ -44490,7 +44438,9 @@
44490
44438
  {
44491
44439
  "type": "text",
44492
44440
  "value": [
44493
- "用于检查是否是 NULL 值。如果元素是 NULL，返回 true。"
44441
+ "用于检查是否是 NULL 值。如果元素是 NULL，返回 true。",
44442
+ "",
44443
+ "注意：自 2.00.5 版本开始，当 *X* 是字典、元组、数据向量或表时，该函数将检查每一行中的元素是否是 NULL 值，返回一个具有相同维度的字典、元组或表。"
44494
44444
  ]
44495
44445
  }
44496
44446
  ]
@@ -48814,7 +48764,7 @@
48814
48764
  "",
48815
48765
  "`ub` 表示变量的上界。",
48816
48766
  "",
48817
- "`method` 是字符串，表示算法，目前支持'simplex'和'interior-point'。如果算法为'interior-point'，当问题规模较大时，性能会比'simplex'算法更高，但是精度可能不如'simplex'算法。"
48767
+ "`method` 是字符串，表示算法，目前支持'simplex'和'interior-point'。推荐使用 simplex 算法，部分特殊场景下建议使用 interior-point 算法。"
48818
48768
  ]
48819
48769
  }
48820
48770
  ]
@@ -54040,12 +53990,12 @@
54040
53990
  "========== ====== =======",
54041
53991
  "label col1 col2 ",
54042
53992
  "========== ====== =======",
54043
- "2020.04.06 1 9 ",
54044
- "2020.04.07 1 9 ",
54045
- "2020.04.09 4 ",
54046
- "2020.04.11 4 10 ",
54047
- "2020.04.12 8 10 ",
54048
- "2020.04.15 6 2 ",
53993
+ "2020.01.06 1 9 ",
53994
+ "2020.01.07 1 9 ",
53995
+ "2020.01.09 4 ",
53996
+ "2020.01.11 4 10 ",
53997
+ "2020.01.12 8 10 ",
53998
+ "2020.01.15 6 2 ",
54049
53999
  "========== ====== =======",
54050
54000
  ""
54051
54001
  ]
@@ -54065,12 +54015,12 @@
54065
54015
  "========== ======= =======",
54066
54016
  "label col1 col2 ",
54067
54017
  "========== ======= =======",
54068
- "2020.04.06 1 9 ",
54069
- "2020.04.07 1 9 ",
54070
- "2020.04.09 2.5 9 ",
54071
- "2020.04.11 2.5 9.5 ",
54072
- "2020.04.12 4.3333 9.5 ",
54073
- "2020.04.15 6 6 ",
54018
+ "2020.01.06 1 9 ",
54019
+ "2020.01.07 1 9 ",
54020
+ "2020.01.09 2.5 9 ",
54021
+ "2020.01.11 2.5 9.5 ",
54022
+ "2020.01.12 4.3333 9.5 ",
54023
+ "2020.01.15 6 6 ",
54074
54024
  "========== ======= =======",
54075
54025
  "",
54076
54026
  "相关函数：:doc:`../a/avg`"
@@ -58529,11 +58479,11 @@
58529
58479
  "value": [
58530
58480
  "若 *X* 为向量，计算 *X* 中出现次数最多的值。",
58531
58481
  "",
58532
- "若 *X* 为矩阵，计算其每列中出现次数最多的值，返回一个向量。",
58482
+ "若 *X* 为矩阵/表，计算其每列中出现次数最多的值，返回一个向量/表。",
58533
58483
  "",
58534
- "若 *X* 为表，计算其每列中出现次数最多的值，返回一个表。",
58484
+ "该函数通过 hash table 统计 *X* 中唯一值（key）出现的次数，当有多个次数最多的 key 时，返回 hash table 中的第一个 key。与所有其它聚合函数一致，该函数在计算时忽略NULL值。",
58535
58485
  "",
58536
- "与所有其它聚合函数一致，计算时忽略NULL值。"
58486
+ "注意：对于不同数据类型，该函数采用的 hash 算法不相同，因此输出结果可能不同。"
58537
58487
  ]
58538
58488
  }
58539
58489
  ]
@@ -64689,9 +64639,9 @@
64689
64639
  "value": [
64690
64640
  "`ds` 是存储在元组中的数据源集合。它通常是由 :doc:`../s/sqlDS` 函数生成。",
64691
64641
  "",
64692
- "`Y` 是一个字符串，表示 *ds* 表示的表中因变量的列名。",
64642
+ "`Y` 是一个字符串，表示 *ds* 表中因变量的列名。",
64693
64643
  "",
64694
- "`X` 是字符串标量或向量，表示 *ds* 表示的表中自变量的列名。",
64644
+ "`X` 是字符串标量或向量，表示 *ds* 表中自变量的列名。",
64695
64645
  "",
64696
64646
  "`intercept` 是一个布尔变量，指示是否包含回归中的截距。默认值是true。当它为true时，系统自动给 *X* 添加一列 \"1\" 以生成截距。",
64697
64647
  "",
@@ -64961,7 +64911,20 @@
64961
64911
  {
64962
64912
  "type": "text",
64963
64913
  "value": [
64964
- "按元素逐个返回 *X* 逻辑或 *(OR)Y* 的结果。"
64914
+ "按元素逐个返回 *X* 逻辑或 *(OR)Y* 的结果。",
64915
+ "",
64916
+ "注意：若 or 或 || 的操作数包含 NULL 时，|| 返回的对应结果为 NULL，而 or 针对不同 server 版本，返回的结果不同。",
64917
+ "",
64918
+ "* 对于小于 2.00.9.4 的版本，or 返回的对应结果为 NULL。",
64919
+ "* 对于 2.00.9.4 及以上版本，or 返回的结果由配置项 logicOrIgnoreNull 控制，见下表：",
64920
+ "",
64921
+ "======== ========= ======================================== =============================================",
64922
+ "操作数 操作数 返回值（logicOrIgnoreNull= true 时） 返回值（logicOrIgnoreNull= false 时）",
64923
+ "======== ========= ======================================== =============================================",
64924
+ "非零 NULL true NULL",
64925
+ "零 NULL true NULL",
64926
+ "NULL NULL true NULL",
64927
+ "======== ========= ======================================== ============================================="
64965
64928
  ]
64966
64929
  }
64967
64930
  ]
@@ -100946,16 +100909,16 @@
100946
100909
  "value": [
100947
100910
  "`X` 是一个向量。",
100948
100911
  "",
100949
- "`limit` 是一个标量或两个元素组成的向量，表示相对于未屏蔽数据的数目，数组的每一侧要掩盖的百分比，取值为0到1之间。若为标量，表示每侧均要掩盖的百分比。若X有n个元素，第(n * limit[0])个最小的元素和第(n * limit[1])个最大的元素被屏蔽，未屏蔽的数据总数为n *(1.-sum(limit))。若 *limit* 中一个元素为0，表示此侧不掩盖。",
100912
+ "`limit` 是一个标量或两个元素组成的向量，表示相对于未屏蔽数据的数目，数组的每一侧要掩盖的百分比，取值为0到1之间。若为标量，表示每侧均要掩盖的百分比。若X有n个元素（包括NULL值），第(n \\* limit[0])个最小的元素和第(n \\* limit[1])个最大的元素被屏蔽，未屏蔽的数据总数为n \\*(1-sum(limit))。若 *limit* 中一个元素为0，表示此侧不掩盖。",
100950
100913
  "",
100951
100914
  "`inclusive` 是一个标量或两个元素组成的向量，表示在每一侧被屏蔽的数据数量应被截断(true)还是四舍五入(false)。",
100952
100915
  "",
100953
- "`nanPolicy` 是一个字符串，表示如何处理NULL值。可取以下值，默认值为‘upper'。",
100916
+ "`nanPolicy` 是一个字符串，表示如何处理NULL值。可取以下值，默认值为'upper'。",
100954
100917
  "",
100955
100918
  "* 'upper': 将NULL值视为最大值进行掩盖。",
100956
100919
  "* 'lower': 将NULL值视为最小值进行掩盖。",
100957
- "* 'raise': 抛出异常",
100958
- "* 'omit': 忽略NULL值"
100920
+ "* 'raise': 抛出异常。",
100921
+ "* 'omit': 不掩盖NULL值。"
100959
100922
  ]
100960
100923
  }
100961
100924
  ]
package/index.js CHANGED
@@ -1581,6 +1581,8 @@ export function formati(obj, index, options = {}) {
1581
1581
  const { base, data } = obj.value;
1582
1582
  return format(DdbType.string, base[data[index]], obj.le, options);
1583
1583
  }
1584
+ case DdbType.void:
1585
+ return format(obj.type, obj.value, obj.le, options);
1584
1586
  case DdbType.uuid:
1585
1587
  case DdbType.int128:
1586
1588
  case DdbType.ipaddr: