Native MySQL Connector for WINDEV and WEBDEV

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

Native Connectors/Native Accesses

Native MySQL Connector

Native MySQL Connector for WINDEV and WEBDEV

Overview

Required configuration

Use

See also

Native MySQL Connector for WINDEV and WEBDEV

Available only with this kind of connection

Overview

WINDEV and WEBDEV 26 propose a Native Connector to MySQL (also called Native MySQL Access). This Native Connector allows you to access a MySQL database from a WLanguage program without using any external driver.

Caution: This version of Native MySQL Connector operates with WINDEV and WEBDEV version 26. The Native MySQL Connector is not available for WINDEV Mobile. If you are using WINDEV Mobile, the access to a foreign database (MySQL, Oracle, SQL Server) must be performed via a Webservice supplied with WINDEV Mobile. See the help about SQLConnectWS for more details.

Remark: The Native MySQL Connector is an optional and free module available for download from the PC SOFT site

Required configuration

Conditions for using the Native MySQL Connector

Client layer of MySQL (LibMySQL.DLL file)
- 32-bit client layer to use the 32-bit Native MySQL Connector (version 3.x to 5.x checked).
- Versions 17 and later
  64-bit client layer to use the 64-bit Native MySQL Connector (version 5.x checked).
  New in version 17
  64-bit client layer to use the 64-bit Native MySQL Connector (version 5.x checked).
  64-bit client layer to use the 64-bit Native MySQL Connector (version 5.x checked).
The LibMySQL.DLL DLL must be found:
- On the development computer:
  - in the "\Programs\Framework\Win32x86" directory of the setup directory of WINDEV or WEBDEV (32 bits).
  - in the "\Programs\Framework\Win64x86" directory of the setup directory of WINDEV or WEBDEV (64 bits).
- On the deployment computer, in the executable directory or in the Windows directory. For a deployment on a Web server, the DLL must be found in the directory of the Native Connector or in the Windows directory.

The necessary files

The following files are required to use the Native MySQL Connector:

The LibMySQL.DLL DLL. This DLL is supplied with MySQL. See the license agreement of MySQL for more details about the distribution conditions of this DLL.
- 32-bit file to use the 32-bit Native MySQL Connector.
- Versions 17 and later
  64-bit file to use the 64-bit Native MySQL Connector.
  New in version 17
  64-bit file to use the 64-bit Native MySQL Connector.
  64-bit file to use the 64-bit Native MySQL Connector.
From version 5.5 of libmysql.dll client, the computer that runs the application must install a Visual Studio Redistributable package corresponding to the server version (see the Oracle site for more details).

The wdxxxmsql.dll DLL: Required for the 32-bit Native Connector to a MySQL database. This file is supplied with the Native MySQL Connector for WINDEV or WEBDEV.
Versions 17 and later
The wdxxxmsql64.dll DLL: Required for the 64-bit Native Connector to a MySQL database. This file is supplied with the Native MySQL Connector for WINDEV or WEBDEV.
New in version 17
The wdxxxmsql64.dll DLL: Required for the 64-bit Native Connector to a MySQL database. This file is supplied with the Native MySQL Connector for WINDEV or WEBDEV.
The wdxxxmsql64.dll DLL: Required for the 64-bit Native Connector to a MySQL database. This file is supplied with the Native MySQL Connector for WINDEV or WEBDEV.

Versions 17 and later
To debug a multi-configuration project in 32-bit and 64-bit configuration:

copy the 32-bit libmysql DLL into the EXE sub-folder of 32-bit configuration of project.
copy the 64-bit libmysql DLL into the EXE sub-folder of 64-bit configuration of project.

New in version 17
To debug a multi-configuration project in 32-bit and 64-bit configuration:

copy the 32-bit libmysql DLL into the EXE sub-folder of 32-bit configuration of project.
copy the 64-bit libmysql DLL into the EXE sub-folder of 64-bit configuration of project.

To debug a multi-configuration project in 32-bit and 64-bit configuration:

copy the 32-bit libmysql DLL into the EXE sub-folder of 32-bit configuration of project.
copy the 64-bit libmysql DLL into the EXE sub-folder of 64-bit configuration of project.

Installing a new version of MySQL

The dialog between the Native MySQL Connector and MySQL uses the LIBMYSQL.DLL library provided with MySQL.
The Native Connector may no longer operate if the behavior of this DLL is modified (when changing version for example).

An upgraded version that takes these changes into account will be available soon ; meanwhile, all you have to do is use the previous version of LIBMYSQL.DLL. This DLL will operate with the new version of MySQL, while still being compatible with the Native Connector.

Files required to use Native MySQL Connector in Linux

To use Native MySQL Connector in Linux, the following operations must be performed:

Install the MySQL client layer on the server. Check whether the libmysqlclient.so DLL was copied into /usr/lib.
Remarks:
- The 32-bit MySQL client layer must be installed to use the 32-bit Native MySQL Connector.
- Versions 17 and later
  The 64-bit MySQL client layer must be installed to use the 64-bit Native MySQL Connector.
  New in version 17
  The 64-bit MySQL client layer must be installed to use the 64-bit Native MySQL Connector.
  The 64-bit MySQL client layer must be installed to use the 64-bit Native MySQL Connector.
If the copied DLLs are such as libmysqlClient.so.12.0.0, a link must be created on this DLL with the following code line:

ln -s libmysqlclient.so.12.0.0 libmysqlclient.so
If you are using a WEBDEV site, copy the following DLLs to the directory of WEBDEV application server:
- wd260hf.so: HFSQL library
- wd260msql.so: library of 32-bit Native Connector
- Versions 17 and later
  wd260msql64.so: library of 64-bit Native Connector
  New in version 17
  wd260msql64.so: library of 64-bit Native Connector
  wd260msql64.so: library of 64-bit Native Connector
- wd260sql.so: SQL library
If you are using a Java application or a Linux Batch, copy the following DLLs to the application directory:
- wd260hf.so: HFSQL library
- wd260msql.so: library of 32-bit Native Connector
- Versions 17 and later
  wd260msql64.so: library of 64-bit Native Connector
  New in version 17
  wd260msql64.so: library of 64-bit Native Connector
  wd260msql64.so: library of 64-bit Native Connector
- wd260sql.so: SQL library

Use

Using the Native MySQL Connector in your WINDEV applications and WEBDEV sites

To use MySQL in native mode, you must program in the WINDEV application or WEBDEV site:

with the "SQL" functions of WLanguage (see Programming with SQL functions).
with the "HFSQL" functions of WLanguage (see Programming with HFSQL functions).

Remarks:

Don't forget to read the limitations of the Native MySQL Connector.
Versions 23 and later
The option "Automatically create the data files when they are opened" ("Files" tab in the project description) is taken into account by the Native MySQL Connector.
New in version 23
The option "Automatically create the data files when they are opened" ("Files" tab in the project description) is taken into account by the Native MySQL Connector.
The option "Automatically create the data files when they are opened" ("Files" tab in the project description) is taken into account by the Native MySQL Connector.

Remark: From version 19, HFSQL is the new name of HyperFileSQL.

Optimizing HFSQL functions

The "Browsing table" controls based on queries are optimized: the content of the Table control can be sorted by clicking one of its columns.
To avoid re-running the same query several times when browsing its result, we advise you to use the hNoRefresh constant (if the data is modified by a single computer for example).