企业内部经常会开发一些小型系统或需要将现有的系统开发Restful API供内部系统集成，这类系统的特点是：几乎都是CRUD操作，业务简单，使用人数少，生命周期短。有没有一种工具，我们只需要关注数据库设计，使用它快速自动生成Restful API供前端或第三方系统调用？

本文将为大家介绍一个工具Hasura，它能够帮助你通过实时GraphQL API即时访问你的数据，因此你可以更快地构建和发布现代应用程序和API。Hasura连接到你的数据库、REST 服务器、GraphQL服务器和第三方API，为你的所有数据源提供统一的实时GraphQL API。

什么是Hasura

开源的SQL转API的项目不少，例如SQLer和Directus是Github Star数量较高的项目。Directus提供了用于管理SQL数据库内容的实时API和应用仪表板；SQLer是一个小型便携式服务器，使你可以使用SQL查询编写API，以便在任何人点击它时执行，它还使你能够定义验证规则，以便你可以验证请求正文/查询参数，以及使用简单的数据转换JavaScript语法。SQLer使用Nginx风格的配置语言(HCL)和JavaScript引擎来自定义表达式。

相比SQLer、Directus，Hasura提供了更为灵活、易用、强大的功能，同时它提供了Web Console，更便于管理API。Hasura提供以下功能：

• 强大的查询：内置过滤、分页、模式搜索、批量插入、更新、删除；
• 添加现有的数据库：将其指向现有数据库以立即获得即用型GraphQL API；
• 实时查询：使用订阅将任何GraphQL查询转换为实时查询；
• 操作扩展：编写REST API以使用自定义业务逻辑扩展Hasura的架构。
• 触发webhooks或无服务器功能：在Postgres插入/更新/删除事件；
• 预定触发器：使用cron配置或一次性事件在特定时间点执行自定义业务逻辑；
• 细粒度访问控制：与身份验证系统集成的动态访问控制；
• 管理UI：提供一个易用的Web管理UI；
• 多数据库支持：PostgreSQL、SQL Server、Big Query、MySQL等；

Hasura与GraphQL

GraphQL是一种数据语言，此语言的开发目的是便于应用程序从服务器上提取数据。它具有可指定的自记录风格。在GraphQL操作中，客户端指定数据从服务器返回时的结构如何。这样客户端就可以只查询它需要的数据，以它需要的格式进行查询。

GraphQL的实现分为Client和Server，Server实现了GraphQL协议，支持GraphQL查询，Client是一个GraphQL请求客户端，就像jQuery Ajax和Restful后端API的关系一样。GraphQL 有三项顶级操作：

• 查询 - 只读提取；
• 更改 - 写入，然后提取；
• 订阅 - 用于接收数据的长期活动连接；

GraphQL使应用程序开发人员可以轻松地从他们的API中精确查询他们想要的数据。例如，假设我们正在构建一个送餐应用程序。以下是Postgres上的表结构可能的样子：

对于显示当前用户订单的“订单状态”的应用程序，GraphQL查询将获取最新的订单状态和交付订单的位置，此查询参数作为字符串发送到网络服务器，该服务器对其进行解析、应用授权规则并适当调用数据库等内容以获取应用程序的数据。它以请求的确切格式将此数据作为JSON返回。

实时查询是能够订阅特定查询的最新结果。随着底层数据的变化，服务器应该将最新的结果推送给客户端。这与GraphQL完美契合，因为GraphQL客户端支持订阅来处理混乱的WebSocket连接。如果GraphQL服务器支持，将查询转换为实时查询非常简单。

Hasura本质上是一个GraphQL引擎，它也提供将GraphQL查询转换为Resrful API的功能。它拥有良好的并发实时订阅性能，并且支持垂直和/或水平扩展：

Hasura GraphQL引擎订阅实际上是实时查询，即订阅将返回正在进行的查询的最新结果，而不是导致结果的单个事件。Hasura通过将多个相似的订阅组合成一个SQL查询并从数据库中获取单个响应来优化订阅，而不是为每个订阅进行单独的SQL查询。

快速开始

下面我们开始使用Docker + Hasura + PostgreSQL演示一个CRUD的例子，具体看看Hasura能够提供的功能。首先我们使用Docker启动PostgreSQL数据库和Hasura Engine，并开启Console：

# PostgreSQL
docker run --name local-postgres \
  -e POSTGRES_PASSWORD=your_password \  
  -e PGDATA=/var/lib/postgresql/data/pgdata \
  -p 5432:5432 -d postgres:12
# Hasura
docker run -d -p 8080:8080 \
  -e HASURA_GRAPHQL_DATABASE_URL=postgres://username:password@hostname:port/dbname \
  -e HASURA_GRAPHQL_ENABLE_CONSOLE=true \
  hasura/graphql-engine:latest

笔者使用Mac Book运行本案例，使用的docker.for.mac.localhost连接数据库，这是Docker内置的变量，代表本地hostname。如果你在实验过程中遇到PostgreSQL连接的问题，在Docker应用中连接Docker数据库可以通过inspect命令查看数据库在Docker中的端口和IP。

启动之后访问localhost:8080就可以看到Hasura的Console界面。这里我们直接使用这台PostgreSQL数据库，不再连接另外的Database。

安装PostgreSQL命令行客户端：

brew install libpq
brew link --force libpq
psql postgres://postgres:[your password]@localhost:5432/postgres

在PostgreSQL中创建一个Schema和两张表，一张是用户表，另一张是薪水表：

create schema if not exists example;
set search_path to 'example';
create sequence users_id_seq start 1000 increment 1;
create table users (
  id integer primary key default nextval('users_id_seq'),
  name varchar(40) NOT NULL,
  gender integer NOT NULL,
  cell_phone varchar(40) not null
);

create sequence payroll_id_seq start 1000 increment 1;
create table payroll (
  id integer primary key default nextval('payroll_id_seq'),
  user_id integer not null,
  pay_day date not null,
  salary money not null
);

在Console中添加这两张表：

插入一条用户数据：

mutation MyMutation($object: example_users_insert_input!) {
  insert_example_users_one(object: $object) {
    cell_phone
    gender
    name
  }
}
// 参数
{
  "object": {
    "cell_phone": "18200008888",
    "gender": 1,
    "name": "Lisa"
  }
}

查询数据库发现数据已经插入：

postgres=# select * from users;
  id  | name | gender | cell_phone  
------+------+--------+-------------
 1001 | Lisa |      1 | 18200008888
(1 row)

点击上图中的REST按钮将插入操作转换为Restful接口：

接着创建用户查询接口，在API Query窗口中添加User查询，生成的查询语句如下：

query MyQuery {
  example_users {
    cell_phone
    gender
    id
    name
  }
}

你同样可以点击“Analye”按钮查看Hasura生成的SQL语句：

点击REST按钮创建Restful API，至此我们创建了2个API：

通过浏览器访问API，效果如下：

删除、修改与订阅功能下文就不再演示了，你可以根据官方文档解锁Hasura更多的功能。通过本文的案例，相信你可以初步了解Hasura提供的能力，它是一个Graphql引擎，并能提供Restful接口，同时它能定时执行你定义的SQL，并在数据操作前允许你回调自定义接口以扩展功能。

通过向大家介绍Hasura为大家解决工作中的问题提供一个工具储备，相信能对你有所帮助。如果你在工作中也用到了Hasura，欢迎留言讨论。

参考资料

https://github.com/hasura/graphql-engine

https://hasura.io/docs/latest/graphql/core/index.html