ElasticSearchDSL 数据连接

1. 概述

1.1 功能概述

Wyn支持连接 ElasticSearchDSL 数据库，然后对接入的数据进行加工和处理，并最终通过仪表板或报表实现数据的可视化展示。

1.2 应用场景

当您需要使用 ElasticSearchDSL 数据库，并将其数据接入 Wyn，借助 Wyn 强大的可视化图表与报表功能进行数据展示时，本文将为您详细介绍 ElasticSearchDSL 数据库接入 Wyn 的具体操作流程，为您提供全面且实用的参考。

2. 操作步骤

2.1 前提条件

连接 ElasticSearchDSL 数据库的前提条件如下：

版本要求：Wyn 支持 ElasticSearchDSL 数据库的版本为 7.x~7.17。

2.2 操作步骤

步骤一：创建数据源，选择ElasticSearchDSL

文档门户单击创建文档，选择数据源。
下图图标视图选择ElasticSearchDSL。

步骤二：填写配置信息

填写数据库配置信息。

配置信息具体介绍见下表：

参数	说明
名称	自定义输入数据源的名称。
主机名	主机名称或IP。
端口	端口号，默认为9200。
用户名	连接数据库的用户名。
密码	连接数据库用户的密码。
使用配置连接字符串（高级）	如果您勾选了此选项，则只需要填写此项与数据源的名称即可。填写此项的格式为： `HostName=myHostname;Port=myPort;username=myUsername;Password=myPassword`

步骤三：测试连接

单击页面左下角的测试数据连接测试连接是否正常。
连接成功后，单击确定。

步骤四：保存

单击创建，保存 ElasticSearchDSL 数据源。

Wyn成功连接 ElasticSearchDSL 数据库后，可以在「文档门户>我的分析>数据源」列表中找到创建成功的 ElasticSearchDSL 数据源。更多介绍，请见数据源操作。

3. 注意事项

3.1 关于ElasticSearchDSL数据源的应用

我们无法通过单击数据源名称直接预览 ElasticSearchDSL 数据源中的内容，这是因为 ElasticSearchDSL 数据源的特殊性。对于此类数据源，我们只能通过原生查询的方式读取数据库中的数据。
在数据集中使用 ElasticSearchDSL 数据源时，无法通过拖拽数据表来建立关联关系，仅支持创建自定义表，并且必须使用原生查询来获取数据。
原生查询需要遵循 ElasticSearch 的原生语法，这种方式不仅能够提高查询效率，还可以利用原生语法中的丰富命令语句，实现更灵活、更复杂的查询需求，从而获得更精准的查询结果。
有关 Elastic SearchDSL 命令的更多介绍请您参考 Elastic SearchDSL 官网。
下面一起来看看例子：
1）添加自定义表：

2）使用原生查询语法：

3）另外，查询语句中支持使用参数，如下图所示使用了一个用户信息上下文的参数。

type=info
注意1：
参数使用字符串类型的用户信息上下文时，须保证参数值不能为空。因为当参数值为空时，查询时将返回所有的数据。存在一定的安全风险，请您留意。
注意2：
使用 ElasticSearch 原生查询时，支持字符串类型、整型和布尔类型，其他类型（包括日期型和日期时间）都会转为字符串或显示为不支持。
那么如何在ElasticSearch 原生查询中使用日期时间类型字段呢？
在这种情况下，用户需要添加一个计算字段，然后指定类型为日期时间，从而将已转换为字符串的列重新转换为日期时间列。
注意3：
在 Wyn 中不支持以下aggregations：
1. Pipeline aggregations 均不支持；
2. Bucket aggregations 中不支持以下几类：
- Categorize text
- Children
- Composite
- Geo-distance
- Geohash grid
- Geotile grid
- Global
- Nested
- Parent
- Reverse nested
3. Metrics aggregations 中不支持：
- Geo-bounds
- Geo-centroid
- Geo-Line

1. 概述
1.1 功能概述
1.2 应用场景
2. 操作步骤
2.1 前提条件
2.2 操作步骤
3. 注意事项
3.1 关于ElasticSearchDSL数据源的应用