USE SCHEMA

Dotyczy: Databricks SQL Databricks Runtime 10.4 LTS i nowsze

Ustawia bieżący schemat. Po ustawieniu bieżącego schematu, niekwalifikowane odwołania do obiektów, takich jak tabele, funkcje i widoki, do których odnoszą się instrukcje SQL, są rozpoznawane z bieżącego schematu. Domyślna nazwa schematu to default.

Chociaż SCHEMA i DATABASE można używać zamiennie, preferowane jest SCHEMA.

Składnia

USE [SCHEMA] schema_name

Parametr

• schema_name

  Nazwa schematu do użycia. Schemat musi istnieć w bieżącym wykazie lub zgłaszany jest wyjątek SCHEMA_NOT_FOUND.

Przykłady

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

Powiązane artykuły

• CREATE SCHEMA
• DROP SCHEMA
• USE CATALOG