文档首页
MySQL 9.0 参考手册
相关文档 下载本手册
PDF (US Ltr) - 40.0Mb
PDF (A4) - 40.1Mb
手册页 (TGZ) - 258.2Kb
手册页 (Zip) - 365.3Kb
Info (Gzip) - 4.0Mb
Info (Zip) - 4.0Mb


27.3.6.1 会话对象

在全局对象的 session 属性中始终可以使用 Session 对象。Session 具有以下列出的方法

  • getOption(String name):获取语句选项 name 的值。返回一个字符串或一个真假值,具体取决于选项类型。

  • prepare(String sql, {passResultToClient: Bool, charsetName: String}):启用预处理语句的执行;接受 SQL 语句并返回一个 PreparedStatement 对象。

    调用此方法等同于在 mysql 客户端中执行 PREPARE 语句。

  • quoteName(String name):返回 name,在转义后。

  • runSql(String query[[, Array statementParameters], Options options]):执行查询,并使用指定的选项和可选的语句参数列表;它返回一个 SqlResult

  • setOptions(Object options):设置语句选项默认值。未指定的选项将假设其默认值。

  • sql(String sql, {passResultToClient: Bool, charsetName: String, integerType: IntegerType}):执行简单的 SQL 语句。也可以用来提供属性,覆盖在会话中设置的 passResultlToClientcharsetName 值。返回一个 SqlExecute 对象。

    IntegerType 由一个 JSON 键值对组成,其键为 IntegerType,其可能的取值及其效果如下所列

    • mysql.IntegerType.BIGINT:将所有 MySQL 整数类型值转换为 JavaScript BigInt

    • mysql.IntegerType.STRING:将所有 MySQL 整数类型值转换为 JavaScript String

    • mysql.IntegerType.UNSAFE_BIGINT:如果 MySQL 值是安全的,则将其转换为 JavaScript Number;否则将其转换为 JavaScript BigInt。如果值是安全的,则转换为 JavaScript Number;否则转换为 JavaScript String。如果未指定规则,则这是默认行为。

    • mysql.IntegerType.UNSAFE_STRING:如果 MySQL 值是安全的,则将其转换为 JavaScript Number;否则将其转换为 JavaScript String。如果未指定规则,则这是默认行为。

    此值设置的规则决定了 MySQL 整数类型值如何通过此 SQL 语句转换为 JavaScript。它们的名称(不包括对象引用)对应于在 mle_set_session_state() 中使用 integer_type 键使用的那些名称。默认行为等同于设置了 mysql.IntegerType.UNSAFE_STRING 或调用了 mle_set_session_state('{"integer_type":"STRING"}')

    此选项也可以使用 runSQL()prepare() 为给定语句设置。