Перейти к основному содержимому
Версия: 2.0.x

USE

USE указывает активную базу данных для вашей сессии. После этого вы можете выполнять операции, такие как создание таблиц и выполнение запросов.

Синтаксис​

USE [<catalog_name>.]<db_name>

Параметры​

ПараметрОбязательныйОписание
catalog_nameНетИмя каталога.
  • Если этот параметр не указан, по умолчанию используется база данных в default_catalog.
  • Вы должны указать этот параметр при использовании базы данных из внешнего каталога. Дополнительную информацию см. в Примере 2.
  • Вы должны указать этот параметр при переключении баз данных между разными каталогами. Дополнительную информацию см. в Примере 3.
Дополнительную информацию о каталогах см. в разделе Обзор.
db_nameДаИмя базы данных. База данных должна существовать.

Примеры​

Пример 1: Использование example_db из default_catalog в качестве активной базы данных вашей сессии.

USE default_catalog.example_db;

Или

USE example_db;

Пример 2: Использование example_db из hive_catalog в качестве активной базы данных вашей сессии.

USE hive_catalog.example_db;

Пример 3: Переключение активной базы данных вашей сессии с hive_catalog.example_table1 на iceberg_catalog.example_table2.

USE iceberg_catalog.example_table2;