SQL 客户端应用程序

edit

SQL 客户端应用程序

edit

得益于其JDBCODBC接口,大量第三方应用程序可以使用Elasticsearch的SQL功能。 本节按字母顺序列出了其中一些应用程序及其各自的配置——但此列表绝非详尽无遗(欢迎提交PR以改进它): 只要应用程序可以使用Elasticsearch SQL驱动程序,它就可以使用Elasticsearch SQL。

Elastic 不认可、推广或提供对所列应用程序的支持。对于这些产品中的原生 Elasticsearch 集成,请联系各自的供应商。

每个应用程序都有其自己的需求和许可证,这些不在本文档的范围内,本文档仅涵盖与Elasticsearch SQL相关的配置方面。

目前对实现ODBC 2.x标准及之前版本的应用程序的支持有限。

DBeaver

edit

您可以使用 Elasticsearch JDBC 驱动程序从 DBeaver 访问 Elasticsearch 数据。

Elastic 不认可、推广或提供对此应用程序的支持;如需在此产品中进行原生 Elasticsearch 集成,请联系其供应商。

先决条件

edit

新建连接

edit

通过菜单 文件 > 新建 > 数据库连接 菜单或直接通过 数据库连接 面板创建新连接。

dbeaver 1 新连接

选择 Elasticsearch 类型

edit

从可用连接类型中选择 Elasticsearch 类型:

dbeaver 2 conn es

指定 Elasticsearch 集群信息

edit

适当配置Elasticsearch SQL连接:

dbeaver 3 连接属性

验证驱动程序版本

edit

确保使用正确的JDBC驱动版本,通过使用编辑驱动设置按钮:

dbeaver 4 驱动程序版本

DBeaver 知道 Elasticsearch JDBC maven 仓库,因此只需 下载/更新 工件或添加一个新的。作为替代方案,如果 Elasticsearch Maven 仓库不可行,也可以添加一个本地文件。

当更换驱动程序时,请确保点击底部的查找类按钮 - 驱动程序类应自动被选中,但这提供了一个检查,确保驱动程序jar文件被正确找到并且没有损坏。

测试连接性

edit

一旦驱动程序版本和设置就位,使用测试连接来检查一切是否正常。如果一切正常,应该会弹出一个确认窗口,显示驱动程序版本和Elasticsearch SQL的版本:

dbeaver 5 测试连接

点击完成,新的 Elasticsearch 连接将出现在数据库连接面板中。

DBeaver 现在已配置为与 Elasticsearch 通信。

连接到 Elasticsearch

edit

只需点击 Elasticsearch 连接并开始查询和探索 Elasticsearch:

dbeaver 6 数据

DbVisualizer

edit

您可以使用 Elasticsearch JDBC 驱动程序从 DbVisualizer 访问 Elasticsearch 数据。

Elastic 不认可、推广或提供对此应用程序的支持。

先决条件

edit
  • DbVisualizer 13.0 或更高版本
  • Elasticsearch SQL JDBC 驱动

    注意
    13.0 之前的 DbVisualizer 版本仍然可以通过从通用 自定义 模板设置 JDBC 驱动 来连接到 Elasticsearch。

设置 Elasticsearch JDBC 驱动

edit

通过工具 > 驱动管理器设置Elasticsearch JDBC驱动:

dbvis 1 驱动管理器

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

dbvis 2 驱动管理器 elasticsearch

在本地下载驱动程序:

dbvis 3 驱动管理器下载

并检查其可用状态:

dbvis 4 驱动管理器就绪

创建一个新连接

edit

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

dbvis 5 新连接

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

dbvis 6 新连接 elasticsearch

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

dbvis 7 新连接连接

执行SQL查询

edit

设置已完成。可以使用DbVisualizer对Elasticsearch运行查询并探索其内容:

dbvis 8 数据

Microsoft Excel

edit

您可以使用 Elasticsearch ODBC 驱动程序从 Microsoft Excel 访问 Elasticsearch 数据。

Elastic 不认可、推广或提供对此应用程序的支持;如需在此产品中进行原生 Elasticsearch 集成,请联系其供应商。

先决条件

edit

将数据加载到电子表格中

edit

首先,您需要选择ODBC作为数据源来加载数据。为此,请点击数据选项卡,然后点击新建查询按钮,在下拉菜单中展开从其他来源,然后选择从ODBC

ODBC 作为数据源apps excel fromodbc

这将打开一个新窗口,其中包含一个下拉菜单,菜单中填充了Excel在系统中找到的DSN。选择一个配置为连接到您的Elasticsearch实例的DSN,然后按确定按钮:

选择一个DSNapps excel dsn

这将打开一个新窗口,允许用户输入连接凭证。

