GraphQL入门与开源的GraphQL引擎Hasura体验

背景

Hasura 是一个开源的 GraphQL 引擎，它可以帮助开发人员快速构建和部署现代应用程序的后端。它提供了一个自动化的 GraphQL API ，可以直接连接到现有的数据库，并提供实时数据推送和订阅功能。 Hasura 团队总部位于印度。

下载安装

脚本地址：https://raw.githubusercontent.com/hasura/graphql-engine/stable/install-manifests/docker-compose/docker-compose.yaml

[root@graphql ~]# cd /opt/hasura/# 下载docker-compose.yml的编排脚本
[root@graphql hasura]# curl https://raw.githubusercontent.com/hasura/graphql-engine/stable/install-manifests/docker-compose/docker-compose.yaml -o docker-compose.yml# 启动容器
[root@graphql hasura]# docker compose up -d
[+] Running 3/3✘ Container hasura-data-connector-agent-1  Error                                                                     0.1s ✔ Container hasura-postgres-1              Running                                                                   0.0s ✔ Container hasura-graphql-engine-1        Created                                                                   0.1s 
dependency failed to start: container hasura-data-connector-agent-1 is unhealthy

遇到的问题：CPU does not support x86-64-v2

正常情况下，经过上述的安装之后就可以正常使用Hasura了，但是显然， docker compose 启动容器后显示了一条错误信息：

dependency failed to start: container hasura-data-connector-agent-1 is unhealthy

# 查看进程
[root@graphql hasura]# docker ps
CONTAINER ID   IMAGE                                   COMMAND                   CREATED          STATUS                            PORTS      NAMES
48055c1c2732   hasura/graphql-data-connector:v2.33.0   "/app/run-java.sh"        29 seconds ago   Restarting (127) 13 seconds ago              hasura-data-connector-agent-1
8e5e0f4d8cd5   postgres:15                             "docker-entrypoint.s…"   13 hours ago     Up 13 hours                       5432/tcp   hasura-postgres-1# 查看报错容器的日志信息
[root@graphql hasura]# docker logs 48055c1c2732
Fatal glibc error: CPU does not support x86-64-v2
Fatal glibc error: CPU does not support x86-64-v2
Fatal glibc error: CPU does not support x86-64-v2

  • 原因分析
    日志里说明了错误的原因，由于 CPU 架构问题。。

  • 解决方法
    那么，就换个不同的版本吧，但是从官方的发布日志里并没有找到需要的版本；换个思路， data-connector-agent 似乎是新版本才加入的，核心的 graphql-engine 能用就行，就从网络博客中找到了以下 docker-compose.yml 的编排脚本：

version: '3.6'
services:postgres:image: postgres:15restart: alwaysvolumes:- db_data:/var/lib/postgresql/dataports:- "5432:5432"environment:POSTGRES_PASSWORD: postgrespasswordgraphql-engine:image: hasura/graphql-engine:v2.24.0ports:- "8080:8080"depends_on:- "postgres"restart: alwaysenvironment:## postgres database to store Hasura metadataHASURA_GRAPHQL_METADATA_DATABASE_URL: postgres://postgres:postgrespassword@postgres:5432/postgres## this env var can be used to add the above postgres database to Hasura as a data source. this can be removed/updated based on your needsPG_DATABASE_URL: postgres://postgres:postgrespassword@postgres:5432/postgres## enable the console served by serverHASURA_GRAPHQL_ENABLE_CONSOLE: "true" # set to "false" to disable console## enable debugging mode. It is recommended to disable this in productionHASURA_GRAPHQL_DEV_MODE: "true"HASURA_GRAPHQL_ENABLED_LOG_TYPES: startup, http-log, webhook-log, websocket-log, query-log## uncomment next line to run console offline (i.e load console assets from server instead of CDN)# HASURA_GRAPHQL_CONSOLE_ASSETS_DIR: /srv/console-assets## uncomment next line to set an admin secret# HASURA_GRAPHQL_ADMIN_SECRET: myadminsecretkey
volumes:db_data:

遇到的问题：不同版本的PostgreSQL数据目录不兼容

如果一开始用的是 PostgreSQL 15 ，而重新换新的 docker-compose.yml 的编排脚本（里面是 PostgreSQL 14.X ）执行时，便会报出以下错误。

The data directory was initialized by PostgreSQL version 15, which is not compatible with this version 14.9 (Debian 14.9-1.pgdg120+1).

  • 原因分析
    docker compose 会按名称重用卷（这样就不会丢失数据）。在更换 PostgreSQL 大版本时，必须将数据迁移到新卷，如果没有任何有用的数据，则删除旧的卷。

  • 解决方法
    先删除容器，再删除未被任何容器使用的本地卷
    docker volume ls # 查看本地所有的卷
    docker volume prune # 删除未被任何容器使用的本地卷

