타입

MySQL 타입

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

CREATE TABLE some_types (
  some_tiny_int TINYINT,                           -- Byte로 반환됨
  some_small_int SMALLINT,                         -- Short로 반환됨
  some_integer INTEGER,                            -- Int로 반환됨
  some_int INT,                                    -- Int로 반환됨
  some_big_int BIGINT,                             -- Long으로 반환됨
  some_decimal DECIMAL(6,5),                       -- Int로 반환됨
  some_dec DEC(6,5),                               -- Int로 반환됨
  some_numeric NUMERIC(6,5),                       -- Int로 반환됨
  some_float FLOAT(6),                             -- Double로 반환됨
  some_real REAL,                                  -- Double로 반환됨
  some_double DOUBLE,                              -- Double로 반환됨
  some_double_precision DOUBLE PRECISION,          -- Double로 반환됨
  some_boolean BOOLEAN,                            -- Boolean으로 반환됨
  some_date DATE,                                  -- String으로 반환됨
  some_time TIME,                                  -- String으로 반환됨
  some_timestamp2 TIMESTAMP(6),                    -- String으로 반환됨
  some_char CHAR,                                  -- String으로 반환됨
  some_character CHARACTER(6),                     -- String으로 반환됨
  some_char_varying CHAR VARYING(6),               -- String으로 반환됨
  some_longvarchar LONGVARCHAR,                    -- String으로 반환됨
  some_character_varying CHARACTER VARYING(6),     -- String으로 반환됨
  some_varchar VARCHAR(16),                        -- String으로 반환됨
  some_clo CHARACTER LARGE OBJECT(16),             -- String으로 반환됨
  some_clob clob(16 M CHARACTERS),                 -- String으로 반환됨
  some_binary BINARY,                              -- ByteArray로 반환됨
  some_binary2 BINARY(6),                          -- ByteArray로 반환됨
  some_longvarbinary LONGVARBINARY,                -- ByteArray로 반환됨
  some_longvarbinary2 LONGVARBINARY(6),            -- ByteArray로 반환됨
  some_binary_varying BINARY VARYING(6),           -- ByteArray로 반환됨
  some_varbinary VARBINARY(8),                     -- ByteArray로 반환됨
  some_uuid UUID,                                  -- ByteArray로 반환됨
  some_blob BLOB,                                  -- ByteArray로 반환됨
  some_blo BINARY LARGE OBJECT(6),                 -- ByteArray로 반환됨
  some_bit BIT,                                    -- ByteArray로 반환됨
  some_bit2 BIT(6),                                -- ByteArray로 반환됨
  some_bit_varying BIT VARYING(6),                 -- ByteArray로 반환됨
  some_interval INTERVAL YEAR TO MONTH,            -- ByteArray로 반환됨
  some_interval2 INTERVAL YEAR(3),                 -- ByteArray로 반환됨
  some_interval3 INTERVAL DAY(4) TO HOUR,          -- ByteArray로 반환됨
  some_interval4 INTERVAL MINUTE(4) TO SECOND(6),  -- ByteArray로 반환됨
  some_interval5 INTERVAL SECOND(4,6)              -- 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
  )
)

Enums

편의를 위해 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()
  )
)

값 타입(Value types)

SQLDelight는 요청 시 기본 데이터베이스 타입을 래핑하는 컬럼용 값 타입(value type)을 생성할 수 있습니다:

CREATE TABLE hockeyPlayer (
  id INT AS VALUE
);

## 낙관적 잠금 (Optimistic Locking)

컬럼을 `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;

마이그레이션에서의 커스텀 타입 (Custom Types in Migrations)

마이그레이션이 스키마의 소스(source of truth)인 경우, 테이블을 변경(alter)할 때 노출될 Kotlin 타입을 지정할 수도 있습니다:

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

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