Dela via

USE SCHEMA

  • Artikel

Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime 10.4 LTS och senare

Anger den aktuella schema. Efter att den aktuella schema är setlöses okvalificerade referenser till objekt som tables, funktioner och views, vilka refereras till av SQL, från den aktuella schema. Standardnamnet för schema är default.

Även om användning av SCHEMA och DATABASE är utbytbar, SCHEMA är att föredra.

Syntax

USE [SCHEMA] schema_name

Parameter

  • schema_name

    Namnet på schema som ska användas. schema måste finnas inom den aktuella catalog eller så aktiveras undantaget SCHEMA_NOT_FOUND.

Exempel

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