编辑和测试数据转换

Editing transformations

有关编辑数据转换的更多信息，请参阅下面列出的页面。

• Structure of transformations
• Designing an event log
• Tips for writing SQL

运行查询

备注：

对于 2023.10.7 之前的版本“全部运行”和“运行文件”限制为 10 分钟。从 2023.10.7 开始“全部运行”和“运行文件”的时长限制为 1 小时。强烈建议使用小型数据集开发和测试数据转换，以确保您的转换不会超过此时间限制。有关上传开发数据集的更多信息，请参阅Process Mining 门户。

编辑转换时，您可以选择“运行查询”以测试您的更改并查看预览。系统会运行修改后的查询和所有相关查询。例如，如果已修改cases_input.sql 。“运行查询”命令将运行cases_input.sql和cases.sql ，后者使用cases_input.sql的结果。

生成的数据仅在“数据转换”编辑器中可用，而在仪表板编辑器中不可用。

有两种类型的运行：

• 运行查询: 启动数据运行，重新计算所有修改后的查询及其依赖项。
• 运行文件：启动运行以仅重新计算当前选定的 SQL 文件及其父查询。此选项使您能够测试和调试对特定 SQL 文件的自定义。
  提示：

  您可以随时选择“取消运行”以取消转换运行。

结果显示在“预览”面板中。

备注：

“运行查询”通常比启动完整数据运行的“应用到仪表板”快得多。

备注：

运行查询不会影响已发布流程应用程序中的数据。

添加文件夹和文件

您可以在转换中创建新文件夹并添加新文件。

命名约定

• 对于文件、文件夹、字段和表格的名称：
  • 只能使用小写 (az) 字符、大写 (AZ) 字符和数字 (0-9)；
  • 不能对文件、文件夹、字段和表格的名称使用特殊字符|*:?"<>\/ 。
• 对于文件名，您只能使用_:.作为特殊字符。
• 文件名不能以_ （下划线）开头。

从转换菜单创建新的文件夹或文件

请按照以下步骤创建新的文件夹或文件。

步骤	操作
1	导航到转换中要添加新文件或文件夹的位置。
2	转到“转换”面板，然后选择菜单图标打开转换菜单。
3	从菜单中选择适用的选项。
4	输入新文件夹或文件的描述性名称，然后按“Enter”。

系统将在所选文件夹中创建新文件夹或文件。

从上下文菜单创建新文件夹或文件

请按照以下步骤从上下文菜单中创建新的文件夹或文件。

步骤	操作
1	右键单击转换中要在其中添加新文件或文件夹的文件夹。
2	从菜单中选择适用的选项。
3	输入新文件夹或文件的描述性名称，然后按“Enter”。

系统将在所选文件夹中创建新文件夹或文件。

未保存的文件更改

编辑.sql文件时， “转换”文件夹结构中会出现一个蓝色圆点，表示存在未保存的更改。

重命名文件夹或文件

请按照以下步骤创建新的文件夹或文件。

步骤	操作
1	右键单击要重命名的文件夹或文件以打开上下文菜单。
2	选择“重命名” 。
3	根据需要编辑名称，然后按“Enter”。

文件夹或文件已重命名。

删除文件夹或文件

请按照以下步骤创建新的文件夹或文件。

步骤	操作
1	右键单击要删除的文件夹或文件，打开上下文菜单。
2	选择“删除”。系统会显示确认消息。
3	选择“删除”以确认删除。

文件夹或文件已删除。

在文件中添加注释

如果要在 SQL 转换文件或文件的注释部分中包含注释，强烈建议使用默认情况下设置为 {# ... #} 的 Jinja 注释语法。这也使您能够注释宏。

SQL

{# {{ pm_utils.optional(ref('Cases_base'), '"Case_status"') }} as "Case_status", #}

{# case
    when {{ pm_utils.optional(ref('Cases_base'), '"Case_value"', 'double') }} >= 1000000 
      then {{ pm_utils.as_varchar('>= 1M') }}
    when {{ pm_utils.optional(ref('Cases_base'), '"Case_value"', 'double') }} >= 0 
     then {{ pm_utils.as_varchar('0 - 1M') }}
   when {{ pm_utils.optional(ref('Cases_base'), '"Case_value"', 'double') }} is not null
     then {{ pm_utils.as_varchar('< 0') }}
  end as "Case_value_group", #}

在文件中查找/替换

在“数据转换”编辑器中，您可以查找和替换单个文件中的文本。

查找文本

要在数据转换编辑器中查找文本，请执行以下操作：

1. 在代码编辑器中单击随机位置，或选择要在其他文本中搜索的文本。
2. 按CTRL+F 。
3. 在“查找”字段中输入要搜索的测试。当前文件中所有出现该文本的部分都将高亮显示。
4. 选择ENTER可跳至下一个匹配项。

查找和替换

要在数据转换编辑器中查找文本，请执行以下操作：

1. 在代码编辑器中单击随机位置，或选择要在其他文本中搜索的文本。
2. 按CTRL+H 。
3. 在“查找”字段中输入要搜索的测试，然后在“替换”字段中输入新测试。当前文件中所有出现该文本的部分都将高亮显示。
4. 选择ENTER以替换文本并跳到下一个匹配项。

要在数据转换编辑器中查找文本，请执行以下操作：

1. 单击代码编辑器。
2. 按CTRL+H 。
3. 在“查找”字段中输入要搜索的测试，然后在“替换”字段中输入新测试。当前文件中所有出现该文本的部分都将高亮显示。
4. 按Crtl+Alt+Enter 。
   提示：

   您还可使用“替换” 或“替换所有” 图标。

在多个文件中查找/替换

如果要在多个文件中查找/替换文本，则只能在外部编辑器中执行此操作。

请按照以下步骤在多个文件中查找/替换文本：

1. 从流程应用程序导出转换。
   备注：

   如果“数据转换”编辑器中有待定更改，请首先使用“应用到仪表板”，并在数据运行完成后导出转换。

2. 解压缩转换文件。
3. 在您喜欢的代码编辑器中打开转换，例如 Notepad++ 或 Visual Studio Code。
4. 使用这些工具的功能查找或替换多个文件中的文本。
5. 保存文件。
6. 将转换文件添加到 .zip 文件。
7. 在流程应用程序中导入转换。
   备注：

   当系统询问将哪些数据用于数据运行时，如果要在执行新的数据运行之前继续编辑转换，请选择“取消” 。

编辑 dbt 项目配置文件

您还可以在“数据转换”编辑器中打开dbt项目配置文件，例如dbt_project.yml 。

警告：

强烈建议仅在需要时编辑 vars 部分。不应更改 dbt_project.yml 的其他部分，以确保转换继续正常工作。

有关dbt的详细信息，请参阅官方 dbt 文档。

在仪表板中提供转换

要使更改在仪表板中可用，您必须执行完整的数据运行以加载数据并运行转换。选择“应用到仪表板”按钮以开始数据运行。

备注：

根据数据集的大小，这需要一些时间。

成功运行数据后，新转换将在仪表板编辑器中可用，并可用于调整仪表板。

备注：

如果您有流程应用程序的已发布版本，则业务用户将立即看到新数据。如果要确保已发布的应用程序在编辑转换时继续正常运行，强烈建议您使用开发应用程序。请执行以下步骤。

1. 克隆您的应用程序以创建开发应用程序。
2. 编辑并测试转换。
3. 从开发应用程序导出转换。
4. 在已发布的流程应用程序中导入转换。