[root@graphql hasura]# docker volume ls
DRIVER    VOLUME NAME
local     hasura_db_data# 这条命令并没有删除卷，接着就用下一条语句直接删除
[root@graphql hasura]# docker volume prune
WARNING! This will remove anonymous local volumes not used by at least one container.
Are you sure you want to continue? [y/N] y
Total reclaimed space: 0B[root@graphql hasura]# docker volume rm hasura_db_data
hasura_db_data
/var/lib/docker/volumes# 再次尝试启动
[root@graphql hasura]# docker compose up -d# 启动成功
[root@graphql hasura]# docker ps
CONTAINER ID   IMAGE                           COMMAND                    CREATED              STATUS                        PORTS                                       NAMES
5709437e2127   hasura/graphql-engine:v2.24.0   "/bin/sh -c '\"${HGE_…"   About a minute ago   Up About a minute (healthy)   0.0.0.0:8080->8080/tcp, :::8080->8080/tcp   hasura-graphql-engine-1
a41ec5127932   postgres:15                     "docker-entrypoint.s…"    About a minute ago   Up About a minute             0.0.0.0:5432->5432/tcp, :::5432->5432/tcp   hasura-postgres-1

连接数据源

安装启动成功后，可以打开浏览器访问控制台：http://your-host:8080/console。

可以直接使用 Hasura 自带的 PostgreSQL 作为数据源进行操作。

2023-11-04-Hasura.jpg

Hasura 本身就是基于 PostgreSQL 进行开发的，目前对其他的数据库也在做适配中，不过如果要连接 MySQL ，则需要使用其企业版。。

2023-11-04-MySQL.jpg

因此如果确实有连接 MySQL 的强需求，则可以尝试下国产版的 Hasura ：飞布。

2023-11-04-Fireboom.jpg

GraphQL基本操作

关于 GraphQL 可以结合以下两个网址极速入门~~

  • GraphQL入门
  • Countries GraphQL API

2023-11-04-Country.jpg

基本查询

query {countries{name,codephones}
}

嵌套查询

query {countries{name,codephone,languages{code,name,native,rtl}}
}

条件查询

{countries(filter : {code:{eq: "AU"} }) {namecodephonelanguages {codenamenativertl}}
}query getCountry {country(code: "CN"){name,codephones}
}

别名

{countries(filter : {code:{eq: "AU"} }) {namecodephonelan: languages {codenamenativertl}}
}

片段

{conflictOne: countries(filter: {code: {eq: "PS"}}) {...sameField}conflictTwo: countries(filter: {code: {eq: "IL"}}) {...sameField}
}fragment sameField on Country {codenamenativelan: languages {codenamenative}
}

操作名称query

query getCounty {countries(filter : {code:{eq: "CN"} }) {namecodephonelanguages {codenamenativertl}}
}

变量

query getCounty($code: String) {countries(filter: {code: {eq: $code}}) {namecodephonelanguages {codenamenativertl}}
}{"code": "AU"
}

默认变量

query getCounty($code: String = "CN") {countries(filter: {code: {eq: $code}}) {namecodephonelanguages {codenamenativertl}}
}

指令：include，skip

query getCounty($code: String, $withLanguages: Boolean!) {countries(filter: {code: {eq: $code}}) {namecodephonelanguages @include(if: $withLanguages){codenamenativertl}states @skip(if: $withLanguages){codename}}
}{"code": "CN","withLanguages": false
}

小总结

Hasura 是一个强大的工具，可以帮助开发人员快速构建现代应用程序的后端，并提供实时数据推送和安全性，其特性如下：

  1. 快速开发：Hasura提供了一个简单易用的界面，可以快速定义和管理数据模型，并自动生成GraphQL API。这样可以大大减少开发时间和工作量。
  2. 实时数据推送：Hasura支持实时数据推送和订阅功能，可以实时更新客户端应用程序的数据。这对于需要实时更新的应用程序非常有用，如聊天应用、实时博客等。
  3. 安全性：Hasura提供了强大的身份验证和授权功能，可以轻松管理用户权限和访问控制。这样可以确保数据的安全性和保护用户隐私。
  4. 扩展性：Hasura可以轻松扩展以处理高负载和大规模应用程序。它支持水平扩展和负载均衡，可以根据需要增加或减少资源。

当然，作为一款后端低代码平台，也推荐使用对标 Hasura 的国产替代产品：飞布：

飞布是可视化API开发平台，对标 hasura ，灵活开放、多语言兼容、简单易学，能构建生产级 WEB API ，让前端变全栈，让后端不搬砖。

Reference

  • Hasura官方文档
  • Hasura安装脚本
  • Countries GraphQL API 源码
  • Countries 数据集

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.hqwc.cn/news/161730.html

如若内容造成侵权/违法违规/事实不符，请联系编程知识网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

YoloV8目标检测与实例分割——目标检测onnx模型推理

YoloV8目标检测与实例分割——目标检测onnx模型推理

