NodeJS 101 — 파트 2 MySQL

발행: 14시간 전 (2026년 1월 8일 오후 01:04 GMT+9)

9 min read

원문: Dev.to

Source: Dev.to

위에 제공된 소스 링크 외에 번역할 텍스트가 포함되어 있지 않습니다. 번역을 원하는 전체 내용을 제공해 주시면 한국어로 번역해 드리겠습니다.

📖 서문

이 문서는 web service 또는 RESTful API 를 JavaScript (Node.js) 언어를 사용하여 프레임워크와 다양한 라이브러리와 함께 개발합니다.

🌐 Express – HTTP 프레임워크로 웹 서버를 생성합니다
🗄️ Sequelize – 데이터베이스 관리를 위한 ORM
💾 MySQL – 관계형 데이터베이스
🔧 POSTMAN – API 테스트 도구

📚 목차

Module 2: 💾 Basic API MySQL

Module 2: 💾 Basic API MySQL

Express와 MySQL 데이터베이스 연결 및 사용 방법을 배웁니다

⬆ 목차로 돌아가기

Section 2‑1 – 🚀 새 Express 및 MySQL 앱 만들기

⬆ 목차로 돌아가기

📁 새 프로젝트 만들기

폴더 demo-mysql 만들기
```
mkdir demo-mysql
```
demo-mysql 폴더로 이동
```
cd demo-mysql
```
⚠️ 주의: 원본 문서에 나와 있는 cd mkdir demo-mysql 명령은 잘못되었습니다. 폴더를 만든 후에는 cd demo-mysql을 사용해야 합니다
Node.js 애플리케이션 만들기
```
npm init -y
```
이 명령은 package.json 파일을 자동으로 생성합니다

📄 `index.js` 파일 만들기

const express = require('express');
const cors = require('cors');          // ✅ cors 패키지를 사용하고 require('express') 대신 사용
const PORT = process.env.PORT || 5000;
const app = express();

app.use(express.json());
app.use(express.urlencoded({ extended: true }));
app.use(cors());

app.listen(PORT, () => {
    console.log(`CORS enabled server listening on ${PORT}`);
});

⚠️ 주의: 기존 코드에서는 cors에 require('express')를 사용했는데 이는 올바르지 않습니다. require('cors')를 사용해야 합니다

📦 필요한 패키지 설치

주요 패키지

npm install express mysql2 cors --save

개발 의존성 – Nodemon

npm install -D nodemon

전역으로 설치하고 싶다면 (선택 사항)

npm install -g nodemon

📋 설치된 패키지

Package	Description
`express`	Node.js용 웹 프레임워크
`mysql2`	Node.js용 MySQL 클라이언트
`cors`	Cross‑Origin Resource Sharing을 처리하는 미들웨어
`nodemon`	파일 변경 시 서버 자동 재시작

Section 2‑2 – 🔌 MySQL 데이터베이스 연결

⬆ 목차로 돌아가기

📦 MySQL2 가져오기

다음 줄을 index.js 파일에 추가합니다

const mysql = require('mysql2');

🔌 MySQL 데이터베이스 연결

방법 1 – 상수 사용

const connection = mysql.createConnection({
    host: 'localhost',
    user: 'root',
    password: '',
    database: 'basic_api_express_db'
});

방법 2 – 환경 변수 사용 (추천) ⭐

const connection = mysql.createConnection({
    host: process.env.DB_HOSTNAME   || 'localhost',
    user: process.env.DB_USERNAME   || 'root',
    password: process.env.DB_PASSWORD || '',
    database: process.env.DB_DATABASE || 'basic_api_express_db'
});

💡 추천: 배포 시 보안과 유연성을 위해 방법 2를 사용하세요

📥 데이터베이스에서 데이터 가져오기 테스트

다음 코드를 index.js에 추가합니다

// Get all users
app.get('/users', (req, res) => {
    try {
        connection.query('SELECT * FROM `users`', (err, results) => {
            if (err) {
                return res.status(500).json({ message: "Database error", error: err });
            }
            res.status(200).json(results);
        });
    } catch (error) {
        res.status(400).json({ message: "Get users failed", error: error.message });
    }
});

// Get user by id
app.get('/users/:id', (req, res) => {
    try {
        const id = req.params.id;
        connection.query(
            'SELECT * FROM `users` WHERE `id` = ?',
            [id],
            (err, results) => {
                if (err) {
                    return res.status(500).json({ message: "Database error", error: err });
                }
                if (results.length === 0) {
                    return res.status(404).json({ message: "User not found" });
                }
                res.status(200).json({ payload: results });
            }
        );
    } catch (error) {
        res.status(400).json({ message: "Get user by id failed", error: error.message });
    }
});

