文件首頁
MySQL 9.0 參考手冊
相關文件 下載本手冊
PDF (美國信紙尺寸) - 40.0Mb
PDF (A4) - 40.1Mb
Man Pages (TGZ) - 258.2Kb
Man Pages (Zip) - 365.3Kb
Info (Gzip) - 4.0Mb
Info (Zip) - 4.0Mb


MySQL 9.0 參考手冊  /  ...  /  工作階段物件

27.3.6.1 工作階段物件

Session 物件始終作為全域物件的 session 屬性提供。Session 具有此處列出的方法

  • getOption(String name):取得陳述式選項 name 的值。根據選項類型傳回字串或 true-false 值。

  • 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。如果未指定規則,這是預設行為。

    此值設定的規則會決定此 SQL 陳述式如何將 MySQL 整數值轉換為 JavaScript。其名稱(減少物件參考)與用於 mle_set_session_state()integer_type 鍵所使用的名稱相對應。預設行為相當於已設定 mysql.IntegerType.UNSAFE_STRING,或已呼叫 mle_set_session_state('{"integer_type":"STRING"}')

    也可以使用 runSQL()prepare() 為給定陳述式設定此選項。