@tauri-apps/plugin-sql

类

default

数据库

Database 类是与 SQL 插件 Rust 端通信的主要接口。

构造函数

new default()

new default(path): default

参数

参数	类型
path	字符串

返回

default

来源: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/sql/guest-js/index.ts#L29

属性

属性	类型	定义于
path	字符串	来源: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/sql/guest-js/index.ts#L28

方法

close()

close(db?): Promise<boolean>

关闭

关闭数据库连接池。

参数

参数	类型	描述
db?	字符串	如果您管理多个数据库，可以选择指定数据库的名称。否则，所有数据库池都将在作用域内。

返回

Promise<boolean>

示例

const success = await db.close()

来源: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/sql/guest-js/index.ts#L162

execute()

execute(query, bindValues?): Promise<QueryResult>

执行

将 SQL 表达式传递给数据库执行。

参数

参数	类型
查询	字符串
绑定值?	未知[]

返回

Promise<QueryResult>

示例

// for sqlite & postgres
// INSERT example
const result = await db.execute(
   "INSERT into todos (id, title, status) VALUES ($1, $2, $3)",
   [ todos.id, todos.title, todos.status ]
);
// UPDATE example
const result = await db.execute(
   "UPDATE todos SET title = $1, completed = $2 WHERE id = $3",
   [ todos.title, todos.status, todos.id ]
);

// for mysql
// INSERT example
const result = await db.execute(
   "INSERT into todos (id, title, status) VALUES (?, ?, ?)",
   [ todos.id, todos.title, todos.status ]
);
// UPDATE example
const result = await db.execute(
   "UPDATE todos SET title = ?, completed = ? WHERE id = ?",
   [ todos.title, todos.status, todos.id ]
);

来源: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/sql/guest-js/index.ts#L108

select()

select<T>(query, bindValues?): Promise<T>

选择

将 SELECT 查询传递给数据库执行。

类型参数

类型参数
T

参数

参数	类型
查询	字符串
绑定值?	未知[]

返回

Promise<T>

示例

// for sqlite & postgres
const result = await db.select(
   "SELECT * from todos WHERE id = $1", [ id ]
);

// for mysql
const result = await db.select(
   "SELECT * from todos WHERE id = ?", [ id ]
);

来源: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/sql/guest-js/index.ts#L141

get()

static get(path): default

获取

一个静态初始化器，它同步返回 Database 类的实例，同时将实际的数据库连接延迟到数据库的首次调用或选择时。

Sqlite

该路径是相对于 tauri::path::BaseDirectory::App 的，并且必须以 sqlite: 开头。

参数

参数	类型
path	字符串

返回

default

示例

const db = Database.get("sqlite:test.db");

来源: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/sql/guest-js/index.ts#L72

load()

static load(path): Promise<default>

加载

一个静态初始化器，它连接到基础数据库并在数据库连接建立后返回 Database 实例。

Sqlite

该路径是相对于 tauri::path::BaseDirectory::App 的，并且必须以 sqlite: 开头。

参数

参数	类型
path	字符串

返回

Promise<default>

示例

const db = await Database.load("sqlite:test.db");

来源: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/sql/guest-js/index.ts#L48

接口

QueryResult

属性

属性	类型	描述	定义于
lastInsertId?	数字	最后插入的 id。此值未针对 Postgres 数据库设置。如果 Postgres 需要最后插入的 id，则必须使用 select 函数，并带有 RETURNING 子句（INSERT INTO todos (title) VALUES ($1) RETURNING id）。	来源: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/sql/guest-js/index.ts#L18
rowsAffected	数字	受查询影响的行数。	来源: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/sql/guest-js/index.ts#L9