USE CATALOG
적용 대상:
Databricks SQL Databricks Runtime 10.4 LTS 이상 Unity Catalog만.
현재 catalog설정합니다. 현재 catalog가 set인 후, SQL에서 참조하는 함수, tables에 대한 일부 및 정규화되지 않은 식별자, 그리고 views는 현재 catalog에서 해결됩니다.
catalog을 설정하면 현재 schema이 default로 초기화됩니다.
구문
{ USE | SET } CATALOG [ catalog_name | ' catalog_name ' ]
매개 변수
-
사용할 catalog 이름입니다. catalog가 존재하지 않으면, 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