企业内部经常会开发一些小型系统或需要将现有的系统开发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 Console

Hasura与GraphQL

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

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

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

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

Example Table

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

Query Order

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

GraphQL订阅查询

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

水平扩展

性能测试

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

快速开始

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

# PostgreSQLdocker run --name local-postgres \  -e POSTGRES_PASSWORD=your_password \    -e PGDATA=/var/lib/postgresql/data/pgdata \  -p 5432:5432 -d postgres:12# Hasuradocker 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。

Connect Database

安装PostgreSQL命令行客户端：

brew install libpqbrew link --force libpqpsql 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中添加这两张表：

添加表到Hasura

插入一条用户数据：

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接口：

创建Restful接口

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

query MyQuery {  example_users {    cell_phone    gender    id    name  }}

查询User

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

Hasura生成的SQL

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

API 列表

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

访问Restful API

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

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

参考资料