Skip to content

Commit aedd7cc

Browse files
authored
Merge pull request #23551 from v-makouz/18.1_pr2
18.1 pr2
2 parents d7e7548 + 0e74a3b commit aedd7cc

3 files changed

Lines changed: 44 additions & 43 deletions

File tree

docs/connect/odbc/linux-mac/install-microsoft-odbc-driver-sql-server-macos.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Install the Microsoft ODBC driver for SQL Server (macOS)
33
description: Learn how to install the Microsoft ODBC Driver for SQL Server on macOS clients to enable database connectivity.
4-
ms.date: 02/15/2022
4+
ms.date: 08/08/2022
55
ms.prod: sql
66
ms.prod_service: connectivity
77
ms.technology: connectivity
@@ -71,19 +71,19 @@ The ODBC driver on macOS consists of the following components:
7171

7272
|Component|Description|
7373
|---------------|-----------------|
74-
|libmsodbcsql.17.dylib or libmsodbcsql.13.dylib|The dynamic library (`dylib`) file that contains all of the driver's functionality. This file is installed in `/usr/local/lib/`.|
75-
|`msodbcsqlr17.rll` or `msodbcsqlr13.rll`|The accompanying resource file for the driver library. This file is installed in `[driver .dylib directory]../share/msodbcsql17/resources/en_US/` for Driver 17 and in `[driver .dylib directory]../share/msodbcsql/resources/en_US/` for Driver 13. |
76-
|msodbcsql.h|The header file that contains all of the new definitions needed to use the driver.<br /><br /> **Note:** You can't reference msodbcsql.h and odbcss.h in the same program.<br /><br /> msodbcsql.h is installed in `/usr/local/include/msodbcsql17/` for Driver 17 and in `/usr/local/include/msodbcsql/` for Driver 13. |
77-
|LICENSE.txt|The text file that contains the terms of the End-User License Agreement. This file is placed in `/usr/local/share/doc/msodbcsql17/` for Driver 17 and in `/usr/local/share/doc/msodbcsql/` for Driver 13. |
78-
|RELEASE_NOTES|The text file that contains release notes. This file is placed in `/usr/local/share/doc/msodbcsql17/` for Driver 17 and in `/usr/local/share/doc/msodbcsql/` for Driver 13. |
74+
|libmsodbcsql.18.dylib or libmsodbcsql.17.dylib or libmsodbcsql.13.dylib|The dynamic library (`dylib`) file that contains all of the driver's functionality. This file is installed in `/usr/local/lib/`.|
75+
|`msodbcsqlr18.rll` or `msodbcsqlr17.rll` or `msodbcsqlr13.rll`|The accompanying resource file for the driver library. This file is installed in `[driver .dylib directory]../share/msodbcsql18/resources/en_US/` for Driver 18, `[driver .dylib directory]../share/msodbcsql17/resources/en_US/` for Driver 17, and in `[driver .dylib directory]../share/msodbcsql/resources/en_US/` for Driver 13. |
76+
|msodbcsql.h|The header file that contains all of the new definitions needed to use the driver.<br /><br /> **Note:** You can't reference msodbcsql.h and odbcss.h in the same program.<br /><br /> msodbcsql.h is installed in `/usr/local/include/msodbcsql18/` for Driver 18, `/usr/local/include/msodbcsql17/` for Driver 17, and in `/usr/local/include/msodbcsql/` for Driver 13. |
77+
|LICENSE.txt|The text file that contains the terms of the End-User License Agreement. This file is placed in `/usr/local/share/doc/msodbcsql18/` for Driver 18, `/usr/local/share/doc/msodbcsql17/` for Driver 17, and in `/usr/local/share/doc/msodbcsql/` for Driver 13. |
78+
|RELEASE_NOTES|The text file that contains release notes. This file is placed in `/usr/local/share/doc/msodbcsql18/` for Driver 18, `/usr/local/share/doc/msodbcsql17/` for Driver 17, and in `/usr/local/share/doc/msodbcsql/` for Driver 13. |
7979

