SHOW APPLICATIONS

Lista os objetos de aplicativo para os quais você tem privilégios de acesso em toda a sua conta no Snowflake Native App Framework.

A saída retorna metadados e propriedades para o objeto de aplicativo, ordenados lexicograficamente por nome. Isso é importante se você deseja filtrar os resultados usando os filtros fornecidos.

Consulte também:

ALTER APPLICATION, CREATE APPLICATION, DESCRIBE APPLICATION, DROP APPLICATION

Sintaxe

SHOW APPLICATIONS [ LIKE '<pattern>' ]
  [ STARTS WITH '<name_string>' ]
  [ LIMIT <rows> [ FROM '<name_string>' ] ];
Copy

Parâmetros

LIKE 'pattern'

Opcionalmente, filtra a saída do comando pelo nome do objeto. O filtro utiliza correspondência de padrão que não diferencia maiúsculas e minúsculas, com suporte para caracteres curinga SQL (% e _).

Por exemplo, os seguintes padrões retornam os mesmos resultados:

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...

. padrão: sem valor (nenhuma filtragem é aplicada à saída).

STARTS WITH 'name_string'

Opcionalmente, filtra a saída do comando com base nos caracteres que aparecem no início do nome do objeto. A cadeia de caracteres deve ser delimitada entre aspas simples e há distinção entre maiúsculas e minúsculas.

Por exemplo, as seguintes cadeias de caracteres retornam resultados diferentes:

... STARTS WITH 'B' ...
... STARTS WITH 'b' ...

. Padrão: sem valor (nenhuma filtragem é aplicada à saída)

LIMIT rows [ FROM 'name_string' ]

Opcionalmente, limita o número máximo de linhas retornadas, ao mesmo tempo em que permite a «paginação» dos resultados. O número real de linhas retornadas pode ser menor que o limite especificado. Por exemplo, o número de objetos existentes é menor que o limite especificado.

A subcláusula opcional FROM 'name_string' serve efetivamente como um “cursor” para os resultados. Isso permite obter o número especificado de linhas seguindo a primeira linha cujo nome do objeto corresponde à cadeia de caracteres especificada:

  • A cadeia de caracteres deve ser delimitada entre aspas simples e há distinção entre maiúsculas e minúsculas.

  • A cadeia de caracteres não precisa incluir o nome completo do objeto; também é permitido usar nomes parciais.

Padrão: nenhum valor (nenhum limite é aplicado à saída)

Nota

Para comandos SHOW que oferecem suporte às cláusulas FROM 'name_string' e STARTS WITH 'name_string', você pode combinar ambas as cláusulas na mesma instrução. No entanto, ambas as condições devem ser cumpridas ou elas se cancelam mutuamente e nenhum resultado é retornado.

Além disso, os objetos são devolvidos em ordem lexicográfica por nome, portanto FROM 'name_string' só retorna linhas com um valor lexicográfico maior que as linhas retornadas por STARTS WITH 'name_string'.

Por exemplo:

  • ... STARTS WITH 'A' LIMIT ... FROM 'B' não retornaria nenhum resultado.

  • ... STARTS WITH 'B' LIMIT ... FROM 'A' não retornaria nenhum resultado.

  • ... STARTS WITH 'A' LIMIT ... FROM 'AB' retornariam resultados (se alguma linha corresponder às cadeias de caracteres de entrada).

Saída

A saída do comando fornece propriedades de objeto de aplicativo e metadados nas seguintes colunas:

Coluna

Descrição

created_on

Data e hora em que o objeto de aplicativo foi criado.

name

O nome do objeto de aplicativo.

is_default

Especifica se o objeto do aplicativo está no namespace padrão do usuário.

is_current

Especifica se o objeto de aplicativo está no contexto da sessão atual.

source_type

Especifica a origem do objeto de aplicativo. Os valores válidos são:

  • APPLICATION PACKAGE

  • LISTING

source

O nome do pacote do aplicativo ou listagem usado para criar o objeto de aplicativo.

owner

A função usada para criar o objeto de aplicativo.

comment

Texto que fornece informações sobre o objeto de aplicativo.

version

O identificador de versão usado para criar o objeto de aplicativo.

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 usado para criar o objeto de aplicativo.

options

Para um objeto de aplicativo, esse campo está sempre vazio.

retention_time

O tempo de retenção do objeto de aplicativo.

upgrade_status

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.

Exemplos

SHOW APPLICATIONS;
Copy
+-------------------------------+------------------------+------------+------------+---------------------+----------------------------+---------------+---------+---------------------+-----------------+-------+---------+----------------+
| created_on                    | name                   | is_default | is_current | source_type         | source                     | owner         | comment | version             | label           | patch | options | retention_time |
|-------------------------------+------------------------+------------+------------+---------------------+----------------------------+---------------+---------+---------------------+-----------------+-------+---------+----------------|
| 2023-02-03 10:14:09.828 -0800 | hello_snowflake_app    | N          | Y          | APPLICATION PACKAGE | hello_snowflake_package    | PROVIDER_ROLE |         | v1                  | Version v1      |     0 |         | 1              |
| 2023-03-22 16:12:40.373 -0700 | PRODUCTION_APP         | Y          | Y          | APPLICATION PACKAGE | hello_snowflake_package    | PROVIDER_ROLE |         | v2                  | Version v2      |     0 |         | 1              |
+-------------------------------+------------------------+------------+------------+---------------------+----------------------------+---------------+---------+---------------------+-----------------+-------+---------+----------------+
Linguagem: Português