sliceByKey

语法

sliceByKey(table, rowKeys, [colNames])

参数

table 是键值表或索引内存表。

rowKeys 是标量或向量,表示索引列的指定值。

colNames 是字符串标量或向量,表示要选择的列的列名。

详情

从键值表或索引内存表中获取含有索引列指定值(由参数 rowKeys 指定)的行以及指定列(由 colNames 参数指定)的数据。耗时约为相应的SQL语句的50%。

如果是键值表,rowKeys 参数必须含有所有 keyColumns 的值。

如果是索引内存表,可指定前n个 keyColumns 的值,若其中有一列指定值为向量,所有指定列的指定值均需为同等长度的向量。

若不指定 colNames 参数,则会输出所有列。

结果的数据结构取决于 colNames。若 colNames 为标量,返回一个向量;若 colNames 为向量,返回一个内存表。

例子

$ t = indexedTable(`sym`side, 10000:0, `sym`side`price`qty, [SYMBOL,CHAR,DOUBLE,INT])
$ insert into t values(`IBM`MSFT`IBM, ['B','S','S'], 125.27 208.9 125.29, 1000 800 200)
$ a=sliceByKey(t,"IBM", 'price');

$ a;
[125.27,125.29]

$ typestr(a);
FAST DOUBLE VECTOR

$ a=sliceByKey(t,("IBM",'S'));
$ a;

sym

side

price

qty

IBM

S

125.29

200

$ typestr(a);
IN-MEMORY TABLE

$ t1 = keyedTable(`sym`side, 10000:0, `sym`side`price`qty, [SYMBOL,CHAR,DOUBLE,INT])
$ insert into t1 values(`IBM`MSFT`IBM, ['B','S','S'], 125.27 208.9 125.29, 1000 800 200)
$ sliceByKey(t1, [["IBM", "MSFT"], ['B', 'S']]);

sym

side

price

qty

IBM

B

125.27

1000

MSFT

S

208.9

800