向PostgreSQL SERIAL列插入默认值：Scala/Java 实现指南

本文将介绍如何使用 Scala/Java 向 PostgreSQL 数据库中 SERIAL 类型的列插入默认值。不同于 MySQL 允许向自增列插入 NULL 值，PostgreSQL 需要使用 DEFAULT 关键字。本文将介绍如何通过 PreparedStatement 实现这一目标，并解决常见的插入错误，提供可行的代码示例，帮助开发者避免常见陷阱，确保数据插入的正确性。

在 PostgreSQL 中，SERIAL 类型实际上是一个语法糖，它会自动创建一个序列 (sequence) 并将该列设置为该序列的默认值。当你想要插入一行数据，并且希望 SERIAL 列自动生成一个值时，你需要显式地告诉 PostgreSQL 使用默认值。

使用 DEFAULT VALUES 插入

最直接的方法是使用 INSERT INTO table_name DEFAULT VALUES 语句。这种方法适用于当你只想插入一行完全由默认值组成的数据时。例如，对于以下表结构：

CREATE TABLE serial_table (
    id SERIAL NOT NULL PRIMARY KEY,
    name VARCHAR(255)
);

你可以使用以下 SQL 语句插入一行 id 使用默认值，name 也使用默认值（如果定义了的话，否则为 NULL）的数据：

INSERT INTO serial_table DEFAULT VALUES;

使用 PreparedStatement 插入

如果你需要使用 PreparedStatement 来插入数据，并且希望 SERIAL 列使用默认值，则不能直接使用 st.setNull(1, java.sql.Types.NULL) 或 st.setObject(1, "DEFAULT")。这是因为 PreparedStatement 主要用于处理已知数据类型的值，而 DEFAULT 并不是一个标准的数据类型。

正确的做法是在 SQL 语句中显式地省略 SERIAL 列，或者使用 DEFAULT 关键字。

方法一：省略 SERIAL 列

如果你的表结构允许，并且你只想插入 SERIAL 列的默认值和其他列的值，那么你可以省略 SERIAL 列。例如：

import java.sql.PreparedStatement
import java.sql.Connection

def insertWithPreparedStatement(conn: Connection, name: String): Unit = {
  val sql = "INSERT INTO serial_table (name) VALUES (?)"
  val st: PreparedStatement = conn.prepareStatement(sql)
  st.setString(1, name)
  st.executeUpdate()
  st.close()
}

在这个例子中，id 列（SERIAL 类型）被省略了，PostgreSQL 会自动使用序列的下一个值。

方法二：使用 DEFAULT 关键字

如果你的表结构要求你必须指定所有列，或者你想更明确地表达你的意图，你可以使用 DEFAULT 关键字。

import java.sql.PreparedStatement
import java.sql.Connection

def insertWithDefault(conn: Connection, name: String): Unit = {
  val sql = "INSERT INTO serial_table (id, name) VALUES (DEFAULT, ?)"
  val st: PreparedStatement = conn.prepareStatement(sql)
  st.setString(1, name)
  st.executeUpdate()
  st.close()
}

在这个例子中，id 列被显式地设置为 DEFAULT，PostgreSQL 会自动使用序列的下一个值。 注意，这里setString(1, name)的索引是1，因为DEFAULT已经占据了第一个位置。

注意事项

• 确保你的表结构允许省略 SERIAL 列，或者显式地使用 DEFAULT 关键字。
• 不要尝试使用 st.setNull() 或 st.setObject() 来设置 SERIAL 列的值为 DEFAULT，这通常会导致错误。
• 如果你的表结构不允许省略 SERIAL 列，并且你没有显式地使用 DEFAULT 关键字，那么你将会收到语法错误。

总结

向 PostgreSQL SERIAL 列插入默认值，需要理解 PostgreSQL 的行为方式。 避免直接设置 NULL 或尝试将 "DEFAULT" 作为字符串插入。 使用 INSERT INTO table_name DEFAULT VALUES、省略 SERIAL 列或显式使用 DEFAULT 关键字是在 Scala/Java 中实现此目的的正确方法。根据你的具体需求和表结构选择最合适的方法，可以有效地避免常见的插入错误。