Guide
Comment utiliser Fast SQL dans Capacitor
Utiliser @capgo/capacitor-fast-sql
Le plugin Fast SQL pour un accès haute performance à la base SQLite.
Installer
bun add @capgo/capacitor-fast-sql
bunx cap sync
bunx cap sync copie le code natif du plugin dans vos projets natifs. Relancez-l’après chaque mise à jour du plugin.
Importer
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
Aperçu de API
| Méthode | Description |
|---|---|
connect |
Initialisez la connexion à la base de données et démarrez le serveur HTTP. |
disconnect |
Fermez la connexion à la base de données et arrêtez le serveur HTTP. |
getServerInfo |
Récupérez le port du serveur HTTP et le token pour une communication directe. |
execute |
Exécutez une requête SQL via le bridge Capacitor (pour les requêtes simples). Pour de meilleures performances avec de gros jeux de données, utilisez directement le protocole HTTP via la classe SQLConnection. |
beginTransaction |
Démarrez une transaction de base de données. |
commitTransaction |
Validez la transaction en cours. |
rollbackTransaction |
Annulez la transaction en cours. |
configureWeb |
Configurez les options spécifiques au web pour le module officiel SQLite Wasm. |
Exemples
connect()
Initialisez la connexion à la base de données et démarrez le serveur HTTP.
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
const conn = await CapgoCapacitorFastSql.connect({ database: 'myapp' });
console.log('Connected on port:', conn.port);
disconnect()
Fermez la connexion à la base de données et arrêtez le serveur HTTP.
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
await CapgoCapacitorFastSql.disconnect({ database: 'myapp' });
getServerInfo()
Récupérez le port du serveur HTTP et le token pour une communication directe.
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
const info = await CapgoCapacitorFastSql.getServerInfo({ database: 'myapp' });
console.log('Server port:', info.port);
execute()
Exécutez une requête SQL via le bridge Capacitor (pour les requêtes simples). Pour de meilleures performances avec de gros jeux de données, utilisez directement le protocole HTTP via 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()
Démarrez une transaction de base de données.
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
await CapgoCapacitorFastSql.beginTransaction({ database: 'myapp' });
// Execute multiple operations
await CapgoCapacitorFastSql.commitTransaction({ database: 'myapp' });
commitTransaction()
Validez la transaction en cours.
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
await CapgoCapacitorFastSql.commitTransaction({ database: 'myapp' });
Le tableau ci-dessus liste les 8 méthodes principales. Les helpers de listener et de version, ainsi que le contrat complet de chaque méthode, sont documentés dans le dépôt GitHub.
Référence complète
Continuer depuis Utilisation de @capgo/capacitor-fast-sql
Si vous utilisez Utiliser @capgo/capacitor-fast-sql pour planifier le stockage et la gestion des fichiers, connectez-l’à @capgo/capacitor-fast-sql pour les détails d’implémentation dans @capgo/capacitor-fast-sql, Prise en main pour les détails d'implémentation dans Getting Started @capgo/capacitor-data-storage-sqlite pour les détails d'implémentation dans @capgo/capacitor-data-storage-sqlite, Utiliser @capgo/capacitor-data-storage-sqlite pour la capacité native dans Using @capgo/capacitor-data-storage-sqlite, et @capgo/capacitor-file pour les détails d’implémentation dans @capgo/capacitor-file.