USE CATALOG

Berlaku untuk: Databricks SQL Databricks Runtime 10.4 LTS ke atas Unity Catalog saja

Mengatur katalog saat ini. Setelah katalog saat ini diatur, pengidentifikasi parsial dan yang tidak memenuhi syarat untuk tabel, fungsi, dan tampilan yang dirujuk oleh pernyataan SQL diselesaikan dari katalog saat ini.

Mengatur katalog juga mengatur ulang skema saat ini ke default.

Sintaks

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

Parameter

• catalog_name

  Nama katalog yang akan digunakan. Jika katalog tidak ada, NO_SUCH_CATALOG_EXCEPTION dilemparkan.

Contoh

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

Artikel terkait

• CREATE CATALOG
• DROP CATALOG
• USE SCHEMA