가이드
Capacitor에서 Fast SQL 사용법
@capgo/capacitor-fast-sql 사용하기
고성능 SQLite 데이터베이스 액세스를 위한 Fast SQL 플러그인
설치
bun add @capgo/capacitor-fast-sql
bunx cap sync
bunx cap sync 플러그인의 네이티브 code를 네이티브 프로젝트에 복사합니다. 플러그인을 업그레이드할 때마다 다시 실행하세요.
가져오기
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
API 한눈에 보기
| 메서드 | 설명 |
|---|---|
connect |
데이터베이스 연결을 초기화하고 HTTP 서버를 시작합니다. |
disconnect |
데이터베이스 연결을 종료하고 HTTP 서버를 중지합니다. |
getServerInfo |
직접 통신을 위한 HTTP 서버 포트와 토큰을 가져옵니다. |
execute |
Capacitor 브릿지를 통해 SQL 쿼리를 실행합니다(단순 쿼리용). 대용량 데이터의 성능을 높이려면 SQLConnection 클래스를 통해 HTTP 프로토콜을 직접 사용하세요. |
beginTransaction |
데이터베이스 트랜잭션을 시작합니다. |
commitTransaction |
현재 트랜잭션을 커밋합니다. |
rollbackTransaction |
현재 트랜잭션을 롤백합니다. |
configureWeb |
공식 SQLite Wasm 모듈의 웹 전용 옵션을 설정합니다. |
예시
connect()
데이터베이스 연결을 초기화하고 HTTP 서버를 시작합니다.
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
const conn = await CapgoCapacitorFastSql.connect({ database: 'myapp' });
console.log('Connected on port:', conn.port);
disconnect()
데이터베이스 연결을 닫고 HTTP 서버를 중지합니다.
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
await CapgoCapacitorFastSql.disconnect({ database: 'myapp' });
getServerInfo()
직접 통신용 HTTP 서버 포트와 토큰을 가져옵니다.
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
const info = await CapgoCapacitorFastSql.getServerInfo({ database: 'myapp' });
console.log('Server port:', info.port);
execute()
Capacitor 브리지를 통해 SQL 쿼리를 실행합니다(단순 쿼리용). 대용량 데이터셋에서 더 나은 성능을 원하면 SQLConnection 클래스로 HTTP 프로토콜을 직접 사용하세요.
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()
데이터베이스 트랜잭션을 시작합니다.
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
await CapgoCapacitorFastSql.beginTransaction({ database: 'myapp' });
// Execute multiple operations
await CapgoCapacitorFastSql.commitTransaction({ database: 'myapp' });
commitTransaction()
현재 트랜잭션을 커밋합니다.
import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';
await CapgoCapacitorFastSql.commitTransaction({ database: 'myapp' });
위 표는 8가지 핵심 메서드를 나열합니다. Listener와 version 헬퍼, 그리고 각 메서드의 전체 명세는 다음 문서에 정리되어 있습니다. GitHub 리포지토리.
전체 레퍼런스
@capgo/capacitor-fast-sql 사용법 계속 보기
사용 중이라면 @capgo/capacitor-fast-sql 사용하기 저장 공간과 파일 처리를 계획하려면, 다음 항목과 연결하세요 @capgo/capacitor-fast-sql @capgo/capacitor-fast-sql의 구현 세부 사항은 시작하기 Getting Started의 구현 상세 내용은 @capgo/capacitor-data-storage-sqlite @capgo/capacitor-data-storage-sqlite의 구현 세부 사항은, @capgo/capacitor-data-storage-sqlite 사용하기 @capgo/capacitor-data-storage-sqlite 사용하기에서 네이티브 기능은, @capgo/capacitor-file @capgo/capacitor-file.의 구현 세부 사항은