Udostępnij za pośrednictwem

USE CATALOG

  • Artykuł

Dotyczy:oznaczone jako tak Databricks SQL oznaczone jako tak Databricks Runtime 10.4 LTS i nowsze oznaczone jako tak tylko Unity Catalog

Ustawia bieżący katalog. Po ustawieniu bieżącego wykazu identyfikatory częściowo i niecałkowicie kwalifikowane dla tabel, funkcji i widoków, do których odwołują się zapytania SQL, są rozwiązywane z bieżącego wykazu.

Ustawienie wykazu powoduje również zresetowanie bieżącego schematu do default.

Składnia

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

Parametr

Przykłady

-- 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 datbase to `default`
> USE CATALOG some_cat;
> SELECT  current_catalog(), current_database();
  some_cat default

-- Setting the schema within the curret 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