Technical Reference Manual - InduSoft

Database Interface
Using MySQL
IWS can interface with MySQL databases, but to do so, you must install an ADO.Net provider for MySQL.
The provider required by IWS is MySQL Connector/Net, and at the time of this writing, the necessary software
can be downloaded from the official MySQL site. (Please note that the linked site is beyond our control and
may change without notice.)
Once the provider is installed, you can use the Database Configuration property sheet to configure a MySQL
database connection. However, unlike for other database types, you cannot use the Data Link Properties dialog
(which is accessed by clicking ... to the right of the Connection string box) to form the connection string. Instead,
you must directly enter the connection string using this basic format:
Provider=MYSQLCLIENT; Server=myServerAddress; Database=myDataBase; Uid=myUsername;
Pwd=myPassword;
The following optional parameters can be appended to the connection string:
Optional parameters for the MySQL Connector/Net connection string
Parameter
Port=number;
Server=myServerAddress1 & myServerAddress2
& … & myServerAddressN;
Encryption=true;
Encrypt=true;
Default Command Timeout=milliseconds;
Connection Timeout=seconds;
Ignore Prepare=true;
Protocol=myProtocol;
Shared Memory Name=MySQL;
CharSet=UTF8;
Description
Specifies what port to use for the connection. The default port is 3306, but any
port can be specified as long as it matches the server configuration.
If a port of -1 is specified, then the connection will use the named pipes network
protocol (see Protocol below).
Use any server in a replicated server configuration.
Enables SSL encryption for all data sent between the client and the server. The
server must have a valid certificate installed.
An alternative to Encryption above, in case there are errors.
Specifies a default command timeout for the connection. This does not
supercede any timeout properties on individual commands.
Specifies how long the client will wait for a server connection before terminating
the attempt.
Instructs the database provider to ignore Command.Prepare
statements, to prevent corruption from server-side prepared commands.
Specifies which network protocol to use. The default is socket or tcp, but
you can specify pipe to use a named pipes connection or memory to use
a shared memory object.
Specifies the name of the shared memory object to be used for communication.
(This parameter applies only if the Protocol parameter above is set to
memory.)
Specifies which character set to use to encode queries to the server.
Please note that query results are encoded in the same character set that the
data itself is recorded.
Note: These procedures were tested using MySQL v5.1.11 and MySQL Connector/Net v6.2.0.
InduSoft Web Studio Page 513