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

功能概述

编写好的自定义原生查询数据源提供程序，可按如下步骤部署并在系统中使用，以实现对自定义数据源的连接。

前置准备：自定义数据源提供程序。

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

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

操作介绍

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

1. 文件部署

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

QQ_1722563873148

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

type=info
本章节使用JDBC数据源供应程序为例，需要目标数据库的JDBC驱动才能工作。
您可以前往第三方数据库的官方网站下载相应的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示例代码中要求驱动必须在工作目录中，请根据您的自定义原生查询数据源提供程序的设置决定驱动放置的位置。

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

2. 修改配置

停止WynService的服务。

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

示例：

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

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