USE SCHEMA

  • [アーティクル]

適用対象:「はい」のチェック マーク Databricks SQL 「はい」のチェック マーク Databricks Runtime 10.2 以降

現在のスキーマを設定します。 現在のスキーマが設定された後、SQL によって参照されるテーブル、関数、ビューなどのオブジェクトへの非修飾参照は、現在のスキーマから解決されます。 既定のスキーマ名は、default です。

SCHEMA と DATABASE の使用は交換可能ですが、SCHEMA をお勧めします。

構文

USE [SCHEMA] schema_name

パラメーター

  • schema_name

    使用するスキーマの名前。 schema_name が修飾されている場合、現在のカタログも、指定したカタログ名に設定されます。 スキーマが存在しない場合は、例外がスローされます。

例

-- 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_schema(), current_catalog();
  some_cat default

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

-- Resetting both catalog and schema
> USE CATALOG main;
> USE SCHEMA my_schema;
> SELECT current_schema(), current_catalog();
  main my_schema

-- Setting the catalog resets the schema to `default` again
> USE CATALOG some_cat;
> SELECT current_schema(), current_catalog();
  some_cat default