SHOW USERS

Liste tous les utilisateurs du système.

Voir aussi :

CREATE USER , ALTER USER , DROP USER , DESCRIBE USER

Syntaxe

SHOW [ TERSE ] USERS
[ LIKE '<pattern>' ]
[ STARTS WITH '<name_string>' ]
[ LIMIT <rows> ]
[ FROM '<name_string>' ]
Copy

Paramètres

TERSE

(Facultatif) Retourne seulement un sous-ensemble des colonnes de sortie :

| name | created_on | display_name | first_name | last_name | email | org_identity | comment | has_password | has_rsa_public_key |
Copy

Par défaut : aucune valeur (toutes les colonnes sont incluses dans la sortie).

LIKE 'pattern'

Filtre la sortie de commande par nom d’objet. Le filtre utilise une concordance de motif insensible à la casse avec prise en charge des caractères génériques SQL (% et _).

Par exemple, les motifs suivants donnent les mêmes résultats :

  • ... LIKE '%testing%' ...

  • ... LIKE '%TESTING%' ...

STARTS WITH 'name_string'

(Facultatif) Filtre la sortie de commande en fonction des caractères qui apparaissent au début du nom de l’objet. La chaîne doit être délimitée par des guillemets simples et est sensible à la casse.

Par exemple, les clauses suivantes renvoient des résultats différents :

  • ... STARTS WITH 'B' ...

  • ... STARTS WITH 'b' ...

Par défaut : aucune valeur (aucun filtrage n’est appliqué à la sortie).

LIMIT rows [ FROM 'name_string' ]

(Facultatif) Limite le nombre maximum de lignes retournées, tout en permettant la « pagination » des résultats. Notez que 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.

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

Note

Les deux FROM 'name_string' et STARTS WITH 'name_string' peuvent être combinés dans la même instruction ; cependant, les deux conditions doivent être remplies ou elles s’annulent mutuellement et aucun résultat n’est retourné.

De plus, les objets sont retournés dans l’ordre lexicographique par nom, donc FROM 'name_string' ne retourne que les lignes ayant une valeur lexicographique plus élevée que les lignes retournées par STARTS WITH 'name_string'

Par exemple :

  • ... STARTS WITH 'A' LIMIT ... FROM 'B' ne donnerait aucun résultat.

  • ... STARTS WITH 'B' LIMIT ... FROM 'A' ne donnerait aucun résultat.

  • ... STARTS WITH 'A' LIMIT ... FROM 'AB' donnerait des résultats (si des lignes correspondent aux chaînes d’entrée).

Notes sur l’utilisation

  • La commande ne peut être exécutée que par des utilisateurs ayant un rôle ayant le privilège global MANAGE GRANTS. Ce privilège n’est généralement accordé qu’aux rôles ACCOUNTADMIN et SECURITYADMIN.

  • Si le compte comprend plus de 10 000 utilisateurs, vous pouvez utiliser l’une des options suivantes :

    • SHOW USERS;

    • SHOW USERS LIMIT 10000 FROM 'JOE';

      Renvoie les utilisateurs après 10 000. Dans cet exemple, JOE est le nom d’utilisateur de la dernière ligne de la commande.

  • L’exécution de la commande ne nécessite pas l’exécution d’un entrepôt en cours d’exécution.

  • Pour post-traiter la sortie de cette commande, vous pouvez utiliser la fonction RESULT_SCAN qui traite la sortie comme une table qui peut être interrogée.