리액트 네이티브에서 SQLite를 사용하는 방법은 무엇인가요?

리액트 네이티브에서 SQLite를 사용하는 방법 FAQ

Q1. 리액트 네이티브에서 SQLite를 사용하려면 어떤 라이브러리를 설치해야 하나요?
A1. 가장 많이 사용하는 라이브러리는 [`react-native-sqlite-storage`](https://github.com/andpor/react-native-sqlite-storage)입니다. 이 라이브러리는 Android와 iOS 모두 지원하며, 설치 후 네이티브 링크 작업이 필요합니다.

---

Q2. `react-native-sqlite-storage` 설치 방법은 어떻게 되나요?
A2. 터미널에서 아래 명령어로 설치합니다.
```bash
npm install react-native-sqlite-storage
또는
yarn add react-native-sqlite-storage
```
설치 후 리액트 네이티브 0.60 이상이면 자동으로 링크되지만, 필요 시 수동 링크를 할 수도 있습니다.

---

Q3. Android와 iOS에서 추가 설정은 어떤 것이 필요한가요?
A3.
- iOS : `cd ios && pod install` 명령어로 CocoaPods를 통해 라이브러리를 설치해야 합니다.
- Android : `android/app/build.gradle`에 기본적으로 설정이 되어 있지만, 반드시 `minSdkVersion`이 16 이상인지 확인하세요.

---

Q4. SQLite 데이터베이스를 어떻게 생성하고 연결하나요?
A4. 다음과 같이 데이터베이스를 엽니다.
```javascript
import SQLite from 'react-native-sqlite-storage';

const db = SQLite.openDatabase(
{name: 'mydb.db', location: 'default'},
() => { console.log('DB opened'); },
error => { console.log('DB error: ', error); }
);
```

---

Q5. 테이블을 생성하는 기본 코드는 어떻게 되나요?
A5. `transaction` 메서드를 사용해 SQL 쿼리를 실행합니다.
```javascript
db.transaction(tx => {
tx.executeSql(
'CREATE TABLE IF NOT EXISTS Users (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT, age INTEGER);',
[],
() => { console.log('Table created successfully'); },
(tx, error) => { console.log('Error creating table:', error); }
);
});
```

---

Q6. 데이터 삽입은 어떻게 하나요?
A6. `executeSql`에 삽입 쿼리를 전달합니다.
```javascript
db.transaction(tx => {
tx.executeSql(
'INSERT INTO Users (name, age) VALUES (?, ?);',
['Alice', 25],
() => { console.log('Data inserted'); },
(tx, error) => { console.log('Insert error:', error); }
);
});
```

---
Q7. 데이터를 조회하는 방법은?
A7. `executeSql`의 성공 콜백에서 결과를 받아옵니다.
```javascript
db.transaction(tx => {
tx.executeSql(
'SELECT * FROM Users;',
[],
(tx, results) => {
let rows = results.rows;
for (let i = 0; i < rows.length; i++) {
console.log(`User: ${rows.item(i).name}, Age: ${rows.item(i).age}`);
}
}
);
});
```

---

Q8. 데이터 업데이트 및 삭제는?
A8. SQL UPDATE, DELETE 문법을 그대로 사용합니다.
```javascript
// 업데이트 예
db.transaction(tx => {
tx.executeSql(
'UPDATE Users SET age = ? WHERE name = ?;',
[26, 'Alice']
);
});

// 삭제 예
db.transaction(tx => {
tx.executeSql(
'DELETE FROM Users WHERE name = ?;',
['Alice']
);
});
```

---

Q9. 트랜잭션 외에 비동기/프로미스 방식 사용이 가능한가요?
A9. 기본 제공 API는 콜백 기반이지만, [`react-native-sqlite-2`](https://github.com/craftzdog/react-native-sqlite-2) 같은 프로미스 기반 라이브러리를 사용하거나, 콜백을 `Promise`로 감싸 직접 구현할 수도 있습니다.

---

Q10. SQLite 데이터베이스 파일 위치는 어디에 저장되나요?
A10.
- iOS: 앱의 샌드박스 내 `Library/LocalDatabase` 폴더
- Android: 앱 전용 디렉터리의 `databases` 폴더
`location: 'default'` 설정 시 자동으로 적절한 위치에 저장됩니다.

---

Q11. 디버깅 팁이나 주의사항이 있나요?
A11.
- 트랜잭션 내에서 여러 쿼리를 실행 시 순서 및 에러 핸들링을 신경 써야 합니다.
- 쿼리 문법 오류, 데이터 타입 불일치가 자주 발생하므로 SQL 문을 꼼꼼히 확인하세요.
- Android 에뮬레이터나 iOS 시뮬레이터에서 DB 파일 위치에 접근해 직접 확인할 수 있습니다.

---

Q12. 리액트 네이티브 공식 docs에도 나와 있나요?
A12. 리액트 네이티브 공식 문서에서는 SQLite가 기본 라이브러리가 아니므로 별도 언급은 없으며, 위 공식 라이브러리 `react-native-sqlite-storage` GitHub 페이지에서 자세한 문서와 예제를 참고하는 것이 가장 좋습니다.

---

위 FAQ를 참고하시면 리액트 네이티브에서 SQLite를 설치하고 사용하는 데 큰 도움이 될 것입니다.

리액트 네이티브에서 SQLite를 사용하는 방법은 모바일 애플리케이션에서 데이터베이스를 관리하고 저장하는 데 매우 유용합니다.

SQLite는 경량의 관계형 데이터베이스로, 로컬 데이터 저장소로 많이 사용됩니다.

리액트 네이티브에서 SQLite를 사용하기 위해서는 몇 가지 단계를 따라야 합니다.

아래에서 자세히 설명하겠습니다.

1. 프로젝트 설정 리액트 네이티브 프로젝트를 시작하기 위해, 먼저 새로운 프로젝트를 생성합니다.

아래의 명령어를 사용하여 새 프로젝트를 생성할 수 있습니다.

```bash npx react-native init MySQLiteApp cd MySQLiteApp ```

2. SQLite 라이브러리 설치 리액트 네이티브에서 SQLite를 사용하기 위해 `react-native-sqlite-storage` 라이브러리를 설치합니다.

이 라이브러리는 SQLite 데이터베이스와 상호작용할 수 있는 API를 제공합니다.

```bash npm install react-native-sqlite-storage ``` 또는 Yarn을 사용하는 경우: ```bash yarn add react-native-sqlite-storage ```

3. 링크 및 설정 리액트 네이티브 0.60 이상에서는 자동 링크가 지원되므로 별도로 링크할 필요는 없습니다.

그러나 이전 버전을 사용하고 있다면, 수동으로 링크해야 합니다.

```bash react-native link react-native-sqlite-storage ``` iOS에서는 Podfile에 다음을 추가해야 합니다: ```ruby pod 'SQLite.swift', '~> 0.12.2' ``` 그 후, 다음 명령어로 Pods를 설치합니다.

```bash cd ios pod install cd .. ```

4. SQLite 데이터베이스 사용 SQLite를 사용하기 위해 데이터베이스를 열고 쿼리를 실행하는 방법을 살펴보겠습니다.

아래는 기본적인 사용 예제입니다.

```javascript import React, { useEffect } from 'react'; import { View, Text } from 'react-native'; import SQLite from 'react-native-sqlite-storage'; const database_name = "MyDatabase.db"; const database_version = "1.0"; const database_displayname = "SQLite React Native Example"; const database_size = 200000; const App = () => { useEffect(() => { const db = SQLite.openDatabase( database_name, database_version, database_displayname, database_size, () => { console.log("Database opened successfully"); createTable(db); }, error => { console.error("Error opening database: ", error); } ); }, []); const createTable = (db) => { db.transaction(tx => { tx.executeSql( 'CREATE TABLE IF NOT EXISTS Users (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT, age INTEGER)', [], () => { console.log("Table created successfully"); insertUser(db); }, error => { console.error("Error creating table: ", error); } ); }); }; const insertUser = (db) => { db.transaction(tx => { tx.executeSql( 'INSERT INTO Users (name, age) VALUES (?, ?)', ['John Doe', 30], () => { console.log("User inserted successfully"); fetchUsers(db); }, error => { console.error("Error inserting user: ", error); } ); }); }; const fetchUsers = (db) => { db.transaction(tx => { tx.executeSql( 'SELECT * FROM Users', [], (tx, results) => { let users = []; for (let i = 0; i < results.rows.length; i++) { users.push(results.rows.item(i)); } console.log("Fetched users: ", users); }, error => { console.error("Error fetching users: ", error); } ); }); }; return ( SQLite Example in React Native ); }; export default App; ```

5. 데이터베이스 작업 위의 예제에서는 데이터베이스를 열고, 테이블을 생성하고, 데이터를 삽입하고, 데이터를 조회하는 기본적인 작업을 수행했습니다.

각 작업은 트랜잭션 내에서 실행되며, 성공 및 오류 콜백을 통해 결과를 처리합니다.



6. 데이터베이스 닫기 애플리케이션이 종료되거나 데이터베이스 작업이 완료된 후에는 데이터베이스를 닫는 것이 좋습니다.

`db.close()` 메서드를 사용하여 데이터베이스를 닫을 수 있습니다.



7. 에러 처리 SQLite 작업 중 발생할 수 있는 오류를 적절히 처리하는 것이 중요합니다.

위의 예제에서는 각 SQL 쿼리에서 오류 콜백을 통해 오류를 로그로 출력하고 있습니다.



8. 최적화 및 추가 기능 SQLite를 사용할 때는 성능을 고려하여 쿼리를 최적화하고, 필요한 경우 인덱스를 추가하는 것이 좋습니다.

또한, 데이터베이스의 구조를 변경할 필요가 있을 경우 마이그레이션 전략을 세워야 합니다.

결론 리액트 네이티브에서 SQLite를 사용하는 것은 로컬 데이터 저장소를 관리하는 데 매우 유용합니다.

위의 단계와 예제를 따라하면 SQLite 데이터베이스를 쉽게 설정하고 사용할 수 있습니다.

다양한 데이터베이스 작업을 수행하면서 애플리케이션의 요구 사항에 맞게 추가적인 기능을 구현할 수 있습니다.