快速上手系列丨如何管理 PieCloudDB Database 虚拟数仓

为增强社区用户的体验，PieCloudDB Database 社区版已于8月完成了全面改版升级。同时，PieCloudDB 社区还特别制作了《快速入门 PieCloudDB 社区版》系列课程，旨在帮助大家全面了解新版本，逐步探索 PieCloudDB 的强大功能。

PieCloudDB 社区版提供免费下载，可用于体验产品新特性、个人学习、PoC 验证等场景，方便社区用户快速体验领先的数仓虚拟化技术。PieCloudDB 社区版采用全容器化一键式部署方案，支持在线和离线两种安装方式。

通过社区版，用户可体验到 PieCloudDB 的主要特性包括：

• 多维度弹性扩缩容： 按需灵活修改虚拟数仓以及执行器数量。

• 高阶内核特性： 多层缓存设计、SIMD 向量化执行引擎、预计算、数据剪裁等功能。

• 多租户、多集群： 作为一款云原生虚拟数仓，采用全新 eMPP（elastic MPP）架构，具备多租户和多集群能力。

• 存算分离架构： 实现存储和计算资源的独立管理，底层共享一份存储，消除数据孤岛。

本系列课程将分为多个模块，内容设计涵盖基础操作到高阶功能，帮助大家在多维度上理解和管理 PieCloudDB。课程大纲如下：

前两期内容中，我们分别演示了 PieCloudDB 社区版网站「PieStore」的功能介绍以及如何一键部署和安装 PieCloudDB 社区版。

PieCloudDB 社区版镜像提供了 pdbcli 命令行工具来协助管理虚拟数仓，本期为该系列的第三期内容，将围绕如何使用 pdbcli 进行 PieCloudDB 虚拟数仓的管理，内容包括：创建新的虚拟数仓、虚拟数仓的启动和停止、虚拟数仓的弹性扩缩容、修改参数配置，以及如何查看虚拟数仓信息等，相关命令如下：

更多内容，欢迎查阅 《PieCloudDB 社区版管理员指南》 中《管理 PieCloudDB》章节。

01. 新增虚拟数仓

在 PieCloudDB 安装部署完成后，系统会自动生成一个默认的虚拟数仓。如果需要添加新的虚拟数仓，可执行以下命令：

docker exec -it pieclouddb pdbcli cluster create --cluster-size 3 

💡 --cluster-size 参数用于指定新虚拟数仓中执行器的数量

02. 启动和停止虚拟数仓

使用 pdbcli 命令创建虚拟数仓后，虽已完成初始化设置，但虚拟数仓并不会立即运行。如果需要启动新创建的虚拟数仓，需执行以下命令：

docker exec -it pieclouddb pdbcli cluster start --cluster 2 

如需停止虚拟数仓，可执行：

docker exec -it pieclouddb pdbcli cluster stop --cluster 2 

💡 --cluster 参数用于指定需要启动或停止的虚拟数仓的 ID

03. 虚拟数仓的扩缩容

作为一款云原生虚拟数仓，PieCloudDB 支持多维度弹性扩缩容。用户可通过以下命令按需修改虚拟数仓的执行器数量：

docker exec -it pieclouddb pdbcli cluster resize --cluster 2 --cluster-size 4 

💡 --cluster 参数用于指定虚拟数仓的 ID，--cluster-size 用于修改虚拟数仓的执行器数量

04. 修改虚拟数仓配置参数

PieCloudDB 社区版可通过 pdbcli cluster config 命令修改虚拟数仓的配置参数，具体如下：

docker exec -it pieclouddb pdbcli cluster resize --cluster 2 --cluster-size 4 

💡 --cluster 用于指定虚拟数仓的 ID，--name 用于指定参数的名称，--value 则用于指定修改后的参数值

05. 查询虚拟数仓信息

在 PieCloudDB 社区版中，用户可以执行如下命令查看虚拟数仓的详细信息，该示例命令会显示默认用户下的所有虚拟数仓信息：

docker exec -it pieclouddb pdbcli cluster list 

💡 若想查看特定虚拟数仓信息，可以使用参数 --cluster 指定虚拟数仓的 ID

为了方便大家更直观地了解虚拟数仓的管理过程，我们准备了配套演示视频，欢迎观看！也欢迎大家前往 piestore.openpie.com 免费试用体验 PieCloudDB 社区版。