join()
本章介绍join()函数的多种用法。
join()
描述：
多序列连接
语法：
join(Ai:Fi,xj,..;…)
备注：
将多个序列Ai按照关联字段/关联表达式xj和x1相等的关系连接，产生以Fi,…为字段的序表，Fi赋值为Ai对应成员，引用原排列Ai中的记录，xj全省略时用Ai的主键。某个xj 省略时该项条件不必匹配。
不管是多少个排列之间关联，都是和A1中的x1相等判断，因此是一表对多表的关系。
选项：
|
@f |
全连接，找不到匹配值时，则与null对应 |
|
@1 |
左连接（注意：这里是数字1，不是字母l） |
|
@m |
假定所有Ai针对xj,…有序，则用归并法计算 |
|
@p |
按位置连接，忽略xj参数 |
|
@i |
仅用于过滤A1，忽略Fi参数，与@f@1互斥 |
|
@d |
仅用于过滤A1，只保留找不到的，忽略Fi参数，与@f@1互斥 |
参数：
|
Fi |
结果序表的字段名 |
|
Ai |
被连接的序列或排列 |
|
xj |
连接字段/表达式 |
返回值：
所有字段均为引用字段的新序表
示例：
|
|
A |
|
|
1 |
=demo.query("select top 3 EID,NAME from EMPLOYEE").keys(EID) |
|
|
2 |
=demo.query("select top 3 EID,NAME from FAMILY").keys(EID) |
|
|
3 |
=join(A1:Employee,EID;A2:Familymembers,EID) |
常规连接，不匹配的项丢弃，每个字段值都是ref字段，指向原序表的一条记录 |
|
4 |
=join@f(A1:Employee,EID;A2:Familymembers,EID) |
全连接，无匹配项的用null |
|
5 |
=join@1(A1:Employee,EID;A2:Familymembers,EID) |
左连接，以第一个序表为基准，无匹配项的用null |
|
6 |
=join@m(A1:Employee,EID;A2:Familymembers,EID) |
假定所有关联字段同序，用归并法计算；如果不同序则会出错 |
|
7 |
=join@p(A1:Employee;A2:Familymembers) |
|
|
8 |
=join(A1:Employee;A2:Familymembers) |
|
|
9 |
=join(A1:Employee1;A2:Familymembers1) |
|
|
10 |
=join(A8:Employee2;A9:Familymembers2) |
|
|
11 |
=join@i(A1;A2) |
过滤A1，保留找到的 |
|
12 |
=join@d(A1;A2) |
过滤A1，保留找不到的 |
相关概念：
A.join()
描述：
序表与排列外键式连接
语法：
A.join(C:.,T:K,x:F,…; …;…)
备注：
用序表/排列A的字段C,…匹配序表/排列T的键找到相应记录，在A上拼接T中的表达式x，作为字段F添加到A 上形成新序表。
K只能省略或者是#，K省略时默认为T的键；K值为#时表示用T表记录的序号，即外键序号化处理，简单概括就是维表的主键是从1开始的自然数，也就是表记录所在行号，这种情况下就可以用键值直接按行号定位维表记录，从而加快与维表关联的速度，进一步提升性能。
如果F在A中已存在则改写现有字段。时间键值被省略时用now()。
选项：
|
@i |
匹配不上的外键删除整条记录，缺省将填成null。当参数x:F省略时，只做针对A的过滤操作。 |
|
@o(F;…) |
原记录整个作为字段F生成新记录，此时相当于x为~ |
|
@d |
当参数x:F省略时，删除匹配上外键的整条记录，只做针对A的过滤操作。 |
|
@k |
当x是~时，在结果序表中记录F和C:…对应关系用于识别预关联外键 |
|
@m |
A对C有序，T对K有序，此时可用归并方式计算 |
参数：
|
A |
序表/排列 |
|
C |
A的外键，多个时以冒号隔开 |
|
T |
序表/排列 |
|
K |
T的键 |
|
x |
T的字段表达式，x可以是~和#，#表示记录在T中的序号，找不到填为null |
|
F |
表达式x的字段名 |
返回值：
序表/排列
示例：
|
|
A |
|
|
1 |
=connect("demo").query("SELECT * FROM CITIES") |
CITIES表数据内容
|
|
2 |
=connect("demo").query("SELECT * FROM STATECAPITAL where STATEID<30").keys(STATEID) |
STATECAPITAL表数据内容：
|
|
3 |
=A1.join(STATEID,A2,CAPITAL) |
将CITIES表与STATECAPITAL表外键式连接，参数K缺省为的STATECAPITAL键，即STATEID，并将STATECAPITAL表中的字段CAPITAL拼接到中成为新序表
|
|
4 |
=A1.join(STATEID,A2:#,CAPITAL) |
可以看到STATEID字段是从1开始的自然数，与STATECAPITAL表的记录号是一致的，所以可以将参数K设为#，表示用STATECAPITAL表的序号，可提高计算效率，返回结果与A3相同 |
|
5 |
=A1.join@i(STATEID,A2,CAPITAL) |
使用@i选项，匹配不上的外键删除整条记录，缺省将填成null
|
|
6 |
=A1.join@i(STATEID,A2) |
使用@i选项，当参数x:F省略时，只做针对CITIES表的过滤操作
|
|
7 |
=A1.join@d(STATEID,A2) |
使用@d选项，当参数x:F省略时，删除匹配上外键的整条记录，只做针对CITIES表的过滤操作
|
|
8 |
=A1.join(STATEID,A2,abc) |
x参数值在A2中找不到则填为nul
|
|
9 |
=A1.join@k(STATEID,A2,~:STATES) |
使用@k选项，当参数x是~时，在结果序表中记录STATES和STATEID对应关系用于识别预关联外键
|
|
10 |
=A1.join@o(cities;STATEID,A2,CAPITAL) |
使用@o选项，原记录整个作为字段cities生成新记录，此时相当于参数x为~
|
|
11 |
=A1.join(STATEID,A2,CAPITAL:NAME) |
如果NAME在CITIES表中已存在则改写现有字段
|
归并方式计算：
|
|
A |
|
|
1 |
=connect("demo").query("SELECT * FROM CITIES").sort(STATEID) |
CITIES表数据内容
|
|
2 |
=connect("demo").query("SELECT * FROM STATECAPITAL where STATEID<30").keys(STATEID).sort(STATEID) |
STATECAPITAL表数据内容：
|
|
3 |
=A1.join@m(STATEID,A2,CAPITAL) |
CITIES对STATEID有序，STATECAPITAL对K有序，使用@m选项，此时可用归并方式计算
|
ch.join()
描述：
管道与排列外键式连接
语法：
ch.join(C:.,T:K,x:F,…; …;…)
备注：
用管道ch中的字段C,…匹配序表/排列T的键找到相应记录，在ch上拼接T中的表达式x，作为字段F添加到ch上形成管道。
K只能省略或者是#，K省略时默认为T的键；K值为#时表示用T表记录的序号，即外键序号化处理，简单概括就是维表的主键是从1开始的自然数，也就是表记录所在行号，这种情况下就可以用键值直接按行号定位维表记录，从而加快与维表关联的速度，进一步提升性能。
如果F在ch中已存在则改写现有字段。时间键值被省略时用now()。
选项：
|
@i |
匹配不上的外键删除整条记录，缺省将填成null |
|
@o(F;…) |
原记录整个作为字段F生成新记录，x可以是~，表示cs的整条记录 |
|
@d |
当参数x:F省略时，删除匹配上外键的整条记录，只做针对ch的过滤操作。 |
|
@m |
A对C有序，T对K有序，此时可用归并方式计算 |
参数：
|
ch |
管道 |
|
C |
管道ch的外键，多个时以冒号隔开 |
|
T |
序表/排列 |
|
K |
T的键 |
|
x |
T的字段表达式 |
|
F |
表达式x的字段名 |
返回值：
管道
示例：
|
|
A |
|
|
1 |
=demo.cursor("select EID,NAME,SALARY from EMPLOYEE order by EID" ) |
|
|
2 |
=demo.query("select * from PERFORMANCE order by EMPLOYEEID").keys(EMPLOYEEID) |
|
|
3 |
=channel() |
创建管道 |
|
4 |
=channel() |
|
|
5 |
=channel() |
|
|
6 |
=channel() |
|
|
7 |
=A1.push(A3,A4,A5,A6) |
将游标A1中的数据推送到管道A3、A4、A5和A6，此时数据不会立即被推送到管道。 |
|
8 |
=A3.join(EID,A2, BONUS+1:SALARY1) |
常规连接，匹配不上的外键的用null |
|
9 |
=A8.fetch() |
保留管道当前数据 |
|
10 |
=A4.join@i(EID,A2: #1, #3+1:SALARY1) |
#1表示第1个字段，#3表示第3个字段 |
|
11 |
=A10.fetch() |
|
|
12 |
=A5.join@i(EID,A2, BONUS+1:SALARY1) |
匹配不上的外键删除整条记录 |
|
13 |
=A12.fetch() |
|
|
14 |
=A6.join@o(F1;EID,A2,~.BONUS+1:SALARY1) |
原记录整个作为字段F1 |
|
15 |
=A14.fetch() |
|
|
16 |
=A1.fetch() |
|
|
17 |
=A3.result() |
|
|
18 |
=A4.result() |
|
|
19 |
=A5.result() |
结果同A18 |
|
20 |
=A6.result() |
|
cs.join()
描述：
游标与排列外键式连接
语法：
cs.join(C:.,T:K,x:F,…; …;…)
备注：
用游标cs中的字段C,…匹配T的键找到相应记录，在cs上拼接T中的表达式x，作为字段F添加到cs上，返回原游标。
K只能省略或者是#，K省略时默认为T的键；K值为#时表示用T表记录的序号，即外键序号化处理，简单概括就是维表的主键是从1开始的自然数，也就是表记录所在行号，这种情况下就可以用键值直接按行号定位维表记录，从而加快与维表关联的速度，进一步提升性能。
如果F在cs中已存在则改写现有字段。时间键值被省略时用now()。
支持多路游标。
选项：
|
@i |
匹配不上的外键删除整条记录，缺省将填成null |
|
@o(F;…) |
原记录整个作为字段F生成新记录，x可以是~，表示cs的整条记录 |
|
@d |
当参数x:F省略时，删除匹配上外键的整条记录，只做针对cs的过滤操作。 |
|
@m |
cs对C有序，T对K有序，此时可用归并方式计算 |
参数：
|
cs |
游标/多路游标 |
|
C |
游标cs的外键，多个时以冒号隔开 |
|
T |
序表/排列 |
|
K |
T的键 |
|
x |
T的字段表达式 |
|
F |
表达式x的字段名 |
返回值：
原游标cs
示例：
|
|
A |
|
|
1 |
=connect("demo").cursor("SELECT * FROM CITIES") |
CITIES表数据内容
|
|
2 |
=connect("demo").query("SELECT * FROM STATECAPITAL where STATEID<30").keys(STATEID) |
STATECAPITAL表数据内容：
|
|
3 |
=A1.join(STATEID,A2,CAPITAL) |
将CITIES表与STATECAPITAL表外键式连接，参数K缺省为的STATECAPITAL键，即STATEID，并将STATECAPITAL表中的字段CAPITAL拼接到中成为新序表
|
|
4 |
=A1.join(STATEID,A2:#,CAPITAL) |
可以看到STATEID字段是从1开始的自然数，与STATECAPITAL表的记录号是一致的，所以可以将参数K设为#，表示用STATECAPITAL表的序号，可提高计算效率，返回结果与A3相同 |
|
5 |
=A1.join@i(STATEID,A2,CAPITAL) |
使用@i选项，匹配不上的外键删除整条记录，缺省将填成null
|
|
6 |
=A1.join@i(STATEID,A2) |
使用@i选项，当参数x:F省略时，只做针对CITIES表的过滤操作
|
|
7 |
=A1.join@d(STATEID,A2) |
使用@d选项，当参数x:F省略时，删除匹配上外键的整条记录，只做针对CITIES表的过滤操作
|
|
8 |
=A1.join(STATEID,A2,abc) |
x参数值在A2中找不到则填为nul
|
|
9 |
=A1.join@k(STATEID,A2,~:STATES) |
使用@k选项，当参数x是~时，在结果序表中记录STATES和STATEID对应关系用于识别预关联外键
|
|
10 |
=A1.join@o(cities;STATEID,A2,CAPITAL) |
使用@o选项，原记录整个作为字段cities生成新记录，此时相当于参数x为~
|
|
11 |
=A1.join(STATEID,A2,CAPITAL:NAME) |
如果NAME在CITIES表中已存在则改写现有字段
|
相关概念：
cs.join ()
描述：
集群游标与排列外键式连接
语法：
cs.join(C:.,T:K,x:F,…; …;…)
备注：
用游标cs中的字段C,…匹配T的键找到相应记录，在cs上拼接T中的表达式x，作为字段F添加到cs上，返回原游标。
K只能省略或者是#，K省略时默认为T的键；K值为#时表示用T表记录的序号，即外键序号化处理，简单概括就是维表的主键是从1开始的自然数，也就是表记录所在行号，这种情况下就可以用键值直接按行号定位维表记录，从而加快与维表关联的速度，进一步提升性能。
如果F在cs中已存在则改写现有字段。时间键值被省略时用now()。
支持多路游标。
选项：
|
@c |
集群表有分布时，计算也均不做跨机引用，认为引用记录总在本机 |
参数：
|
cs |
游标/多路游标/集群游标 |
|
C |
游标cs的外键，多个时以冒号隔开 |
|
T |
集群内表 |
|
K |
T的键 |
|
x |
T的字段表达式 |
|
F |
表达式x的字段名 |
返回值：
原游标cs
示例：
|
|
A |
|
|
1 |
[192.168.18.143:8281] |
|
|
2 |
=file("emp_1.ctx":[2], A1) |
|
|
3 |
=A2.open() |
|
|
4 |
=A3.cursor() |
集群游标 |
|
5 |
[192.168.0.110:8281] |
|
|
6 |
=file("PERFORMANCE.ctx":[1],A5) |
|
|
7 |
=A6.open() |
|
|
8 |
=A7.cursor() |
|
|
9 |
=A8.memory() |
集群内表 |
|
10 |
=A4.join(EID,A9:EMPLOYEEID, BONUS*12:total) |
用集群游标中的字段EID匹配集群内表中的键EMPLOYEEID，并将集群内表中的表达式BONUS*12作为字段total 拼接到集群游标中，结果返回原游标 |
|
11 |
=A10.fetch() |
取游标中的数据：
|
