New

The executive guide to generative AI

Read more
About usPartnersSupport|Login
« SQL ODBC 配置 »
Elastic 文档 ›Elasticsearch 指南 [8.17] ›SQL ›SQL ODBC

驱动程序安装

编辑

驱动程序安装

编辑

Elasticsearch SQL ODBC 驱动程序可以使用 MSI 包安装在 Microsoft Windows 上。安装过程很简单，由标准的 MSI 向导步骤组成。

安装先决条件

编辑

推荐的安装平台是 Windows 10 64 位或 Windows Server 2016 64 位。

在安装 Elasticsearch SQL ODBC 驱动程序之前，您需要满足以下先决条件：

如果您未能满足任何先决条件，安装程序将显示错误消息并中止安装。

无法使用 MSI 进行在线升级。要升级，您必须先卸载旧驱动程序，然后再安装新驱动程序。

安装 MSI 时，Windows Defender SmartScreen 可能会警告您正在运行无法识别的应用程序。如果 MSI 是从 Elastic 网站下载的，则可以安全地确认该消息，允许继续安装（点击 仍然运行）。

版本兼容性

编辑

您的驱动程序必须与您的 Elasticsearch 版本兼容。

驱动程序版本不能比 Elasticsearch 版本新。例如，Elasticsearch 版本 7.10.0 与 8.17.0 驱动程序不兼容。

Elasticsearch 版本 兼容的驱动程序版本 示例

8.0.0–8.17.0
  • 相同版本
  • 任何早期的 8.x 版本
  • 任何 7.7.0 之后的 7.x 版本。

Elasticsearch 8.17.0 与 8.17.0 及更早的 8.x 驱动程序兼容。Elasticsearch 8.17.0 也与 7.7.0 及更高版本的 7.x 驱动程序兼容。

7.7.1-7.17
  • 相同版本
  • 一个更早的 7.x 版本，回溯到 7.7.0。

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 向导，该向导将指导您完成安装过程。

您首先会看到一个欢迎屏幕

Installer Welcome Screen

单击 下一步 将显示最终用户许可协议。您需要接受许可协议才能继续安装。

Installer EULA Screen

以下屏幕允许您自定义 Elasticsearch ODBC 驱动程序文件的安装路径。

默认安装路径的格式为：%ProgramFiles%\Elastic\ODBCDriver\8.17.0

Installer Driver Path

您现在可以安装驱动程序了。

您需要拥有提升的权限（管理员）才能进行安装。

Installer Begin

假设安装过程没有错误，您应该看到进度屏幕，然后是完成屏幕

Installer Installing

在完成屏幕上，您可以通过选中对话框复选框来启动 ODBC 数据源管理屏幕。这将自动在关闭时启动配置屏幕（32 位或 64 位），您可以在其中配置 DSN。

Installer Complete

与任何 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

INSTALLDIR

安装目录。默认为 %ProgramFiles%\Elastic\ODBCDriver\8.17.0。

要传递一个值，只需使用 <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 驱动程序安装，单击并选择 卸载

uninstall

使用命令行卸载

编辑

也可以从命令行执行卸载，方法是导航到包含 .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
« SQL ODBC 配置 »