for MySQL has been released.  This is a Release Candidate and is

intended for testing and exposure to new features.  We strongly urge you

to not use this release in a production environment.

Version 6.4.2 is intended for use with versions of MySQL from 5.0 – 5.5

** New features found in 6.4 include (please see release notes for more information) **

* Windows Authentication*

This release includes our new support for Windows authentication when connecting to MySQL Server 5.5.

* Table Caching *

We are also introducing a new feature called table caching.  This feature makes it possible to cache the rows of slow changing tables on the client side.

* Simple connection fail-over support *

MySQL database management system, has been released. This release is

the latest release of the 3.51 series and is suitable for use with any

MySQL version since 4.1.

Functionality added or changed:

* Removed use of “old” SQLLEN/SQLULEN types aliases. They are not

supported in unixODBC 2.2.13 and later 64-bit builds. Removed

SQLROWCOUNT, SQLROWSETSIZE, SQLTRANSID, SQLROWOFFSET.

* Options in the GUI are groupped on named tabs.

* Added connection option INTERACTIVE that tells driver that client is

ineractive and interactive_timeout has to be used. (Bug #48603)

* SQLTables uses now INFORMATION_SCHEMA. Added connection option to use

old code. (Bug #43644)

* Added GUI options for MIN_DATE_TO_ZERO and ZERO_DATE_TO_MIN connection

options. (Bug #30539)

Bugs fixed:

* SQLFetch() did not return SQL_ERROR if connection was dropped due to a

timeout. (Bug #39878)

* FLAG_NO_BIGINT still returns bigint for SQLDescribeCol()

(Bug #17679)

* SQLGetTypeInfo() doesn’t return any rows SQL_TIMESTAMP on an ODBC v2

connection. (Bug #30626)

* Inserting a new record using SQLSetPos if the table is from different than

current catalog. (Bug #41946)

* If NO_BACKSLASH_ESCAPES mode is used on a server, escaping binary data

can lead to server query parsing errors. (Bug #49029)

* Column octet length includes terminating null byte. (Bug #54206)

* Driver returns wrong results about column case sensitivity. (Bug #54212)

* Binding bit field to a numeric types doesn’t work. (Bug #32821)

* Some catalog functions used fixed-sized buffers for handling

arguments that could be overrun, and misinterpreted some arguments

as patterns when they should be treated as identifiers. (Bug #36275)

* SQLDescribeCol returns incorrect values of SQLTables data. (Bug #37621)

* SQLForeignKeys included in results rows for foreign keys pointing to

unique fields. (Bug #51422)

* SQLColumns returns wrong transfer octet length. (Bug #53235)

* SQLTablePrivileges requires SELECT privilege on mysql database. (Bug

#50195)

* If there are foreign key constraints with same name for tables with same

names in 2 schemas, SQLForeignKeys can return rows for both

schemas in query about one of those tables. (Bug #49660)

Built using MySQL 5.1.46sp1.

Version 5.1.14 is suitable for use with any MySQL version including MySQL-5.0, MySQL-5.1 or MySQL-5.5.

MySQL Connector/J 5.1.14 includes the following changes targeted at scalability and performance:

- Fixed Bug#58706 – Failover connections didn’t honor “failOverReadOnly=false”, and in some situations would not fall back.

- Added ability to load-balance while auto-commit is enabled.  This introduces two new properties:

loadBalanceAutoCommitStatementThreshold defines the number of matching statements which will trigger the driver to (potentially) swap physical server connections,

loadBalanceAutoCommitStatementRegex defines the regular expression against which statements must match.  The default values (0 and blank, respectively)  retain the previously-established behavior that connections with auto-commit enabled are never balanced.  Feature request documented in Bug#55723.

- Added support for hosts specified in the URL of the form: address=(key=value), supported keys are:

(protocol=tcp or pipe (for named pipes on Windows) (path=[] for named pipes)

(host=[]) for TCP connections (port=[]) for TCP connections

An example would be:

jdbc:mysql://address=(protocol=tcp)(host=localhost)(port=3306)(user=test)/db

Any other parameters are treated as host-specific properties that follow the conventions of the JDBC URL properties. This now allows per-host overrides of any configuration property for multi-host connections (failover, loadbalance, replication). We do recommend that the overrides are limited to user, password, network timeouts and statement and metadata cache sizes. Unexpected behavior may be observed with other per-host overrides.

- Fix for Bug#56099 – Added support for JDBC4-specific functionality when using load-balanced connections.

- Fix for Bug#56200 – Added diagnostic information to SQLException message thrown when a closed load-balanced connection is reused.  This

information will identify the conditions which caused the connection to be closed.

- Fix for Bug#56429 – When using Connector/J configured for failover (jdbc:mysql://host1,host2,… URLs), the non-primary servers re-balance

and spawned new idle connections when the transactions on the master were committed or rolled-back, eventually exceeding max_connections. It was

also discovered that session state (autocommit, isolation level, catalog) wasn’t  being copied from the primary connection to secondary

connections correctly because of the same changes that caused this bug, and this was fixed as well.

- Fix for Bug#56706 – Ensure read-only state is synchronized when new load-balanced connections are selected.

- Fixed Bug#56979 – Improper connection closing logic leads to TIME_WAIT sockets on server

As well as the following general bug fixes and improvements:

- Fix for Bug#58728, NPE in com.mysql.jdbc.jdbc2.optional.StatementWrappe.getResultSet() if rs is null. Regression test case added to Statement regression tests.

- Fix for Bug#58751, DatabaseMetadata.getIndexInfo() CARDINALITY now clamped to Integer.MAX_VALUE.

- Fix for BUG#58590

- Fix for Bug#58232 – CallableStatement fails to fetch OUT parameter against 5.5 server

- Fix for Bug#57850 – Refresh SELECT statement doesn’t use correct data type. Added Field.valueNeedsQuoting (private final boolean) and protected boolean getvalueNeedsQuoting(). UpdatableResultSet refresher and updater call upon this value now.

- Fix for Bug#57697 – Metadata getTables() was not checking for table_name already been quoted.

- Fix for Bug#57694 – 3byte UTF8 can not be used with 5.5.3+ server.

- Fix for Bug#54756 – Cannot retrieve data from ResultSet by column name from a Sphinx daemon.

We were relying only on “server version string” passed. Now, determining server version is done via protocol flags too, where applicable.

- Fix for Bug#57022 – cannot execute a store procedure with output parameters, database parameter was ignored in db.sp notation. The fix is to “sanitize”

db.sp call just like in patch for noAccessToProcedureBodies. BaseTestCase extended with createDatabase and dropDatabase. Regression test added.

- Fix for Bug#57262 – “useOldUTF8Behavior” behavior was broken since 5.1.3, now explicitly sets connection character set to latin1 (“SET NAMES latin1″)

during connection post-handshake process.

- Patch for problem where “noAccessToProcedureBodies=true” was causing “underprivileged” user not to have access to procedures created by him.

- Patch for Bug#56305, unhandled NPE in DatabaseMetaData.java when calling wrong-cased function without access to mysql.proc. Although simple by

itself, some more enhancements were needed for everything to function properly.  So, along with catching potential NPE due to server bug, a

guard against calling JDBC functions with db_name.proc_name notation was also added. Necessary changes added to StringUtils.java too.

- Minor fix in getProcedureColumns() DisplaySize for Bug#51712. Fix for Bug#41269 is not complete without this.  getColumnDisplaySize on a

ResultSet already consisting of metadata is now functional thanks to Bogdan.

- Minor fix for Bug#55217, return 4 as a result of DataBaseMetadata.getJDBCMajorVersion() as per manual.

- Fixed Bug#56955 – Connection properties “trustCertificateKeyStoreType” and “clientCertificateKeyStoreType” have invalid defaults, therefore

connections that specify “useSSL” will sometimes fail with exceptions from JSSE unless “JKS” has been specified for both of these properties.

The default value for these properties is now “JKS”, and thus it no longer has to be specified.

- Fixed Bug#57380 – DatabaseMetaData.supportsMultipleResultSets() now returns true when connected to a 4.1 version or later server.

- Removed logging integrations with log4j and apache-commons-logging due to license incompatibility. Replacing with SLF4J integration in next release.

MySQL version since 4.1 (It will not work with 4.0 or earlier releases.)

Bugs fixed:

* MySQL ODBC Connector on Windows 2008 64bit. (Bug #56233)

* SQLNumResultCols() causes the driver to return only first row in the resultset. (Bug #56677)

* Connector/ODBC 5.1 series requires uninstall prior to installing a new version. (Bug #54314)

* SQLDescribeCol and SQLColAttribute cannot be called before SQLExecute. (Bug #56717)

* Errors would not be reported in bulk upload. (Bug #56804)

* MSI installer does not set InstallLocation value in registry. (Bug #56978)

* SQLProcedureColumns doesn’t work with certain data/parameters combinations. (Bug #57182)

* SQLRowCount return wrong result row count for SQLTables and some other catalog functions. (Bug #57182)

Built against the client library from MySQL Server 5.1.46sp1.

Version 6.3.5 maintenance release includes:

• Fixes to some installer bugs related to .NET Framework 4.0
• Fixes for several other bugs

For details see  http://dev.mysql.com/doc/refman/5.1/en/connector-net-news-6-3-5.html

MySQL Connector 6.3.5 :

1. Provides secure, high-performance data connectivity with MySQL.

2. Implements ADO.NET interfaces that integrate into ADO.NET aware tools.

3. Is a fully managed ADO.NET driver written in 100% pure C#.

4. Provide Visual Studio Integration

MySQL version since 4.1 (It will not work with 4.0 or earlier releases.)

Functionality added or changed:

* Options in the GUI are grouped on named tabs.

* Added connection option INTERACTIVE that tells driver that client is interactive and interactive_timeout has to be used. (Bug #48603)

* Added parameters arrays support. (Bug #48310)

* SQLTables uses now INFORMATION_SCHEMA. Added connection option to use old code. (Bug #43644)

* Added GUI options for MIN_DATE_TO_ZERO and ZERO_DATE_TO_MIN connection options. (Bug #30539)

Bugs fixed:

* If NO_BACKSLASH_ESCAPES mode is used on a server, escaping binary data can lead to server query parsing errors. (Bug #49029)

* Error if unsupported client character set is encountered(for wchar data). (Bug #36996)

* Binding bit field to a numeric types doesn’t work. (Bug #32821)

* Conversion flags are not complete. (Bug #43855)

* SQL_ATTR_MAX_ROWS make some SELECT statement invalid. (Bug #49726)

* Certain column attributes aren’t correct for date columns. (Bug 44576)

* SQLPrepare causes Prefetch of table. (Bug #46411)

* If there are foreign key constraints with same name for tables with same names in 2 schemas, SQLForeignKeys can return rows for both schemas in query about one of those tables. (Bug #49660)

* SQLForeignKeys included in results rows for foreign keys pointing to unique fields (Bug #51422)

* SQLPrimaryKeys returns mangled strings. (Bug #36441)

* Spaces in connection string aren’t removed (Bug #45378)

* SQLColumns returns wrong transfer octet length. (Bug #53235)

* Retrieving of current catalog at the moment when connection is not ready for that(broken, not all pending results processed) leads to application crash. (Bug #46910)

* SQLForeignKeys unacceptable performance getting imported FK. (Bug #39562)

* SQLTablePrivileges requires SELECT privilege on mysql database. (Bug #50195)

* Column octet length includes terminating null byte. (Bug #54206)

* Wrong type returned by SQLColAttribute(SQL_DESC_PRECISION…) in 64-bit systems. (Bug #55024)

Built against the client library from MySQL  5.1.46sp1

Version 5.1.13 is suitable for use with any MySQL version including MySQL-5.0, MySQL-5.1 or MySQL-5.5.

It is now available in source and binary form from the Connector/J download pages at:  http://dev.mysql.com/downloads/connector/j/5.1.html

As always, we recommend that you check the change log  http://dev.mysql.com/doc/refman/5.1/en/cj-news.html and “Upgrading” sections  http://dev.mysql.com/doc/refman/5.1/en/cj-upgrading.html in the manual before upgrading as well as the “CHANGES” file in the download archive to be aware of changes in behavior that might affect your application.

MySQL Connector/J 5.1.13 includes the following changes targeted at scalability and performance:

- Fixed Bug#51266 – jdbc:mysql:loadbalance:// would stick to the first host in the list in some cases, especially exacerbated if the host was down.

- Replaced URLs of the form jdbc:mysql://host-1,host-2 with a composite of a normal connection and a jdbc:mysql:loadbalance:// connection for more robustness and cleaner code.

- Fixed BUG#51643 – Connections using jdbc:mysql:loadbalance:// would have statements (and prepared statements) that did not have their connections changed upon commit()/rollback(), and thus applications that held statement instances past commit()/rollback() could have data written to or read from un-intended connections.

- Fixed BUG#51783 – Load-balanced connections could throw a SQLException incorrectly on commit() or rollback().  This was not caused by failures in commit or rollback, but rather by the possibility that the newly-selected physical connection was stale.  Added logic to catch and retry if this happens, up to the number of hosts specified for load-balancing.  Also added new property,      loadBalanceValidateConnectionOnSwapServer, which controls whether to explicitly ping the selected host (otherwise, the host is presumed to be up, and will only be noticed if auto-commit or transaction isolation state needs to be set and fails).

- Added loadBalancePingTimeout property to allow a specific timeout to be set for each ping executed against the servers.  This ping is executed when the physical connections are rebalanced (commit/rollback or communication exception), or when a query starting with (exactly) “/* ping */” is executed.  The latter causes each open underlying physical connection to be pinged.

- Fixed BUG#51776 – Connection.rollback() could swallow exceptions incorrectly.

- Fixed BUG#52231 – Differences in definitions of which SQLExceptions trigger a failover event could result in failure to try more than a single host in certain situations.

- Fixed BUG#52534 – Performance regression using load-balanced connection.

- More aggressively purge the statement timeout timers after they’ve been cancelled to trade time for memory. This purge only happens if statement timeouts are in use.

- Added management of running load-balanced connections.  Statistics can be obtained, and hosts added/dropped via com.mysql.jdbc.ConnectionGroupManager or the JMX implementation.  This functionality is enabled by setting the new parameter “loadBalanceConnectionGroup” to the name of the logical grouping of connections.

All load-balanced connections sharing the same loadBalanceConnectionGroup value, regardless of how the application creates them, will be managed together.  To enable JMX-based management, set loadBalanceEnableJMX=true and ensure that remote      JMX is enabled in the JRE (eg, use -Dcom.sun.management.jmxremote).

- Added loadBalanceExceptionChecker property, which takes a fully-qualified class name implementing the com.mysql.jdbc.LoadBalancedExceptionChecker interface.  This allows custom evaluation of SQLExceptions thrown to determine whether they should trigger failover to an alternate host in load-balanced deployments.  The default is com.mysql.jdbc.StandardLoadBalanceExceptionChecker.

- Added two new properties which allow more flexibility in determining which SQLExceptions should trigger failover in a load-balanced deployment.  The new “loadBalanceSQLStateFailover” property takes a comma-delimited list of SQLState codes which are compared to the SQLState of the SQLException (matching done with trailing wildcard), while “loadBalanceSQLExceptionSubclassFailover” takes a comma-delimited list of fully-qualified class/interface names, against which the SQLException is checked to determine if it is an instance of any. Matches trigger failover to an alternate host.

- Fixed Bug#51704 – Re-written batched statements don’t honor escape processing flag of their creator.

As well as the following general bug fixes and improvements:

- Fixed BUG#51666 – StatementInterceptors were never “un-safed” after connection establishment, causing interceptors which returned result sets pre/post execution would not work.

- Minor fix in previous patch for Bug#51904. Function ConnectionImpl.setCatalog() was passed quoted argument thus breaking with “…for the right syntax to use near ‘test“’”

- Fix for Bug#51912 – Passing NULL as cat. param to getProcedureColumns with !nullCatalogMeansCurrent

- Fix for Bug#52167 – Can’t parse parameter list with special characters inside

- Fix for Bug#51904 – getProcedureColumns() always returns PROCEDURE_CAT result column as NULL

- Fix for Bug#51712 – Display Size is always 0 for columns returned by getProcedureColumns()

- Fix for Bug#51908 – db variable might have end up unassigned when calling getProcedureColumns()/Functions(). This is a followup on code changes made for Bug#51022.

- Fixed Bug#43576 – Sometimes not able to register OUT parameters for  CallableStatements.

- Fixed Bug#54175 – Driver doesn’t support utf8mb4 for servers 5.5.2 and newer. The driver now auto-detects servers configured with character_set_server=utf8mb4 or treats the Java encoding “utf-8″ passed via “characterEncoding=…” as utf8mb4 in the “SET NAMES=” calls it makes when establishing the connection.

Version 5.1.11 is suitable for use with any MySQL version including MySQL-5.0, MySQL-5.1 or MySQL-5.5.

It is now available in source and binary form from the Connector/J download pages at

http://dev.mysql.com/downloads/connector/j/5.1.html

and mirror sites as well as Maven-2 repositories (note that not all mirror sites may be up to date at this point of time – if you can’t find this version on some mirror, please try again later or choose another download site.)

As always, we recommend that you check the change log

http://dev.mysql.com/doc/refman/5.1/en/cj-news.html

and “Upgrading” sections

http://dev.mysql.com/doc/refman/5.1/en/cj-upgrading.html

in the manual before upgrading as well as the “CHANGES” file in the download archive to be aware of changes in behavior that might affect
your application.

We welcome and appreciate your feedback, bug reports, bug fixes, patches etc.:

http://forge.mysql.com/wiki/Contributing

MySQL Connector/J 5.1.11 includes the following changes targeted at scalability and performance:

- Fix for BUG#50288 – NullPointerException possible during invalidateCurrentConnection() for load-balanced connections.

- Fix for BUG#48605 – Ping for load balanced connections leaves closed connections in liveConnections, causing subsequent Exceptions when that connection is used.

- Fix for BUG#48442 – Load-balanced Connection object returns inconsistent results for hashCode() and equals() dependent upon state of underlying connections.

- Fix for BUG#48172 – Batch rewrite requires space immediately after “VALUES”

- Fix for BUG#48486 Cannot use load balanced connections with MysqlConnectionPoolDataSource.

- “Replication” connections (those with URLs that start with
jdbc:mysql:replication) now use a jdbc:mysql:loadbalance connection
under the hood for the slave “pool”. This also means that one can set
load balancing properties such as “loadBalanceBlacklistTimeout” and
“loadBalanceStrategy” to choose a mechanism for balancing the load and
failover/fault tolerance strategy for the slave pool. This work was done
in order to fix Bug#49537.

- Fixed Bug#36565 – permgen leak from java.util.Timer. Unfortunately no great
fix exists that lets us keep the timer shared amongst connection instances, so
instead it’s lazily created if need be per-instance, and torn down when the
connection is closed.

- Fixed BUG#49700 – Connections from ConnectionPoolDataSource don’t
maintain any values set with “sesssionVariables=…”. This was a bug
in Connection.changeUser()/resetServerState(), we now resubmit the
session variables during the execution of these methods.

(special thanks to Todd Farmer from the Sun/MySQL support team for the numerous fixes to load-balanced connections!)

As well as the following general bug fixes and improvements:

- Fix for BUG#49607 – Provide Connection context in ExceptionInterceptor.

- Fix for BUG#49745 – deleteRow() for updatable result sets can cause full table scan because escaped hex values are used for primary key identifiers.

- Fix for Bug#32525 – “noDatetimeStringSync” doesn’t work for server-side prepared statements. Now it does.

- Hooked up exception interceptors so they get called now.

- Rev’d the statement interceptor interface to pass on some server flags, warning counts and errors. See
the com.mysql.jdbc.StatementInteceptorsV2 interface for more details. The driver will create adaptors to
transparently convert older implementations to the newer interface at runtime.

- Statement Interceptors are now enabled at connection instantiation, but
can not return result sets (they will be ignored) until the connection
has bootstrapped itself. If during the init() method your interceptor
requires access to the connection itself, it should ensure that methods
that might throw exceptions if the connection is closed should handle
this in a robust manner.

- Statement Interceptors didn’t completely intercept server-side prepared statements.