类型

PostgreSQL 类型

SQLDelight 列定义与常规 PostgreSQL 列定义相同，但支持额外列约束，用于在生成的接口中指定该列的 Kotlin 类型。

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

枚举

为了方便起见，SQLDelight 运行时包含了一个 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>;