PIGSTY

http

HTTP client for PostgreSQL, allows web page retrieval inside the database.

Overview

4070httppg_http1.6.3
UTIL
MIT
C

Attributes

YesNoYesNoYesUnknownNo-

Packages

EL
PGDG
pgsql_http_$v*1.6.3-
17
16
15
14
13
Debian
PGDG
postgresql-$v-http1.6.3-
17
16
15
14
13

Availability

PG17PG16PG15PG14PG13
el8.x86_64
1.6.3
1.6.3
1.6.3
1.6.3
1.6.3
el8.aarch64
1.6.3
1.6.3
1.6.3
1.6.3
1.6.3
el9.x86_64
1.6.3
1.6.3
1.6.3
1.6.3
1.6.3
el9.aarch64
1.6.3
1.6.3
1.6.3
1.6.3
1.6.3
d12.x86_64
1.6.3
1.6.3
1.6.3
1.6.3
1.6.3
d12.aarch64
1.6.3
1.6.3
1.6.3
1.6.3
1.6.3
u22.x86_64
1.6.3
1.6.3
1.6.3
1.6.3
1.6.3
u22.aarch64
1.6.3
1.6.3
1.6.3
1.6.3
1.6.3
u24.x86_64
1.6.3
1.6.3
1.6.3
1.6.3
1.6.3
u24.aarch64
1.6.3
1.6.3
1.6.3
1.6.3
1.6.3
CONTRIB
PGDG
PIGSTY

Download

To add the required PGDG / PIGSTY upstream repository, use:

pig repo add pgdg -u    # add PGDG repo and update cache (leave existing repos)
pig repo add pigsty -u  # add PIGSTY repo and update cache (leave existing repos)
pig repo add pgsql -u   # add PGDG + Pigsty repo and update cache (leave existing repos)
pig repo set all -u     # set repo to all = NODE + PGSQL + INFRA  (remove existing repos)
./node.yml -t node_repo -e node_repo_modules=node,pgsql # -l <cluster>

Or download the latest packages directly:

Install

Install this extension with:

pig ext install http; # install by extension name, for the current active PG version
pig ext install pg_http; # install via package alias, for the active PG version
pig ext install http -v 17;   # install for PG 17
pig ext install http -v 16;   # install for PG 16
pig ext install http -v 15;   # install for PG 15
pig ext install http -v 14;   # install for PG 14
pig ext install http -v 13;   # install for PG 13
dnf install pgsql_http_17*;
dnf install pgsql_http_16*;
dnf install pgsql_http_15*;
dnf install pgsql_http_14*;
dnf install pgsql_http_13*;
apt install postgresql-17-http;
apt install postgresql-16-http;
apt install postgresql-15-http;
apt install postgresql-14-http;
apt install postgresql-13-http;
./pgsql.yml -t pg_ext -e '{"pg_extensions": ["pg_http"]}' # -l <cls>

Create this extension with:

CREATE EXTENSION http;

Usage

https://github.com/pramsey/pgsql-http

Request / Response Schema:

     Composite type "public.http_request"
    Column    |       Type        | Modifiers
--------------+-------------------+-----------
 method       | http_method       |
 uri          | character varying |
 headers      | http_header[]     |
 content_type | character varying |
 content      | character varying |

    Composite type "public.http_response"
    Column    |       Type        | Modifiers
--------------+-------------------+-----------
 status       | integer           |
 content_type | character varying |
 headers      | http_header[]     |
 content      | character varying |

Examples

Sending HTTP GET requests with SQL

CREATE EXTENSION http;

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

-- get status and content_type
SELECT status, content_type FROM http_get('http://httpbun.com/');

--  status |       content_type
-- --------+--------------------------
--     200 | text/html; charset=utf-8

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

--             field           |                      value
--  ---------------------------+--------------------------------------------------
--  Location                  | https://httpbun.com/
--  Date                      | Mon, 04 Nov 2024 09:00:36 GMT
--  Content-Length            | 0
--  Connection                | close
--  alt-svc                   | h3=":443"; ma=2592000
--  content-security-policy   | frame-ancestors 'none'
--  content-type              | text/html
--  date                      | Mon, 04 Nov 2024 09:00:37 GMT
--  strict-transport-security | max-age=31536000; includeSubDomains; preload
--  x-content-type-options    | nosniff
--  x-powered-by              | httpbun/af040d24038613575a85f74c2283ae79f8169927
--  (11 rows)
SELECT status, content::json->'form' AS form FROM http_post('http://httpbun.com/post', jsonb_build_object('myvar','myval','foo','bar'));

Issue http put requests:

SELECT status, content_type, content::json->>'data' AS data
  FROM http_put('http://httpbun.com/put', 'some text', 'text/plain');


--  status |   content_type   |   data
-- --------+------------------+-----------
--  200 | application/json | some text

Issue http post request: