在 PostgreSQL 里，其实 99% 场景你写的是 函数（FUNCTION）；

真正的 存储过程（PROCEDURE） 是 11 版才引入，语法几乎一样，只是调用方式不同。

下面把“函数”和“过程”都给你一次讲透，并附完整可直接 `psql -f` 运行的脚本。

---

一、先分清：FUNCTION vs PROCEDURE

特性    FUNCTION    PROCEDURE    
最早版本    一直就有    ≥ 11    
能否回传结果集    ✅ `RETURNS TABLE / SETOF`    ❌（只能 OUT 参数）    
调用方式    `SELECT func(args);`    `CALL proc(args);`    
能否无返回值    ❌ 必须有 `RETURNS`    ✅ 可以啥都不返回    
事务控制    由外层决定    内部可 `COMMIT/ROLLBACK`    

结论：  
- 只要你想“查”数据 → 写 FUNCTION；  
- 只要你想“干”事且内部自己提交 → 写 PROCEDURE。

---

二、FUNCTION 模板（最常用）

```sql
-- 返回单行
CREATE OR REPLACE FUNCTION get_user_name(uid bigint)
RETURNS text
LANGUAGE plpgsql
AS $$
DECLARE
    v_name text;
BEGIN
    SELECT name INTO v_name
      FROM users
     WHERE id = uid;
    RETURN v_name;      -- 找不到会返回 NULL
END;
$$;

-- 返回结果集
CREATE OR REPLACE FUNCTION list_users(min_age int)
RETURNS TABLE(id bigint, name text, age int)
LANGUAGE plpgsql
AS $$
BEGIN
    RETURN QUERY
    SELECT u.id, u.name, u.age
      FROM users u
     WHERE u.age >= min_age
     ORDER BY u.age;
END;
$$;

-- 测试
SELECT get_user_name(1);
SELECT * FROM list_users(18);
```

---

三、PROCEDURE 模板（≥ pg11）

```sql
-- 内部自己提交，外部自动回滚不了
CREATE OR REPLACE PROCEDURE transfer_money(
    from_id bigint,
    to_id   bigint,
    amount  numeric
)
LANGUAGE plpgsql
AS $$
BEGIN
    -- 扣钱
    UPDATE accounts SET balance = balance - amount WHERE id = from_id;
    -- 加钱
    UPDATE accounts SET balance = balance + amount WHERE id = to_id;
    -- 记日志
    INSERT INTO log(from_acc, to_acc, amt, ts)
    VALUES (from_id, to_id, amount, now());
    -- 手动提交（函数里不允许）
    COMMIT;
END;
$$;

-- 调用
CALL transfer_money(3, 5, 100.00);
```

---

四、参数 5 种写法速查
1. `IN`   默认，只进不出  
2. `OUT`  只出不进  
3. `INOUT` 能进能出  
4. `VARIADIC` 可变长参数  
5. 缺省值 `age int DEFAULT 18`

示例（INOUT）：

```sql
CREATE OR REPLACE FUNCTION swap(INOUT a int, INOUT b int)
LANGUAGE plpgsql AS $$
DECLARE tmp int;
BEGIN
    tmp := a;  a := b;  b := tmp;
END;
$$;

-- 调用
SELECT swap(3,7);   -- 返回 7,3
```

---

五、异常处理模板

```sql
CREATE OR REPLACE FUNCTION safe_divide(a numeric, b numeric)
RETURNS numeric
LANGUAGE plpgsql
AS $$
BEGIN
    RETURN a / b;
EXCEPTION
    WHEN division_by_zero THEN
        RAISE NOTICE '除零，返回 NULL';
        RETURN NULL;
    WHEN OTHERS THEN
        RAISE WARNING '未知错误: %', SQLERRM;
        RETURN NULL;
END;
$$;
```

---

六、快速验证脚本
把下面内容存成 `proc.sql`，然后

`psql -U postgres -d yourdb -f proc.sql` 即可一键验证。

```sql
-- 建测试表
DROP TABLE IF EXISTS users;
CREATE TABLE users(
    id   bigserial PRIMARY KEY,
    name text NOT NULL,
    age  int CHECK (age>0)
);

-- 灌点数据
INSERT INTO users(name,age) VALUES
('Alice',19),('Bob',25),('Carol',30);

-- 函数：返回结果集
CREATE OR REPLACE FUNCTION list_users(min_age int)
RETURNS TABLE(id bigint, name text, age int)
LANGUAGE plpgsql AS $$
BEGIN
    RETURN QUERY SELECT u.id, u.name, u.age FROM users u WHERE u.age >= min_age;
END;
$$;

-- 过程：无结果，内部可 COMMIT
CREATE OR REPLACE PROCEDURE add_user(p_name text, p_age int)
LANGUAGE plpgsql AS $$
BEGIN
    INSERT INTO users(name,age) VALUES (p_name, p_age);
    COMMIT;
END;
$$;

-- 测试
SELECT * FROM list_users(20);   -- 函数
CALL add_user('David', 40);     -- 过程
SELECT * FROM list_users(20);
```

---

七、小结口诀
- 要查询 → `FUNCTION` + `RETURNS`/`TABLE`  
- 要干活 → `PROCEDURE` + `CALL`（≥11）  
- 想回传单个值 → `OUT` 参数  
- 想回传结果集 → `RETURN QUERY`