You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/content/tutorials/migrating-from-connector-net.md
+15-8Lines changed: 15 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -19,22 +19,28 @@ MySqlConnector has some different default connection string options:
19
19
<thead>
20
20
<th style="width:20%">Option</th>
21
21
<th style="width:20%">MySqlConnector</th>
22
-
<th style="width:20%">Oracle's Connector/NET</th>
22
+
<th style="width:20%">Oracle’s Connector/NET</th>
23
23
<th style="width:40%">Notes</th>
24
24
</thead>
25
25
<tr>
26
26
<td><code>AllowPublicKeyRetrieval</code></td>
27
27
<td>Default is <code>false</code></td>
28
28
<td>(not configurable)</td>
29
29
<td>When using <code>sha256_password</code> authentication, this option allows the RSA public key to be retrieved from the server
30
-
(when not using a secure connection). It's <code>false</code> by default to avoid disclosing the password to a malicious proxy.</td>
30
+
(when not using a secure connection). It’s <code>false</code> by default to avoid disclosing the password to a malicious proxy.</td>
31
31
</tr>
32
32
<tr>
33
33
<td><code>ConnectionReset</code></td>
34
34
<td>Default is <code>true</code></td>
35
35
<td>Default is <code>false</code></td>
36
36
<td>MySqlConnector always resets pooled connections by default so that the connection is in a known state. This fixes <a href="https://bugs.mysql.com/bug.php?id=77421">MySQL Bug 77421</a>.</td>
37
37
</tr>
38
+
<tr>
39
+
<td><code>IgnoreCommandTransaction</code></td>
40
+
<td>Default is <code>false</code></td>
41
+
<td>(not configurable, effective default is <code>true</code>)</td>
42
+
<td>See remarks under <a href="#mysqlcommand">MySqlCommand</a> below.</td>
43
+
</tr>
38
44
<tr>
39
45
<td><code>LoadBalance</code></td>
40
46
<td>Default is <code>RoundRobin</code></td>
@@ -45,7 +51,7 @@ MySqlConnector has some different default connection string options:
45
51
<td><code>ServerRSAPublicKeyFile</code></td>
46
52
<td>(no default)</td>
47
53
<td>(not configurable)</td>
48
-
<td>Specify a file containing the server's RSA public key to allow <code>sha256_password</code> authentication over an insecure connection.</td>
54
+
<td>Specify a file containing the server’s RSA public key to allow <code>sha256_password</code> authentication over an insecure connection.</td>
49
55
</tr>
50
56
<tr>
51
57
<td><code>UseAffectedRows</code></td>
@@ -74,7 +80,8 @@ object to be created. See [#331](https://github.com/mysql-net/MySqlConnector/iss
74
80
75
81
Connector/NET allows a command to be executed even when `MySqlCommand.Transaction` references a commited, rolled back, or
76
82
disposed `MySqlTransaction`. MySqlConnector will throw an `InvalidOperationException` if the `MySqlCommand.Transaction`
77
-
property doesn't reference the active transaction. To disable this strict validation, set <code>IgnoreCommandTransaction=true</code>
83
+
property doesn’t reference the active transaction. This fixes <ahref="https://bugs.mysql.com/bug.php?id=88611">MySQL Bug 88611</a>.
84
+
To disable this strict validation, set <code>IgnoreCommandTransaction=true</code>
78
85
in the connection string. See [Issue 474](https://github.com/mysql-net/MySqlConnector/issues/474) for more details.
79
86
80
87
### Exceptions
@@ -87,14 +94,14 @@ for various precondition checks that indicate misuse of the API (and not a probl
87
94
The following bugs in Connector/NET are fixed by switching to MySqlConnector.
88
95
89
96
*[#37283](https://bugs.mysql.com/bug.php?id=37283), [#70587](https://bugs.mysql.com/bug.php?id=70587): Distributed transactions are not supported
90
-
*[#50773](https://bugs.mysql.com/bug.php?id=50773): Can't use multiple connections within one TransactionScope
97
+
*[#50773](https://bugs.mysql.com/bug.php?id=50773): Can’t use multiple connections within one TransactionScope
91
98
*[#61477](https://bugs.mysql.com/bug.php?id=61477): `ColumnOrdinal` in schema table is 1-based
92
99
*[#66476](https://bugs.mysql.com/bug.php?id=66476): Connection pool uses queue instead of stack
*[#70686](https://bugs.mysql.com/bug.php?id=70686): `TIME(3)` and `TIME(6)` fields serialize milliseconds incorrectly
95
102
*[#72494](https://bugs.mysql.com/bug.php?id=72494), [#83330](https://bugs.mysql.com/bug.php?id=83330): EndOfStreamException inserting large blob with UseCompression=True
96
103
*[#73610](https://bugs.mysql.com/bug.php?id=73610): Invalid password exception has wrong number
97
-
*[#73788](https://bugs.mysql.com/bug.php?id=73788): Can't use `DateTimeOffset`
104
+
*[#73788](https://bugs.mysql.com/bug.php?id=73788): Can’t use `DateTimeOffset`
98
105
*[#75604](https://bugs.mysql.com/bug.php?id=75604): Crash after 29.4 days of uptime
99
106
*[#75917](https://bugs.mysql.com/bug.php?id=75917), [#76597](https://bugs.mysql.com/bug.php?id=76597), [#77691](https://bugs.mysql.com/bug.php?id=77691), [#78650](https://bugs.mysql.com/bug.php?id=78650), [#78919](https://bugs.mysql.com/bug.php?id=78919), [#80921](https://bugs.mysql.com/bug.php?id=80921), [#82136](https://bugs.mysql.com/bug.php?id=82136): "Reading from the stream has failed" when connecting to a server
100
107
*[#77421](https://bugs.mysql.com/bug.php?id=77421): Connection is not reset when pulled from the connection pool
@@ -105,15 +112,15 @@ The following bugs in Connector/NET are fixed by switching to MySqlConnector.
105
112
*[#81650](https://bugs.mysql.com/bug.php?id=81650), [#88962](https://bugs.mysql.com/bug.php?id=88962): `Server` connection string option may now contain multiple, comma separated hosts that will be tried in order until a connection succeeds
106
113
*[#83229](https://bugs.mysql.com/bug.php?id=83329): "Unknown command" exception inserting large blob with UseCompression=True
107
114
*[#84220](https://bugs.mysql.com/bug.php?id=84220): Cannot call a stored procedure with `.` in its name
108
-
*[#84701](https://bugs.mysql.com/bug.php?id=84701): Can't create a parameter using a 64-bit enum with a value greater than int.MaxValue
115
+
*[#84701](https://bugs.mysql.com/bug.php?id=84701): Can’t create a parameter using a 64-bit enum with a value greater than int.MaxValue
109
116
*[#85185](https://bugs.mysql.com/bug.php?id=85185): `ConnectionReset=True` does not preserve connection charset
110
117
*[#86263](https://bugs.mysql.com/bug.php?id=86263): Transaction isolation level affects all transactions in session
111
118
*[#87307](https://bugs.mysql.com/bug.php?id=87307): NextResult hangs instead of timing out
112
119
*[#87316](https://bugs.mysql.com/bug.php?id=87316): MySqlCommand.CommandTimeout can be set to a negative value
113
120
*[#87868](https://bugs.mysql.com/bug.php?id=87868): `ColumnSize` in schema table is incorrect for `CHAR(36)` and `BLOB` columns
114
121
*[#87876](https://bugs.mysql.com/bug.php?id=87876): `IsLong` is schema table is incorrect for `LONGTEXT` and `LONGBLOB` columns
115
122
*[#88058](https://bugs.mysql.com/bug.php?id=88058): `decimal(n, 0)` has wrong `NumericPrecision`
116
-
*[#88124](https://bugs.mysql.com/bug.php?id=88124): CommandTimeout isn't reset when calling Read/NextResult
123
+
*[#88124](https://bugs.mysql.com/bug.php?id=88124): CommandTimeout isn’t reset when calling Read/NextResult
117
124
*[#88611](https://bugs.mysql.com/bug.php?id=88611): `MySqlCommand` can be executed even if it has "wrong" transaction
118
125
*[#89085](https://bugs.mysql.com/bug.php?id=89085): `MySqlConnection.Database` not updated after `USE database;`
0 commit comments