update

update 语句不仅支持更新内存表，也支持更新没有正在写入数据的 DFS 表（分布式表与维度表）。当更新分布式表时，系统把要更新记录所在的分区整体更新；更新维度表时，系统将该表整体更新。因此更新分布式表仅适用于低频更新任务，例如分钟级更新任务；不适用于高频更新任务，例如毫秒级更新任务。自 2.00.10 版本开始，支持对 OLAP 和 TSDB 引擎（设置 keepDuplicates=ALL 时）下分布式表的分区列进行更新。

更新采取了多版本的方式，并且支持事务。系统会创建一个新的版本以存储新的数据。提交事务之前，其他 SQL 语句仍然访问旧版本的数据。若更新涉及多个分区，只要其中某一个分区更新失败，系统会回滚所有分区的修改。

通过查看分布式表数据更新原理和性能中“数据更新原理”章节的内容来了解分布式表的更新原理。

update
   table_name
   set col1=X1, [col2=X2,...]
   [from table_joiner(table_names)]
   [where condition(s)]
   [context by col_name(s)]

例 1：更新内存表

sym = `C`MS`MS`MS`IBM`IBM`C`C`C$SYMBOL
price= 49.6 29.46 29.52 30.02 174.97 175.23 50.76 50.32 51.29
qty = 2200 1900 2100 3200 6800 5400 1300 2500 8800
timestamp = [09:34:07,09:36:42,09:36:51,09:36:59,09:32:47,09:35:26,09:34:16,09:34:26,09:38:12]
t1 = table(timestamp, sym, qty, price);

t1;

使用 update 语句创建新的列，该列的值为空。

update t1 set vol=long();
t1;

t1.drop!(`vol);
// 将 t1 还原到初始状态

更新 trades 表，将股票符号为 C 的记录的 price 列加 $0.5 以及 qty 列减 50。

update t1 set price=price+0.5, qty=qty-50 where sym=`C;
t1;

update t1 set price=price-0.5, qty=qty+50 where sym=`C;
// 将 t1 还原到初始状态

使用 contextBy 更新一张表。context by 可以用来做分组调整，而 contextby 不可。下例首先使用 context by 计算每只股票的平均价格，然后将每个记录的原始价格减去平均价格。

update t1 set price=price-avg(price) context by sym;
t1;

使用表连接来更新表。

item = table(1..10 as id, 10+rand(100,10) as qty, 1.0+rand(10.0,10) as price)
promotion = table(1..10 as id, rand(0b 1b, 10) as flag, 0.5+rand(0.4,10) as discount);
item;

promotion;

update item set price = price*discount from ej(item, promotion, `id) where flag=1;
item;

例 2. 更新分布式表

login(`admin, `123456)
n=1000000
ID=rand(10, n)
x=rand(1.0, n)
t=table(ID, x)
db=database("dfs://rangedb123", RANGE,  0 5 10)
pt=db.createPartitionedTable(t, `pt, `ID)
pt.append!(t)

pt=loadTable("dfs://rangedb123", `pt)
select avg(x) from pt;

0.4999

update pt set x=x+1;

pt=loadTable("dfs://rangedb123", `pt)
select avg(x) from pt;

1.4999

//不允许使用序列函数对跨分区数据进行更新，因此会报错。
update pt set x=prev(x) 

// update pt set x = prev(x) => Aggregate or order-sensitive functions are not allowed without context by clause when updating a partitioned table.

update pt set x=prev(x) context by ID
//搭配 context by 将数据更新限制在分区内时，可以正确执行。
select TOP 10* from pt order by ID

ID	x
0	
0	1.4483
0	1.6277
0	1.7735
0	1.4349