本文說明如何在 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。 從驅動程式 17.8 開始,macOS 套件同時支援 x64 和 Apple ARM64。 Homebrew 公式會偵測架構並安裝相應的套件。 如果你的命令提示字元在 ARM64 上以 x64 模擬模式執行,Homebrew 會安裝 x64 套件。
在 Homebrew 安裝時使用 unixODBC 。 驅動程式 17 與 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 可以同時安裝。
brew update && HOMEBREW_ACCEPT_EULA=Y brew upgrade msodbcsql18
設定 driver_version 為 17 或 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
在移除驅動程式前,請先關閉使用該驅動程式的應用程式。 如果您安裝了選用工具,請先將它們卸載。 對於 Driver 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 載入公式,請先確認公式的官方名稱和 tap,然後再授予信任。 只信任 Driver 17 的公式,請執行:
brew trust --formula microsoft/mssql-release/msodbcsql17
brew trust --formula microsoft/mssql-release/mssql-tools
然後再試一次安裝。
你可以將 msodbcsql18 和 msodbcsql17 驅動程式公式並排安裝。
mssql-tools與mssql-tools18公式同時提供 sqlcmd 和 bcp,因此 Homebrew 無法將兩者連結起來。 如果mssql-tools18已安裝,前述指令會安裝mssql-tools但會回報步驟brew link未完成,並sqlcmdbcp繼續執行版本 18 的工具。 若要在已安裝 Driver 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/。 歷史上的 Driver 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。 Driver 18 標頭位於 $(brew --prefix msodbcsql18)/include/msodbcsql18/以下;Driver 17 標頭位於 $(brew --prefix msodbcsql17)/include/msodbcsql17/。 歷史上的 Driver 13.1 標頭位於 /usr/local/include/msodbcsql/。 |
LICENSE.txt |
使用者授權合約。 它在 Driver 18 的 $(brew --prefix msodbcsql17)/share/doc/msodbcsql17/ 下方,在 Driver 17 的 $(brew --prefix msodbcsql18)/share/doc/msodbcsql18/ 下方。 歷史版驅動程式 13.1 檔案位於 /usr/local/share/doc/msodbcsql/。 |
RELEASE_NOTES |
發行說明。 它們分別位於 Driver 18 的 $(brew --prefix msodbcsql18)/share/doc/msodbcsql18/ 之下,以及 Driver 17 的 $(brew --prefix msodbcsql17)/share/doc/msodbcsql17/ 之下。 歷史版驅動程式 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