적용 대상:
Databricks SQL Databricks Runtime 10.4 LTS 이상 Unity 카탈로그에만 해당
현재 카탈로그를 설정합니다. 현재 카탈로그가 설정되면, SQL에서 참조하는 테이블, 함수 및 뷰에 대한 부분 및 비정규화된 식별자가 현재 카탈로그에서 처리됩니다.
카탈로그를 설정하면 현재 스키마도 default다시 설정됩니다.
구문
{ USE | SET } CATALOG [ catalog_name | ' catalog_name ' ]
매개 변수
-
사용할 카탈로그의 이름입니다. 카탈로그가 없으면 NO_SUCH_CATALOG_EXCEPTION 예외가 발생합니다.
예제
-- Use the 'hive_metastore' which exists.
> USE CATALOG hive_metastore;
> USE CATALOG 'hive_metastore';
-- Use a catalog given as a string variable
> DECLARE mycat = 'main';
> USE CATALOG IDENTIFIER(mycat);
-- Use the 'some_catalog' which doesn't exist
> USE CATALOG `some_catalog`;
Error: NO_SUCH_CATALOG_EXCEPTION
-- 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