跳至主要内容

创建数据集节点

Create Dataset Node Screenshot

概述​

创建数据集节点用于创建一个具有指定ID和名称的新数据集。如果已存在具有指定ID的数据集，该节点不会执行任何操作。当您想要创建一个新数据集用于存储或处理数据时，此节点特别有用。

多个数据集可以拥有相同的名称，但ID在所有数据集中是唯一的。ID用于在加载、追加或删除数据时识别数据集。如果未提供Dataset ID输入，节点将自动为数据集生成一个ID。

如果未提供Dataset Name输入，节点将使用Dataset ID作为名称。

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

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

输入项​

标题数据类型描述默认值备注
Dataset IDstringThe ID of the dataset to be created.(automatically generated)The input will be coerced into a string if it is not a string.
Dataset NamestringThe name of the dataset to be created. If not provided, the Dataset ID will be used as the name.(dataset ID)The input will be coerced into a string if it is not a string.

示例1：创建一个新数据集​

  1. 创建一个Text Node并将文本设置为employees。
  2. 创建另一个文本节点并将文本设置为Employees。
  3. 创建一个Create Dataset节点，将第一个Text节点连接到Dataset ID输入，第二个Text节点连接到Dataset Name输入。
  4. 运行图表。Create Dataset节点的Dataset ID输出应包含新创建数据集的ID。

Create Dataset Node Example 1

错误处理​

如果在运行图表时上下文环境中数据集提供程序不可用，创建数据集节点将会报错。如果未提供Dataset ID输入参数，同样会报错。

常见问题​

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

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

问：我可以一次性创建多个数据集吗？

A: 不，Create Dataset Node 一次只能创建一个数据集。如果您想创建多个数据集，可以使用多个 Create Dataset Node。

问：如果数据集已存在会怎样？

A: 如果数据集已存在，Create Dataset节点将不会执行任何操作，图表将继续运行。该数据集的ID将从节点输出。这对于确保在加载或追加数据之前数据集已存在非常有用。

另请参阅​