MySQL

ExpandedToggleIcon        Connection Dialog

The following connection options are required for connecting to MySQL:

1.Server - The IP address or DNS name of a MySQL server to which to connect.
2.Port - Number of a port to communicate with listener on the server. The default value is 3306;
3.User Id - The MySQL login account.
4.Password - The password for the MySQL login account.
5.Database - The name of the database to connect to.

 

In addition to the required options, Advanced connection options may be set for more fine connection tuning or setting up secure connections via SSL or SSH.

 

ExpandedToggleIcon        Advanced Connection Options

The following table describes the options that you can include in the Connection String using the Advanced Connection Editor dialog box:

 

Option

Description

Backslash Escapes Mode

Specifies whether backslash escape sequences are enabled when processing string literals.

Binary As Guid

Determines whether to treat BINARY(16) columns as GUID. The default value is false.

Binary Uuid Order

Specifies the byte order used for binary UUID values.

Char As Guid

Determines whether CHAR values are treated as GUID values.

Char As Inet

Determines whether CHAR values are treated as INET address values.

Character Set

Specifies a character set used by the client. When this property is enabled, the "SET NAMES <Charset>" query is executed on establishing a connection. The default value is an empty string, indicating that no action is performed with charset on the client and on the server. You can set the Charset property value to 'auto'. In this case, the server asks for the charset and sets the appropriate charset on the client.

Client Interactive

Determines the inactivity timeout before the server breaks the connection. If true, the server breaks the connection after number of seconds specified in interactive_timeout sever variable, otherwise wait_timeout is used.

Compress

Enables transferred data compression when set to true. The default value is false.

Connection Lifetime

Specifies the maximum lifetime (in seconds) of a connection. When a connection is returned to the pool, its creation time is compared with the current time, and the connection is destroyed if that time span exceeds the value specified by Connection Lifetime. The default value is 0 (connection always returns to pool).

Connection Timeout

Specifies the length of time (in seconds) to wait for a connection to the server before terminating the attempt and generating an error. The default value is 15.

Database

Specifies the name of the database.

Default Auth Plugin

Specifies the name of the authentication plugin. Applicable only when connecting through the MySQL client library version 5.5 or later.

Default Command Timeout

Specifies the time in seconds to wait while trying to execute a command before terminating the attempt and generating an error. 0 indicates no limit.

Default Fetch All

Retrieves all queried data from the server on execution when the FetchAll mode is enabled.

Direct

Allows accessing the MySQL server without using the MySQL client library (libmysql.dll). The default value is true.

Disable Charset Sending

Enables or disables explicit charset resetting when a connection is taken from a pool.

Embedded

Allows using the Embedded MySQL server when set to true. The default value is false.

Enlist

Determines whether the connection is automatically enlisted in the current distributed transaction. The default value is true.

FoundRows

Specifies whether the provider will return the number of rows matched by the WHERE condition of the UPDATE statement instead of the rows actually changed as the number of changed rows.

Host

Specifies the IP address or DNS name of a MySQL server to which to connect.

HTTP Base64

Specifies whether to encode data to MIME base64 format before sending them with the POST Request.

HTTP Content Length

Specifies the value of the Content-Length HTTP header parameter. This is the size of message body in bytes for both client and server.

HTTP Host

Specifies the host name or IP address of HTTP tunnel server.

HTTP Keep Alive

Specifies the timeout in seconds to send Keep-Alive HTTP packets.

HTTP Max Connection Age

Specifies the maximum connection age in seconds after which the tunnel will be closed. The default value is 300 seconds.

HTTP Password

Specifies the password for HTTP authorization.

HTTP Port

Specifies the port number of HTTP tunnel server.

HTTP Strict Content Length

Determines whether data padding is enabled when message size is smaller than ContentLength.

HTTP Url

Specifies the URL of the tunneling PHP script. For example, if the script is in the server root, the url can be the following: http://localhost/tunnel.php.

HTTP User

Specifies the user name for HTTP authorization.

Ignore Fractional Seconds

Specifies whether fractional parts of seconds in TIME, DATETIME, and TIMESTAMP values should be ignored.

Ignore Prepare

Ignores any value assigned to it. Do not use this parameter.

Initialization Command

Specifies a data source-specific command that is executed immediately after the connection is established.

Keep Alive

Specifies whether to send TCP keep-alive packets and the interval at which they are sent in seconds. The default value is 0, indicating that the packets are not sent.

Max Pool Size

Specifies the maximum number of connections allowed in the pool. Setting the Max Pool Size value in the connection string can affect performance. The default value is 100.

Min Pool Size

Specifies the minimum number of connections allowed in the pool. The default value is 0.

