Panduan
Cara menggunakan Fast SQL di Capacitor
Menggunakan @capgo/capacitor-fast-sql
Plugin Fast SQL untuk akses database SQLite berperforma tinggi.
Instal
bun add @capgo/capacitor-fast-sql
bunx cap sync
bunx cap sync menyalin code native plugin ke dalam proyek native Anda. Jalankan lagi setelah setiap upgrade plugin.
Impor
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
Sekilas tentang API
| Metode | Deskripsi |
|---|---|
connect |
Inisialisasi koneksi database dan jalankan HTTP server. |
disconnect |
Tutup koneksi database dan hentikan HTTP server. |
getServerInfo |
Dapatkan port HTTP server dan token untuk komunikasi langsung. |
execute |
Jalankan query SQL lewat bridge Capacitor (untuk query sederhana). Untuk performa yang lebih baik dengan dataset besar, gunakan protokol HTTP secara langsung melalui class SQLConnection. |
beginTransaction |
Mulai transaksi database. |
commitTransaction |
Commit transaksi saat ini. |
rollbackTransaction |
Rollback transaksi saat ini. |
configureWeb |
Konfigurasi opsi khusus web untuk modul resmi SQLite Wasm. |
Contoh
connect()
Inisialisasi koneksi database dan jalankan HTTP server.
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
const conn = await CapgoCapacitorFastSql.connect({ database: 'myapp' });
console.log('Connected on port:', conn.port);
disconnect()
Tutup koneksi database dan hentikan HTTP server.
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
await CapgoCapacitorFastSql.disconnect({ database: 'myapp' });
getServerInfo()
Dapatkan port HTTP server dan token untuk komunikasi langsung.
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
const info = await CapgoCapacitorFastSql.getServerInfo({ database: 'myapp' });
console.log('Server port:', info.port);
execute()
Jalankan query SQL lewat bridge Capacitor (untuk query sederhana). Untuk performa yang lebih baik dengan dataset besar, gunakan protokol HTTP secara langsung melalui class 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);
beginTransaction()
Mulai transaksi database.
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
await CapgoCapacitorFastSql.beginTransaction({ database: 'myapp' });
// Execute multiple operations
await CapgoCapacitorFastSql.commitTransaction({ database: 'myapp' });
commitTransaction()
Commit transaksi saat ini.
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
await CapgoCapacitorFastSql.commitTransaction({ database: 'myapp' });
Tabel di atas mencantumkan 8 metode inti. Dokumentasi untuk Listener, helper versi, serta kontrak lengkap dari setiap metode tersedia di repositori GitHub.
Referensi lengkap
Lanjutkan dari Menggunakan @capgo/capacitor-fast-sql
Jika Anda menggunakan Menggunakan @capgo/capacitor-fast-sql untuk merencanakan penyimpanan dan penanganan file, hubungkan dengan @capgo/capacitor-fast-sql untuk detail implementasi di @capgo/capacitor-fast-sql, Panduan Memulai untuk detail implementasi di Getting Started, @capgo/capacitor-data-storage-sqlite untuk detail implementasi di @capgo/capacitor-data-storage-sqlite, Menggunakan @capgo/capacitor-data-storage-sqlite untuk kapabilitas native di bagian Menggunakan @capgo/capacitor-data-storage-sqlite, dan @capgo/capacitor-file untuk detail implementasi di @capgo/capacitor-file.