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 keine Datenbank 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 bekannt als Namespace, für das Objekt vollständig qualifiziert sein (in Form von db_name.schema_name.object_name). Weitere Informationen zu vollständig qualifizierten Objektnamen finden Sie unter Auflösung von Objektnamen.

  • Wenn für eine Sitzung eine Datenbank, aber kein Schema angegeben ist, müssen alle Objekte, die in Abfragen und anderen SQL-Anweisungen referenziert sind, die in der Sitzung ausgeführt werden, mit dem Schema für das Objekt qualifiziert werden (in Form von schema_name.object_name).

  • Wenn die Datenbank und das Schema für eine Sitzung des Benutzers angegeben sind, sind unqualifizierte Objektnamen in SQL-Anweisungen und Abfragen erlaubt.

Syntax

USE ROLE <name>

USE WAREHOUSE <name>

USE [ DATABASE ] <name>

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

Für spezifische Syntax, Nutzungshinweise und Beispiele siehe:

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

Weitere Details dazu finden Sie unter Kontextfunktionen.

Beispiele

Warehouse verwenden:

USE WAREHOUSE mywarehouse;
Copy

Verwenden eines Schemas:

USE mytestdb.testschema;
Copy