Password

Specifies the password for the account.

Persist Security Info

Indicates if security-sensitive information, such as the password, is not returned as part of the connection if the connection is open or has ever been in an open state.

Ping Interval

Specifies the interval (in seconds) between pinging MySQL server and reopening the connection if required.

Pipe Name

Specifies the name of the pipe to use when connecting via named pipe (Protocol is set to Pipe).

Plugin Dir

Specifies the directory where the plugin is located. Applicable only when connecting through the MySQL client library version 5.5 or later.

Pooling

Draws the connection from the appropriate pool, or creates it and adds it to the appropriate pool, by default.

Port

Specifies the port of MySQL database to which to connect. The default value is 3306.

Protocol

Specifies the type of the network protocol used to access the MySQL server. The default value is Tcp. The following values can be used:

Pipe - Named pipe protocol. Works only on Windows systems.
Memory - Shared memory protocol. This type of the network protocol can be used to access MySQL server running on the same computer as SQL Server. Not supported in Direct mode.
UnixSocket - Unix socket file connection to local server. In the connection string this value may be specified as "unixsocket", "unix socket", or "unix". When using this protocol, you should specify the unix socket file as the Host parameter.
Ssh - SSH protocol.
Ssl - SSL protocol.
Http - HTTP tunneling protocol.
HttpSsl - Secure SSL connection through the HTTP tunneling protocol.

 

Proxy Host

Specifies the host name or IP address of proxy server.

Proxy Password

Specifies the password for the proxy server account.

Proxy Port

Specifies the port number of the proxy server. The default value is 3128.

Proxy User

Specifies the proxy server account name.

Run Once Command

Specifies a database-specific command that is executed immediately after establishing the connection. Unlike Initialization Command, it is not executed for connections obtained from the connection pool.

Server Parameters

Specifies command-line argument for launching MySQL embedded server. Usually used to provide path to files used by server and path to folder where data files reside. For instance:

Server Parameters=\"--basedir=d:/servers/embedded/;--datadir=d:/servers/embedded/data/;\"

Sql Modes

Specifies the value of MySQL sql_mode system variable to be set for the session.

SSH Authentication Type

Specifies the client authentication method. Can include the following values:

PublicKey - Public-key authentication will be used.
Password - Password will be used for authentication.
KeyboardInteractive - Keyboard-interactive authentication will be used.

SSH Cipher List

Specifies the list of ciphers that the client agrees to use. The following ciphers are available for SSH connections:

3DES
Blowfish
AES(128)

You can use ALL keyword to indicate whole set of ciphers. To exclude certain cipher from the set use "-" sign. For instance, "ALL-Blowfish" means that any cipher but Blowfish can be used.

SSH Host

Specifies the name or ip address of SSH server.

SSH Host Key

Specifies the location of the public key on the client side to verify the server host key during establishing connection.

SSH KeyExchange Algorithms

Specifies the algorithms to securely establish a shared encryption key between the client and the server.

SSH MAC Algorithms

Specifies the algorithms to verify the integrity and authenticity of data exchanged between the client and the server.

SSH Passphrase

Specifies the client key passphrase.

SSH Password

Specifies the user password on SSH server.

SSH Port

Specifies the number of the port on the SSH server to connect.

SSH Private Key

Specifies the location of the client private key.

SSH Strict Host Key Checking

Determines whether the host key is verified during establishing connection. The default value is false.

When this option is set to true, the server public key is verified. The verification is successfull if the server key is identical to the key, supplied by user. This key should be specified in the SSH Host Key parameter. If this property is not set or the keys are not equal, the connection is not established. You can get the public host key from system administrator.

SSH User

Specifies the user id on SSH server.

SSL CA Cert

Specifies the location of authority certificate.

SSL Cert

Specifies the location of client certificate.

SSL Cipher List

Specifies the list of ciphers that the client agrees to use.

SSL Key

Specifies the location of user's private key.

SSL TLS Protocol

Specifies the preferred TLS protocol version reported to the server when establishing a secure connection.

Tiny As Boolean

Specifies whether to treat TINYINT(1) columns as boolean. The default value is false.

Transaction Scope Local

Uses only one internal connection when several connections share the same connection string (which includes "Transaction Scope Local=true;") within a scope of TransactionScope. The default value is false.

Unicode

Sets client charset to utf8mb4 for MySQL 5.5.3 and higher or to utf8 for MySQL versions lower than 5.5.3 and converts client data according to this charset, when set to true. The default value is false.

User ID -or- User

Specifies the MySQL login account.

Validate Connection

Specifies whether to validate connections that are being got from the pool.