Editing data transformations

查看和编辑文件

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

提示：

您可以在已固定的选项卡中打开文件。这使您可以快速访问文件，而无需反复重新打开它们。固定文件后，即使您打开其他文件，该文件也会在编辑器中可见。

您可以双击文件，或从选项卡上下文菜单中选择“固定”以固定选项卡。

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

关闭文件

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

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

运行查询

注意：

Run all and Run file are limited to one hour. Therefore, it is strongly recommended to use a small dataset for the development and testing of data transformations, to make sure your transformations do not exceed this time limit. Refer to Process Mining portal for more information.

编辑转换时，您可以选择“运行全部”以测试更改并查看预览。 它运行修改后的查询和所有相关查询。 例如，如果已修改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 文档。