Skip to content

Commit 3b3ce38

Browse files
Merge pull request #289359 from Clare-Zheng82/1028-Add_MySQL_best_practice
[Doc update] Add MySQL best practices
2 parents f5c97e3 + 757fcdb commit 3b3ce38

File tree

1 file changed

+14
-2
lines changed

1 file changed

+14
-2
lines changed

articles/data-factory/connector-mysql.md

Lines changed: 14 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: jianleishen
66
ms.subservice: data-movement
77
ms.custom: synapse
88
ms.topic: conceptual
9-
ms.date: 10/09/2024
9+
ms.date: 10/28/2024
1010
ms.author: jianleishen
1111
---
1212

@@ -305,7 +305,7 @@ When copying data from MySQL, the following mappings are used from MySQL data ty
305305
| `time` |`TimeSpan` |`TimeSpan` |
306306
| `timestamp` |`Datetime` |`Datetime` |
307307
| `tinyblob` |`Byte[]` |`Byte[]` |
308-
| `tinyint` |`SByte` |`Int16` |
308+
| `tinyint` |`SByte` <br/> (`tinyint(1)` is mapped to `Boolean`) |`Int16` |
309309
| `tinyint unsigned` |`Int16` |`Int16` |
310310
| `tinytext` |`String` |`String` |
311311
| `varchar` |`String` |`String` |
@@ -325,6 +325,18 @@ Here are steps that help you upgrade your MySQL connector:
325325

326326
1. The latest driver version v2 supports more MySQL versions. For more information, see [Supported capabilities](connector-mysql.md#supported-capabilities).
327327

328+
### Best practices for MySQL connector recommended version
329+
330+
This section introduces best practices for MySQL connector recommended version.
331+
332+
#### Cannot load SSL key
333+
334+
- **Symptoms**: If you are using MySQL connector recommended version with SSL Key as a connection property, you may meet the following error message: `Could not load the client key from your_pem_file: Unrecognized PEM header: -----BEGIN PRIVATE KEY-----`
335+
336+
- **Cause**: The recommended version cannot decrypt the PCKS#8 format.
337+
338+
- **Recommendation**: Convert the PEM format to PCKS#1.
339+
328340
## Differences between the recommended and the legacy driver version
329341

330342
The table below shows the data type mapping differences between MySQL using the recommended and the legacy driver version.

0 commit comments

Comments
 (0)