SHOW APPLICATION ROLES¶
Lista todas as funções de aplicativo em um aplicativo específico.
- Consulte também:
ALTER APPLICATION ROLE, CREATE APPLICATION ROLE, GRANT APPLICATION ROLE, REVOKE APPLICATION ROLE
Sintaxe¶
SHOW APPLICATION ROLES IN APPLICATION <name>
[ LIKE <pattern> ] [ LIMIT <rows> [ FROM '<name_string>' ] ]
Parâmetros obrigatórios¶
nameEspecifica o aplicativo cujas funções de aplicativo você deseja visualizar.
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'eSTARTS 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 porSTARTS 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
SNOWFLAKEna colunaowner.
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¶
SHOW APPLICATION ROLES IN APPLICATION hello_snowflake_app;
Retorna até dez funções de aplicativo no aplicativo denominado myapp após a primeira função de aplicativo denominada app_role2:
SHOW APPLICATION ROLES IN APPLICATION myapp LIMIT 10 FROM 'app_role2';