USE

USE 语句用于指定会话的当前数据库。之后，您可以执行诸如创建表和执行查询等操作。

语法

USE [<catalog_name>.]<db_name>

参数

参数	必需	描述
catalog_name	否	Catalog 名称。 如果未指定此参数，则默认使用default_catalog中的数据库。 当您使用外部 Catalog 中的数据库时，必须指定此参数。有关更多信息，请参见示例 2。 在不同 Catalog 的数据库之间切换时，必须指定此参数。有关更多信息，请参见示例 3。 有关 Catalog 的更多信息，请参见概述。
db_name	是	数据库名称。数据库必须存在。

示例

示例 1：使用default_catalog中的example_db作为会话的当前数据库。

USE default_catalog.example_db;

或

USE example_db;

示例 2：使用hive_catalog中的example_db作为会话的当前数据库。

USE hive_catalog.example_db;

示例 3：将会话的当前数据库从hive_catalog.example_table1切换到iceberg_catalog.example_table2。

USE iceberg_catalog.example_table2;