MySQL Lists are EOL. Please join:

List:Packagers« Previous MessageNext Message »
From:Surabhi Bhat Date:October 22 2018 5:18pm
Subject:MySQL Connector/NET 8.0.13 has been released
View as plain text  
Dear MySQL users,

MySQL Connector/NET 8.0.13 is the first version to support
Entity Framework Core 2.1 and the third general availability release
of MySQL Connector/NET to add support for the new X DevAPI,which
enables application developers to write code that combines the
strengths of the relational and document models using a modern,
NoSQL-like syntax that does not assume previous experience writing 
traditional SQL.

To learn more about how to write applications using the X DevAPI, see For more
information about how the X DevAPI is implemented in Connector/NET, see

NuGet packages provide functionality at a project level. To get the
full set of features available in Connector/NET such as availability
in the GAC, integration with Visual Studio's Entity Framework Designer
and integration with MySQL for Visual Studio, installation through
the MySQL Installer or the stand-alone MSI is required.

For general documentation about how to get started using MySQL
as a document store, see

To download MySQL Connector/NET 8.0.13, see

Installation instructions can be found at

Changes in MySQL Connector/NET 8.0.13 (2018-10-22, General Availability)

      * Important Changes

      * Functionality Added or Changed

      * Bugs Fixed

*Important Changes*

      * The default value for the SslMode connection option now
        differs based on the protocol used to make the
        connection. The Preferred mode has been reintroduced
        this release (see Options for Both Classic MySQL
        and X Protocol


        To summarize the defaultSslmode values in the
Connector/NET 8.0 
(and 7.0) releaseseries:

        Connector/NET 8.0.13: Preferred mode is the default
        classic MySQL protocol connections only. Required
mode is
        the default for X Protocol connections only
        mode is not available for use with X Protocol).

        Connector/NET 8.0.8 to 8.0.12: Preferred mode is not
        supported for any connections. Required mode is the
        default for both classic MySQL protocol and X

        Connector/NET 7.0.0 to 7.0.7: Preferred mode is the
        default for both classic MySQL protocol and X
        connections. (Bug #28687769)

*Functionality Added or Changed*

      * Document Store: An incremental improvement was made to
        the performance of session creation with a
        string. (Bug #28343655)

      * Support for EF Core 2.1 was added to Connector/NET 8.0.13
        and support for EF Core 2.0 was discontinued in the
        connector version. Other versions of Connector/NET
        continue to support EF Core 2.0 (see Entity
        Core Support


      * The ConnectionTimeout connection option and property were
        reimplemented as the Connect-Timeout option (and the
        ConnectTimeout property) for X Protocol operations.
        aspects of the timeout behavior were changed (see
        for X Protocol Only


        The new ConnectTimeout property was added to the
        MySqlX.XDevAPI.MySqlXConnectionStringBuilder class
        the existing ConnectionTimeout property was removed.

        No modifications were made to the existing
        of the ConnectionTimeout option (or property) for
        MySQL operations.

      * Connector/NET now provides connection pooling for
        applications using the X Protocol. The
        includes the new static MySQLX.GetClient method that
        takes two parameters: connectionData (connection
        or URI) and connectionOptions (JSON-formatted string
        anonymous object containing the pooling options).

        Methodoverloading enables the following type
         MySQLX.GetClient(Object, Object)
         MySQLX.GetClient(Object, String)
         MySQLX.GetClient(String, Object)
         MySQLX.GetClient(String, String)

        GetClient returns the new Client object, which
        an existing and currently unused network connection
        the pool, resets it, and uses it. Closing a session
        the underlying connection as unused and returns it
to the

        Connection options are configured as follows:
        // Connection options of type String
         Client client =
MySQLX.GetClient(ConnectionData, "{ 
\"pooling\": { \"maxSize\": 5, \"queueTimeout\": 5000 } }");

       // Connection options of type Object (anonymous object)
        Client client = MySQLX.GetClient(ConnectionData, new
{ pooling = 
new {maxSize = 5, queueTimeout = 5000 } });

        The new keyword must be used twice when the
        options are configured using an anonymous object.
        Connection options are: enabled, maxSize,
        and queueTimeout. For more information, see
        and Session Concepts

*Bugs Fixed*

      * Document Store: Connector-side validation performed when
        the Collection.CreateIndex method was called
        some of the checks already made by the server. The
        connector now only validates that the
        value passed to the method is a valid JSON document
        the correct structure. (Bug #28343828)

      * EF Core: An invalid syntax error was generated when a new
        property (defined as numeric, has a default value,
and is
        not a primary key) was added to an entity that
        contained a primary-key column with the
        attribute. This fix validates that the entity
        (column) is a primary key first before adding the
        attribute. (Bug #28293927)

      * Document Store: A mixed alphanumeric value such as
        "1address" when used with the Set and Unset methods
        caused the operations to throw an exception. This
        resolves the way mixed values are converted into
        to generate only one token as an identifier. (Bug

      * EF Core: The implementation of some methods required to
        scaffold an existing database were incomplete. (Bug
        #27898343, Bug #90368)

      * Attempts to create a new foreign key from within an
        application resulted in an exception when the key
        generated by a server in the MySQL 8.0 release
        (Bug #27715069)

      * A variable of type POINT when used properly within an
        application targeting MySQL 8.0 generated an SQL
        error. (Bug #27715007)

      * The case-sensitive lookup of field ordinals was
        initialized using case-insensitive comparison logic.
        fix removes the original case-sensitive lookup. (Bug
        #27285641, Bug #88950)

      * The MySql.Data.Types.MySqlGeometry constructor called
        with an array of bytes representing an empty
        collection generated an ArgumentOutOfRangeException
        exception, rather than creating the type as
        Thanks to Peet Whittaker for the patch. (Bug
        Bug #86974)

      * Slow connections made to MySQL were improved by reducing
        the frequency and scope of operating system details
        required by the server to establish and maintain a
        connection. (Bug #22580399, Bug #80030)

On Behalf of MySQL Release Engineering team,
Surabhi Bhat

MySQL Connector/NET 8.0.13 has been releasedSurabhi Bhat22 Oct