USE SCHEMA

  • Artículo

Se aplica a:casilla marcada como sí Databricks SQL casilla marcada como Sí Databricks Runtime 10.4 LTS y versiones posteriores

Establece el esquema actual. Una vez que se establece el esquema actual, las referencias no calificadas a objetos como tablas, funciones y vistas a las que se hace referencia mediante SQL se resuelven a partir del esquema actual. El nombre de esquema predeterminado es default.

Aunque se pueden usar tanto SCHEMA como DATABASE, se prefiere SCHEMA.

Sintaxis

USE [SCHEMA] schema_name

Parámetro

  • schema_name

    Nombre del esquema que se va a usar. El esquema debe existir dentro del catálogo actual o se genera la excepción SCHEMA_NOT_FOUND.

Ejemplos

-- 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