USE SCHEMA

  • 아티클

적용 대상:검사 '예'로 표시 Databricks SQL 검사 '예'로 표시 Databricks Runtime 10.4 LTS 이상

현재 스키마를 설정합니다. 현재 스키마가 설정되면 SQL에서 참조하는 테이블, 함수, 뷰와 같은 개체에 대한 규정되지 않은 참조가 현재 스키마에서 해결됩니다. 기본 스키마 이름은 default입니다.

SCHEMA 및 DATABASE의 사용은 서로 교환할 수 있지만 SCHEMA가 선호됩니다.

구문

USE [SCHEMA] schema_name

매개 변수

  • schema_name

    사용할 스키마의 이름입니다. 스키마는 현재 카탈로그 내에 있어야 합니다. 그렇지 SCHEMA_NOT_FOUND 예외가 발생합니다.

예제

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