使用 Visual Studio Code 在远程计算机上调试 PostgreSQL

1. 概述

PostgreSQL 是一个功能强大的开源关系数据库管理系统，适用于各种应用程序。在开发过程中，调试 PostgreSQL 对于识别和解决问题至关重要。在本博客中，我们将手把手教你使用客户端计算机上的 Visual Studio Code (VSCode) 和 Linux 计算机上运行的 PostgreSQL 设置远程 PostgreSQL 开发调试环境。

2. Linux 上的设置

参考此处提供的文档在物理机或虚拟机上安装 Ubuntu 22.04。并创建一个用户，例如"ubuntu"。
在 Ubuntu 机器上生成 SSH 密钥对，以允许远程调试，这样就无需重复输入用户名和密码：

shell 复制代码

$ sudo apt update && sudo apt install ssh -y
$ ssh-keygen -t ed25519
$ cat /home/ubuntu/.ssh/ed25519.pub >> /home/ubuntu/.ssh/authorized_keys

将私钥复制到您的 Windows 客户端计算机（例如，c:\Users\user1.ssh\id_ed25519）。注意：为了更好的安全实践，您应该在客户端机器上生成 ssh 密钥对，并将公钥信息添加到服务器的authorized_keys中，并将私钥保密为只有您自己知道的秘密。
在 Ubuntu 上安装 PostgreSQL 构建依赖项：

shell 复制代码

$ sudo apt-get install -y build-essential git gdb lcov bison flex \
          libkrb5-dev libssl-dev libldap-dev libpam0g-dev python3-dev \
          tcl-dev libperl-dev gettext libxml2-dev libxslt1-dev \
          libreadline-dev libedit-dev uuid-dev libossp-uuid-dev \
          libipc-run-perl perl libtest-simple-perl

克隆 PostgreSQL，编译它，然后启动 PostgreSQL 服务器：

shell 复制代码

$ git clone https://github.com/postgres/postgres.git
$ cd postgres && git checkout REL_15_3 -b pg153 
$ ./configure  --prefix=/home/ubuntu/mypg --enable-tap-tests --enable-debug CFLAGS="-g3 -O0"
$ make --j
$ make install

$ export PGDATA=/home/ubuntu/mydb
$ export PATH=/home/ubuntu/mypg/pgapp/bin:$PATH
$ export LD_LIBRARY_PATH=/home/ubuntu/mypg/pgapp/lib
$ initdb -D $PGDATA
$ pg_ctl -D $PGDATA -l logfile start
$ psql -d postgres

3. 设置 Visual Studio Code

安装 Visual Studio Code 并安装"Remote -- SSH"和"C/C++"调试扩展。
通过输入 remote-ssh 安装"Remote -- SSH"扩展，如下图所示。

安装如下图所示的 c/c++ debugging 扩展，并选择 Microsoft 发布的扩展。

安装完remote-ssh和c/c++调试扩展后，你应该在左下角看到一个小图标，如下图蓝色高亮所示，

单击远程 ssh 连接图标并设置远程连接配置。

选择 Connect to Host ... 然后输入 ssh ubuntu@ubuntu-ip-addr ，如果 VS Code 要求本地 ssh 配置，则使用位于 c:\Users\user1.ssh\config 的配置并输入以下信息：

Host ubuntu-ip-addr
HostName ubuntu-ip-addr
IdentityFile c:\Users\user1.ssh\id_ed25519
IdentiftiesOnly Yes

如果remote-ssh已经正确设置，那么VSCode应该弹出一个新的IDE窗口，然后使用这个新的IDE窗口从远程Ubuntu服务器打开源代码。
使用以下配置在 .vscode 下创建 launch.json 文件以附加 PostgreSQL 后端：

{
"version": "0.2.0",
"configurations": [
{
"name": "(gdb) Attach",
"type": "cppdbg",
"request": "attach",
"program": "/home/ubuntu/mypg/bin/postgres",
"MIMode": "gdb",
"setupCommands": [
{
"description": "Enable pretty-printing for gdb",
"text": "-enable-pretty-printing",
"ignoreFailures": true
},
{
"description": "Set Disassembly Flavor to Intel",
"text": "-gdb-set disassembly-flavor intel",
"ignoreFailures": true
}
]
}
]
}

确保更改 /home/ubuntu/mypg/bin/postgres 以指向 Ubuntu 服务器上的 PostgreSQL 安装路径。

通过单击 View -> Run 来测试远程 PostgreSQL 调试，然后选择"gdb) Attach"并附加到 PostgreSQL 后端进程。

单击运行图标开始调试

选择要附加的正确 postgres 后端以进行调试

4. Summary 4. 总结

在这篇博文中，我们演示了如何使用客户端计算机上的 Visual Studio Code 和 Linux 计算机上运行的 PostgreSQL 设置远程 PostgreSQL 开发调试环境。通过此设置，开发人员可以有效地调试 PostgreSQL 并识别和解决开发过程中的问题。调试愉快！

原文地址 Debugging PostgreSQL on a remote machine with Visual Studio Code: A Step-by-Step Guide - Highgo Software Inc.

更多阅读：

如何调试分析PostgreSQL代码？