create-dwy 0.12.2 → 0.13.1

package/templates/claude-global/skills//346/225/260/346/215/256/345/272/223/dwy-dolphindb/references/official/progr/data_types_forms/Pair.md

@@ -0,0 +1,154 @@
+---
+source_url: https://docs.dolphindb.cn/zh/progr/data_types_forms/Pair.html
+fetched_at: 2026-05-19T09:00:29Z
+category: progr
+title: 数据对
+sha1: 460edfb0297ff23295f8eb49155f627bc85d0e5a
+---
+
+# 数据对
+
+## 概述
+
+数据对是只有两个值的特殊的向量。一个数据对包含了两个标量值。这两个标量值必须满足以下任一条件：
+
+- 它们的数据类型相同。
+- 它们都属于 INTEGRAL、FLOATING 或 DECIMAL 类别。
+
+数据对类型的数据可用于：
+
+1. **代表数据范围**
+
+   不包含上限的数据范围有以下几种情况：
+
+   1. 表示索引：
+
+      ```dolphindb
+      x=5 3 6 2;
+      x[1:3];
+      // output
+      [3,6]
+      a=rand(1000.0,20000000)
+      b=a.subarray(0:1000000);
+      m=matrix(1 2 3 4, 5 6 7 8, 9 10 11 12);
+      m;
+      ```
+
+      | #0 | #1 | #2 |
+      | --- | --- | --- |
+      | 1 | 5 | 9 |
+      | 2 | 6 | 10 |
+      | 3 | 7 | 11 |
+      | 4 | 8 | 12 |
+
+      ```dolphindb
+      m[1:2, 0:2];
+      ```
+
+      | #0 | #1 |
+      | --- | --- |
+      | 2 | 6 |
+   2. 表示 for-loop
+      的范围：
+
+      ```dolphindb
+      for(s in 1:3){print s};
+      // output
+      1
+      2
+      ```
+   3. 在 [bucket](../../funcs/b/bucket.html) 或 [bucketCount](../../funcs/b/bucketCount.html)
+      函数中：
+
+      ```dolphindb
+      bucket(4 0 1 3 2, 0:4, 2);
+      // output
+      [,0,0,1,1]
+      ```
+
+   其它情况下，数据范围均包含上限。
+
+   ```dolphindb
+   [5,6,8] between 1:6;
+   // output
+   [1,1,0]
+
+   t1 = table(`A`A`B as sym, 09:56:06 09:56:07 09:56:06 as time, 10.6 10.7 20.6 as price)
+   t2 = table(take(`A,10) join take(`B,10) as sym, take(09:56:00+1..10,20) as time, (10+(1..10)\10-0.05) join (20+(1..10)\10-0.05) as bid, (10+(1..10)\10+0.05) join (20+(1..10)\10+0.05) as offer, take(100 300 800 200 600, 20) as volume)
+   wj(t1, t2, -5:0, <avg(bid)>, `sym`time);
+   ```
+2. 表示矩阵的维度。例如，"2:5" 表示一个 2 乘 5 的矩阵。如果一个一维数组 x 有 10 个元素，x$2:5 表示把 x 转化为 2 乘 5
+   的矩阵，其中“$”表示转化。
+3. 创建 [table](../../funcs/t/table.html)
+   时指定容量和初始行数。
+
+   ```dolphindb
+   t=table(100:0, `date`sym`high`low`close, [DATE,SYMBOL,DOUBLE,DOUBLE,DOUBLE]);
+   ```
+
+## 创建数据对
+
+使用冒号 ":" 或 [pair](../../funcs/p/pair.html)
+函数来创建数据对数据。
+
+例如：
+
+```dolphindb
+1:3;
+3.4:7.8;
+1b:0b;
+
+# 返回：
+1:0
+
+true:false;
+
+# 返回：
+1:0
+
+2013.06.13:2013.11.10;
+5 pair 6;
+
+# 返回：
+5:6
+
+`Hello:`World;
+# 返回：
+"Hello" : "World"
+```
+
+## 访问数据对
+
+用 X[Y] 的形式访问数据对数据。Y 可以是整数也可以是整数向量，或者数据对。例如：
+
+```dolphindb
+x = 3:6;
+x[1];
+```
+
+返回：6
+
+```dolphindb
+x[0 1];
+```
+
+返回：[3,6]
+
+## 修改数据对
+
+数据对中的两个值可以分别被修改。例如：
+
+```dolphindb
+x=3:6;
+x[0]=4;
+x;
+```
+
+返回：4:6
+
+```dolphindb
+x=3:6+1;
+x;
+```
+
+返回：4:7

package/templates/claude-global/skills//346/225/260/346/215/256/345/272/223/dwy-dolphindb/references/official/progr/data_types_forms/Scalar.md

@@ -0,0 +1,60 @@
+---
+source_url: https://docs.dolphindb.cn/zh/progr/data_types_forms/Scalar.html
+fetched_at: 2026-05-19T09:00:28Z
+category: progr
+title: 标量
+sha1: 0fe3d9b0d548d495049183bce82b052e8d32b9dd
+---
+
+# 标量
+
+标量是只有一个值的变量或常数。与之对比，所有其他数据形式可以容纳多个对象。
+
+## 示例
+
+- 布尔型标量：
+  - 1b
+  - true
+- 整形标量：5
+- 字符型标量：119c
+- 字符串型标量：`Hello
+- 单精度浮点型标量：1.2f
+- 双精度浮点型标量：20987.58F
+- 日期标量：2013.06.13
+- 月份标量：2012.12M
+- 时间戳标量：2016.10.12T00:00:00.001
+- 时间标量：12:32:56.356
+
+可以通过 [form](../../funcs/f/form.html) 函数的返回值（数据形式标识符）判断一个变量或常数的数据形式：
+
+```dolphindb
+x=5;
+form x;
+```
+
+返回值：0。
+
+由于 `form` 函数的数据形式标识符与数据形式的对应关系如下：
+
+| 0 | 1 | 2 | 3 | 4 | 5 | 6 |
+| --- | --- | --- | --- | --- | --- | --- |
+| 标量 | 向量 | 数据对 | 矩阵 | 集合 | 字典 | 表 |
+
+因此可以判断，*x* 是一个标量。
+
+## 标量计算
+
+1. 对两个标量进行二元运算：结果是一个标量。
+
+   ```dolphindb
+   add(1,2)
+   // output
+   3
+   ```
+2. 对一个标量和一个向量进行二元运算：结果是一个向量。
+
+   ```dolphindb
+   mul(1 2 3, 3);
+   // output
+   [3,6,9]
+   ```

package/templates/claude-global/skills//346/225/260/346/215/256/345/272/223/dwy-dolphindb/references/official/progr/data_types_forms/Set.md

@@ -0,0 +1,179 @@
+---
+source_url: https://docs.dolphindb.cn/zh/progr/data_types_forms/Set.html
+fetched_at: 2026-05-19T09:00:42Z
+category: progr
+title: 集合
+sha1: a2c70c978db43173515c8d622697949d515f7912
+---
+
+# 集合
+
+## 概述
+
+集合中的元素没有重复值。它支持除函数或句柄之外的所有数据类型。
+
+## 创建集合
+
+可用函数 [set](../../funcs/s/set.html) 来创建集合。
+
+```dolphindb
+x=set([5,5,3,4]);
+x;
+
+set(4,3,5)
+
+y=set(8 9 9 4 6);
+y;
+
+set(6,4,9,8)
+```
+
+## 集合的操作
+
+交集 (&)
+
+```dolphindb
+x & y;
+
+set(4)
+```
+
+并集 (|)
+
+```dolphindb
+x | y;
+
+set(8,9,6,5,3,4)
+```
+
+子集 (-)
+
+```dolphindb
+x-y;
+
+set(3,5)
+
+y-x;
+
+set(6,9,8)
+```
+
+对称差 (^)
+
+```dolphindb
+y^x;
+
+set(5,3,6,9,8)
+x^y;
+
+set(8,5,3,6,9)
+```
+
+## 集合运算符
+
+可用以下运算符对两个集合进行比较：<, <=, >, >=, ==, !=, 和 in。
+
+如果X是Y的一个子集，那么 X<=Y。
+
+```dolphindb
+x=set([4, 6]);
+x;
+
+set(6,4)
+y=set(8 9 9 4 6);
+y;
+
+set(6,4,9,8)
+
+x<=y;
+
+1
+// x是y的子集
+
+y>=x;
+
+1
+```
+
+如果X和Y有完全一样的元素，那么X==Y；如果它们的元素不完全相同，那么 X!=Y。
+
+```dolphindb
+z=set(8 9 4 6);
+y==z;
+
+1
+// y和z所含的元素完全相同
+
+y in z;
+
+[1,1,1,1]
+
+x in z;
+
+[1,1]
+
+x!=z;
+
+1
+
+z>=x;
+
+1
+```
+
+## 修改集合
+
+向集合中追加数据：
+
+```dolphindb
+y=set(8 9 9 4 6);
+y;
+
+set(6,4,9,8)
+
+y.append!(3);
+
+set(3,6,4,9,8)
+```
+
+用函数 [erase!](../../funcs/e/erase_.html) 从集合中删除一个元素。
+
+```dolphindb
+y.erase!(3);
+
+set(6,4,9,8)
+```
+
+用函数 [clear!](../../funcs/c/clear_.html) 清空一个集合。
+
+```dolphindb
+y.clear!();
+
+set()
+```
+
+## 在集合中查询
+
+由于集合在实现上用的是哈希表，因此搜索集合中的元素通常比搜索向量中的元素要快。但是，建立哈希表可能需要大量的时间。一般只有在需要重复搜索的时候才会去建立一个集合。
+
+```dolphindb
+x=1..20000000;
+shuffle!(x);
+
+[3123455,13242159,6705807,6107095,10703880,14924328,4435139,19888822,11885962,8535552,17956796,7349822,14777562,13918572,8570589,10706038,6508545,12362405,12742059,16485330,14219242,16979158,6060092,18157360,16132016,12510810,14509873,4402923,6277378,11762392...]
+
+timer y=set(x);
+
+Time elapsed: 8101.53 ms
+y;
+
+set(14261183,6712062,10066096,14147249,10177467,6928135,15470317,1348143,19503158,9781988,12709425,3357820,7105084,8740796,10555072,15523011,17319678,19672048,5332111,17767151,4598557,10395083,9715094,8630928,12345383,12834953,11278593,2637131,11464014,14018258...)
+
+timer(1000){19884856 in x};
+
+Time elapsed: 1191.52 ms
+
+timer(1000){19884856 in y};
+
+Time elapsed: 0 ms
+```

package/templates/claude-global/skills//346/225/260/346/215/256/345/272/223/dwy-dolphindb/references/official/progr/data_types_forms/Table.md

@@ -0,0 +1,338 @@
+---
+source_url: https://docs.dolphindb.cn/zh/progr/data_types_forms/Table.html
+fetched_at: 2026-05-19T09:00:46Z
+category: progr
+title: 表
+sha1: f883ce5a8c974bc2e31b0d9f96a49a3688d41664
+---
+
+# 表
+
+表是数据库的重要组成部分，用于表达数据以及这些数据之间的联系。表由许多列组成，每一列都必须指定列名和数据类型，并且存储了对应类型的数据。可以对表中的数据进行增加，删除，更新和查询操作。
+
+DolphinDB 中数据表有以下几类：
+
+- 内存表
+
+  - 普通内存表（[table](../../funcs/t/table.html)），最基础的表结构，常用于临时数据存储。
+  - 索引内存表（[indexedTable](../../funcs/i/indexedTable.html)），适用于存取键值对数据的场景，范围查询性能更优。
+  - 键值内存表（[keyedTable](../../funcs/k/keyedTable.html)），适用于存取键值对数据的场景，单点查性性能更优。
+  - 流数据表（[streamTable](../../funcs/s/streamTable.html), [haStreamTable](../../funcs/h/haStreamTable.html)），用于流数据的实时接收和存储。
+  - mvcc 内存表（[mvccTable](../../funcs/m/mvccTable.html)），适用于频繁查询，但写入、更新、删除频率不高的场景。
+  - 分区内存表（[createPartitionedTable](../../funcs/c/createPartitionedTable.html)），各分区可并行计算，适用于数据量较大且对性能有要求的场景。
+  - 缓存表（[cachedTable](../../funcs/c/cachedTable.html)），提供了缓存并定时更新数据的功能，适用于同步实时性要求不高的数据。
+  - 内存在线事务处理表（[createIMOLTPTable](../../funcs/c/createIMOLTPTable.html)），通过主键和索引加速查询，适用于对响应时间有严格要求的低延时场景。
+- 分布式表
+
+  - 分布式分区表（[createPartitionedTable](../../funcs/c/createPartitionedTable.html)），最常见的分布式表结构，多用于大规模数据存储和高并发请求的场景。
+  - 维度表（[createDimensionTable](../../funcs/c/createdimensiontable.html)），在分布式数据库中没有分区的表，适用于存储不频繁更新的小数据集。
+
+## 创建表
+
+本节介绍内存表的创建。创建内存表时，表名和列名必须由中文或英文字母、数字或下划线 (\_) 组成，且必须以中文或英文字母开头。
+
+2.00.2 版本开始，由 [pivot by](../sql/pivotBy.html), [addColumn](../../funcs/a/addColumn.html)
+操作产生的列名，支持包含特殊字符，或以数字开头。
+
+请注意：
+
+- 包含特殊符号或以数字开头的列名在 SQL 中引用时，需将列名用双引号引用，并在其之前使用下划线作为标识，例如：\_"IBM.N",
+  \_"000001.SH"；
+- 列名包含特殊符号或以数字开头的列亦可通过 tb["col"]，tb."col" 的方式访问。
+- 进行 pivot by 需要对空数据赋予列名时，会赋予列名"NULL"，引用时需要遵循上述第一条规则（\_"NULL")。
+
+为了与之前版本的代码兼容，引入了配置项 *removeSpecialCharInColumnName*，默认值是
+false，表示允许列名包含特殊字符。如果要跟以前兼容，可以将该变量配置为 true。
+
+例1：创建内存表的三种方式。
+
+（1）`table(X as col, [X1 as col1], [X2 as col2],
+.....)`
+
+```dolphindb
+t0=table(1 2 3 as a, `x`y`z as b, 10.8 7.6 3.5 as c);
+t0;
+```
+
+| a | b | c |
+| --- | --- | --- |
+| 1 | x | 10.8 |
+| 2 | y | 7.6 |
+| 3 | z | 3.5 |
+
+（2）`table(X, [X1], [X2], .....)`
+
+```dolphindb
+x=1 2 3;
+y=4 5 6;
+t1=table(x,y);
+t1;
+```
+
+| x | y |
+| --- | --- |
+| 1 | 4 |
+| 2 | 5 |
+| 3 | 6 |
+
+（3）`table(capacity:size, colNames, colTypes)`
+
+```dolphindb
+t2=table(200:10, `name`id`value, [STRING,INT,DOUBLE]);
+t2;
+```
+
+| name | id | value |
+| --- | --- | --- |
+|  | 0 | 0 |
+|  | 0 | 0 |
+|  | 0 | 0 |
+|  | 0 | 0 |
+|  | 0 | 0 |
+|  | 0 | 0 |
+|  | 0 | 0 |
+|  | 0 | 0 |
+|  | 0 | 0 |
+|  | 0 | 0 |
+
+例2：列名包含特殊符号的内存表创建与查询。
+
+```dolphindb
+t3=table(1 2 3 as `_a, 4 5 6 as "2 ab");
+t3;
+```
+
+| \_a | 2 ab |
+| --- | --- |
+| 1 | 4 |
+| 2 | 5 |
+| 3 | 6 |
+
+```dolphindb
+select _"_a" as "_aa", _"2 ab" as "2ab" from t3;
+```
+
+| \_aa | 2ab |
+| --- | --- |
+| 1 | 4 |
+| 2 | 5 |
+| 3 | 6 |
+
+例3：将向量或矩阵转换为表。
+
+```dolphindb
+a=([1,2],[3.2,4.3],[2019.01.02,2019.05.03]);
+table(a);
+```
+
+| C0 | C1 | C2 |
+| --- | --- | --- |
+| 1 | 3.2 | 2019.01.02 |
+| 2 | 4.3 | 2019.05.03 |
+
+```dolphindb
+m=1..12$3:4;
+table(m);
+```
+
+| C0 | C1 | C2 | C3 |
+| --- | --- | --- | --- |
+| 1 | 4 | 7 | 10 |
+| 2 | 5 | 8 | 11 |
+| 3 | 6 | 9 | 12 |
+
+## 查看表
+
+使用 [rows](../../funcs/r/rows.html) 或 [size](../../funcs/s/size.html) 函数查看表的行数
+
+```dolphindb
+rows(t1);
+// output: 3
+size(t1);
+// output: 3
+```
+
+使用 [cols](../../funcs/c/cols.html) 函数查看表的列数
+
+```dolphindb
+cols(t1);
+// output: 2
+```
+
+使用 [schema](../../funcs/s/schema.html) 函数查看表的结构
+
+```dolphindb
+schema(t1);
+/*
+chunkPath->
+partitionColumnIndex->-1
+colDefs->
+name typeString typeInt extra comment
+---- ---------- ------- ----- -------
+x    INT        4                    
+y    INT        4                    
+*/
+```
+
+## 访问表
+
+DolphinDB 访问表的方式很灵活，既可以使用 SQL 语句，也可以使用类似 python 的语法。SQL 访问表的具体例子详见
+[SQL语句](../sql/sql_intro.html "DolphinDB 中 SQL 语句的基本语法和用法")，下例主要说明如何通过类似 python
+的语法读取表数据。
+
+例1：可使用 <tableName>[X,Y] 访问表，其中 X 和 Y 可以是标量或数据对。X 用于选择行，Y
+用于选择列。表索引的范围从 0 开始，不包含上限值。例如，1:3 包括 1 和 2。类似地，2:0 表示 1 和 0。
+
+```dolphindb
+t1[1:3, 1];
+```
+
+| y |
+| --- |
+| 5 |
+| 6 |
+
+```dolphindb
+t1[,t1.columns()-1];
+```
+
+| y |
+| --- |
+| 4 |
+| 5 |
+| 6 |
+
+```dolphindb
+t1.keys();
+
+["x","y"]
+
+t1.values();
+
+([1,2,3],[4,5,6])
+```
+
+例2：条件访问数据表。
+
+```dolphindb
+t1[t1.x>2];      // 查询 x>2 的行
+
+or
+t1[t1[`x]>2];
+```
+
+| x | y |
+| --- | --- |
+| 3 | 6 |
+
+```dolphindb
+t1[t1.x in (1 3)];       // 查询 x=1 或 x=3 的行
+```
+
+| x | y |
+| --- | --- |
+| 1 | 4 |
+| 3 | 6 |
+
+```dolphindb
+t1[t1.x>1 && t1.y<6];       // 查询 x>1 和 y<6 的行
+```
+
+| x | y |
+| --- | --- |
+| 2 | 5 |
+
+## 更新表
+
+例1：根据条件更新内存表。
+
+```dolphindb
+t1[`x, t1[`x] < 2] = 3
+
+or
+t1[`x, <x < 2>] = 3
+```
+
+| x | y |
+| --- | --- |
+| 3 | 4 |
+| 2 | 5 |
+| 3 | 6 |
+
+例2：通过赋值语句添加或更新表。
+
+创建一个空表并插入数据：
+
+```dolphindb
+t = table(100:0, `x`y`z, `STRING`DATE`DOUBLE);
+// 创建一个具有三列 x, y, z 的表，数据类型分别为 STRING, DATE, DOUBLE。表的容量为 100，初始长度为 0。
+
+t;
+```
+
+| x | y | z |
+| --- | --- | --- |
+|  |  |  |
+
+```dolphindb
+insert into t values(take(`MS,3),2010.01.01 2010.01.02 2010.01.03, 1 2 3);
+t;
+```
+
+| x | y | z |
+| --- | --- | --- |
+| MS | 2010.01.01 | 1 |
+| MS | 2010.01.02 | 2 |
+| MS | 2010.01.03 | 3 |
+
+```dolphindb
+t=table(1 2 3 as id, 4 5 6 as value);
+t;
+```
+
+| id | value |
+| --- | --- |
+| 1 | 4 |
+| 2 | 5 |
+| 3 | 6 |
+
+```dolphindb
+t[`id`name]=[7 8 9, `IBM`MSFT`GOOG];
+t;
+```
+
+| id | value | name |
+| --- | --- | --- |
+| 7 | 4 | IBM |
+| 8 | 5 | MSFT |
+| 9 | 6 | GOOG |
+
+例3：通过 SQL update 语句更新表。
+
+```dolphindb
+n=10
+colNames = `time`sym`id
+colTypes = [DATE,SYMBOL,INT]
+t = table(n:0, colNames, colTypes)
+insert into t values(2020.01.05 13:30:10.008, `A1, 1)
+insert into t values(2020.01.06 13:30:10.008, `A2, 2)
+// 插入数据的时间类型与内存表时间类型不一致时，会自动转换为内存表时间列的类型。
+insert into t values(2020.06M, `A3, 3)
+
+update t set time=2020.06.13 13:30:10 where sym=`A1
+select * from t
+```
+
+| time | sym | id |
+| --- | --- | --- |
+| 2020.06.13 | A1 | 1 |
+| 2020.01.06 | A2 | 2 |
+| 2020.06.01 | A3 | 3 |
+
+## 删除表
+
+- 通过函数 [dropTable](../../funcs/d/dropTable.html) 和 [truncate](../../funcs/t/truncate.html) 可以一次性删除所有分布式表数据。
+- 通过 [delete](../sql/delete.html)
+  语句可以删除指定条件的表（内存表或分布式表）数据。
+
+详情参考 [DropDatabaseandTable](../../db_distr_comp/db_oper/drop_db_tb.html) 页面的说明。