DESCRIBE APPLICATION¶

显示有关 Snowflake Native App 的信息。

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`	应用程序上次升级的时间戳。
`restricted_callers_rights`	表示已为该应用程序启用了受限呼叫者权限。有关更多信息，请参阅将受限调用方权限授予应用程序中的可执行文件：。
`share_events_with_provider`	指示是否为应用程序启用日志记录和事件共享。
`authorize_telemetry_event_sharing`	`AUTHORIZE_TELEMETRY_EVENT_SHARING` 标志的状态。
`log_level`	提供商在清单文件中定义的日志级别。
`trace_level`	提供商在清单文件中定义的跟踪级别。
`metric_level`	提供商在清单文件中定义的指标级别。
`auditlog_level`	提供商在清单文件中定义的审计日志级别。
`effective_log_level`	为应用程序程序启用的日志级别。
`effective_trace_level`	为应用程序启用的当前跟踪级别。
`effective_metric_level`	为应用程序启用的当前指标级别。
`effective_auditlog_level`	为应用程序启用的当前审计日志级别。
`debug_mode`	指示应用程序是否是使用调试模式创建的。
`disable_application_redaction`	表示是否已禁用提供商数据的编辑。
`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`	升级失败的原因（如果适用）。
`upgrade_after`	表示提供商已安排在此时开始升级。但应用程序可能会在此日期和时间之前升级。有关更多信息，请参阅手动升级应用程序。
`upgrade_in_maintenance_window`	如果为 `TRUE`，表示提供商已计划在 Snowpark Container Services 维护时段内升级应用程序。此功能目前处于预览阶段。
`previous_version`	应用程序先前版本的标识符。
`previous_patch`	已安装应用程序的上一个补丁号。
`previous_version_state`	应用程序先前版本的状态。
`comment`	提供有关应用程序的信息的文本。
`disablement_reasons`	一个包含禁用应用程序原因的数组。有关更多信息，请参阅可能会禁用应用程序的原因。
`release_channel_name`	版本频道的类型。有效值为 `QA`、`ALPHA`、`DEFAULT`。有关更多信息，请参阅使用版本渠道发布应用程序。

使用说明¶

To post-process the output of this command, you can use the pipe operator (->>) or the RESULT_SCAN function. Both constructs treat the output as a result set that you can query.

此命令的输出列名称以小写形式生成。如果您通过管道运算符或 RESULT_SCAN 函数使用此命令的结果集，请在查询中对列名使用加双引号的标识符，以确保它们与已扫描输出中的列名相匹配。例如，如果输出列的名称为 type，则为标识符指定 "type"。

示例¶

描述应用程序的属性：

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                            |                               |
+------------------------------------+-------------------------------+