揭秘pgsql-http：PostgreSQL与外部服务通信的核心组件

【免费下载链接】pgsql-http HTTP client for PostgreSQL, retrieve a web page from inside the database. 项目地址: https://gitcode.com/gh_mirrors/pg/pgsql-http

pgsql-http是一款功能强大的PostgreSQL扩展，它充当数据库与外部服务通信的桥梁，让你能够直接从PostgreSQL数据库内部发起HTTP请求。无论是构建触发器调用Web服务，还是实现数据库与外部API的实时数据交互，pgsql-http都能提供简单高效的解决方案。

🌟 pgsql-http的核心价值

想象一下，当数据库中的数据发生变化时，能够自动通知外部系统；或者在查询数据时，能实时从外部API获取补充信息——这些场景通过pgsql-http都能轻松实现。这款扩展将HTTP客户端能力直接集成到PostgreSQL中，打破了数据库与外部服务之间的壁垒。

🚀 快速上手：基础功能体验

URL编码从未如此简单

处理URL参数时，特殊字符编码是必备操作。pgsql-http提供了便捷的urlencode函数：

-- 编码字符串
SELECT urlencode('my special string''s & things?');

-- 编码JSON数据
SELECT urlencode(jsonb_build_object('name','Colin & James','rate','50%'));

轻松发起HTTP请求

pgsql-http支持多种HTTP方法，让数据库具备完整的Web通信能力：

-- 基础GET请求
SELECT content FROM http_get('http://httpbun.com/ip');

-- 带请求头的GET请求
SELECT content::json->'headers'->>'Authorization'
  FROM http((
          'GET',
           'http://httpbun.com/headers',
           ARRAY[http_header('Authorization','Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9')],
           NULL,
           NULL
        )::http_request);

📚 核心功能解析

请求与响应模型

pgsql-http建立在两个核心复合类型之上：

• http_request：包含请求方法、URI、请求头、内容类型和内容
• http_response：包含状态码、内容类型、响应头和响应内容

所有HTTP操作都围绕这两个类型展开，通过http()主函数实现，其他工具函数如http_get()、http_post()等都是对该函数的封装。

全面的HTTP方法支持

pgsql-http提供了完整的HTTP方法支持：

• http_get(uri VARCHAR)：发送GET请求
• http_post(uri VARCHAR, content VARCHAR, content_type VARCHAR)：发送POST请求
• http_put(uri VARCHAR, content VARCHAR, content_type VARCHAR)：发送PUT请求
• http_patch(uri VARCHAR, content VARCHAR, content_type VARCHAR)：发送PATCH请求
• http_delete(uri VARCHAR)：发送DELETE请求
• http_head(uri VARCHAR)：发送HEAD请求

高级配置：CURL选项

通过http_set_curlopt()函数，你可以直接配置CURL选项，实现代理设置、超时控制、SSL验证等高级功能：

-- 设置代理端口
SELECT http_set_curlopt('CURLOPT_PROXYPORT', '12345');

-- 设置User-Agent
SELECT http_set_curlopt('CURLOPT_USERAGENT', 'MyApp/1.0 (+https://myapp.example.com)');

-- 列出当前设置的所有CURL选项
SELECT * FROM http_list_curlopt();

📦 安装指南

Debian/Ubuntu系统

通过apt直接安装（替换17为你的PostgreSQL版本）：

apt install postgresql-17-http

源码编译安装

1. 安装依赖：

sudo apt install postgresql-server-dev-14 libcurl4-openssl-dev make g++

2. 编译安装：

make
sudo make install

3. 在数据库中启用扩展：

CREATE EXTENSION http;

⚠️ 注意事项

虽然pgsql-http功能强大，但使用时需注意：

• 超时处理：默认超时时间为5秒，可通过http.timeout_msec参数调整
• 连接管理：默认每次请求使用新连接，高性能场景可启用http.keepalive = 'on'
• 安全性：谨慎授予函数执行权限，避免未授权的外部请求
• 错误处理：始终检查HTTP响应状态码，处理可能的错误和异常

💡 实用场景举例

1. 触发器集成

创建触发器，在数据更新时自动通知外部系统：

CREATE OR REPLACE FUNCTION notify_external_service()
RETURNS trigger AS $$
BEGIN
  PERFORM http_post(
    'https://api.example.com/notify',
    jsonb_build_object('id', NEW.id, 'action', 'updated'),
    'application/json'
  );
  RETURN NEW;
END;
$$ LANGUAGE plpgsql;

CREATE TRIGGER data_updated_trigger
AFTER UPDATE ON important_table
FOR EACH ROW EXECUTE FUNCTION notify_external_service();

2. 数据增强

查询时从外部API获取补充数据：

SELECT 
  users.id, 
  users.name,
  (http_get('https://api.example.com/user-stats/' || users.id)).content::json->>'rating' AS rating
FROM users;

pgsql-http为PostgreSQL数据库带来了强大的外部通信能力，无论是构建实时数据集成管道，还是实现复杂的业务逻辑，它都能成为你得力的工具。通过简单的SQL函数，就能让数据库与外部世界无缝连接，开启PostgreSQL的全新可能！

【免费下载链接】pgsql-http HTTP client for PostgreSQL, retrieve a web page from inside the database. 项目地址: https://gitcode.com/gh_mirrors/pg/pgsql-http