SQL 客户端应用程序
editSQL 客户端应用程序
edit得益于其JDBC和ODBC接口,大量第三方应用程序可以使用Elasticsearch的SQL功能。 本节按字母顺序列出了其中一些应用程序及其各自的配置——但此列表绝非详尽无遗(欢迎提交PR以改进它): 只要应用程序可以使用Elasticsearch SQL驱动程序,它就可以使用Elasticsearch SQL。
Elastic 不认可、推广或提供对所列应用程序的支持。对于这些产品中的原生 Elasticsearch 集成,请联系各自的供应商。
每个应用程序都有其自己的需求和许可证,这些不在本文档的范围内,本文档仅涵盖与Elasticsearch SQL相关的配置方面。
目前对实现ODBC 2.x标准及之前版本的应用程序的支持有限。
DBeaver
edit您可以使用 Elasticsearch JDBC 驱动程序从 DBeaver 访问 Elasticsearch 数据。
Elastic 不认可、推广或提供对此应用程序的支持;如需在此产品中进行原生 Elasticsearch 集成,请联系其供应商。
验证驱动程序版本
edit确保使用正确的JDBC驱动版本,通过使用编辑驱动设置按钮:

DBeaver 知道 Elasticsearch JDBC maven 仓库,因此只需 下载/更新 工件或添加一个新的。作为替代方案,如果 Elasticsearch Maven 仓库不可行,也可以添加一个本地文件。
当更换驱动程序时,请确保点击底部的查找类按钮 - 驱动程序类应自动被选中,但这提供了一个检查,确保驱动程序jar文件被正确找到并且没有损坏。
测试连接性
edit一旦驱动程序版本和设置就位,使用测试连接来检查一切是否正常。如果一切正常,应该会弹出一个确认窗口,显示驱动程序版本和Elasticsearch SQL的版本:

点击完成,新的 Elasticsearch 连接将出现在数据库连接面板中。
DBeaver 现在已配置为与 Elasticsearch 通信。
DbVisualizer
edit您可以使用 Elasticsearch JDBC 驱动程序从 DbVisualizer 访问 Elasticsearch 数据。
Elastic 不认可、推广或提供对此应用程序的支持。
先决条件
edit- DbVisualizer 13.0 或更高版本
-
Elasticsearch SQL JDBC 驱动
- 注意
- 13.0 之前的 DbVisualizer 版本仍然可以通过从通用 自定义 模板设置 JDBC 驱动 来连接到 Elasticsearch。
设置 Elasticsearch JDBC 驱动
edit通过工具 > 驱动管理器设置Elasticsearch JDBC驱动:

从左侧边栏选择Elasticsearch驱动模板以创建一个新的用户驱动:

在本地下载驱动程序:

并检查其可用状态:

创建一个新连接
edit一旦Elasticsearch驱动程序就位,创建一个新连接:

通过双击可用驱动程序列表中的Elasticsearch条目:

输入连接详细信息,然后按连接,驱动程序版本(与集群版本相同)应显示在连接消息下。

