USE SCHEMA
適用対象: Databricks SQL Databricks Runtime 10.4 LTS 以上
現在のスキーマを設定します。 現在のスキーマが設定された後、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