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.
`restricted_callers_rights`	Indica que os direitos restritos do chamador foram ativados para o aplicativo. Consulte Conceder direitos do chamador restritos a um executável em um aplicativo para obter mais informações.
`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.
`metric_level`	O nível de métrica definido pelo provedor no arquivo de manifesto.
`auditlog_level`	O nível de log de auditoria 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 atual configurado para o aplicativo.
`effective_metric_level`	O nível de métrica atual configurado para o aplicativo.
`effective_auditlog_level`	O nível de log de auditoria atual configurado para o aplicativo.
`debug_mode`	Indica se o aplicativo foi criado usando o modo de depuração.
`disable_application_redaction`	Indica se a edição de dados do provedor foi desativada.
`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.
`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_in_maintenance_window`	Se for `TRUE`, indica que o provedor agendou a atualização do aplicativo durante uma janela de manutenção Snowpark Container Services. Este recurso está atualmente em versão preliminar.
`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.
`disablement_reasons`	Uma matriz contendo os motivos pelos quais o aplicativo foi desativado. Para obter mais informações, consulte Motivos pelos quais um aplicativo pode ser desativado.
`release_channel_name`	O tipo de canal de lançamento. Os valores válidos são `QA`, `ALPHA`, `DEFAULT`. Para obter mais informações, consulte Publicar um aplicativo usando canais de lançamento.

Notas de uso¶

Para pós-processar a saída deste comando, você pode usar o operador de canal (->>) ou a função RESULT_SCAN. Ambos os constructos tratam a saída como um conjunto de resultados que você pode consultar.

Os nomes das colunas de saída para este comando são gerados em minúsculas. Se você consumir um conjunto de resultados deste comando com o operador de canal ou a função RESULT_SCAN, use identificadores entre aspas duplas para os nomes das colunas na consulta para garantir que eles correspondam aos nomes das colunas na saída que foi verificada. Por exemplo, se o nome de uma coluna de saída for type, especifique "type" para o identificador.

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