Перейти к основному содержимому

USE

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

Синтаксис​

USE [<catalog_name>.]<db_name>

Параметры​

ПараметрОбязательныйОписание
catalog_nameНетИмя каталога.
  • Если этот параметр не указан, по умолчанию используется база данных в default_catalog.
  • Вы должны указать этот параметр при использовании базы данных из external 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;