Skip to content

3.0.0

Latest

Choose a tag to compare

@bgrainger bgrainger released this 12 Nov 04:16
· 2 commits to master since this release
3.0.0
95875a1
  • Support .NET 11.
    • Support zstd compression on .NET 11: #717.
    • With UseCompression=True, zstd is preferred over zlib if the server supports it.
  • Possibly Breaking Remove .NET 6.0 and .NET 9.0 target frameworks.
    • Microsoft ended .NET 6.0 support on 12 November 2024 and .NET 9.0 support on 10 November 2026.
    • The minimum supported version of .NET is now .NET 8.0; .NET 9.0 applications will use the net8.0 build.
    • .NET 6.0 and .NET 7.0 applications should still work via netstandard2.1, but won't have DbBatch integration or DateOnly/TimeOnly support.
  • Possibly Breaking Remove .NET Framework 4.6.2 integration tests.
    • MySqlConnector still targets net462 as the minimum supported .NET Framework version but the integration tests for it have been removed and no longer run on each CI build.
    • .NET Framework 4.6.2 will be unsupported on 12 January 2027 and we advise users to upgrade to a supported version.
  • Breaking Remove experimental OpenTelemetry semantic conventions: #1435.
    • Only the stable database semantic conventions are emitted; the OTEL_SEMCONV_STABILITY_OPT_IN environment variable is ignored.
    • MySqlConnectorTracingOptionsBuilder.WithSemanticConventionsKinds is now [Obsolete] and has no effect.
    • The legacy db.connection_string, db.name, db.statement, db.system, db.user, net.*, and thread.id tags and the exception event are no longer recorded.
    • Open activities now have db.namespace and server.address tags even if the connection fails.
    • A command timeout sets error.type to timeout.
  • Possibly Breaking VARBINARY(16) columns are no longer read as Guid when using Binary16 GuidFormat: #1691.
    • A workaround is to call MySqlDataReader.GetGuid instead of GetValue.
  • Possibly Breaking Update dependencies to avoid binding redirects on .NET Framework: #1674.
  • Possibly Breaking When a pooled connection's database was changed (with ChangeDatabase or USE), select the connection string's Database again without reauthenticating: #1671.
    • This avoids calling ProvidePasswordCallback and saves round trips when pipelining is enabled.
    • With ConnectionReset=False, other session state is no longer reset in this case.
  • Possibly Breaking Set isolation level for XA transactions from TransactionScope: #1299.
    • XA transactions that don't specify an isolation level now use SERIALIZABLE instead of the server default.
  • Possibly Breaking Changed several columns in the tables schema from long to ulong; this matches the data type on most MySQL servers.
  • Add MySqlDataSource.Clear and MySqlDataSource.ClearAsync: #1670.
  • Return true from MySqlTransaction.SupportsSavepoints: #1676.
  • Use a plugin registered with AuthenticationPlugins.Register when the server switches to an authentication method that MySqlConnector doesn't implement: #1678.
  • Use performance_schema.processlist for the ProcessList schema with MySQL 8.0.22 and later: #1443.
  • Remove proxy detection for retired Azure Database for MySQL Single Server: #1661.
  • Identify the column in InvalidCastException messages: #1135.
  • Respect NoBackslashEscapes for binary GUID parameters: #1692.
  • Fix DnsCheckInterval so new connections use the pool's cached DNS addresses, instead of possibly reconnecting to the old IP address after a DNS change: #1666.
  • Fix prepared statement executing against the wrong database: #1684.
  • Fix DbType.Object being mapped to MySqlDbType.Vector: #1679.
  • Fix error status not being recorded on Execute activity: #1667.
  • Fix Parameter '@'%'' must be defined. when executing account management statements: #1480.
  • Optimization: Read typed values (e.g., GetInt32, GetDateTime) without boxing: #721.
  • Optimization: Reduce lock contention when resetting the command timeout for each row: #1290.
  • Optimization: Reuse a cached buffer for large packets: #1686.
  • Optimization: Use runtime async, ZLibEncoder, and ZLibDecoder in .NET 11.
  • Thanks to @alaricd, @birdnamoo, @eriawan, @rodri-oliveira-dev, and @VerstraeteNick for contributions to this release.