驱动程序安装
Elastic Stack Serverless
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 与 9.0.0 驱动程序不兼容。
| Elasticsearch 版本 | 兼容的驱动程序版本 | 示例 |
|---|---|---|
| 7.7.0 及更早版本 | * 相同版本。 |
Elasticsearch 7.6.1 仅与 7.6.1 驱动程序兼容。 |
从以下位置下载 Elasticsearch SQL ODBC 驱动程序 9.0.0 的 .msi 包：https://elastic.ac.cn/downloads/odbc-client
有两个版本的安装程序可用
- 32 位驱动程序 (x86) 用于 Microsoft Office 2016 应用程序套件； 尤其是 Microsoft Excel 和 Microsoft Access 以及其他基于 32 位的程序。
- 64 位驱动程序 (x64) 建议用于所有其他应用程序。
用户应考虑下载并安装 32 位和 64 位驱动程序，以便在安装在其系统上的应用程序之间实现最大的兼容性。
双击下载的 .msi 包以启动 GUI 向导，该向导将指导您完成安装过程。
您将首先看到一个欢迎屏幕
单击下一步将显示最终用户许可协议。 您需要接受许可协议才能继续安装。
以下屏幕允许您自定义 Elasticsearch ODBC 驱动程序文件的安装路径。
默认安装路径的格式为：%ProgramFiles%\Elastic\ODBCDriver\9.0.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-9.0.0-windows-x86_64.msi /qn
默认情况下，msiexec.exe 不会等待安装过程完成，因为它在 Windows 子系统中运行。 为了等待该过程完成并确保相应地设置 %ERRORLEVEL%，建议使用 start /wait 创建一个进程并等待其退出
start /wait msiexec.exe /i esodbc-9.0.0-windows-x86_64.msi /qn
与任何 MSI 安装包一样，可以在 %TEMP% 目录中找到安装过程的日志文件，其名称是随机生成的，符合格式 MSI<random>.LOG。 可以使用 /l 命令行参数提供日志文件的路径
start /wait msiexec.exe /i esodbc-9.0.0-windows-x86_64.msi /qn /l install.log
可以使用以下命令查看受支持的 Windows Installer 命令行参数
msiexec.exe /help
…或者查阅 Windows Installer SDK 命令行选项。
GUI 中公开的所有设置也可以用作命令行参数（在 Windows Installer 文档中称为属性），这些参数可以传递给 msiexec.exe
INSTALLDIR- 安装目录。 默认为 %ProgramFiles%\Elastic\ODBCDriver\9.0.0。
要传递一个值，只需使用格式 <PROPERTYNAME>="<VALUE>" 将属性名称和值附加到安装命令。 例如，要使用与默认安装目录不同的目录
start /wait msiexec.exe /i esodbc-9.0.0-windows-x86_64.msi /qn INSTALLDIR="c:\CustomDirectory"
有关包含引号的值的其他规则，请参阅 Windows Installer SDK 命令行选项。
.msi 包处理作为安装一部分添加的所有目录和文件的卸载。
卸载将删除作为安装一部分创建的所有内容。
可以通过按 Windows 键并键入 添加或删除程序 来打开系统设置，从而卸载已安装的程序。
打开后，在已安装的应用程序列表中找到 Elasticsearch ODBC 驱动程序安装，单击并选择卸载
也可以通过命令行执行卸载，方法是导航到包含 .msi 包的目录并运行
start /wait msiexec.exe /x esodbc-9.0.0-windows-x86_64.msi /qn
与安装过程类似，可以使用 /l 命令行参数传递卸载过程的日志文件的路径
start /wait msiexec.exe /x esodbc-9.0.0-windows-x86_64.msi /qn /l uninstall.log