Guía
Cómo usar Fast SQL en Capacitor
Usando @capgo/capacitor-fast-sql
Plugin Fast SQL para acceso de alto rendimiento a bases de datos SQLite.
Instalar
bun add @capgo/capacitor-fast-sql
bunx cap sync
bunx cap sync copia el code nativo del plugin en tus proyectos nativos. Ejecútalo de nuevo tras cada actualización del plugin.
Importar
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
API de un vistazo
| Método | Descripción |
|---|---|
connect |
Inicializa la conexión a la base de datos e inicia el servidor HTTP. |
disconnect |
Cierra la conexión a la base de datos y detén el servidor HTTP. |
getServerInfo |
Obtén el puerto del servidor HTTP y el token para la comunicación directa. |
execute |
Ejecuta consultas SQL mediante el bridge de Capacitor (para consultas simples). Para un mejor rendimiento con grandes datasets, usa el protocolo HTTP directamente con la clase SQLConnection. |
beginTransaction |
Inicia una transacción de base de datos. |
commitTransaction |
Confirma la transacción actual. |
rollbackTransaction |
Revierte la transacción actual. |
configureWeb |
Configura las opciones web para el módulo oficial de SQLite Wasm. |
Ejemplos
connect()
Inicializa la conexión a la base de datos e inicia el servidor HTTP.
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
const conn = await CapgoCapacitorFastSql.connect({ database: 'myapp' });
console.log('Connected on port:', conn.port);
disconnect()
Cierra la conexión a la base de datos y detén el servidor HTTP.
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
await CapgoCapacitorFastSql.disconnect({ database: 'myapp' });
getServerInfo()
Obtén el puerto del servidor HTTP y el token para la comunicación directa.
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
const info = await CapgoCapacitorFastSql.getServerInfo({ database: 'myapp' });
console.log('Server port:', info.port);
execute()
Ejecuta consultas SQL mediante el bridge de Capacitor (para consultas simples). Para un mejor rendimiento con grandes datasets, usa el protocolo HTTP directamente con la clase 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()
Inicia una transacción de base de datos.
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
await CapgoCapacitorFastSql.beginTransaction({ database: 'myapp' });
// Execute multiple operations
await CapgoCapacitorFastSql.commitTransaction({ database: 'myapp' });
commitTransaction()
Confirma la transacción actual.
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
await CapgoCapacitorFastSql.commitTransaction({ database: 'myapp' });
La tabla anterior lista los 8 métodos principales. Los helpers de listener y de versión, y el contrato completo de cada método, están documentados en la repositorio GitHub.
Referencia completa
Continuar desde Uso de @capgo/capacitor-fast-sql
Si estás usando Uso de @capgo/capacitor-fast-sql para planificar el almacenamiento y la gestión de archivos, conéctalo con @capgo/capacitor-fast-sql para los detalles de implementación en @capgo/capacitor-fast-sql, Primeros pasos para los detalles de implementación en Primeros pasos, @capgo/capacitor-data-storage-sqlite para el detalle de implementación en @capgo/capacitor-data-storage-sqlite, Uso de @capgo/capacitor-data-storage-sqlite para la capacidad nativa en Uso de @capgo/capacitor-data-storage-sqlite, y @capgo/capacitor-file por los detalles de implementación en @capgo/capacitor-file.