跳到主要内容
版本:Stable-3.1

USE

功能

指定会话使用的数据库。指定数据库后,即可以进行后续的建表或者查询等操作。

语法

USE [<catalog_name>.]<db_name>

参数说明

参数必选说明
catalog_nameCatalog 名称。
  • 如不指定该参数,则默认使用 default_catalog 下的数据库。
  • 如要使用 external catalog 下的数据库,则必须指定该参数,具体见「示例二」。
  • 如从一个 catalog 下的数据库切换到另一个 catalog 下的数据库,则必须指定该参数,具体见「示例三」。
更多有关 catalog 的信息,请参见概述
db_name数据库名称。该数据库必须存在。

示例

示例一:使用 default_catalog 下的 example_db 作为会话的数据库。

USE default_catalog.example_db;

USE example_db;

示例二:使用 hive_catalog 下的 example_db 作为会话的数据库。

USE hive_catalog.example_db;

示例三:将会话使用的数据库 hive_catalog.example_table1 切换到 iceberg_catalog.example_table2

USE iceberg_catalog.example_table2;