SHOW APPLICATIONS

Lists the Snowflake Native Apps that you have access privileges for across your entire account.

The output returns metadata and properties for the app, ordered lexicographically by name. This is important to note if you want to filter the results using the provided filters.

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

The command output provides app properties and metadata in the following columns:

Coluna

Descrição

created_on

Date and time when the app was created.

name

The name of the app.

is_default

Specifies whether the app is in the default namespace for the user.

is_current

Specifies whether the app is in the current session context.

source_type

Specifies the source of the app. The following values are valid:

  • APPLICATION PACKAGE

  • LISTING

source

The name of the application package or listing used to create the app.

owner

The role used to create the app.

comment

Text that provides information about the app.

version

The version identifier used to create the app.

label

The version label of the app. This label is visible to consumers when they install an app.

patch

The patch number used to create the app.

options

For an app, this field is always empty.

retention_time

The retention time of the app.

upgrade_state

The current state of the background installation or upgrade of the app. The following values are valid:

  • 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.

disablement_reasons

O motivo pelo qual o aplicativo foi desativado. Para obter mais informações, consulte Disabled apps.

last_upgraded_on

The timestamp when the app was last upgraded.

release_channel_name

O nome do canal de lançamento usado para criar o aplicativo. Se o aplicativo não foi criado a partir de um canal de lançamento, o valor dessa propriedade será. default.

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.

    For example, you can use the pipe operator or RESULT_SCAN function to select specific columns from the SHOW command output or filter the rows.

    When you refer to the output columns, use double-quoted identifiers for the column names. For example, to select the output column type, specify SELECT "type".

    You must use double-quoted identifiers because the output column names for SHOW commands are in lowercase. The double quotes ensure that the column names in the SELECT list or WHERE clause match the column names in the SHOW command output that was scanned.

Exemplos

SHOW APPLICATIONS;
Copy
+-------------------------------+------------------------+------------+------------+---------------------+----------------------------+---------------+---------+---------------------+-----------------+-------+---------+----------------+---------------+-----------+
| created_on                    | name                   | is_default | is_current | source_type         | source                     | owner         | comment | version             | label           | patch | options | retention_time | upgrade_state | type      |
|-------------------------------+------------------------+------------+------------+---------------------+----------------------------+---------------+---------+---------------------+-----------------+-------+---------+----------------|---------------+-----------+
| 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              | COMPLETE      | NATIVE    |
| 2023-03-22 16:12:40.373 -0700 | PRODUCTION_APP         | Y          | Y          | APPLICATION PACKAGE | hello_snowflake_package    | PROVIDER_ROLE |         | v2                  | Version v2      |     0 |         | 1              | COMPLETE      | NATIVE    |
+-------------------------------+------------------------+------------+------------+---------------------+----------------------------+---------------+---------+---------------------+-----------------+-------+---------+----------------+---------------+-----------+
Linguagem: Português