连接状态与属性

连接建立后,可通过以下属性查看连接信息与状态:

属性 类型 说明
session_id str 当前服务端会话 ID,重连或节点切换后会自动更新。
host str 当前连接的服务端地址;高可用模式下为当前实际连接的节点。
port int 当前连接的服务端端口。
is_alive bool 主动发送 version() 探测请求判断连接是否可用;会产生网络开销,可能触发重连或节点切换。
is_closed bool 客户端对象是否已显式调用 close() 关闭;不发起网络请求,不能反映底层网络连通性。
is_busy bool 连接是否正在执行操作,或仍处于分段读取状态。
startup str 当前连接配置的启动脚本。
msg_logger dolphindb.Logger 自定义消息日志对象,用于处理脚本 print 输出;详见日志重定向。
  • 判断连接可用性:请使用 is_alive。is_closed 仅记录客户端对象的关闭状态,底层套接字异常断开时仍可能为 False。

  • 分段读取限制:当存在未完成的 BlockReader 分段读取时(is_busy=True),读取 is_alive 会抛出 RuntimeError。