跳到主要内容
版本：7.4.0

数据账户

1. 概述

数据账户，是用于连接数据库（服务）的通行凭证。通过数据账户，可以快速的进行数据库连接，获取数据库中的表信息，进行数据集的创建。通过数据账户所有者和使用者的权限分离，可以满足企业不同用户的数据账户管理需求。

2. 使用指导

功能入口：数据准备 > 数据账户 > 新建/管理。

image.png

2.1  选择连接器

在数据账户页面，点击右上角“新建数据账户”按钮，进入配置页面后，按需选择数据库连接器。

注意：

1. 若未找到合适的数据库连接器，观远BI支持自助式对接外部数据库，详见自助式对接外部数据库。 

2. 若勾选到相关连接器，但却报错“无法解析”等相关信息，详见《报错说明》。

1.gif

2.2 配置数据账户

2.2.1. 常规配置

在当前界面，配置连接方式、数据库地址、用户名/密码、数据库名、端口、SSL协议等参数。

说明

以MySQL连接器为例，其余连接器操作配置略有差异，以实际页面为准。

  • 当连接方式选择「指定数据库」时，需要配置：

    • 数据库地址(域名或 ip)：指定数据库所在服务器的网络地址（域名或 IP），让系统能找到运行数据库的服务器；
    • 用户名：数据库的登录身份标识，用于验证连接者的身份合法性；
    • 密码：与用户名配套的认证凭证，进一步确认用户身份，确保只有授权用户可访问数据库；
    • 数据库名：指定要连接的具体数据库（因一台数据库服务器可能承载多个数据库）；
    • 端口：数据库服务监听的网络端口号，通过该端口建立与数据库服务的网络连接（如 MySQL 默认端口为 3306）；
    • 是否使用 SSL 协议：决定数据库连接是否启用 SSL 加密，「true」为启用（保障数据传输安全），「false」为不启用。

  • 当连接方式选择「JDBC URL」时，需要配置：

    • 用户名：数据库的登录身份标识，用于验证连接者的身份合法性；

    • 密码：与用户名配套的认证凭证，进一步确认用户身份，确保只有授权用户可访问数据库；

    • 数据库名：指定要连接的具体数据库（因一台数据库服务器可能承载多个数据库）；

    • JDBC URL：包含连接数据库的核心信息，如数据库类型（示例中为 MySQL，格式前缀jdbc:mysql:）、服务器主机地址（{host}）、端口（{port}）、目标数据库名（{database}）等。应用程序通过解析该 URL，能自动构建与数据库的连接。

    • JDBC 加密参数：当 JDBC URL 中存在${xxxx}格式的占位符时，系统会自动解析出参数名并展示在此区域。需为每个解析出的参数填写参数值（必填），参数值会像 “密码” 一样，进行base64 加密存储与展示（如显示为******），保障敏感信息安全。

      示例：

      • JDBC URL：65005858312643302.databricks.azure.cn:443/default?transportMode=http;ssl=1;httpPath=sql/protocolv1/6500585831264330/0329-123321-rqotvx1s;AuthMech=3;UID=${UID};PWD=${PWD}
      • JDBC URL 加密参数：自动解析出UID、PWD两个参数名，填写参数值（如token、dapib9d4646a35b0d51b552126e6853a1639）后，会加密并展示为******。

2.2.2. （可选）高级设置

部分数据库在配置数据账户时，支持额外的高级设置：

  • 最大连接数：支持设置单个数据账户的连接池数上限，若运行中连接数超过该数值则连接排队。

  • 驱动：支持用户在新建数据账户时，选择已设置好的“自定义”驱动；

2.gif

2.2.3. 测试连接

配置完成后，点击「测试连接」以验证配置的正确性和网络连接的可用性。

  • 若测试连接成功，表示配置正确并且可以连接到数据库，可以进行下一步；

  • 若测试连接失败，会收到错误消息（含连接失败的原因），需要进行参数修改。

2.2.4. 确认数据账户信息

为当前数据库的数据账号进行命名，完成数据账户创建的全部流程。

2.3 管理数据账户

创建完成后的数据账户，将会统一放置在数据账户列表中。用户可进行过滤查询，并对某个已创建的数据账户进行修改、权限配置、查看资源血缘、迁移等。

3.gif

在权限配置方面，用户可为当前数据账户指定所有者和使用者，所有者拥有当前数据账户资源的全部管理权限，使用者可使用该数据账户创建相关数据集。

此外，数据账户也支持作为一种 BI 资源进行一键迁移，详情请参阅《数据账户迁移》。

4.gif

当需要重连数据池时，可单击「刷新连接池」手动刷新数据账户的连接池。

image-10