🧪 API 테스트

GET http://localhost:5000/users
GET http://localhost:5000/users/1

Section 2‑3 – ➕ 사용자 생성

(내용이 아직 지정되지 않음 – 필요에 따라 코드와 설명을 추가하세요)

Section 2‑4 – ✏️ 사용자 업데이트

(내용이 아직 지정되지 않음 – 코드와 설명을 추가하세요)

Source: …

อธิบายต่อไปนี้ตามต้องการ)*

Section 2‑5 – 🗑️ DELETE USER

(เนื้อหายังไม่ได้ระบุ – ใส่โค้ดและคำอธิบายต่อไปนี้ตามต้องการ)

หมายเหตุ: หากต้องการเพิ่มส่วนของการสร้าง, แก้ไข, และลบผู้ใช้ ให้ทำตามรูปแบบของ GET /users และ GET /users/:id โดยใช้ INSERT, UPDATE, DELETE ผ่าน connection.query พร้อมจัดการ error handling อย่างเดียวกัน.

번역

다음은 필요에 따라 설명하십시오)*

Section 2‑5 – 🗑️ DELETE USER

(내용이 아직 지정되지 않음 – 필요에 따라 코드와 설명을 삽입하십시오)

참고: 사용자 생성, 수정, 삭제 부분을 추가하려면 GET /users 및 GET /users/:id 형식을 따라 INSERT, UPDATE, DELETE를 connection.query를 통해 사용하고 동일한 오류 처리 방식을 적용하십시오.

5000/users/1

Section 2‑3 – ➕ CREATE USER

⬆ 목차로 돌아가기

➕ 새 User 만들기

파일에 추가: index.js

app.post('/users', (req, res, next) => {
    try {
        const { fname, lname, username, password, avatar } = req.body;

        connection.query(
            'INSERT INTO `users`(`fname`, `lname`, `username`, `password`, `avatar`) VALUES (?, ?, ?, ?, ?)',
            [fname, lname, username, password, avatar],
            (err, results) => {
                if (err) {
                    return res.status(500).json({
                        message: "create user was failed",
                        error: err.message
                    });
                }
                res.status(201).json({
                    message: "create user was successfully",
                    payload: results
                });
            }
        );
    } catch (error) {
        res.status(400).json({
            message: "create user was failed",
            error: error.message
        });
    }
});

🔍 코드 설명

INSERT INTO – 데이터를 추가하는 SQL 명령
? – SQL 인젝션 방지를 위한 플레이스홀더
status(201) – 데이터 생성 성공을 나타내는 HTTP 상태 코드

🧪 API 테스트

POST http://localhost:5000/users
Content-Type: application/json

{
  "fname": "John",
  "lname": "Doe",
  "username": "johndoe",
  "password": "password123",
  "avatar": "https://example.com/avatar.jpg"
}

Section 2‑4 – ✏️ UPDATE USER

⬆ 목차로 돌아가기

✏️ User 데이터 업데이트

파일에 추가: index.js

app.put('/users/:id', (req, res, next) => {
    try {
        const id = req.params.id;
        const { fname, lname, username, password, avatar } = req.body;

        connection.query(
            'UPDATE `users` SET `fname`= ?, `lname`= ?, `username`= ?, `password`= ?, `avatar`= ? WHERE id = ?',
            [fname, lname, username, password, avatar, id],
            (err, results) => {
                if (err) {
                    return res.status(500).json({
                        message: "update user was failed",
                        error: err.message
                    });
                }
                if (results.affectedRows === 0) {
                    return res.status(404).json({
                        message: "User not found"
                    });
                }
                res.status(200).json({
                    message: "update user was successfully",
                    payload: results
                });
            }
        );
    } catch (error) {
        res.status(400).json({
            message: "update user was failed",
            error: error.message
        });
    }
});

🔍 코드 설명

UPDATE – 데이터를 업데이트하는 SQL 명령
affectedRows – 업데이트된 행 수 (0 = 데이터 없음)

🧪 API 테스트

PUT http://localhost:5000/users/1
Content-Type: application/json

{
  "fname": "Jane",
  "lname": "Doe",
  "username": "janedoe",
  "password": "newpassword123",
  "avatar": "https://example.com/new-avatar.jpg"
}

Section 2‑5 – 🗑️ DELETE USER

⬆ 목차로 돌아가기

🗑️ User 데이터 삭제

파일에 추가: index.js

