USE SCHEMA

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

Note

Esta página describe el USE SCHEMA comando SQL, que establece el esquema actual para una sesión. Para el privilegio USE SCHEMA del Catálogo de Unity, con el que los usuarios necesitan interactuar con objetos en un esquema, véase USE SCHEMA.

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
  • Last updated on