🎯 MySQL Workbench를 설치하고, 기존 코드에 DB를 연동합니다.

📙 Today I Learned

MySQL Workbench 설정

MySQL Workbench

MySQL을 쉽게 관리할 수 있도록 도와주는 프로그램 (MySQL 전용 GUI 도구)입니다.

🤔 왜 사용할까?
SQL 쿼리를 편하게 입력하고 실행 가능하고, 엑셀처럼 GUI로 쉽게 다룰 수 있도록 해주기 때문입니다.

👉 MySQL Workbench 공식 다운로드 페이지

---

MySQL Workbench 설치 과정

• MySQL Workbench 공식 사이트에서 운영체제에 맞는 Installer를 다운로드 버튼을 클릭합니다.
  

• 회원가입 없이 다운로드할 수 있습니다.
  

• 설정 유형을 Custom으로 선택하고 Next >를 눌러줍니다.
  

• 설치할 Server, Workbench, Shell의 버전을 골라 옮겨주고 Next >를 눌러줍니다.

  • MySQL Server : 데이터베이스를 관리하고 실행하는 핵심 서버 소프트웨어
  • MySQL Workbench : 데이터베이스를 시각적으로 설계, 관리, 쿼리 실행 등을 할 수 있는 GUI 도구
  • MySQL Shell : MySQL을 관리하고 스크립트를 실행할 수 있는 CLI(Command Line Interface)

  

• 설치 프로그램을 확인하고 Execute를 눌러 설치해줍니다.
  

• 설치가 완료되면 Next >를 눌러줍니다.
  

• 환경 설정에 대한 안내를 확인하고 Next >를 눌러줍니다.
  

---

🚨 port 오류 발생 및 해결

⚠️ 발생한 오류
서버 연결 포트에 The specific port is already in use 오류가 발생하였습니다.
해당 포트 번호가 이미 사용 중이기 때문에 사용하지 못 한다는 의미였습니다.

💡 해결 과정 ( Windows 해결 방법 )

1️⃣ 포트넘버에 해당하는 네트워크 상태 요청

netstat -ano | findstr :<포트넘버>

2️⃣ 해당 포트에서 사용 중인 프로세스 강제 종료

taskkill /PID <프로세스ID> /F

---

• Config Type 및 TCP/IP, 포트 번호(3306)를 기본으로 설정해줍니다.

🤔 방화벽 해제는 왜 필요할까?

방화벽은 네트워크 보안을 위해 외부 접근을 차단하는 역할을 합니다. 하지만 다른 컴퓨터에서 MySQL 서버에 원격으로 접속하기 위해 방화벽이 이를 차단하지 않도록 설정해야 합니다.

• 인증 방식을 선택하여 Next >를 눌러줍니다.

  • 강렬한 비밀번호 암호화 방식 (✅ 추천)

    • ⚠️ 만약 사용 중인 애플리케이션이나 데이터베이스 드라이버가 이 방식을 지원하지 않으면, MySQL 서버에 연결하는 데 문제가 생길 수 있습니다.

    • 최신 보안 방식을 사용하여 비밀번호를 더 안전하게 보호합니다.

  • 옛날 인증 방식 사용 (구버전 호환 유지)

    • 애플리케이션, 클라이언트, 드라이버와의 연동이 수월합니다.
    • 레거시 시스템과의 호환성이 중요한 경우 선택하는 것이 좋습니다.

  

• root 계정의 비밀번호를 설정합니다.

  (계정을 추가할 수 있지만 개인으로 사용할 것이기 때문에 추가하지 않겠습니다.)

  

• MySQL Server를 Window Service로 등록하기 위한 설정도 기본값으로 두고 Next >를 눌러줍니다.

  (기본 서비스 이름이 MySQL80인 이유는 MySQL 5.x를 이미 사용하는 경우, "MySQL"이라는 이름이 충돌할 수 있기 때문에 8.0이라는 것을 명시하기 위함입니다.)

  

