# Teradata 数据连接

本章将详细介绍Wyn中连接Teradata数据库的操作流程。

## Content

## 1\. 概述

### 1.1 功能概述

%PRODUCT\_NAME%支持连接 Teradata 数据库，并基于其数据创建数据模型或数据集，最终通过仪表板中的组件实现数据的可视化展示。

### 1.2 应用场景

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

## 2\. 操作步骤

### 2.1 前提条件

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

1. **系统要求**：%PRODUCT\_NAME% 支持 Teradata 数据库的版本为 **16.10, 16.20, 17.00, 17.10, 17.20**。
2. **驱动配置**：
    **步骤一：下载驱动**
    1）创建 Teradata 数据连接前，需要手动下载驱动。
    具体步骤如下：
    由 [https://www.nuget.org/packages/Teradata.Client.Provider/17.20.7](https://www.nuget.org/packages/Teradata.Client.Provider/17.20.7) 处下载`Teradata.Client.Provider` 驱动，驱动文件名为 `teradata.client.provider.17.20.7.nupkg`（请注意必须使用该指定版本）。
    **步骤二：部署驱动**
    1）下载后将压缩包解压。然后拷贝`Teradata.Client.Provider.dll`和`Teradata.Net.Security.Tdgss.dll` 这两个dll文件。
    ![image](https://gccndocumentsitestorage.blob.core.chinacloudapi.cn/document-site-files/images/d25f585e-d6e6-400c-a4ae-dbeb87dedc63/image.c0d26f.png?width=500)
    将拷贝的两个dll文件放到以下目录中：
    `\Wyn\DataSourceService\third-party-drivers\teradata` （如缺少对应文件夹，请手动创建）
    **步骤三：重启服务**
    1）[重启WynService 服务](/solutions/wyn/help/docs/installation-deployment/others/wynservicerestart)。

    >type=info
    > **提示：**
    > 1. Server 和 Cotworker 都需要用到这个驱动，所以如果您将 Server 和 Cotworker部署在了不同的机器上，那么就需要分别部署驱动。
    >  部署路径均为：`\Wyn\DataSourceService\third-party-drivers\teradata` （如缺少对应文件夹，请手动创建）
    > 2. Linux 环境中区分大小写，请注意文件夹名称要与给出的路径相同。

3. **启用数据源**：标准版系统中默认没有开启该数据源的连接入口，开启方法详见[标准版中启用JDBC驱动支持(Windows)](/solutions/wyn/help/docs/data-connection/start-java-databese)和[标准版中启用JDBC驱动支持(Linux)](/solutions/wyn/help/docs/data-connection/staret-jdbc-database-in-linux)。

### 2.2 操作步骤

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

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

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

    | 快捷创建：鼠标悬停创建数据源 | 完整创建：数据源列表创建数据源 |
    | -------------- | --------------- |
    | ![PixPin_2025-08-11_17-40-55](https://gccndocumentsitestorage.blob.core.chinacloudapi.cn/document-site-files/images/53718c5b-c627-4bb8-afaf-3db83ed6dcd8/PixPin_2025-08-11_17-40-55.6418d1.png?width=500) | ![PixPin_2025-08-11_17-39-59](https://gccndocumentsitestorage.blob.core.chinacloudapi.cn/document-site-files/images/53718c5b-c627-4bb8-afaf-3db83ed6dcd8/PixPin_2025-08-11_17-39-59.a5ea62.png?width=500) |

2. 在数据源选择界面，找到 **Teradata** 并单击。
    ![PixPin_2025-08-14_09-05-05](https://gccndocumentsitestorage.blob.core.chinacloudapi.cn/document-site-files/images/53718c5b-c627-4bb8-afaf-3db83ed6dcd8/PixPin_2025-08-14_09-05-05.840372.png?width=700)

**步骤二：填写配置信息**

1. 填写数据库配置信息。
    ![image](https://gccndocumentsitestorage.blob.core.chinacloudapi.cn/document-site-files/images/d25f585e-d6e6-400c-a4ae-dbeb87dedc63/image.61880f.png?width=700)
2. 配置信息具体介绍见下表：

    | **参数** | **说明** |
    | :--- | :--- |
    | 名称 | 自定义输入数据源的名称。 |
    | 主机 | 主机名或主机IP。 |
    | 端口 | 端口号，默认为1025。 |
    | 用户名 | 连接数据库的用户名。 |
    | 密码 | 连接数据库用户的密码。 |
    | 数据库 | 输入数据库名或单击下拉箭头选择数据库。 |
    | 使用配置连接字符串（高级） | 如果您勾选了此选项，则只需要填写此项与数据源的名称即可。填写此项的格式为：<br>`Data Source=myServerAddress;Port Number=port;UserID=myUsername;Password=myPassword;Database=database;`<br> 另外，字符串中可以使用用户上下文和组织上下文来进行数据过滤。格式为：<br> “`@{用户上下文名称}`”如“`@{DBName}`”，详见[用户上下文属性管理](/solutions/wyn/help/docs/permission-management/account/user-context-management)。<br> 和“`#{组织信息上下文}`”如“`#{DBName}`”，详见[组织属性和组织信息上下文](/solutions/wyn/help/docs/permission-management/account/organization/organization-properties-and-information-context)。 |
    | 使用表/字段名称映射 | 修改数据源中的表名或列名，使其在数据集中显示为期望的名称。<br>详情请见[使用表/字段名称映射(修改数据源表名或列名)](/solutions/wyn/help/docs/data-connection/mapping-use-table/filed-name)。 |

**步骤三：测试连接**

1. 单击页面左下角的<strong>测试数据连接</strong>测试连接是否正常。
    ![image](https://gccndocumentsitestorage.blob.core.chinacloudapi.cn/document-site-files/images/d25f585e-d6e6-400c-a4ae-dbeb87dedc63/image.fa07f3.png?width=700)
2. 连接成功后，单击<strong>确定</strong>。
    ![image2019-11-4_17-33-26.png](https://gccndocumentsitestorage.blob.core.chinacloudapi.cn/document-site-files/images/470a8bbd-e525-44a5-a8a2-dc9a77e30084/80186825/image2019-11-4_17-33-26.png?width=500)

**步骤四：保存**

1. 单击右下角的**创建**按钮，即可保存 Teradata 数据源。
    ![image](https://gccndocumentsitestorage.blob.core.chinacloudapi.cn/document-site-files/images/d25f585e-d6e6-400c-a4ae-dbeb87dedc63/image.a3bf77.png?width=700)
2. %PRODUCT\_NAME%成功连接 Teradata 数据库后，可以在「**文档门户>工作空间>数据源**」列表中找到创建成功的 Teradata 数据源。更多介绍，请见[数据源操作](/solutions/wyn/help/docs/data-connection/datasource-management-and-sharing/datasource-operate)。