USE CATALOG
gäller för: Databricks SQL
Databricks Runtime 10.4 LTS och senare
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
-
Namnet på katalogen som ska användas. Om katalogen inte finns genereras en NO_SUCH_CATALOG_EXCEPTION.
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