USE CATALOG

適用於:核取記號為「是」Databricks SQL 核取記號為「是」Databricks Runtime 10.4 LTS 和更新版本核取記號為「是」僅限 Unity 目錄

Note

本頁說明 USE CATALOG SQL 指令,該指令可設定會話的當前目錄。 關於 USE CATALOG Unity 目錄權限,使用者需要與目錄中的物件互動,請參見 USE CATALOG。

設定目前的目錄。 設定目前目錄之後,會從目前的目錄解析 SQL 所參考之數據表、函式和檢視的部分和未限定識別符。

設定目錄也會將目前的架構 default重設為 。

語法

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

參數

範例

-- 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 schema to `default`
> USE CATALOG some_cat;
> SELECT current_catalog(), current_schema();
  some_cat default

-- Setting the schema in the current catalog
> USE SCHEMA some_schema;
> SELECT current_catalog(), current_schema();
  some_cat some_schema

-- Resetting both catalog and schema
> USE SCHEMA main.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