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.

The output column names for this command are generated in lowercase. If you consume a result set from this command with the pipe operator or the RESULT_SCAN function, use double-quoted identifiers for the column names in the query to ensure that they match the column names in the output that was scanned. For example, if the name of an output column is type, then specify "type" for the identifier.

示例¶

描述应用程序的属性：

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