Node.js / 2024-03-30

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 구문을 사용하였고, 모든 작업이 완료된 후에는 반드시 데이터베이스 연결을 종료하여 리소스 누수를 방지하는 것이 좋습니다.

실행 결과 화면

데이터베이스 연결 및 데이터 조회 하기 예제 코드 실행 결과 화면

참고 사이트

더 자세한 정보와 고급 기능에 대해서는 다음 사이트를 참조하세요.

이 가이드를 통해 Node.js 애플리케이션에서 MariaDB 데이터베이스에 연결하고 데이터를 쉽게 조회할 수 있습니다.

관련 이전 게시글

이 글이 도움이 되셨다면 공유 부탁 드립니다.