APPLICATION_CONFIGURATION_VALUE_HISTORY¶

提供指定 Snowflake Native App 中应用程序配置的值更改历史记录。

您可以调用此函数来检查应用程序配置的值更改历史记录。有关信息，请参阅应用程序配置。

语法¶

APPLICATION_CONFIGURATION_VALUE_HISTORY(
  [ APPLICATION_NAME => '<application_name>' ]
  [ , CONFIGURATION_NAME => '<config_name>' ]
)

实参¶

必填：

application_name: 配置所在应用程序的名称。

可选：

config_name: 配置的名称。如果未提供，该函数将返回该应用程序中所有配置的历史记录。

返回¶

该函数返回以下列：


列	数据类型	描述
NAME	STRING	配置的名称，由提供商定义。
APPLICATION_NAME	STRING	配置所在应用程序的名称。
CREATED_ON	TIMESTAMP	创建配置对象时的时间戳。
UPDATED_ON	TIMESTAMP	上次更新配置对象时的时间戳。
TYPE	STRING	配置的类型。可能的值是 APPLICATION_NAME 和 STRING。
STATUS	STRING	配置的状态。可能的值是 PENDING 和 DONE。
SENSITIVE	BOOLEAN	该值是否敏感。
VALUE	STRING	使用者设置的值。对于 APPLICATION_NAME 类型的应用程序配置，这是使用者指定的应用程序的最新名称。如果应用程序已重命名，这可能与最初提供的不同。如果应用程序已删除，则此处不会显示任何值，就像未设置该值一样。当 `SENSITIVE=TRUE` 时，该值处于隐藏状态，除非执行角色是拥有配置的应用程序。
VALUE_UPDATED_ON	TIMESTAMP	设置或取消设置值时的上次更新时间戳。
LABEL	STRING	UI 中显示的方便用户记忆的名称，由提供商提供。
DESCRIPTION	STRING	配置的描述。
APPLICATION_ROLES	STRING	有权访问配置的应用程序角色名称，以逗号分隔。这将显示最新的名称，即使角色已重命名也是如此。如果应用程序角色已删除，则输出列表中不会包含该角色。

使用说明¶

该视图仅显示会话的当前角色已被授予访问权限的配置。
该视图不包括已删除的配置。
当调用 Information Schema 表函数时，会话必须具有正在使用的 INFORMATION_SCHEMA 架构，或者函数名称必须受到完全限定。有关更多详细信息，请参阅 Snowflake Information Schema。

示例¶

检索 application_name 应用程序中 config_name 应用程序配置的值更改历史记录：

SELECT * FROM TABLE(information_schema.application_configuration_value_history(application_name => 'my_app', configuration_name => 'my_configuration'));