Comandos SHOW: suporte à paginação

Atenção

Essa mudança de comportamento está no pacote 2023_05.

Para saber o status atual do pacote, consulte Histórico do pacote.

Na versão atual, o comportamento desses comandos muda da seguinte forma:

Anteriormente:

Esses comandos não oferecem suporte à limitação da saída de linha ou paginação dos resultados.

Atualmente:

Esses comandos oferecem suporte à paginação da saída usando uma cláusula LIMIT … FROM:

SHOW <domain_plural> [ LIMIT <rows> [ FROM '<name_string>' ] ]
Copy

O comando SHOW GRANTS oferece suporte apenas à cláusula LIMIT. Por exemplo:

SHOW GRANTS [ LIMIT <rows> ]
Copy

Onde:

domain_plural

Use uma das seguintes formas de plural do domínio do objeto:

  • APPLICATION ROLES

  • DATABASE ROLES

  • ROLES

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 inferior ao 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. Além disso, a cadeia de caracteres não tem que incluir o nome completo do objeto; nomes parciais têm suporte.

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

Por exemplo:

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

A instrução retorna até dez funções de aplicativo no aplicativo denominado myapp após a primeira função de aplicativo denominada app_role2.

Ref: 1080