pgAdmin4

适用范围

• 支持PolarDB PostgreSQL版（兼容Oracle） 2.0版本。

• 已经在PolarDB集群创建账号，创建账号请参见创建数据库账号。

• 已经将需要访问PolarDB集群的主机IP地址添加到白名单，如何添加白名单请参见设置集群白名单。

• PolarDB PostgreSQL版（兼容Oracle）2.0.14.22.0（不包含）之前版本PL/SQL断点显示行数比实际断点位置少一行。

  例如，断点在存储过程的第10行，但是显示行数会显示为第9行。

下载链接

• Windows版本：

  pgadmin4-polardb-x64.zip（pgAdmin入口在runtime文件夹中）

• Mac版本：

  • Apple Silicon版本：

    pgadmin4-polardb-arm64.dmg（MD5：e195cf7eb03da5e0bf0814ccf7f4e13b）

  • Intel版本：

    pgadmin4-polardb-x86_64.dmg（MD5：e730dce5e1b2648bc248a73dbaf2571b）

使用方式

1. 添加PolarDB集群服务器：

   1. 在左侧对象浏览器中右键单击Servers节点，选择注册 > 服务器...。

   2. 在注册 - 服务器对话框中，切换到General标签页，在名称字段中填写服务器名称（必填项，可根据实际情况自行设置）。

   3. 在注册 - 服务器对话框中，切换到连接标签页中，依次填写：

      选项	说明
      主机名称/地址	PolarDB PostgreSQL版（兼容Oracle）集群连接地址
      端口	1521
      维护数据库	您的数据库名称
      用户名	您的数据库账号名称
      密码	您的数据库账号密码

2. 通过pgAdmin4执行数据库命令：

   1. 单击工具栏中的新建连接按钮，连接到您的数据库。

   2. 在查询编辑器中输入以下命令，并单击上方的执行按钮。

      -- 1. 创建包声明 (Package Specification)
      CREATE OR REPLACE PACKAGE testpkg IS
          PROCEDURE print_a();
          PROCEDURE sign_a(val INT);
      END;
      
      -- 2. 创建包体 (Package Body)
      CREATE OR REPLACE PACKAGE BODY testpkg IS
          a INT := 100;
          
          PROCEDURE print_a() IS
          BEGIN
              RAISE NOTICE 'a is: %', a;
          END;
      
          PROCEDURE sign_a(val INT) IS
          BEGIN
              a := val;
          END;
      END;
      
      -- 3. 调用测试
      CALL testpkg.sign_a(100);
      CALL testpkg.print_a();
      

   3. 查看底部消息面板是否有显示CREATE PACKAGE BODY。

3. PL/SQL存储过程调试：PolarDB PostgreSQL版（兼容Oracle）数据库支持调试PL/SQL存储过程、函数和包，其中包（Package）也会显示在左侧导航栏的架构中，下滑您可看到刚创建的testpkg包。

   • 直接调试：对于PL/SQL的存储过程、函数和包，您可在左侧导航栏的架构中进行调试。找到您刚创建的testpkg包，鼠标右侧单击存储过程，再单击正在调试 > 调试，即可开始调试。

     说明

     • 对于包含OUT参数存储过程请使用间接调试方式。

     • 调试过程中，您可以直接在代码左侧添加或删除断点，参数与包变量则会显示在底部的本地变量中。

     • 添加或删除断点仅允许在调试过程中操作。

   • 间接调试：

     1. 您可在左侧导航栏的架构中进行调试。找到您刚创建的testpkg包，鼠标右侧单击存储过程，再单击正在调试 > 设置断点，此时当前会话（会话A）等待其他会话调用该函数。

     2. 单击查询工具按钮新建一个连接（会话B），在查询编辑器中执行 CALL testpkg.print_a();，以从另一个会话调用该函数并触发断点。

     3. 返回会话A，当其他会话（例如，会话B）调用该函数后，调试器捕获调用并在代码区域显示存储过程的代码内容。底部的本地变量面板中可查看当前变量信息（如变量 a 类型为 integer，值为 100）。此时可进行添加断点等调试操作。

版本更新日志

专家面对面

关于pgAdmin4，如果您在使用过程中有任何问题，请进钉钉群咨询。钉钉群号：103850000848。