8080
## Resource file loading
8181

82-
The driver needs to load the resource file in order to function. This file is called `msodbcsqlr17.rll` or `msodbcsqlr13.rll` depending on the driver version. The location of the `.rll` file is relative to the location of the driver itself (`so` or `dylib`), as noted in the component table. As of version 17.1 the driver will also attempt to load the `.rll` from the default directory if loading from the relative path fails. The default resource file path on macOS is `/usr/local/share/msodbcsql17/resources/en_US/`
82+
The driver needs to load the resource file in order to function. This file is called `msodbcsqlr18.rll`, `msodbcsqlr17.rll`, or `msodbcsqlr13.rll` depending on the driver version. The location of the `.rll` file is relative to the location of the driver itself (`so` or `dylib`), as noted in the component table. As of version 17.1 the driver will also attempt to load the `.rll` from the default directory if loading from the relative path fails. The default resource file path on macOS is `/usr/local/share/msodbcsql18/resources/en_US/`
8383

8484
## Troubleshooting
8585

86-
Some users encounter an issue when trying to connect after installing the ODBC driver and receive an error like: `"[01000] [unixODBC][Driver Manager]Can't open lib 'ODBC Driver 17 for SQL Server' : file not found (0) (SQLDriverConnect)"`. It may be the case that unixODBC isn't configured correctly to find registered drivers. In these cases, creating symbolic links can resolve the issue.
86+
Some users encounter an issue when trying to connect after installing the ODBC driver and receive an error like: `"[01000] [unixODBC][Driver Manager]Can't open lib 'ODBC Driver 18 for SQL Server' : file not found (0) (SQLDriverConnect)"`. It may be the case that unixODBC isn't configured correctly to find registered drivers. In these cases, creating symbolic links can resolve the issue.
8787

