[Fullstack] Xây dựng forum bằng GraphQL, React, Apollo và Prisma - Part 4 (Backend - Connect to Database)
Bài đăng này đã không được cập nhật trong 5 năm
Hi mọi người!. Tiếp tục với series xây dựng forum bằng GraphQL, React, Apollo, Nodejs và Prisma.
Link toàn bộ series các bạn có thể xem ở đây
Ở phần trước chúng ta đã tìm hiểu qua về Mutation và Query cơ bản. Cách đọc dữ liệu với Query
và cách update dữ liệu với Mutation
sử dụng resolvers
.
Phần này, chúng ta sẽ cùng nhau đi kết nối với Database và thao tác với Database thông qua Prisma Client (mình sẽ đề cập chi tiết bên dưới)
Prisma là gì và vì sao sử dụng Prisma?
Prisma là một Object Relational Mapping (ORMs) được dùng để xây dựng các máy chủ như GraphQL Server, RESTful APIs, microservice, ...etc.
Như mình đã giới thiệu ở bài viết đầu tiên của series này. Prisma đơn giản là 1 layer nằm giữa Webserver và Database. Prisma giúp chúng ta giao tiếp với db một cách dễ dàng hơn.
Cách truyền thống mà Webserver giao tiếp với Database là thông qua các câu lệnh SQL Query như SELECT
, UPDATE
hay DELETE
Giờ đây, giờ vào các công cụ ORMs nói chung và Prisma nói riêng. Chúng tạo ra một tầng abstraction giữa Webserver và Database.
Điều này giúp cho lập trình viên dễ dàng trong việc thao tác với Database. Thay vì viết những câu lệnh SQL khô khan, có thể sai bất cứ lúc nào thì chúng ta có thể viết các hàm tương ứng.
Traditional solution:
Select * from Posts where title = "GraphQL API";
INSERT INTO Posts VALUES ("Graphql API", "Learning how to Writting GraphQL API", "thuan");
ORMs solution (JavaScript implementation)
const posts = prisma.posts({ title: "GraphQL API" });
const newPost = prisma.createPost({
title: "Graphql API",
description: "Learning how to Writting GraphQL API",
author: "thuan"
});
Việc sử dụng ORMs cũng cho chúng ta khả năng tuỳ biến rất cao. Trong hầu hết case phức tạp thì ORMs đều có thể handle được. Chúng ta hãy cùng tìm hiểu nhé.
Cài đặt Prisma và thao tác với Database
Prisma cho chúng ta 2 lựa chọn để setup Database:
- Tạo mới Database: Sử dụng Local Database (sử dụng Docker để building và running) hoặc Demo Database (Sử dụng dịch vụ của Prisma: Prisma Cloud)
- Từ Design Database có sẵn: Các bạn có thể xem thêm ở đây.
Điều hay ho ở đây là chúng ta không cần quan tâm đến việc sử dùng Database nào (Mysql, PostgresQL, MongoDB, ...) Với mỗi loại, Prisma sẽ có cách handle mà vẫn đảm bảo tính chặt chẽ.
Ở đây mình sẽ sử dụng Local Database để tạo Database. Các bạn cũng có thể sử dụng demo server. Xem hướng dẫn tại đây.
Sử dụng demo Server sẽ dễ dàng hơn cho việc cài đặt và cấu hình. Nhưng mình vẫn ưu tiên sự ổn định và tốc độ nên mình sẽ quyết định sử dụng local
Về cơ bản thì việc sử dụng Local Database hay Demo Database đều sẽ trả về một PRISMA_ENDPOINT để chúng ta có thể kết nối với GraphQL Server.
Open Terminal, đầu tiên là install Prisma:
npm install -g prisma
Install Docker: Để sử dụng Prisma locally, chúng ta bắt buộc phải install Docker. Các bạn có thể download Docker Community Edition ở đây.
Tạo Docker Image, tại root folder:
touch docker-compose.yml
Mình sử dụng MySQL, docker image của MySQL, paste đoạn code này vào file docker-compose.yml
.
version: '3'
services:
prisma:
image: prismagraphql/prisma:1.28
restart: always
ports:
- "4466:4466"
environment:
PRISMA_CONFIG: |
port: 4466
databases:
default:
connector: mysql
host: mysql
port: 3306
user: root
password: prisma
migrations: true
mysql:
image: mysql:5.7
restart: always
environment:
MYSQL_ROOT_PASSWORD: prisma
volumes:
- mysql:/var/lib/mysql
volumes:
mysql:
Build image:
docker-compose up -d
Init Prisma:
prisma init --endpoint http://localhost:4466
Prisma init sẽ khởi tạo ra 2 file:
datamodal.prisma
: File này sẽ chứa toàn bộ Schema. Ở đây Prisma cho chúng ta một SchemaUser
có sẵn. Chẳng hạn mình sẽ add thêm 1 Schema nữa đặt tên làPost
.
type Post {
id: ID! @unique
title: String!
content: String!
author: User!
createdAt: DateTime!
updatedAt: DateTime!
}
type User {
id: ID! @unique
name: String!
email: String!
posts: [Post!]!
}
prisma.yml
: File này sẽ chứa các configuration cần thiết để deploy lên Prisma Server bao gồm endpoint, datamodal, hooks, generate, etc.. (chúng ta sẽ cùng nhau đi tìm hiểu chi tiết ở những phần sau).
OK giờ có thể deploy đc rồi
prisma deploy
Truy cập http://localhost:4466
và thao tác một số câu Query
và Mutation
:
KHởi tạo Mutation
có tên là createUser
.
Ở bên phải Prisma
đã generate cho chúng ta toàn bộ Documentation và Schema mà chúng ta vừa tạo. Cùng với đó là những operation cơ bản READ, CREATE, UPDATE, DELETE.
Xem toàn bộ list các users:
query getUsersList {
users {
id
name
email
}
}
Tiếp theo là Tạo 1 Post
với và connect với User
vừa tạo thông qua id
. Execute mutation createPost
mutation createPost {
createPost(
data: {
title:"Learn GraphQL"
content:"Create GraphQL using Prisma"
author: {
connect: {id:"cjti9k0lj001z0803x8fkumge"}
}
}
) {
id
title
content
author{
name
}
createdAt
updatedAt
}
}
Nếu chúng ta muốn view và edit những dữ liệu trong Database thì có thể vào Prisma Admin thông qua URL: http://localhost:4466/_admin
Oke. Done. Giờ nếu chúng ta muốn thao tác với Prisma thông qua code thì sao nhỉ :?
Generate Prisma Client:
Paste đoạn code này vào prisma.yml
, dưới endpoint
và datamodel
endpoint: http://localhost:4466
datamodel: datamodel.prisma
generate:
- generator: javascript-client
output: ./generated/prisma-client/
Run
prisma generate
Khi này Prisma sẽ generate cho chúng ta 1 folder ./generated/prisma-client/
chứa tất cả những operation dựa trên file datamodel.prisma
.
Building simple Node application
touch index.js
Init package.json
file và install prisma-client-lib
(thư viện này sẽ giúp chúng ta sử dụng với Prisma Client vừa mới được generate bên trên)
npm init -y
npm install --save prisma-client-lib
Oke, let's write some code
index.js
const { prisma } = require('./generated/prisma-client')
async function main() {
// Create a new user
const newUser = await prisma.createUser({ name: 'Thuan', email: 'thuan@gmail.com' })
console.log(`Created new user: ${newUser.name} (ID: ${newUser.id}), (Email: ${newUser.email})`)
// Read all users from the database and print them to the console
const allUsers = await prisma.users()
console.log(`Users List`, JSON.stringify(allUsers, null, 2))
// Create a new Post and connect to user.
const newPost = await prisma.createPost({
title: 'GraphQL post',
content: 'GraphQL is awesome',
author: {
connect: { id: newUser.id }
}
})
console.log(`Created new post: `, JSON.stringify(newPost, null, 2))
}
main().catch(e => console.error(e))
Run Node app,
node index.js
Và đây là kết quả, chúng ta cũng có thể kiểm tra trong Prisma Admin (http://localhost:4466/_admin
)
Kết luận
Vậy là ở phần này chúng ta đã khởi tạo Database thành công. Phần tiếp theo chúng ta sẽ cùng đi xây dựng những function cơ bản cho Forum.
Các bạn có thể download source code ở đây Github
Happy Coding!
All rights reserved