即使 Elasticsearch 实例未启用安全功能,Excel 也可能需要用户名。在这种情况下,提供一个没有密码的虚假用户名不会影响连接性。但请注意,Excel 会缓存这些凭据(因此,如果您确实启用了安全功能,则不会再次提示您输入凭据)。

填写用户名和密码,然后按 连接

提供连接凭据apps excel cred

一旦连接成功,Excel 将读取 Elasticsearch 的目录,并为用户提供从哪些表(索引)加载数据的选项。点击其中一个表将加载数据预览:

选择要加载的表格apps excel picktable

现在点击加载按钮,Excel 将会从表格中加载所有数据到电子表格中:

数据已加载到电子表格中apps excel loaded

Microsoft Power BI 桌面版

edit

您可以使用 Elasticsearch ODBC 驱动程序从 Microsoft Power BI Desktop 访问 Elasticsearch 数据。

Elastic 不认可、推广或提供对此应用程序的支持;如需在此产品中进行原生 Elasticsearch 集成,请联系其供应商。

先决条件

edit

数据加载

edit

首先,您需要选择ODBC作为数据源来加载数据。启动后,点击获取数据按钮(位于主页选项卡下),然后在列表底部点击更多…​按钮:

获取数据 / 更多…​apps pbi fromodbc1

在新打开的窗口中,滚动到全部列表的底部,选择ODBC条目,然后点击连接按钮:

ODBC / 连接apps pbi fromodbc2

这将用一个新的从ODBC窗口替换当前窗口,您需要选择一个之前配置的DSN:

选择一个DSNapps pbi dsn

一旦连接,Power BI 将读取 Elasticsearch 的目录,并为用户提供从多个表(索引)中加载数据的选项。点击其中一个表将加载数据预览:

选择要加载的表apps pbi picktable

现在勾选选定的表格并点击加载按钮。Power BI 将加载并分析数据,填充一个包含可用列的列表。这些列现在可以用来构建所需的视觉效果:

可视化数据apps pbi_loaded

Microsoft PowerShell

edit

您可以使用 Elasticsearch ODBC 驱动程序从 Microsoft PowerShell 访问 Elasticsearch 数据。

Elastic 不认可、推广或提供对此应用程序的支持;如需在此产品中进行原生 Elasticsearch 集成,请联系其供应商。

先决条件

edit

编写脚本

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并简单地执行脚本:

在 PowerShell 中运行 SQLapps ps exed

MicroStrategy 桌面版

edit

您可以使用 Elasticsearch ODBC 驱动程序从 MicroStrategy Desktop 访问 Elasticsearch 数据。

Elastic 不认可、推广或提供对此应用程序的支持;如需在此产品中进行原生 Elasticsearch 集成,请联系其供应商。

先决条件

edit

数据加载

edit

要使用 Elasticsearch SQL ODBC 驱动程序将数据加载到 MicroStrategy Desktop,请按顺序执行以下步骤。

  1. 创建新档案

    一旦应用程序启动,您首先需要创建一个新档案

    应用微策略新建档案

  2. 新数据

    要导入到刚刚打开的新档案中,请点击数据集列中的新数据按钮:

    应用微策略新数据

  3. 从表中访问数据

    这将打开一个新窗口,允许选择数据源以加载数据。点击数据库图标:

    应用微策略数据库

  4. 新数据源

    在新打开的从表导入 - 选择窗口中,点击数据源项右侧的+按钮:

    应用微策略新建数据源

  5. 数据源

    数据源窗口中,勾选DSN 数据源的单选按钮。在DSN下拉框中,选择您之前配置的DSN名称。对于版本,选择通用DBMS

    在提供的字段中输入用户名和密码。 请注意,应用程序需要它们,无论它们是否已经是先前配置的DSN的一部分,新的输入将优先于这些。

    最后,为您刚刚配置的应用程序特定数据源命名:

    应用微策略DSN

  6. 选择导入选项

    选择导入方法如下。您可以选择任何选项;我们将举例说明选择表选项:

    应用微策略表

  7. 从表导入 - 选择

    您在两步之前命名的数据源现在列在数据源列中。点击其名称会触发应用程序查询在DSN中配置的Elasticsearch实例,并列出可用的表:

    应用微策略加载表

  8. 数据访问模式

    选择一个表来加载数据,然后按下完成按钮。在此过程中,应用程序会提供选择加载方法的选项。 你可以选择任意一种,我们将以实时连接方式为例:

    应用微策略实时

  9. 可视化数据

    数据集列中,您可以选择要可视化的表列(或索引字段):

    应用微策略可视化

Qlik Sense 桌面版

edit

您可以使用 Elasticsearch ODBC 驱动程序从 Qlik Sense Desktop 访问 Elasticsearch 数据。

Elastic 不认可、推广或提供对此应用程序的支持;如需在此产品中进行原生 Elasticsearch 集成,请联系其供应商。

