SHOW APPLICATIONS

列出您在 Snowflake Native App Framework 中对整个账户具有访问权限的应用程序对象。

输出会返回应用程序对象的元数据和属性，根据名称按字典顺序排序。如果您希望使用提供的筛选器筛选结果，请务必注意这一点。

另请参阅：

ALTER APPLICATION、CREATE APPLICATION、DESCRIBE APPLICATION、DROP APPLICATION

语法

SHOW APPLICATIONS [ LIKE '<pattern>' ]
  [ STARTS WITH '<name_string>' ]
  [ LIMIT <rows> [ FROM '<name_string>' ] ];
Copy

参数

LIKE 'pattern'

（可选）按对象名称筛选命令输出。筛选器使用 不区分大小写 的模式匹配，并支持 SQL 通配符（% 和 _）。

例如，以下模式返回 相同的 结果：

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...

. 默认：无值（不对输出应用筛选）。

STARTS WITH 'name_string'

（可选）根据对象名称开头显示的字符筛选命令输出。该字符串必须放在单引号内并且 区分大小写。

例如，以下字符串会返回 不同的 结果：

... STARTS WITH 'B' ...
... STARTS WITH 'b' ...

. 默认：无值（不对输出应用筛选）

LIMIT rows [ FROM 'name_string' ]

（可选）限制返回的最大行数，同时还对结果启用“分页”功能。实际返回的行数可能小于指定的限制。例如，现有对象的数量小于指定的限制。

可选的 FROM 'name_string' 分子句实际上会充当结果的“游标”。这样就可以提取对象名称与指定字符串匹配的第一行之后的指定行数：

  • 该字符串必须放在单引号内并且 区分大小写。

  • 该字符串不必包含完整的对象名称；支持部分名称。

默认：无值（不对输出应用限制）

备注

对于支持 FROM 'name_string' 和 STARTS WITH 'name_string' 子句的 SHOW 命令，您可以将这两个子句组合在同一语句中。但是，两个条件都必须满足，否则它们相互抵消，不返回任何结果。

此外，对象按名称的字典顺序返回，因此 FROM 'name_string' 仅返回字典值高于 STARTS WITH 'name_string' 所返回行的行。

例如：

  • ... STARTS WITH 'A' LIMIT ... FROM 'B' 不会返回任何结果。

  • ... STARTS WITH 'B' LIMIT ... FROM 'A' 不会返回任何结果。

  • ... STARTS WITH 'A' LIMIT ... FROM 'AB' 将返回结果（如果有任何行与输入字符串匹配）。

输出

命令输出在以下列中提供应用程序对象属性和元数据：

列

描述

created_on

创建应用程序对象的日期和时间。

name

应用程序对象的名称。

is_default

指定应用程序对象是否位于用户的默认命名空间中。

is_current

指定应用程序对象是否位于当前会话上下文中。

source_type

指定应用程序对象的源。有效值为：

  • APPLICATION PACKAGE

  • LISTING

source

用于创建应用程序对象的应用程序包或列表的名称。

owner

用于创建应用程序对象的角色。

comment

提供有关应用程序对象的信息的文本。

version

用于创建应用程序对象的版本标识符。

label

应用程序对象的版本标签。此标签在使用者安装 Snowflake Native App 时对其可见。

patch

用于创建应用程序对象的补丁编号。

options

对于应用程序对象，此字段始终为空。

retention_time

应用程序对象的保留时间。

upgrade_state

应用程序对象的后台安装或升级的当前状态。有效值为：

  • INSTALLING：应用程序对象正在创建过程中。

  • INSTALL_FAILED：应用程序对象创建失败。应用程序对象会一直处于 INSTALL_FAILED 状态，直到被删除。有关安装或升级失败的原因的信息，请参阅 DESCRIBE APPLICATION 命令的 UPGRADE_FAILURE_REASON 列。

  • COMPLETE：已成功完成安装脚本，并已创建或升级应用程序对象。

  • QUEUED：应用程序对象处于升级队列中。

  • UPGRADING：应用程序对象正在升级过程中。

  • FAILED：所有升级尝试均失败。如果存在，失败的原因将在 UPGRADE_FAILURE_REASON 列中列出。实例将保持 FAILED 状态，直到版本指令更新为指向与 TARGET_UPGRADE_VERSION 列中定义的升级目标版本不同的版本。

  • QUEUED_RETRY：实例在一次或多次升级尝试中失败。UPGRADE_FAILURE_REASON 中指明了失败的原因：实例排队等待执行另一次升级尝试。

  • DISABLED：应用程序对象及其升级已禁用。在这种状态下，使用者将无法访问该实例，也不会考虑对其进行升级，更不会阻止应用程序包版本的删除。如果存在，失败的原因将在 UPGRADE_FAILURE_REASON 列中列出。

示例

SHOW APPLICATIONS;
Copy
+-------------------------------+------------------------+------------+------------+---------------------+----------------------------+---------------+---------+---------------------+-----------------+-------+---------+----------------+
| created_on                    | name                   | is_default | is_current | source_type         | source                     | owner         | comment | version             | label           | patch | options | retention_time |
|-------------------------------+------------------------+------------+------------+---------------------+----------------------------+---------------+---------+---------------------+-----------------+-------+---------+----------------|
| 2023-02-03 10:14:09.828 -0800 | hello_snowflake_app    | N          | Y          | APPLICATION PACKAGE | hello_snowflake_package    | PROVIDER_ROLE |         | v1                  | Version v1      |     0 |         | 1              |
| 2023-03-22 16:12:40.373 -0700 | PRODUCTION_APP         | Y          | Y          | APPLICATION PACKAGE | hello_snowflake_package    | PROVIDER_ROLE |         | v2                  | Version v2      |     0 |         | 1              |
+-------------------------------+------------------------+------------+------------+---------------------+----------------------------+---------------+---------+---------------------+-----------------+-------+---------+----------------+
语言: 中文