跳至主要内容

获取数据集行节点

Get Dataset Row Node Screenshot

概述​

Get Dataset Row节点允许您通过提供数据集ID和行ID来从数据集中检索特定行。当您希望通过ID访问和处理数据集中的特定数据行时，此节点特别有用。

节点在运行图时需要上下文中有一个可用的数据集提供者。数据集提供者负责管理数据集的存储和检索。在Rivet应用程序中，数据集提供者会自动为您处理。

有关数据集的更多信息，请参阅用户指南中的Data Studio部分。

输入项​

标题数据类型描述默认值备注
Row IDstringThe ID of the row to retrieve.(required if if the input toggle for Row ID is enabled)The input will be coerced into a string if it is not a string.
Dataset IDstringThe ID of the dataset to retrieve the row from. This input is only available if Use Dataset ID Input is enabled.(required if if the input toggle for Dataset ID is enabled)The input will be coerced into a string if it is not a string.

示例1：从数据集中检索一行​

  1. 在Data Studio中，创建一个名为Employees的新数据集并添加几行数据。
  2. 创建一个Get Dataset Row节点，将Dataset设置为Employees，并将Row ID设置为您添加到数据集中的某行的ID。您可以在Data Studio中第一列看到这些ID。
  3. 运行图表。Get Dataset Row节点的Row输出应包含您指定的行数据。

Get Dataset Row Node Example 1

示例2：从数据集中检索动态行​

  1. 在Data Studio中，创建一个名为Employees的新数据集并添加几行数据。
  2. 创建一个获取数据集行节点，将数据集设置为Employees并启用行ID的输入切换。
  3. 创建一个文本节点并将文本设置为您添加到数据集中的某一行ID。将文本节点连接到获取数据集行节点的行ID输入。
  4. 运行图表。Get Dataset Row节点的Row输出应包含您指定的行数据。

Get Dataset Row Node Example 2

错误处理​

如果在运行图表时上下文环境中数据集提供程序不可用，Get Dataset Row节点将会报错。如果未提供数据集ID或行ID，它也会报错。如果指定的行在数据集中不存在，则不会运行Row输出。

常见问题​

问：什么是数据集提供者？

A: 数据集提供者是一个负责管理数据集存储和检索的对象。当图表运行时，它会被传递给上下文。数据集提供者必须实现DatasetProvider接口，该接口包含获取、存放和删除数据集的方法。更多信息请参阅API参考文档。

问：我可以一次性检索多行数据吗？

A: 不，Get Dataset Row节点每次只能检索一行数据。如果您需要检索多行数据，可以使用多个Get Dataset Row节点，或者考虑拆分Get Dataset Row节点。

问：如果该行不存在会发生什么？

A: 如果该行不存在，则不会运行Row输出。不会抛出错误。您可以使用If Node来检查是否运行了Row输出。

另请参阅​