Skip to content

Commit d72482f

Browse files
Odbc release18.6.1 (#36071)
* Odbc release18.6.1 * Apply suggestions from code review Co-authored-by: David Engel <dengel1012@gmail.com> * Update version Co-authored-by: David Engel <dengel1012@gmail.com> * Updated Release number and date * Update ms.topic: * Update docs/includes/odbc-latest-release.md * Update docs/includes/odbc-latest-release.md * Update docs/connect/odbc/linux-mac/release-notes-odbc-sql-server-linux-mac.md --------- Co-authored-by: David Engel <dengel1012@gmail.com>
1 parent 517f65a commit d72482f

9 files changed

Lines changed: 195 additions & 119 deletions

docs/connect/odbc/bug-fixes.md

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -3,17 +3,21 @@ title: List of bugs fixed
33
description: This page contains a listing of bugs fixed in each release, starting with Microsoft ODBC Driver 17 for SQL Server.
44
author: David-Engel
55
ms.author: davidengel
6-
ms.date: 03/17/2025
6+
ms.date: 12/17/2025
77
ms.service: sql
88
ms.subservice: connectivity
9-
ms.topic: conceptual
9+
ms.topic: release-notes
1010
helpviewer_keywords:
1111
- "driver"
1212
---
1313
# List of bugs fixed
1414

1515
This page contains a listing of bugs fixed in each release, starting with [!INCLUDE[msCoName](../../includes/msconame-md.md)] ODBC Driver 17 for [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)].
1616

17+
### Bug fixes in the [!INCLUDE[msCoName](../../includes/msconame-md.md)] ODBC Driver 18.6.1.1 for [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)]
18+
19+
- Fix TDS packet size in BID trace
20+
1721
### Bug fixes in the [!INCLUDE[msCoName](../../includes/msconame-md.md)] ODBC Driver 18.5.1.1 for [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)]
1822

