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