Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Si applica a:
Databricks SQL Databricks Runtime 10.4 LTS e versioni successive solo Catalogo Unity
Note
Questa pagina descrive il USE CATALOG comando SQL, che imposta il catalogo corrente per una sessione. Per il USE CATALOG privilegio Unity Catalog, che gli utenti devono utilizzare per interagire con gli oggetti di un catalogo, vedi USE CATALOG.
Imposta il catalogo corrente. Dopo aver impostato il catalogo corrente, gli identificatori parziali e non qualificati per tabelle, funzioni e viste a cui si fa riferimento tramite istruzioni SQL sono risolti dal catalogo corrente.
L'impostazione del catalogo reimposta anche lo schema corrente su default.
Sintassi
{ USE | SET } CATALOG [ catalog_name | ' catalog_name ' ]
Parametro
-
Nome del catalogo da utilizzare. Se il catalogo non esiste, viene generata una NO_SUCH_CATALOG_EXCEPTION.
Esempi
-- 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