跳过主内容
返回插件
@capgo/capacitor-fast-sql
教程
@capgo/capacitor-fast-sql

快速 SQL

高性能本机SQLite,使用自定义协议进行高效的同步操作和IndexedDB替代品

指南

快速SQL教程

使用@capgo/capacitor-fast-sql

快速SQL插件,高性能SQLite数据库访问

安装

bun add @capgo/capacitor-fast-sql
bunx cap sync

此插件暴露的内容

  • connect - 初始化数据库连接并启动 HTTP 服务器。
  • disconnect - 关闭数据库连接并停止 HTTP 服务器。
  • getServerInfo - 获取 HTTP 服务器端口和令牌以进行直接通信。
  • execute - 通过 Capacitor 桥执行 SQL 查询(适用于简单查询)。对于大型数据集的更好性能,请直接使用 HTTP 协议通过 SQLConnection 类。

示例使用

connect

初始化数据库连接并启动 HTTP 服务器。

import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';

const conn = await CapgoCapacitorFastSql.connect({ database: 'myapp' });
console.log('Connected on port:', conn.port);

disconnect

关闭数据库连接并停止 HTTP 服务器。

import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';

await CapgoCapacitorFastSql.disconnect({ database: 'myapp' });

getServerInfo

获取 HTTP 服务器端口和令牌以进行直接通信。

import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';

const info = await CapgoCapacitorFastSql.getServerInfo({ database: 'myapp' });
console.log('Server port:', info.port);

execute

通过 Capacitor 桥执行 SQL 查询(适用于简单查询)。对于大型数据集的更好性能,请直接使用 HTTP 协议通过 SQLConnection 类。

import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';

const result = await CapgoCapacitorFastSql.execute({
  database: 'myapp',
  statement: 'SELECT * FROM users WHERE age > ?',
  params: [18]
});
console.log('Rows:', result.rows);

全局参考

继续使用@capgo/capacitor-fast-sql

如果您正在使用 使用@capgo/capacitor-fast-sql 来规划存储和文件处理,连接它与 @capgo/capacitor-fast-sql 了解@capgo/capacitor-fast-sql的实现细节在@capgo/capacitor-fast-sql, 入门指南 了解入门指南的实现细节在入门指南, @capgo/capacitor-data-storage-sqlite 为 @capgo/capacitor-data-storage-sqlite 的实现细节, 使用 @capgo/capacitor-data-storage-sqlite 为原生能力在使用 @capgo/capacitor-data-storage-sqlite, @capgo/capacitor-file 为 @capgo/capacitor-file 的实现细节,