先决条件

edit

数据加载

edit

要使用 Elasticsearch SQL ODBC 驱动程序将数据加载到 Qlik Sense Desktop 中,请按顺序执行以下步骤。

  1. 创建新应用

    一旦应用程序启动,您首先需要点击创建新应用按钮:

    应用 Qlik 新建应用

  2. 名称应用

    …然后给它一个名字,

    创建 Qlik 应用程序

  3. 打开应用

    …然后打开它:

    应用 Qlik 打开

  4. 向您的应用程序添加数据

    开始配置新创建的应用程序中的源,以加载数据:

    应用 Qlik 添加数据

  5. 从ODBC加载

    您将可以选择数据源。点击ODBC图标:

    应用 Qlik ODBC

  6. 选择数据源名称(DSN)

    创建新连接 (ODBC)对话框中,点击您为Elasticsearch实例预先配置的DSN名称:

    应用 Qlik DSN

    在相应的字段中提供用户名和密码,如果您的实例启用了身份验证,并且这些信息尚未包含在DSN中。按下创建按钮。

  7. 选择源表

    应用程序现在将连接到Elasticsearch实例并查询目录信息,为您提供一个可以从其中加载数据的表列表:

    应用 Qlik 选择表

  8. 可视化数据

    点击添加数据按钮并自定义您的数据可视化:

    应用 Qlik 可视化

SQuirreL SQL

edit

您可以使用 Elasticsearch JDBC 驱动程序从 SQuirreL SQL 访问 Elasticsearch 数据。

Elastic 不认可、推广或提供对此应用程序的支持;如需在此产品中进行原生 Elasticsearch 集成,请联系其供应商。

先决条件

edit

添加 Elasticsearch JDBC 驱动

edit

要添加Elasticsearch JDBC驱动程序,请使用Windows > 查看驱动程序菜单(或Ctrl+Shift+D快捷键):

松鼠1查看驱动程序

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

松鼠2选择驱动程序

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

松鼠 3 添加驱动程序

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

松鼠4驱动列表

为Elasticsearch添加别名

edit

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

松鼠 5 添加别名

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

squirell 6 alias props

设置已完成。通过点击测试连接来再次确认。

执行SQL查询

edit

连接应自动打开(如果之前已创建,只需在别名面板中单击连接)。SQuirreL SQL 现在可以向 Elasticsearch 发送 SQL 命令:

松鼠7数据

SQL Workbench/J

edit

您可以使用 Elasticsearch JDBC 驱动程序从 SQL Workbench/J 访问 Elasticsearch 数据。

Elastic 不认可、推广或提供对此应用程序的支持;如需在此产品中进行原生 Elasticsearch 集成,请联系其供应商。

先决条件

edit

添加 Elasticsearch JDBC 驱动

edit

通过管理驱动程序将Elasticsearch JDBC驱动添加到SQL Workbench/J中,可以从主窗口的文件菜单或连接窗口中进行操作:

工作台 1 管理驱动程序

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

工作台 2 选择驱动程序

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

工作台 3 添加 jar

创建一个新的连接配置文件

edit

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

工作台 4 连接

选择之前配置的驱动程序,并使用JDBC语法设置集群的URL。 通过测试按钮验证连接 - 应该会出现一个确认窗口,表明所有内容都已正确配置。

设置已完成。

执行SQL查询

edit

SQL Workbench/J 已准备好通过 SQL 与 Elasticsearch 进行通信:点击创建的配置文件以执行语句或浏览数据:

工作台 5 数据

Tableau Desktop

edit

使用 Elasticsearch JDBC 驱动程序和专用的 Elasticsearch Tableau 连接器从 Tableau Desktop 访问 Elasticsearch 数据。

Elastic 不认可、推广或提供对此应用程序的支持;如需在此产品中进行原生 Elasticsearch 集成,请联系其供应商。

先决条件

edit

加载数据

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 by Elastic作为数据源

新建连接模态框中,输入您的Elasticsearch实例的信息,然后点击登录

登录

在主窗口中,选择您的Elasticsearch实例作为数据库。然后选择一个表进行加载。

选择一个表来加载

最后,生成一份报告。

生成报告

Tableau Server

edit

使用Elasticsearch JDBC驱动程序和专用的Elasticsearch Tableau连接器从Tableau Server访问Elasticsearch数据。

Elastic 不认可、推广或提供对此应用程序的支持;如需在此产品中进行原生 Elasticsearch 集成,请联系其供应商。

先决条件

edit

加载数据

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实例的信息,然后点击登录

登录

在主窗口中,选择您的Elasticsearch实例作为数据库。然后选择一个表进行加载。

选择一个表来加载

最后,生成一份报告。

生成报告