干货丨时序数据库DolphinDB历史数据回放教程
一个量化策略在用于实际交易时，处理实时数据的程序通常为事件驱动。而研发量化策略时，需要使用历史数据进行回测，这时的程序通常不是事件驱动。因此同一个策略需要编写两套代码，不仅耗时而且容易出错。在 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秒。
