개요
“개요” 섹션이름이 지정된 스토어를 열고, 키를 설정하며, SQL을 직접 작성하지 않고 값을 쿼리합니다. 스토어 내에서 테이블을 전환하고, JSON 페이로드를 마이그레이션하며, OS 샌드박스 이상의 at-rest 보호가 필요할 때 iOS와 Android에서 암호화를 활성화합니다.
대표적인 사용 사례: 오프라인 설정, 임시 저장 양식, 프로세스 재시작 후에도 유지되어야 하는 캐시된 API 페이로드 및 기능 플래그.
플랫폼 지원
“플랫폼 지원” 섹션| 플랫폼 | 지원 | 참고 사항 |
|---|---|---|
| iOS | 지원 | 커뮤니티 스토리지 레이어를 통한 SQLite |
| Android | 지원 | 선택적 암호화 지원 SQLite |
| 웹 | 지원 | IndexedDB 기반 구현 |
핵심 기능
“핵심 기능” 섹션openStore- 스토어 열기.closeStore- 스토어 닫기.isStoreOpen- 스토어가 열려 있는지 확인.isStoreExists- 스토어가 존재하는지 확인.
공개 API
“Public API” 섹션| 메서드 | 설명 |
|---|---|
openStore | Store를 엽니다. |
closeStore | Store를 닫습니다. |
isStoreOpen | Store가 열려 있는지 확인합니다. |
isStoreExists | Store가 존재하는지 확인합니다. |
deleteStore | Store를 삭제합니다. |
setTable | 기존 Store에 테이블을 설정하거나 추가합니다. |
set | 지정된 키와 값으로 데이터를 저장합니다. |
get | 지정된 키에 해당하는 데이터 값을 가져옵니다. |
remove | 지정된 키의 데이터를 삭제합니다. |
clear | Data Store를 비웁니다 (모든 키 삭제). |
iskey | 데이터 키가 존재하는지 확인합니다. |
keys | 데이터 키 목록을 가져옵니다. |
values | 데이터 값 목록을 가져옵니다. |
filtervalues | 필터 키에 대한 데이터 값 목록을 가져옵니다. |
keysvalues | 데이터 키/값 쌍 목록을 가져옵니다. |
isTable | 테이블 존재 여부를 확인합니다. |
tables | 현재 스토어의 테이블 목록을 가져옵니다. |
deleteTable | 테이블을 삭제합니다. |
importFromJson | JSON에서 데이터베이스를 가져옵니다. |
isJsonValid | JSON 객체의 유효성을 확인합니다. |
exportToJson | 주어진 데이터베이스를 JSON 객체로 내보냅니다. |
getPluginVersion | 네이티브 Capacitor 플러그인 버전을 가져옵니다. |
Source of Truth
“Source Of Truth” 섹션이 레퍼런스는 다음에서 동기화됩니다. src/definitions.ts 에서 capacitor-data-storage-sqlite.
@capgo/capacitor-data-storage-sqlite에서 계속하기
“@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의 구현 세부 사항은, @capgo/capacitor-file 사용하기 @capgo/capacitor-file 사용 시 네이티브 기능은 @capgo/capacitor-uploader @capgo/capacitor-uploader의 구현 세부 사항은, 그리고 @capgo/capacitor-uploader 사용하기 @capgo/capacitor-uploader. 사용 시 네이티브 기능은