cx_oracle 中 Connection.ping() 的返回值是多少？

Question

我刚刚安装了一个python包：cx_oracle。从the cx_oracle document我找到了一个方法：Connection.ping()，它被描述为“Ping服务器，可以用来测试连接是否仍然活跃。”。

但是文档没有提到ping()的返回值是什么。

我写了一些代码来做一个测试：

#!/usr/bin/env python3
import cx_Oracle
conn = cx_Oracle.connect("...")
print(conn.ping()) # display：None
conn.close()
print(conn.ping()) # raise exception: cx_Oracle.InterfaceError: not connected

从测试结果中我发现ping()会在连接正常时返回None，或者在连接关闭后抛出异常：cx_Oracle.InterfaceError: not connected。

还有其他可能的返回值吗？为什么不直接返回 True 或 False？

Answer 1

cx_Oracle documentation states that 这是：

此方法是 DB API 定义的扩展，仅在 Oracle 10g R2 及更高版本中可用。

但是，此方法未记录在 PEP 249 - connection methods 或 optional extensions（或其他任何地方）中的当前 Python 数据库 API 规范中。

PEP 249 的 MySQL 实现也 has this method;该文件指出：

当连接不可用时，会引发InterfaceError。采用 is_connected() 方法来检查连接而不引发 错误。

出现错误时引发 InterfaceError。

由于这与 cx_Oracle 行为相同，我假设这是您问题的答案，并且您确定的行为是正确的：

• 如果连接处于活动状态，则不会返回
• 如果连接处于非活动状态，则会引发 InterfaceError

如果我们查看the code for .ping()，它确认这是该方法的实现方式：

static PyObject *Connection_Ping(
    udt_Connection *self,               // connection
    PyObject* args)                     // arguments
{
    sword status;

    if (Connection_IsConnected(self) < 0)
        return NULL;
    status = OCIPing(self->handle, self->environment->errorHandle,
            OCI_DEFAULT);
    if (Environment_CheckForError(self->environment, status,
            "Connection_Ping()") < 0)
        return NULL;
    Py_INCREF(Py_None);
    return Py_None;
}

Answer 2

感谢 Ben 的回答，给定来自 cx_Oracle 库的 connectionObject，这至少应该包含您可能想要的内容。

def isOpen(connectionObject):
    try:
        return connectionObject.ping() is None
    except:
        return False