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>
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();
+----------------+--------------------------+---------------------+--------------------+------------------+
| 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;
Verwenden eines Schemas:
USE mytestdb.testschema;