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 ou un schéma n’est pas spécifié 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 connu sous le nom espaces de noms, pour l’objet.

Syntaxe¶

USE ROLE <name>

USE WAREHOUSE <name>

USE [ DATABASE ] <name>

USE [ SCHEMA ] [<db_name>.]<name>

Copy

Pour des informations spécifiques sur la syntaxe, les notes sur l’utilisation et des exemples, voir :

Notes générales 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           |
+----------------+--------------------------+---------------------+--------------------+------------------+

Copy

Pour plus de détails, voir Fonctions contextuelles.

Exemples¶

Utiliser un entrepôt :

USE WAREHOUSE mywarehouse;

Copy

Utiliser un schéma avec le nom complet du schéma spécifié :

USE mytestdb.testschema;

Copy

Utiliser un schéma sans le nom complet du schéma spécifié (nécessite que la base de données du schéma soit déjà utilisée pour la session) :

USE testschema;

Copy