USE CATALOG

Van toepassing op:Alleen Databricks SQL Databricks Runtime 10.4 LTS en hoger dan Unity Catalog

Opmerking

Deze pagina beschrijft het USE CATALOG SQL-commando, dat de huidige catalogus voor een sessie instelt. Voor het USE CATALOG Unity Catalog-privilege, dat gebruikers nodig hebben om met objecten in een catalogus te communiceren, zie USE CATALOG.

Hiermee stelt u de huidige catalogus in. Nadat de huidige catalogus is ingesteld, worden gedeeltelijk en niet-gekwalificeerde id's voor tabellen, functies en weergaven waarnaar wordt verwezen door SQLs, omgezet vanuit de huidige catalogus.

Als u de catalogus instelt, wordt ook het huidige schema opnieuw ingesteld op default.

Syntaxis

{ USE | SET } CATALOG [ catalog_name | ' catalog_name ' ]

Parameter

• catalog_name

  De naam van de catalogus die moet worden gebruikt. Als de catalogus niet bestaat, wordt er een NO_SUCH_CATALOG_EXCEPTION opgeworpen.

Voorbeelden

-- Use the 'hive_metastore' which exists.
> USE CATALOG hive_metastore;

> USE CATALOG 'hive_metastore';

-- Use a catalog given as a string variable
> DECLARE mycat = 'main';
> USE CATALOG IDENTIFIER(mycat);

-- Use the 'some_catalog' which doesn't exist
> USE CATALOG `some_catalog`;
  Error: NO_SUCH_CATALOG_EXCEPTION

-- Setting the catalog resets the database to `default`
> USE CATALOG some_cat;
> SELECT  current_catalog(), current_database();
  some_cat default

-- Setting the schema in the current catalog
> USE DATABASE some_db;
> SELECT  current_catalog(), current_database();
  some_cat some_db

-- Resetting both catalog and schema
> USE DATABASE main.my_db;
> SELECT  current_catalog(), current_database();
  main my_db

-- Setting the catalog resets the database to `default` again
> USE CATALOG some_cat;
> SELECT  current_catalog(), current_database();
  some_cat default

Verwante artikelen:

• CREATE CATALOG
• DROP CATALOG
• USE SCHEMA