在PostgreSQL中，如果你希望在执行
INSERT操作后立即获取所有新插入的数据，最直接且推荐的方法是使用
RETURNING *子句。这个特性非常强大，它能让你省去一次额外的
SELECT查询，从而提高效率并简化应用逻辑。
解决方案
要实现PostgreSQL插入时返回所有数据，你只需要在
INSERT语句的末尾加上
RETURNING *。这会指示数据库在成功插入数据后，将新插入行的所有列的值作为结果集返回。
举个例子，假设你有一个名为
users的表，包含
id(序列生成),
name,
CREATE TABLE users (
id SERIAL PRIMARY KEY,
name VARCHAR(100) NOT NULL,
email VARCHAR(100) UNIQUE NOT NULL,
created_at TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP
);当你插入一条新用户记录时，如果想立即获取包括自动生成的
id和
created_at在内的所有信息，可以这样写：
INSERT INTO users (name, email)
VALUES ('张三', 'zhangsan@example.com')
RETURNING *;执行这条语句后，PostgreSQL会返回一个结果集，其中包含
id,
name,
created_at这四个字段，对应着你刚刚插入的那条记录。这对于需要立即使用新生成的主键或者其他默认值填充的字段的应用场景来说，简直是福音。
PostgreSQL中RETURNING
子句的工作原理是什么？
说实话，
RETURNING子句是PostgreSQL在DML（数据操作语言）方面一个相当人性化的设计。它的核心思想是：既然你已经告诉数据库要执行一个操作（比如插入、更新或删除），那么为什么不直接把这个操作影响到的数据也一并告诉你呢？省得我再跑一趟去问。
具体来说，当你在
INSERT、
UPDATE或
DELETE语句后面加上
RETURNING子句时，数据库会在执行完主操作（比如数据插入）之后，立即捕获受影响的行数据。这个捕获过程是在同一个事务上下文中完成的，这意味着你拿到的数据是最新且最准确的，不会有其他并发操作带来的数据不一致问题。
你可以返回任何列，甚至是基于这些列的表达式。例如，如果你想返回
id和
name，以及一个表示用户年龄的计算字段（假设
users表有个
birth_date字段），你可以写成
RETURNING id, name, EXTRACT(YEAR FROM AGE(birth_date)) AS age。这种灵活性让它不仅仅是简单地返回原始数据，还能进行一些即时的数据转换或计算。它避免了客户端应用需要先插入，再根据某些条件（比如刚刚插入的
name和
RETURNING简直是必不可少。
如何精确控制PostgreSQL插入操作返回的特定列？
很多时候，我们插入数据后可能并不需要返回所有列。比如，我们可能只关心新生成的主键
id，或者某个特定的状态字段。这时候，
RETURNING *就显得有些“大方”了，它会返回所有列，这可能增加了网络传输的负担，也让应用程序处理结果时多了一些不必要的字段。
要精确控制返回的列，你只需要在
RETURNING关键字后面列出你想要获取的列名，用逗号分隔开即可。
还是用
users表做例子： 如果我只关心新插入用户的
id和
INSERT INTO users (name, email)
VALUES ('李四', 'lisi@example.com')
RETURNING id, email;这样，PostgreSQL就只会返回
id和
RETURNING子句的强大和实用性。它不仅仅是“返回数据”，更是“按需返回数据”。
在应用程序中如何有效地利用PostgreSQL的RETURNING
子句？
在应用程序中利用
RETURNING子句，是提升开发效率和数据一致性的关键一环。大多数现代的数据库驱动和ORM（对象关系映射）框架都对
RETURNING有很好的支持，或者至少提供了访问其结果集的方法。
以Python的
psycopg2库为例，当你执行一个
INSERT ... RETURNING语句时，
cursor.execute()方法并不会直接返回结果，你需要通过
cursor.fetchone()或
cursor.fetchall()来获取返回的数据。
import psycopg2
conn = psycopg2.connect("dbname=your_db user=your_user password=your_password")
cur = conn.cursor()
try:
user_name = '王五'
user_email = 'wangwu@example.com'
cur.execute(
"INSERT INTO users (name, email) VALUES (%s, %s) RETURNING id, name, created_at;",
(user_name, user_email)
)
# 获取返回的第一行数据
new_user_data = cur.fetchone()
if new_user_data:
print(f"新用户ID: {new_user_data[0]}, 姓名: {new_user_data[1]}, 创建时间: {new_user_data[2]}")
# 或者通过列名访问（如果使用DictCursor）
# print(f"新用户ID: {new_user_data['id']}, 姓名: {new_user_data['name']}, 创建时间: {new_user_data['created_at']}")
else:
print("插入失败或未返回数据。")
conn.commit()
except Exception as e:
conn.rollback()
print(f"发生错误: {e}")
finally:
cur.close()
conn.close()可以看到，通过
fetchone()我们直接拿到了新插入的数据，省去了再执行一次
SELECT的麻烦。这不仅减少了数据库的往返次数（round trips），降低了网络延迟，还确保了你获取的数据就是刚刚插入的那个精确状态，避免了并发场景下可能出现的竞态条件。对于需要立即使用新生成的主键来关联其他数据表（比如插入用户后，立即插入该用户的订单信息）的场景，这种方式简直是天作之合。它让你的应用程序逻辑更紧凑，也更健壮。
