Oracle 数据连接

1. 概述

1.1 功能概述

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

1.2 应用场景

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

2. 操作步骤

2.1 前提条件

连接 Oracle 数据库前，需满足以下条件：

版本要求：Wyn 支持 Oracle 数据库的最低版本为10g ，需要安装Oracle Client；11g以上无需安装Oracle Client。

2.2 操作步骤

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

在文档门户中可通过以下两种方式创建数据源（具体操作界面详见下方对比表格）：

快捷创建：文档门户单击工作空间进入文档列表，找到数据源后鼠标悬停单击“+”按钮，即可进入数据源选择界面。
完整创建：文档门户单击工作空间进入文档列表，选中数据源进入数据源列表界面，在该界面单击 +创建数据源 按钮，即可进入数据源选择界面。
快捷创建：鼠标悬停创建数据源
完整创建：数据源列表创建数据源

在数据源选择界面，找到 Oracle 并单击。

步骤二：填写配置信息

填写数据库配置信息。

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

类别	参数	说明
快速配置	名称	自定义输入数据源的名称。
	主机	主机名。
	端口	端口号，默认为1521。
	用户名	连接Oracle的用户名。
	密码	连接Oracle用户的密码。
	服务名称	输入服务器Oracle实例名，如ORCL。
高级配置	使用配置连接字符串	如果您勾选了此选项，则只需要填写此项与数据源的名称即可。填写此项的格式为： `USER ID=myUserId; Password=myPassword; Data Source="(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST= myOracleDBHost)(PORT=myOracleDBPort))(CONNECT_DATA=(SERVICE_NAME=myOracleDBServiceName)))";CommandTimeout=myCommandTimeout; AllowNonOwnerTables=true;` 另外，字符串中可以使用用户上下文和组织上下文来进行数据过滤。格式为： “`@{用户上下文名称}`”如“`@{DBName}`”，详见用户上下文属性管理。和“`#{组织信息上下文}`”如“`#{DBName}`”，详见组织属性和组织信息上下文。 AllowNonOwnerTables 为选填项，在不填写该配置项时，创建的数据连接仅能访问指定的schema。 - 该配置项为True时，允许访问所有当前用户有权限访问的所有schema。 - 该配置项为False时，与不填写该配置项时一样，仅能访问指定的schema。注意：当设置AllowNonOwnerTables=True时，在数据集或数据模型中使用该数据源时，由于需要加载所有schema下的数据表，可能会导致性能问题，请您根据自身业务需要来配置该项。
高级配置	使用表/字段名称映射	修改数据源中的表名或列名，使其在数据集中显示为期望的名称。详情请见使用表/字段名称映射(修改数据源表名或列名)。

步骤三：测试连接

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

步骤四：保存

单击右下角的创建按钮，即可保存 Oracle 数据源。
Wyn成功连接 Oracle 数据库后，可以在「文档门户>工作空间>数据源」列表中找到创建成功的 Oracle 数据源，可以对其进行管理操作，更多介绍，请见数据源操作。

3. 注意事项

如果 Wyn 安装在 Linux 系统中，需要连接 Windows 系统中的 Oracle 数据源时，需要首先在 Linux 系统中设定时区，使其与 Oracle 数据源所在时区一致，然后重启系统。
例如：
```
ln -fs /usr/share/zoneinfo/Asia/Chongqing /etc/localtime
dpkg-reconfigure -f noninteractive tzdata
sudo systemctl stop wyn
sudo systemctl start wyn
```