安裝 Microsoft ODBC Driver for SQL Server (macOS)
本文說明如何在 macOS 上安裝 Microsoft ODBC Driver for SQL Server， 以及如何使用適用於 SQL Server (bcp 和 sqlcmd) 與 unixODBC 開發標頭的選擇性命令列工具。
本文提供從 Bash Shell 安裝 ODBC 驅動程式的命令。 如果想要直接下載套件，請參閱下載 ODBC Driver for SQL Server。
注意
只有在到版本 17.7 的 x64 架構上，才在 macOS 上支援 Microsoft ODBC Driver for SQL Server。 從版本 17.8 開始，已新增 Apple ARM64 支援。 系統將偵測架構，且 Homebrew 公式會自動安裝正確的封裝。 如果您的命令提示字元是在採用 ARM64 的 x64 模擬模式中執行，則會安裝 x64 封裝。 如果您在命令提示字元未於模擬模式中執行，則會安裝 ARM64 封裝。
此外，Homebrew 預設目錄會隨著 ARM64 架構變更為 /opt/homebrew。 [驅動程式檔案] 區段中的路徑會使用預設為 /usr/local 的 x64 Homebrew 路徑，因此您的檔案路徑會隨之改變。
Microsoft ODBC 18
若要在 macOS 上安裝 Microsoft ODBC Driver 18 for SQL Server，請執行下列命令：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release
brew update
HOMEBREW_ACCEPT_EULA=Y brew install msodbcsql18 mssql-tools18
舊版
下列各節提供在 macOS 上安裝舊版 Microsoft ODBC 驅動程式的指示。
Microsoft ODBC 17
若要在 macOS 上安裝 Microsoft ODBC Driver 17 for SQL Server，請執行下列命令：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release
brew update
HOMEBREW_ACCEPT_EULA=Y brew install msodbcsql17 mssql-tools
重要
如果您已安裝短暫提供的第 17 版 msodbcsql 套件，您應該先移除它，再安裝 msodbcsql17 套件。 如此可避免衝突。 msodbcsql17 套件可以和 msodbcsql 第 13 版套件並存安裝。
ODBC 13.1
使用下列命令，在 OS X 10.11 (El Capitan) 與 macOS 10.12 (Sierra) 上安裝 Microsoft ODBC driver 13.1 for SQL Server：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
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 驅動程式包含下列元件：
| 元件 | Description |
|---|---|
| libmsodbcsql.18.dylib or libmsodbcsql.17.dylib or libmsodbcsql.13.dylib | 動態連結程式庫 (dylib) 檔案，其中包含驅動程式的所有功能。 這個檔案會安裝在 /usr/local/lib/。 |
msodbcsqlr18.rll、msodbcsqlr17.rll 或 msodbcsqlr13.rll |
隨附驅動程式程式庫的資源檔。 針對 Driver 18，此檔案會安裝在 [driver .dylib directory]../share/msodbcsql18/resources/en_US/，針對 Driver 17 在 [driver .dylib directory]../share/msodbcsql17/resources/en_US/，以及針對 Driver 13 則在 [driver .dylib directory]../share/msodbcsql/resources/en_US/。 |
| msodbcsql.h | 標頭檔，其中包含使用驅動程式所需的所有新定義。 注意：您無法在相同的程式中參考 msodbcsql.h 和 odbcss.h。 針對 Driver 18，msodbcsql.h 會安裝在 /usr/local/include/msodbcsql18/，針對 Driver 17 在 /usr/local/include/msodbcsql17/，以及針對 Driver 13 則在 /usr/local/include/msodbcsql/。 |
| LICENSE.txt | 文字檔案，其中包含授權條款。 針對 Driver 18，此檔案會放置在 /usr/local/share/doc/msodbcsql18/，針對 Driver 17 在 /usr/local/share/doc/msodbcsql17/，以及針對 Driver 13 則在 /usr/local/share/doc/msodbcsql/。 |
| RELEASE_NOTES | 文字檔案，其中包含版本資訊。 針對 Driver 18，此檔案會放置在 /usr/local/share/doc/msodbcsql18/，針對 Driver 17 在 /usr/local/share/doc/msodbcsql17/，以及針對 Driver 13 則在 /usr/local/share/doc/msodbcsql/。 |
載入資源檔
驅動程式需要載入資源檔，才能運作。 這個檔案稱為 msodbcsqlr18.rll、msodbcsqlr17.rll 或 msodbcsqlr13.rll，視驅動程式版本而定。 .rll 檔案的位置是相對於驅動程式本身 (so 或 dylib) 的位置，如元件表格中所述。 到版本 17.1 為止，驅動程式也會嘗試從預設目錄載入 .rll，如果從相對路徑載入失敗的話。 macOS 上的預設資源檔路徑為 /usr/local/share/msodbcsql18/resources/en_US/
疑難排解
某些使用者在安裝 ODBC 驅動程式後嘗試連線時會遇到問題，並收到類似以下的錯誤："[01000] [unixODBC][Driver Manager]Can't open lib 'ODBC Driver 18 for SQL Server' : file not found (0) (SQLDriverConnect)"。 這可能是因為 unixODBC 未正確設定且找不到已註冊的驅動程式。 在這些情況下，建立符號連結便可以解決該問題。
sudo ln -s /usr/local/etc/odbcinst.ini /etc/odbcinst.ini
sudo ln -s /usr/local/etc/odbc.ini /etc/odbc.ini
針對無法使用 ODBC 驅動程式與 SQL Server 建立連線的其他案例，請參閱已知問題一文中的針對連線問題進行疑難排解。
如果 brew 找不到公式，請確定您未略過安裝步驟：brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release