MDL

通联数据依托于金融大数据，结合人工智能技术为投资者提供个性化、智能化、专业化投资服务。而 MDL 是通联数据提供的高频行情数据服务，DolphinDB 提供了能够从 MDL 服务器获取高频行情数据的 DolphinDB MDL 插件，帮助用户方便地通过 DolphinDB 脚本语言将实时行情数据接入 DolphinDB 中，以便进行后续的计算或存储。

在插件市场安装插件

版本要求

DolphinDB Server 2.00.10 及更高版本，支持 Linux x86-64。

安装步骤

在 DolphinDB 客户端中使用 listRemotePlugins 命令查看插件仓库中的插件信息。

注意：仅展示当前操作系统和 server 版本支持的插件。若无预期插件，可自行编译或在 DolphinDB 用户社区进行反馈。
```
login("admin", "123456");
listRemotePlugins()
```
使用 installPlugin 命令完成插件安装。
```
installPlugin("MDL");
```
使用 loadPlugin 命令加载插件。
```
loadPlugin("MDL");
```

用户接口

createHandle

语法

createHandle(name, host, port, username, [workerNum=1])

参数

name STRING 类型标量，作为句柄的唯一标识，不可重复。

host STRING 类型向量，服务器的 IP 或者域名。

port INT 类型向量，端口号，个数需要与 host 参数的数量一致。

username STRING 类型标量，用户 ID。

workerNum INT 类型标量，MDL 工作线程的数量，可选参数。

详情

返回一个 MDL 句柄，用于之后的操作。

getSchema

语法

getSchema(svrID, msgID, [extraOrderLevel=0])

参数

svrID STRING 类型标量，数据服务 ID。

msgID INT 类型标量，消息 ID。

extraOrderLevel INT 类型标量，值为 0-10，默认为 0。在指定 svrID、msgID 为 "MDLSID_MDL_SZL2", 28 或者 "MDLSID_MDL_SHL2", 4 即订阅 snapshot 时有效，会决定是否在表末尾增加 order queue 相关信息的字段。有 10 档可选，所以可以指定为 0-10。

详情

获取对应消息的表结构。

另外，可以通过 schema = getSchema("SHL2_SZL2_ORDER_AND_TRANSACTION", 0) 获取用于 order transaction 合并类型表的结构。

语法

subscribe(handle, output, svrID, [svrVersion], [msgID], [fieldName], [fieldValues], [extraOrderLevel=0])

参数

handle MDL 句柄。

output 可以为一个共享流表，需要在订阅前创建，该表的 schema 可以通过插件提供的 getSchema 函数来获取。连接服务器后会将订阅的数据实时刷新到这个流表中。也可以为字典类型，key 是 Int 类型的 channelNo，value 是对应 channelNo 行情要写入的共享流表，该表的结构通过 getSchema 函数来获取（getSchema("SHL2_SZL2_ORDER_AND_TRANSACTION", 0)），目前支持 "SHL2_SZL2_ORDER_AND_TRANSACTION" 一种，对应上交所 L2 和深交所 L2 的 order 和 transaction 合并类型行情。这种情况下，不支持填写 svrVersion、msgID、fieldName、fieldValues、extraOrderLevel 字段。

svrID STRING 类型标量，要订阅的数据服务 ID。如果 output 为字典类型，还支持 "SHL2_ORDER_AND_TRANSACTION" 和 "SZL2_ORDER_AND_TRANSACTION" 两种，每一种分别订阅对应交易所的 order 和 transaction 行情。

svrVersion STRING 类型标量，要订阅的数据服务版本号。

msgID INT 类型标量，要订阅的消息 ID。

fieldName STRING 类型标量，要过滤的字段名，可选参数。

fieldValues STRING 类型向量，要过滤的字段对应的值，可选参数，对于日期类型，"0" 用于订阅日期为空的情况，"20230808" 这种形式用于订阅指定的日期。

详情

记录要订阅的消息，然后在连接到服务器时提交订阅请求，必须在调用 connect 之前调用。可以使用字段名与字段值对要订阅的服务进行过滤，如可以通过 fieldName 指定股票编码字段，通过 fieldValues 指定要订阅的股票编码。

一个 MDL 句柄订阅的一种消息只能指定一个流表，如果需要对一个消息订阅多次并分别写入到多个流表，可以通过 createHandle 创建多个句柄，分别进行订阅并指定要写入到的流表。

注意：

因为通联 MDL 不支持同时订阅在不同服务器的数据源，也就是当同时订阅上交所 L2 和深交所 L2 时，只能收到其中一个数据源的行情。为了解决这个问题，需要创建两个句柄，分别订阅上交所 L2 和深交所 L2 的数据，一个句柄只订阅一个数据源的行情。
如果订阅了 order transaction 合并类型，MDDate 字段为 handle 创建日期，如果需要跨天订阅，该字段无效。
如果订阅了 order transaction 合并类型，上交所 SecurityType 字段为 marketInfo 回调所得，因此如果在盘中订阅，最开始记录的 SecurityType 字段可能为空。