[Qt5] MySQL(MariaDB) Driver 인식 시키기 ( 윈도우 환경 )

QT에서 SqlDatabase 를 사용하여 다양한 DB를 지원한다.
기본적으로 SQLite 를 지원하지만 MariaDB나 MySQL 을 사용하기 위해 드라이버 설치를 해주어야 한다.
이 드라이버를 설치 하기 위해서는 QT를 설치시 Source 도 함께 설치 되어야만 한다.

MySQL 드라이버 인식 관련 QT 문서 주소는 다음과 같다.
https://doc.qt.io/qt-5/sql-driver.html

먼저 MySQL 또는 MariaDB 를 설치 한다.
https://dev.mysql.com/downloads/c-api/

그리고
C:\Qt\5.15.2\Src\qtbase\src\plugins\sqldrivers
폴더에서 qmake 실행 한다.

참고로 컴파일러 경로와 mingw32-make 폴더의 경로는 이미 설정이 되어 있어야 한다.

C:\Qt\Tools\mingw810_64\bin // For mingw32-make 설정
C:\Qt\5.15.2\mingw81_64\bin // qmake 경로 설정

qmake -- MYSQL_INCDIR="D:/work/mysql_x64/include" MYSQL_LIBDIR="D:/work/mysql_x64/lib"
실행 한다.
여기서 설치 파일이 D:/mysql_x64 폴더인 경우이다.

이때 MySQL에 no 가 나오면 해당 폴더의 config.cache 파일을 제거 하고 다시 실행 한다.
참고로 관련 로그는 config.log 파일을 확인 한다.

C:\Qt\5.15.2\Src\qtbase\src\plugins\sqldrivers>qmake -- MYSQL_INCDIR="D:/work/mysql_x64/include" MYSQL_LIBDIR="D:/work/mysql_x64/lib"

Running configuration tests...
Checking for DB2 (IBM)... no
Checking for InterBase... no
Checking for MySQL... yes
Checking for OCI (Oracle)... no
Checking for ODBC... yes
Checking for PostgreSQL... no
Checking for SQLite (version 2)... no
Checking for TDS (Sybase)... no
Done running configuration tests.

Configure summary:

Qt Sql Drivers:
  DB2 (IBM) .............................. no
  InterBase .............................. no
  MySql .................................. yes
  OCI (Oracle) ........................... no
  ODBC ................................... yes
  PostgreSQL ............................. no
  SQLite2 ................................ no
  SQLite ................................. yes
    Using system provided SQLite ......... no
  TDS (Sybase) ........................... no

Qt is now configured for building. Just run 'mingw32-make'.
Once everything is built, you must run 'mingw32-make install'.
Qt will be installed into 'C:\Qt\5.15.2\mingw81_64'.

Prior to reconfiguration, make sure you remove any leftovers from
the previous build.

그리고 나서 다음 명령어를 식행 한다.

mingw32-make
mingw32-make install

실제 mysql 드러이브 적용은 C:\Qt\5.15.2\mingw81_64\plugins\sqldrivers 폴더에 qsqlmysql.dll 과 qsqlmysql.dll.debug 를 복사 해준다.

그리고 설치한 libmysql.dll 과 libmysql.lib 파일을 컴파일러가 있는 경로의 bin 폴더에 복사해 준다.
C:\Qt\5.15.2\mingw81_64\bin 폴더에 복사해 주어야 한다.

그리고 실제 적용은 deploy 명령을 실행시 sqldrivers 에 복사 하기 때문에 설치 전에 deploy를 했으면 수동으로 복사해 주어야 한다.

Mysql 드라이버가 설치가 되면 MariaDB 와 MySQL 모두 드라이버 목록에 나타난다.

MySQL 드라이버 설치후 목록이다 ( QSqlDatabase::drivers() 이용 )

0 : QSQLITE
1 : QMARIADB
2 : QMYSQL
3 : QMYSQL3
4 : QODBC
5 : QODBC3
6 : QPSQL
7 : QPSQL7

참고로 QSqlDatabase 를 사용하기 위해서는 해당 라이브러리 파일만 있으면 인식이 가능하다.
실행 파일의 sqldrivers 폴더에 qsqlmysql.dll 파일을 그냥 복사해서 사용하면 된다.
물론 qsqlmysql.dll 을 사용하기 위해서는 libmysql.dll 파일도 실행 파일 경로에 있어야 한다.

 

MACOS MySQL 드라이버 설치

Here is a short torurial:

1. install mysql via homebrew: $ brew install mysql
2. install Qt Source (I install Qt into default path -- my $HOME directory /Users/liuhao) https://doc.qt.io/qt-5/gettingstarted.html
3. open Terminal and change path to /Users/liuhao/Qt/5.15.2/Src/qtbase/src/plugins/sqldrivers
4. run /Users/liuhao/Qt/5.15.2/clang_64/bin/qmake -- MYSQL_PREFIX=/usr/local/Cellar/mysql (watch out for the spaces around --) and you will get some messages like:

$ /Users/liuhao/Qt/5.15.2/clang_64/bin/qmake  -- MYSQL_PREFIX=/usr/local/Cellar/mysql

Running configuration tests...
Done running configuration tests.

Configure summary:

Qt Sql Drivers:
  DB2 (IBM) .............................. no
  InterBase .............................. no
  MySql .................................. yes
  OCI (Oracle) ........................... no
  ODBC ................................... no
  PostgreSQL ............................. no
  SQLite2 ................................ no
  SQLite ................................. yes
    Using system provided SQLite ......... no
  TDS (Sybase) ........................... no

Qt is now configured for building. Just run 'make'.
Once everything is built, you must run 'make install'.
Qt will be installed into '/Users/liuhao/Qt/5.15.2/clang_64'.

Prior to reconfiguration, make sure you remove any leftovers from
the previous build.

1. $ make sub-mysql and then you can find new mysql driver dylib files in /Users/liuhao/Qt/5.15.2/Src/qtbase/src/plugins/sqldrivers/plugins/sqldrivers

$ ls -alh /Users/liuhao/Qt/5.15.2/Src/qtbase/src/plugins/sqldrivers/plugins/sqldrivers
total 3360
drwxr-xr-x  6 liuhao a   192B Aug 20 18:29 .
drwxr-xr-x  3 liuhao a    96B Aug 20 16:17 ..
-rwxr-xr-x  1 liuhao a   1.5M Aug 20 18:24 libqsqlite.dylib
drwxr-xr-x  3 liuhao a    96B Aug 20 18:23 libqsqlite.dylib.dSYM
-rwxr-xr-x  1 liuhao a    94K Aug 20 18:29 libqsqlmysql.dylib
drwxr-xr-x  3 liuhao a    96B Aug 20 16:17 libqsqlmysql.dylib.dSYM

1. copy it to /Users/liuhao/Qt/5.15.2/clang_64/plugins/sqldrivers/ and you will be able to use it in qt project.

foreach (QString driver, QSqlDatabase::drivers ())
{
    qDebug() << driver;
}
/*
available drivers
...
"QMARIADB"
"QMYSQL"
"QMYSQL3"
...
*/