Microsoft Excel
edit您可以使用 Elasticsearch ODBC 驱动程序从 Microsoft Excel 访问 Elasticsearch 数据。
Elastic 不认可、推广或提供对此应用程序的支持;如需在此产品中进行原生 Elasticsearch 集成,请联系其供应商。
先决条件
edit- Microsoft Office 2016 或更高版本
- Elasticsearch SQL ODBC 驱动程序
- 预配置的用户或系统 DSN(参见 配置 部分,了解如何配置 DSN)。
将数据加载到电子表格中
edit首先,您需要选择ODBC作为数据源来加载数据。为此,请点击数据选项卡,然后点击新建查询按钮,在下拉菜单中展开从其他来源,然后选择从ODBC:
这将打开一个新窗口,其中包含一个下拉菜单,菜单中填充了Excel在系统中找到的DSN。选择一个配置为连接到您的Elasticsearch实例的DSN,然后按确定按钮:
这将打开一个新窗口,允许用户输入连接凭证。
即使 Elasticsearch 实例未启用安全功能,Excel 也可能需要用户名。在这种情况下,提供一个没有密码的虚假用户名不会影响连接性。但请注意,Excel 会缓存这些凭据(因此,如果您确实启用了安全功能,则不会再次提示您输入凭据)。
填写用户名和密码,然后按 连接。
一旦连接成功,Excel 将读取 Elasticsearch 的目录,并为用户提供从哪些表(索引)加载数据的选项。点击其中一个表将加载数据预览:
现在点击加载按钮,Excel 将会从表格中加载所有数据到电子表格中:
Microsoft Power BI 桌面版
edit您可以使用 Elasticsearch ODBC 驱动程序从 Microsoft Power BI Desktop 访问 Elasticsearch 数据。
Elastic 不认可、推广或提供对此应用程序的支持;如需在此产品中进行原生 Elasticsearch 集成,请联系其供应商。
先决条件
edit- Microsoft Power BI Desktop 2.63 或更高版本
- Elasticsearch SQL ODBC 驱动程序
- 预配置的用户或系统 DSN(参见 配置 部分,了解如何配置 DSN)。
数据加载
edit首先,您需要选择ODBC作为数据源来加载数据。启动后,点击获取数据按钮(位于主页选项卡下),然后在列表底部点击更多…按钮:
在新打开的窗口中,滚动到全部列表的底部,选择ODBC条目,然后点击连接按钮:
这将用一个新的从ODBC窗口替换当前窗口,您需要选择一个之前配置的DSN:
一旦连接,Power BI 将读取 Elasticsearch 的目录,并为用户提供从多个表(索引)中加载数据的选项。点击其中一个表将加载数据预览:
现在勾选选定的表格并点击加载按钮。Power BI 将加载并分析数据,填充一个包含可用列的列表。这些列现在可以用来构建所需的视觉效果:
Microsoft PowerShell
edit您可以使用 Elasticsearch ODBC 驱动程序从 Microsoft PowerShell 访问 Elasticsearch 数据。
Elastic 不认可、推广或提供对此应用程序的支持;如需在此产品中进行原生 Elasticsearch 集成,请联系其供应商。
先决条件
edit- Microsoft PowerShell
- Elasticsearch SQL ODBC 驱动程序
- 一个预配置的用户或系统 DSN(参见 配置 部分,了解如何配置 DSN)。
编写脚本
edit虽然将以下指令放入脚本文件中并不是绝对要求,但这样做将使其更易于扩展和重用。以下指令示例了如何使用预先配置的DSN从Elasticsearch实例中的现有索引执行简单的SELECT查询。打开一个新文件,select.ps1,并将以下指令放入其中:
$connectstring = "DSN=Local Elasticsearch;" $sql = "SELECT * FROM library" $conn = New-Object System.Data.Odbc.OdbcConnection($connectstring) $conn.open() $cmd = New-Object system.Data.Odbc.OdbcCommand($sql,$conn) $da = New-Object system.Data.Odbc.OdbcDataAdapter($cmd) $dt = New-Object system.Data.datatable $null = $da.fill($dt) $conn.close() $dt
现在打开一个PowerShell shell并简单地执行脚本:
MicroStrategy 桌面版
edit您可以使用 Elasticsearch ODBC 驱动程序从 MicroStrategy Desktop 访问 Elasticsearch 数据。
Elastic 不认可、推广或提供对此应用程序的支持;如需在此产品中进行原生 Elasticsearch 集成,请联系其供应商。
先决条件
edit- MicroStrategy Desktop 11 或更高版本
- Elasticsearch SQL ODBC 驱动程序
- 预配置的用户或系统 DSN(参见 配置 部分,了解如何配置 DSN)。
数据加载
edit要使用 Elasticsearch SQL ODBC 驱动程序将数据加载到 MicroStrategy Desktop,请按顺序执行以下步骤。
-
创建新档案
一旦应用程序启动,您首先需要创建一个新档案:
-
新数据
要导入到刚刚打开的新档案中,请点击数据集列中的新数据按钮:
-
从表中访问数据
这将打开一个新窗口,允许选择数据源以加载数据。点击数据库图标:
-
新数据源
在新打开的从表导入 - 选择窗口中,点击数据源项右侧的+按钮:
-
数据源
在数据源窗口中,勾选DSN 数据源的单选按钮。在DSN下拉框中,选择您之前配置的DSN名称。对于版本,选择通用DBMS。
在提供的字段中输入用户名和密码。 请注意,应用程序需要它们,无论它们是否已经是先前配置的DSN的一部分,新的输入将优先于这些。
最后,为您刚刚配置的应用程序特定数据源命名:
-
选择导入选项
选择导入方法如下。您可以选择任何选项;我们将举例说明选择表选项:
-
从表导入 - 选择
您在两步之前命名的数据源现在列在数据源列中。点击其名称会触发应用程序查询在DSN中配置的Elasticsearch实例,并列出可用的表:
-
数据访问模式
选择一个表来加载数据,然后按下完成按钮。在此过程中,应用程序会提供选择加载方法的选项。 你可以选择任意一种,我们将以实时连接方式为例:
-
可视化数据
从数据集列中,您可以选择要可视化的表列(或索引字段):
Qlik Sense 桌面版
edit您可以使用 Elasticsearch ODBC 驱动程序从 Qlik Sense Desktop 访问 Elasticsearch 数据。
Elastic 不认可、推广或提供对此应用程序的支持;如需在此产品中进行原生 Elasticsearch 集成,请联系其供应商。
先决条件
edit- Qlik Sense Desktop 2018年11月或更高版本
- Elasticsearch SQL ODBC驱动程序
- 一个预配置的用户或系统DSN(参见配置部分,了解如何配置DSN)。
数据加载
edit要使用 Elasticsearch SQL ODBC 驱动程序将数据加载到 Qlik Sense Desktop 中,请按顺序执行以下步骤。
-
创建新应用
一旦应用程序启动,您首先需要点击创建新应用按钮:
-
名称应用
…然后给它一个名字,
-
打开应用
…然后打开它:
-
向您的应用程序添加数据
开始配置新创建的应用程序中的源,以加载数据:
-
从ODBC加载
您将可以选择数据源。点击ODBC图标:
-
选择数据源名称(DSN)
在创建新连接 (ODBC)对话框中,点击您为Elasticsearch实例预先配置的DSN名称:
在相应的字段中提供用户名和密码,如果您的实例启用了身份验证,并且这些信息尚未包含在DSN中。按下创建按钮。
-
选择源表
应用程序现在将连接到Elasticsearch实例并查询目录信息,为您提供一个可以从其中加载数据的表列表:
-
可视化数据
点击添加数据按钮并自定义您的数据可视化:
SQuirreL SQL
edit您可以使用 Elasticsearch JDBC 驱动程序从 SQuirreL SQL 访问 Elasticsearch 数据。
Elastic 不认可、推广或提供对此应用程序的支持;如需在此产品中进行原生 Elasticsearch 集成,请联系其供应商。
先决条件
edit- SQuirreL SQL 版本 4.0.0 或更高
- Elasticsearch SQL JDBC 驱动
添加 Elasticsearch JDBC 驱动
edit要添加Elasticsearch JDBC驱动程序,请使用Windows > 查看驱动程序菜单(或Ctrl+Shift+D快捷键):

