Guide
Comment utiliser Fast SQL dans Capacitor
Utilisation de @capgo/capacitor-fast-sql
Plugin SQL rapide pour l'accès à la base de données SQLite haute performance.
Installer
bun add @capgo/capacitor-fast-sql
bunx cap sync
bunx cap sync copie le code natif du plugin code dans vos projets natifs. Exécutez-l’à nouveau après chaque mise à jour du plugin.
Importer
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
Vue d'ensemble de API
| Méthode | Description |
|---|---|
connect |
Initialisez la connexion à la base de données et démarrez le serveur HTTP. |
disconnect |
Closez la connexion à la base de données et arrêtez le serveur HTTP. |
getServerInfo |
Obtenez le port et le jeton du serveur HTTP pour une communication directe. |
execute |
Exécutez une requête SQL via Capacitor pont (pour des requêtes simples). Pour une meilleure performance avec de grands ensembles de données, utilisez le protocole HTTP directement 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 SQLite Wasm officiel. |
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()
Closez 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()
Obtenez le port du serveur HTTP et le jeton 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 pont Capacitor (pour des requêtes simples). Pour une meilleure performance avec de grands ensembles de données, utilisez le protocole HTTP directement 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émarrer 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()
Valider la transaction en cours.
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
await CapgoCapacitorFastSql.commitTransaction({ database: 'myapp' });
La table ci-dessus liste les 8 méthodes de base. Les aides aux écouteurs et aux versions, ainsi que la pleine convention de chaque méthode, sont documentés dans le référentiel GitHub.
Référence complète
Continuez à partir de l'utilisation de @capgo/capacitor-fast-sql
Continuez à partir de l'utilisation de @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-fast-sql : Utilisez @capgo/capacitor-fast-sql pour planifier le stockage et la gestion des fichiers, connectez-l’avec à @capgo/capacitor-fast-sql pour les détails d'implémentation dans @capgo/capacitor-fast-sql, Getting Started pour les détails d'implémentation dans Démarrage, à @capgo/capacitor-data-storage-sqlite pour les détails d'implémentation dans @capgo/capacitor-data-storage-sqlite, Utilisez @capgo/capacitor-data-storage-sqlite pour la capacité native dans Utilisez @capgo/capacitor-data-storage-sqlite, et à @capgo/capacitor-file pour les détails d'implémentation dans @capgo/capacitor-file.