Merge pull request #21280 from MicrosoftDocs/main

2/17 AM Publish

Author: huypub

docs/connect/odbc/bug-fixes.md

@@ -2,7 +2,7 @@
 title: "List of bugs fixed"
 description: "This page contains a listing of bugs fixed in each release, starting with Microsoft ODBC Driver 17 for SQL Server."
 ms.custom: ""
-ms.date: "02/15/2022"
+ms.date: "02/17/2022"
 ms.prod: sql
 ms.prod_service: connectivity
 ms.reviewer: v-davidengel
@@ -27,6 +27,14 @@ This page contains a listing of bugs fixed in each release, starting with [!INCL
 - Fixed loss of Azure Active Directory authentication mode when reconnecting an idle connection.
 - Fix an issue with federated authentication when using PingFed.
 
+### Bug fixes in the [!INCLUDE[msCoName](../../includes/msconame_md.md)] ODBC Driver 17.9 for [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)]
+
+- Fix UI issues where text was cut off and position of items was off.
+- Fix issue with Active Directory Interactive login where attempting to login after closing the window of the first failure would automatically succeed if cached credentials were available.
+- Fixed use of XADTC with Azure SQL Managed Instance.
+- Fixed loss of Azure Active Directory authentication mode when reconnecting an idle connection.
+- Fix an issue with federated authentication when using PingFed.
+
 ### Bug fixes in the [!INCLUDE[msCoName](../../includes/msconame_md.md)] ODBC Driver 17.8 for [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)]
 
 - Fix for restrictions on connection string regarding usage of `UID` and `PWD` keywords

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

@@ -1,7 +1,7 @@
 ---
 title: Download ODBC Driver for SQL Server
 description: Download the Microsoft ODBC Driver for SQL Server to develop native-code applications that connect to SQL Server and Azure SQL Database.
-ms.date: 02/15/2022
+ms.date: 02/17/2022
 ms.prod: sql
 ms.prod_service: connectivity
 ms.reviewer: ""
@@ -45,6 +45,22 @@ Microsoft ODBC Driver 18.0.1.1 for SQL Server (x64):
 Microsoft ODBC Driver 18.0.1.1 for SQL Server (x86):  
 [Chinese (Simplified)](https://go.microsoft.com/fwlink/?linkid=2187028&clcid=0x804) | [Chinese (Traditional)](https://go.microsoft.com/fwlink/?linkid=2187028&clcid=0x404) | [English (United States)](https://go.microsoft.com/fwlink/?linkid=2187028&clcid=0x409) | [French](https://go.microsoft.com/fwlink/?linkid=2187028&clcid=0x40c) | [German](https://go.microsoft.com/fwlink/?linkid=2187028&clcid=0x407) | [Italian](https://go.microsoft.com/fwlink/?linkid=2187028&clcid=0x410) | [Japanese](https://go.microsoft.com/fwlink/?linkid=2187028&clcid=0x411) | [Korean](https://go.microsoft.com/fwlink/?linkid=2187028&clcid=0x412) | [Portuguese (Brazil)](https://go.microsoft.com/fwlink/?linkid=2187028&clcid=0x416) | [Russian](https://go.microsoft.com/fwlink/?linkid=2187028&clcid=0x419) | [Spanish](https://go.microsoft.com/fwlink/?linkid=2187028&clcid=0x40a)
 
+Version 17.9.1 is the latest general availability (GA) version of the 17.x driver. If you have a previous version of Microsoft ODBC Driver 17 for SQL Server installed, installing 17.9.1 upgrades it to 17.9.1.
+
+**[![Download](../../ssms/media/download-icon.png) Download Microsoft ODBC Driver 17 for SQL Server (x64)](https://go.microsoft.com/fwlink/?linkid=2187214)**  
+**[![Download](../../ssms/media/download-icon.png) Download Microsoft ODBC Driver 17 for SQL Server (x86)](https://go.microsoft.com/fwlink/?linkid=2187215)**  
+
+- Release number: 17.9.1.1
+- Released: February 17, 2022
+
+This release of Microsoft ODBC Driver for SQL Server can be installed in the following languages:
+
+Microsoft ODBC Driver 17.9.1.1 for SQL Server (x64):  
+[Chinese (Simplified)](https://go.microsoft.com/fwlink/?linkid=2187214&clcid=0x804) | [Chinese (Traditional)](https://go.microsoft.com/fwlink/?linkid=2187214&clcid=0x404) | [English (United States)](https://go.microsoft.com/fwlink/?linkid=2187214&clcid=0x409) | [French](https://go.microsoft.com/fwlink/?linkid=2187214&clcid=0x40c) | [German](https://go.microsoft.com/fwlink/?linkid=2187214&clcid=0x407) | [Italian](https://go.microsoft.com/fwlink/?linkid=2187214&clcid=0x410) | [Japanese](https://go.microsoft.com/fwlink/?linkid=2187214&clcid=0x411) | [Korean](https://go.microsoft.com/fwlink/?linkid=2187214&clcid=0x412) | [Portuguese (Brazil)](https://go.microsoft.com/fwlink/?linkid=2187214&clcid=0x416) | [Russian](https://go.microsoft.com/fwlink/?linkid=2187214&clcid=0x419) | [Spanish](https://go.microsoft.com/fwlink/?linkid=2187214&clcid=0x40a)
+
+Microsoft ODBC Driver 17.9.1.1 for SQL Server (x86):  
+[Chinese (Simplified)](https://go.microsoft.com/fwlink/?linkid=2187215&clcid=0x804) | [Chinese (Traditional)](https://go.microsoft.com/fwlink/?linkid=2187215&clcid=0x404) | [English (United States)](https://go.microsoft.com/fwlink/?linkid=2187215&clcid=0x409) | [French](https://go.microsoft.com/fwlink/?linkid=2187215&clcid=0x40c) | [German](https://go.microsoft.com/fwlink/?linkid=2187215&clcid=0x407) | [Italian](https://go.microsoft.com/fwlink/?linkid=2187215&clcid=0x410) | [Japanese](https://go.microsoft.com/fwlink/?linkid=2187215&clcid=0x411) | [Korean](https://go.microsoft.com/fwlink/?linkid=2187215&clcid=0x412) | [Portuguese (Brazil)](https://go.microsoft.com/fwlink/?linkid=2187215&clcid=0x416) | [Russian](https://go.microsoft.com/fwlink/?linkid=2187215&clcid=0x419) | [Spanish](https://go.microsoft.com/fwlink/?linkid=2187215&clcid=0x40a)
+
 ### Release notes for Windows
 
 For details about this release on Windows, see [the Windows release notes](windows\release-notes-odbc-sql-server-windows.md).
@@ -67,6 +83,7 @@ If you need to download the packages for offline installation, all versions are
 ### Alpine
 
 - [18.0.1.1 Alpine package](https://download.microsoft.com/download/b/9/f/b9f3cce4-3925-46d4-9f46-da08869c6486/msodbcsql18_18.0.1.1-1_amd64.apk) ([PGP Signature](https://download.microsoft.com/download/b/9/f/b9f3cce4-3925-46d4-9f46-da08869c6486/msodbcsql18_18.0.1.1-1_amd64.sig))
+- [17.9.1.1 Alpine package](https://download.microsoft.com/download/e/4/e/e4e67866-dffd-428c-aac7-8d28ddafb39b/msodbcsql17_17.9.1.1-1_amd64.apk) ([PGP Signature](https://download.microsoft.com/download/e/4/e/e4e67866-dffd-428c-aac7-8d28ddafb39b/msodbcsql17_17.9.1.1-1_amd64.sig))
 - [17.8.1.1 Alpine package](https://download.microsoft.com/download/e/4/e/e4e67866-dffd-428c-aac7-8d28ddafb39b/msodbcsql17_17.8.1.1-1_amd64.apk) ([PGP Signature](https://download.microsoft.com/download/e/4/e/e4e67866-dffd-428c-aac7-8d28ddafb39b/msodbcsql17_17.8.1.1-1_amd64.sig))
 - [17.7.2.1 Alpine package](https://download.microsoft.com/download/e/4/e/e4e67866-dffd-428c-aac7-8d28ddafb39b/msodbcsql17_17.7.2.1-1_amd64.apk) ([PGP Signature](https://download.microsoft.com/download/e/4/e/e4e67866-dffd-428c-aac7-8d28ddafb39b/msodbcsql17_17.7.2.1-1_amd64.sig))
 - [17.7.1.1 Alpine package](https://download.microsoft.com/download/e/4/e/e4e67866-dffd-428c-aac7-8d28ddafb39b/msodbcsql17_17.7.1.1-1_amd64.apk) ([PGP Signature](https://download.microsoft.com/download/e/4/e/e4e67866-dffd-428c-aac7-8d28ddafb39b/msodbcsql17_17.7.1.1-1_amd64.sig))

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

@@ -1,7 +1,7 @@
 ---
 title: Install the Microsoft ODBC driver for SQL Server (Linux)
 description: Learn how to install the Microsoft ODBC Driver for SQL Server on Linux clients to enable database connectivity.
-ms.date: 02/15/2022
+ms.date: 02/17/2022
 ms.prod: sql
 ms.prod_service: connectivity
 ms.technology: connectivity
@@ -201,22 +201,22 @@ The following sections explain how to install the Microsoft ODBC driver 17 from
 
 ```bash
 #Download the desired package(s)
-curl -O https://download.microsoft.com/download/e/4/e/e4e67866-dffd-428c-aac7-8d28ddafb39b/msodbcsql17_17.8.1.1-1_amd64.apk
-curl -O https://download.microsoft.com/download/e/4/e/e4e67866-dffd-428c-aac7-8d28ddafb39b/mssql-tools_17.8.1.1-1_amd64.apk
+curl -O https://download.microsoft.com/download/e/4/e/e4e67866-dffd-428c-aac7-8d28ddafb39b/msodbcsql17_17.9.1.1-1_amd64.apk
+curl -O https://download.microsoft.com/download/e/4/e/e4e67866-dffd-428c-aac7-8d28ddafb39b/mssql-tools_17.9.1.1-1_amd64.apk
 
 
 #(Optional) Verify signature, if 'gpg' is missing install it using 'apk add gnupg':
-curl -O https://download.microsoft.com/download/e/4/e/e4e67866-dffd-428c-aac7-8d28ddafb39b/msodbcsql17_17.8.1.1-1_amd64.sig
-curl -O https://download.microsoft.com/download/e/4/e/e4e67866-dffd-428c-aac7-8d28ddafb39b/mssql-tools_17.8.1.1-1_amd64.sig
+curl -O https://download.microsoft.com/download/e/4/e/e4e67866-dffd-428c-aac7-8d28ddafb39b/msodbcsql17_17.9.1.1-1_amd64.sig
+curl -O https://download.microsoft.com/download/e/4/e/e4e67866-dffd-428c-aac7-8d28ddafb39b/mssql-tools_17.9.1.1-1_amd64.sig
 
 curl https://packages.microsoft.com/keys/microsoft.asc  | gpg --import -
-gpg --verify msodbcsql17_17.8.1.1-1_amd64.sig msodbcsql17_17.8.1.1-1_amd64.apk
-gpg --verify mssql-tools_17.8.1.1-1_amd64.sig mssql-tools_17.8.1.1-1_amd64.apk
+gpg --verify msodbcsql17_17.9.1.1-1_amd64.sig msodbcsql17_17.9.1.1-1_amd64.apk
+gpg --verify mssql-tools_17.9.1.1-1_amd64.sig mssql-tools_17.9.1.1-1_amd64.apk
 
 
 #Install the package(s)
-sudo apk add --allow-untrusted msodbcsql17_17.8.1.1-1_amd64.apk
-sudo apk add --allow-untrusted mssql-tools_17.8.1.1-1_amd64.apk
+sudo apk add --allow-untrusted msodbcsql17_17.9.1.1-1_amd64.apk
+sudo apk add --allow-untrusted mssql-tools_17.9.1.1-1_amd64.apk
 ```
 
 > [!NOTE]
@@ -240,6 +240,9 @@ curl https://packages.microsoft.com/config/debian/9/prod.list > /etc/apt/sources
 #Debian 10
 curl https://packages.microsoft.com/config/debian/10/prod.list > /etc/apt/sources.list.d/mssql-release.list
 
+#Debian 11
+curl https://packages.microsoft.com/config/debian/11/prod.list > /etc/apt/sources.list.d/mssql-release.list
+
 exit
 sudo apt-get update
 sudo ACCEPT_EULA=Y apt-get install -y msodbcsql17
@@ -319,7 +322,7 @@ sudo zypper install -y unixODBC-devel
 ### <a id="ubuntu17"></a> Ubuntu
 
 ```bash
-if ! [[ "16.04 18.04 20.04 21.04" == *"$(lsb_release -rs)"* ]];
+if ! [[ "16.04 18.04 20.04 21.04 21.10" == *"$(lsb_release -rs)"* ]];
 then
     echo "Ubuntu $(lsb_release -rs) is not currently supported.";
     exit;

docs/connect/odbc/linux-mac/known-issues-in-this-version-of-the-driver.md

@@ -1,7 +1,7 @@
 ---
 title: Known issues for the ODBC driver on Linux and macOS
 description: "Learn about known issues with the Microsoft ODBC Driver for SQL Server on Linux and macOS and steps for troubleshooting connectivity issues."
-ms.date: 02/15/2022
+ms.date: 02/17/2022
 ms.prod: sql
 ms.reviewer: ""
 ms.technology: connectivity
@@ -70,7 +70,7 @@ UNICODE Using encoding ASCII 'ISO8859-1' and UNICODE 'UCS-2LE'
 There's more than one driver manager installed and your application is using the wrong one, or the driver manager wasn't built correctly.
 
 Some macOS users encounter the following error with driver version 17.8 or older:\
-(This error has been resolved in driver version 18.0+)
+(This error has been resolved in driver version 17.9+)
 
 ```text
 [08001][Microsoft][ODBC Driver 17 for SQL Server]SSL Provider: [OpenSSL library could not be loaded, make sure OpenSSL 1.0 or 1.1 is installed]

docs/connect/odbc/linux-mac/programming-guidelines.md

@@ -3,7 +3,7 @@ title: Programming guidelines
 
 description: The programming features of the ODBC Driver for SQL Server on macOS and Linux contain some differences from the Windows versions.
 ms.custom: ""
-ms.date: 02/15/2022
+ms.date: 02/17/2022
 ms.prod: sql
 ms.prod_service: connectivity
 ms.reviewer: v-davidengel
@@ -121,12 +121,12 @@ In ODBC Driver 13 and 13.1, when UTF-8 multibyte characters or UTF-16 surrogates
 
 ## <a name="bkmk-openssl"></a>OpenSSL
 
-Starting with version 17.4, the driver loads OpenSSL dynamically, which allows it to run on systems that have either version 1.0 or 1.1 without a need for separate driver files. Starting with version 18.0, the driver supports OpenSSL 3.0 in addition to the previous versions. When multiple versions of OpenSSL are present, the driver will attempt to load the latest one.
+Starting with version 17.4, the driver loads OpenSSL dynamically, which allows it to run on systems that have either version 1.0 or 1.1 without a need for separate driver files. Starting with version 17.9, the driver supports OpenSSL 3.0 in addition to the previous versions. When multiple versions of OpenSSL are present, the driver will attempt to load the latest one.
 
 | Driver version      | Supported OpenSSL versions |
 |---------------------|----------------------------|
 | 17.4+               | 1.0, 1.1                   |
-| 18.0                | 1.0, 1.1, 3.0              |
+| 17.9, 18.0+         | 1.0, 1.1, 3.0              |
 
 
 > [!NOTE]

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

@@ -2,7 +2,7 @@
 title: Release Notes ODBC Driver for SQL Server on Linux and macOS
 description: "Learn what's new and changed in released versions of the Microsoft ODBC Driver for SQL Server."
 ms.custom: ""
-ms.date: 02/15/2022
+ms.date: 02/17/2022
 ms.prod: sql
 ms.prod_service: connectivity
 ms.reviewer: v-davidengel
@@ -43,6 +43,15 @@ GeneMi.  2019/04/03.
 | Bug fixes. | [Bug fixes](../bug-fixes.md). |
 |   |   |
 
+## 17.9, February 2022
+
+| New item | Details |
+| :------- | :------ |
+| New distributions supported. | Debian 11, Ubuntu 21.10, macOS 12 |
+| Added compatibility with OpenSSL 3.0 | See [Connection String Keywords and Data Source Names](connection-string-keywords-and-data-source-names-dsns.md#using-tlsssl). |
+| Bug fixes. | [Bug fixes](../bug-fixes.md). |
+|   |   |
+
 ## 17.8.1.2, October 2021
 
 | New item | Details |

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

@@ -2,7 +2,7 @@
 title: Release notes for mssql-tools on Linux and macOS
 description: "Learn what's new and changed in released versions of the Microsoft SQL Server Tools."
 ms.custom: ""
-ms.date: 02/15/2022
+ms.date: 02/17/2022
 ms.prod: sql
 ms.prod_service: connectivity
 ms.reviewer: v-davidengel
@@ -26,6 +26,13 @@ This article lists and describes what's new in the versioned releases of the [!I
 | TDS 8.0 | Add support for TDS 8.0 strict encryption |
 |   |   |
 
+## 17.9.1.1, February 2022
+
+| New item | Details |
+| :------- | :------ |
+| Sqlcmd Bugfix | Fixed extraneous trailing bytes after encoding conversion. |
+|   |   |
+
 ## 17.8.1.2, October 2021
 
 | New item | Details |