UWP 앱에서 SQLite 데이터베이스 사용
SQLite를 사용하여 사용자의 디바이스에 있는 경량 데이터베이스에 데이터를 저장하고 검색할 수 있습니다. 이 가이드에서는 그 방법을 보여줍니다.
로컬 스토리지에 SQLite를 사용할 때의 이점
✔️ SQLite는 가볍고 독립적입니다. 다른 종속성이 없는 코드 라이브러리입니다. 구성이 필요 없습니다.
✔️ 데이터베이스 서버가 없습니다. 클라이언트와 서버가 동일한 프로세스에서 실행됩니다.
✔️ SQLite는 공용 도메인에 기반을 두고 있어 자유롭게 사용하고 앱을 통해 배포할 수 있습니다.
✔️ SQLite는 모든 플랫폼과 아키텍처에서 작동합니다.
SQLite에 대한 자세한 내용은 여기를 참조하세요.
추상화 계층 선택
Microsoft가 빌드한 Entity Framework Core 또는 오픈 소스인 SQLite 라이브러리를 사용하는 것이 좋습니다.
Entity Framework Core
EF(Entity Framework)는 도메인별 개체를 사용하여 관계형 데이터로 작업할 수 있는 개체 관계형 매퍼입니다. 다른 .NET 앱의 데이터에 이 프레임워크를 이미 사용하고 있다면, 코드를 UWP 앱으로 마이그레이션할 수 있습니다. 그러면 연결 문자열이 적절히 변경되어 작동합니다.
직접 시도해 보려면 EF Core 시작을 참조하세요.
SQLite 라이브러리
Microsoft.Data.Sqlite 라이브러리는 System.Data.Common 네임스페이스에 인터페이스를 구현합니다. Microsoft는 이러한 구현 방식을 적극적으로 유지하고 있으며, 이 방식은 저수준 기본 SQLite API와 관련된 직관적인 래퍼를 제공합니다.
이 가이드의 나머지 부분에서는 이 라이브러리의 사용 방법을 안내합니다.
Microsoft.Data.SQlite 라이브러리를 사용할 수 있도록 솔루션 설정
기본 UWP 프로젝트를 시작하고 적절한 Nuget 패키지를 설치하겠습니다.
지원되는 모든 Windows 버전은 SQLite를 지원하므로 앱에서 SQLite 라이브러리를 패키지할 필요가 없습니다. 그 대신, Windows와 함께 설치되는 SQLite 버전을 사용할 수 있습니다. 이는 몇 가지 측면에서 도움이 됩니다.
✔️ SQLite 바이너리를 다운로드하여 애플리케이션의 일부로 패키징할 필요가 없기 때문에 애플리케이션 크기가 줄어듭니다.
✔️ SQLite에서 SQLite의 버그와 보안 취약성을 해결하는 중요한 픽스를 게시할 때 사용자에게 새 앱 버전을 푸시할 필요가 없습니다. SQLite의 Windows 버전은 Microsoft가 SQLite.org와 함께 유지 관리합니다.
✔️ SQLite의 SDK 버전이 이미 메모리에 로드될 가능성이 높기 때문에 앱 로드 시간이 더 빨라질 수 있습니다.
DataAccess라는 UWP 프로젝트에 클래스를 추가하여 시작할 예정입니다. .NET Standard 클래스 라이브러리 프로젝트를 사용하여 데이터 액세스 코드를 포함할 수 있지만 예제에서는 사용하지 않습니다.
솔루션을 마우스 오른쪽 단추로 클릭한 다음, 솔루션용 NuGet 패키지 관리를 클릭합니다.
여기서 선택할 수 있습니다. Windows에 포함된 SQLite 버전을 사용할 수도 있고, 또는 특정 SQLite 버전을 사용해야 하는 이유가 있는 경우 패키지에 SQLite 라이브러리를 포함시킬 수도 있습니다. Microsoft는 Windows에 포함된 SQLite 버전을 사용할 것입니다.
찾아보기 탭을 선택하고 Microsoft.Data.SQLite.Core 패키지를 검색한 다음 안정적인 최신 버전을 설치합니다.
SQLite 데이터베이스에서 데이터를 추가 및 검색
수행할 단계:
1️⃣ 데이터 액세스 클래스를 준비합니다.
2️⃣ SQLite 데이터베이스를 초기화합니다.
3️⃣ SQLite 데이터베이스에 데이터를 삽입합니다.
4️⃣ SQLite 데이터베이스에서 데이터를 검색합니다.
5️⃣ 기본 사용자 인터페이스를 추가합니다.
데이터 액세스 클래스 준비
프로젝트에서 DataAccess 클래스를 열고 해당 클래스를 정적으로 만듭니다.
참고 항목
이 예에서는 정적 클래스에 데이터 액세스 코드를 배치했지만, 이는 디자인 옵션으로 어디까지나 선택 사항입니다.
public static class DataAccess
{
}
명령문을 사용하여 이 파일 맨 위에 다음을 추가합니다.
using Microsoft.Data.Sqlite;
using System.Collections.Generic;
SQLite 데이터베이스 초기화
SQLite 데이터베이스를 초기화하는 DataAccess 클래스에 메서드를 추가합니다.
public async static void InitializeDatabase()
{
await ApplicationData.Current.LocalFolder.CreateFileAsync("sqliteSample.db", CreationCollisionOption.OpenIfExists);
string dbpath = Path.Combine(ApplicationData.Current.LocalFolder.Path, "sqliteSample.db");
using (SqliteConnection db =
new SqliteConnection($"Filename={dbpath}"))
{
db.Open();
String tableCommand = "CREATE TABLE IF NOT " +
"EXISTS MyTable (Primary_Key INTEGER PRIMARY KEY, " +
"Text_Entry NVARCHAR(2048) NULL)";
SqliteCommand createTable = new SqliteCommand(tableCommand, db);
createTable.ExecuteReader();
}
}
이 코드는 SQLite 데이터베이스를 만들어서 애플리케이션의 로컬 데이터 저장소에 저장합니다.
이 예에서는 데이터베이스 이름을 sqlliteSample.db로 지정했지만, 인스턴스화하는 모든 SqliteConnection 개체에서 사용하기만 한다면 어떤 이름이든 상관 없습니다.
UWP 프로젝트의 App.xaml.cs 파일 생성자에서 DataAccess 클래스의 InitializeDatabase 메서드를 호출합니다.
public App()
{
this.InitializeComponent();
this.Suspending += OnSuspending;
DataAccess.InitializeDatabase();
}
SQLite 데이터베이스에 데이터 삽입
SQLite 데이터베이스에 데이터를 삽입하는 DataAccess 클래스에 메서드를 추가합니다. 이 코드는 SQL 삽입 공격을 방지하기 위해 쿼리에 매개 변수를 사용합니다.
public static void AddData(string inputText)
{
string dbpath = Path.Combine(ApplicationData.Current.LocalFolder.Path, "sqliteSample.db");
using (SqliteConnection db =
new SqliteConnection($"Filename={dbpath}"))
{
db.Open();
SqliteCommand insertCommand = new SqliteCommand();
insertCommand.Connection = db;
// Use parameterized query to prevent SQL injection attacks
insertCommand.CommandText = "INSERT INTO MyTable VALUES (NULL, @Entry);";
insertCommand.Parameters.AddWithValue("@Entry", inputText);
insertCommand.ExecuteReader();
}
}
SQLite 데이터베이스에서 데이터 검색
SQLite 데이터베이스에서 데이터 행을 가져오는 메서드를 추가합니다.
public static List<String> GetData()
{
List<String> entries = new List<string>();
string dbpath = Path.Combine(ApplicationData.Current.LocalFolder.Path, "sqliteSample.db");
using (SqliteConnection db =
new SqliteConnection($"Filename={dbpath}"))
{
db.Open();
SqliteCommand selectCommand = new SqliteCommand
("SELECT Text_Entry from MyTable", db);
SqliteDataReader query = selectCommand.ExecuteReader();
while (query.Read())
{
entries.Add(query.GetString(0));
}
}
return entries;
}
Read 메서드는 반환된 데이터 행을 통과합니다. 행이 남아 있으면 true을(를) 반환하고, 그렇지 않으면 false을(를) 반환합니다.
GetString 메서드는 특정 열의 값을 문자열로 반환합니다. 원하는 데이터의 0부터 시작하는 열 서수를 나타내는 정수 값을 수락합니다. GetDataTime 및 GetBoolean 같이 유사한 메서드를 사용할 수도 있습니다. 열에 포함된 데이터 유형에 따라 메서드를 선택합니다.
이 예에서는 한 열에서 모든 항목을 선택하기 때문에 서수 매개 변수가 중요하지 않습니다. 하지만 여러 열이 쿼리에 사용되는 경우 데이터를 가져올 열을 획득하려면 서수 값을 사용해야 합니다.
기본 사용자 인터페이스 추가
UWP 프로젝트의 MainPage.xaml 파일에 다음 XAML을 추가합니다.
<Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
<StackPanel>
<TextBox Name="Input_Box"></TextBox>
<Button Click="AddData">Add</Button>
<ListView Name="Output">
<ListView.ItemTemplate>
<DataTemplate>
<TextBlock Text="{Binding}"/>
</DataTemplate>
</ListView.ItemTemplate>
</ListView>
</StackPanel>
</Grid>
이 기본 사용자 인터페이스는 SQLite 데이터베이스에 추가할 문자열을 입력하는 데 사용할 수 있는 TextBox를 제공합니다. 이 UI의 Button을 SQLite 데이터베이스에서 데이터를 검색하여 ListView에 표시하는 이벤트 처리기에 연결할 것입니다.
MainPage.xaml.cs 파일에서 다음 처리기를 추가합니다. 이 메서드를 UI에 있는 Button의 Click 이벤트와 연결합니다.
private void AddData(object sender, RoutedEventArgs e)
{
DataAccess.AddData(Input_Box.Text);
Output.ItemsSource = DataAccess.GetData();
}
또한 애플리케이션이 시작될 때 기존 데이터가 로드되는지 확인하려고 합니다. MainPage 생성자에 코드 줄을 추가하여 GetData()를 호출합니다.
public MainPage()
{
this.InitializeComponent();
Output.ItemsSource = DataAccess.GetData();
}
다 되었습니다. Microsoft.Data.Sqlite를 살펴보면서 SQLite 데이터베이스로 또 무엇을 할 수 있는지 알아보세요. 아래 링크를 통해 UWP 앱에서 데이터를 활용하는 다른 방법을 알아보세요.
다음 단계
앱을 SQL Server 데이터베이스에 직접 연결
UWP 앱에서 SQL Server 데이터베이스 사용을 참조하세요.
여러 플랫폼의 여러 앱 간에 코드 공유
데스크톱과 UWP 간에 코드 공유를 참조하세요.
Azure SQL 백엔드로 마스터 세부 정보 페이지 추가
고객 주문 데이터베이스 샘플을 참조하세요.