一、模型转换 1.onnxruntime ONNX Runtime（ONNX Runtime或ORT）是一个开源的高性能推理引擎，用于部署和运行机器学习模型。它的设计目标是优化执行使用Open Neural Network Exchange（ONNX）格式定义的模型，…
阅读更多...
集线器、交换机、网桥、路由器、网关

集线器、交换机、网桥、路由器、网关

目录 集线器(HUB)交换机(SWITCH)网桥(BRIDGE)路由器(ROUTER)网关(GATEWAY)交换机和路由器的区别参考 集线器(HUB) 功能 集线器对数据的传输起到同步、放大和整形的作用 属于物理层设备 工作机制 使用集线器互连而成的以太网被称为共享式以太网。当某个主机要给另一个主机发送单…
阅读更多...
Python模块psutil：系统进程管理与Selenium效率提升的完美结合

Python模块psutil：系统进程管理与Selenium效率提升的完美结合

前言 在前面编写一个Selenium的自动化程序时候，发现一个问题。 因笔记本配置较为差，所以每次初始化Selenium的WebDriver都会非常慢，整个等待过程是不友好的。 所以我就想到： 在程序中初始化一个全局的WebDriver对象&#xff0c…
阅读更多...
【JMeter】后置处理器的分类以及场景介绍

【JMeter】后置处理器的分类以及场景介绍

1.常用后置处理器的分类 Json提取器 针对响应体的返回结果是json格式的会自动生成新的变量名为【提取器中变量名_MatchNr】，取到的个数由jsonpath expression取到的个数决定 可以当作普通变量调用，调用语法：${提取器中变量名_MatchNr}正则表达式提取器 返回结果是任何数据格…
阅读更多...
Qt QtCreator添加自定义注释

Qt QtCreator添加自定义注释

在写代码的时候我们为了规范化，一般会加文件注释、类注释和函数注释；用注释来说明我们的代码，也方便模块化开发，那么我们在写注释的时候经常会写一些重复的内容，我们会复制粘贴。这样一来二去，就显得很繁琐…
阅读更多...
论文阅读—— CEASC（cvpr2023）

论文阅读—— CEASC（cvpr2023）

arxiv：https://arxiv.org/abs/2303.14488 github：https://github.com/Cuogeihong/CEASC 为了进一步减轻SC中的信息损失，使训练过程更加稳定，我们在训练过程中除了稀疏卷积之外，还保持了正常的密集卷积，生成…
阅读更多...
Iceberg教程

Iceberg教程

目录 教程来源于尚硅谷1. 简介1.1 概述1.2 特性 2. 存储结构2.1 数据文件(data files)2.2 表快照(Snapshot)2.3 清单列表(Manifest list)2.4 清单文件(Manifest file)2.5 查询流程分析 3. 与Flink集成3.1 环境准备3.1.1 安装Flink3.1.2 启动Sql-Client 3.2 语法 教程来源于尚硅…
阅读更多...
https原理

https原理

首先说一下几个概念：对称加密、非对称加密 对称加密： 客户端和服务端使用同一个秘钥，分两种情况： 1、所有的客户端和服务端使用同一个秘钥，这个秘钥被泄漏后数据不再安全 2、每个客户端生成一个秘钥&…
阅读更多...
Apache Flink 1.12.0 on Yarn(3.1.1) 所遇到的問題

Apache Flink 1.12.0 on Yarn(3.1.1) 所遇到的問題

Apache Flink 1.12.0 on Yarn(3.1.1) 所遇到的問題 新搭建的FLINK集群出现的问题汇总 1.新搭建的Flink集群和Hadoop集群无法正常启动Flink任务 查看这个提交任务的日志无法发现有用的错误信息。 进一步查看yarn日志： 发现只有JobManager的错误日志出现了如下的…
阅读更多...
3+单细胞+代谢+WGCNA+机器学习

3+单细胞+代谢+WGCNA+机器学习

今天给同学们分享一篇生信文章“Identification of new co-diagnostic genes for sepsis and metabolic syndrome using single-cell data analysis and machine learning algorithms”，这篇文章发表Front Genet.期刊上，影响因子为3.7。 结果解读&#x…
阅读更多...
3.26每日一题（线性非齐次的特解如何设）

3.26每日一题（线性非齐次的特解如何设）

1、非齐次方程有e的2x次幂：特解也有e的2x次幂 2、e的2x次幂前面有特殊的一元方程：特解要设为一般的特征方程（axb） 3、求线性齐次特征方程的特征根； 4、判断e的 rx 次幂中的 r 和特征根有没有重合的个数：…
阅读更多...
curl(七)上传和下载

curl(七)上传和下载

一 上传 ① -T | --upload 上传 ​1、向ftp服务器 传一个文件：curl -T localfile -u name：passwd ftp://upload_site：port/path/2、向http服务器上传文件curl -T localfile http://www.wzj.com/wzj.html注意: 这时候使用的协议是HTTP的PUT…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023