DESCRIBE APPLICATION¶

Exibe informações sobre um objeto de aplicativo criado usando Snowflake Native App Framework.

DESCRIBE pode ser abreviado como DESC.

Consulte também:: ALTER APPLICATION PACKAGE, CREATE APPLICATION PACKAGE, DROP APPLICATION PACKAGE, SHOW APPLICATION PACKAGES,

Sintaxe¶

DESC[RIBE] APPLICATION <name>

Copy

Parâmetros¶

name: Especifica o identificador do aplicativo a ser descrito.

Saída¶

O comando fornece propriedades de um objeto de aplicativo nas seguintes colunas:

Coluna	Descrição
`property`	O nome da propriedade do objeto de aplicativo. Esta coluna pode incluir as propriedades listadas na tabela a seguir.
`value`	O valor atribuído à propriedade do objeto de aplicativo.

A coluna property pode incluir as seguintes propriedades de um objeto de aplicativo:

Propriedade	Descrição
`name`	O nome do objeto de aplicativo.
`source_organization`	O nome da organização da conta que contém o pacote de aplicativo usado para criar o objeto de aplicativo.
`source_account`	A conta do pacote de aplicativo usada para criar o objeto de aplicativo.
`source_type`	A fonte usada para criar o aplicativo. Os valores válidos são `APP_PACKAGE` e `LISTING`.
`source`	O nome do pacote do aplicativo ou listagem usado para criar o objeto de aplicativo.
`version`	O identificador de versão do objeto de aplicativo.
`version_label`	O rótulo da versão do objeto de aplicativo. Este rótulo fica visível para o consumidor quando ele instala um Snowflake Native App.
`patch`	O número do patch do objeto de aplicativo.
`created_on`	O carimbo de data/hora em que o objeto de aplicativo foi criado.
`last_upgraded_on`	O carimbo de data/hora da última atualização do objeto de aplicativo.
`share_events_with_provider`	Indica se o registro em log e compartilhamento de eventos está habilitado para o objeto de aplicativo.
`log_level`	O nível de log definido para o objeto de aplicativo.
`trace_level`	O nível de rastreamento definido para o objeto de aplicativo.
`debug_mode`	Indica se o aplicativo foi criado usando o modo de depuração.
`upgrade_state`	O estado atual da instalação ou atualização em segundo plano do objeto de aplicativo. Os valores válidos são: `INSTALLING`: o objeto do aplicativo está em processo de criação. `INSTALL_FAILED`: a criação do objeto de aplicativo falhou. O objeto do aplicativo permanece no estado `INSTALL_FAILED` até ser descartado. O motivo da falha está listado na coluna `UPGRADE_FAILURE_REASON`, se houver. `COMPLETE`: o script de configuração foi concluído com êxito e o objeto do aplicativo foi criado ou atualizado. `QUEUED`: o objeto do aplicativo está na fila para atualização. `UPGRADING`: o objeto do aplicativo está em processo de atualização. `FAILED`: todas as tentativas de atualização falharam. O motivo da falha está listado na coluna `UPGRADE_FAILURE_REASON`, se presente. A instância permanece no estado `FAILED` até que uma diretriz de versão seja atualizada para apontar para uma versão diferente daquela para a qual a atualização foi direcionada, conforme definido em TARGET_UPGRADE_VERSION. `QUEUED_RETRY`: a instância falhou em uma ou mais tentativas de atualização. O motivo da falha é indicado em `UPGRADE_FAILURE_REASON`: a instância está na fila para realizar outra tentativa de atualização. `DISABLED`: o objeto do aplicativo e suas atualizações foram desativados. Nesse estado, a instância ficará inacessível para os consumidores, não será considerada para atualizações e não bloqueará a queda da versão do pacote de aplicativos. O motivo da falha está listado na coluna `UPGRADE_FAILURE_REASON`, se houver.
`upgrade_target_version`	O identificador de versão para o qual o objeto de aplicativo está sendo atualizado.
`upgrade_target_patch`	O patch para o qual o objeto de aplicativo está sendo atualizado.
`upgrade_attempt`	Indica se houve uma tentativa de atualização para o objeto de aplicativo.
`upgrade_task_id`	O identificador de tarefa interno para a tentativa de atualização.
`upgrade_started_on`	O carimbo de data/hora de quando a atualização foi iniciada.
`upgrade_attempted_on`	O carimbo de data/hora em que o objeto de aplicativo foi atualizado pela última vez.
`upgrade_failure_reason`	A razão pela qual a atualização falhou, se aplicável.
`previous_version`	O identificador da versão anterior do objeto de aplicativo.
`previous_patch`	O número do patch anterior do objeto de aplicativo instalado.
`previous_version_state`	O estado da versão anterior do objeto de aplicativo.

Notas de uso¶

Para pós-processar a saída deste comando, você pode usar a função RESULT_SCAN, que trata a saída como uma tabela que pode ser consultada.

Exemplos¶

Descreve as propriedades de um objeto de aplicativo:

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                 | 2023-05-25 08:30:41.520 -0700 |
| last_upgraded_on           |                               |
| share_events_with_provider | 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_reason     | NULL                          |
| previous_version           | NULL                          |
| previous_patch             | 0                             |
| previous_version_state     | COMPLETE                      |
+----------------------------+-------------------------------+