如何在PostgreSQL中直接调用Web服务？pgsql-http入门指南

【免费下载链接】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扩展，它允许您直接在数据库内部调用Web服务，实现数据的实时获取与交互。无论是需要从外部API获取数据，还是在触发器中调用Web钩子，pgsql-http都能为您提供简单而高效的解决方案。

🚀 什么是pgsql-http？

pgsql-http是一个PostgreSQL扩展，它提供了完整的HTTP客户端功能，使您能够在SQL中直接发送HTTP请求并处理响应。通过这个扩展，您可以轻松实现数据库与外部Web服务的集成，无需额外的中间层。

根据项目元数据META.json显示，当前最新版本为1.6.1，支持PostgreSQL 9.1及以上版本。该扩展使用MIT许可证，由Paul Ramsey维护，源码托管在Git仓库中。

⚡ 核心功能与优势

pgsql-http提供了一系列实用功能，让数据库与Web服务的交互变得简单：

• 完整的HTTP方法支持：包括GET、POST、PUT、PATCH、DELETE和HEAD
• 灵活的请求配置：支持自定义请求头、内容类型和请求体
• URL编码工具：方便处理URL参数和表单数据
• CURL选项配置：支持代理设置、SSL验证、超时控制等高级功能
• 响应处理：获取状态码、响应头和响应内容

📦 快速安装步骤

Debian/Ubuntu系统

如果您使用的是Debian或Ubuntu系统，可以通过apt直接安装：

# 替换17为您的PostgreSQL版本
apt install postgresql-17-http

从源码编译安装

对于其他系统，您可以从源码编译安装：

# 安装依赖
sudo apt install postgresql-server-dev-14 libcurl4-openssl-dev make g++

# 克隆仓库
git clone https://gitcode.com/gh_mirrors/pg/pgsql-http

# 编译安装
cd pgsql-http
make
sudo make install

启用扩展

安装完成后，在PostgreSQL中启用扩展：

CREATE EXTENSION http;

如果您已经安装过旧版本，可以通过以下命令升级：

ALTER EXTENSION http UPDATE;

🔍 基础使用示例

1. 发送GET请求

最基本的用法是发送GET请求获取网页内容：

SELECT content
  FROM http_get('http://httpbun.com/ip');

返回结果：

           content
-----------------------------
 {"origin":"24.69.186.43"}
(1 row)

2. 带参数的GET请求

您可以通过JSONB参数传递查询参数：

SELECT status, content::json->'args' AS args
  FROM http_get('http://httpbun.com/get',
                jsonb_build_object('myvar','myval','foo','bar'));

3. 发送POST请求

发送JSON数据的POST请求：

SELECT status, content::json->'form' AS form
  FROM http_post('http://httpbun.com/post',
                 jsonb_build_object('myvar','myval','foo','bar'));

4. 自定义请求头

添加自定义请求头，如认证信息：

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

🛠️ 高级功能

URL编码

pgsql-http提供了urlencode函数，方便处理特殊字符：

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

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

处理响应头

您可以解析并处理响应头信息：

SELECT (unnest(headers)).*
  FROM http_get('http://httpbun.com/');

返回结果：

      field       |                      value
------------------+--------------------------------------------------
 Server           | nginx
 Date             | Wed, 26 Jul 2023 19:52:51 GMT
 Content-Type     | text/html
 Content-Length   | 162
 Connection       | close
 Location         | https://httpbun.org
 server           | nginx
 date             | Wed, 26 Jul 2023 19:52:51 GMT
 content-type     | text/html
 x-powered-by     | httpbun/3c0dc05883dd9212ac38b04705037d50b02f2596
 content-encoding | gzip

配置CURL选项

pgsql-http允许您配置底层CURL选项，如设置代理、超时等：

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

-- 设置用户代理
SELECT http_set_curlopt('CURLOPT_USERAGENT', 'MyApp/1.0 (+https://myapp.example.com)');

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

-- 重置所有选项
SELECT http_reset_curlopt();

⚠️ 注意事项

虽然pgsql-http功能强大，但在使用时也需要注意以下几点：

1. 性能影响：HTTP请求可能会阻塞SQL执行，影响数据库性能。建议设置合理的超时时间：

   SELECT http_set_curlopt('CURLOPT_TIMEOUT', '5'); -- 5秒超时
   

2. 错误处理：始终检查HTTP响应状态码，处理可能的错误：

   SELECT status, content 
   FROM http_get('http://example.com') 
   WHERE status = 200;
   

3. 安全考虑：限制对敏感函数的访问，避免未授权的外部请求：

   REVOKE EXECUTE ON FUNCTION http_get FROM PUBLIC;
   GRANT EXECUTE ON FUNCTION http_get TO trusted_role;
   

4. 连接管理：默认情况下，每个请求使用新连接。对于高频请求，可以启用连接复用：

   SET http.keepalive = 'on';
   

📚 更多资源

• 项目源码：http.c
• 安装配置：Makefile
• SQL脚本：sql/http.sql
• 版本升级脚本：http--1.5--1.6.sql

通过pgsql-http，您可以轻松实现PostgreSQL与Web服务的无缝集成，为数据库应用带来更多可能性。无论是数据同步、外部API调用还是实时数据获取，pgsql-http都能成为您的得力助手！

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