SHOW DATASETS¶
Affiche des informations sur les jeux de données de votre compte. Vous pouvez afficher tous les jeux de données ou utiliser la sous-commande IN pour n’afficher que les résultats au niveau du schéma ou de la base de données.
- Voir aussi :
Syntaxe¶
SHOW DATASETS
[ LIKE '<pattern>' ]
[ IN { SCHEMA <schema_name> | DATABASE <db_name> | ACCOUNT } ]
[ STARTS WITH '<name_string>' ]
[ LIMIT <rows> [ FROM '<name_string>' ] ]
Paramètres facultatifs¶
LIKE pattern
Limite la liste des jeux de données renvoyés à ceux qui correspondent au modèle spécifié.
IN SCHEMA <schema_name> | DATABASE <db_name> | ACCOUNT
Limite la liste des jeux de données renvoyés à ceux qui se trouvent dans le schéma ou la base de données spécifié(e) au sein d’un compte.
DATABASE db_name
Limite la liste des jeux de données renvoyés à ceux de la base de données spécifiée. Si vous spécifiez une base de données sans
db_name
et si aucune base de données n’est utilisée, le mot-clé n’a aucun effet sur la sortie.SCHEMA schema_name
Par défaut, renvoie les enregistrements du schéma en cours d’utilisation. Vous pouvez également spécifier un
schema_name
.STARTS WITH name_string
Utilise la chaîne que vous spécifiez pour limiter les jeux de données renvoyés. Les noms des jeux de données renvoyés ont les mêmes caractères de début que la chaîne spécifiée.
LIMIT rows [ FROM name_string ]
Limite le nombre de jeux de données renvoyés au nombre de lignes spécifié. La clause FROM facultative spécifie le point de départ des jeux de données renvoyés.
Exigences en matière de contrôle d’accès¶
Un rôle utilisé pour exécuter cette opération doit au minimum disposer des privilèges suivants :
Privilège |
Objet |
Remarques |
---|---|---|
OWNERSHIP ou USAGE |
Jeu de données |
Fournit le privilège d’afficher les jeux de données au sein du compte. |
Le privilège USAGE relatif à la base de données et au schéma parents est exigé pour effectuer des opérations sur tout objet d’un schéma.
Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.
Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.
Exemples¶
L’exemple suivant montre deux jeux de données dans le schéma PUBLIC :
SHOW DATASETS IN SCHEMA PUBLIC LIMIT 2;