驱动程序安装
编辑驱动程序安装编辑
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
-
适用于 Visual Studio 2017 或更高版本的 Microsoft Visual C++ 可再发行组件 - 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.14.2 驱动程序不兼容。
| Elasticsearch 版本 | 兼容的驱动程序版本 | 示例 |
|---|---|---|
8.0.0–8.14.2 |
|
Elasticsearch 8.14.2 与 8.14.2 和更早的 8.x 驱动程序兼容。Elasticsearch 8.14.2 还与 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.14.2 的 .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.14.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
.msi 也可以通过命令行安装。使用与 GUI 相同的默认值的最简单安装方法是先导航到下载目录，然后运行
msiexec.exe /i esodbc-8.14.2-windows-x86_64.msi /qn
默认情况下，msiexec.exe 不会等待安装过程完成，因为它在 Windows 子系统中运行。要等待进程完成并确保 %ERRORLEVEL% 设置正确，建议使用 start /wait 创建一个进程并等待它退出
start /wait msiexec.exe /i esodbc-8.14.2-windows-x86_64.msi /qn
与任何 MSI 安装包一样，安装过程的日志文件可以在 %TEMP% 目录中找到，其随机生成的名称遵循格式 MSI<random>.LOG。可以使用 /l 命令行参数提供日志文件的路径
start /wait msiexec.exe /i esodbc-8.14.2-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.14.2-windows-x86_64.msi /qn INSTALLDIR="c:\CustomDirectory"
请查阅 Windows Installer SDK 命令行选项，了解有关包含引号的值的附加规则。
使用“添加或删除程序”卸载编辑
.msi 包处理安装过程中添加的所有目录和文件的卸载。
卸载将删除安装过程中创建的所有内容。
可以通过按 Windows 键并键入 add or remove programs 来打开系统设置，从而卸载已安装的程序。
打开后，在已安装应用程序列表中找到 Elasticsearch ODBC 驱动程序安装，单击并选择 卸载
使用命令行卸载编辑
也可以通过导航到包含 .msi 包的目录并运行以下命令来从命令行执行卸载
start /wait msiexec.exe /x esodbc-8.14.2-windows-x86_64.msi /qn
与安装过程类似，可以使用 /l 命令行参数传递卸载过程的日志文件的路径
start /wait msiexec.exe /x esodbc-8.14.2-windows-x86_64.msi /qn /l uninstall.log