適用対象:
Databricks SQL
Databricks Runtime 10.4 LTS 以上
Unity Catalog のみ
現在のカタログを設定します。 現在のカタログが設定されると、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