適用於:
Databricks SQL
Databricks Runtime 10.4 LTS 和更新版本
Note
本頁描述 USE SCHEMA SQL 指令,該指令設定會話的當前架構。 關於 USE SCHEMA Unity 目錄權限,使用者需要與結構中的物件互動,請參見 USE SCHEMA。
設定目前的架構。 在設定好目前架構後,對於由 SQL 參考的物件(如表格、函式和視圖)的未限定參考,會從目前架構中解析。
預設架構名稱稱為 default。
雖然 SCHEMA 和 DATABASE 之間的使用是可以互換的,但偏好使用 SCHEMA。
語法
USE [SCHEMA] schema_name
參數
-
要使用的架構名稱。 架構必須存在於目前目錄內,否則 引發例外狀況SCHEMA_NOT_FOUND 。
範例
-- Use the 'userschema' which exists.
> USE SCHEMA userschema;
-- Use the 'userschema1' which doesn't exist
> USE SCHEMA userschema1;
Error: Database 'userschema1' not found;
-- Setting the catalog resets the schema to `default`
> USE CATALOG some_cat;
> SELECT current_catalog(), current_schema();
some_cat default
-- Setting the schema within the current catalog
> USE SCHEMA some_schem;
> SELECT current_catalog(), current_schema();
some_cat some_schema
-- Resetting both catalog and schema
> USE CATALOG main;
> USE SCHEMA 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