Compartir vía

USE CATALOG

  • Artículo

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

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

  • catalog_name

    Nombre del catálogo que se va a usar. Si el catálogo no existe, se produce una excepción.

Ejemplos

-- Use the 'hive_metastore' which exists.
> USE CATALOG hive_metastore;

> USE CATALOG 'hive_metastore';

-- Use the 'some_catalog' which doesn't exist
> USE CATALOG `some_catalog`;
  Error: Catalog 'some_catalog' not found;

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