ガイド
Capacitor で Fast SQL を使う方法
@capgo/capacitor-fast-sql の使用
高速な SQLite データベースアクセスを実現する Fast SQL プラグイン。
インストール
bun add @capgo/capacitor-fast-sql
bunx cap sync
bunx cap sync プラグインのネイティブcodeをネイティブプロジェクトにコピーします。プラグインをアップグレードするたびに再度実行してください。
インポート
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
API の概要
| メソッド | 説明 |
|---|---|
connect |
データベース接続を初期化し、HTTPサーバーを起動します。 |
disconnect |
データベース接続を閉じ、HTTPサーバーを停止します。 |
getServerInfo |
直接通信に使うHTTPサーバーのポートとトークンを取得します。 |
execute |
Capacitor bridge経由でSQLクエリを実行します(シンプルなクエリ向け)。大規模なデータセットでパフォーマンスを上げたい場合は、SQLConnectionクラスでHTTPプロトコルを直接使ってください。 |
beginTransaction |
データベーストランザクションを開始します。 |
commitTransaction |
現在のトランザクションをコミットします。 |
rollbackTransaction |
現在のトランザクションをロールバックします。 |
configureWeb |
公式のSQLite WasmモジュールのWeb固有オプションを設定します。 |
例
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 bridge経由でSQLクエリを実行します(シンプルなクエリ向け)。大規模なデータセットでパフォーマンスを上げたい場合は、SQLConnectionクラスでHTTPプロトコルを直接使ってください。
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);
beginTransaction()
データベーストランザクションを開始します。
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
await CapgoCapacitorFastSql.beginTransaction({ database: 'myapp' });
// Execute multiple operations
await CapgoCapacitorFastSql.commitTransaction({ database: 'myapp' });
commitTransaction()
現在のトランザクションをコミットします。
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
await CapgoCapacitorFastSql.commitTransaction({ database: 'myapp' });
上記の表は 8 つのコアメソッドの一覧です。リスナーやバージョンのヘルパー、各メソッドの完全なコントラクトについては、 GitHub リポジトリ.
完全なリファレンス
「@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. の実装詳細については