Setting up a SQL connector

简介

本页包含有关如何创建新的 SQL 连接器并将其连接到源系统的说明。

先决条件

假设已安装设置本地测试环境中描述的开发工具。

创建新的 SQL 连接器

如果要构建新的 SQL 连接器，可以下载模板连接器，其中包含 SQL 连接器的基本设置。

启动存储库

建议将连接器存储在版本控制系统中，例如 GitHub。

步骤	操作
1	创建一个包含完整连接器目录的新存储库。 此目录必须与下载的（模板）连接器具有相同的结构。

配置提取

首先，需要设置提取设置，以指向所需的源系统和暂存数据库。 对于每个开发者环境和生产环境，必须执行一次这些配置步骤。

步骤 1：选择提取方法

每个连接器都附带一组特定的提取方法。 需要配置其中一种提取方法，以提取源数据。

提取方法	描述
从文件加载	• 为“从文件加载”提取程序设置 CData 作业。 请参阅提取程序：从文件加载。 • 使用extractors/load-from-file/instructions.md中提供的特定于此连接器的自定义查询。
从源加载	要从源系统加载输入数据，请使用extractors/load-from-source/instructions.md中的特定说明。 “从源加载”提取程序仅适用于为特定源系统制作的连接器，例如 “SAP 采购到付款”连接器。

步骤 2：限制源数据

确保为提取程序设置适当的筛选器，以仅加载分析所需的数据。 例如，将数据限制为过去 6 个月的数据，或仅限于感兴趣的特定部门。

有关筛选输入数据的特定说明，请参见提取程序的instructions.md 。

步骤 3：配置提取脚本

如果连接器使用 CData Sync 进行数据提取，则extract_cdata.ps1脚本必须指向正确的作业。 请按照以下步骤配置提取脚本。

步骤	操作
1	在scripts/目录中，将config_template.json重命名为config.json 。 config.json 被 Git 忽略，以便开发和生产环境可以使用不同的提取配置。
2	在config.json中，将文本JOB_NAME_CREATED_IN_CDATA更改为刚刚创建的 CData 作业。

如果连接器不使用 CData Sync 提取数据，请使用instructions.md中提供的特定说明。

配置转换

要在正确的暂存数据库上执行转换， profiles.yml需要为此连接器引用您的暂存数据库。 需要为每个开发者环境和生产环境执行一次这些配置步骤。 请按照以下步骤配置转换。

步骤	操作
1	复制连接器transformations/profiles.yml的内容。
2	将内容粘贴到您的个人profiles.yml中以添加这些内容。 个人profiles.yml应位于连接器目录之外。
3	将内容更改为指向您的临时数据库。

配置负载

要使用 load.ps1 脚本执行缓存生成，必须将其指向相应应用程序版本处于活动状态的 Process Mining 环境。 请按照以下步骤配置提取脚本。

如果在配置提取过程中已执行步骤 1 ，则可以省略该步骤。

步骤	操作
1	在scripts/目录中，将config_template.json重命名为config.json 。 config.json 被 Git 忽略，以便开发和生产环境可以使用不同的提取配置。
2	在config.json中，将文本PROCESS_MINING_ENVIRONMENT更改为激活版本的环境。

后续步骤

正确设置 SQL 连接器后，即可运行。 请参阅 运行 SQL 连接器。