Editing data transformations

查看和编辑文件

SQL 文件和输入文件显示在选项卡中。当您打开 SQL 文件或输入文件时，系统将在“数据转换”编辑器中打开一个新选项卡。这使您能够同时打开和使用多个文件。如果 SQL 文件中有任何未保存的更改，则会在选项卡中以蓝点表示。

提示：

您可以在已固定的选项卡中打开文件。这使您可以快速访问文件，而无需反复重新打开它们。固定文件后，即使您打开其他文件，该文件在编辑器中仍可见。您可以双击文件，或从选项卡上下文菜单中选择“固定”以固定选项卡。

备注：

如果当前打开的 SQL 文件中有任何未保存的更改，则打开新文件时，这些更改将保留在其自己的选项卡中。如果没有未保存的更改，则会在当前显示的选项卡中打开新的 SQL 文件。

关闭文件

您可以快速关闭当前选项卡、所有选项卡或选项卡上下文菜单中的所有其他选项卡。

右键单击选项卡名称以打开选项卡上下文菜单。

运行查询

备注：

“全部运行”和“运行文件”限制为一小时。因此，强烈建议使用小型数据集开发和测试数据转换，以确保您的转换不会超过此时间限制。有关更多信息，请参阅“Process Mining 门户” 。

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

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

有两种类型的运行：

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

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

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

备注：

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

查看已编译的 SQL

在运行查询后，您可以通过启用“已编译的 SQL”切换选项来查看 SQL 代码的已编译版本。这在调试 SQL 错误时非常有用，因为报告的行号与已编译的 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 文件，您可以重用查询并进行修改，而无需创建全新的文件。它还可以帮助您对查询进行修改，而不会更改或损坏原始查询。

复制文件后，系统会在同一文件夹中该复制文件的正下方创建原始文件的副本。

请按照以下步骤复制 SQL 文件。

步骤	操作
1	打开“更多操作”单击要复制的文件的菜单，以打开其上下文菜单
2	选择“复制” 。系统会将重复的文件插入到与原始文件相同的位置。

复制并粘贴文件

您可以复制 SQL 文件，并将其粘贴到其他位置。通过复制和粘贴 SQL 文件，您可以重用查询并对查询进行修改，而无需创建全新的文件。

请按照以下步骤复制并粘贴 SQL 文件。

步骤	操作
1	打开“更多操作”菜单，以打开菜单。
2	选择“复制” 。
3	打开“更多操作”菜单从菜单中选择“粘贴” 。系统即会插入复制的文件。
4	拖放文件以将其移动到所需位置。

在文件中查找/替换

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

查找文本

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

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. 在流程应用程序中导入转换。
   备注：

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

在文件中添加注释

如果要在 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", #}

编辑 dbt 项目配置文件

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

警告：

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

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