POSTGRESQL——存储过程调试

在 PostgreSQL 中调试存储过程（通常指的是 PL/pgSQL 或其他过程语言编写的函数），如果不能或不想使用专门的 debug 模式或插件，可以通过以下几种方法进行辅助调试：

1. 使用 RAISE 语句输出调试信息

场景与示例：
在存储过程中插入 RAISE 语句来输出中间变量的值或流程控制信息。

CREATE OR REPLACE FUNCTION my_function(arg1 int)
RETURNS integer AS $$
DECLARE
    local_var int;
BEGIN
    -- 调试代码段
    local_var := arg1 * 2;
    RAISE NOTICE '局部变量 local_var 的值为: %', local_var;

    -- 更多处理逻辑...
    
    RETURN local_var;
END;
$$ LANGUAGE plpgsql;

通过设置 client_min_messages 参数，可以确保这些消息被传递给客户端。例如，在会话中执行：

SET client_min_messages = notice;

2. 日志记录

场景与示例：
调整 log_min_messages 配置参数，将调试信息写入服务器日志。

-- 在postgresql.conf中设置全局
log_min_messages = debug5

-- 或者在会话中临时设置
SET log_min_messages TO debug5;

-- 在函数中使用不同级别的 RAISE
RAISE LOG '这是日志信息';
RAISE DEBUG '这是调试信息';

3. 使用条件断点模拟

场景与示例：
由于没有真正的断点机制，可以通过添加临时逻辑判断来进行模拟断点。

CREATE OR REPLACE FUNCTION my_function(arg1 int)
RETURNS integer AS $$
DECLARE
    breakpoint boolean := false;
    local_var int;
BEGIN
    IF breakpoint THEN
        -- 当需要“断点”时，修改这里的布尔变量
        RAISE NOTICE '到达模拟断点位置';
        -- 可以在这里检查变量状态
    END IF;

    local_var := arg1 * 2;

    -- 如果需要进一步调试，可以继续添加类似检查点
    -- ...

    RETURN local_var;
END;
$$ LANGUAGE plpgsql;

4. 输出查询计划

场景与示例：
对于涉及复杂查询的情况，可以利用 EXPLAIN 或 EXPLAIN ANALYZE 来查看函数内部查询的执行计划。

-- 在函数外部分析其内部查询
EXPLAIN (ANALYZE, BUFFERS) SELECT * FROM my_function(10);

5. 插件辅助

尽管您提到不能使用 debug 模式，但如果是早期的文章所指的不便之处，现在可能已经有更成熟的插件可用，如 pldebugger 插件可以帮助调试 PL/pgSQL 函数。若条件允许，可尝试安装并使用这类插件：

• 安装 pldebugger 插件后，根据插件文档的指示，在 pgAdmin 或其他客户端工具中开启函数的调试模式，可以实现更接近传统调试器的功能，如单步执行、查看变量值等。
  当然，调试过程中除了输出调试信息，还需要关注可能出现的异常情况。在 PostgreSQL 存储过程中，可以通过 RAISE EXCEPTION 语句来捕获和抛出自定义错误，并打印异常信息。

6. 使用 RAISE EXCEPTION 抛出和打印异常信息

场景与示例：

CREATE OR REPLACE FUNCTION my_function(arg1 int)
RETURNS integer AS $$
DECLARE
    local_var int;
BEGIN
    IF arg1 <= 0 THEN
        -- 打印自定义错误信息并抛出异常
        RAISE EXCEPTION '输入参数 arg1 必须大于零' 
                      USING ERRCODE = 'check_violation'; 
    END IF;

    local_var := arg1 * 2;

    RETURN local_var;
EXCEPTION
    WHEN check_violation THEN
        -- 当捕获到指定异常时，可以在此处输出额外的调试信息
        RAISE NOTICE '在函数 my_function 中捕获到违反检查条件的异常: %', SQLERRM;
        -- 重新抛出异常以便上层调用者处理
        RAISE;
END;
$$ LANGUAGE plpgsql;

在这个例子中，当 arg1 小于等于0时，函数会抛出一个异常，并附带一条自定义错误信息。在 EXCEPTION 块中，我们捕获了这个异常，输出了详细的错误信息，并选择重新抛出异常让上层调用者能够感知和处理此错误。

7. 使用 GET STACKED DIAGNOSTICS 获取异常详细信息

还可以通过 GET STACKED DIAGNOSTICS 获取异常发生时的更多诊断信息，包括SQLSTATE、SQLERRM、行列号等。

CREATE OR REPLACE FUNCTION my_function(...)
...
BEGIN
...
EXCEPTION
    WHEN OTHERS THEN
        GET STACKED DIAGNOSTICS diag_message = MESSAGE_TEXT,
                                diag_context = PG_EXCEPTION_CONTEXT,
                                diag_sqlstate = RETURNED_SQLSTATE;
        RAISE NOTICE E'异常详情：\n% \n上下文：\n% \nSQLSTATE: %', 
                    diag_message, diag_context, diag_sqlstate;
        -- 根据需求选择是否重新抛出异常
END;
$$ LANGUAGE plpgsql;

这样，当出现任何未预期的异常时，你可以获取到丰富的堆栈信息，帮助定位问题所在。

注意：

• 对于较新的 PostgreSQL 版本，请务必查阅最新的官方文档和相关插件的最新状态及使用说明。
• 若系统安全策略不允许启用特定插件或者改变服务器配置，上述基于 RAISE 和日志的方法将是首选。