部署自定义原生查询数据源

1. 概述

1.1 功能概述

Wyn支持编写部署自定义原生查询数据源提供程序，然后对接入的数据进行加工和处理，并最终通过仪表板或报表实现数据的可视化展示。

1.2 应用场景

当您需要使用自己的数据库，并期望将其数据接入 Wyn，借助 Wyn丰富的可视化图表及报表功能进行数据展示时，本文将为您详细指引部署自定义原生查询数据源提供程序的具体操作流程，提供全面且实用的参考。

2. 操作步骤

2.1 前提条件

程序：自定义数据源提供程序已编写完成。

type=info
编写自定义数据源请参考编写自定义原生查询数据源提供程序。
如有疑问可以参考下面的示例代码：
jdbc_source.zip

本章节以JDBC数据源为例，逐步讲解如何在Wyn中创建一个JDBC数据源提供程序并使用。

您可以前往第三方数据库的官方网站下载相应的JDBC驱动程序。

MySQL的：https://dev.mysql.com/downloads/connector/j/
SQL服务器：https://learn.microsoft.com/zh-cn/sql/connect/jdbc/download-microsoft-jdbc-driver-for-sql-server?view=sql-server-ver16
Postgres：https://jdbc.postgresql.org/download/

本章节使用的NativeJdbcProvider示例代码中要求驱动必须在工作目录中，请根据您的自定义原生查询数据源提供程序的设置决定驱动放置的位置。

2.2 操作步骤

2.2.1 部署自定义数据源提供程序

步骤一：文件部署

打开自定义数据源，在项目文件所在的目录中执行dotnet publish命令。

QQ_1722563873148

等待执行完成，在该目录下.\bin\Release\net8.0\publish目录即为工作目录。

把工作目录移动到Wyn部署的机器上。

步骤二：修改配置

停止WynService的服务。

在配置文件 Wyn.conf 中的DataProviders节点下添加CustomNativeQueryDataProviderAssemblies节点，并把其内容设置为工作目录下自定义数据源提供程序程序集的路径。

示例：

<GlobalSettings>
  <DataProviders>
    <CustomNativeQueryDataProviderAssemblies>
      <sys:string>E:\work\custom datasource\jdbc_source\NativeJdbcProvider.dll</sys:string>
    </CustomNativeQueryDataProviderAssemblies>
  </DataProviders>
</GlobalSettings>

type=info
提示
标准版，Windows环境中配置文件的默认路径为 C:\Program Files\Wyn\conf 。
请将 Wyn.conf 文件备份后再进行修改操作，以备修改过程中对比内容或恢复文件时使用。
如需在原路径下进行修改，请使用管理员权限打开 Wyn.conf 文件。
在 Wyn.conf 中使用 <sys:string> 时，需要在 Wyn.conf 的最前面添加 xmlns:sys="https://extendedxmlserializer.github.io/system"。

步骤三：重启服务

重启 WynService 服务。