Freigeben über


USE CATALOG

Gilt für: Häkchen ja Databricks SQL durch Häkchen mit „Ja“ markiert Databricks Runtime 10.4 LTS und höher Häkchen bei ja Nur Unity Catalog

Legt den aktuellen Katalog fest. Nachdem der aktuelle Katalog festgelegt wurde, werden teilweise und unqualifizierte Bezeichner für Tabellen, Funktionen und Sichten, auf die von SQL-Befehlen verwiesen wird, anhand des aktuellen Katalogs aufgelöst.

Durch Festlegen des Katalogs wird auch das aktuelle Schema auf default zurückgesetzt.

Syntax

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

Parameter

  • catalog_name

    Der Name des zu verwendenden Katalogs. Wenn der Katalog nicht vorhanden ist, wird eine Ausnahme ausgelöst.

Beispiele

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