SYSTEM$REPORT_HEALTH_STATUS¶

语法¶

SYSTEM$REPORT_HEALTH_STATUS( '<status>' )

实参¶

'status'

VARCHAR 类型的字符串字面量可指示应用程序的运行状况。您可以指定以下值中的一个：

• 'OK'：选择使用 时默认使用的角色和仓库。使用者实例运行正常。

• 'FAILED'：选择使用 时默认使用的角色和仓库。使用者实例处于错误状态。

• 'PAUSED'：选择使用 时默认使用的角色和仓库。使用者手动暂停了该应用程序。

使用说明¶

• 此函数旨在由使用者应用程序调用。应用程序应定期调用此函数，以向提供商账户报告其运行状况。

• 应用程序逻辑会根据其自身的监控和错误处理来确定要报告的运行状况。

• 提供商账户可以通过 GET_HEALTH_STATUS 函数查看此函数所报告的运行状况。您应定期从提供商账户调用 GET_HEALTH_STATUS，以监控使用者实例的运行状况。如果使用任务或受监控的任务来调用此函数，请确保应用程序具有运行该任务的正确权限。建议设置警报，以便在使用者实例报告 FAILED 状态、PAUSED 状态或停止报告其状态时通知您。

• Snowflake 仅保留应用程序的每个使用者实例报告的最新运行状况。

• 为避免 Snowflake 负载过重，此函数会受到速率限制。如果同一使用者实例在 55 分钟内再次调用该函数，它将返回 false，表示状态报告未被接受。

• 有关从提供商端监控应用程序运行状况的更多信息，请参阅 对应用程序使用监控。

返回值¶

• 如果运行状态报告成功，此函数返回 TRUE。

• 如果状态报告由于速率限制而失败，此函数返回 FALSE。