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 同步作业执行的更多详细信息，请转到 CData 同步实例，然后检查作业的“ 日志记录和历史记录” 选项卡。 请参见下图。

要记录更多详细信息，请将“ 日志文件详细程度 ”设置为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 ，并删除临时文件。

计划数据提取

还可以安排定期数据提取。 请参阅 计划数据提取。