1. MySQL 数据连接概述

MySQL 是最流行的关系型数据库管理系统之一，由瑞典 MySQL AB 公司开发，属于 Oracle 旗下产品。关系数据库将数据保存在不同的表中，而不是将所有数据放在一个大仓库内，具备提升速度、灵活性等特点。观远数据针对 MySQL专门开发了数据连接器，本文将介绍如何连接 MySQL 数据库。

2. 准备工作

在连接数据库之前，请收集以下信息：

• 数据库的版本（版本要求： MySQL ≥5.5）；

• 数据库所在服务器的 IP 地址和端口号；

• 数据库的名称；

• 数据库的用户名和密码；

• 需要连接的数据库方式。

3. 连接步骤

3.1 创建数据连接账户

登录观远BI ，点击「数据中心>数据账户」，点击「新建数据账户」，在添加账户弹窗中，账户平台框选择「 MySQL」，如下图所示：

连接方式可以选择“指定数据库”或“JDBC URL”两种。确认信息填写无误后，点击“测试连接”，显示“连接成功”，则点击“确认”创建好一个 MySQL 数据连接账户。

3.2 创建数据集

选择连接器

点击「数据中心>数据集」，点击“+新建数据集”，选择“数据库”。在“选择连接器”中选中“ MySQL”，点击下一步。

选择数据表

下拉选择已有数据账户，通过MySQL接入数据时，选择数据表共有两种数据创建方式，分别为SQL查询和图形建模。

模式一：SQL查询

左侧为当前连接数据库中的数据表，选择数据表可快速创建查询语句。您也可以根据自己的需要在中间“SQL 查询”区域填写查询语句。

输入框下方有“时间宏”供您选择，为数据更新与动态分析设置时间要求。观远数据的动态时间宏，可以帮助您根据当前日期生成动态SQL，高效实现定时刷新数据与增量更新。例如我们可以输入这样的SQL语句：

更多使用方式可查看《动态时间宏》。点击“时间宏”下方的“添加参数”功能，可以使用参数来实现数据分析维度的切换。更多使用方式可查看《全局参数》。

数据预览成功后，可进入到下一步。

模式二：图形建模

图形建模，是观远数据为了降低数据对接过程中的操作门槛，方便非技术同事也能更快更好进行数据连接工作，而提供的进行表和表之间关联操作的功能，通过图形化的方式实现数据连接。在创建数据集的开始，选择MySQL或Impala后，即可在数据库查询环节，选择“图形建模”方式（目前仅支持MySQL与Impala对接）。针对已创建的数据集，在修改模型结构时，也支持图形建模方式，操作方式不变，具体如下：

a. 从数据集列表中采用拖拽的方式将数据集添加进入“关联创建”画布中：选择需要的一张或多张数据表，若选择多张数据表，则需要关联或者拼接成一张宽表;

b. 当拖入2张表时，默认选择内连接方式，若两张表存在同名字段，会优先自动将同名字段作为外键进行关联；用户也可通过手动方式增减以及设置关联条件；

c. 关联创建支持内连接、左外连接、全连接以及行拼接（支持的操作会协同数据库本身，如MySQL本身不支持全连接在关联创建中也不支持全连接）；

d. 当不再需要该数据集时，可右键唤起删除操作进行删除；

e. 需要设置完成所有关联关系，才可以进入到第二步“字段配置”；

f. 完成关联创建后，进入到字段配置，进行选择列以及条件筛选环节；

g. 预览数据集无问题后，可进入下一步操作。

数据连接及更新设置

观远数据支持“直连数据库”与“Guan-Index”两种数据库连接方式。点击数据库连接方式的选择框，选择“直连数据库”或“Guan-Index”，并进行相关设置。

方式一： 直连数据库

直连数据库，是指选择“直连数据库”时，卡片数据将直接从数据库获得。用户需要设置“缓存有效周期”和“支持实时卡片数据”。

• “缓存有效周期”即“数据更新周期”，作用是定时更新与该数据集相关的所有卡片、卡片数据集、ETL、JOIN等数据。

• “支持实时卡片数据”是指建在该数据集上的卡片，可支持更短周期的数据更新，当前默认为1分钟。

如果开通了“24h定时更新任务密度图功能”，功能开启后，缓存有效周期选择每天/每周/每月，则会展示定时更新任务密度图（如需使用该功能，请联系观远人员协助开启）。

方式二： Guan-Index

Guan-Index，是指数据被抽取到观远服务器后将构建物理数据集，支持增量更新。具体使用步骤如下：

• 首先，当您选择Guan-Index模式时，在上一步的“数据库查询”中，不能选择“添加参数”。

• 其次，若您要对数据集进行增量更新或未来有设置增量更新的可能，可以通过点击选择“去重主键”，对未来需要增量更新的字段进行设置。

• 再次，如点击“增量更新”，您可以填写SQL来设置增量更新的条件，通常与时间宏参数配合进行。

• 最后，设置数据更新周期，即可进入“下一步”。

确认数据表信息

在确认数据表信息阶段，观远数据支持确定数据集名称与保存位置、支持字段重命名，通过MySQL数据库接入数据时还支持字段名称显示为字段注释。

信息一：确定数据集名称与保存位置

为您的数据集提供一个方便辨识的名字，以及指定保存位置。点击确认后，数据集创建成功，可以在“数据中心”-“数据集”中找到它。需要注意的是，若创建的是Guan-Index数据集，您可能需要等待一段时间，等数据抽取完成后可以在“数据中心”看到正确的数据集信息。

信息二：支持字段重命名

当字段名需要修改时，点击字段名右侧的小箭头，即可打开下拉框，修改字段名。

信息三：字段名称显示为字段注释

若勾选“字段名称显示为字段注释”，字段名称将自动同步成数据库中已设置的字段注释。当企业的IT部门构建应用层宽表时，通常在数仓或者数据库环境会将宽表的数据集字段中文名称标注在表结构的comments中。当BI在对接宽表时，可通过此功能直接将原表comments中的字段注释直接覆盖成字段名称，减少手动修改的重复工作。

3.3 使用数据集

在数据集创建完后，可以直接使用数据集制作可视化图表等操作，您还可以对数据集进行其他设置操作，具体操作可查看《数据集》相关文档。