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 colocada entre aspas simples e faz distinção entre letras 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 colocada entre aspas simples e faz distinção entre letras 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_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. 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.

Notas de uso

  • O comando não precisa de um warehouse em funcionamento para ser executado.

  • O comando retorna apenas objetos para os quais a função atual do usuário atual recebeu pelo menos um privilégio de acesso.

  • O privilégio de acesso MANAGE GRANTS permite implicitamente que seu titular consulte todos os objetos da conta. Por padrão, somente o administrador de conta (usuários com a função ACCOUNTADMIN) e o administrador de segurança (usuários com a função SECURITYADMIN) têm o privilégio MANAGE GRANTS.

  • 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

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