Node.js에서 MariaDB 데이터베이스 연결 및 데이터 조회 방법
Node.js 애플리케이션에서 MariaDB 데이터베이스에 연결하고 데이터를 조회하는 방법에 대해 알아보겠습니다. MariaDB와의 비동기 통신을 가능하게 하는 mysql
패키지를 사용합니다.
필요한 패키지 설치
먼저, mysql
패키지를 설치합니다. 이 패키지는 Node.js에서 MySQL 및 MariaDB 데이터베이스와의 연결을 관리합니다. 터미널 또는 명령 프롬프트에서 다음 명령어를 실행하여 설치할 수 있습니다.
npm install mariadb
데이터베이스 연결 및 데이터 조회 하기
사용 예제 코드
// Express와 MariaDB 모듈을 불러옵니다.
const express = require('express');
const mariadb = require('mariadb');
// Express 애플리케이션을 생성합니다.
const app = express();
const port = 3000;
// MariaDB 연결 풀을 생성합니다. 이는 데이터베이스 연결을 관리하는 데 사용됩니다.
const pool = mariadb.createPool({
host: 'localhost', // 데이터베이스 서버의 호스트 이름
user: 'blueshare', // 데이터베이스 사용자 이름
password: '1111', // 사용자 비밀번호
database: 'study', // 사용할 데이터베이스 이름
port: 3307, // 데이터베이스 서버의 포트 번호 (기본 포트 3306인 경우에는 생략 가능)
connectionLimit: 5 // 연결 풀에서 유지할 최대 연결 수
});
// 루트 URL ('/')에 대한 GET 요청을 처리합니다.
app.get('/', async (req, res) => {
let conn;
try {
// 데이터베이스 연결을 풀에서 가져옵니다.
conn = await pool.getConnection();
// EMP 테이블에서 EMP_NO가 'A0001'인 직원의 정보를 조회합니다.
const rows = await conn.query("SELECT EMP_NO, NAME FROM EMP WHERE EMP_NO = 'A0001'");
// 조회 결과를 JSON 문자열로 변환하여 응답으로 보냅니다.
res.send(`조회 결과: ${JSON.stringify(rows)}`);
} catch (err) {
// 오류가 발생한 경우, 콘솔에 오류 메시지를 출력하고 클라이언트에 오류 메시지를 보냅니다.
console.error('오류 발생:', err);
res.status(500).send(`오류 발생: ${err.message}`);
} finally {
// 작업이 완료된 후, 연결을 종료합니다.
if (conn) conn.end();
}
});
// 지정된 포트에서 서버를 시작합니다. 서버가 시작되면 콘솔에 메시지를 출력합니다.
app.listen(port, () => {
console.log(`Server is running on port ${port}`);
});
- 위의 예제 코드는 기본적인 데이터 조회 작업을 수행하는 간단한 예시를 보여줍니다. 특정 사용자의 정보를 조회하는 쿼리를 실행하여 결과를 JSON 형식으로 웹 페이지에 출력하는 과정을 통해, Node.js에서 MariaDB 데이터베이스를 활용하는 방법을 알 수 있습니다. 이 예제는 Node.js 및 Express 애플리케이션 개발에 있어 데이터베이스와의 상호작용을 알 수 있습니다.
- 데이터베이스와의 연결 및 쿼리 실행 과정에서 발생할 수 있는 오류를 관리하는 방법도 중요합니다. 위 코드에서는 연결 시도 중 발생할 수 있는 예외를 처리하기 위해
try...catch
구문을 사용하였고, 모든 작업이 완료된 후에는 반드시 데이터베이스 연결을 종료하여 리소스 누수를 방지하는 것이 좋습니다.
실행 결과 화면
![데이터베이스 연결 및 데이터 조회 하기 예제 코드 실행 결과 화면](https://bluesharehub.com/wp-content/uploads/2024/03/image-79.png)
![데이터베이스 연결 및 데이터 조회 하기 예제 코드 실행 결과 화면](https://bluesharehub.com/wp-content/uploads/2024/03/image-79.png)
참고 사이트
더 자세한 정보와 고급 기능에 대해서는 다음 사이트를 참조하세요.
이 가이드를 통해 Node.js 애플리케이션에서 MariaDB 데이터베이스에 연결하고 데이터를 쉽게 조회할 수 있습니다.
관련 이전 게시글
- Node.js 서버 생성 및 실행하는 방법
- Express 기본 라우팅: GET과 POST 요청 처리하는 방법
- Node.js 기반에서 Express를 활용한 기본 웹 서버 구축하는 방법
- Express에서 라우터를 사용하여 애플리케이션 구조화 방법
- Express 요청 데이터 파싱: 내장 메서드와 body-parser 미들웨어
이 글이 도움이 되셨다면 공유 부탁 드립니다.