다음을 통해 공유

데이터 형식

SQLite에는 네 가지 기본 데이터 형식이 있습니다: INTEGER, REAL, TEXT, 및 BLOB. 데이터베이스 값을 반환하는 API object 는 이러한 네 가지 형식 중 하나만 반환합니다. 추가 .NET 형식은 Microsoft.Data.Sqlite에서 지원되지만, 값은 궁극적으로 이러한 형식과 네 가지 기본 형식 중 하나 간에 강제 변환됩니다.

.NET SQLite 비고
Boolean INTEGER 0 또는 1
Byte INTEGER
Byte[] BLOB
Char TEXT UTF-8
DateOnly TEXT yyyy-MM-dd
DateTime TEXT yyyy-MM-dd HH:mm:ss.FFFFFFF
DateTimeOffset TEXT yyyy-MM-dd HH:mm:ss.FFFFFFFzzz
Decimal TEXT 0.0########################### 형식. REAL 는 손실을 발생시킵니다.
Double REAL
Guid TEXT 00000000-0000-0000-0000-000000000000
Int16 INTEGER
Int32 INTEGER
Int64 INTEGER
SByte INTEGER
Single REAL
String TEXT UTF-8
TimeOnly TEXT HH:mm:ss.fffffff
TimeSpan TEXT d.hh:mm:ss.fffffff
UInt16 INTEGER
UInt32 INTEGER
UInt64 INTEGER 큰 값에는 오버플로우가 발생합니다.

대체 형식

일부 .NET 형식은 대체 SQLite 형식에서 읽을 수 있습니다. 이러한 대체 형식을 사용하도록 매개 변수를 구성할 수도 있습니다. 자세한 내용은 매개 변수를 참조하세요.

.NET SQLite 비고
Char INTEGER UTF-16
DateOnly REAL 줄리안 일 값
DateTime REAL 줄리안 일 값
DateTimeOffset REAL 줄리안 일 값
Guid BLOB
TimeOnly REAL 일 단위
TimeSpan REAL 일 단위

예를 들어 다음 쿼리는 결과 집합의 열에서 REAL TimeSpan 값을 읽습니다.

command.CommandText =
@"
    SELECT name, julianday(finished) - julianday(started) AS length
    FROM task
    WHERE finished IS NOT NULL
";
using (var reader = command.ExecuteReader())
{
    while (reader.Read())
    {
        var name = reader.GetString(0);
        var length = reader.GetTimeSpan(1);

        Console.WriteLine($"'{name}' took {length}.");
    }
}

열 형식

SQLite는 값 형식이 저장된 열이 아니라 값 자체와 연결된 동적 형식 시스템을 사용합니다. 원하는 열 형식 이름을 자유롭게 사용할 수 있습니다. Microsoft.Data.Sqlite는 이러한 이름에 추가 의미 체계를 적용하지 않습니다.

열 형식 이름은 형식 선호도에 영향을 미칩니다. 일반적인 한 가지 문제는 STRING 열 형식을 사용하면 값을 INTEGER 또는 REAL으로 변환하려고 시도하여 예기치 않은 결과로 이어질 수 있다는 것입니다. 네 가지 INTEGER기본 SQLite 형식 이름( , , REALTEXT및 BLOB)만 사용하는 것이 좋습니다.

SQLite를 사용하면 길이, 정밀도 및 배율과 같은 형식 패싯을 지정할 수 있지만 데이터베이스 엔진에 의해 적용되지 않습니다. 앱은 이를 강제하는 것에 책임이 있습니다.

참고하십시오

  • Last updated on