USE <objet>¶
Spécifie le rôle, l’entrepôt virtuel, la base de données ou le schéma à utiliser pour la session en cours :
Le rôle d’une session détermine les objets auxquels il est possible d’accéder dans les requêtes et autres instructions SQL exécutées dans la session.
Un entrepôt est nécessaire pour qu’une session exécute des requêtes et d’autres instructions DML, y compris le chargement/déchargement de données, dans la session.
Si une base de données n’est pas spécifiée pour une session, tous les objets référencés dans les requêtes et autres instructions SQL exécutées dans la session doivent être entièrement qualifiés avec la base de données et le schéma, aussi connus sous le nom espaces de noms, pour l’objet (sous la forme
db_name.schema_name.object_name
). Pour plus d’informations sur les noms d’objets entièrement qualifiés, voir Résolution de nom d’objet.Si une base de données est spécifiée pour une session mais que le schéma n’est pas spécifié pour une session, tous les objets référencés dans les requêtes et les autres instructions SQL exécutées dans la session doivent être qualifiés avec le schéma de l’objet (sous la forme
schema_name.object_name
).Si la base de données et le schéma sont spécifiés pour une session utilisateur, les noms d’objet non qualifiés sont autorisés dans les requêtes et les instructions SQL.
Syntaxe¶
USE ROLE <name>
USE WAREHOUSE <name>
USE [ DATABASE ] <name>
USE [ SCHEMA ] [<db_name>.]<name>
Pour des informations spécifiques sur la syntaxe, les notes sur l’utilisation et des exemples, voir :
Notes sur l’utilisation¶
Pour afficher le rôle, les rôles secondaires, la base de données, le schéma et l’entrepôt virtuel actuels de la session, utilisez les fonctions de contexte correspondantes. Par exemple :
SELECT CURRENT_ROLE(),
CURRENT_SECONDARY_ROLES(),
CURRENT_WAREHOUSE(),
CURRENT_DATABASE(),
CURRENT_SCHEMA();
+----------------+--------------------------+---------------------+--------------------+------------------+
| CURRENT_ROLE() | CURRENT_SECONDARY_ROLES | CURRENT_WAREHOUSE() | CURRENT_DATABASE() | CURRENT_SCHEMA() |
|----------------+--------------------------+---------------------+--------------------+------------------|
| SYSADMIN | ALL | MYWH | MYTESTDB | PUBLIC |
+----------------+--------------------------+---------------------+--------------------+------------------+
Pour plus de détails, voir Fonctions contextuelles.
Exemples¶
Utiliser un entrepôt :
USE WAREHOUSE mywarehouse;
Utiliser un schéma :
USE mytestdb.testschema;