• 서버 파일 권한 설정 옵션을 선택한 후 Next >를 눌러줍니다.

  • windows 서비스 사용자와 관리자 그룹에 한해서 전체 엑세스 권한을 부여(✅ 추천)

  • 권한 레벨을 검토하고 구성할 수 있도록 설정

  • 서버 구성 후 권한을 관리

  

• Execute 버튼을 눌러 각 항목 설정을 완료합니다.
  

• Finish 버튼을 눌러 설정을 마칩니다.
  

• 설치가 완료되었습니다. Finish 버튼을 눌러 작업을 마칩니다.
  

---

MySQL Workbench 사용

MySQL Connection

(🐋도커를 실행한 상태에서 진행해야 합니다.)

• + 버튼을 눌러 Database와 연결을 해줍니다.
  

• 이름을 적어주고, OK 버튼을 눌러 완료해줍니다.
  

• 비밀번호를 적고 OK 버튼을 눌러 입장합니다.
  

• 생성한 파일에 들어가 Query 탭에 명령문을 입력하고 위의 번개(실행)⚡버튼을 눌러 명령문을 실행시킵니다.
  

---

MySQL Workbench로 DB 연동

• 새로 publisher_community 스키마를 만든 후 Apply 버튼을 눌러줍니다.
  

• 명령어를 확인해주고 Apply 버튼을 눌러줍니다.
  

측면 네비게이터탭에서 우클릭을 통해 스키마를 생성하여 줍니다.

---

지난번 만들었던 테이블을 수정하여 이를 데이터 테이블로 생성하겠습니다.

📖 작가 테이블 (authors)

번호(id)	작가명	구독자 수	책 수	user_id
1	조정래	100	10	1
2	김훈	20	20	2
3	한강	500	10	3
4	신경숙	100	10	1
5	황석영	200	15	3
6	최은영	300	5	1
7	윤이형	150	7	3

🏢 출판사 회원 테이블 (users)

회원 ID	출판사	비밀번호	연락처	이메일
1	문학동네	1111	031-955-8888	contact@munhak.com
2	민음사	2222	02-515-2000	info@minumsa.com
3	창비	3333	02-3780-0700	support@changbi.com

---

• users 테이블 생성한 후 Apply 버튼을 눌러줍니다.
  

  🤔 하단 Auto Increment가 비활성일 때

  위 체크박스와 아래 체크박스는 같은 것이기 때문에 위에 AI(Auto Increment) 체크버튼✅을 눌러줍니다.

• users 테이블 명령어를 확인해주고 Apply 버튼을 눌러줍니다.
  

• authors 테이블을 생성한 후 FK키를 생성하기 위해 하단의 Foreign Keys 탭을 눌러줍니다.
  

• 참조할 테이블을 선택한 후, 참조하는 테이블과 참조되는 테이블의 칼럼을 지정하고 Apply 버튼을 클릭합니다.
  

• authors 테이블 명령어를 확인해주고 Apply 버튼을 눌러줍니다.
  

  INDEX : user_id 컬럼에 대해 ASC(오름차순) 정렬로 인덱스를 생성합니다.

  CONSTRAINT : user_id 컬럼에 대해 제약 조건을 설정합니다.

  ON DELETE NO ACTION : users 테이블의 id가 삭제될 경우 authors 테이블에서 해당 user_id가 영향을 받지 않습니다.

  ON UPDATE NO ACTION : users 테이블의 id가 변경되더라도 authors 테이블의 user_id는 변경되지 않습니다.

• users 테이블에 값을 넣기 위해 표 아이콘을 선택한 후 insert rows 아이콘을 선택하여 값을 넣어주고 Apply 버튼을 눌러줍니다.
  

• users 테이블 INSERT 명령어를 확인해주고 Apply 버튼을 눌러줍니다.
  

• authors 테이블에 값을 넣기 위해 표 아이콘을 선택한 후 insert rows 아이콘을 선택하여 값을 넣어주고 Apply 버튼을 눌러줍니다.
  

• authors 테이블 INSERT 명령어를 확인해주고 Apply 버튼을 눌러줍니다.
  

칼럼 추가해주기

