USE VCLUSTER

切换当前会话使用的计算资源（Virtual Cluster）。

语法

USE VCLUSTER vc_name;

参数说明

vc_name

返回值

该命令无返回结果，执行成功后当前会话的计算资源切换为指定的

vc_name

可通过

SELECT CURRENT_VCLUSTER()

SELECT CURRENT_VCLUSTER(); -- 返回当前会话使用的计算资源名称，例如 "default"

使用示例

1. 切换到名为

   DEFAULT

   DEFAULT
   的通用计算资源：

USE VCLUSTER DEFAULT; SELECT CURRENT_VCLUSTER();

2. 切换到高性能分析型计算资源：

USE VCLUSTER DEFAULT_AP;

3. 切换后执行查询，查询将在新的计算资源上运行：

USE VCLUSTER DEFAULT_AP; SELECT COUNT(*) FROM doc_test.orders;

注意事项

• 使用客户端工具（如 SQLLine、DBeaver）连接时，

  USE VCLUSTER

  USE VCLUSTER
  在整个会话期间持续生效。
• 在 Lakehouse Studio 界面中，建议优先通过页面顶部的下拉菜单切换计算资源。若直接在 SQL 编辑器中执行该命令，需将

  USE VCLUSTER

  USE VCLUSTER
  语句与后续 SQL 一起选中后执行，否则切换效果仅对当前语句临时生效。
• 指定的计算资源必须已存在且处于可用状态，可通过

  SHOW VCLUSTERS

  SHOW VCLUSTERS
  查看所有可用计算资源。
• 若计算资源处于

  SUSPENDED

  SUSPENDED
  状态，切换后首次执行 SQL 时会自动唤醒，可能有短暂延迟。

预览