本文介绍如何在 macOS 上安装 Microsoft ODBC Driver for SQL Server。 本文还包括有关 SQL Server 的可选命令行工具(bcp 和 sqlcmd)以及 unixODBC 开发标头的说明。
本文提供了用于从 bash shell 安装 ODBC 驱动程序的命令。 如果要直接下载包,请参阅下载 ODBC Driver for SQL Server。
选择驱动版本
对于新应用,请使用 Driver 18。 驱动程序 17 对于需要版本 17 行为的应用程序仍然受到支持。 在将应用程序从 Driver 17 升级到 Driver 18 之前,请查看 主要版本差异,包括加密默认值的更改。 有关支持日期,请参见 支持生命周期。
下表展示了本文中命令中使用的驱动程序和命令行工具配方:
| Version | 驱动程序公式 | 可选工具公式 |
|---|---|---|
| 18 | msodbcsql18 |
mssql-tools18 |
| 17 | msodbcsql17 |
mssql-tools |
注意
macOS 上驱动版本到 17.7 仅支持 x64。 从 Driver 17.8 开始,macOS 软件包同时支持 x64 和 Apple ARM64。 Homebrew公式检测架构并安装匹配的软件包。 如果你的命令提示符在 ARM64 上以 x64 仿真模式运行,Homebrew 会安装 x64 软件包。
使用 Homebrew 安装时,请使用unixODBC。 驱动程序 17 和 Driver 18 的公式将 unixODBC 作为依赖安装。 如果其他设置使用 iODBC,请确保驱动程序库和驱动程序管理器针对的是相同的架构。 架构不匹配可能导致诸如 incompatible architecture (have 'arm64', need 'x86_64')的错误。
准备 Homebrew
如果未安装 Homebrew,请按照 Homebrew 的安装说明操作。 安装后,按照安装程序打印的 shell 配置说明操作,然后运行 brew --version 以确认 brew 可用。 Homebrew 在 Apple 芯片上的默认前缀是 /opt/homebrew。
Microsoft ODBC 18
若要在 macOS 上安装 Microsoft ODBC Driver 18 for SQL Server,请运行以下命令:
brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release
brew update
HOMEBREW_ACCEPT_EULA=Y brew install msodbcsql18 mssql-tools18
如果 Homebrew 拒绝从不受信任的 tap 加载公式,请在授予信任前先验证该公式的官方名称并点击。 要只信任 Driver 18 的公式,请运行:
brew trust --formula microsoft/mssql-release/msodbcsql18
brew trust --formula microsoft/mssql-release/mssql-tools18
然后重试安装。
更新或验证驱动程序安装
要更新驱动程序,请刷新 Homebrew 并升级同一主版本的配方。 替换 msodbcsql18 为 msodbcsql17 以更新驱动程序17。 要在主要版本之间迁移,请安装另一个 formula,并配置您的应用程序使用其驱动程序名称。 两种 formula 可以同时安装。
brew update && HOMEBREW_ACCEPT_EULA=Y brew upgrade msodbcsql18
设置为 driver_version17 或 18,然后检查已安装的公式版本、unixODBC 注册、macOS 架构和驱动程序库架构:
| 驱动程序版本 | driver_formula |
driver_name |
驱动库 |
|---|---|---|---|
| 18 | msodbcsql18 |
ODBC Driver 18 for SQL Server |
libmsodbcsql.18.dylib |
| 17 | msodbcsql17 |
ODBC Driver 17 for SQL Server |
libmsodbcsql.17.dylib |
set -e
driver_version=18
driver_formula="msodbcsql${driver_version}"
driver_name="ODBC Driver ${driver_version} for SQL Server"
driver_library="$(brew --prefix "$driver_formula")/lib/libmsodbcsql.${driver_version}.dylib"
brew list --versions "$driver_formula"
odbcinst -q -d -n "$driver_name"
uname -m
file "$driver_library"
这些命令报告已安装的公式版本、注册的驱动程序名称、macOS 架构以及驱动程序库架构。 默认情况下,Homebrew 公式会注册驱动程序。 如果您安装了带有该 --without-registration 选项的公式,注册查询会失败,并且该过程会在架构检查前停止。
卸载或重新安装驱动程序 17 或驱动程序 18
在移除驱动程序之前,先关闭使用该驱动程序的应用程序。 如果您安装了可选工具,请先卸载它们。 对于驱动程序 17,请替换 mssql-tools18 为 mssql-tools:
HOMEBREW_NO_AUTOREMOVE=1 brew uninstall mssql-tools18
Homebrew 可以在 brew uninstall 期间自动移除未使用的依赖项。 为这两个卸载命令设置 HOMEBREW_NO_AUTOREMOVE=1,以保持 unixODBC 可用,直到您取消注册并验证驱动程序。 如果你运行 brew autoremove,请等到完成该验证后再运行。
然后卸载驱动程序。 替换 msodbcsql18 为 msodbcsql17 以移除驱动程序17:
HOMEBREW_NO_AUTOREMOVE=1 brew uninstall msodbcsql18
如果 Homebrew 报告说另一个 formula 依赖于该驱动,请在继续前仔细查看该依赖关系。 不要强制移除已安装工具所需的驱动程序。
卸载注册了该驱动程序的软件包后,移除其注册。 对于驱动程序 17,请替换 18 为 17:
odbcinst -u -d -n "ODBC Driver 18 for SQL Server"
移除注册后,运行 odbcinst -q -d。 如果它列出了驱动程序名称,请确认已移除的驱动程序名称未被列出。 如果报告了 SQLGetPrivateProfileString failed,就运行 odbcinst -j 并检查它报告的 DRIVERS 路径。 如果驱动程序配置文件存在、可读且不包含驱动程序注册,则没有任何驱动程序仍处于已注册状态。 如果文件缺失、无法读取,或仍包含已移除驱动程序的条目,请在将移除视为完成之前解决该配置问题。 要重新安装,请对同一主要版本重复安装命令,然后重复验证。 卸载驱动程序可能会阻止按该驱动程序名称请求的应用程序进行连接。 不要手动删除驱动程序库或驱动程序管理器配置文件。
Microsoft ODBC 17
若要在 macOS 上安装 Microsoft ODBC Driver 17 for SQL Server,请运行以下命令:
brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release
brew update
HOMEBREW_ACCEPT_EULA=Y brew install msodbcsql17 mssql-tools
如果 Homebrew 拒绝从不受信任的 tap 加载公式,请在授予信任前先验证该公式的官方名称并点击。 只信任 Driver 17 的公式,请运行:
brew trust --formula microsoft/mssql-release/msodbcsql17
brew trust --formula microsoft/mssql-release/mssql-tools
然后重试安装。
你可以同时安装 msodbcsql18 和 msodbcsql17 driver 公式。
mssql-tools和mssql-tools18公式都提供了sqlcmd和bcp,所以 Homebrew 无法将两者关联起来。 如果已安装 mssql-tools18,前述命令会安装 mssql-tools,但会报告 brew link 步骤未完成,而 sqlcmd 和 bcp 将继续运行版本 18 的工具。 在已安装驱动程序 18 工具的情况下,要添加驱动程序 17,请仅安装驱动程序:
HOMEBREW_ACCEPT_EULA=Y brew install msodbcsql17
重要
如果您安装了短暂可用的 v17 msodbcsql 包,请在安装 msodbcsql17 前将其卸载,以避免冲突。 你可以将 msodbcsql 与 v13 msodbcsql17 包并排安装。
早期版本
以下部分提供了驱动程序 13.1 的安装说明。
ODBC 13.1 版
这些命令记录了 OS X 10.11(El Capitan)和 macOS 10.12(Sierra)的历史驱动程序 13.1 路径。 Homebrew 当前支持的安装要求 列出了macOS Sequoia(15)或更高版本;它们不包括这些较旧的系统。
brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release
brew update
brew install msodbcsql@13.1.9.2 mssql-tools@14.0.6.0
驱动程序文件
macOS 上的关键 ODBC 驱动程序文件包括:
| 组件 | 说明 |
|---|---|
libmsodbcsql.18.dylib, libmsodbcsql.17.dylib, 或 libmsodbcsql.13.dylib |
主驱动库。 Driver 18 库位于 $(brew --prefix msodbcsql18)/lib/下;Driver 17 库位于 $(brew --prefix msodbcsql17)/lib/。 历史版驱动 13.1 库位于 /usr/local/lib/。 |
msodbcsqlr18.rll, msodbcsqlr17.rll, 或 msodbcsqlr13.rll |
驱动程序库的资源文件。 对于驱动程序 18,它位于 $(brew --prefix msodbcsql18)/share/msodbcsql18/resources/en_US/ 下;对于驱动程序 17,它位于 $(brew --prefix msodbcsql17)/share/msodbcsql17/resources/en_US/ 下。 历史驱动 13.1 文件位于 /usr/local/share/msodbcsql/resources/en_US/。 |
msodbcsql.h |
包含驱动程序定义的头文件。 你不能引用 msodbcsql.h 和 odbcss.h 在同一个程序里。 驱动程序 18 头位于 $(brew --prefix msodbcsql18)/include/msodbcsql18/以下;驱动程序 17 头位于 $(brew --prefix msodbcsql17)/include/msodbcsql17/以下。 历史驱动 13.1 头位于 /usr/local/include/msodbcsql/。 |
LICENSE.txt |
最终用户许可协议。 Driver 18 位于 $(brew --prefix msodbcsql18)/share/doc/msodbcsql18/ 下,Driver 17 位于 $(brew --prefix msodbcsql17)/share/doc/msodbcsql17/ 下。 历史驱动 13.1 文件位于 /usr/local/share/doc/msodbcsql/。 |
RELEASE_NOTES |
发布说明。 它们分别位于适用于驱动程序 18 的 $(brew --prefix msodbcsql17)/share/doc/msodbcsql17/ 和适用于驱动程序 17 的 $(brew --prefix msodbcsql18)/share/doc/msodbcsql18/ 下。 历史驱动 13.1 文件位于 /usr/local/share/doc/msodbcsql/。 |
加载资源文件
驱动程序需要资源文件才能正常工作。 其位置相对于驱动程序库,如前表所示。 从17.1版本开始,如果相对查找失败,驱动程序还会检查其默认资源目录。
疑难解答
如果连接出现 Can't open lib 错误,请检查 unixODBC 读取哪些配置文件:
odbcinst -j
如果报告的目录不是 Homebrew 配置目录,请为启动应用程序的 shell 设置 ODBCSYSINI ,然后再次检查路径:
export ODBCSYSINI="$(brew --prefix)/etc"
odbcinst -j
有关连接问题的更多信息,请参阅关于连接问题故障排除的已知问题文章。
如果 Homebrew 找不到这些公式,就添加 Microsoft tap 源:
brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release