app.delete('/users/:id', (req, res, next) => {
    try {
        const id = req.params.id;

        connection.query(
            'DELETE FROM `users` WHERE id = ?',
            [id],
            (err, results) => {
                if (err) {
                    return res.status(500).json({
                        message: "delete user was failed",
                        error: err.message
                    });
                }
                if (results.affectedRows === 0) {
                    return res.status(404).json({
                        message: "User not found"
                    });
                }
                res.status(200).json({
                    message: "dele

Source:

te user was successfully",
                    payload: results
                });
            }
        );
    } catch (error) {
        res.status(400).json({
            message: "delete user was failed",
            error: error.message
        });
    }
});

🔍 코드 설명

DELETE FROM – 데이터를 삭제하는 SQL 명령어
affectedRows – 삭제된 행 수 (0 = 데이터 없음)

🧪 API 테스트

DELETE http://localhost:5000/users/1

🎉 Module 2 요약

우리는 Express와 MySQL Database를 연결하고 CRUD Operations를 모두 사용하는 방법을 배웠습니다.

Method	Endpoint	Description
`GET`	`/users`	모든 사용자 데이터 조회
`GET`	`/users/:id`	ID에 해당하는 사용자 조회
`POST`	`/users`	새로운 사용자 생성
`PUT`	`/users/:id`	사용자 데이터 업데이트
`DELETE`	`/users/:id`	사용자 삭제

Reference

NodeJS 101 — 파트 2 MySQL

📖 서문

📚 목차

Module 2: 💾 Basic API MySQL

Section 2‑1 – 🚀 새 Express 및 MySQL 앱 만들기

📁 새 프로젝트 만들기

📄 `index.js` 파일 만들기

📦 필요한 패키지 설치

📋 설치된 패키지

Section 2‑2 – 🔌 MySQL 데이터베이스 연결

📦 MySQL2 가져오기

🔌 MySQL 데이터베이스 연결

📥 데이터베이스에서 데이터 가져오기 테스트

🧪 API 테스트

Section 2‑3 – ➕ 사용자 생성

Section 2‑4 – ✏️ 사용자 업데이트

Section 2‑5 – 🗑️ DELETE USER

Section 2‑5 – 🗑️ DELETE USER

5000/users/1

Section 2‑3 – ➕ CREATE USER

➕ 새 User 만들기

🔍 코드 설명

🧪 API 테스트

Section 2‑4 – ✏️ UPDATE USER

✏️ User 데이터 업데이트

🔍 코드 설명

🧪 API 테스트

Section 2‑5 – 🗑️ DELETE USER

🗑️ User 데이터 삭제

🔍 코드 설명

🧪 API 테스트

🎉 Module 2 요약

관련 글

나는 결국 모든 Express 컨트롤러에서 try-catch를 쓰는 것을 멈췄다 (당신도 그래야 합니다)

2026년에 Node 대신 Bun을 선택한 이유 (그리고 여러분도 그래야 하는 이유)

초보자를 위한 JavaScript DOM 설명

왜 setTimeout이 Node.js에서 객체를 반환하는가 (그리고 setInterval이 앱을 깨뜨릴 수 있는 이유)

📖 서문

📚 목차

Module 2: 💾 Basic API MySQL

Section 2‑1 – 🚀 새 Express 및 MySQL 앱 만들기

📁 새 프로젝트 만들기

📄 index.js 파일 만들기

📦 필요한 패키지 설치

📋 설치된 패키지

Section 2‑2 – 🔌 MySQL 데이터베이스 연결

📦 MySQL2 가져오기

🔌 MySQL 데이터베이스 연결

📥 데이터베이스에서 데이터 가져오기 테스트

🧪 API 테스트

Section 2‑3 – ➕ 사용자 생성

Section 2‑4 – ✏️ 사용자 업데이트

Section 2‑5 – 🗑️ DELETE USER

Section 2‑5 – 🗑️ DELETE USER

5000/users/1

Section 2‑3 – ➕ CREATE USER

➕ 새 User 만들기

🔍 코드 설명

🧪 API 테스트

Section 2‑4 – ✏️ UPDATE USER

✏️ User 데이터 업데이트

🔍 코드 설명

🧪 API 테스트

Section 2‑5 – 🗑️ DELETE USER

🗑️ User 데이터 삭제

🔍 코드 설명

🧪 API 테스트

🎉 Module 2 요약

관련 글

나는 결국 모든 Express 컨트롤러에서 try-catch를 쓰는 것을 멈췄다 (당신도 그래야 합니다)

2026년에 Node 대신 Bun을 선택한 이유 (그리고 여러분도 그래야 하는 이유)

초보자를 위한 JavaScript DOM 설명

왜 setTimeout이 Node.js에서 객체를 반환하는가 (그리고 setInterval이 앱을 깨뜨릴 수 있는 이유)

📄 `index.js` 파일 만들기