Row operations
使用行操作可以在数据表中删除、获取、插入、更新、upsert 或过滤行。有关节点本身的更多信息,请参阅 Data Table 节点文档。
Delete 删除行#
使用此操作根据定义的条件从数据表中删除一行或多行。
输入以下参数:
- Resource 资源:选择 Row 行。
- Operation 操作:选择 Delete 删除。
- Data table 数据表:选择如何标识要操作的数据表:
- From list 从列表中选择:从所有数据表的下拉列表中选择表。
- By Name 按名称:输入数据表的名称。
- By ID 按 ID:输入数据表的 ID。
- Must Match 必须匹配:选择是删除匹配 Any Condition 任意条件还是 All Conditions 所有条件的行。
- Conditions 条件:点击 Add Condition 添加条件来定义要操作的数据表行。您可以添加多个条件。对于每个条件:
- Column 列:选择要比较的列。
- Condition 条件:选择如何比较列值:Equals 等于、Not Equals 不等于、Greater Than 大于、Greater Than or Equal 大于等于、Less Than 小于、Less Than or Equal 小于等于、Is Empty 为空或 Is Not Empty 不为空。
- Value 值:输入要与列进行比较的值。您可以使用固定值或引用前置节点数据的表达式。Is Empty 为空和 Is Not Empty 不为空条件不存在此字段。
Delete 删除行选项#
使用这些选项进一步调整操作的行为:
- Dry Run 模拟运行:启用后可模拟删除而不修改表。节点会返回将被删除的行,包括操作前后的状态。
Get 获取行#
使用此操作根据定义的条件从数据表中检索一行或多行。
输入以下参数:
- Resource 资源:选择 Row 行。
- Operation 操作:选择 Get 获取。
- Data table 数据表:选择如何标识要操作的数据表:
- From list 从列表中选择:从所有数据表的下拉列表中选择表。
- By Name 按名称:输入数据表的名称。
- By ID 按 ID:输入数据表的 ID。
- Must Match 必须匹配:选择是获取匹配 Any Condition 任意条件还是 All Conditions 所有条件的行。
- Conditions 条件:点击 Add Condition 添加条件来定义要操作的数据表行。您可以添加多个条件。对于每个条件:
- Column 列:选择要比较的列。
- Condition 条件:选择如何比较列值:Equals 等于、Not Equals 不等于、Greater Than 大于、Greater Than or Equal 大于等于、Less Than 小于、Less Than or Equal 小于等于、Is Empty 为空或 Is Not Empty 不为空。
- Value 值:输入要与列进行比较的值。您可以使用固定值或引用前置节点数据的表达式。Is Empty 为空和 Is Not Empty 不为空条件不存在此字段。
- Return All 返回全部:启用后返回所有匹配行。或者禁用并输入 Limit 限制来限制返回的行数,例如
50。 - Order By 排序:启用后可定义用于排序结果的列及方向(升序或降序)。禁用则不对结果排序。
If Row Exists 如果行存在#
使用此操作检查数据表中是否存在匹配定义条件的行。如果找到匹配的行,节点会原样输出它接收到的输入项。如果不存在匹配的行,则不输出任何内容。
输入以下参数:
- Resource 资源:选择 Row 行。
- Operation 操作:选择 If Row Exists 如果行存在。
- Data table 数据表:选择如何标识要操作的数据表:
- From list 从列表中选择:从所有数据表的下拉列表中选择表。
- By Name 按名称:输入数据表的名称。
- By ID 按 ID:输入数据表的 ID。
- Must Match 必须匹配:选择行是否必须匹配 Any Condition 任意条件还是 All Conditions 所有条件。
- Conditions 条件:点击 Add Condition 添加条件来定义要操作的数据表行。您可以添加多个条件。对于每个条件:
- Column 列:选择要比较的列。
- Condition 条件:选择如何比较列值:Equals 等于、Not Equals 不等于、Greater Than 大于、Greater Than or Equal 大于等于、Less Than 小于、Less Than or Equal 小于等于、Is Empty 为空或 Is Not Empty 不为空。
- Value 值:输入要与列进行比较的值。您可以使用固定值或引用前置节点数据的表达式。Is Empty 为空和 Is Not Empty 不为空条件不存在此字段。
If Row Does Not Exist 如果行不存在#
使用此操作检查数据表中是否不存在匹配定义条件的行。如果未找到匹配的行,节点会原样输出它接收到的输入项。如果存在匹配的行,则不输出任何内容。
输入以下参数:
- Resource 资源:选择 Row 行。
- Operation 操作:选择 If Row Does Not Exist 如果行不存在。
- Data table 数据表:选择如何标识要操作的数据表:
- From list 从列表中选择:从所有数据表的下拉列表中选择表。
- By Name 按名称:输入数据表的名称。
- By ID 按 ID:输入数据表的 ID。
- Must Match 必须匹配:选择行是否必须匹配 Any Condition 任意条件还是 All Conditions 所有条件。
- Conditions 条件:点击 Add Condition 添加条件来定义要操作的数据表行。您可以添加多个条件。对于每个条件:
- Column 列:选择要比较的列。
- Condition 条件:选择如何比较列值:Equals 等于、Not Equals 不等于、Greater Than 大于、Greater Than or Equal 大于等于、Less Than 小于、Less Than or Equal 小于等于、Is Empty 为空或 Is Not Empty 不为空。
- Value 值:输入要与列进行比较的值。您可以使用固定值或引用前置节点数据的表达式。Is Empty 为空和 Is Not Empty 不为空条件不存在此字段。
Insert 插入行#
使用此操作向数据表中插入新行。
输入以下参数:
- Resource 资源:选择 Row 行。
- Operation 操作:选择 Insert 插入。
- Data table 数据表:选择如何标识要操作的数据表:
- From list 从列表中选择:从所有数据表的下拉列表中选择表。
- By Name 按名称:输入数据表的名称。
- By ID 按 ID:输入数据表的 ID。
- Mapping Column Mode 列映射模式:选择是否:
- Map Each Column Manually 手动映射每列:明确选择将哪些传入数据字段映射到哪个列。即使传入数据字段名称与数据表列名称不匹配,也可以进行映射。您可以选择从映射中删除某些值。
- Map Automatically 自动映射:允许节点按名称自动匹配数据字段到列。要成功映射,传入数据中的字段名称必须与数据表中的列名称完全匹配。所有字段都将被映射。
Insert 插入行选项#
使用这些选项进一步调整操作的行为:
- Optimize Bulk 优化批量:启用后可阻止返回插入的数据。这可以将批量插入性能提高最多 5 倍。
Update 更新行#
使用此操作根据定义的条件更新数据表中的一行或多行。
输入以下参数:
- Resource 资源:选择 Row 行。
- Operation 操作:选择 Update 更新。
- Data table 数据表:选择如何标识要操作的数据表:
- From list 从列表中选择:从所有数据表的下拉列表中选择表。
- By Name 按名称:输入数据表的名称。
- By ID 按 ID:输入数据表的 ID。
- Must Match 必须匹配:选择是更新匹配 Any Condition 任意条件还是 All Conditions 所有条件的行。
- Conditions 条件:点击 Add Condition 添加条件来定义要操作的数据表行。您可以添加多个条件。对于每个条件:
- Column 列:选择要比较的列。
- Condition 条件:选择如何比较列值:Equals 等于、Not Equals 不等于、Greater Than 大于、Greater Than or Equal 大于等于、Less Than 小于、Less Than or Equal 小于等于、Is Empty 为空或 Is Not Empty 不为空。
- Value 值:输入要与列进行比较的值。您可以使用固定值或引用前置节点数据的表达式。Is Empty 为空和 Is Not Empty 不为空条件不存在此字段。
- Mapping Column Mode 列映射模式:选择是否:
- Map Each Column Manually 手动映射每列:明确选择将哪些传入数据字段映射到哪个列。即使传入数据字段名称与数据表列名称不匹配,也可以进行映射。您可以选择从映射中删除某些值。
- Map Automatically 自动映射:允许节点按名称自动匹配数据字段到列。要成功映射,传入数据中的字段名称必须与数据表中的列名称完全匹配。所有字段都将被映射。
Update 更新行选项#
使用这些选项进一步调整操作的行为:
- Dry Run 模拟运行:启用后可模拟更新而不修改表。节点会返回将被更新的行,包括操作前后的状态。
Upsert 行#
使用此操作对数据表执行 upsert 操作。如果存在匹配定义条件的行,则使用提供的值更新该行。如果不存在匹配的行,则创建新行。
- Resource 资源:选择 Row 行。
- Operation 操作:选择 Upsert。
- Data table 数据表:选择如何标识要操作的数据表:
- From list 从列表中选择:从所有数据表的下拉列表中选择表。
- By Name 按名称:输入数据表的名称。
- By ID 按 ID:输入数据表的 ID。
- Must Match 必须匹配:选择是 upsert 匹配 Any Condition 任意条件还是 All Conditions 所有条件的行。
- Conditions 条件:点击 Add Condition 添加条件来定义要操作的数据表行。您可以添加多个条件。对于每个条件:
- Column 列:选择要比较的列。
- Condition 条件:选择如何比较列值:Equals 等于、Not Equals 不等于、Greater Than 大于、Greater Than or Equal 大于等于、Less Than 小于、Less Than or Equal 小于等于、Is Empty 为空或 Is Not Empty 不为空。
- Value 值:输入要与列进行比较的值。您可以使用固定值或引用前置节点数据的表达式。Is Empty 为空和 Is Not Empty 不为空条件不存在此字段。
- Mapping Column Mode 列映射模式:选择是否:
- Map Each Column Manually 手动映射每列:明确选择将哪些传入数据字段映射到哪个列。即使传入数据字段名称与数据表列名称不匹配,也可以进行映射。您可以选择从映射中删除某些值。
- Map Automatically 自动映射:允许节点按名称自动匹配数据字段到列。要成功映射,传入数据中的字段名称必须与数据表中的列名称完全匹配。所有字段都将被映射。
Upsert 行选项#
使用这些选项进一步调整操作的行为:
- Dry Run 模拟运行:启用后可模拟 upsert 操作而不修改表。节点会返回将受影响的行,包括操作前后的状态。