一个量化策略在用于实际交易时，处理实时数据的程序通常为事件驱动。而研发量化策略时，需要使用历史数据进行回测，这时的程序通常不是事件驱动。因此同一个策略需要编写两套代码，不仅耗时而且容易出错。在 DolphinDB database 中，用户可将历史数据按照时间顺序以“实时数据”的方式导入流数据表中，这样就可以使用同一套代码进行回测和实盘交易。
DolphinDB的流数据处理框架采用发布-订阅-消费的模式。数据生产者将实时数据继续地以流的形式发布给所有数据订阅者。订阅者收到消息以后，可使用自定义函数或者DolphinDB内置的聚合引擎来处理消息。DolphinDB流数据接口支持多种语言的API，包括C++, C#, Java, 和Python等。用户可以使用这些API来编写更加复杂的处理逻辑，更好地与实际生产环境相结合。详情请参考DolphinDB流数据教程。
本文介绍replay和replayDS函数，然后使用金融数据展示数据回放的过程与应用场景。
1. 函数介绍
replay
replay(inputTables, outputTables, [dateColumn], [timeColumn], [replayRate], [parallelLevel=1])
replay函数的作用是将若干表或数据源同时回放到相应的输出表中。用户需要指定输入的数据表或数据源、输出表、日期列、时间列、回放速度以及并行度。
replay函数参数概念如下：
- inputTables: 单个表或包含若干表或数据源（见replayDS介绍）的元组。
- outputTables: 单个表或包含若干个表的元组，这些表通常为流数据表。输入表和输出表的个数一致，且一一对应，每对输入、输出表的结构相同。
- dateColumn, timeColumn: string, 表示输入表的日期和时间列，若不指定则默认第一列为日期列。若输入表中时间列同时包含日期和时间，需要将dateColumn和timeColumn设为同一列。回放时，系统将根据dateColumn和timeColumn的设定，决定回放的最小时间精度。在此时间精度下，同一时刻的数据将在相同批次输出。比如一张表同时有日期列和时间列，但是replay函数只设置了dateColumn，那么同一天的所有数据会在一个批次输出。
- replayRate: 整数, 表示每秒钟回放的数据条数。由于回放时同一个时刻数据在同一批次输出，因此当replayRate小于一个批次的行数时，实际输出的速率会大于replayRate。
- parallelLevel: 整数, 表示读取数据的并行度。当源数据大小超过内存大小的时候，需要使用replayDS函数将源数据划分为若干个小的数据源，依次从磁盘中读取数据并回放。指定多个读取数据的线程数可提升数据读取速度。
replayDS
replayDS(sqlObj, [dateColumn], [timeColumn], [timeRepartitionSchema])
replayDS函数可以将输入的SQL查询转化为数据源，结合replay函数使用。其作用是根据输入表的分区以及timeRepartitionSchema，将原始的SQL查询按照时间顺序拆分成若干小的SQL查询。
replayDS函数参数概念如下：
- sqlObj: SQL元代码，表示回放的数据，如<select * from sourceTable>。
- dateColumn: 字符串, 表示日期列。若不指定，默认第一列为日期列。replayDS函数默认日期列是数据源的一个分区列，并根据分区信息将原始SQL查询拆分为多个查询。
- timeColumn: 字符串, 表示时间列，配合timeRepartitionSchema使用。
- timeRepartitionSchema: 时间类型向量，如08:00:00 .. 18:00:00。若同时指定了timeColumn, 则对SQL查询在时间维度上进一步拆分。
单个内存表回放
单内存表回放只需要设置输入表、输出表、日期列、时间列和回放速度即可。
replay(inputTable, outputTable, `date, `time, 10)
使用data source的单表回放
当单表行数过多时，可以配合使用replayDS进行回放。首先使用replayDS生成data source，本例中指定了日期列和timeRepartitionColumn。回放调用与单个内存表回放相似，但是可以指定回放的并行度。replay内部实现使用了pipeline框架，取数据和输出分开执行。当输入为data source时，多块数据可以并行读取，以避免输出线程等待的情况。此例中并行度设置为2，表示有两个线程同时执行取数据的操作。
inputDS = replayDS(<select * from inputTable>, `date, `time, 08:00:00.000 + (1..10) * 3600000)
replay(inputDS, outputTable, `date, `time, 1000, 2)
使用data source的多表回放
replay也支持多张表的同时回放，只需要将多张输入表以元组的方式传给replay,并且分别指定输出表即可。这里输出表和输入表应该一一对应，每一对都必须有相同的表结构。如果指定了日期列或时间列，那么所有表中都应当有存在相应的列。
ds1 = replayDS(<select * from input1>, `date, `time, 08:00:00.000 + (1..10) * 3600000)
ds2 = replayDS(<select * from input2>, `date, `time, 08:00:00.000 + (1..10) * 3600000)
ds3 = replayDS(<select * from input3>, `date, `time, 08:00:00.000 + (1..10) * 3600000)
replay([ds1, ds2, ds3], [out1, out2, out3], `date, `time, 1000, 2)
取消回放
如果replay函数是通过submitJob调用，可以使用getRecentJob获取jobId，然后用cancelJob取消回放。
getRecentJobs()
cancelJob(jobid)
如果是直接调用，可在另外一个GUI session中使用getConsoleJobs获取jobId，然后使用cancelConsoleJob取消回放任务。
getConsoleJobs()
cancelConsoleJob(jobId)
2．如何使用回放数据
回放的数据以流数据形式存在，我们可以使用以下三种方式来订阅消费这些数据：
- 在DolphinDB中订阅，使用DolphinDB脚本自定义回调函数来消费流数据。
- 在DolphinDB中订阅，使用内置的流计算引擎来处理流数据，譬如时间序列聚合引擎、横截面聚合引擎、异常检测引擎等。DolphinDB内置的聚合引擎可以对流数据进行实时聚合计算，使用简便且性能优异。在3.2中，我们使用横截面聚合引擎来处理回放的数据，并计算ETF的内在价值。横截面聚合引擎的具体用法参见DolphinDB用户手册。
- 第三方客户端通过DolphinDB的流数据API来订阅和消费数据。
３. 金融示例
回放美国股市一天的level1交易数据，并计算ETF价值
本例中使用美国股市2007年8月17日的level1交易数据，利用replayDS进行数据回放，并通过DolphinDB内置的横截面聚合引擎计算ETF价值。数据存放在分布式数据库dfs://TAQ的quotes表，下面是quotes表的结构以及数据预览。
//加载数据库中quotes表的数据，查看表结构
quotes = database("dfs://TAQ").loadTable("quotes");
quotes.schema().colDefs;
name typeString typeInt
time SECOND 10
symbol SYMBOL 17
ofrsiz INT 4
ofr DOUBLE 16
mode INT 4
mmid SYMBOL 17
ex CHAR 2
date DATE 6
bidsize INT 4
bid DOUBLE 16
//查看quotes表内前十行的数据
select top 10 * from quotes;
symbol date time bid ofr bidsiz ofrsiz mode ex mmid
A 2007.08.17 04:15:06 0.01 0 10 0 12 80
A 2007.08.17 06:21:16 1 0 1 0 12 80
A 2007.08.17 06:21:44 0.01 0 10 0 12 80
A 2007.08.17 06:49:02 32.03 0 1 0 12 80
A 2007.08.17 06:49:02 32.03 32.78 1 1 12 80
A 2007.08.17 07:02:01 18.5 0 1 0 12 84
A 2007.08.17 07:02:01 18.5 45.25 1 1 12 84
A 2007.08.17 07:54:55 31.9 45.25 3 1 12 84
A 2007.08.17 08:00:00 31.9 40 3 2 12 84
A 2007.08.17 08:00:00 31.9 35.5 3 2 12 84
（1）对要进行回放的数据进行划分。由于一天的数据共有336,305,414条，一次性导入内存再回放会有较长延迟，还有可能导致内存溢出，因此先使用replayDS函数并指定参数timeRepartitionSchema，将数据按照时间戳分为62个部分。
sch = select name,typeString as type from quotes.schema().colDefs
trs = cutPoints(09:30:00.001..18:00:00.001, 60)
rds = replayDS(<select * from quotes>, `date, `time, trs);
（2）定义输出表outQuotes，一般为流数据表。
share streamTable(100:0, sch.name,sch.type) as outQuotes
（3）定义股票权重字典weights以及聚合函数etfVal，用于计算ETF价值。在本例中，我们仅计算AAPL、IBM、MSFT、NTES、AMZN、GOOG这几只股票的ETF价值。
defg etfVal(weights,sym, price) {
return wsum(price, weights[sym])
}
weights = dict(STRING, DOUBLE)
weights[`AAPL] = 0.1
weights[`IBM] = 0.1
weights[`MSFT] = 0.1
weights[`NTES] = 0.1
weights[`AMZN] = 0.1
weights[`GOOG] = 0.5
（4）创建流聚合引擎，并订阅数据回放的输出表outQuotes。订阅outQuotes表时，我们指定了发布表的过滤条件，只有symbol为AAPL、IBM、MSFT、NTES、AMZN、GOOG的数据才会发布到横截面聚合引擎，减少不必要的网络开销和数据传输。
setStreamTableFilterColumn(outQuotes, `symbol)
outputTable = table(1:0, `time`etf, [TIMESTAMP,DOUBLE])
tradesCrossAggregator=createCrossSectionalAggregator("etfvalue", <[etfVal{weights}(symbol, ofr)]>, quotes, outputTable, `symbol, `perBatch)
subscribeTable(,"outQuotes","tradesCrossAggregator",-1,append!{tradesCrossAggregator},true,,,,,`AAPL`IBM`MSFT`NTES`AMZN`GOOG)
（5）开始回放，设定每秒回放10万条数据，聚合引擎则会实时地对回放的数据进行消费。
submitJob("replay_quotes", "replay_quotes_stream", replay, [rds], [`outQuotes], `date, `time,100000,4)
（6）查看不同时间点下我们选择的股票的ETF价值。
//查看outputTable表内前15行的数据,其中第一列时间为聚合计算发生的时间
>select top 15 * from outputTable;
time etf
2019.06.04T16:40:18.476 14.749
2019.06.04T16:40:19.476 14.749
2019.06.04T16:40:20.477 14.749
2019.06.04T16:40:21.477 22.059
2019.06.04T16:40:22.477 22.059
2019.06.04T16:40:23.477 34.049
2019.06.04T16:40:24.477 34.049
2019.06.04T16:40:25.477 284.214
2019.06.04T16:40:26.477 284.214
2019.06.04T16:40:27.477 285.68
2019.06.04T16:40:28.477 285.68
2019.06.04T16:40:29.478 285.51
2019.06.04T16:40:30.478 285.51
2019.06.04T16:40:31.478 285.51
2019.06.04T16:40:32.478 285.51
4. 性能测试
我们在服务器上对DolphinDB的数据回放功能进行了性能测试。服务器配置如下：
主机：DELL PowerEdge R730xd
CPU：Intel Xeon(R) CPU E5-2650 v4（24核 48线程 2.20GHz）
内存：512 GB （32GB × 16, 2666 MHz）
硬盘：17T HDD （1.7T × 10, 读取速度222 MB/s，写入速度210 MB/s）
网络：万兆以太网
测试脚本如下：
sch = select name,typeString as type from quotes.schema().colDefs
trs = cutPoints(09:30:00.001..18:00:00.001,60)
rds = replayDS(<select * from quotes>, `date, `time, trs);
share streamTable(100:0, sch.name,sch.type) as outQuotes
jobid = submitJob("replay_quotes","replay_quotes_stream", replay, [rds], [`outQuotes], `date, `time, , 4)
在不设定回放速率（即以最快的速率回放），并且输出表没有任何订阅时，回放336,305,414条数据耗时仅需要90~110秒。