从左侧的Drivers面板中选择Elasticsearch配置文件(如果缺失,请检查SQuirreL SQL版本或在左上角的‘+’按钮处添加新条目到列表中):

选择额外类路径标签页并添加JDBC jar。命名连接并列出驱动程序以填充类名(如果尚未填写):

驱动程序现在应该出现在列表中,其名称旁边有一个蓝色的对勾标记:

为Elasticsearch添加别名
edit添加一个新连接或使用新驱动程序的SQuirreL术语中的别名。为此,请选择左侧的别名面板,然后点击+符号:

命名新的别名并选择之前添加的Elasticsearch驱动程序:

设置已完成。通过点击测试连接来再次确认。
SQL Workbench/J
edit您可以使用 Elasticsearch JDBC 驱动程序从 SQL Workbench/J 访问 Elasticsearch 数据。
Elastic 不认可、推广或提供对此应用程序的支持;如需在此产品中进行原生 Elasticsearch 集成,请联系其供应商。
先决条件
edit- SQL Workbench/J 构建 125 或更高版本
- Elasticsearch SQL JDBC 驱动
添加 Elasticsearch JDBC 驱动
edit通过管理驱动程序将Elasticsearch JDBC驱动添加到SQL Workbench/J中,可以从主窗口的文件菜单或连接窗口中进行操作:

