Reset stream（重置数据流(Reset stream)）

Resetting an ingest stream clears the existing records from a stream and provides an opportunity to change the stream's schema, throughput, and configuration values. This can be helpful during stream pipeline development since you can clear and update an ingest stream without replacing existing references of the stream within your Pipeline Builder pipelines.

Note that resets are only available for ingest streams. Downstream consuming pipelines of the ingest stream must be replayed after a reset.

• Push-based ingestion requires updating the POST URL to reference the new stream viewRid value.
• Magritte-based ingestion requires an agent rebuild.

:::callout{theme="danger"} Resetting streams can have irreversible effects on data. We do not recommend resetting production ingest streams because existing records will be lost. :::

To reset a stream, follow the instructions below:

1. Open an ingest stream.
2. Select the Details tab.
3. In the Stream Settings section, select Reset stream.

1. You will be redirected to the stream reset page. On this page, you can optionally update the schema, throughput, or configuration values. If you only want to clear data from the stream, leave those sections unchanged.

1. Select Reset stream to initiate the stream reset.

---

中文翻译

重置数据流(Reset stream)

重置数据流会清除数据流中的现有记录，并允许您更改数据流的模式(Schema)、吞吐量(Throughput)和配置值。这在数据流管道开发过程中非常有用，因为您可以清除和更新数据流，而无需替换管道构建器(Pipeline Builder)管道中该数据流的现有引用。

请注意，重置仅适用于数据摄取流(Ingest stream)。重置后，必须重放数据摄取流的下游消费管道。

• 基于推送的数据摄取(Push-based ingestion)需要更新POST URL，以引用新的数据流viewRid值。
• 基于Magritte的数据摄取(Magritte-based ingestion)需要重建代理(Agent)。

:::callout{theme="danger"} 重置数据流可能对数据造成不可逆的影响。我们不建议重置生产环境中的数据摄取流，因为现有记录将会丢失。 :::

要重置数据流，请按照以下步骤操作：

1. 打开一个数据摄取流。
2. 选择详情(Details)选项卡。
3. 在数据流设置(Stream Settings)部分，选择重置数据流(Reset stream)。

1. 您将被重定向到数据流重置页面。在此页面上，您可以选择更新模式(Schema)、吞吐量(Throughput)或配置值。如果只想清除数据流中的数据，请保持这些部分不变。

1. 选择重置数据流(Reset stream)以启动数据流重置。