영어로 읽기

다음을 통해 공유


데이터 형식

SQLite에는 INTEGER, REAL, TEXT 및 BLOB이라는 네 가지 기본 데이터 형식만 있습니다. 데이터베이스 값을 object로 반환하는 API는 이 네 가지 형식 중 하나만 반환합니다. 추가 .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
소수 TEXT 0.0########################### 형식. REAL은 손실 형식입니다.
두 배 REAL
GUID TEXT 00000000-0000-0000-0000-000000000000
Int16 INTEGER
Int32 INTEGER
Int64 INTEGER
SByte INTEGER
단일 REAL
문자열 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로 변환하려고 시도하므로 예기치 않은 결과가 발생할 수 있는 것입니다. 네 가지 기본 SQLite 형식 이름(INTEGER, REAL, TEXT 및 BLOB)만 사용하는 것이 좋습니다.

SQLite를 사용하면 길이, 전체 자릿수 및 소수 자릿수와 같은 형식 패싯을 지정할 수 있지만 데이터베이스 엔진은 이를 적용하지 않습니다. 앱이 이를 적용해야 합니다.

참고 항목