跳到主要内容
版本：6.0.0

外部数据库接入

1. 外部数据库接入功能概述​

国产数据库正呈现出快速发展的势头，随着国家政策的支持和技术创新的推动，国产数据库在性能、安全性和可靠性等方面取得了显著进步，逐渐赢得了企业和政府部门的青睐。因此，观远推出自助式外部数据库接入方式，支持对接BI标准支持数据库范围外的云厂商、国产化等各类数据库以快速支撑售前客户的新型数据库POC以及服务中客户的国产数据库接入场景，提高了数据接入的灵活性，缩短数据库接入的时间等待周期。

2. 准备工作​

在进行外部数据库接入配置之前，请收集以下信息：

  • 驱动Jar包及可用的Driver Class；

  • 接入数据库的方言标准，表列表获取方式和方言数据库是否相同；

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

  • 数据库的名称；

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

  • 需支持以JDBC的方式进行连接。

3. 操作步骤​

3.1. 新建配置驱动和数据库连接器​

单击"管理中心 - 资源管理 - 驱动和连接器管理"开始新建、配置驱动和数据库连接器。

image.png

3.1.1. 新建配置驱动​

单击“驱动管理”-“新增驱动”开始新建、配置驱动：

  • 编辑驱动名称，单击“保存”即可完成驱动新建。

image.png

  • 选择刚才新建的驱动，上传驱动Jar包及可用的Driver Class，单击“应用”完成驱动配置。

image.png

3.1.2. 新建配置数据库连接器​

单击“数据库连接器管理”-“新建数据库连接器”开始新建、配置数据库连接器：

image.png

  • 显示ICON，设置自定义数据连接的图片ICON，用于在数据账户以及数据库数据集新建环节的展示。

  • 连接器名称，按照用户习惯自行定义，不支持特殊字符。

  • 默认方言支持，目前开放的支持方言有MySQL、Oracle、DB2、PG，已经验证支持的数据库如下：

方言数据库
MySQLOceanBase（MySQL）、云器LakeHouse
Oracle人大金仓KES
DB2Azure DataBricks
  • 获取表列表SQL，具体的数据库表列表获取逻辑和方言数据库可能出现不一致的情况，支持用户按照对应的数据库自定义获取逻辑，指定表列表获取的SQL以及返回结果集中表名所在列的index，示例：
数据库表列表获取SQL
云器LakeHouse{"sql": "show tables in ||schema||", "tableNameIdx": 2}
Azure DataBircks{"sql": "show tables", "tableNameIdx": 2}

SQL中指定了||schema||参数后，在创建数据账户时候动态展示schema选项，由用户输入

image.png

  • 用户名密码显示开关，例如Azure DataBricks的认证方式中用户名/密码是包含在URL中，不支持传统的传参方式，可以通过开关控制是否显示。

image.png

3.2. 创建数据账户​

驱动和连接建立完成后，在“数据中心”-“数据账户”-“新建数据账户”页面可以选择对应的连接以及驱动映射关系，完成数据账户的创建，对于自定义账户，考虑到非JDBC URL方式下的参数差异化，当前仅支持JDBC URL的连接方式。

image.png

已创建的数据账户都会保存在“数据账户”中，具体创建步骤可参考《数据账户》。