Skip to content

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 操作而不修改表。节点会返回将受影响的行,包括操作前后的状态。