Running a SQL connector

简介

本页包含有关如何使用脚本运行 SQL 连接器的说明。

先决条件

run.ps1和load.ps1需要与用于生产的 Process Mining 安装在同一台服务器上运行。 extraction_cdata.ps1和transform.ps1脚本也可以从其他位置运行。

假设：

• 已安装设置本地测试环境中所述的开发工具。
• 按照设置 SQL 连接器中的说明设置 SQL 连接器。
  备注：

  连接器的scripts/目录包含一组标准脚本，用于运行和计划数据提取、转换和加载。

运行连接器

请按照以下步骤运行连接器，提取、转换和加载数据。

步骤	操作
1	以管理员身份启动Windows PowerShell 。
2	转到scripts/目录。
3	执行run.ps1 。

仅运行提取

请按照以下步骤仅执行提取。

步骤	操作
1	启动Windows PowerShell 。
2	转到scripts/目录。
3	执行extraction_cdata.ps1 。

备注：

如果您的连接器不使用 CData Sync 提取数据，则extraction_ script的名称将有所不同。

仅运行转换

请按照以下步骤仅执行转换步骤。

步骤	操作
1	启动Windows PowerShell 。
2	转到scripts/目录。
3	执行transform.ps1 。

每个转换步骤也可以单独运行。

仅运行负载

请按照以下步骤仅执行加载步骤。

步骤	操作
1	以管理员身份启动Windows PowerShell 。
2	转到scripts/目录。
3	执行load.ps1 。

调试错误

运行脚本时，系统会创建一个日志文件LogFile.log 。 此日志文件包含作业执行的所有阶段以及关联的时间戳。 日志文件还返回一组最小的错误代码，可以提供进一步的指导。

加载

有关缓存生成的更多详细信息，请选中加载脚本所在目录中生成的cache_generation_output.log 。

C 数据提取

有关 CData Sync 作业执行的更多详细信息，请转到 CData Sync 实例并查看作业的“日志记录和历史记录”选项卡。请参见下图。

要记录更多详细信息，请将日志文件详细程度设置为Verbose并再次运行提取脚本extraction_cdata.ps1 。

下面概述了 CData 同步作业的返回代码。

代码	日志说明
0	作业“提取”成功。
-1	作业“提取失败”。
-2	执行提取失败。检查您的设置或查看作业的“日志记录和历史记录”选项卡。

转换

日志文件还返回转换脚本的一组错误代码。 以下是错误代码的概述。

代码	日志说明
-1	常规dbt run或dbt test失败。 这意味着当前设置或配置存在问题。 有关更多详细信息，请查看LogFile.log 。
0*	dbt调用已完成，没有错误。
1*	已完成dbt调用，至少处理一个错误（例如模型语法错误、权限错误等）。运行已完成，但可能已跳过某些模型。LogFile.log包含额外信息，说明错误是发生在dbt run阶段还是dbt test阶段。
2*	dbt调用已完成，但出现未处理的错误（例如网络中断）。

• 0、1 和 2 是dbt特定的返回代码。有关退出代码，请参阅官方 dbt 文档。

调试大型 Dbt 项目

如果运行转换需要很长时间，则可以检查scripts/目录中的response.txt 。其中包含来自dbt的实时响应。完成dbt test或dbt run后，系统会将信息附加到LogFile.log ，并删除临时文件。

计划数据提取

还可以设置定期提取数据。请参阅计划数据提取。