SHOW APPLICATION ROLES¶

Sintaxe¶

SHOW APPLICATION ROLES IN APPLICATION <name>
  [ LIKE <pattern> ] [ LIMIT <rows> [ FROM '<name_string>' ] ]

Parâmetros obrigatórios¶

name

Especifica o aplicativo cujas funções de aplicativo você deseja exibir.

Parâmetros opcionais¶

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

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

Notas de uso¶

• A saída deste comando exibe SNOWFLAKE na coluna owner.

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

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

Exemplos¶

Para exibir todas as funções do aplicativo em um aplicativo específico:

SHOW APPLICATION ROLES IN APPLICATION hello_snowflake_app;

Para exibir até dez funções de aplicativo no aplicativo nomeado myapp após a primeira função de aplicativo nomeada app_role2:

SHOW APPLICATION ROLES IN APPLICATION myapp LIMIT 10 FROM 'app_role2';