qt-sql-example/README.md

# Qt SQL Example

An exemplary [Qt](https://www.qt.io/) app that connects to SQL server and displays a table from a database. The program was made for educational purposes.

Compiled Windows and Linux applications with statically-linked libraries can be downloaded from [Releases](https://github.com/andre-wojtowicz/qt-sql-example/releases).

![](screenshot.png)

The application is developed with Qt 5.9.1 on Windows 10 and Ubuntu 16.04.
The program was tested on MySQL Server 5.5.57 and Microsoft SQL Server 2008 R2 SP3.

## Client config

The program reads `config.ini` on startup. The file must be in the app working directory.

## SQL database drivers

A comprehensive discussion about SQL database drivers (Qt driver plugins as well as system drivers) can be found in [Qt Documentation](https://doc.qt.io/qt-5/sql-driver.html). MSSQL is handled by the ODBC driver.

Although binaries of the program have statically-linked libraries, in order to connect from Linux to MSSQL server, one should install ODBC SQL Server driver (e.g. `msodbcsql17`__*__).

The following section covers the essential tools to develop app with dynamically-linked SQL libraries.

### Windows 10

* Both Qt SQL driver plugins (QMYSQL and QODBC) should be already bundled with Qt SDK.
* MySQL driver can be *installed* by placing `libmysql.dll` from [C API for MySQL (mysqlclient)](https://dev.mysql.com/downloads/connector/c/) in the app working directory.
* ODBC Driver Manager and SQL Server driver are built in; hence, no further installation is necessary. Alternatively, instead of SQL Server driver, one can use Microsoft ODBC Driver; see [Microsoft Docs](https://docs.microsoft.com/en-us/sql/connect/odbc/windows/microsoft-odbc-driver-for-sql-server-on-windows).

### Ubuntu 16.04

Packages with Qt driver plugins and system SQL drivers:

* MySQL - `libqt5sql5-mysql` `libmysqlclient20`,
* ODBC ([unixODBC Driver Manager](http://www.unixodbc.org) and Microsoft ODBC Driver) - `libqt5sql5-odbc` `libodbc1` `unixodbc` `odbcinst` `msodbcsql17`__*__.

__*__ How to install `msodbcsql17` - [Installing the Microsoft ODBC Driver for SQL Server on Linux and macOS](https://docs.microsoft.com/en-us/sql/connect/odbc/linux-mac/installing-the-microsoft-odbc-driver-for-sql-server).
Update README.md 2017-09-01 23:02:10 +02:00			`# Qt SQL Example`
Added project files 2017-09-01 22:53:26 +02:00
Minors for linux compatibility; Updated readme 2017-09-02 23:11:10 +02:00			`An exemplary [Qt](https://www.qt.io/) app that connects to SQL server and displays a table from a database. The program was made for educational purposes.`
Added project files 2017-09-01 22:53:26 +02:00
Update README.md 2017-09-05 00:22:08 +02:00			`Compiled Windows and Linux applications with statically-linked libraries can be downloaded from [Releases](https://github.com/andre-wojtowicz/qt-sql-example/releases).`
Updated readme 2017-09-03 01:12:55 +02:00
Added project files 2017-09-01 22:53:26 +02:00			`![](screenshot.png)`

Update README.md 2017-09-05 00:22:08 +02:00			`The application is developed with Qt 5.9.1 on Windows 10 and Ubuntu 16.04.`
			`The program was tested on MySQL Server 5.5.57 and Microsoft SQL Server 2008 R2 SP3.`
Minors for linux compatibility; Updated readme 2017-09-02 23:11:10 +02:00
			`## Client config`

Update README.md 2017-09-05 00:22:08 +02:00			The program reads `config.ini` on startup. The file must be in the app working directory.
Minors for linux compatibility; Updated readme 2017-09-02 23:11:10 +02:00
			`## SQL database drivers`

Updated readme 2017-09-03 01:12:55 +02:00			`A comprehensive discussion about SQL database drivers (Qt driver plugins as well as system drivers) can be found in [Qt Documentation](https://doc.qt.io/qt-5/sql-driver.html). MSSQL is handled by the ODBC driver.`
Minors for linux compatibility; Updated readme 2017-09-02 23:11:10 +02:00
Update README.md 2018-05-19 13:45:17 +02:00			Although binaries of the program have statically-linked libraries, in order to connect from Linux to MSSQL server, one should install ODBC SQL Server driver (e.g. `msodbcsql17`__*__).
Update README.md 2017-09-05 00:22:08 +02:00
			`The following section covers the essential tools to develop app with dynamically-linked SQL libraries.`

Minors for linux compatibility; Updated readme 2017-09-02 23:11:10 +02:00			`### Windows 10`

Updated readme 2017-09-03 01:12:55 +02:00			`* Both Qt SQL driver plugins (QMYSQL and QODBC) should be already bundled with Qt SDK.`
			* MySQL driver can be installed by placing `libmysql.dll` from [C API for MySQL (mysqlclient)](https://dev.mysql.com/downloads/connector/c/) in the app working directory.
			`* ODBC Driver Manager and SQL Server driver are built in; hence, no further installation is necessary. Alternatively, instead of SQL Server driver, one can use Microsoft ODBC Driver; see [Microsoft Docs](https://docs.microsoft.com/en-us/sql/connect/odbc/windows/microsoft-odbc-driver-for-sql-server-on-windows).`
Minors for linux compatibility; Updated readme 2017-09-02 23:11:10 +02:00
			`### Ubuntu 16.04`

Minors along with readme update 2017-09-02 23:55:18 +02:00			`Packages with Qt driver plugins and system SQL drivers:`
Minors for linux compatibility; Updated readme 2017-09-02 23:11:10 +02:00
			* MySQL - `libqt5sql5-mysql` `libmysqlclient20`,
Update README.md 2018-05-19 13:45:17 +02:00			* ODBC ([unixODBC Driver Manager](http://www.unixodbc.org) and Microsoft ODBC Driver) - `libqt5sql5-odbc` `libodbc1` `unixodbc` `odbcinst` `msodbcsql17`__*__.
Minors for linux compatibility; Updated readme 2017-09-02 23:11:10 +02:00
Update README.md 2018-05-19 13:45:17 +02:00			__*__ How to install `msodbcsql17` - [Installing the Microsoft ODBC Driver for SQL Server on Linux and macOS](https://docs.microsoft.com/en-us/sql/connect/odbc/linux-mac/installing-the-microsoft-odbc-driver-for-sql-server).