DESCRIBE APPLICATION¶

Exibe informações sobre um Snowflake Native App.

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 exibe as propriedades de um aplicativo nas seguintes colunas:

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

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

Propriedade	Descrição
`name`	O nome do aplicativo.
`source_organization`	O nome da organização da conta que contém o pacote de aplicativo usado para criar o aplicativo.
`source_account`	A conta do pacote de aplicativo usado para criar o 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 de aplicativo ou da listagem usada para criar o aplicativo.
`version`	O identificador de versão do aplicativo.
`version_label`	O rótulo da versão do aplicativo. Este rótulo fica visível para o consumidor quando ele instala um Snowflake Native App.
`patch`	O número do patch do aplicativo.
`created_on`	O carimbo de data/hora em que o aplicativo foi criado.
`last_upgraded_on`	O carimbo de data/hora da última atualização do aplicativo.
`share_events_with_provider`	Indica se o registro em log e o compartilhamento de eventos estão ativados para o aplicativo.
`authorize_telemetry_event_sharing`	O status do sinalizador `AUTHORIZE_TELEMETRY_EVENT_SHARING`.
`log_level`	O nível de log definido pelo provedor no arquivo de manifesto.
`trace_level`	O nível de rastreamento definido pelo provedor no arquivo de manifesto.
`effective_log_level`	O nível de log habilitado para o aplicativo.
`effective_trace_level`	O nível de rastreamento habilitado para o aplicativo.
`debug_mode`	Indica se o aplicativo foi criado usando o modo de depuração.
`upgrade_after`	Indica que o provedor programou um upgrade para começar nesse momento. No entanto, o aplicativo pode ser atualizado antes dessa data e hora. Para obter mais informações, consulte Atualização manual de um aplicativo.
`upgrade_state`	O estado atual da instalação em segundo plano ou da atualização do 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. Veja a coluna `UPGRADE_FAILURE_REASON` do comando DESCRIBE APPLICATION para obter informações sobre o motivo da falha na instalação ou atualização. `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 houver. 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 na coluna `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 da versão para a qual o aplicativo está sendo atualizado.
`upgrade_target_patch`	O patch para o qual o aplicativo está sendo atualizado.
`upgrade_attempt`	Indica se foi tentada uma atualização para o 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 da última instalação do aplicativo ou da nova tentativa.
`upgrade_failure_type`	O motivo de uma falha na atualização. Os valores possíveis são: `VERSION_SETUP`: indica que ocorreu um erro ao executar o script de configuração do aplicativo. Isso pode ocorrer se o script de instalação contiver um erro de sintaxe, estiver vazio etc. Quando esse erro ocorre, uma notificação por e-mail é enviada ao provedor. `INTERNAL`: indica um erro interno do Snowflake, por exemplo, se um objeto necessário não responde ou não pode ser encontrado.
`upgrade_failure_reason`	A razão pela qual a atualização falhou, se aplicável.
`previous_version`	O identificador da versão anterior do aplicativo.
`previous_patch`	O número do patch anterior do aplicativo instalado.
`previous_version_state`	O estado da versão anterior do aplicativo.
`comment`	Texto que fornece informações sobre o 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. Você também pode usar o operador de canal para consultar a saída desse comando.

Exemplos¶

Descrever as propriedades de um 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                         | 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                            |                               |
+------------------------------------+-------------------------------+