从左侧选择Elasticsearch配置文件(如果缺失,请检查SQL Workbench/J版本或通过左上角的空白页面按钮添加新条目到列表中):

添加JDBC jar(如果驱动名称尚未被选中,请点击放大镜按钮):

创建一个新的连接配置文件
edit配置好驱动程序后,通过文件 > 连接窗口(或使用Alt+C快捷键)创建一个新的连接配置文件:

选择之前配置的驱动程序,并使用JDBC语法设置集群的URL。 通过测试按钮验证连接 - 应该会出现一个确认窗口,表明所有内容都已正确配置。
设置已完成。
Tableau Desktop
edit使用 Elasticsearch JDBC 驱动程序和专用的 Elasticsearch Tableau 连接器从 Tableau Desktop 访问 Elasticsearch 数据。
Elastic 不认可、推广或提供对此应用程序的支持;如需在此产品中进行原生 Elasticsearch 集成,请联系其供应商。
先决条件
edit- Tableau Desktop 2019.4 或更高版本
- Elasticsearch SQL JDBC 驱动
- 适用于 Tableau 的 Elasticsearch 连接器
加载数据
edit首先,将JDBC驱动程序移动或下载到Tableau Desktop驱动程序目录中:
-
Windows:
C:\Program Files\Tableau\Drivers -
Mac:
/Users/[user]/Library/Tableau/Drivers
将Tableau的Elasticsearch连接器移动到Tableau Desktop的连接器目录中:
-
Windows:
C:\Users\[Windows 用户]\Documents\My Tableau Repository\Connectors -
Mac:
/Users/[用户]/Documents/My Tableau Repository/Connectors
启动 Tableau Desktop。在菜单中,点击 更多… 并选择 Elasticsearch by Elastic 作为数据源。
在新建连接模态框中,输入您的Elasticsearch实例的信息,然后点击登录。
在主窗口中,选择您的Elasticsearch实例作为数据库。然后选择一个表进行加载。
最后,生成一份报告。
Tableau Server
edit使用Elasticsearch JDBC驱动程序和专用的Elasticsearch Tableau连接器从Tableau Server访问Elasticsearch数据。
Elastic 不认可、推广或提供对此应用程序的支持;如需在此产品中进行原生 Elasticsearch 集成,请联系其供应商。
先决条件
edit- Tableau Server 2019.4 或更高版本
- Elasticsearch SQL JDBC 驱动
- 适用于 Tableau 的 Elasticsearch 连接器
加载数据
edit首先,将JDBC驱动程序移动或下载到Tableau Server的驱动程序目录中:
-
Windows:
C:\Program Files\Tableau\Drivers -
Mac:
/Users/[user]/Library/Tableau/Drivers
将Tableau的Elasticsearch连接器移动到Tableau Server的连接器目录中。要找到此目录的位置,请参阅Tableau Server文档或使用TSM命令行界面。
重新启动 Tableau Server。
要将数据加载到工作簿中,请从数据菜单或使用图标添加新数据源。在连接到数据模态框的连接器选项卡中,选择Elasticsearch by Elastic。
输入您的Elasticsearch实例的信息,然后点击登录。
在主窗口中,选择您的Elasticsearch实例作为数据库。然后选择一个表进行加载。
最后,生成一份报告。










































