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

Für spezifische Syntax, Nutzungshinweise und Beispiele siehe:

Allgemeine Nutzungshinweise

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

    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

    Weitere Details dazu finden Sie unter Kontextfunktionen.

Beispiele

Warehouse verwenden:

USE WAREHOUSE mywarehouse;
Copy

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

USE mytestdb.testschema;
Copy

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