pg-safeupdate 的安装和配置教程

2025-05-21 23:03:47作者：齐冠琰

1. 项目基础介绍及主要编程语言

pg-safeupdate 是一个为 PostgreSQL 数据库设计的简单扩展，其主要功能是确保在执行 UPDATE 和 DELETE 操作时必须有 WHERE 子句指定条件。这样可以避免意外地删除或更新所有数据，提高数据安全性。该项目的开发主要是为了与 PostgREST 这种无权限限制的 REST API 一起使用，以避免数据被无意中破坏。项目主要使用 C 语言开发，同时也包含了一些 Ruby 代码用于测试。

2. 项目使用的关键技术和框架

PostgreSQL：一个功能强大的开源对象关系型数据库系统。
C 语言：用于编写 PostgreSQL 扩展的主要语言。
Ruby：用于编写测试脚本的语言。

3. 项目安装和配置的准备工作及详细安装步骤

准备工作

在开始安装 pg-safeupdate 前，您需要确保系统中已经安装了以下软件：

PostgreSQL：数据库系统，pg-safeupdate 将作为其扩展运行。
GCC：C 编译器，用于编译 C 语言代码。
make：一个构建系统，用于自动化编译过程。

安装步骤

以下步骤将引导您完成 pg-safeupdate 的安装：

克隆项目

首先，您需要从 GitHub 上克隆 pg-safeupdate 项目。打开终端或命令提示符，执行以下命令：
```
git clone https://github.com/eradman/pg-safeupdate.git
```
这将在当前目录中创建一个名为 pg-safeupdate 的新文件夹，其中包含项目文件。
编译扩展

进入项目文件夹，使用 make 命令编译扩展：
```
cd pg-safeupdate
make
```
如果编译成功，您将在当前目录中看到一个名为 safeupdate.so 的共享对象文件。
安装扩展

要安装扩展，您需要将 safeupdate.so 文件复制到 PostgreSQL 的扩展目录中，通常是 /usr/local/pgsql/lib 或 /usr/lib/postgresql/X.Y/contrib（X.Y 是 PostgreSQL 的版本号）。
```
sudo cp safeupdate.so /usr/local/pgsql/lib
```
然后，您需要将扩展的 SQL 脚本运行在 PostgreSQL 中，以创建所需的函数和对象。进入 pg-safeupdate 目录，并执行以下命令：
```
sudo make install
```
启用扩展

在 PostgreSQL 数据库中启用 pg-safeupdate 扩展。首先，连接到您的数据库：
```
psql mydatabase
```
然后，运行以下命令来加载扩展：
```
CREATE EXTENSION safeupdate;
```
或者，如果您想要在所有会话中默认加载该扩展，可以在 postgresql.conf 文件中添加以下配置行：
```
shared_preload_libraries='safeupdate'
```
并重启 PostgreSQL 服务。
使用扩展

现在您已经安装并启用了 pg-safeupdate 扩展，任何没有 WHERE 子句的 UPDATE 或 DELETE 语句都会引发错误。例如：
```
UPDATE rack SET fan_speed = 70; -- 这将导致错误
```
您必须始终指定 WHERE 子句来限制更新或删除操作的范围。