Sdílet prostřednictvím

USE SCHEMA

  • Článek

Platí pro:zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime 10.4 LTS a vyšší

Nastaví aktuální schema. Jakmile je aktuální schemaset, nekvalifikované odkazy na objekty, jako jsou tables, funkce a views, které jsou odkazovány pomocí SQL, jsou překládány z aktuálního schema. Výchozí název schema je default.

I když je používání SCHEMA a DATABASE je zaměnitelné, SCHEMA je upřednostňované.

Syntaxe

USE [SCHEMA] schema_name

Parametr

  • schema_name

    Název schema, který se má použít. schema musí existovat v aktuálním catalog, jinak je vyvolána výjimka SCHEMA_NOT_FOUND.

Příklady

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