iT邦幫忙

第 12 屆 iT 邦幫忙鐵人賽

DAY 30
1
AI & Data

看圖說故事,讓 Neo4j 重新詮釋你的資料庫系列 第 30

Neo4j 的 GraphQL 計畫:GRANDstack

上一篇文章開啟了 GraphQL 的話題,介紹 Neo4j GraphQL plugin 的使用,讓我們可以很方便用 GraphQL 存取 Neo4j 資料庫。
不過官方已不再維護這個 plugin,認為將 GraphQL 的支援從資料庫核心服務抽離出來,才是好的設計。

那麼取得代之的是什麼呢?neo4j-graphql-js 或是 neo4j-graphql-java,這兩個專案的作用都是將 GraphQL 語法轉換成 Cypher 來操作資料庫,只是語言不同。

在繼續說下去之前,我們先來看一個更大的東西 GRANDstack

安裝與操作 GRANDstack

GRANDstack 是 Neo4j 目前還在開發中的一個實驗計畫,其命名來自於:

  • GraphQL
  • React
  • Apollo
  • Neo4j Database

很顯然的,這是一個從前端到後端的完整開發環境,是一個示範 GraphQL 操作 Neo4j 資料庫的完整解決方案,我們先把它安裝起來吧!
安裝步驟相當簡單,官方也出了 GRANDstack Starter ,大致上的步驟如下:

  1. 準備一個空白的 Neo4j 資料庫,可以使用 Sandbox 的 Blank 方案;如果是本機的資料庫,記得要安裝 APOC library。
    Sandbox 的部分,須要複製帳密、以及 Bolt URL 等連線資訊
    Neo4j GRANDstack for sandbox
  2. 使用 create-grandstack-app 指令建立 GRANDstack 專案
npx create-grandstack-app mygrand
  1. 選擇開發 Web 的語言
    Neo4j GRANDstack step1
  2. 接下來就是一連串的各種選項和問答,透過這些問答來最簡化設定 config
    Neo4j GRANDstack step2
  3. 安裝成功後,直接執行 npm script
npm run start
  1. 上述指令會啟動 Apollo Server,並自動開啟 Dashboard 網頁,但因為是空的資料庫,這時候還不會有什麼意義的資訊 http://localhost:3000/
  2. 塞入範例資料如下,再回來看 Dashboard 就會有一些資訊了
npm run seedDb

Neo4j GRANDstack dashboard

接下來就可以另外打開 http://localhost:4001/graphql 來下達 GraphQL 的查詢語法。

Neo4j GRANDstack GraphQL

GRANDstack 的其他細節設定與操作,可以參考官方教學,接下來我們回過頭來看看 neo4j-graphql.js

neo4j-graphql.js

我們試著用最少的程式碼來實作 GraphQL 查詢電影資料庫,首先開啟一個新的 nodejs 專案,並安裝 neo4j-graphql.js 和 Apollo server

npm init
npm install --save neo4j-graphql-js apollo-server

先簡單定義我們預期的 GraphQL Schema,然後在交由 graphql js 自動產生完整的 Schema

const GraphqlJS = require('neo4j-graphql-js');

const typeDefs = `
type Movie  {
    title: String!
    released: Int
    actors: [Person] @relation(name:"ACTED_IN",direction:IN)
}
type Person {
    name: String!
    born: Int
    movies: [Movie] @relation(name:"ACTED_IN",direction:OUT)
}
`;

const schema = GraphqlJS.makeAugmentedSchema({ typeDefs });
// console.log(schema);

初始化一個 Neo4j Driver 物件

const neo4j = require('neo4j-driver');

const driver = neo4j.driver(
  'bolt://localhost:7687',
  neo4j.auth.basic('neo4j', 'mypassword')
);

初始化 Apollo server 物件並監聽 3003 port

const Apollo = require('apollo-server');

const server = new Apollo.ApolloServer({ schema, context: { driver } });

server.listen(3003, '0.0.0.0').then(({ url }) => {
  console.log(`GraphQL API ready at ${url}`);
});

接著開啟網頁 http://0.0.0.0:3003/ 就可以用 GraphQL 查詢電影資料庫了,範例如下

Neo4j GraphQL js demo

以上就是 GRANDstack 的初步介紹,更細節的教學請看參考資源喔~

這是鐵人賽最後一篇文章了,感謝過程中所有追蹤或瀏覽我文章的朋友們,謝謝你們知的支持 ^^
有很多文章是在很趕的時候送出的,沒有充分檢查,之後我會再撥些時間回來慢慢修飾與更正,如果圖形資料庫有勾起你的興趣,請還是持續訂閱追蹤,謝謝大家~

參考資源

https://neo4j.com/labs/grandstack-graphql/
https://grandstack.io/docs/neo4j-graphql-js/
https://github.com/neo4j-graphql/neo4j-graphql-js


上一篇
以 GraphQL 查詢 Neo4j 資料庫
系列文
看圖說故事,讓 Neo4j 重新詮釋你的資料庫30

1 則留言

0
gummy_01
iT邦新手 5 級 ‧ 2020-12-22 22:31:11

您好,我是中正大學碩專班的學生,敝姓林,
本身因為論文需使用到Neo4j工具,但官方trigger文件我一直無法執行成功,
網路上爬文也尚未解決問題。

不曉得您對這方面是否有研究呢?
非常感謝!!!

蛋踢球 iT邦新手 5 級 ‧ 2020-12-29 00:11:00 檢舉

很抱歉,今天才看到您的留言^^"
Trigger 我沒特別研究,但也許你可以試著貼更多資訊,我們可以一起找答案~

gummy_01 iT邦新手 5 級 ‧ 2021-01-05 09:38:52 檢舉

好的QQ,因為這部分資源比較少…想說上來討論看看XD,先謝謝你協助~~我再研究看看!!若有相關疑問或操作問題的話再與您討論切磋~

我要留言

立即登入留言