타입

PostgreSQL 타입

SQLDelight 컬럼 정의는 일반적인 PostgreSQL 컬럼 정의와 동일하지만, 생성된 인터페이스에서 컬럼의 Kotlin 타입을 지정하는 추가 컬럼 제약 조건을 지원합니다.

CREATE TABLE some_types (
  some_smallint SMALLINT,               -- Retrieved as Short
  some_int2 INT2,                       -- Retrieved as Short
  some_integer INTEGER,                 -- Retrieved as Int
  some_int INT,                         -- Retrieved as Int
  some_int4 INT4,                       -- Retrieved as Int
  some_bigint BIGINT,                   -- Retrieved as Long
  some_int8 INT8,                       -- Retrieved as Long
  some_numeric NUMERIC,                 -- Retrieved as BigDecimal
  some_decimal DECIMAL,                 -- Retrieved as Double
  some_real REAL,                       -- Retrieved as Double
  some_float4 FLOAT4,                   -- Retrieved as Double
  some_double_prec DOUBLE PRECISION,    -- Retrieved as Double
  some_float8 FLOAT8,                   -- Retrieved as Double
  some_smallserial SMALLSERIAL,         -- Retrieved as Short
  some_serial2 SERIAL2,                 -- Retrieved as Short
  some_serial SERIAL,                   -- Retrieved as Int
  some_serial4 SERIAL4,                 -- Retrieved as Int
  some_bigserial BIGSERIAL,             -- Retrieved as Long
  some_serial8 SERIAL8,                 -- Retrieved as Long
  some_character CHARACTER,             -- Retrieved as String
  some_char CHAR,                       -- Retrieved as String
  some_char_var CHARACTER VARYING(16),  -- Retrieved as String
  some_varchar VARCHAR(16),             -- Retrieved as String
  some_text TEXT,                       -- Retrieved as String
  some_date DATE,                       -- Retrieved as LocalDate
  some_time TIME,                       -- Retrieved as LocalTime
  some_timestamp TIMESTAMP,             -- Retrieved as LocalDateTime
  some_timestamp TIMESTAMPTZ,           -- Retrieved as OffsetDateTime
  some_json JSON,                       -- Retrieved as String
  some_jsonb JSONB,                     -- Retrieved as String
  some_interval INTERVAL,               -- Retrieved as String
  some_uuid UUID                        -- Retrieved as UUID
  some_bool BOOL,                       -- Retrieved as Boolean
  some_boolean BOOLEAN,                 -- Retrieved as Boolean
  some_bytea BYTEA                      -- Retrieved as ByteArray
);

커스텀 컬럼 타입

컬럼을 커스텀 타입으로 조회하고 싶다면 Kotlin 타입을 지정할 수 있습니다.

import kotlin.String;
import kotlin.collections.List;

CREATE TABLE hockeyPlayer (
  cup_wins TEXT AS List<String> NOT NULL
);

하지만, Database를 생성하려면 데이터베이스 타입과 커스텀 타입 간에 매핑하는 방법을 아는 ColumnAdapter를 제공해야 합니다.

val listOfStringsAdapter = object : ColumnAdapter<List<String>, String> {
  override fun decode(databaseValue: String) =
    if (databaseValue.isEmpty()) {
      listOf()
    } else {
      databaseValue.split(",")
    }
  override fun encode(value: List<String>) = value.joinToString(separator = ",")
}

val queryWrapper: Database = Database(
  driver = driver,
  hockeyPlayerAdapter = hockeyPlayer.Adapter(
    cup_winsAdapter = listOfStringsAdapter
  )
)

Enum

편의를 위해 SQLDelight 런타임은 enum을 String 데이터로 저장하기 위한 ColumnAdapter를 포함합니다.

import com.example.hockey.HockeyPlayer;

CREATE TABLE hockeyPlayer (
  position TEXT AS HockeyPlayer.Position
)

val queryWrapper: Database = Database(
  driver = driver,
  hockeyPlayerAdapter = HockeyPlayer.Adapter(
    positionAdapter = EnumColumnAdapter()
  )
)

값 타입

SQLDelight는 요청 시 기본 데이터베이스 타입을 래핑하는 컬럼에 대한 값 타입을 생성할 수 있습니다.

CREATE TABLE hockeyPlayer (
  id INT AS VALUE
);

## 낙관적 잠금

열을 `LOCK`로 지정하면 해당 열에 대한 값 유형이 생성되며, `UPDATE` 문이 업데이트를 수행하기 위해 해당 잠금을 올바르게 사용해야 합니다.

```sql
CREATE TABLE hockeyPlayer(
  id INT AS VALUE,
  version_number INT AS LOCK,
  name VARCHAR(8)
);

-- 이것은 실패합니다 (그리고 IDE 플러그인은 아래와 같이 다시 작성하도록 제안할 것입니다)
updateName:
UPDATE hockeyPlayer
SET name = ?;

-- 이것은 컴파일을 통과합니다
updateNamePassing:
UPDATE hockeyPlayer
SET name = ?
    version_number = :version_number + 1
WHERE version_number = :version_number;

마이그레이션의 커스텀 타입

마이그레이션이 스키마의 신뢰할 수 있는 소스인 경우, 테이블을 변경할 때 노출되는 Kotlin 타입을 지정할 수도 있습니다:

import kotlin.String;
import kotlin.collection.List;

ALTER TABLE my_table
  ADD COLUMN new_column VARCHAR(8) AS List<String>;