Kategorien:

DDL-Befehle

USE <Objekt>

Gibt die Rolle, das Warehouse, die Datenbank oder das Schema an, das bzw. die für die aktuelle Sitzung verwendet werden soll:

  • Die Rolle für eine Sitzung bestimmt die Objekte, auf die in Abfragen und anderen SQL-Anweisungen zugegriffen werden kann, die in der Sitzung ausgeführt werden.

  • Ein Warehouse ist erforderlich, damit eine Sitzung Abfragen und andere DML-Anweisungen ausführen kann, einschließlich Laden/Entladen von Daten in der Sitzung.

  • Wenn für eine Sitzung weder Datenbank noch Schema angegeben ist, müssen alle Objekte, die in Abfragen und anderen SQL-Anweisungen, die in der Sitzung ausgeführt werden, referenziert werden, mit der Datenbank und dem Schema, auch Namespace genannt, für das Objekt vollständig qualifiziert sein.

Syntax

USE ROLE <name>

USE WAREHOUSE <name>

USE [ DATABASE ] <name>

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

Für spezifische Syntax, Nutzungshinweise und Beispiele siehe:

Allgemeine Nutzungshinweise

  • Verwenden Sie die entsprechenden Kontextfunktionen, um die aktuelle Rolle, Datenbank, das Schema und das Warehouse für die Sitzung anzuzeigen. Beispiel:

    SELECT CURRENT_ROLE(), CURRENT_WAREHOUSE(), CURRENT_DATABASE(), CURRENT_SCHEMA();
    
    +----------------+---------------------+--------------------+------------------+
    | CURRENT_ROLE() | CURRENT_WAREHOUSE() | CURRENT_DATABASE() | CURRENT_SCHEMA() |
    |----------------+---------------------+--------------------+------------------|
    | SYSADMIN       | MYWH                | MYTESTDB           | PUBLIC           |
    +----------------+---------------------+--------------------+------------------+
    

    Weitere Details dazu finden Sie unter Kontextfunktionen.

Beispiele

Warehouse verwenden:

USE WAREHOUSE mywarehouse;

Schema mit dem vollständig qualifizierten Namen des angegebenen Schemas verwenden:

USE mytestdb.testschema;

Schema ohne den vollständig qualifizierten Namen des angegebenen Schemas verwenden (dazu muss die Datenbank für das Schema bereits für die Sitzung verwendet werden):

USE testschema;