SQL ODBC - ドライバーのインストール（Driver installation）

ドライバーのインストール
インストールの前提条件
バージョンの互換性
パッケージのダウンロード
グラフィカルユーザーインターフェース (GUI) を使用したインストール
コマンドラインを使用したインストール
- コマンドラインオプション
- プログラムの追加/削除を使用したアンインストール

ドライバーのインストール

Elasticsearch SQL ODBCドライバーは、MSIパッケージを使用してMicrosoft Windowsにインストールできます。インストールプロセスは簡単で、標準のMSIウィザードの手順で構成されています。

インストールの前提条件

推奨されるインストールプラットフォームは、Windows 10 64ビットまたはWindows Server 2016 64ビットです。

Elasticsearch SQL ODBCドライバーをインストールする前に、以下の前提条件を満たす必要があります;

.NET Framework 4.xフル、最新 - https://dotnet.microsoft.com/download/dotnet-framework
Microsoft Visual C++ Redistributable for Visual Studio 2017以降 - https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist
- 64ビットドライバーにはx64再配布可能パッケージが必要です
- 32ビットドライバーにはx86またはx64再配布可能パッケージが必要です（後者は32ビットドライバーに必要なコンポーネントもインストールします）
インストールを実行するユーザーには管理者権限が必要です。

前提条件を満たさない場合、インストーラーはエラーメッセージを表示し、インストールを中止します。

MSIを使用してインラインアップグレードすることはできません。アップグレードするには、まず古いドライバーをアンインストールし、その後新しいドライバーをインストールする必要があります。

MSIをインストールする際、Windows Defender SmartScreenが未認識のアプリを実行することについて警告する場合があります。MSIがElasticのウェブサイトからダウンロードされたものであれば、メッセージを承認してインストールを続行することは安全です(Run anyway)。

バージョンの互換性

ドライバーは、あなたのElasticsearchバージョンと互換性がある必要があります。

ドライバーのバージョンは、Elasticsearchのバージョンより新しくてはなりません。たとえば、Elasticsearchバージョン7.10.0は8.15.2ドライバーと互換性がありません。

Elasticsearchバージョン	互換性のあるドライバーバージョン	例
8.0.0–8.15.2	- 同じバージョン - 以前の8.xバージョンのいずれか - 7.7.0以降の任意の7.xバージョン	Elasticsearch 8.15.2は8.15.2および以前の8.xドライバーと互換性があります。Elasticsearch 8.15.2は7.7.0以降の7.xドライバーとも互換性があります。
7.7.1-7.17	- 同じバージョン - 7.7.0までの以前の7.xバージョン	Elasticsearch 7.10.0は7.7.0-7.10.0ドライバーと互換性があります。
7.7.0およびそれ以前のバージョン	- 同じバージョン。	Elasticsearch 7.6.1は7.6.1ドライバーとのみ互換性があります。

パッケージのダウンロード

Elasticsearch SQL ODBCドライバー8.15.2のための.msiパッケージを以下からダウンロードしてください: https://www.elastic.co/downloads/odbc-client

インストーラーには2つのバージョンがあります:

32ビットドライバー (x86) Microsoft Office 2016スイートのアプリケーション、特にMicrosoft ExcelやMicrosoft Access、その他の32ビットベースのプログラムで使用します。
64ビットドライバー (x64) すべての他のアプリケーションでの使用を推奨します。

ユーザーは、システムにインストールされているアプリケーション間の最大の互換性を確保するために、32ビットおよび64ビットの両方のドライバーをダウンロードしてインストールすることを検討すべきです。

グラフィカルユーザーインターフェース (GUI) を使用したインストール

ダウンロードした.msiパッケージをダブルクリックして、インストールプロセスを案内するGUIウィザードを起動します。

最初にウェルカム画面が表示されます:

インストーラーウェルカム画面

次へをクリックすると、エンドユーザーライセンス契約が表示されます。インストールを続行するには、ライセンス契約に同意する必要があります。

インストーラーEULA画面

次の画面では、Elasticsearch ODBCドライバーのファイルのインストールパスをカスタマイズできます。

デフォルトのインストールパスは次の形式です: %ProgramFiles%\Elastic\ODBCDriver\8.15.2

インストーラードライバーパス

