Catégories :

Commandes DDL

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>

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, 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_WAREHOUSE(), CURRENT_DATABASE(), CURRENT_SCHEMA();
    
    +----------------+---------------------+--------------------+------------------+
    | CURRENT_ROLE() | CURRENT_WAREHOUSE() | CURRENT_DATABASE() | CURRENT_SCHEMA() |
    |----------------+---------------------+--------------------+------------------|
    | SYSADMIN       | MYWH                | MYTESTDB           | PUBLIC           |
    +----------------+---------------------+--------------------+------------------+
    

    Pour plus de détails, voir Fonctions contextuelles.

Exemples

Utiliser un entrepôt :

USE WAREHOUSE mywarehouse;

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

USE mytestdb.testschema;

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;