Freigeben über

USE SCHEMA

  • Artikel

Gilt für: Häkchen ja Databricks SQL Häkchen gesetzt ja Databricks Runtime 10.4 LTS und höher

Legt das aktuelle Schema fest. Nachdem das aktuelle Schema festgelegt wurde, werden nicht qualifizierte Verweise auf Objekte wie Tabellen, Funktionen und Sichten, auf die von SQL-Befehlen verwiesen wird, anhand des aktuellen Schemas aufgelöst. Der Standardname des Schemas ist default.

Auch wenn die Verwendung von SCHEMA und DATABASE austauschbar ist, sollte vorzugsweise SCHEMA verwendet werden.

Syntax

USE [SCHEMA] schema_name

Parameter

  • schema_name

    Name des zu verwendende Schemas. Das Schema muss im aktuellen Katalog enthalten sein, andernfalls wird die Ausnahme SCHEMA_NOT_FOUND ausgelöst.

Beispiele

-- Use the 'userschema' which exists.
> USE SCHEMA userschema;

-- Use the 'userschema1' which doesn't exist
> USE SCHEMA userschema1;
  Error: Database 'userschema1' not found;

-- Setting the catalog resets the schema to `default`
> USE CATALOG some_cat;
> SELECT current_catalog(), current_schema();
  some_cat default

-- Setting the schema within the current catalog
> USE SCHEMA some_schem;
> SELECT current_catalog(), current_schema();
  some_cat some_schema

-- Resetting both catalog and schema
> USE CATALOG main;
> USE SCHEMA my_schema;
> SELECT current_catalog(), current_schema();
  main my_schema

-- Setting the catalog resets the schema to `default` again
> USE CATALOG some_cat;
> SELECT current_catalog(), current_schema();
  some_cat default