これでドライバーをインストールする準備が整いました。

インストールには管理者権限が必要です。

インストーラー開始

エラーなくインストールが行われると、進行状況画面が表示され、その後完了画面が表示されます:

インストーラーインストール中

完了画面では、ダイアログのチェックボックスをチェックすることでODBCデータソース管理画面を起動できます。これにより、閉じると自動的に構成画面が起動します（32ビットまたは64ビットのいずれか）で、DSNを構成できます。

インストーラー完了

すべてのMSIインストールパッケージと同様に、インストールプロセスのログファイルは%TEMP%ディレクトリ内に見つかり、MSI<random>.LOG形式に従ったランダムに生成された名前が付けられます。

インストール中にエラーが発生した場合は、https://github.com/elastic/elasticsearch-sql-odbc/issuesで問題を開き、インストールログファイルを添付し、調査のために追加の詳細を提供することをお勧めします。

コマンドラインを使用したインストール

以下に示す例は、64ビットMSIパッケージのインストールに適用されます。32ビットMSIパッケージで同じ結果を得るには、ファイル名の接尾辞windows-x86.msiを使用します。


``````sh
msiexec.exe /i esodbc-8.15.2-windows-x86_64.msi /qn
`

デフォルトでは、msiexec.exeはインストールプロセスが完了するのを待ちません。これはWindowsサブシステムで実行されるためです。プロセスが終了するのを待ち、%ERRORLEVEL%が適切に設定されることを確認するには、start /waitを使用してプロセスを作成し、終了を待つことをお勧めします:

start /wait msiexec.exe /i esodbc-8.15.2-windows-x86_64.msi /qn

すべてのMSIインストールパッケージと同様に、アンインストールプロセスのログファイルは%TEMP%ディレクトリ内に見つかり、MSI<random>.LOG形式に従ったランダムに生成された名前が付けられます。ログファイルへのパスは、/lコマンドライン引数を使用して指定できます。

start /wait msiexec.exe /i esodbc-8.15.2-windows-x86_64.msi /qn /l install.log

サポートされているWindowsインストーラーコマンドライン引数は、次のコマンドを使用して表示できます:

msiexec.exe /help

…またはWindows Installer SDKコマンドラインオプション.aspx)を参照してください。

コマンドラインオプション

GUI内で公開されているすべての設定は、msiexec.exeに渡すことができるコマンドライン引数（Windows Installerドキュメント内ではプロパティと呼ばれます）としても利用可能です:


`INSTALLDIR`	インストールディレクトリ。デフォルトは`%ProgramFiles%\Elastic\ODBCDriver\8.15.2`です。

値を渡すには、プロパティ名と値を<PROPERTYNAME>="<VALUE>"形式でインストールコマンドに追加します。たとえば、デフォルトのインストールディレクトリとは異なるインストールディレクトリを使用するには:

start /wait msiexec.exe /i esodbc-8.15.2-windows-x86_64.msi /qn INSTALLDIR="c:\CustomDirectory"

追加のルールについては、引用符を含む値に関するWindows Installer SDKコマンドラインオプション.aspx)を参照してください。

プログラムの追加/削除を使用したアンインストール


アンインストールは、インストールの一部として作成された**すべての**コンテンツを削除します。  
インストールされたプログラムは、Windowsキーを押して`````add or remove programs`````と入力することでシステム設定を開くことでアンインストールできます。  
開いたら、インストールされたアプリケーションのリスト内でElasticsearch ODBCドライバーのインストールを見つけ、クリックして`````Uninstall`````を選択します:  
 ![アンインストール](https://cdn.hedaai.com/projects/elasticsearch-8-15/ef1ff20c2a8fe8a95331520f24805a1a.png_big1500.jpeg)
### コマンドラインを使用したアンインストール
アンインストールは、`````.msi`````パッケージを含むディレクトリに移動し、次のコマンドを実行することでコマンドラインからも実行できます:  
``````sh
start /wait msiexec.exe /x esodbc-8.15.2-windows-x86_64.msi /qn
`

インストールプロセスと同様に、アンインストールプロセスのログファイルのパスは/lコマンドライン引数を使用して渡すことができます。

start /wait msiexec.exe /x esodbc-8.15.2-windows-x86_64.msi /qn /l uninstall.log