USE CATALOG

  • 아티클

적용 대상:검사 '예'로 표시 Databricks SQL 검사 '예'로 표시 Databricks Runtime 10.4 LTS 이상 검사 '예'로 표시 Unity 카탈로그만 해당

현재 카탈로그를 설정합니다. 현재 카탈로그가 설정된 후 SQL에서 참조하는 테이블, 함수 및 뷰에 대한 부분 및 규정되지 않은 ID가 현재 카탈로그에서 분석됩니다.

카탈로그를 설정하면 현재 스키마도 default로 다시 설정됩니다.

구문

{ USE | SET } CATALOG [ catalog_name | ' catalog_name ' ]

매개 변수

  • catalog_name

    사용할 카탈로그의 이름입니다. 카탈로그가 없으면 예외가 throw됩니다.

예제

-- Use the 'hive_metastore' which exists.
> USE CATALOG hive_metastore;

> USE CATALOG 'hive_metastore';

-- Use the 'some_catalog' which doesn't exist
> USE CATALOG `some_catalog`;
  Error: Catalog 'some_catalog' not found;

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

-- Setting the schema within the curret catalog
> USE DATABASE some_db;
> SELECT  current_catalog(), current_database();
  some_cat some_db

-- Resetting both catalog and schema
> USE DATABASE main.my_db;
> SELECT  current_catalog(), current_database();
  main my_db

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