USE SCHEMA

Область применения: Databricks SQL Databricks Runtime 10.4 LTS и выше

Задает текущую схему. After the current schema is set, unqualified references to objects such as tables, functions, and views that are referenced by SQLs are resolved from the current schema. Имя схемы по умолчанию — default.

Хотя использование SCHEMA и DATABASE является взаимозаменяемым, лучше использовать SCHEMA.

Синтаксис

USE [SCHEMA] schema_name

Параметр

• 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

Связанные статьи

• CREATE SCHEMA
• DROP SCHEMA
• USE CATALOG