类型转换

DolphinDB 与 Python API 的交互过程始终遵循 API交互协议。该协议规定了通信双方在交互过程中使用的报文信息格式。在 API 与 DolphinDB 的交互过程中，通过指定 protocol 参数，即可选择交互过程中使用的传输数据格式协议。

Python 中包含多套常用类型系统，其与 DolphinDB 的类型系统并非一一对应。为更好地兼容各类型系统与 DolphinDB 之间的数据交互，DolphinDB Python API 自1.30.21.1版本起，session（session）和 DBConnectionPool 新增 protocol 参数。 目前已支持的协议包括 PROTOCOL_DDB、PROTOCOL_PICKLE（3.0.2.0 之前版本的默认值） 和 PROTOCOL_ARROW。自 3.0.2.0 版本起，Python API 默认使用 PROTOCOL_DDB 协议。 此外，对于 UUID、IPADDR、SECOND 等无法直接上传的类型， Python API 支持强制类型转换。

下例展示了 session 如何指定使用的传输协议。

import dolphindb as ddb
import dolphindb.settings as keys
# 使用协议 PROTOCOL_DDB
s = ddb.session(protocol=keys.PROTOCOL_DDB)
# 使用协议 PROTOCOL_PICKLE
s = ddb.session(protocol=keys.PROTOCOL_PICKLE)
# 使用协议 PROTOCOL_ARROW
s = ddb.session(protocol=keys.PROTOCOL_ARROW)

PROTOCOL_DDB、PROTOCOL_PICKLE 和 PROTOCOL_ARROW 协议支持不同的类型系统，提供各自特色的序列化方式以适应不同应用场景，最终实现更高效的数据传输。以下内容为用户选择传输协议提供些许参考建议：

• PROTOCOL_DDB 协议是 DolphinDB 自定义的一套数据序列化、反序列化方案，被广泛使用于 Python API、C++ API、Java API 等 API 中。其支持的数据形式和数据类型最为全面。
• PROTOCOL_PICKLE 协议基于 Python 原生的 Pickle 协议，同时进行了部分适配 DolphinDB 的修改。
• PROTOCOL_ARROW 协议是基于 Apache Arrow 通用序列化方案、用于对大型数据集进行序列化和反序列化的协议，可以跨平台、跨语言地进行高效数据传输。

从使用场景的角度来看：

• PROTOCOL_ARROW 协议适用于从上游数据库到下游消费、且全部使用 Apache Arrow 格式作为中间格式的场景，可以方便地在各个组件之间传递数据。而用户只需要付出从数据库取出数据这一次序列化开销，后续不再需要进行序列化和反序列化。此外，使用该协议可以较高效地利用网络带宽，目前有较多的行情服务商使用 Apache Arrow 协议。
• PROTOCOL_PICKLE 协议针对数据传输类的场景，PROTOCOL_DDB 协议支持的数据形式和数据类型最为全面。如果场景中使用 pandas 的 DataFrame 较多，则更推荐使用 PROTOCOL_PICKLE 协议和 PROTOCOL_DDB 协议。