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 :

CREATE DATASET, ALTER DATASET

Syntaxe

SHOW DATASETS
  [ LIKE '<pattern>' ]
  [ IN { SCHEMA <schema_name> | DATABASE <db_name> | ACCOUNT } ]
  [ STARTS WITH '<name_string>' ]
  [ LIMIT <rows> [ FROM '<name_string>' ] ]
Copy

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;
Copy