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.

![](screenshot.png)

The program was tested on: 
 * clients: Windows 10 with Qt 5.9.1, Ubuntu 16.04 with Qt 5.5.1, 
 * servers: MySQL Server 5.5.57, Microsoft SQL Server 2008 R2 SP3.

## Client config

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

## SQL database drivers

A comprehensive discussion about SQL database drivers can be found in [Qt Documentation](https://doc.qt.io/qt-5/sql-driver.html).

### Windows 10

* Both Qt driver plugins should be already bundled with Qt SDK.
* System ODBC driver should be already bundled with Windows.
* System 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.

### Ubuntu 16.04

Packages with Qt driver plugins and system SQL manager with drivers:

* MySQL - `libqt5sql5-mysql` `libmysqlclient20`,
* MSSQL/ODBC - `libqt5sql5-odbc` `libodbc1` `odbcinst` `unixodbc` `msodbcsql`__*__.

__*__ How to install `msodbcsql` - [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
			`![](screenshot.png)`

			`The program was tested on:`
Minors for linux compatibility; Updated readme 2017-09-02 23:11:10 +02:00			`* clients: Windows 10 with Qt 5.9.1, Ubuntu 16.04 with Qt 5.5.1,`
Added project files 2017-09-01 22:53:26 +02:00			`* servers: MySQL Server 5.5.57, Microsoft SQL Server 2008 R2 SP3.`
Minors for linux compatibility; Updated readme 2017-09-02 23:11:10 +02:00
			`## Client config`

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

			`## SQL database drivers`

			`A comprehensive discussion about SQL database drivers can be found in [Qt Documentation](https://doc.qt.io/qt-5/sql-driver.html).`

			`### Windows 10`

			`* Both Qt driver plugins should be already bundled with Qt SDK.`
			`* System ODBC driver should be already bundled with Windows.`
			* System 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.

			`### Ubuntu 16.04`

			`Packages with Qt driver plugins and system SQL manager with drivers:`

			* MySQL - `libqt5sql5-mysql` `libmysqlclient20`,
			* MSSQL/ODBC - `libqt5sql5-odbc` `libodbc1` `odbcinst` `unixodbc` `msodbcsql`__*__.

			__*__ How to install `msodbcsql` - [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).