USE指定当前会话数据库-云原生数据仓库AnalyticDB(AnalyticDB)-阿里云帮助中心

USE 用于指定当前会话使用的数据库。指定数据库后，即可进行后续的建表或查询等操作。

语法

USE [<catalog_name>.]<db_name>;

必填

说明

catalog_name

否

Catalog 名称。

如不指定该参数：
- 如当前会话未指定 Catalog，则默认使用 adb 下的数据库。
- 如当前会话已指定 Catalog，则使用会话的 Catalog 下的数据库。
如要使用 External Catalog 下的数据库，则必须指定该参数。
如从一个 Catalog 下的数据库切换到另一个 Catalog 下的数据库，则必须指定该参数。

该参数自 3.2.7 版本起支持。

db_name

是

数据库名称。该数据库必须存在。

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

USE adb.example_db;

或

USE example_db;

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

USE paimon_catalog.example_db;

示例三：将会话使用的数据库 paimon_catalog.example_db1 切换到 iceberg_catalog.example_db2。

USE iceberg_catalog.example_db2;