この記事では、Microsoft ODBC Driver for SQL Server を macOS にインストール方法について説明します。 また、SQL Server 用のオプションのコマンドライン ツール (bcp および sqlcmd) と、unixODBC 開発ヘッダーについても説明します。
この記事では、Bash シェルから ODBC ドライバーをインストールするためのコマンドについて説明します。 パッケージを直接ダウンロードする場合は、「ODBC Driver for SQL Server のダウンロード」を参照してください。
ドライバーバージョンを選択する
新規アプリケーションにはドライバー18を使用してください。 ドライバー17は、バージョン17の動作を必要とするアプリケーションに対して引き続きサポートされています。 アプリケーションをドライバー17からドライバー18にアップグレードする前に、暗号化のデフォルト変更を含む 主要なバージョンの違いを確認してください。 サポート日については、 サポートライフサイクルを参照してください。
以下の表は、この記事のコマンドで使用されるドライバーおよびコマンドライン ツールの formula を示しています:
| バージョン | ドライバー構成 | オプションツール formula |
|---|---|---|
| 18 | msodbcsql18 |
mssql-tools18 |
| 17 | msodbcsql17 |
mssql-tools |
注意
macOS上の17.7以前のドライバーはx64のみ対応です。 ドライバー17.8以降、macOSパッケージはx64とApple ARM64の両方をサポートしています。 Homebrew の Formula はアーキテクチャを検出し、対応するパッケージをインストールします。 コマンドプロンプトが ARM64 で x64 エミュレーションモードで実行されている場合、Homebrew は x64 パッケージをインストールします。
Homebrew でインストールする場合は unixODBC を使いましょう。 Driver 17 と Driver 18 の formula では、unixODBC を依存関係としてインストールします。 別のセットアップで iODBC(iODBC)を使用している場合は、ドライバーライブラリとドライバーマネージャーが同じアーキテクチャを対象にしていることを確認してください。 アーキテクチャのミスマッチは incompatible architecture (have 'arm64', need 'x86_64')のようなエラーを引き起こすことがあります。
Homebrew を準備する
Homebrewがインストールされていない場合は、 Homebrewのインストール手順に従ってください。 インストール後、インストーラーが印刷したシェル構成手順に従い、 brew --version を実行して brew が利用可能か確認してください。 AppleシリコンのHomebrewのデフォルトプレフィックスは /opt/homebrewです。
マイクロソフト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が信頼されていないタップからフォーミュラを読み込まない場合は、信頼を付与する前にフォーミュラの正式名とタップを確認してください。 Driver 18のフォーミュラだけを信頼するには、以下を実行します:
brew trust --formula microsoft/mssql-release/msodbcsql18
brew trust --formula microsoft/mssql-release/mssql-tools18
次に、インストールを再試行します。
ドライバーのインストールを更新または確認する
ドライバーを更新するには、Homebrewをリフレッシュし、同じメジャーバージョンのformulaをアップグレードしてください。 ドライバー17を更新するには msodbcsql18 を msodbcsql17 に置き換えてください。 メジャーバージョン間を移行するには、もう一方の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"
コマンドはインストールされた formula のバージョン、登録済みドライバー名、macOS アーキテクチャ、およびドライバーライブラリのアーキテクチャを報告します。 デフォルトでは、Homebrew の formula はドライバーを登録します。
--without-registrationオプションでformulaをインストールした場合、登録クエリは失敗し、アーキテクチャのチェックの前に処理は停止します。
ドライバー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実行する場合は、その確認が終わるまで待ってください。
その後、ドライバーをアンインストールしてください。 ドライバー17を削除するには msodbcsql18 を msodbcsql17 に置き換えます:
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パスを確認してください。 ドライバー構成ファイルが存在し、読み取り可能で、かつドライバー登録がない場合、登録済みのドライバーは残りません。 ファイルが欠落している、読み取れない、または削除されたドライバーのエントリがまだ残っている場合は、削除を完了とみなす前にその構成問題を解決してください。 再インストールするには、同じメジャーバージョンのインストールコマンドを繰り返し、その後確認を繰り返してください。 ドライバーを削除すると、そのドライバー名を求めるアプリケーションが接続できなくなることがあります。 ドライバーライブラリやドライバーマネージャーの設定ファイルを手動で削除しないでください。
マイクロソフト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からformulaを読み込まない場合は、信頼を付与する前にformulaの正式名とtapを確認してください。 Driver 17のフォーミュラだけを信頼するには、以下を実行してください:
brew trust --formula microsoft/mssql-release/msodbcsql17
brew trust --formula microsoft/mssql-release/mssql-tools
次に、インストールを再試行します。
msodbcsql17とmsodbcsql18ドライバのフォーミュラを並べてインストールできます。
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 をインストールする前に削除してください。
msodbcsql17をv13のmsodbcsqlパッケージと並べてインストールできます。
以前のバージョン
以下のセクションでは、Driver 13.1 のインストール手順を示します。
ODBC 13.1
これらのコマンドは、OS X 10.11(El Capitan)および macOS 10.12(Sierra)における Driver 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/配下です。 旧Driver 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 |
End-User ライセンス契約書。 ドライバー18は $(brew --prefix msodbcsql18)/share/doc/msodbcsql18/ にあり、ドライバー17は $(brew --prefix msodbcsql17)/share/doc/msodbcsql17/ にあります。 旧版のDriver 13.1ファイルは /usr/local/share/doc/msodbcsql/にあります。 |
RELEASE_NOTES |
リリースノート。 ドライバー18は $(brew --prefix msodbcsql18)/share/doc/msodbcsql18/ の下にあり、ドライバー17は $(brew --prefix msodbcsql17)/share/doc/msodbcsql17/ の下にあります。 旧版のDriver 13.1ファイルは /usr/local/share/doc/msodbcsql/に記載されています。 |
リソースファイルをロードする
ドライバは機能するためにリソースファイルが必要です。 その場所は前の表に示されているように、ドライバーライブラリからの相対位置にあります。 バージョン17.1以降、相対検索が失敗した場合、ドライバーはデフォルトのリソースディレクトリもチェックします。
トラブルシューティング
接続が Can't open lib エラーで失敗した場合、unixODBC がどの設定ファイルを読み込むかを確認します:
odbcinst -j
報告されたディレクトリがHomebrewの設定ディレクトリでない場合は、アプリケーションを起動するシェルの ODBCSYSINI を設定し、その後パスを再度確認してください。
export ODBCSYSINI="$(brew --prefix)/etc"
odbcinst -j
接続の問題の詳細については、「接続の問題のトラブルシューティングに関する既知の問題の記事」を参照してください。
Homebrewでformulaが見つからない場合は、Microsoft tapを追加してください:
brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release