DESCRIBE APPLICATION¶

显示有关应用程序对象的信息。

DESCRIBE 可以缩写为 DESC。

另请参阅：: ALTER APPLICATION PACKAGE、CREATE APPLICATION PACKAGE、DROP APPLICATION PACKAGE、SHOW APPLICATION PACKAGES，

语法¶

DESC[RIBE] APPLICATION <name>

Copy

参数¶

name: 指定要描述的应用程序对象的标识符。

输出¶

该命令在以下列中显示应用程序对象的属性：

列	描述
`property`	应用程序对象的属性的名称。此列可以包含下表中列出的属性。
`value`	分配给应用程序对象属性的值。

property 列可以包含应用程序对象的以下属性：

属性	描述
`name`	应用程序对象的名称。
`source_organization`	包含用于创建应用程序对象的应用程序包的账户的组织名称。
`source_account`	用于创建应用程序对象的应用程序包的账户。
`source_type`	用于创建应用程序的源。有效值为 `APP_PACKAGE` 和 `LISTING`。
`source`	用于创建应用程序对象的应用程序包或列表的名称。
`version`	应用程序对象的版本标识符。
`version_label`	应用程序对象的版本标签。此标签在使用者安装 Snowflake Native App 时对其可见。
`patch`	应用程序对象的补丁号。
`created_on`	应用程序对象的创建时间戳。
`last_upgraded_on`	应用程序对象的上次升级时间戳。
`share_events_with_provider`	指示是否为应用程序对象启用日志记录和事件共享。
`authorize_telemetry_event_sharing`	`AUTHORIZE_TELEMETRY_EVENT_SHARING` 标志的状态。
`log_level`	提供商在清单文件中定义的日志级别。
`trace_level`	提供商在清单文件中定义的跟踪级别。
`effective_log_level`	为应用程序程序启用的日志级别。
`effective_trace_level`	为应用程序程序启用的跟踪级别。
`debug_mode`	指示应用程序是否是使用调试模式创建的。
`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` 列中列出。
`upgrade_target_version`	应用程序对象要升级到的版本标识符。
`upgrade_target_patch`	应用程序对象正在升级到的补丁。
`upgrade_attempt`	指示是否尝试升级应用程序对象。
`upgrade_task_id`	升级尝试的内部任务标识符。
`upgrade_started_on`	启动升级时的时间戳。
`upgrade_attempted_on`	上次应用程序安装或重试尝试的时间戳。
`upgrade_failure_type`	升级失败的原因。可能的值： `VERSION_SETUP`：表示运行应用程序的安装脚本时发生错误。如果安装脚本包含语法错误、为空等，则可能会发生这种情况。发生此错误时，将向提供商发送电子邮件通知。 `INTERNAL`：表示内部 Snowflake 错误，例如，如果所需对象没有响应或找不到。
`upgrade_failure_reason`	升级失败的原因（如果适用）。
`previous_version`	应用程序对象先前版本的标识符。
`previous_patch`	已安装应用程序对象的上一个补丁的编号。
`previous_version_state`	应用程序对象先前版本的状态。
`comment`	提供有关应用程序对象的信息的文本。

使用说明¶

若要对此命令的输出进行后处理，可以使用 RESULT_SCAN 函数，该函数会将输出视为可查询的表。

示例¶

描述应用程序对象的属性：

DESC APPLICATION hello_snowflake_app;

Copy

+------------------------------------+-------------------------------+
| property                           | value                         |
|------------------------------------+-------------------------------|
| name                               | hello_snowflake_app           |
| source_organization                | my_organization               |
| source_account                     | provider_account              |
| source_type                        | APPLICATION PACKAGE           |
| source                             | hello_snowflake_package       |
| version                            | v1_0                          |
| version_label                      | NULL                          |
| patch                              | 0                             |
| created_on                         | 2024-05-25 08:30:41.520 -0700 |
| last_upgraded_on                   |                               |
| share_events_with_provider         | FALSE                         |
| authorize_telemetry_event_sharing  | FALSE                         |
| log_level                          | OFF                           |
| trace_level                        | OFF                           |
| debug_mode                         | FALSE                         |
| upgrade_state                      | COMPLETE                      |
| upgrade_target_version             | NULL                          |
| upgrade_target_patch               | 0                             |
| upgrade_attempt                    | NULL                          |
| upgrade_task_id                    | NULL                          |
| upgrade_started_on                 |                               |
| upgrade_attempted_on               |                               |
| upgrade_failure_type               | NULL                          |
| upgrade_failure_reason             | NULL                          |
| previous_version                   | NULL                          |
| previous_patch                     | 0                             |
| previous_version_state             | COMPLETE                      |
| comment                            |                               |
+------------------------------------+-------------------------------+