1923
- Fix connection recovery to obtain the active primary node when a server moves
@@ -77,7 +81,7 @@ This page contains a listing of bugs fixed in each release, starting with [!INCL
7781
### Bug fixes in the [!INCLUDE[msCoName](../../includes/msconame-md.md)] ODBC Driver 18.2 for [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)]
7882

7983
- Fix VBS-NONE enclave attestation protocol
80-
- Fix error when retrieving numeric column with Regional=Yes
84+
- Fix an error when retrieving numeric column with Regional=Yes
8185
- Fix intermittent lack of error when server is stopped during bcp out operation
8286
- Fix error when stored procedure call contains unquoted string parameter
8387
- Fix a memory leak upon reconnect
@@ -106,7 +110,7 @@ This page contains a listing of bugs fixed in each release, starting with [!INCL
106110
### Bug fixes in the [!INCLUDE[msCoName](../../includes/msconame-md.md)] ODBC Driver 18.0 for [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)]
107111

108112
- Fix UI issues where text was cut off and position of items was off.
109-
- Fix issue with Active Directory Interactive login where attempting to log in after closing the window of the first failure would automatically succeed if cached credentials were available.
113+
- Fix issue with Active Directory Interactive login where attempting to sign in after closing the window of the first failure would automatically succeed if cached credentials were available.
110114
- Fix use of XADTC with Azure SQL Managed Instance.
111115
- Fix loss of Microsoft Entra authentication mode when reconnecting an idle connection.
112116
- Fix an issue with federated authentication when using PingFed.
@@ -128,7 +132,7 @@ This page contains a listing of bugs fixed in each release, starting with [!INCL
128132
### Bug fixes in the [!INCLUDE[msCoName](../../includes/msconame-md.md)] ODBC Driver 17.9 for [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)]
129133

130134
- Fix UI issues where text was cut off and position of items was off.
131-
- Fix issue with Active Directory Interactive login where attempting to log in after closing the window of the first failure would automatically succeed if cached credentials were available.
135+
- Fix issue with Active Directory Interactive login where attempting to sign in after closing the window of the first failure would automatically succeed if cached credentials were available.
132136
- Fix use of XADTC with Azure SQL Managed Instance.
133137
- Fix loss of Microsoft Entra authentication mode when reconnecting an idle connection.
134138
- Fix an issue with federated authentication when using PingFed.
@@ -213,7 +217,7 @@ This page contains a listing of bugs fixed in each release, starting with [!INCL
213217
- Fixed detection of connection liveness
214218
- Fixed incorrect detection of closed sockets
215219
- Fixed an infinite wait when attempting to release a statement handle during failed recovery
216-
- Fixed incorrect uninstallation behavior when both version 13 and 17 are installed on Windows
220+
- Fixed incorrect uninstallation behavior when both versions 13 and 17 are installed on Windows
217221
- Fixed decryption behavior on older Windows platform (Windows 7, 8 and Server 2012)
218222
- Fixed a cache issue when using ADAL Authentication on Windows
219223
- Fixed an issue that was locking and overwriting trace logs on Windows

docs/connect/odbc/download-odbc-driver-for-sql-server.md

Lines changed: 32 additions & 27 deletions
Large diffs are not rendered by default.

docs/connect/odbc/linux-mac/installing-the-microsoft-odbc-driver-for-sql-server.md

Lines changed: 36 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -3,10 +3,10 @@ title: Install the Microsoft ODBC driver for SQL Server (Linux)
33
description: Learn how to install the Microsoft ODBC Driver for SQL Server on Linux clients to enable database connectivity.
44
author: David-Engel
55
ms.author: davidengel
6-
ms.date: 07/30/2025
6+
ms.date: 12/17/2025
77
ms.service: sql
88
ms.subservice: connectivity
9-
ms.topic: conceptual
9+
ms.topic: concept-article
1010
ms.custom:
1111
- intro-installation
1212
- linux-related-content
@@ -22,7 +22,7 @@ This article provides commands for installing the ODBC driver from the bash shel
2222

2323
## <a id="18"></a> Microsoft ODBC 18
2424

25-
The following sections explain how to install the Microsoft ODBC driver 18 from the bash shell for different Linux distributions. Supported distributions are Alpine Linux, Debian, Red Hat Enterprise Linux (RHEL), Oracle Linux, SUSE Linux Enterprise Server (SLES), and Ubuntu. Starting with version 18.4, to accept the EULA automatically when installing the non-Alpine Linux (.deb or .rpm) driver, you can create the file '/opt/microsoft/msodbcsql18/ACCEPT_EULA'.
25+
The following sections explain how to install the Microsoft ODBC driver 18 from the bash shell for different Linux distributions. Supported distributions are Alpine Linux, Debian, Red Hat Enterprise Linux (RHEL), Oracle Linux, SUSE Linux Enterprise Server (SLES), Ubuntu, and Azure Linux. Starting with version 18.4, to accept the EULA automatically when installing the non-Alpine Linux (`.deb`or `.rpm`) driver, you can create the file `/opt/microsoft/msodbcsql18/ACCEPT_EULA`.
2626

2727
### [Alpine](#tab/alpine18-install)
2828

@@ -39,20 +39,20 @@ then
3939
fi
4040

4141
#Download the desired package(s)
42-
curl -O https://download.microsoft.com/download/fae28b9a-d880-42fd-9b98-d779f0fdd77f/msodbcsql18_18.5.1.1-1_$architecture.apk
43-
curl -O https://download.microsoft.com/download/7/6/d/76de322a-d860-4894-9945-f0cc5d6a45f8/mssql-tools18_18.4.1.1-1_$architecture.apk
42+
curl -O https://download.microsoft.com/download/9dcab408-e0d4-4571-a81a-5a0951e3445f/msodbcsql18_18.6.1.1-1_$architecture.apk
43+
curl -O https://download.microsoft.com/download/b60bb8b6-d398-4819-9950-2e30cf725fb0/mssql-tools18_18.6.1.1-1_$architecture.apk
4444

4545
#(Optional) Verify signature, if 'gpg' is missing install it using 'apk add gnupg':
46-
curl -O https://download.microsoft.com/download/fae28b9a-d880-42fd-9b98-d779f0fdd77f/msodbcsql18_18.5.1.1-1_$architecture.sig
47-
curl -O https://download.microsoft.com/download/7/6/d/76de322a-d860-4894-9945-f0cc5d6a45f8/mssql-tools18_18.4.1.1-1_$architecture.sig
46+
curl -O https://download.microsoft.com/download/9dcab408-e0d4-4571-a81a-5a0951e3445f/msodbcsql18_18.6.1.1-1_$architecture.sig
47+
curl -O https://download.microsoft.com/download/b60bb8b6-d398-4819-9950-2e30cf725fb0/mssql-tools18_18.6.1.1-1_$architecture.sig
4848

4949
curl https://packages.microsoft.com/keys/microsoft.asc | gpg --import -
50-
gpg --verify msodbcsql18_18.5.1.1-1_$architecture.sig msodbcsql18_18.5.1.1-1_$architecture.apk
51-
gpg --verify mssql-tools18_18.4.1.1-1_$architecture.sig mssql-tools18_18.4.1.1-1_$architecture.apk
50+
gpg --verify msodbcsql18_18.6.1.1-1_$architecture.sig msodbcsql18_18.6.1.1-1_$architecture.apk
51+
gpg --verify mssql-tools18_18.6.1.1-1_$architecture.sig mssql-tools18_18.6.1.1-1_$architecture.apk
5252

5353
#Install the package(s)
54-
sudo apk add --allow-untrusted msodbcsql18_18.5.1.1-1_$architecture.apk
55-
sudo apk add --allow-untrusted mssql-tools18_18.4.1.1-1_$architecture.apk
54+
sudo apk add --allow-untrusted msodbcsql18_18.6.1.1-1_$architecture.apk
55+
sudo apk add --allow-untrusted mssql-tools18_18.6.1.1-1_$architecture.apk
5656
```
5757

5858
> [!NOTE]
@@ -61,7 +61,7 @@ sudo apk add --allow-untrusted mssql-tools18_18.4.1.1-1_$architecture.apk
6161
### [Debian](#tab/debian18-install)
6262

6363
```bash
64-
if ! [[ "9 10 11 12" == *"$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1)"* ]];
64+
if ! [[ "9 10 11 12 13" == *"$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1)"* ]];
6565
then
6666
echo "Debian $(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1) is not currently supported.";
6767
exit;
@@ -92,7 +92,7 @@ sudo apt-get install -y libgssapi-krb5-2
9292
### [RHEL and Oracle Linux](#tab/redhat18-install)
9393

9494
```bash
95-
if ! [[ "7 8 9" == *"$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1)"* ]];
95+
if ! [[ "7 8 9 10" == *"$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1)"* ]];
9696
then
9797
echo "RHEL $(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1) is not currently supported.";
9898
exit;
@@ -146,7 +146,7 @@ sudo zypper install -y unixODBC-devel
146146
### [Ubuntu](#tab/ubuntu18-install)
147147

148148
```bash
149-
if ! [[ "18.04 20.04 22.04 24.04 24.10" == *"$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2)"* ]];
149+
if ! [[ "18.04 20.04 22.04 24.04 25.10" == *"$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2)"* ]];
150150
then
151151
echo "Ubuntu $(grep VERSION_ID /etc/os-release | cut -d '"' -f 2) is not currently supported.";
152152
exit;
@@ -173,6 +173,27 @@ sudo apt-get install -y unixodbc-dev
173173
> [!NOTE]
174174
> You can substitute setting the environment variable 'ACCEPT_EULA' with setting the debconf variable 'msodbcsql/ACCEPT_EULA' instead: `echo msodbcsql18 msodbcsql/ACCEPT_EULA boolean true | sudo debconf-set-selections`
175175
176+
### [Azure Linux](#tab/azure18-install)
177+
178+
```bash
179+
if ! [[ "3.0" == *"$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2)"* ]];
180+
then
181+
echo "Azure Linux $(grep VERSION_ID /etc/os-release | cut -d '"' -f 2) is not currently supported.";
182+
exit;
183+
fi
184+
185+
sudo ACCEPT_EULA=Y tdnf install -y msodbcsql18
186+
# optional: for bcp and sqlcmd
187+
sudo ACCEPT_EULA=Y tdnf install -y mssql-tools18
188+
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bashrc
189+
source ~/.bashrc
190+
# optional: for unixODBC development headers
191+
sudo tdnf install -y unixODBC-devel
192+
```
193+
194+
> [!NOTE]
195+
> If you don't set the `ACCEPT_EULA` environment variable, the installation still continues. However, you then need to manually run `/opt/microsoft/msodbcsql18/accept-eula.sh` and `/opt/mssql-tools18/bin/accept-eula.sh` to agree to the license terms. To automatically accept the EULA during installation, you can create the files `/opt/microsoft/msodbcsql18/ACCEPT_EULA` and `/opt/mssql-tools18/ACCEPT_EULA`.
196+
176197
---
177198

178199
## Previous versions
@@ -189,7 +210,7 @@ The following sections provide instructions for installing previous versions of
189210
The following sections explain how to install the Microsoft ODBC driver 17 from the bash shell for different Linux distributions.
190211

191212
> [!IMPORTANT]
192-
> If you installed the v17 `msodbcsql` package that was briefly available, you should remove it before installing the `msodbcsql17` package. This will avoid conflicts. The `msodbcsql17` package can be installed side by side with the `msodbcsql` v13 package.
213+
> If you installed the v17 `msodbcsql` package that was briefly available, you should remove it before installing the `msodbcsql17` package to avoid conflicts. The `msodbcsql17` package can be installed side by side with the `msodbcsql` v13 package.
193214
194215
### [Alpine](#tab/alpine17-install)
195216

docs/connect/odbc/linux-mac/release-notes-odbc-sql-server-linux-mac.md

Lines changed: 18 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -3,11 +3,11 @@ title: Release Notes ODBC Driver for SQL Server on Linux and macOS
33
description: "Learn what's new and changed in released versions of the Microsoft ODBC Driver for SQL Server."
44
author: David-Engel
55
ms.author: davidengel
6-
ms.date: 03/17/2025
6+
ms.date: 12/17/2025
77
ms.service: sql
88
ms.subservice: connectivity
99
ms.custom: linux-related-content
10-
ms.topic: conceptual
10+
ms.topic: release-notes
1111
---
1212
# Release Notes for the Microsoft ODBC Driver for SQL Server on Linux and macOS
1313

@@ -28,6 +28,16 @@ Thank you.
2828
GeneMi. 2019/04/03.
2929
-->
3030

31+
## 18.6.1, December 2025
32+
33+
| New item | Details |
34+
| :------- | :------ |
35+
| New data type | Added support for new Vector data type (float32). |
36+
| ConcatNullYieldsNull property | Added support for ConcatNullYieldsNull as a connection string property. |
37+
| New distributions supported. | Azure Linux 3.0 ARM, Debian Linux 13, RedHat Linux 10, Ubuntu Linux 25.10 |
38+
| Azure Linux License | Changed License Acceptance Process for Azure Linux. |
39+
| Bug fixes. | [Bug fixes](../bug-fixes.md). |
40+
3141
## 18.5.1, March 2025
3242

3343
| New item | Details |
@@ -42,7 +52,7 @@ GeneMi. 2019/04/03.
4252
| :------- | :------ |
4353
| New distributions supported. | macOS 14, Ubuntu 24.04, Alpine 3.19 |
4454
| Accept EULA by file presence. | Added the ability to accept the EULA for DEB and RPM packages by the presence of a file. |
45-
| Microsoft Entra ID | Renamed all occurrences of "Azure Active Directory" to "Microsoft Entra ID". See [New name for Azure Active Directory](/entra/fundamentals/new-name) for more information. |
55+
| Microsoft Entra ID | Renamed all occurrences of "Azure Active Directory" to "Microsoft Entra ID". For more information, see [New name for Azure Active Directory](/entra/fundamentals/new-name). |
4656
| Bug fixes. | [Bug fixes](../bug-fixes.md). |
4757

4858
## 18.3.3, April 2024
@@ -124,7 +134,7 @@ GeneMi. 2019/04/03.
124134
| VBS-NONE enclave attestation protocol | New enclave attestation option to not attest the enclave. See [Using Always Encrypted](../using-always-encrypted-with-the-odbc-driver.md) |
125135
| Wildcard matching of HostnameInCertificate | Now able to use wildcard for specifying hostname, if different from default value found in Addr/Address/Server. |
126136
| ServerCertificate option | See [DSN and Connection String Attributes and Keywords](../dsn-connection-string-attribute.md). |
127-
| TrustedConnection_UseAAD option | Now only Kerberos integrated authentication is enabled when specifying Trusted_Connection=yes. Use the TrustedConnection_UseAAD option to enable the previous behavior of using either Kerberos or Azure Active Directory integrated. See [Using Azure Active Directory](../using-azure-active-directory.md) for more information. |
137+
| TrustedConnection_UseAAD option | Now only Kerberos integrated authentication is enabled when specifying Trusted_Connection=yes. Use the TrustedConnection_UseAAD option to enable the previous behavior of using either Kerberos or Azure Active Directory integrated. For more information, see [Using Azure Active Directory](../using-azure-active-directory.md). |
128138
| Bug fixes. | [Bug fixes](../bug-fixes.md). |
129139

130140
## 17.10, June 2022
@@ -285,7 +295,7 @@ New connection string attribute UseFMTOnly causes driver to use legacy metadata
285295
Support for Azure SQL Managed Instance.
286296

287297
> [!NOTE]
288-
> There are a number of differences when using Managed Instance:
298+
> There are many differences when using Managed Instance:
289299
>
290300
> - FILESTREAM isn't supported
291301
> - Local filesystem access isn't supported, but required for things like tracefiles
@@ -294,7 +304,7 @@ Support for Azure SQL Managed Instance.
294304
> - DTC isn't supported
295305
> - 'sa' account isn't present (default account is called 'cloudSA')
296306
> - TDS token ERROR (0xAA) returns incorrect server name
297-
> - Special characters in database name are not supported
307+
> - Special characters in database name aren't supported
298308
> - ALTER DATABASE [dbname1] MODIFY NAME = [dbname2] isn't supported
299309
> - The error messages are always shown in English, regardless of language settings (same as Azure)
300310
@@ -316,7 +326,7 @@ With Microsoft ODBC Driver 13.0 for SQL Server, SQL Server 2014 and SQL Server 2
316326

317327
**New distributions supported**:
318328

319-
Ubuntu is now supported, along with Red Hat and SUSE. Each platform has a platform-relevant package (RPM or DEB) to ease installation and configuration. See [Installing the Driver](installing-the-microsoft-odbc-driver-for-sql-server.md) for installation instructions.
329+
Ubuntu is now supported, along with Red Hat and SUSE. Each platform has a platform-relevant package (RPM or DEB) to ease installation and configuration. See [Installing the Driver](installing-the-microsoft-odbc-driver-for-sql-server.md) for installation instructions.
320330

321331
**unixODBC Driver Manager 2.3.1 Support**: In addition to a newer driver manager, there's also a package for installing this dependency that eases installation and configuration.
322332

@@ -332,4 +342,4 @@ The ODBC driver on Linux supports [!INCLUDE[ssHADR](../../../includes/sshadr-md.
332342

333343
The ODBC driver on Linux supports connections to Azure SQL Database.
334344

335-
The `-l` option (login time out) has been added to `bcp`. For more information, see [Connecting with **bcp**](../../../tools/bcp-utility.md).
345+
The `-l` option (login timeout) was added to `bcp`. For more information, see [Connecting with **bcp**](../../../tools/bcp-utility.md).

docs/connect/odbc/linux-mac/release-notes-tools.md

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,18 +3,26 @@ title: Release notes for mssql-tools on Linux and macOS
33
description: "Learn what's new and changed in released versions of the Microsoft SQL Server Tools."
44
author: David-Engel
55
ms.author: davidengel
6-
ms.date: 07/31/2024
6+
ms.date: 12/17/2025
77
ms.service: sql
88
ms.subservice: connectivity
99
ms.custom: linux-related-content
10-
ms.topic: conceptual
10+
ms.topic: release-notes
1111
---
1212
# Release notes for the Microsoft SQL Server tools on Linux and macOS
1313

1414
[!INCLUDE[Driver_ODBC_Download](../../../includes/driver_odbc_download.md)]
1515

1616
This article lists and describes what's new in the versioned releases of the [!INCLUDE[msCoName](../../../includes/msconame-md.md)] SQL Server Tools on Linux and macOS.
1717

18+
## 18.6.1.1, December 2025
19+
20+
| New item | Details |
21+
| :------- | :------ |
22+
| Sqlcmd command line | Added ServerCertificate option on Sqlcmd command line. |
23+
| BCP command line | Added ServerCertificate and Code Page options on BCP command line. |
24+
| Azure Linux License | Changed License Acceptance Process for Azure Linux. |
25+
1826
## 18.4.1.1, July 2024
1927

2028
| New item | Details |
@@ -83,7 +91,7 @@ This article lists and describes what's new in the versioned releases of the [!I
8391
| Feature added | Details |
8492
| :------------ | :------ |
8593
| Sqlcmd Bugfix | Fixed input redirection bug and empty lines leading to repeated execution. |
86-
| Sqlcmd Bugfix | Fixed mistaken error reporting for r, p, X and k options under certain formatting. |
94+
| Sqlcmd Bugfix | Fixed mistaken error reporting for r, p, X, and k options under certain formatting. |
8795
| Sqlcmd -z/-Z "Password" Option | Now supported. |
8896

8997
## 17.6.1.1, July 2020

0 commit comments

Comments
 (0)