• 테이블 표에 스패너 도구🔧를 선택해서 칼럼을 추가해줍니다.
  

---

코드 DB 연동하기

mysql2 라이브러리 설치

npm install —save mysql2

코드 DB를 연동하기 위해서 mysql2 라이브러리를 설치해줍니다.

mysql2 예시 코드 출력

예시 코드를 활용하여 코드를 작성합니다.

// Get the client
const mysql = require('mysql2');

// Create the connection to database
const connection = mysql.createConnection({
  host: 'localhost',
  user: 'root',
  password: 'root',
  database: 'publisher_community',
});

// A simple SELECT query
connection.query('SELECT * FROM `users` ', function (err, results, fields) {
  console.log(results); // results contains rows returned by server
  console.log(fields); // fields contains extra meta data about results, if available
});

출력된 result와 fields 값을 확인합니다.

---

timezone 문제 해결

설정한 users의 값을 불러옵니다.

connection.query('SELECT * FROM `users` ', function (err, results, fields) {
  let { id, password, email, created_at } = results[0];
  console.log(id, password, email, created_at);
});

🤔 문제 1
코드를 통해 받은 created_at의 시간과 Workbench에 설정된 시간이 다르다는 것을 확인할 수 있습니다. (DB 시간 ≠ 코드 출력 시간)

💡 해결 1
timezone 명령문을 통해 통일해줍니다.

SET GLOBAL time_zone = 'Asia/Seoul';

코드 출력 결과 시간 값이 변경된 것을 확인할 수 있습니다.

🤔 문제 2
현재 시간과 9시간의 오차가 발생합니다.

💡 해결 2
1️⃣ Global Timezone과 Session(DB) Timezone을 확인합니다.
SELECT @@global.time_zone, @@session.time_zone;

2️⃣ 현재 DB의 timezone이 설정이 안되어 있으므로 한국 시간으로 설정해줍니다.
SET time_zone = 'Asia/Seoul';

3️⃣ 변경된 Timezone 확인하면 시간이 일치하는 것을 확인할 수 있습니다.

dateStrings : true 설정을 추가한 후 다시 코드를 확인하면 시간이 모두 한국시간으로 일치하는 것을 확인할 수 있습니다.

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

---

API 설계

설정했던 API를 다시 DB를 반영하도록 수정하였습니다.

회원 API 설계

• 로그인 : POST /login

  • request: body(email, password)

  • response: ${name}님 환영합니다 ⇒ 메인 페이지로 이동

• 회원 가입 : POST /join

  • request: body(email, name, password, contact)

  • response: ${name}님 환영합니다 ⇒ 로그인 페이지로 이동

• 회원 개별 조회 : GET /users

  • request: body(email)

  • response: id, name

• 회원 개별 탈퇴 : DELETE /users

  • request: body(email)

  • response: ${name}님 다음에 또 뵙겠습니다. ⇒ 메인 페이지로 이동

주황글씨 : 변경사항

---

작가 채널 API 설계

• 작가 생성 : POST /authors

  • request : body (name, user_id)

  • response : 201 Created ${name}님의 작가 생활을 응원합니다. -> 작가 관리 페이지

• 작가 수정 : PUT /authors/:id

  • request: URL (id), body(name)

  • response : 200 Ok 작가이름이 성공적으로 수정되었습니다. 기존${} => 수정 ${}

• 작가 개별 삭제 : DELETE /authors/:id

  • request: URL(id)

  • response : 200 Ok ${name}님이 삭제 되었습니다. => 메인 페이지

• 작가 전체 조회 : GET /authors

  • request: body (user_id)
  • response : 200 Ok 작가 전체 데이터 list, json array

• 작가 개별 조회 : GET /authors/:id

  • request: URL(id)

  • response : 작가 개별 데이터

주황글씨 : 변경사항

---

✏️ 한 줄 회고

설치 과정에서 포트 충돌 오류가 발생했지만, 기존 해결 방법을 적용하여 수월하게 해결할 수 있었고, 기록의 중요성에 대해 깨닫게 된 하루였습니다.