Commandes SHOW : prise en charge de la pagination¶
Attention
Ce changement de comportement est présent dans le bundle 2023_05.
Pour connaître le statut actuel du bundle, reportez-vous à Historique du bundle.
Dans la version actuelle, le comportement de ces commandes change comme suit :
- Précédemment:
Ces commandes ne permettent pas de limiter la sortie de lignes ou la pagination des résultats.
- Actuellement:
Ces commandes prennent en charge la pagination de la sortie à l’aide d’une clause LIMIT… FROM :
SHOW <domain_plural> [ LIMIT <rows> [ FROM '<name_string>' ] ]
La commande SHOW GRANTS ne prend en charge que la clause LIMIT. Par exemple :
SHOW GRANTS [ LIMIT <rows> ]
Où :
domain_plural
Utilisez l’une des formes plurielles suivantes du domaine de l’objet :
APPLICATION ROLES
DATABASE ROLES
ROLES
LIMIT rows [ FROM 'name_string' ]
(Facultatif) Limite le nombre maximum de lignes retournées, tout en permettant la « pagination » des résultats. Le nombre réel de lignes retournées pourrait être inférieur à la limite spécifiée (par exemple, le nombre d’objets existants est inférieur à la limite spécifiée).
La sous-clause facultative
FROM 'name_string'
sert effectivement de « curseur » pour les résultats. Ceci permet de récupérer le nombre spécifié de lignes suivant la première ligne dont le nom d’objet correspond à la chaîne spécifiée :La chaîne doit être délimitée par des guillemets simples et est sensible à la casse. De plus, la chaîne n’a pas besoin d’inclure le nom complet de l’objet ; les noms partiels sont pris en charge.
Par défaut : aucune valeur (aucune limite n’est appliquée à la sortie).
Par exemple :
SHOW APPLICATION ROLES IN APPLICATION myapp LIMIT 10 FROM 'app_role2';
L’instruction renvoie jusqu’à dix rôles d’application dans l’application nommée
myapp
après le premier rôle d’application nomméapp_role2
.
Réf : 1080