MAGMA实时表

MAGMA实时表是对于有主键约束的MAGMA表的一种增删改的优化。 对于有主键的列进行增删改，只要能确定主键的数值，我们就能直接确定主键所在的存储节点的位置 （目前MAGMA表中主键必须包含分布列，所以确定了主键就能确定分布列）， 于是可以将请求直接发往相应的存储节点执行，降低增删改语句的执行开销。

所以MAGMA实时表必须指定主键，进行增删改的数据也必须指定主键。

MAGMA实时表，通过统一的insert语法，将upsert（update or insert）与delete统一集成到insert语法中， 在内核中实现了不同类型的dml语句处理。

在语法上，用户需要通过realtime_op字段，指明当前的操作类型； realtime_op隐藏操作列出现在用户列的最后一列。

实时表建表语句中要用with选项指明realtime=true， 并且指定TABLESPACE为magma_default（表示建立MAGMA表）， 并且表中必须含有主键。

-- 建表语法 DDL （在 Oushudb 中创建 magma 实时表）
CREATE TABLE t_realtime_target(id int primary key, name text, age int)
WITH(realtime=true) TABLESPACE magma_default;

MAGMA实时表进行upsert时，要在insert语句中指定操作类型为’R’或者’r’ （表示insert or replace on conflict）。

-- upsert语法
-- insert全列数据，并设置操作类型为‘R'或者’r'
INSERT INTO t_realtime_target VALUES (1, 'aaa', 18, 'R');

MAGMA实时表进行delete时，要在delete语句中指定操作类型为’D’或者’d’， 并且主键列的数值必须设置，其他非主键列设置为null即可。

-- delete语法 dml, 必须设置主键，其他非主键用户表字段设为null即可，并设置操作类型为‘D'或者’d'
INSERT INTO t_realtime_target VALUES (1, null, null, 'D');