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 |
Initialise la connexion à la base de données et démarre le serveur HTTP. |
disconnect |
Ferme la connexion à la base de données et arrête le serveur HTTP. |
getServerInfo |
Récupère le port du serveur HTTP et le token pour une communication directe. |
execute |
Exécute une requête SQL via le bridge Capacitor (pour les requêtes simples). Pour de meilleures performances avec des jeux de données volumineux, utilisez directement le protocole HTTP via la classe SQLConnection. |
beginTransaction |
Démarre une transaction de base de données. |
commitTransaction |
Valide 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 après l'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 Utiliser @capgo/capacitor-data-storage-sqlite, et @capgo/capacitor-file pour les détails d'implémentation dans @capgo/capacitor-file.