8888
```bash
8989
sudo ln -s /usr/local/etc/odbcinst.ini /etc/odbcinst.ini

docs/connect/odbc/linux-mac/system-requirements.md

Lines changed: 33 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: System Requirements (ODBC Driver for SQL Server)
33
description: This lists the system requirements for the ODBC Driver for SQL Server on Linux and macOS operating systems.
44
ms.custom: ""
5-
ms.date: 06/30/2022
5+
ms.date: 08/08/2022
66
ms.prod: sql
77
ms.prod_service: connectivity
88
ms.reviewer: ""
@@ -28,41 +28,40 @@ The Linux and macOS drivers SQL version compatibility is the same as the [Window
2828

2929
## Operating system support
3030

31-
Versions 18, 17, 13.1, and 13 of the Linux and macOS drivers are supported on the x64 architecture of the following operating systems. The ARM64 architecture on macOS is supported starting with version 17.8.
31+
Versions 18, 17, 13.1, and 13 of the Linux and macOS drivers are supported on the x64 architecture of the following operating systems. The ARM64 architecture on macOS is supported starting with version 17.8. The ARM64 architecture on Red Hat 8, 9, Debian 11, and Ubuntu 18.04, 20.04, 22.04 are supported starting with version 18.1.
3232

33-
|Driver version&nbsp;&#8594;<br />&#8595; Operating System |18.0|17.10|17.9|17.8|17.7|17.6|17.5|17.4|17.3|17.2|17.1|17.0|13.1|13|
33+
|Driver version&nbsp;&#8594;<br />&#8595; Operating System |18.1|18.0|17.10|17.9|17.8|17.7|17.6|17.5|17.4|17.3|17.2|17.1|17.0|13.1|13|
3434
|-------------------------------|----|----|----|----|----|----|----|----|----|----|----|----|----|---|
35-
|Apple OS X 10.11 (El Capitan) | | | | | | | |Yes |Yes |Yes |Yes |Yes |Yes |Yes|
36-
|Apple macOS 10.12 (Sierra) | | | | | | | |Yes |Yes |Yes |Yes |Yes |Yes |Yes|
37-
|Apple macOS 10.13 (High Sierra)| | | | | |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes|
38-
|Apple macOS 10.14 (Mojave) | | | |Yes |Yes |Yes |Yes |Yes |Yes | | | | | |
39-
|Apple macOS 10.15 (Catalina) |Yes |Yes |Yes |Yes |Yes |Yes |Yes | | | | | | | |
40-
|Apple macOS 11.0 (Big Sur) |Yes |Yes |Yes |Yes |Yes | | | | | | | | | |
41-
|Apple macOS 12.0 (Monterey) |Yes |Yes |Yes | | | | | | | | | | | |
42-
|Alpine Linux 3.11 | | | |Yes |Yes |Yes |Yes | | | | | | | |
43-
|Alpine Linux 3.12 |Yes |Yes |Yes |Yes |Yes | | | | | | | | | |
44-
|Alpine Linux 3.13 |Yes |Yes |Yes |Yes |Yes | | | | | | | | | |
45-
|Alpine Linux 3.14 |Yes |Yes |Yes |Yes |Yes | | | | | | | | | |
46-
|Alpine Linux 3.15 |Yes |Yes |Yes |Yes |Yes | | | | | | | | | |
47-
|Debian Linux 8 | | | | | |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes|
48-
|Debian Linux 9 |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes|
49-
|Debian Linux 10 |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes | | | | | | |
50-
|Debian Linux 11 |Yes |Yes |Yes | | | | | | | | | | | |
51-
|Oracle Linux 7 |Yes |Yes |Yes |Yes |Yes | | | | | | | | | |
52-
|Oracle Linux 8 |Yes |Yes |Yes |Yes |Yes |Yes |Yes | | | | | | | |
53-
|Red Hat Enterprise Linux 6 | | | | |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes|
54-
|Red Hat Enterprise Linux 7 |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes|
55-
|Red Hat Enterprise Linux 8 |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes | | | | | | |
56-
|Red Hat Enterprise Linux 9 | |Yes | | | | | | | | | | | | |
57-
|SUSE Linux Enterprise Server 11<sup>1</sup>| |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes|
58-
|SUSE Linux Enterprise Server 12|Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes|
59-
|SUSE Linux Enterprise Server 15|Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes | | | | | |
60-
|Ubuntu Linux 14.04 | | | | | | | |Yes |Yes |Yes |Yes |Yes |Yes |Yes|
61-
|Ubuntu Linux 16.04 | | | |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes|
62-
|Ubuntu Linux 18.04 |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes | | | | |
63-
|Ubuntu Linux 20.04 |Yes |Yes |Yes |Yes |Yes |Yes | | | | | | | | |
64-
|Ubuntu Linux 21.10 |Yes |Yes |Yes | | | | | | | | | | | |
65-
|Ubuntu Linux 22.04 | |Yes | | | | | | | | | | | | |
35+
|Apple OS X 10.11 (El Capitan) | | | | | | | | |Yes |Yes |Yes |Yes |Yes |Yes |Yes|
36+
|Apple macOS 10.12 (Sierra) | | | | | | | | |Yes |Yes |Yes |Yes |Yes |Yes |Yes|
37+
|Apple macOS 10.13 (High Sierra)| | | | | | |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes|
38+
|Apple macOS 10.14 (Mojave) | | | | |Yes |Yes |Yes |Yes |Yes |Yes | | | | | |
39+
|Apple macOS 10.15 (Catalina) |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes | | | | | | | |
40+
|Apple macOS 11.0 (Big Sur) |Yes |Yes |Yes |Yes |Yes |Yes | | | | | | | | | |
41+
|Apple macOS 12.0 (Monterey) |Yes |Yes |Yes |Yes | | | | | | | | | | | |
42+
|Alpine Linux 3.11 | | | | |Yes |Yes |Yes |Yes | | | | | | | |
43+
|Alpine Linux 3.12 | |Yes |Yes |Yes |Yes |Yes | | | | | | | | | |
44+
|Alpine Linux 3.13 |Yes |Yes |Yes |Yes |Yes |Yes | | | | | | | | | |
45+
|Alpine Linux 3.14 |Yes |Yes |Yes |Yes |Yes |Yes | | | | | | | | | |
46+
|Alpine Linux 3.15 |Yes |Yes |Yes |Yes |Yes |Yes | | | | | | | | | |
47+
|Debian Linux 8 | | | | | | |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes|
48+
|Debian Linux 9 | |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes|
49+
|Debian Linux 10 |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes | | | | | | |
50+
|Debian Linux 11 |Yes |Yes |Yes |Yes | | | | | | | | | | | |
51+
|Oracle Linux 7 |Yes |Yes |Yes |Yes |Yes |Yes | | | | | | | | | |
52+
|Oracle Linux 8 |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes | | | | | | | |
53+
|Red Hat Enterprise Linux 6 | | | | | |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes|
54+
|Red Hat Enterprise Linux 7 |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes|
55+
|Red Hat Enterprise Linux 8 |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes | | | | | | |
56+
|Red Hat Enterprise Linux 9 |Yes | |Yes | | | | | | | | | | | | |
57+
|SUSE Linux Enterprise Server 11<sup>1</sup>| | |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes|
58+
|SUSE Linux Enterprise Server 12|Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes|
59+
|SUSE Linux Enterprise Server 15|Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes | | | | | |
60+
|Ubuntu Linux 14.04 | | | | | | | | |Yes |Yes |Yes |Yes |Yes |Yes |Yes|
61+
|Ubuntu Linux 16.04 | | | | |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes|
62+
|Ubuntu Linux 18.04 |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes | | | | |
63+
|Ubuntu Linux 20.04 |Yes |Yes |Yes |Yes |Yes |Yes |Yes | | | | | | | | |
64+
|Ubuntu Linux 22.04 |Yes | |Yes | | | | | | | | | | | | |
6665

6766
<sup>1</sup> ODBC Driver 17 supports SUSE Linux Enterprise Server 11 SP4 only
6867

docs/connect/odbc/windows/system-requirements-installation-and-driver-files.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: System Requirements, Installation, and Driver Files
33
description: This article describes the system requirements for the Microsoft ODBC Driver for SQL Server.
44
ms.custom: ""
5-
ms.date: 06/30/2022
5+
ms.date: 08/08/2022
66
ms.prod: sql
77
ms.prod_service: connectivity
88
ms.reviewer: ""
@@ -24,6 +24,7 @@ Compatibility indicates that a driver was tested for compatibility against exist
2424

2525
|Database version&nbsp;&#8594;<br />&#8595; Driver Version|Azure SQL Database|Azure Synapse Analytics|Azure SQL Managed Instance|SQL Server 2019|SQL Server 2017|SQL Server 2016|SQL Server 2014|SQL Server 2012|SQL Server 2008 R2|SQL Server 2008|SQL Server 2005|
2626
|----|---|---|---|---|---|---|---|---|---|---|---|
27+
|18.1|Yes|Yes|Yes|Yes|Yes|Yes|Yes| | | | |
2728
|18.0|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes| | | |
2829
|17.10|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes| | | |
2930
|17.9|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes| | | |
@@ -56,6 +57,7 @@ The following matrix indicates driver version support for Windows operating syst
5657

5758
|Operating system&nbsp;&#8594;<br />&#8595; Driver version|Windows Server 2022|Windows Server 2019|Windows Server 2016|Windows Server 2012 R2|Windows Server 2012|Windows Server 2008 R2|Windows 11|Windows 10|Windows 8.1|Windows 7|Windows Vista SP2|
5859
|----|---|---|---|---|---|---|---|---|---|---|---|
60+
|18.1|Yes|Yes|Yes|Yes|Yes| |Yes|Yes|Yes| | |
5961
|18.0|Yes|Yes|Yes|Yes|Yes| |Yes|Yes|Yes| | |
6062
|17.10|Yes|Yes|Yes|Yes|Yes| |Yes|Yes|Yes| | |
6163
|17.9|Yes|Yes|Yes|Yes|Yes| |Yes|Yes|Yes| | |

0 commit comments

Comments
 (0)