Guida
Come usare Fast SQL in Capacitor
Utilizzo di @capgo/capacitor-fast-sql
Plugin Fast SQL per l'accesso ad alta velocità a database SQLite.
Installa
bun add @capgo/capacitor-fast-sql
bunx cap sync
bunx cap sync copia i code nativi del plugin nei tuoi progetti nativi. Eseguilo di nuovo dopo ogni aggiornamento del plugin.
Importa
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
API in breve
| Metodo | Descrizione |
|---|---|
connect |
Inizializza la connessione al database e avvia il server HTTP. |
disconnect |
Chiudi la connessione al database e arresta il server HTTP. |
getServerInfo |
Ottieni la porta del server HTTP e il token per la comunicazione diretta. |
execute |
Esegui una query SQL tramite il bridge Capacitor (per query semplici). Per performance migliori con dataset ampi, usa direttamente il protocollo HTTP tramite la classe SQLConnection. |
beginTransaction |
Avvia una transazione sul database. |
commitTransaction |
Esegui il commit della transazione corrente. |
rollbackTransaction |
Esegui il rollback della transazione corrente. |
configureWeb |
Configura le opzioni web per il modulo ufficiale SQLite Wasm. |
Esempi
connect()
Inizializza la connessione al database e avvia il server HTTP.
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
const conn = await CapgoCapacitorFastSql.connect({ database: 'myapp' });
console.log('Connected on port:', conn.port);
disconnect()
Chiudi la connessione al database e arresta il server HTTP.
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
await CapgoCapacitorFastSql.disconnect({ database: 'myapp' });
getServerInfo()
Ottieni la porta del server HTTP e il token per la comunicazione diretta.
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
const info = await CapgoCapacitorFastSql.getServerInfo({ database: 'myapp' });
console.log('Server port:', info.port);
execute()
Esegui una query SQL tramite il bridge Capacitor (per query semplici). Per performance migliori con dataset ampi, usa direttamente il protocollo HTTP tramite la classe 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()
Avvia una transazione sul database.
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
await CapgoCapacitorFastSql.beginTransaction({ database: 'myapp' });
// Execute multiple operations
await CapgoCapacitorFastSql.commitTransaction({ database: 'myapp' });
commitTransaction()
Esegui il commit della transazione corrente.
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
await CapgoCapacitorFastSql.commitTransaction({ database: 'myapp' });
La tabella sopra elenca gli 8 metodi core. Listener, helper di versione e il contratto completo di ogni metodo sono documentati in repository GitHub.
Riferimento completo
Continua da Usare @capgo/capacitor-fast-sql
Se stai usando Usare @capgo/capacitor-fast-sql per pianificare lo storage e la gestione dei file, collegalo a @capgo/capacitor-fast-sql per i dettagli di implementazione in @capgo/capacitor-fast-sql, Per iniziare per i dettagli di implementazione nella guida introduttiva, @capgo/capacitor-data-storage-sqlite per i dettagli di implementazione in @capgo/capacitor-data-storage-sqlite, Utilizzo di @capgo/capacitor-data-storage-sqlite per la funzionalità nativa in Utilizzo di @capgo/capacitor-data-storage-sqlite, e @capgo/capacitor-file per i dettagli di implementazione in @capgo/capacitor-file.