What is PostgREST

从字面上看 PostgREST 是 PostgreSQL+ RESTful 的组合体。

PostgREST 是 haskell 写的，以 postgres 数据库为基础，替你自动生成 REST API。你只需要通过 sql 定义好数据库的 table 等，postgrest 就能生成 REST API。PostgREST 效率非常高，而且它连 json 的 render 都在 postgres 中处理，性能还不错。

有这样的一张数据表结构

create table todos (
  id serial primary key,
  done boolean not null default false,
  task text not null,
  due timestamptz
);

insert into todos (task) values
  ('finish tutorial 0'), ('pat self on back');

运行 PostgREST，你可以通过 http 访问数据库数据了

[
  {
    "id":1,
    "done":false,
    "task":"finish tutorial 0",
    "due":null
  },
  {
    "id":2,
    "done":false,
    "task":"pat self on back",
    "due":null
  }
]

安装

下载 PostgREST 打包好的releases版本就好

配置文件 db.conf

# db.conf

db-uri = "postgres://postgres:postgres@localhost:5432/eth"
db-schema = "public" # postgre default schema public
db-anon-role = "postgres" #用户
server-host = "0.0.0.0"
server-port = 4000 # 端口

设置 PostgreSQL 访问权限

在pg_hba.conf中配置服务端允许的认证方式

#/etc/postgresql/9.x/main/pg_hba.conf
# TYPE  DATABASE  USER  CIDR-ADDRESS  METHOD

host all all 127.0.0.1/0 md5

重启数据库 sudo service postgresql restart

启动 PostgREST

postgrest db.conf 根据配置文件中设定的端口启动 http 服务

请求数据

curl http://localhost:4000/blocks # 直接请求数据表 blocks

[
  {
    "id":1,
    "height":10,
    "timestamp":1516894509,
    "txs_num":500,
    "hash":"0x40b8e073a6196d330a35c4b41f8ec9e7a00aa4898d580ee360a703119517d986",
    "parent_hash":"0x53d898401c6c7900cc0b14da33c2d25b1d4a83db36e7faefc998f597682ea708",
    "uncle_hash":"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "coinbase":"0x5a0b54d5dc17e0aadc383d2db43b0a0d3e029c4c",
    "difficulty":236596,
    "size":29216,
    "gas_used":7965081,
    "gas_limit":7988374,
    "nonce":61634,
    "reward":5193,
    "extra_data":"sparkpool-cn-node-2",
  }
]

查询条件可以灵活组合，生产力暴棚，更复杂的查询请看 PostgREST 的 API 文档

http://localhost:4000/blocks?limit=10 #获取前 10 条数据
http://localhost:4000/blocks?limit=10&offset=30 #分页
http://localhost:4000/blocks?limit=10&order=height.desc #倒序
http://localhost:4000/blocks?limit=10&select=height #只获取 height 字段
http://localhost:4000/blocks?limit=10&select=height,hash&id.gte.99999 # 获取 id>99999 的数据

新工具 pREST

pREST 跟 PostgREST 功能类似。PostgREST 用 Haskell 写的，pREST 用 go 写的，文档也更全面。

pREST 例子 http://<url>/<db>/public/<tabel>?tokens=$notnull&balance=$gt.0&_page_size=20&_page=2

查询 tabel 中 tokens 不为空 balance>0的数据，也支持分页，太棒了。

prest.toml 配置文件内容：

# migrations = "./migrations"

# debug = true
# enabling debug mode will disable JWT authorization

[http]
port = 9000
# Port 6000 is blocked on windows. You must change to 8080 or any unblocked port

[jwt]
default = false

[pg]
host = "127.0.0.1"
user = "postgres"
pass = "postgres"
port = 5432
database = "zqw"
## or used cloud factor
# URL = "postgresql://user:pass@localhost/mydatabase/?sslmode=disable"

[access]
restrict = true  # can access only the tables listed below

    [[access.tables]]
    name = "block"
    permissions = ["read"]
    fields="*"