在 Snowsight 中管理 Snowpipe¶
您可以使用 Snowsight 查看 Snowpipe 详细信息并执行一些管道管理任务。
在图表中可视化暂存区、管道和表，并了解这些对象之间的关系和数据沿袭。
查看任何管道的完整信息，包括已加载（或部分加载）的内容。
检查您的任何管道是否出现故障、停顿或停止从文件加载新数据。
执行一些管道管理任务，例如暂停或恢复管道、删除管道、转移管道所有权以及向管道添加注释。
查看详细状态和复制历史记录。
要求¶
要查看有关管道的详细信息，您必须使用具有管道的 MONITOR 或 OWNERSHIP 权限，以及包含管道的数据库和架构的 USAGE 权限的角色。有关更多信息，请参阅 管道权限。
管道详细信息¶
要在 Snowsight 中查看管道详细信息，请执行以下步骤：
登录 Snowsight。
在导航菜单中，选择 Data » Databases。
找到包含管道的数据库和架构。
选择管道以打开详细信息。
Pipe Details 页面包括有关以下内容的信息：
状态。示例：Running；Paused。
管道中挂起的文件数（如果有）。
最后一次引入的日期（如果适用）。
仓库。（Snowpipe 始终使用 Serverless 计算资源运行。）
传入的 通知通道，用于告诉管道何时有新文件。
图表中暂存区、管道和表之间的关系。
执行的最新副本。
用于创建管道的 SQL 命令 (Pipe Definition)。
管道上授予的 特权。
管理管道¶
您可以从 Pipe Details 页面执行以下任务：
要向管道添加注释，请选择
» Edit。要编辑管道的其他属性，必须使用 CREATE PIPE SQL 命令替换管道。要暂停或恢复管道，请选择
» Pause 或 Resume。要弃用管道，请选择
» Drop。要将管道的所有权转让给另一个角色，请选择
» Transfer Ownership。
有关管理管道的更多信息，请参阅 管理 Snowpipe。
复制历史记录¶
要查看任何管道的复制历史记录，请前往 Pipe Details 页面，然后选择 Copy History 选项卡。
“Copy History”选项卡显示的详细信息包括 STATUS、DURATION、ROWS、SIZE 和 FILE NAME。
直方图最多显示 14 天的加载历史记录，并允许您从以下维度中进行选择：
:ui:`Copies`（默认）：已加载的文件数。显示按状态分组的每日或每小时的文件数，有助于识别失败的加载并监控一段时间内的引入趋势。
Rows：已插入的行数。按天或小时汇总行数，从而深入了解数据吞吐量趋势。
Duration：管道引入持续时间。显示管道引入所花费的时间（按天或小时汇总），该时间代表管道的无服务器计算时间，并作为计算成本的代理指标。
管道指标部分通过以下关键指标帮助分析管道的运行状况和吞吐量：
Success rate：在所选时间范围内成功加载的文件的百分比。
Max ingestion gap：突出显示引入周期之间的巨大差距，从而更容易识别连续引入中的中断。
Time since last ingestion：表示自上次加载文件以来所经过的时间。
Min row count：识别行数少于预期的文件或空文件。
Pending files：显示检测到的尚未加载到表中的文件数。
您还可以选择手动加载尚未加载的文件，方法是在页面右上角的省略号下拉菜单中选择 Manual Refresh 选项。
要搜索单个文件，请使用页面右上角的搜索栏。您可以按文件名、状态或日期进行搜索。