본문 바로가기
C_C++

C++ : mariaDB C/C++ Connector 설치하기

by taekho 2026. 4. 30.

 

1. C/C++에서 mariaDB Server 데이터베이스을 사용하려면 mariaDB Connector를 설치해야한다.

 

2. mariaDB Connector 사이트에 접속한다.

https://mariadb.com/downloads/connectors/

 

Download MariaDB Products & Tools | MariaDB

Download MariaDB products, connectors, and tools including Community Server, Enterprise Server, ColumnStore and MaxScale.

mariadb.com

 

3. C/C++ Connector를 선택후 다운로드한다.

 

4. 환경변수에 mariaDB 설치 디렉토리를 등록한다.

MARIADB_DIR로 등록한 경우

 

5. Visual Studio Community에서 테스트용 프로젝트를 생성한다.(빈 프로젝트 템플릿 선택)

 

6. main.cpp 파일 추가

 

7. 프로젝트에 mariaDB 관련 설정을 한다.

7.1 [프로젝트 속성 페이지]를 연다.

7.2 C/C++ 속성에서 [추가 포함 디렉토리]를 설정한다.

 

7.3 링커 속성에서 [추가 라이브러리 디렉토리]를 설정한다.

 

7.4 링커 속성에서 [입력]에서 [추가 종속성]을 설정한다.

 

 

7.5 mariadbcpp.dll 파일을 실행 파일 폴더에 복사한다.

 

8. main.cpp에 아래의 코드를 입력하여 실행되면 mariaDB C/C++ Connector가

    정상적으로 설정 된 것이다.

#include <iostream>
#include <mariadb/conncpp.hpp>

int main() {
    try {
        sql::Driver* driver = sql::mariadb::get_driver_instance();                
        const std::string host = "jdbc:mariadb://localhost:3306"; 
        const std::string database = "database";
        const std::string user = "user";
        const std::string pwd = "password";

        std::unique_ptr<sql::Connection> conn{driver->connect( host, user, pwd)};
        conn->setSchema(database);
        std::cout << "Connected Successfully.." << std::endl;
        conn->close();
    }
    catch (sql::SQLException& e) {
        std::cerr << "Error: " << e.what() << std::endl;
        return 1;
    }

    return 0;
}

 

9. Windows Console에서 한글 깨짐 방지하려면 수정이 필요합니다.

#include <iostream>
#include <mariadb/conncpp.hpp>
#include <windows.h>

int main() {
    try {
        sql::Driver* driver = sql::mariadb::get_driver_instance();                
        const std::string host = "jdbc:mariadb://localhost:3306"; 
        const std::string database = "database";
        const std::string user = "user";
        const std::string pwd = "password";

        std::unique_ptr<sql::Connection> conn{driver->connect( host, user, pwd)};
        conn->setSchema(database);
        std::cout << "Connected Successfully.." << std::endl;
        
    	SetConsoleOutputCP(CP_UTF8);
     
        // 데이터 조회 코드
        std::cout << u8"데이터 조회 성공" << std::endl; 

        // 데이터 입력 코드
        std::cout << u8"데이터 삽입 성공" << std::endl; 
    
        conn->close();
    }
    catch (sql::SQLException& e) {
        std::cerr << "Error: " << e.what() << std::endl;
        return 1;
    }

    return 0;
}

 

* 참고

vcpkg를 이용하여 설치하는 방법도 있습니다.

1. vcpkg 설치.

2. vcpkg install mariadb-connector-cpp:x64-windows