Microsoft ODBC Driver for SQL Server をインストールする (macOS)

この記事では、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