Dela via


USE CATALOG

gäller för:kontrollera markerat ja Databricks SQL kontrollera markerat ja Databricks Runtime 10.4 LTS och senare kontrollera markerat ja Endast Unity Catalog

Anger den aktuella katalogen. När den aktuella katalogen har angetts löses delvis och okvalificerade identifierare för tabeller, funktioner och vyer som refereras till av SQL:er från den aktuella katalogen.

Om du ställer in katalogen återställs även det aktuella schemat till default.

Syntax

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

Parameter

Exempel

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