database.prepare(sql[, options])

版本历史
版本变更
v26.8.0

Add the persistent option.

v26.8.0

Throw ERR_INVALID_ARG_VALUE if sql contains no statements.

v22.5.0

新增于: v22.5.0

  • sql <string> 用于编译为预处理语句的 SQL 字符串。
  • options <Object> 为预处理语句提供的可选配置。
    • readBigInts <boolean> 如果 true，整数字段将被读取为 BigInt。 默认值： 继承自数据库选项或 false。
    • returnArrays <boolean> 如果 true，结果将作为数组返回。 默认值： 继承自数据库选项或 false。
    • allowBareNamedParameters <boolean> 如果 true，允许绑定命名参数而无需前缀字符。**默认值：**继承自数据库选项或 true。
    • allowUnknownNamedParameters <boolean> 如果 true，未知的命名参数将被忽略。**默认值：**继承自数据库选项或 false。
    • persistent <boolean> 如果 true，会提示 SQLite 该语句将被长时间保留并可能多次重用。SQLite 当前通过避免使用旁路内存来响应该提示。对应 SQLITE_PREPARE_PERSISTENT 标志。默认值： false。
  • 返回：Statement 准备好的声明。

将 SQL 语句编译成 准备好的声明。此方法是 sqlite3_prepare_v3() 的一个封装。

🌐 Compiles a SQL statement into a prepared statement. This method is a wrapper around sqlite3_prepare_v3().