USE CATALOG

Se aplica a:casilla marcada como sí Databricks SQL casilla marcada como Sí Databricks Runtime 10.4 LTS y versiones posteriores casilla marcada como Sí solo a Unity Catalog

Note

Esta página describe el USE CATALOG comando SQL, que establece el catálogo actual para una sesión. Para el USE CATALOG privilegio del Catálogo de Unity, con el que los usuarios necesitan interactuar con objetos en un catálogo, véase USE CATALOG.

Establece el catálogo actual. Una vez que se ha establecido el catálogo actual, los identificadores parciales y no completos de las tablas, funciones y vistas a las que hacen referencia las instrucciones SQL se resuelven desde dicho catálogo.

Al establecer el catálogo también se restablece el esquema actual en default.

Sintaxis

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

Parámetro

Ejemplos

-- 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
  • Last updated on