驱动程序安装
编辑驱动程序安装
编辑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 网站下载的，则可以安全地确认该消息，允许继续安装（点击 仍然运行）。
版本兼容性
编辑您的驱动程序必须与您的 Elasticsearch 版本兼容。
驱动程序版本不能比 Elasticsearch 版本新。例如，Elasticsearch 版本 7.10.0 与 8.17.0 驱动程序不兼容。
| Elasticsearch 版本 | 兼容的驱动程序版本 | 示例 |
|---|---|---|
8.0.0–8.17.0 |
|
Elasticsearch 8.17.0 与 8.17.0 及更早的 8.x 驱动程序兼容。Elasticsearch 8.17.0 也与 7.7.0 及更高版本的 7.x 驱动程序兼容。 |
7.7.1-7.17 |
|
Elasticsearch 7.10.0 与 7.7.0-7.10.0 驱动程序兼容。 |
7.7.0 及更早的版本 |
|
Elasticsearch 7.6.1 仅与 7.6.1 驱动程序兼容。 |
下载 .msi 包
编辑从以下位置下载 Elasticsearch SQL ODBC 驱动程序 8.17.0 的 .msi 包：https://elastic.ac.cn/downloads/odbc-client
有两个版本的安装程序可用
- 32 位驱动程序 (x86) 用于 Microsoft Office 2016 套件应用程序；特别是 Microsoft Excel 和 Microsoft Access 以及其他基于 32 位的程序。
- 64 位驱动程序 (x64) 建议用于所有其他应用程序。
用户应考虑下载并安装 32 位和 64 位驱动程序，以便在系统上安装的应用程序之间实现最大兼容性。
使用图形用户界面 (GUI) 进行安装
编辑双击下载的 .msi 包以启动 GUI 向导，该向导将指导您完成安装过程。
您首先会看到一个欢迎屏幕
单击 下一步 将显示最终用户许可协议。您需要接受许可协议才能继续安装。
以下屏幕允许您自定义 Elasticsearch ODBC 驱动程序文件的安装路径。
默认安装路径的格式为：%ProgramFiles%\Elastic\ODBCDriver\8.17.0
您现在可以安装驱动程序了。
您需要拥有提升的权限（管理员）才能进行安装。
假设安装过程没有错误，您应该看到进度屏幕，然后是完成屏幕
在完成屏幕上，您可以通过选中对话框复选框来启动 ODBC 数据源管理屏幕。这将自动在关闭时启动配置屏幕（32 位或 64 位），您可以在其中配置 DSN。
与任何 MSI 安装包一样，安装过程的日志文件可以在 %TEMP% 目录中找到，其名称是随机生成的，格式为 MSI<random>.LOG。
如果在安装过程中遇到错误，我们建议您提出问题 https://github.com/elastic/elasticsearch-sql-odbc/issues，附上您的安装日志文件并提供其他详细信息，以便我们进行调查。
使用命令行进行安装
编辑下面给出的示例适用于安装 64 位 MSI 包。要使用 32 位 MSI 包获得相同的结果，您应该改用文件名后缀 windows-x86.msi
也可以通过命令行安装 .msi。通过首先导航到下载目录，然后运行以下命令，可以实现与 GUI 相同的最简单的安装方式
msiexec.exe /i esodbc-8.17.0-windows-x86_64.msi /qn
默认情况下，msiexec.exe 不会等待安装过程完成，因为它在 Windows 子系统中运行。要等待进程完成并确保正确设置 %ERRORLEVEL%，建议使用 start /wait 创建一个进程并等待它退出
start /wait msiexec.exe /i esodbc-8.17.0-windows-x86_64.msi /qn
与任何 MSI 安装包一样，安装过程的日志文件可以在 %TEMP% 目录中找到，其名称是随机生成的，格式为 MSI<random>.LOG。可以使用 /l 命令行参数提供日志文件的路径
start /wait msiexec.exe /i esodbc-8.17.0-windows-x86_64.msi /qn /l install.log
可以使用以下命令查看支持的 Windows Installer 命令行参数
msiexec.exe /help
…或者查阅 Windows Installer SDK 命令行选项。
命令行选项
编辑GUI 中公开的所有设置也可以作为命令行参数（在 Windows Installer 文档中称为属性）传递给 msiexec.exe
|
|
安装目录。默认为 |
要传递一个值，只需使用 <PROPERTYNAME>="<VALUE>" 格式将属性名称和值附加到安装命令。例如，要使用与默认安装目录不同的安装目录
start /wait msiexec.exe /i esodbc-8.17.0-windows-x86_64.msi /qn INSTALLDIR="c:\CustomDirectory"
有关包含引号的值的其他规则，请查阅 Windows Installer SDK 命令行选项。
使用“添加/删除程序”卸载
编辑.msi 包处理卸载安装过程中添加的所有目录和文件。
卸载将删除作为安装一部分创建的所有内容。
可以通过按 Windows 键并键入 添加或删除程序 打开系统设置来卸载已安装的程序。
打开后，在已安装的应用程序列表中找到 Elasticsearch ODBC 驱动程序安装，单击并选择 卸载
使用命令行卸载
编辑也可以从命令行执行卸载，方法是导航到包含 .msi 包的目录并运行
start /wait msiexec.exe /x esodbc-8.17.0-windows-x86_64.msi /qn
与安装过程类似，可以使用 /l 命令行参数传递卸载过程的日志文件路径
start /wait msiexec.exe /x esodbc-8.17.0-windows-x86_64.msi /qn /l uninstall.log