连接状态与属性
连接建立后,可通过以下属性查看连接信息与状态:
| 属性 | 类型 | 说明 |
|---|---|---|
| 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。
